Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ODBC ドライバーの接続文字列の構文とオプション
ODBC ドライバーの接続文字列オプションを指定するための構文は次のとおりです。
```
DRIVER={Amazon Timestream ODBC Driver};(option)=(value);
```
使用できるオプションは次のとおりです。
**ドライバー接続のオプション**
+ **`Driver`** *(必須)* – ODBC で使用されているドライバー。
デフォルトは Amazon Timestream です。
+ **`DSN`** – 接続の設定に使用するデータソース名 (DSN)。
デフォルトは `NONE` です。
+ **`Auth`** – 認証モード。次のいずれかである必要があります。
+ `AWS_PROFILE` – デフォルトの認証情報チェーンを使用します。
+ `IAM` – IAM AWS 認証情報を使用します。
+ `AAD` – Azure Active Directory (AD) ID プロバイダーを使用します。
+ `OKTA` – Okta ID プロバイダーを使用します。
デフォルトは `AWS_PROFILE` です。
**エンドポイント設定のオプション**
+ **`EndpointOverride`** – Timestream for LiveAnalytics サービスのエンドポイントオーバーライド。これは、リージョンをオーバーライドする高度なオプションです。例えば、次のようになります。
```
query-cell2.timestream.us-east-1.amazonaws.com
```
+ **`Region`** – Timestream for LiveAnalytics サービスエンドポイントの署名リージョン。
デフォルトは `us-east-1` です。
**認証情報プロバイダーのオプション**
+ **`ProfileName`** – AWS 設定ファイルのプロファイル名。
デフォルトは `NONE` です。
**AWS IAM 認証オプション**
+ **`UID`** または **`AccessKeyId`** – AWS ユーザーアクセスキー ID。接続文字列で `UID` と `AccessKeyId` の両方が指定されている場合、`UID` 値が使用されます (空でない限り)。
デフォルトは `NONE` です。
+ **`PWD`** または **`SecretKey`** – AWS ユーザーのシークレットアクセスキー。接続文字列で `PWD` と `SecretKey` の両方が指定されている場合、`PWD` 値が使用されます (空でない限り)。
デフォルトは `NONE` です。
+ **`SessionToken`** – 多要素認証 (MFA) が有効なデータベースにアクセスするために必要な一時セッショントークン。入力の末尾に ` = ` を含めないでください。
デフォルトは `NONE` です。
**Okta の SAML ベース認証オプション**
+ **`IdPHost`** – 指定された IdP のホスト名。
デフォルトは `NONE` です。
+ **`UID`** または **`IdPUserName`** – 指定された IdP アカウントのユーザー名。接続文字列で `UID` と `IdPUserName` の両方が指定されている場合、`UID` 値が使用されます (空でない限り)。
デフォルトは `NONE` です。
+ **`PWD`** または **`IdPPassword`** – 指定された IdP アカウントのパスワード。接続文字列で `PWD` と `IdPPassword` の両方が指定されている場合、`PWD` 値が使用されます (空でない限り)。
デフォルトは `NONE` です。
+ **`OktaApplicationID`** – Timestream for LiveAnalytics アプリケーションに関連付けられた Okta が提供する一意の ID。アプリケーション ID (AppId) を検索する場所は、アプリケーションメタデータで指定された `entityID` フィールドにあります。以下に例を示します。
```
entityID="http://www.okta.com//(IdPAppID)
```
デフォルトは `NONE` です。
+ **`RoleARN`** – 発信者が想定しているロールの Amazon リソースネーム (ARN)。
デフォルトは `NONE` です。
+ **`IdPARN`** – IdP を説明する IAM の SAML プロバイダーの Amazon リソースネーム (ARN)。
デフォルトは `NONE` です。
**Azure Active Directory の SAML ベース認証オプション**
+ **`UID`** または **`IdPUserName`** – 指定された IdP アカウントのユーザー名。
デフォルトは `NONE` です。
+ **`PWD`** または **`IdPPassword`** – 指定された IdP アカウントのパスワード。
デフォルトは `NONE` です。
+ **`AADApplicationID`** – Azure AD に登録されたアプリケーションの一意の ID。
デフォルトは `NONE` です。
+ **`AADClientSecret`** – トークンの取得を承認するために使用される、Azure AD の登録済みアプリケーションに関連付けられたクライアントシークレット。
デフォルトは `NONE` です。
+ **`AADTenant`** – Azure AD テナント ID。
デフォルトは `NONE` です。
+ **`RoleARN`** – 発信者が想定しているロールの Amazon リソースネーム (ARN)。
デフォルトは `NONE` です。
+ **`IdPARN`** – IdP を説明する IAM の SAML プロバイダーの Amazon リソースネーム (ARN)。
デフォルトは `NONE` です。
**AWS SDK (アドバンスド) オプション**
+ **`RequestTimeout`** – AWS SDK がタイムアウトする前にクエリリクエストを待機するミリ秒単位の時間。正でない値を指定すると、リクエストのタイムアウトが無効になります。
デフォルトは `3000` です。
+ **`ConnectionTimeout`** – AWS SDK がタイムアウトする前にオープン接続経由でデータを転送するのを待機するミリ秒単位の時間。値が 0 の場合、接続タイムアウトは無効になります。負の値は指定できません。
デフォルトは `1000` です。
+ **`MaxRetryCountClient`** – SDK における 5xx エラーコードの再試行可能エラーの最大再試行回数。負の値は指定できません。
デフォルトは `0` です。
+ **`MaxConnections`** – Timestream サービスへの同時オープン可能な HTTP 接続の最大数。正の値を指定する必要があります。
デフォルトは `25` です。
**ODBC ドライバーのログ記録オプション**
+ **`LogLevel`** – ドライバーのログ記録のログレベル。次のいずれかにする必要があります。
+ **0** (OFF)。
+ **1** (ERROR)。
+ **2** (WARNING)。
+ **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` を使用して設定されます。次の値を指定できます。
+ `OFF`
+ `ERROR`
+ `WARN`
+ `INFO`
+ `DEBUG`
+ `TRACE`
+ `FATAL`
`TS_AWS_LOG_LEVEL` が設定されていない場合、SDK ログレベルはデフォルトの `WARN` に設定されます。
## プロキシを介して接続する
ODBC ドライバーは、プロキシを介した Amazon Timestream for LiveAnalytics への接続をサポートしています。この機能を使用するには、プロキシ設定に基づいて次の環境変数を設定します。
+ **`TS_PROXY_HOST`** – プロキシホスト。
+ **`TS_PROXY_PORT`** – プロキシポート番号。
+ **`TS_PROXY_SCHEME`** – プロキシスキーム (`http` または `https`)。
+ **`TS_PROXY_USER`** – プロキシ認証のユーザー名。
+ **`TS_PROXY_PASSWORD`** – プロキシ認証のユーザーパスワード。
+ **`TS_PROXY_SSL_CERT_PATH`** – HTTPS プロキシへの接続に使用する SSL 証明書ファイル。
+ **`TS_PROXY_SSL_CERT_TYPE`** – プロキシクライアント SSL 証明書のタイプ。
+ **`TS_PROXY_SSL_KEY_PATH`** – HTTPS プロキシへの接続に使用するプライベートキーファイル。
+ **`TS_PROXY_SSL_KEY_TYPE`** – HTTPS プロキシへの接続に使用するプライベートキーファイルのタイプ。
+ **`TS_PROXY_SSL_KEY_PASSWORD`** – HTTPS プロキシへの接続に使用されるプライベートキーファイルへのパスフレーズ。