TIBCO Cloud™ Spotfire® Web 客户端用户指南

访问 Microsoft SQL Server 中的数据

可以使用 Microsoft SQL Server 数据连接器连接到 Microsoft SQL Server 系统并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及使用与 Microsoft SQL Server 的数据连接时的注意事项。

页面内容

连接器功能

当您使用 Microsoft SQL Server 连接器访问数据时,可以使用以下功能。

功能 支持?
加载方法
  • 导入(内存中)
  • 外部(数据库内)
  • 按需
自定义查询
预存程序
自定义连接属性
使用身份提供程序进行单点登录
在 Web 客户端中编写
Linux Web Player 支持

数据源属性

以下是在使用 Microsoft SQL Server 连接器创建数据连接时可以配置的受支持的数据源属性。

注: 有关驱动程序软件中的属性和相应设置的更多信息,请参见 Microsoft 提供的有关 SQL Server .NET 数据提供程序的官方文档。
选项 说明
服务器

您的数据所在的服务器名称。若要包含端口号,请将其直接添加在名称的后面,前面带有逗号。若要包含实例名,请将其直接添加在服务器名的后面,前面带有反斜杠。

端口号的示例:MyDatabaseServer,1234

实例名的示例:MyDatabaseServer\InstanceName

数据库

确定如何选择要访问的数据库。

从列表中选择

在“数据库”下拉菜单中从所有可用数据库的列表中选择。单击“连接”后,系统会填充“数据库”下拉菜单。

注意:要使用“从列表中选择”选项,您必须有权访问数据源中的默认数据库。默认数据库通常称为“主数据库”。

输入名称

手动输入要访问的数据库的名称。

身份验证方法

当登录到数据库时要使用的身份验证方法。

Windows 身份验证

当使用 Windows 身份验证(例如 Kerberos)时,系统将使用已登录用户的访问令牌。已提供对 SQL Server 的适当访问权限的用户能够连接和读取数据。

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

SQL Server 身份验证

使用数据库身份验证,身份验证通过数据库用户来执行。通过使用“数据源设置”对话框中的设置,可将数据库凭据作为分析文件的一部分加以存储和解密。如果在分析文件中找到凭据,则会使用这些凭据对数据库进行自动身份验证。

如果在分析文件中未找到凭据或凭据配置文件,则打开该文件的所有用户都将被提示输入数据库凭据。

请注意,如果嵌入到分析文件中的凭据失败,则不会提示输入凭据。

Active Directory - 集成

[如果您在运行于 Linux 系统上的 Spotfire Web 客户端中打开数据连接,则不支持此身份验证方法。]

如果您正在使用 Active Directory 并且您的域与 Azure Active Directory 联合,那么您可以连接到 Microsoft Azure SQL 数据库并使用您的已登录 Azure Active Directory 凭据进行身份验证。选择身份验证方法“Active Directory - 集成”。

使用此身份验证方法,凭据无法保存到分析文件中。

Active Directory - 密码

输入 Azure Active Directory 主体用户的用户名和密码以用于向 Microsoft Azure SQL 数据库进行身份验证。

仅使用“Active Directory - 密码”身份验证连接到 Microsoft Azure SQL 数据库。

身份提供程序 (OAuth2)

使用身份提供程序(例如 Okta 或 Keycloak)登录。当您打开数据连接时,将会打开一个 Web 浏览器窗口,您可以使用身份提供程序的登录程序来登录。

加密

选中此复选框可要求在连接到 SQL Server 时使用加密。默认情况下选择“加密”。

信任服务器

[仅在选择“加密”时才适用。]

如果要使用加密来连接到不具有可验证服务器证书的 SQL Server(例如,如果该服务器正在使用自签名证书),您可以选中此复选框以信任该服务器并在不验证服务器证书的情况下进行连接。

连接超时 (秒)

与数据库建立连接时允许等待的最长时间(以秒为单位)。

您还可以将此超时设置在管理器中设置为首选项,如果您未在连接对话框中设置超时,将使用该首选项。

