Timestream for InfluxDB 3 の DB クラスターのパラメータグループ - Amazon Timestream

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

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

Timestream for InfluxDB 3 の DB クラスターのパラメータグループ

データベースパラメータは、データベースの設定方法を指定します。DB インスタンスをパラメータグループに関連付けて、データベースの設定を管理します。

Amazon Timestream for InfluxDB は、デフォルト設定でパラメータグループを定義します。カスタマイズした設定を使用して独自のパラメータグループを定義できます。Core エディションと Enterprise エディションのパラメータグループは類似していますが、同一ではなく代替できません。

InfluxDB 3 の場合、クラスター設定はパラメータグループを通じて管理されます。これらのパラメータグループには、InfluxDB 3 クラスターの動作を決定するエンジン設定値が含まれています。

パラメータグループの特性

  • イミュータビリティ: パラメータグループは、作成後イミュータブルになります。作成後にパラメータを変更することはできません。

  • クローン作成: 既存のパラメータグループをクローンし、クローンの作成プロセス中にパラメータを変更することで、新しいパラメータグループを作成できます。これは AWS マネジメントコンソール 唯一の機能です。

  • 削除: パラメータグループは削除できません。

  • デフォルトグループ: Timestream for InfluxDB は、一般的なユースケース用に最適化された事前設定済みのデフォルトのパラメータグループを提供します。

クラスター設定の主要なパラメータ

InfluxDB 3 のパラメータグループを使用すると、次のようなクラスターのさまざまな側面を設定できます。

  • エンジンタイプ (InfluxDBV2、InfluxDBV3Core、InfluxDBV3Enterprise)

  • InfluxDB 3 Enterprise パラメータ

  • サービス定義のパラメータグループ

  • クエリの同時実行数の制限

  • クエリのメモリ割り当て

  • ストレージキャッシュ設定

  • HTTP タイムアウト設定

  • ログレベルと詳細度

  • 圧縮設定 (Enterprise バージョン)

新しいクラスターを作成する場合、パラメータグループに関連付ける必要があります。この関連付けにより、クラスターの運用特性が決まります。

共通パラメータ (Core と Enterprise の両方で使用可能)

パラメータ 説明 範囲/形式
クエリ設定
queryFileLimit クエリファイルの最大数 0-1024
queryLogSize クエリログのサイズ 1~10000
logFilter ログフィルタリング設定 最大 1024 文字
logFormat ログの形式 「full」
DataFusion エンジン
dataFusionNumThreads DataFusion スレッドの数 1~2048
dataFusionRuntimeType ランタイム実行モデル current-thread、multi-thread、multi-thread-alt
dataFusionMaxParquetFanout Parquet ファイルの最大ファンアウト 1~1000000
dataFusionUseCachedParquetLoader Parquet ローダーキャッシュの有効化 ブール値
メモリ管理
bufferMemLimitMb MB 単位のバッファメモリ制限 1024-16777216000
execMemPoolBytes 実行メモリプールのサイズ パーセンテージまたは絶対値
parquetMemCacheSize Parquet メモリキャッシュサイズ パーセンテージまたは絶対値
forceSnapshotMemThreshold 強制スナップショットのメモリしきい値 パーセンテージまたは絶対値
WAL 設定
walSnapshotSize WAL スナップショットサイズ 1~10000
walMaxWriteBufferSize WAL 書き込みバッファの最大サイズ 1~1000000
snapshottedWalFilesToKeep 保持するスナップショットされた WAL ファイルの数 0~10000
walReplayConcurrencyLimit WAL 再生同時実行数の制限 1〜100
キャッシュ設定
lastCacheEvictionInterval 最終値のキャッシュエビクション間隔 時間
distinctCacheEvictionInterval 一意値キャッシュエビクション間隔 時間
tableIndexCacheMaxEntries テーブルインデックスキャッシュエントリの最大数 1~1000
parquetMemCachePrunePercentage Parquet キャッシュプルーニングの割合 0-1
HTTP 設定
maxHttpRequestSize 最大 HTTP リクエストサイズ 1024-16777216
保持と削除
retentionCheckInterval 保持ポリシーのチェック間隔 時間
deleteGracePeriod 削除の猶予期間 時間
hardDeleteDefaultDuration デフォルトのハード削除期間 時間

Enterprise のみのパラメータ

