Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ODBC Amazon Timestream for LiveAnalytics 用のオープンソース [ODBC ドライバー](https://github.com/awslabs/amazon-timestream-odbc-driver/tree/main)は、開発者向けに Timestream for LiveAnalytics への SQL リレーショナルインターフェイスを提供し、Power BI Desktop や Microsoft Excel などのビジネスインテリジェンス (BI) ツールからの接続を可能にします。現在、Timestream for LiveAnalytics ODBC ドライバーは [Windows、macOS、Linux ](https://github.com/awslabs/amazon-timestream-odbc-driver/releases)で利用でき、Okta および Microsoft Azure Active Directory (AD) の SSO もサポートしています。 詳細については、GitHub の「[Amazon Timestream ODBC Driver Documentation](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/index.md)」を参照してください。 **Topics** + [Timestream for LiveAnalytics ODBC ドライバーを設定する](ODBC-setup.md) + [ODBC ドライバーの接続文字列の構文とオプション](ODBC-connecting.md) + [Timestream for LiveAnalytics ODBC ドライバーの接続文字列の例](ODBC-connecting-examples.md) + [ODBC ドライバーとの接続のトラブルシューティング](ODBC-connecting-troubleshooting.md) # Timestream for LiveAnalytics ODBC ドライバーを設定する ## AWS アカウントで LiveAnalytics の Timestream へのアクセスを設定する Timestream for LiveAnalytics を使用するように AWS アカウントをまだ設定していない場合は、「」のインサクションに従ってください[Timestream for LiveAnalytics へのアクセス](accessing.md)。 ## システムに ODBC ドライバーをインストールする [ODBC GitHub リポジトリ](https://github.com/awslabs/amazon-timestream-odbc-driver/releases)からシステムに適した Timestream ODBC ドライバーインストーラをダウンロードし、各システムでのインストール手順に従います。 + [Windows 用インストールガイド](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-installation-guide.md) + [MacOS 用インストールガイド](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-installation-guide.md) + [Linux 用インストールガイド](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-installation-guide.md) ## ODBC ドライバーのデータソース名 (DSN) を設定する 各システムの DSN 設定ガイドの手順に従います。 + [Windows 用 DSN 設定](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/windows-dsn-configuration.md) + [MacOS 用 DSN 設定](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/macOS-dsn-configuration.md) + [Linux 用 DSN 設定](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/linux-dsn-configuration.md) ## ODBC ドライバーと連携するようにビジネスインテリジェンス (BI) アプリケーションを設定する いくつかの一般的な BI アプリケーションを ODBC ドライバーと連携するように設定する手順は次のとおりです。 + [Microsoft Power BI の設定。](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-power-bi.md) + [Microsoft Excel の設定](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/microsoft-excel.md) + [Tableau の設定](https://github.com/awslabs/amazon-timestream-odbc-driver/blob/main/docs/markdown/setup/tableau.md) その他のアプリケーション # 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 プロキシへの接続に使用されるプライベートキーファイルへのパスフレーズ。 # Timestream for LiveAnalytics ODBC ドライバーの接続文字列の例 ## IAM 認証情報を使用して ODBC ドライバーに接続する例 ``` Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);SessionToken=(your session token);Region=us-east-2; ``` ## プロファイルを使用して ODBC ドライバーに接続する例 ``` Driver={Amazon Timestream ODBC Driver};ProfileName=(the profile name);region=us-west-2; ``` ドライバーは、`~/.aws/credentials` で指定された認証情報を使用するか、環境変数 `AWS_SHARED_CREDENTIALS_FILE` でファイルが指定されている場合はそのファイルの認証情報を使用して接続を試みます。 ## Okta を使用して ODBC ドライバーに接続する例 ``` driver={Amazon Timestream ODBC Driver};auth=okta;region=us-west-2;idPHost=(your host at Okta);idPUsername=(your user name);idPPassword=(your password);OktaApplicationID=(your Okta AppId);roleARN=(your role ARN);idPARN=(your Idp ARN); ``` ## Azure Active Directory (AAD) を使用して ODBC ドライバーに接続する例 ``` driver={Amazon Timestream ODBC Driver};auth=aad;region=us-west-2;idPUsername=(your user name);idPPassword=(your password);aadApplicationID=(your AAD AppId);aadClientSecret=(your AAD client secret);aadTenant=(your AAD tenant);roleARN=(your role ARN);idPARN=(your idP ARN); ``` ## 指定されたエンドポイントとログレベル 2 (WARNING) で ODBC ドライバーに接続する例 ``` Driver={Amazon Timestream ODBC Driver};Auth=IAM;AccessKeyId=(your access key ID);secretKey=(your secret key);EndpointOverride=ingest.timestream.us-west-2.amazonaws.com;Region=us-east-2;LogLevel=2; ``` # ODBC ドライバーとの接続のトラブルシューティング **注記** DSN でユーザー名とパスワードが既に指定されている場合、ODBC ドライバーマネージャーからの要求に応じてユーザー名とパスワードを再度指定する必要はありません。 エラーコード `01S02` とメッセージ「`Re-writing (connection string option) (have you specified it several times?`」は、接続文字列オプションが接続文字列で複数回渡された場合に表示されます。1 つのオプションを複数回指定すると、エラーが発生します。DSN と接続文字列を使用した接続時に、DSN で接続オプションが既に指定されている場合は、接続文字列で再度指定しないでください。