Spotfire® 用户指南

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 的适当访问权限的用户能够连接和读取数据。

域凭据未存储在分析文件中。

连接超时 (秒)

指定与数据库建立连接时等待的最大秒数。

注意:默认情况下,此字段留空,将使用数据源驱动程序中的默认超时设置。

特殊属性设置

使用此控件可以指定要用于连接到 SAP HANA 实例的其他 ODBC 连接属性。使用此控件可以配置并使用受 SAP HANA ODBC 驱动程序支持的、但在 Spotfire 中没有专用控件的连接属性。

在“特殊属性设置”控件中,每一行表示一个连接属性。要添加并配置连接属性,请在“属性”字段中输入该连接属性的名称,并在“值”字段中输入值。

有关可用的和受支持的 ODBC 连接属性的详细信息,请参见 SAP 提供的官方文档《SAP HANA Client Interface Programming Reference》。

注意:在“属性”字段中输入的连接属性名称必须是确切名称。根据所使用的 ODBC 驱动程序版本,属性名称可能区分大小写。

输入连接属性的名称和值后,将添加一个新行,您可以在其中添加其他属性。要删除已添加的连接属性,请单击行中最左侧的单元格以选择整个行,然后按 Delete 键。

提示:如果您的键盘没有 Delete 键,则改为使用相应的键盘快捷方式。例如在 Mac 计算机上,相应的键盘快捷方式为 Fn + Backspace。

受支持的数据类型

设置到外部数据源的连接时,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

统计函数仅适用于关系数据:

MEDIAN, STDDEV, STDDEV_POP, STDDEV_SAMP, VAR, VAR_POP, VAR_SAMP

文本 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