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 – Timestream for LiveAnalytics 服務的端點覆寫。這是覆寫區域的進階選項。例如：
```
query-cell2.timestream.us-east-1.amazonaws.com
```
Region – Timestream for LiveAnalytics 服務端點的簽署區域。

預設值為 us-east-1。

UID 或 AccessKeyId – AWS 使用者存取金鑰 ID。如果連線字串中同時提供 AccessKeyId UID和，除非值為空白，否則將使用 UID值。

預設值為 NONE。
PWD 或 SecretKey – AWS 使用者私密存取金鑰。如果連線字串中同時提供 SecretKey PWD和，除非值為空白，否則將使用搭配 PWD的值。

預設值為 NONE。
SessionToken – 存取已啟用多重要素驗證 (MFA) 的資料庫所需的臨時工作階段字符。請勿在輸入 = 中包含結尾。

預設值為 NONE。

IdPHost – 指定 IdP 的主機名稱。

預設值為 NONE。
UID 或 IdPUserName – 指定 IdP 帳戶的使用者名稱。如果連線字串中同時提供 IdPUserName UID和，則除非值為空白，否則將使用 UID值。

預設值為 NONE。
PWD 或 IdPPassword – 指定 IdP 帳戶的密碼。如果連線字串中同時提供 IdPPassword PWD和，除非值為空白，否則將使用 PWD值。

預設值為 NONE。
OktaApplicationID – 與 Timestream for LiveAnalytics 應用程式相關聯的唯一 Okta 提供的 ID。尋找應用程式 ID (AppId) 的位置位於應用程式中繼資料中提供的entityID欄位中。範例為：
```
entityID="http://www.okta.com//(IdPAppID)
```
預設值為 NONE。
RoleARN – 發起人所擔任角色的 Amazon Resource Name (ARN)。

預設值為 NONE。
IdPARN – IAM 中描述 IdP 之 SAML 提供者的 Amazon Resource Name (ARN)。

預設值為 NONE。

UID 或 IdPUserName – 指定 IdP 帳戶的使用者名稱。

預設值為 NONE。
PWD 或 IdPPassword – 指定 IdP 帳戶的密碼。

預設值為 NONE。
AADApplicationID – Azure AD 上已註冊應用程式的唯一 ID。

預設值為 NONE。
AADClientSecret – 與 Azure AD 上已註冊應用程式相關聯的用戶端秘密，用於授權擷取字符。

預設值為 NONE。
AADTenant – Azure AD 租用戶 ID。

預設值為 NONE。
RoleARN – 發起人所擔任角色的 Amazon Resource Name (ARN)。

預設值為 NONE。
IdPARN – IAM 中描述 IdP 之 SAML 提供者的 Amazon Resource Name (ARN)。

預設值為 NONE。

RequestTimeout – SDK 在逾時之前 AWS 等待查詢請求的時間，以毫秒為單位。任何非正值都會停用請求逾時。

預設值為 3000。
ConnectionTimeout – SDK 在逾時之前 AWS 等待透過開放連線傳輸資料的時間，以毫秒為單位。值為 0 會停用連線逾時。此值不得為負。

預設值為 1000。
MaxRetryCountClient – SDK 中具有 5xx 錯誤代碼的可重試錯誤重試嘗試次數上限。值不得為負。

預設值為 0。
MaxConnections – 與 Timestream 服務同時開啟 HTTP 連線的允許數目上限。值必須為正值。

預設值為 25。

LogLevel – 驅動程式記錄的日誌層級。必須是下列其中一個：
- 0 (OFF)。
- 1 (ERROR)。
- 2 （警告）。
- 3 (INFO)。
- 4 (DEBUG)。
預設值為 1(ERROR)。

警告：使用 DEBUG 記錄模式時，驅動程式可以記錄個人資訊。
LogOutput – 要存放日誌檔案的資料夾。

預設值為：
- Windows：%USERPROFILE%，如果無法使用，則為 %HOMEDRIVE%%HOMEPATH%。
- macOS 和 Linux：$HOME，如果無法使用，則為函數getpwuid(getuid())傳回值pw_dir中的欄位。

SDK 記錄選項

AWS SDK 日誌層級與 Timestream for LiveAnalytics ODBC 驅動程式日誌層級不同。設定一個不會影響另一個。

使用環境變數設定 SDK 日誌層級TS_AWS_LOG_LEVEL。有效的值如下：

如果 TS_AWS_LOG_LEVEL 未設定，軟體開發套件日誌層級會設定為預設值，即 WARN。

透過代理連線

ODBC 驅動程式支援透過代理連線至 Amazon Timestream for LiveAnalytics。若要使用此功能，請根據您的代理設定設定下列環境變數：

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

驅動程式設定

連線字串範例