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

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

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

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

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

DB インスタンスの接続情報には、エンドポイント、ポート、ユーザー名、パスワード、有効なアクセストークン (オペレータートークンまたはオールアクセストークンなど) が含まれます。例えば、Timestream for InfluxDB の DB インスタンスにおけるエンドポイントの値が c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws だったとします。この場合、ポート値は 8086、データベースユーザーは admin です。この情報から、インスタンスにアクセスするには以下を使用します。

2024 年 12 月 9 日より前に作成されたインスタンスには、インスタンス ID ではなくインスタンス名を含むエンドポイントを使用します。例: influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com。

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

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

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

アクセストークンの作成

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

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

export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
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 マネジメントコンソール、、 AWS Command Line Interfaceまたは Timestream API を使用して、新しい DB パラメータグループを作成できます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

カスタマイズした設定を使用して、独自の DB パラメータグループを作成できます。DB パラメータグループを DB インスタンスに関連付けるには AWS マネジメントコンソール、、 AWS Command Line Interface、または Timestream for InfluxDB 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 パラメータグループを返すには、 get-db-parameter-group コマンドを使用します AWS Command Line Interface 。

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

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

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

の使用 AWS Command Line Interface

DB パラメータグループのパラメータ値を表示するには、 コマンドを使用します AWS Command Line Interface get-db-parameter-group。parameter-group-identifier を自分の情報に置き換えます。

get-db-parameter-group --identifier parameter-group-identifier

API の使用

DB パラメータグループのパラメータ値を表示するには、Timestream API の GetDbParameterGroup コマンドを使用します。parameter-group-identifier を自分の情報に置き換えます。

GetDbParameterGroup parameter-group-identifier