Groupes de paramètres pour les clusters de bases de données dans Timestream for InfluxDB 3

Les paramètres de base de données spécifient comment la base de données est configurée. Vous gérez la configuration de votre base de données en associant vos instances de base de données à des groupes de paramètres.

Amazon Timestream pour InfluxDB définit des groupes de paramètres avec des paramètres par défaut. Vous pouvez également définir vos propres groupes de paramètres à l'aide de paramètres personnalisés. Les groupes de paramètres des éditions Core et Enterprise, bien que similaires, ne sont ni identiques ni interchangeables.

Pour InfluxDB 3, les configurations de cluster sont gérées via des groupes de paramètres. Ces groupes de paramètres contiennent des valeurs de configuration du moteur qui déterminent le fonctionnement de votre cluster InfluxDB 3.

Caractéristiques du groupe de paramètres

• Immuabilité : les groupes de paramètres sont immuables une fois créés. Vous ne pouvez pas modifier les paramètres après leur création.

• Clonage : vous pouvez créer un nouveau groupe de paramètres en clonant un groupe existant et en modifiant les paramètres pendant le processus de clonage. Il s'agit d'une fonctionnalité AWS Management Console unique.

• Suppression : les groupes de paramètres ne peuvent pas être supprimés.

• Groupes par défaut : Timestream for InfluxDB fournit des groupes de paramètres par défaut avec des paramètres préconfigurés optimisés pour les cas d'utilisation courants.

Paramètres clés pour la configuration du cluster

Les groupes de paramètres pour InfluxDB 3 vous permettent de configurer différents aspects de votre cluster, notamment :

• Types de moteurs (InfluxDBV2, Influx DBV3 Core, Influx DBV3 Enterprise)

• Paramètres d'entreprise d'InfluxDB 3

• Groupes de paramètres définis par le service

• Limites de simultanéité des requêtes

• Allocation de mémoire pour les requêtes

• Paramètres du cache de stockage

• Configurations du délai d'expiration HTTP

• Niveaux de log et verbosité

• Paramètres de compactage (version Enterprise)

Lorsque vous créez un nouveau cluster, vous devez l'associer à un groupe de paramètres. Cette association détermine les caractéristiques opérationnelles de votre cluster.

Paramètres communs (disponibles à la fois dans Core et Enterprise)

Paramètre	Description	Gamme/Format
Configuration des requêtes
queryFileLimit	Nombre maximum de fichiers de requête	0-1024
queryLogSize	Taille du journal des requêtes	1 à 10 000
logFilter	Configuration du filtrage des journaux	1024 caractères maximum
logFormat	Format des journaux	« complet »
DataFusion Moteur
dataFusionNumThreads	Nombre de DataFusion fils	1-2048
dataFusionRuntimeType	Modèle d'exécution du runtime	fil en cours, multithread, multi-thread-alt
dataFusionMaxParquetFanout	Ventilation maximale du classeur pour parquet	1-1000000
dataFusionUseCachedParquetLoader	Activer la mise en cache du chargeur Parquet	Booléen
Gestion de mémoire
bufferMemLimitMb	Limite de mémoire tampon en Mo	1024-16777216000
execMemPoolBytes	Taille du pool de mémoire d'exécution	Pourcentage ou valeur absolue
parquetMemCacheSize	Taille du cache mémoire Parquet	Pourcentage ou valeur absolue
forceSnapshotMemThreshold	Seuil de mémoire pour les instantanés forcés	Pourcentage ou valeur absolue
Configuration du WAL
walSnapshotSize	Taille de l'instantané WAL	1 à 10 000
walMaxWriteBufferSize	Taille maximale de la mémoire tampon d'écriture WAL	1-1000000
snapshottedWalFilesToKeep	Nombre de fichiers WAL instantanés à conserver	0-10000
walReplayConcurrencyLimit	Limite de simultanéité des rediffusions WAL	1-100
Paramètres du cache
lastCacheEvictionInterval	Intervalle d'expulsion du cache de dernière valeur	Durée
distinctCacheEvictionInterval	Intervalle d'expulsion du cache à valeurs distinctes	Durée
tableIndexCacheMaxEntries	Nombre maximal d'entrées du cache d'index de table	1 à 1 000
parquetMemCachePrunePercentage	Pourcentage d'élagage du parquet	0-1
Configuration du protocole HTTP
maxHttpRequestSize	Taille maximale des requêtes HTTP	1024-16777216
Conservation et suppression
retentionCheckInterval	Intervalle de vérification de la politique de rétention	Durée
deleteGracePeriod	Période de grâce pour les suppressions	Durée
hardDeleteDefaultDuration	Durée de suppression définitive par défaut	Durée

