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
|
カタログ同期間隔 | 時間 |
パラメータグループの管理
パラメータグループを管理するには、次を行います。
-
作成: カスタム設定で新しいパラメータグループを作成します。
-
関連付け: パラメータグループを新規または既存のクラスターに関連付けます。
-
削除または変更: パラメータグループは変更または削除できません。
パラメータグループはイミュータブルであるため、クラスターを作成する前に設定を慎重に計画してください。後でパラメータを変更する必要がある場合は、新しいパラメータグループを作成してクラスターに関連付ける必要があります。そのとき、クラスターの再起動が必要になる場合があります。
パラメータグループの作成
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 つのサービス定義パラメータグループが用意されています。
-
InfluxDBv3Core: 単一ノードの InfluxDB 3 Core クラスターのデフォルト設定。
-
InfluxDBv3Enterprise: 3 ノードの InfluxDB 3 Enterprise クラスターのデフォルト設定 (ライター/リーダーノード 2 個 + 専用コンパクター 1 個)。
-
InfluxDBv3Enterprise1Node: 単一ノードの InfluxDB 3 Enterprise クラスターのデフォルト設定 (専用コンパクターなし)。
これらのサービス定義のパラメータグループはイミュータブルであり、直接使用するか、--source-db-parameter-group-id オプションを使用してカスタムパラメータグループを作成するためのテンプレートとして使用できます。