Groupes de paramètres Amazon Neptune

Vous gérez votre configuration de base de données dans Amazon Neptune à l'aide de paramètres dans un groupe de paramètres. Les groupes de paramètres servent de conteneurs pour les valeurs de configuration de moteur qui sont appliquées à une ou plusieurs instances de base de données.

Il existe deux types de groupes de paramètres : les groupes de paramètres de cluster de bases de données et les groupes de paramètres de base de données.

• Les groupes de paramètres de base de données s'appliquent au niveau de l'instance et sont généralement associés aux paramètres du moteur de graphe Neptune, comme le paramètre neptune_query_timeout.

• Les groupes de paramètres de cluster de base de données s'appliquent à chaque instance du cluster et ont généralement des valeurs plus générales. Chaque cluster Neptune est associé à un groupe de paramètres de cluster de bases de données. Toutes les instances de base de données au sein de ce cluster héritent des valeurs de configuration du moteur contenues dans le groupe de paramètres de cluster de bases de données.

Les valeurs de configuration que vous modifiez dans le groupe de paramètres de cluster de base de données remplacent les valeurs par défaut du groupe de paramètres de base de données. Si vous modifiez les valeurs correspondantes dans le groupe de paramètres de base de données, ces valeurs remplacent celles du groupe de paramètres de cluster de bases de données.

Un groupe de paramètres de base de données par défaut est utilisé si vous créez une instance de base de données sans spécifier un groupe de paramètres de base de données personnalisé. Vous ne pouvez pas modifier les valeurs de paramètre d'un groupe de paramètres de base de données par défaut. Pour modifier les paramètres par défaut, vous devez créer un groupe de paramètres de base de données. Il n'est pas possible de modifier tous les paramètres de moteur de base de données dans un groupe de paramètres de base de données que vous créez.

Les groupes de paramètres sont créés dans des familles compatibles avec les différentes versions du moteur Neptune. La famille de groupes de paramètres par défaut est neptune1, qui est compatible avec toutes les versions du moteur antérieures à 1.2.0.0. À partir de la Sortie : 1.2.0.0 (21/07/2022), la famille de groupes de paramètres neptune1.2 doit être utilisée à la place. Par conséquent, lorsque vous effectuez une mise à niveau vers 1.2.0.0 ou une version ultérieure, vous devrez d'abord recréer tous les groupes de paramètres personnalisés de la famille neptune1.2 afin de pouvoir les associer lors de la mise à niveau.

Certains paramètres Neptune sont statiques, tandis que d'autres sont dynamiques. Les différences sont les suivantes :

Paramètres statiques

• Un paramètre statique est un paramètre qui ne prend effet qu'après le redémarrage d'une instance de base de données. En d'autres termes, lorsque vous modifiez un paramètre statique et que vous enregistrez le groupe de paramètres de base de données d'une instance, vous devez redémarrer manuellement l'instance de base de données pour que la modification du paramètre soit appliquée. Actuellement, tous les paramètres au niveau des instances Neptune (dans un groupe de paramètres de base de données plutôt que dans un groupe de paramètres de cluster de bases de données) sont statiques.

• Lorsque vous modifiez un paramètre statique au niveau du cluster et que vous enregistrez le groupe de paramètres de base de données d'un cluster, la modification de ce paramètre est appliquée après que vous avez redémarré manuellement chaque instance de base de données du cluster.

Paramètres dynamiques

• Un paramètre dynamique est un paramètre qui prend effet presque immédiatement après sa mise à jour dans son groupe de paramètres. En d'autres termes, il n'est pas nécessaire de redémarrer une instance de base de données après avoir mis à jour un paramètre dynamique pour que la modification prenne effet.

• Attendez-vous à un léger délai avant que la modification d'un paramètre de cluster dynamique soit appliquée à toutes les instances de base de données.

• Une valeur de paramètre dynamique mise à jour n'est pas appliquée aux demandes en cours d'exécution, mais uniquement à celles soumises après la modification.

• Lorsque vous modifiez un paramètre dynamique au niveau du cluster, par défaut, la modification de ce paramètre est appliquée à votre cluster de bases de données immédiatement, sans nécessiter de redémarrage. Pour reporter la modification du paramètre après le redémarrage des instances de base de données du cluster, vous pouvez utiliser l'AWS CLI pour définir la valeur ApplyMethod sur pending-reboot pour la modification du paramètre.