パラメータ 説明 範囲/形式
ノードの設定
ingestQueryInstances ライター/リーダーノードの数 1~2 (必須)
queryOnlyInstances 専用リーダーノードの数 0~1 (必須)
dedicatedCompactor 専用コンパクターノードを有効にする ブール値 (必須)
圧縮設定
compactionRowLimit 圧縮の行制限 1~100000000
compactionMaxNumFilesPerPlan 圧縮プランあたりの最大ファイル数 1~10000
compactionGen2Duration 第 2 世代の圧縮期間 時間
compactionMultipliers 圧縮レベルの乗数 形式: 「n,n,n,n」
compactionCleanupWait クリーンアップまでの待機時間 時間
compactionCheckInterval 圧縮チェック間隔 時間
キャッシュの構成
lastValueCacheDisableFromHistory 履歴データからの LVC の無効化 ブール値
distinctValueCacheDisableFromHistory 履歴データからの DVC の無効化 ブール値
レプリケーション
replicationInterval データレプリケーション間隔 時間
catalogSyncInterval カタログ同期間隔 時間

パラメータグループの管理

パラメータグループを管理するには、次を行います。

  1. 作成: カスタム設定で新しいパラメータグループを作成します。

  2. 関連付け: パラメータグループを新規または既存のクラスターに関連付けます。

  3. 削除または変更: パラメータグループは変更または削除できません。

パラメータグループはイミュータブルであるため、クラスターを作成する前に設定を慎重に計画してください。後でパラメータを変更する必要がある場合は、新しいパラメータグループを作成してクラスターに関連付ける必要があります。そのとき、クラスターの再起動が必要になる場合があります。

パラメータグループの作成

InfluxDB 3 Core パラメータグループを作成します。

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-core-pg" \ --description "Custom parameter group for InfluxDB 3 Core" \ --parameters '{ "InfluxDBv3Core": { "queryFileLimit": 512, "dataFusionNumThreads": 16, "bufferMemLimitMb": 8192, "maxHttpRequestSize": 8388608 } }'

InfluxDB 3 Enterprise パラメータグループを作成します (3 ノード設定)。

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-enterprise-pg" \ --description "Custom parameter group for 3-node InfluxDB 3 Enterprise cluster" \ --parameters '{ "InfluxDBv3Enterprise": { "ingestQueryInstances": 2, "queryOnlyInstances": 0, "dedicatedCompactor": true, "compactionRowLimit": 1000000, "compactionCheckInterval": "30m", "dataFusionNumThreads": 32, "bufferMemLimitMb": 16384 } }'

InfluxDB 3 Enterprise パラメータグループを作成します (単一ノード設定)。

aws timestream-influxdb create-db-parameter-group \ --name "my-influxdb3-enterprise-single-pg" \ --description "Custom parameter group for single-node InfluxDB 3 Enterprise" \ --parameters '{ "InfluxDBv3Enterprise": { "ingestQueryInstances": 1, "queryOnlyInstances": 0, "dedicatedCompactor": false, "dataFusionNumThreads": 16 } }'

サービス定義のパラメータグループの使用

デフォルトの core パラメータグループを使用してクラスターを作成します。

aws timestream-influxdb create-db-cluster \ --name "my-core-cluster" \ --db-parameter-group-identifier "InfluxDBv3Core" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.large \

デフォルトの enterprise パラメータグループ (3 ノード) を使用してクラスターを作成します。

aws timestream-influxdb create-db-cluster \ --name "my-enterprise-cluster" \ --db-parameter-group-identifier "InfluxDBv3Enterprise" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.xlarge \

単一ノードの enterprise パラメータグループを使用してクラスターを作成します。

aws timestream-influxdb create-db-cluster \ --name "my-enterprise-single" \ --db-parameter-group-identifier "InfluxDBv3Enterprise1Node" \ --vpc-subnet-ids subnet-12345 subnet-67890 \ --vpc-security-group-ids sg-abcdef \ --db-instance-type db.influxIOIncluded.large \

パラメータグループの一覧表示と説明

すべてのパラメータグループを一覧表示します。

aws timestream-influxdb list-db-parameter-groups

特定のパラメータグループを記述します。

aws timestream-influxdb get-db-parameter-group \ --identifier "my-influxdb3-enterprise-pg"

サービス定義のパラメータグループリファレンス

Amazon Timestream for InfluxDB には、3 つのサービス定義パラメータグループが用意されています。

  1. InfluxDBv3Core: 単一ノードの InfluxDB 3 Core クラスターのデフォルト設定。

  2. InfluxDBv3Enterprise: 3 ノードの InfluxDB 3 Enterprise クラスターのデフォルト設定 (ライター/リーダーノード 2 個 + 専用コンパクター 1 個)。

  3. InfluxDBv3Enterprise1Node: 単一ノードの InfluxDB 3 Enterprise クラスターのデフォルト設定 (専用コンパクターなし)。

これらのサービス定義のパラメータグループはイミュータブルであり、直接使用するか、--source-db-parameter-group-id オプションを使用してカスタムパラメータグループを作成するためのテンプレートとして使用できます。