ODBC ドライバーの接続文字列の構文とオプション - Amazon Timestream
プロキシ接続

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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) 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 プロキシへの接続に使用されるプライベートキーファイルへのパスフレーズ。