Groupes de paramètres Amazon Neptune

Vous gérez la configuration de votre base de données dans Amazon Neptune en utilisant les paramètres d'un groupe de paramètres. Les groupes de paramètres servent de conteneur pour les valeurs de configuration du moteur qui sont appliquées à une ou plusieurs instances de base de données.

Il existe deux types de groupes de paramètres de base de données, à savoir les groupes de paramètres de base 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 graphique Neptune, tels que leneptune_query_timeout paramètre.

• 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 base de données. Chaque instance de base de données de ce cluster hérite des valeurs de configuration du moteur contenues dans le groupe de paramètres du 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 base de données d'un cluster de base 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 du groupe de paramètres de base de données par défaut. Pour modifier les valeurs de paramètre par défaut, vous devez plutôt 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 créé.

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 estneptune1, qui est compatible avec toutes les versions du moteur antérieures à1.2.0.0. En commençant parVersion : 1.2.0.0 (21/07/07), la famille de groupes deneptune1.2 paramètres doit être utilisée à la place. Cela signifie que lorsque vous passez à une version supérieure1.2.0.0 ou supérieure, vous devez d'abord recréer tous vos groupes de paramètres personnalisés de laneptune1.2 famille afin de pouvoir les associer lors de la mise à niveau.

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

Paramètres statiques

• Un paramètre statique prend effet uniquement 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 est appliquée. Actuellement, tous les paramètres au niveau de l'instance 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 du paramètre est appliquée une fois que vous avez redémarré manuellement chaque instance de base de données du cluster de base de données.

Paramètres dynamiques

• Un paramètre dynamique prend effet presque immédiatement après la mise à jour du paramètre 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 la mise à jour d'un paramètre dynamique pour que le changement de paramètre prenne effet.

• Attendez-vous à un léger délai pour qu'une modification dynamique des paramètres du cluster 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 du paramètre est appliquée à votre cluster de base 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 pour définir laAWS CLI valeurApplyMethod à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

  AuparavantVersion : 1.2.0.0 (21/07/07), toutes les instances en lecture-réplique d'un cluster de base de données étaient automatiquement redémarrées chaque fois que l'instance principale (d'écriture) redémarrait.

  ÀVersion : 1.2.0.0 (21/07/07) partir de maintenant, le redémarrage de l'instance principale n'entraîne le redémarrage d'aucune des instances répliquées. Cela signifie que si vous modifiez un paramètre au niveau du cluster, vous devez redémarrer chaque instance séparément pour prendre en compte le changement de paramètre.

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 ConsoleAWS de gestion 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. Choisissez Modifier les paramètres.

5. Définissez les valeurs pour les paramètres que vous souhaitez modifier.

6. Choisissez Save Changes (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 un groupe de paramètres de cluster de base de données

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

1. Connectez-vous à la ConsoleAWS de gestion 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 des familles 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. Sélectionnez Create (Créer).

Vous pouvez également créer un groupe de paramètres de base de données à l'aide duAWS 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)