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

Amazon Timestream for InfluxDB DB インスタンスへの接続

DB インスタンスに接続する前に、DB インスタンスを作成する必要があります。詳細については、DB インスタンスの作成 を参照してください。Amazon Timestream が DB インスタンスをプロビジョニングしたら、influxDB API、Influx、CLIまたは InfluxDB の互換性のあるクライアントまたはユーティリティを使用して DB インスタンスに接続します。

Amazon Timestream for InfluxDB DB インスタンスの接続情報の検索

DB インスタンスの接続情報には、エンドポイント、ポート、ユーザー名、パスワード、およびオペレーターやすべてのアクセストークンなどの有効なアクセストークンが含まれます。例えば、InfluxDB DB インスタンスの場合、エンドポイント値が であるとしますinfluxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com。この場合、ポート値は 8086 で、データベースユーザーは管理者 です。この情報を考慮して、接続文字列に次の値を指定します。

エンドポイントは DB インスタンスごとに一意であり、ポートとユーザーの値はさまざまです。DB インスタンスに接続するには、Influx 、Influx CLIAPI、または InfluxDB と互換性のある任意のクライアントを使用できます。

DB インスタンスの接続情報を検索するには、 AWS マネジメントコンソールを使用します。 AWS コマンドラインインターフェイス (AWS CLI) describe-db-instances コマンドまたは Timestream-influxdb APIGetDBInstanceオペレーションを使用することもできます。

ユーザー名とパスワードの情報を検索する必要がある場合は、設定の詳細タブを選択し、 influxAuthParametersSecretArn を選択して Secrets Manager にアクセスします。

アクセストークンの作成

この情報により、インスタンスに接続してアクセストークンを取得または作成できるようになります。これを実現するには、いくつかの方法があります。

次の例では、 curlと InfluxDB を使用してすべてのアクセストークンAPIを生成します。

export INFLUX_HOST=https://influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: text/plain; charset=utf-8" \
  --data '{
    "status": "active",
    "description": "All access token for get started tutorial",
    "orgID": "'"$INFLUX_ORG_ID"'",
    "permissions": [
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
    ]
  }
'

データベース認証オプション

Amazon Timestream for InfluxDB では、データベースユーザーを認証する以下の方法をサポートしています。

暗号化された接続

アプリケーションから Secure Socket Layer (SSL) または Transport Layer Security (TLS) を使用して、DB インスタンスへの接続を暗号化できます。InfluxDB と Kronos サービスによって作成および管理されるアプリケーション間のTLSハンドシェイクに必要な証明書。証明書が更新されると、インスタンスはユーザーの介入を必要とせずに最新バージョンで自動的に更新されます。

パラメータグループを使用する

データベースパラメータは、データベースの設定方法を指定します。データベースパラメータでは、データベースに割り当てるメモリなどのリソースの量を指定できます。

DB インスタンスをパラメータグループに関連付けることで、データベース設定を管理します。Amazon Timestream for InfluxDB は、デフォルト設定でパラメータグループを定義します。カスタマイズした設定を使用して独自のパラメータグループを定義できます。

パラメータグループの概要

DB パラメータグループは、1 つ以上の DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。

デフォルトおよびカスタムパラメータグループ

DB インスタンスでは DB パラメータグループが使用されます。次のセクションでは、DB インスタンスパラメータグループの設定と管理について説明します。

DB パラメータグループを作成する

AWS Management Console、、 AWS Command Line Interfaceまたは Timestream を使用して、新しい DB パラメータグループを作成できますAPI。

DB パラメータグループ名には、次の制限事項が適用されます。

デフォルトのパラメータグループのパラメータ設定は変更できません。代わりに、以下を実行できます。

静的および動的 DB インスタンスパラメータ

InfluxDB DB インスタンスパラメータは常に静的 です。これらは次のように動作します。

静的パラメータを変更し、DB パラメータグループを保存してインスタンスに割り当てると、インスタンスの再起動後にパラメータの変更が自動的に有効になります。

新しい DB パラメータグループを DB インスタンスに関連付けると、Timestream は DB インスタンスの再起動後にのみ変更された静的パラメータを適用します。現在、唯一のオプションがすぐに適用されます。

DB パラメータグループの変更については、「DB インスタンスの更新」を参照してください。

サポートされるパラメータとパラメータ値

DB インスタンスでサポートされているパラメータを確認するには、DB インスタンスで使用される DB パラメータグループのパラメータを表示します。詳細については、「DB パラメータグループのパラメータ値の表示」を参照してください。

InfluxDB のオープンソースバージョン でサポートされているすべてのパラメータの詳細については、「InfluxDB 設定オプション」を参照してください。現在、変更できるのは次の InfluxDB パラメータのみです。

パラメータグループに不適切な設定のパラメータがあると、パフォーマンスが低下したりシステムが不安定になったり、予期しない悪影響が生じることがあります。データベースパラメータを変更するときは、常に注意してください。テスト DB インスタンスでパラメータグループ設定の変更を試してから、これらのパラメータグループの変更を本番 DB インスタンスに適用します。

DB パラメータグループを使用する

DB インスタンスでは DB パラメータグループが使用されます。次のセクションでは、DB インスタンスパラメータグループの設定と管理について説明します。

DB パラメータグループを作成する

DB パラメータグループを DB インスタンスに関連付ける

カスタマイズした設定を使用して、独自の DB パラメータグループを作成できます。DB パラメータグループは、 AWS Management Console、、 AWS Command Line Interfaceまたは Timestream-InfluxDB を使用して DB インスタンスに関連付けることができますAPI。DB インスタンスを作成または変更するときに、これを行うことができます。

DB パラメータグループの作成については、DB パラメータグループを作成する を参照してください。DB インスタンスの作成については、「DB インスタンスの作成」を参照してください。DB インスタンスの変更については、「」を参照してくださいDB インスタンスの更新。

の使用 AWS Command Line Interface

Linux、macOS、Unix の場合:

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID \
--region YOUR_REGION \
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID \
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

Windows の場合:

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID ^
--region YOUR_REGION ^
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"
                        
 

DB パラメータグループを一覧表示する

AWS アカウント用に作成した DB パラメータグループを一覧表示できます。

の使用 AWS Command Line Interface

AWS アカウントのすべての DB パラメータグループを一覧表示するには AWS Command Line Interface 、 list-db-parameter-groups コマンドを使用します。

aws timestream-influxdb list-db-parameter-groups --region region

AWS アカウントの特定の DB パラメータグループを返す AWS Command Line Interface には、 get-db-parameter-group コマンドを使用します。

aws timestream-influxdb get-db-parameter-group --region region --identifier identifier

DB パラメータグループのパラメータ値を表示する

DB パラメータグループのすべてのパラメータとそれらの値のリストを取得できます。

の使用 AWS Command Line Interface

DB パラメータグループのパラメータ値を表示するには、次の必須パラメータで コマンドを使用します AWS Command Line Interface get-db-parameters。

--db-parameter-group-name

の使用 API

DB パラメータグループのパラメータ値を表示するには、次の必須パラメータで Timestream API GetDBParameters コマンドを使用します。

DBParameterGroupName