如果您在连接对话框中设置超时,该值将覆盖管理器首选项中设置的值。如果您既没有在连接对话框中也没有在首选项中指定超时,则将使用默认值 120 秒。

注意:如果将连接超时设为零,则被视为永不超时。这意味着,尝试执行命令时不设上限。通常不建议采取这种做法。

命令超时 (秒)

执行一条命令所允许的最长时间(以秒为单位)。

您还可以将此超时设置在管理器中设置为首选项,如果您未在连接对话框中设置超时,将使用该首选项。

如果您在连接对话框中设置超时,该值将覆盖管理器首选项中设置的值。如果您既没有在连接对话框中也没有在首选项中指定超时,则将使用默认值 1800 秒。

注意:如果将命令超时设为零,则被视为永不超时。这意味着,尝试执行命令时不设上限。通常不建议采取这种做法。

Microsoft SQL Server 连接数据源的自定义属性

以下是允许用作 Microsoft SQL Server 连接数据源中自定义属性的默认驱动程序设置列表。要了解如何更改允许的自定义属性,请参见控制允许哪些属性

默认允许的自定义属性

ApplicationIntent、Attestation Protocol、Column Encryption Setting、ConnectRetryCount、ConnectRetryInterval、Enclave Attestation Url、Enlist、Failover Partner、FailoverPartnerSPN、HostNameInCertificate、IPAddressPreference、Load Balance MultiSubnetFailoverTimeout、Max Pool Size、Min Pool Size、MultipleActiveResultSets、Packet Size、PoolBlockingPeriod、Pooling、ServerCertificate、ServerSPN、Transaction Binding、Type System Version、User Instance、Workstation ID

SQL Server 数据类型

设置到外部数据源的连接时,Spotfire 需要将数据源中的数据类型映射到 Spotfire 中的数据类型。请参见下文,了解使用 SQL Server 数据库时 Spotfire 支持的不同数据类型以及适用的数据类型映射的列表。

SQL Server 数据类型 Spotfire 数据类型
BINARY Binary
GEOGRAPHY Binary
GEOMETRY Binary
IMAGE Binary
ROWVERSION Binary
TIMESTAMP Binary
VARBINARY Binary
BIT Boolean
DECIMAL Currency
MONEY Currency
NUMERIC Currency
SMALLMONEY Currency
DATE Date
DATETIME DateTime
DATETIME2 DateTime
SMALLDATETIME DateTime
INT Integer
SMALLINT Integer
TINYINT Integer
BIGINT LongInteger
FLOAT Real
REAL SingleReal
CHAR String
NCHAR String
NTEXT String
NVARCHAR String
TEXT String
UNIQUEIDENTIFIER String
VARCHAR String
TIME Time

支持的函数

支持的函数是指您在处理数据库中的数据表时可以使用的函数,例如在计算的列和自定义表达式中使用。

注: 您的数据库可能无法使用某些受支持的函数。这取决于数据库中可用的函数,不同数据库版本和类型之间通常会有差异。

以下是 Microsoft SQL Server 连接器支持的函数。

函数类型 支持的函数
日期和时间 Year、Quarter、Month、Week、Day、DayOfMonth、DayOfYear、DayOfWeek、Hour、Minute、Second、Millisecond
转换 SN
数学 Abs、ASin、ACos、ATan、Atn2、Ceiling、Cos、Sin、Tan、Cot、Exp、Floor、Log、Log10、Power、Sqrt、Square
运算符 +、-、*、/、%
统计 Sum、Avg、Max、Min、Count、UniqueCount、Count_Big、Stdev、StdevP、Var、VarP
文本 CharIndex、Len、Lower、Upper、LTrim、RTrim、Soundex、Reverse、Split

使用 Microsoft SQL Server 数据连接

以下是有关在 Spotfire 中使用来自 Microsoft SQL Server 连接中的数据的具体信息。

遥测 - 查询标记

使用 Microsoft SQL Server 连接器建立连接时,Spotfire 应用程序名称和版本号会作为遥测标记添加到连接字符串中。