Paramètres réservés aux entreprises

Paramètre	Description	Gamme/Format
Configuration du nœud
ingestQueryInstances	Nombre de writer/reader nœuds	1-2 (obligatoire)
queryOnlyInstances	Nombre de nœuds de lecture dédiés	0-1 (obligatoire)
dedicatedCompactor	Activer un nœud de compacteur dédié	Booléen (obligatoire)
Paramètres de compactage
compactionRowLimit	Limite de lignes pour le compactage	1-100000000
compactionMaxNumFilesPerPlan	Nombre maximum de fichiers par plan de compactage	1 à 10 000
compactionGen2Duration	Durée de compactage de génération 2	Durée
compactionMultipliers	Multiplicateurs du niveau de compactage	Format : « n, n, n »
compactionCleanupWait	Temps d'attente avant le nettoyage	Durée
compactionCheckInterval	Intervalle de contrôle du compactage	Durée
Configuration du cache
lastValueCacheDisableFromHistory	Désactiver LVC à partir des données historiques	Booléen
distinctValueCacheDisableFromHistory	Désactiver le DVC à partir des données historiques	Booléen
Réplication
replicationInterval	Intervalle de réplication des données	Durée
catalogSyncInterval	Intervalle de synchronisation du catalogue	Durée

Gestion des groupes de paramètres

Pour gérer les groupes de paramètres :

1. Créer : créez un nouveau groupe de paramètres avec des paramètres personnalisés.

2. Associer : associez un groupe de paramètres à un cluster nouveau ou existant.

3. Supprimer ou modifier : les groupes de paramètres ne peuvent pas être modifiés ou supprimés.

Les groupes de paramètres étant immuables, planifiez soigneusement votre configuration avant de créer un cluster. Si vous devez modifier les paramètres ultérieurement, vous devrez créer un nouveau groupe de paramètres et l'associer à votre cluster, ce qui peut nécessiter un redémarrage du cluster.

Création de groupes de paramètres

Créez un groupe de paramètres 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
    }
  }'

Créez un groupe de paramètres InfluxDB 3 Enterprise (configuration à 3 nœuds) :

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

Créez un groupe de paramètres InfluxDB 3 Enterprise (configuration à nœud unique) :

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

Utilisation de groupes de paramètres définis par le service

Créez un cluster avec le groupe de paramètres principaux par défaut :

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 \

Créez un cluster avec le groupe de paramètres d'entreprise par défaut (3 nœuds) :

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 \

Créez un cluster avec un groupe de paramètres d'entreprise à nœud unique :

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 \

Lister et décrire les groupes de paramètres

Répertoriez tous les groupes de paramètres :

aws timestream-influxdb list-db-parameter-groups

Décrivez un groupe de paramètres spécifique :

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

Groupes de paramètres définis par le service Référence

Amazon Timestream pour InfluxDB fournit trois groupes de paramètres définis par le service :

1. Influx DBv3 Core : configuration par défaut pour les clusters InfluxDB 3 Core à nœud unique.

2. Influx DBv3 Enterprise : configuration par défaut pour les clusters InfluxDB 3 Enterprise à 3 nœuds (2 writer/reader nœuds + 1 compacteur dédié).

3. Influx DBv3 Enterprise1Node : configuration par défaut pour les clusters InfluxDB 3 Enterprise à nœud unique (pas de compacteur dédié).

Ces groupes de paramètres définis par le service sont immuables et peuvent être utilisés directement ou comme modèles pour créer des groupes de paramètres personnalisés à l'aide de l'option. --source-db-parameter-group-id