Amazon Timestream for InfluxDB 3 の設定とパラメータグループのよくある質問

パラメータグループを使用した InfluxDB 3 クラスターの Amazon Timestream の設定に関する質問。完全なパラメータリファレンスについては、「」を参照してくださいAmazon Timestream の DB クラスターのパラメータグループ。

クラスターの現在実行中の設定を確認するにはどうすればよいですか?

データベースの_internalnodesテーブルをクエリすることで、実行中のクラスターの有効なパラメータ値を確認できます。

SELECT * FROM _internal.nodes

これにより、クラスター内の各ノードのアクティブな設定が返されます。これを使用して、新しいパラメータグループを適用する前と後にパラメータ値を確認します。

パラメータグループとは

パラメータグループには、InfluxDB 3 クラスターの動作を制御するエンジン設定値が含まれています。これには、クエリ実行、メモリ管理、圧縮、キャッシュなどの設定が含まれます。Amazon Timestream にはデフォルトのパラメータグループが用意されており、カスタムパラメータグループを作成できます。

カスタムパラメータグループを作成するにはどうすればよいですか?

AWS CLI または AWS マネジメントコンソール を使用してパラメータグループを作成します。エディション (Core または Enterprise) とカスタマイズするパラメータを指定します。例えば、次のようになります。

aws timestream-influxdb create-db-parameter-group \
  --name "my-custom-pg" \
  --description "Custom parameter group" \
  --parameters '{
    "InfluxDBv3Enterprise": {
      "queryFileLimit": 500,
      "queryLogSize": 2000
    }
  }'

作成後にパラメータグループを変更できますか?

いいえ。パラメータグループは、一度作成すると変更できません。パラメータを変更するには、新しいパラメータグループを作成し、 update-db-cluster コマンドを使用してクラスターに割り当てます。更新はすぐに適用され、インスタンスを再起動します。

パラメータの変更は実行時に適用されますか?

いいえ。すべてのパラメータは起動専用です。ランタイムの再設定はありません。変更を適用するには、更新されたパラメータグループを使用してクラスターを再起動する必要があります。

どのパラメータを変更しないようにすべきですか?

一部のパラメータは、データをディスク上で物理的に整理する方法に影響するため、クラスターの初期設定後に変更しないでください。変更すると、データの破損やクエリの失敗が発生する可能性があります。具体的には次のとおりです。

• gen1-duration – 第 1 レベルの圧縮ウィンドウを制御します (デフォルト: 10 分)

• compaction-gen2-duration – 第 2 レベルの圧縮ウィンドウを制御します。

• compaction-multipliers – 高レベルの圧縮率を制御します

新しいパラメータグループを作成するときは、これらの値は常に現在の設定と同じままにします。パラメータとその影響の完全なリストについては、「」を参照してください詳細なパラメータリファレンス。

パラメータグループを作成するためのベストプラクティスは何ですか?

デフォルトのパラメータグループから開始するか、既存のパラメータグループのクローンを作成し、変更する必要がある特定のパラメータのみを変更します。クローン作成は を通じて使用 AWS マネジメントコンソール でき、すべての安全なデフォルトを継承できます。理解してテストしたパラメータのみを調整し、圧縮関連のパラメータ (gen1-duration、compaction-gen2-duration、compaction-multipliers) は常に変更しないでください。

インスタンスタイプのパラメータ値のサイズはどのように設定すればよいですか?

パラメータ値は、インスタンスタイプの vCPU とメモリ容量に基づいて調整する必要があります。主なガイドライン:

• DataFusion スレッド – インスタンスの vCPUsの数に設定します (たとえば、 の場合は 16)db.influx.4xlarge。

• DataFusion の最大 Parquet ファンアウト – インスタンスサイズが小さいインスタンスの場合は 250～500、12xlarge 以上のインスタンスの場合は最大 5,000～10,000 のスケール。

• exec-mem-pool-bytes – 混合ワークロードノードのデフォルトは 20% のままにします。クエリのみのノードの場合、最大 70% まで増やすことができます。

• parquet-mem-cache-size – ほとんどのワークロードでは、デフォルトの 20% のままにします。db.influx.4xlarge 以降では、 を 25% に増やします。

インスタンスごとのサイズ表の詳細については、「」を参照してください詳細なパラメータリファレンス。