ODBC 驱动程序的连接字符串语法及选项

用于指定 ODBC 驱动程序连接字符串选项的语法如下：


DRIVER={Amazon Timestream ODBC Driver};(option)=(value);

可用选项如下：

Driver （必填）：与 ODBC 结合使用的驱动程序。

默认为 Amazon Timestream。
DSN：用于配置连接的数据来源名称（DSN）。

默认为 NONE。
Auth：身份验证模式。其必须是以下内容之一：
- AWS_PROFILE：使用默认凭证链。
- IAM：使用 AWS IAM 凭证
- AAD：使用 Azure Active Directory（AD）身份提供商。
- OKTA：使用 Okta 身份提供商。
默认为 AWS_PROFILE。

EndpointOverride：适用于 LiveAnalytics 的 Timestream 服务的端点覆盖。这是用于覆盖区域的高级选项。例如：
```
query-cell2.timestream.us-east-1.amazonaws.com
```
Region：适用于 LiveAnalytics 的 Timestream 服务端点的签名区域。

默认为 us-east-1。

UID 或 AccessKeyId：AWS 用户访问密钥 ID。如果连接字符串中同时提供 UID 和 AccessKeyId，则将使用 UID 值，除非该值为空。

默认为 NONE。
PWD 或 SecretKey：AWS 用户秘密访问密钥。如果连接字符串中同时提供 PWD 和 SecretKey，则将使用带的 PWD 值，除非该值为空。

默认为 NONE。
SessionToken：访问已启用多重身份验证（MFA）的数据库所需的临时会话令牌。请勿在输入中包含尾随 = 。

默认为 NONE。

IdPHost：指定 IdP 的主机名。

默认为 NONE。
UID 或 IdPUserName：指定 IdP 账户的用户名。如果连接字符串中同时提供 UID 和 IdPUserName，则将使用 UID 值，除非该值为空。

默认为 NONE。
PWD 或 IdPPassword：指定 IdP 账户的密码。如果连接字符串中同时提供 PWD 和 IdPPassword，则将使用 PWD 值，除非该值为空。

默认为 NONE。
OktaApplicationID：Okta 提供的与适用于 LiveAnalytics 的 Timestream 应用程序关联的唯一 ID。可在应用程序元数据所提供 entityID 字段中查找应用程序 ID（AppID）的位置。例如：
```
entityID="http://www.okta.com//(IdPAppID)
```
默认为 NONE。
RoleARN：调用方所代入角色的 Amazon 资源名称（ARN）。

默认为 NONE。
IdPARN：描述 IdP 的 IAM 中 SAML 提供商的 Amazon 资源名称（ARN）。

默认为 NONE。

RequestTimeout：AWS SDK 在查询请求超时之前等待的时间（以毫秒为单位）。任何非正值都表示禁用请求超时。

默认为 3000。
ConnectionTimeout：AWS SDK 在通过开放连接传输数据超时之前等待的时间（以毫秒为单位）。值为 0 时，将禁用连接超时。该值不得为负。

默认为 1000。
MaxRetryCountClient：SDK 中可重试错误（错误代码为 5xx）的最大重试次数。值不得为负。

默认为 0。
MaxConnections：允许与 Timestream 服务同时打开的 HTTP 连接最大数量。值必须为正。

默认为 25。

LogLevel：驱动程序日志记录的日志级别。必须为以下值之一：
- 0：（关闭）。
- 1：（错误）。
- 2：（警告）。
- 3：（信息）。
- 4：（调试）。
默认为 1（错误）。

警告：使用调试日志记录模式时，驱动程序可能会记录个人信息。
LogOutput：用于存储日志文件的文件夹。

默认为：
- Windows：%USERPROFILE%，或者如果不可用，则为 %HOMEDRIVE%%HOMEPATH%。
- macOS 和 Linux：$HOME，或者如果不可用，则函数 getpwuid(getuid()) 中的字段 pw_dir 返回值。

SDK 日志记录选项

AWS SDK 日志级别与适用于 LiveAnalytics 的 Timestream ODBC 驱动程序日志级别相互独立。设置其中一个不会影响另一个。

SDK 日志级别使用环境变量 TS_AWS_LOG_LEVEL 进行设置。有效值为：

如果未设置 TS_AWS_LOG_LEVEL，则将 SDK 日志级别设置为默认值，即 WARN。

通过代理进行连接

ODBC 驱动程序支持通过代理连接到适用于 LiveAnalytics 的 Amazon Timestream。要使用此功能，请根据代理设置配置以下环境变量：

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

驱动程序设置

连接字符串示例