SAP HANA 连接器 - 功能和设置
您可以使用 SAP HANA 连接器连接至 SAP HANA 数据库，并访问其中的数据。在此页面上，可以了解相关功能、可用设置以及处理与 SAP HANA 的数据连接时的注意事项。
页面内容
连接器功能
当您使用 SAP HANA 连接器访问数据时，可以使用以下功能。
| 功能 | 支持？ |
|---|---|
| 加载方法 |
|
| 自定义查询 | 是 |
| 预存程序 | 是，对于关系数据 注： 只能导入来自 SAP HANA 中预存程序的数据。外部（数据库内）加载方法不可用。
|
| 自定义连接属性 | 是 |
| 使用身份提供程序进行单点登录 | 否 |
| 在 Web 客户端中编写 | 是 |
| 包含在 Linux 上的 Spotfire 发行版中 | 是 |
数据源属性
以下是在使用 SAP HANA 连接器创建数据连接时可以配置的受支持的数据源属性。
| 选项 | 说明 |
|---|---|
| 服务器 |
您的数据所在的服务器名称。若要包含端口号，请将其直接添加在名称的后面，前面带有冒号。 端口号的示例：MyDatabaseServer:1234 SAP HANA 支持弹性连接，这意味着，您可以提供多个服务器，并能在到第一个服务器的连接中断时，转而使用下一个服务器。若要添加多个服务器，请使用分号作为分隔符。 使用多个服务器的示例：MyDatabaseServer01;MyDatabaseServer02;MyDatabaseServer03 使用多个服务器（包括端口号）的示例：MyDatabaseServer01:1234;MyDatabaseServer02:1234;MyDatabaseServer03:1234 注： SAP HANA 中的每个租户数据库都具有专用端口号。请确保使用正确的端口号连接到 SAP HANA 实例中的预期租户数据库。有关租户数据库的端口分配的更多信息，请参见 SAP 的官方文档。
|
| 连接 |
选择要连接的 SAP HANA 数据类型。 关系数据 访问数据库中的原始数据表。 信息视图 访问信息视图（例如计算视图），这是数据库中数据的预建模多维视图。 |
| 使用 SSL 连接 |
SAP HANA 连接器支持 SSL。 注： 如果在 Spotfire Server 上将 Kerberos 身份验证与委派的凭据结合使用，则不能在 Spotfire Web 客户端中将此连接器与 SSL 结合使用。数据库供应商提供的 ODBC 驱动程序预计将在特定于用户的目录或 Windows 注册表项中查找 SSL 证书信息。将 Kerberos 身份验证与委派的凭据结合使用时，这些信息在服务器上不可用。
|
| 包括系统架构 | 如果希望包括系统表，请选中此复选框。 |
| 为计算视图显示列标签 | 如果要对来自计算视图的列使用显示名称而非技术名称，则选中此复选框。 |
| 语言 | 在下拉列表中进行选择以使用特定的语言查看数据。 |
| 身份验证方法 |
当登录到数据库时要使用的身份验证方法。选择“用户名和密码”或“Kerberos 身份验证”。 用户名和密码 使用用户名和密码身份验证，身份验证通过数据库用户来执行。通过使用“数据源设置”对话框中的设置，可将数据库凭据作为分析文件的一部分加以存储和解密。如果在分析文件中找到凭据，则会使用这些凭据对数据库进行自动身份验证。 如果在分析文件中未找到凭据或凭据配置文件，则打开该文件的所有用户都将被提示输入数据库凭据。 请注意，如果嵌入到分析文件中的凭据失败，则不会提示输入凭据。 Kerberos 当使用 Kerberos 身份验证时，系统将使用已登录用户的访问令牌。已提供对 SAP HANA 的适当访问权限的用户能够连接和读取数据。 域凭据未存储在分析文件中。 |
| 连接超时 (秒) |
与数据库建立连接时允许等待的最长时间（以秒为单位）。 您还可以在管理器中将此超时设置为偏好，如果您未在连接对话框中设置超时，将使用该偏好。 如果您在连接对话框中设置超时，该值将覆盖管理器偏好中设置的值。如果您既没有在连接对话框中也没有在首选项中指定超时，则将使用默认值 15 秒。 注： 如果将连接超时设为零，则被视为永不超时。这意味着，尝试执行命令时不设上限。通常不建议采取这种做法。
注： 默认情况下，此字段留空，将使用数据源驱动程序中的默认超时设置。
|
| 命令超时 (秒) |
执行一条命令所允许的最长时间（以秒为单位）。 您还可以在管理器中将此超时设置为偏好，如果您未在连接对话框中设置超时，将使用该偏好。 如果您在连接对话框中设置超时，该值将覆盖管理器偏好中设置的值。如果您既没有在连接对话框中也没有在首选项中指定超时，则将使用默认值 600 秒。 注： 如果将命令超时设为零，则被视为永不超时。这意味着，尝试执行命令时不设上限。通常不建议采取这种做法。
|
SAP HANA 连接数据源的自定义属性
以下是可以用作 SAP HANA 连接数据源中自定义属性的默认驱动程序设置列表。要了解如何更改允许的自定义属性，请参见控制允许哪些属性。
默认允许的自定义属性
allowLocalCompress, allowReconnectOnSelect, bindAddress, chopBlanks, chopBlanksInput, communicationTimeout,
compress, DSN, packetCaching, packetSize, packetSizeLimit, prefetch, proxyHostname, proxy_host, proxyHttp, proxyPort,
proxy_port, reconnect, statementCacheSize, tcpKeepAliveCount, tcpKeepAliveIdle, tcpKeepAliveInterval, tcpUserTimeout,
tcpQuickAck, tcpSynCnt受支持的数据类型
设置到外部数据源的连接时，Spotfire 需要将数据源中的数据类型映射到 Spotfire 中的数据类型。以下是 SAP HANA 连接器支持的数据类型。
| 数据库数据类型 | Spotfire 数据类型 |
|---|---|
| BINARY | Binary |
| BINTEXT | Binary |
| BLOB | Binary |
| VARBINARY | Binary |
| BOOLEAN | Boolean/Bool |
| SMALLDECIMAL | Currency/Decimal |
| DATE | Date |
| SECONDDATE | DateTime |
| TIMESTAMP | DateTime |
| INTEGER | Integer/Int |
| SMALLINT | Integer/Int |
| TINYINT | Integer/Int |
| BIGINT | LongInteger/Long |
| DOUBLE | Real/Double |
| FLOAT | SingleReal/Float |
| REAL | SingleReal/Float |
| ALPHANUM | String |
| CHAR | String |
| CLOB | String |
| NCHAR | String |
| NCLOB | String |
| NVARCHAR | String |
| SHORTTEXT | String |
| STRING | String |
| TEXT | String |
| VARCHAR | String |
| TIME | Time |
| DECIMAL(p, s) / DEC |
当 p = 0 并且 s = 0 时：Currency/Decimal 当 p <= 9 并且 s = 0 时：Integer 当 9 < p <= 18 并且 s = 0 时：LongInteger 当 p <= 15 或 p >= 29 时：Real/Double 其他：Currency/Decimal |
支持的函数
支持的函数是指您在处理数据库中的数据表时可以使用的函数，例如在计算的列和自定义表达式中使用。
以下是 SAP HANA 连接器支持的函数。
| 函数类型 | 支持的函数 |
|---|---|
| 日期和时间 | YEAR, QUARTER, MONTH, MONTHNAME, WEEK, DAYOFWEEK, DAYOFYEAR, DAYOFMONTH, DAYNAME, HOUR, MINUTE, SECOND, MILLISECOND, NOW, ADD_DAYS, ADD_MONTHS, ADD_SECONDS, ADD_YEARS, ISOWEEK, NEXT_DAY, LAST_DAY, YEARS_BETWEEN, MONTHS_BETWEEN, DAYS_BETWEEN, SECONDS_BETWEEN, LOCALTOUTC, UTCTOLOCAL |
| 转换 | SN |
| 数学 |
注： 数学函数仅适用于关系 SAP HANA 数据，不能用于信息视图数据。 ABS, ACOS, ASIN, ATAN, ATAN2, BITAND, BITCOUNT, CEIL, COS, COSH, COT, EXP, FLOOR, LN, LOG, MOD, POWER, ROUND, SIGN, SIN, SINH, SQRT, TAN, TANH, UMINUS |
| 运算符 | %, -, +, *, / |
| 统计 | SUM, AVG, MIN, MAX, COUNT, UNIQUECOUNT统计函数仅适用于关系数据：
|
| 文本 | ASCII, CHAR, CONCAT, LCASE, UCASE, LOWER, UPPER, LEFT, RIGHT, LENGTH, LOCATE, LPAD, RPAD, TRIM, LTRIM, RTRIM, NCHAR, REPLACE, SUBSTR_AFTER, SUBSTR_BEFORE, SUBSTRING, UNICODE |
| 其他 | WIDTH_BUCKET |
SAP HANA 还支持合并函数。
对于合并，请使用函数 WIDTH_BUCKET（请参见 SAP 提供的 SAP HANA 官方文档）。
还可以使用 Spotfire 函数 BinByEvenIntervals。
不支持的函数
此版本连接器不支持以下函数。
数学：GREATEST、LEAST、HEXTOBIN、BINTOHEX
日期和时间：CURRENT_DATE、CURRENT_TIME、CURRENT_TIMESTAMP、CURRENT_UTCDATE、CURRENT_UTCTIME、CURRENT_UTCTIMESTAMP、EXTRACT