Grup parameter untuk cluster DB di Timestream untuk InfluxDB 3

Parameter basis data menentukan konfigurasi basis data. Anda mengelola konfigurasi database Anda dengan mengaitkan instans DB Anda dengan grup parameter.

Amazon Timestream untuk InfluxDB mendefinisikan grup parameter dengan pengaturan default. Anda dapat juga menentukan grup parameter Anda sendiri dengan pengaturan yang disesuaikan. Grup parameter untuk edisi Core dan Enterprise sementara serupa tidak identik atau dapat dipertukarkan.

Untuk InfluxDB 3, konfigurasi cluster dikelola melalui grup parameter. Grup parameter ini berisi nilai konfigurasi engine yang menentukan bagaimana cluster InfluxDB 3 Anda beroperasi.

Karakteristik kelompok parameter

• Kekekalan: Grup parameter tidak dapat diubah setelah dibuat. Anda tidak dapat mengubah parameter setelah pembuatan.

• Kloning: Anda dapat membuat grup parameter baru dengan mengkloning yang sudah ada dan memodifikasi parameter selama proses kloning. Ini adalah AWS Management Console satu-satunya fitur.

• Penghapusan: Grup parameter tidak dapat dihapus.

• Grup Default: Timestream untuk InfluxDB menyediakan grup parameter default dengan pengaturan pra-konfigurasi yang dioptimalkan untuk kasus penggunaan umum.

Parameter kunci untuk konfigurasi cluster

Grup parameter untuk InfluxDB 3 memungkinkan Anda mengonfigurasi berbagai aspek cluster Anda, termasuk:

• Jenis Mesin (InfluxDBV2, Influx DBV3 Core, Influx Enterprise) DBV3

• InfluxDB 3 Parameter Perusahaan

• Grup Parameter yang Ditentukan Layanan

• Batas konkurensi kueri

• Alokasi memori untuk kueri

• Pengaturan cache penyimpanan

• Konfigurasi batas waktu HTTP

• Tingkat log dan verbositas

• Pengaturan pemadatan (Versi perusahaan)

Saat membuat cluster baru, Anda harus mengaitkannya dengan grup parameter. Asosiasi ini menentukan karakteristik operasional cluster Anda.

Parameter Umum (Tersedia di Core dan Enterprise)

Parameter	Deskripsi	Rentang/Format
Konfigurasi Kueri
queryFileLimit	Jumlah maksimum file kueri	0-1024
queryLogSize	Ukuran log kueri	1-10000
logFilter	Konfigurasi penyaringan log	Max 1024 karakter
logFormat	Format untuk log	“penuh”
DataFusion Mesin
dataFusionNumThreads	Jumlah DataFusion utas	1-2048
dataFusionRuntimeType	Model eksekusi runtime	utas saat ini, multi-utas, multi-thread-alt
dataFusionMaxParquetFanout	Fanout file parket maksimum	1-1000000
dataFusionUseCachedParquetLoader	Aktifkan caching pemuat parket	Boolean
Manajemen Memori
bufferMemLimitMb	Batas memori buffer dalam MB	1024-16777216000
execMemPoolBytes	Ukuran kolam memori eksekusi	Persentase atau nilai absolut
parquetMemCacheSize	Ukuran cache memori parket	Persentase atau nilai absolut
forceSnapshotMemThreshold	Ambang memori untuk snapshot paksa	Persentase atau nilai absolut
Konfigurasi WAL
walSnapshotSize	Ukuran snapshot WAL	1-10000
walMaxWriteBufferSize	Ukuran buffer tulis WAL maksimum	1-1000000
snapshottedWalFilesToKeep	Jumlah file WAL snapshotted untuk disimpan	0-10000
walReplayConcurrencyLimit	Batas konkurensi pemutaran ulang WAL	1-100
Pengaturan Cache
lastCacheEvictionInterval	Interval penggusuran cache nilai terakhir	Durasi
distinctCacheEvictionInterval	Interval penggusuran cache nilai yang berbeda	Durasi
tableIndexCacheMaxEntries	Entri cache indeks tabel maksimum	1-1000
parquetMemCachePrunePercentage	Persentase pemangkasan cache parket	0-1
Konfigurasi HTTP
maxHttpRequestSize	Ukuran permintaan HTTP maksimum	1024-16777216
Retensi & Penghapusan
retentionCheckInterval	Interval pemeriksaan kebijakan retensi	Durasi
deleteGracePeriod	Masa tenggang untuk penghapusan	Durasi
hardDeleteDefaultDuration	Durasi penghapusan keras default	Durasi

