访问 Microsoft SQL Server 中的数据
可以使用 Microsoft SQL Server 数据连接器连接到 Microsoft SQL Server 系统并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及使用与 Microsoft SQL Server 的数据连接时的注意事项。
页面内容
连接器功能
当您使用 Microsoft SQL Server 连接器访问数据时,可以使用以下功能。
| 功能 | 支持? |
|---|---|
| 加载方法 |
|
| 自定义查询 | 是 |
| 预存程序 | 是 |
| 自定义连接属性 | 是 |
| 使用身份提供程序进行单点登录 | 是 |
| 在 Web 客户端中编写 | 是 |
| 包含在 Linux 上的 Spotfire 发行版中 | 是 |
数据源属性
以下是在使用 Microsoft SQL Server 连接器创建数据连接时可以配置的受支持的数据源属性。
| 选项 | 说明 |
|---|---|
| 服务器 |
您的数据所在的服务器名称。若要包含端口号,请将其直接添加在名称的后面,前面带有逗号。若要包含实例名,请将其直接添加在服务器名的后面,前面带有反斜杠。 端口号的示例: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(例如,如果该服务器正在使用自签名证书),您可以选中此复选框以信任该服务器并在不验证服务器证书的情况下进行连接。 |
| 身份提供程序 |
[仅适用于身份提供程序 (OAuth2) 身份验证。] 选择要用于登录数据源的身份提供程序。下拉菜单中提供的选项是您已向 OAuth2IdentityProviders 偏好添加的身份提供程序。 |
| 作用域 |
[仅适用于身份提供程序 (OAuth2) 身份验证。] 当您登录到数据源时,作用域决定了 Spotfire 代表您请求的权限。 默认值 使用您在 自定义 在文本框中手动输入作用域。用空格分隔值。
|
| 连接超时(秒) |
与数据库建立连接时允许等待的最长时间(以秒为单位)。 您还可以将此超时设置在管理器中设置为首选项,如果您未在连接对话框中设置超时,将使用该首选项。 如果您在连接对话框中设置超时,该值将覆盖管理器首选项中设置的值。如果您既没有在连接对话框中也没有在首选项中指定超时,则将使用默认值 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 应用程序名称和版本号会作为遥测标记添加到连接字符串中。