Actuellement, tous les paramètres sont statiques, à l'exception des nouveaux paramètres de cluster suivants :

• neptune_enable_slow_query_log (au niveau du cluster)

• neptune_slow_query_log_threshold (au niveau du cluster)

Voici quelques éléments importants que vous devez connaître concernant l'utilisation de paramètres dans un groupe de paramètres DB :

• La configuration incorrecte de paramètres dans un groupe de paramètres DB peut avoir des effets contraires involontaires, dont une dégradation de la performance et une instabilité du système. Montrez-vous toujours prudent lorsque vous modifiez des paramètres de base de données et sauvegardez vos données avant de modifier un groupe de paramètres de base de données. Testez les modifications de paramètres de votre groupe de paramètres sur une instance de base de données test avant d'appliquer ces modifications à une instance de base de données de production.

• Lorsque vous modifiez le groupe de paramètres DB associé à une instance de base de données, vous devez redémarrer manuellement l'instance avant que le nouveau groupe de paramètres DB soit utilisé par l'instance de base de données.

  Note

  Avant la Sortie : 1.2.0.0 (21/07/2022), toutes les instances de réplica en lecture d'un cluster de bases de données étaient automatiquement redémarrées lors du redémarrage de l'instance (d'enregistreur) principale.

  À compter de la Sortie : 1.2.0.0 (21/07/2022), le redémarrage de l'instance principale n'entraîne le redémarrage d'aucune des instances de réplica. Dès lors, si vous modifiez un paramètre au niveau du cluster, vous devez redémarrer chaque instance séparément pour que cette modification de paramètre s'applique.

Modification d'un groupe de paramètres de cluster de base de données ou d'un groupe de paramètres de base de données

1. Connectez-vous à la console de gestion AWS et ouvrez la console Amazon Neptune à l'adresse https://console.aws.amazon.com/neptune/home.

2. Choisissez Parameter groups (Groupes de paramètres) dans le volet de navigation.

3. Choisissez le lien Name (Nom) pour le groupe de paramètres de base de données à modifier.

   (Facultatif) Choisissez Create parameter group (Créer un groupe de paramètres) pour créer un nouveau groupe de paramètres de cluster. Choisissez ensuite le Name (Nom) du nouveau groupe de paramètres.

   Important

   Cette étape est obligatoire si vous ne disposez que du groupe de paramètres de cluster de base de données par défaut, car ce groupe de paramètres ne peut pas être modifié.

4. Recherchez le paramètre et cliquez sur le champ Valeur à côté de la colonne Nom.

5. Entrez la valeur autorisée et cochez la case à côté du champ de valeur.

6. Sélectionnez Enregistrer les modifications.

7. Redémarrez chaque instance de base de données du cluster Neptune si vous modifiez un paramètre de cluster de bases de données, ou une ou plusieurs instances spécifiques si vous modifiez un paramètre d'instance de base de données.

Création d'un groupe de paramètres de base de données ou d'un groupe de paramètres de cluster de bases de données

Vous pouvez facilement utiliser la console Neptune pour créer un groupe de paramètres :

1. Connectez-vous à la console de gestion AWS et ouvrez la console Amazon Neptune à l'adresse https://console.aws.amazon.com/neptune/home.

2. Choisissez Parameter groups (Groupes de paramètres) dans le volet de navigation de gauche.

3. Choisissez Create DB parameter group (Créer un groupe de paramètres de base de données).

   La page Create DB parameter group (Créer un groupe de paramètres de base de données) s'affiche.

4. Dans la liste Famille de groupes de paramètres, choisissez neptune1 ou, si vous ciblez la version 1.2.0.0 ou supérieure du moteur, choisissez neptune1.2.

5. Dans la liste Type, choisissez DB Parameter Group (Groupe de paramètres de base de données) ou DB Cluster Parameter Group (Groupe de paramètres de cluster de base de donnée).

6. Dans la zone Nom du groupe, saisissez le nom du nouveau groupe de paramètres de base de données.

7. Dans la zone Description, saisissez une description pour le nouveau groupe de paramètres de base de données.

8. Choisissez Créer.

Vous pouvez également créer un groupe de paramètres à l'aide de l'AWS CLI :

aws neptune create-db-parameter-group \
  --db-parameter-group-name (a name for the new DB parameter group) \
  --db-parameter-group-family (either neptune1 or neptune1.2, depending on the engine version) \
  --description (a description for the new DB parameter group)