Parameter khusus perusahaan

Parameter	Deskripsi	Rentang/Format
Konfigurasi Node
ingestQueryInstances	Jumlah writer/reader node	1-2 (diperlukan)
queryOnlyInstances	Jumlah node pembaca khusus	0-1 (wajib)
dedicatedCompactor	Aktifkan node pemadat khusus	Boolean (wajib)
Pengaturan Pemadatan
compactionRowLimit	Batas baris untuk pemadatan	1-100000000
compactionMaxNumFilesPerPlan	File maksimum per rencana pemadatan	1-10000
compactionGen2Duration	Durasi pemadatan generasi 2	Durasi
compactionMultipliers	Pengganda tingkat pemadatan	Format: “n, n, n, n”
compactionCleanupWait	Tunggu waktu sebelum pembersihan	Durasi
compactionCheckInterval	Interval pemeriksaan pemadatan	Durasi
Konfigurasi Cache
lastValueCacheDisableFromHistory	Nonaktifkan LVC dari data historis	Boolean
distinctValueCacheDisableFromHistory	Nonaktifkan DVC dari data historis	Boolean
Replikasi
replicationInterval	Interval replikasi data	Durasi
catalogSyncInterval	Interval sinkronisasi katalog	Durasi

Mengelola grup parameter

Untuk mengelola grup parameter:

1. Buat: Buat grup parameter baru dengan pengaturan khusus.

2. Associate: Kaitkan grup parameter dengan cluster baru atau yang sudah ada.

3. Hapus atau Ubah: Grup parameter tidak dapat dimodifikasi atau dihapus.

Karena grup parameter tidak dapat diubah, rencanakan konfigurasi Anda dengan hati-hati sebelum membuat cluster. Jika Anda perlu mengubah parameter nanti, Anda harus membuat grup parameter baru dan mengaitkannya dengan cluster Anda, yang dapat memerlukan restart cluster.

Membuat grup parameter

Buat grup parameter 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
    }
  }'

Buat grup parameter InfluxDB 3 Enterprise (konfigurasi 3-node):

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
    }
  }'

Buat grup parameter InfluxDB 3 Enterprise (konfigurasi simpul tunggal):

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
    }
  }'

Menggunakan grup parameter yang ditentukan layanan

Buat cluster dengan grup parameter inti default:

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 \

Buat cluster dengan grup parameter perusahaan default (3-node):

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 \

Buat cluster dengan grup parameter perusahaan simpul tunggal:

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 \

Daftar dan mendeskripsikan parameter Grup

Daftar semua kelompok parameter:

aws timestream-influxdb list-db-parameter-groups

Jelaskan grup parameter tertentu:

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

Grup parameter yang ditentukan layanan Referensi

Amazon Timestream untuk InfluxDB menyediakan tiga grup parameter yang ditentukan layanan:

1. Influx DBv3 Core: Konfigurasi default untuk cluster InfluxDB 3 Core simpul tunggal.

2. Influx DBv3 Enterprise: Konfigurasi default untuk cluster InfluxDB 3 Enterprise 3-node (2 writer/reader node+1 pemadat khusus).

3. Influx DBv3 Enterprise1Node: Konfigurasi default untuk cluster InfluxDB 3 Enterprise simpul tunggal (tidak ada pemadat khusus).

Grup parameter yang ditentukan layanan ini tidak dapat diubah dan dapat digunakan secara langsung atau sebagai templat untuk membuat grup parameter khusus menggunakan opsi. --source-db-parameter-group-id