Configuration d'une base de données globale dans Amazon Neptune

Vous pouvez créer une base de données Neptune globale de l'une des manières suivantes :

• Créez une base de données globale avec de nouveaux clusters de bases de données et de nouvelles instances de base de données.

• Créez une base de données globale en utilisant un cluster de bases de données Neptune existant comme cluster principal.

Exigences de configuration d'une base de données globale dans Amazon Neptune

Une base de données globale Neptune couvre au moins deux Régions AWS. La Région AWS principale contient un cluster de bases de données Neptune qui dispose d'une seule instance d'enregistreur. Une à cinq Régions AWS secondaires contiennent chacune un cluster de bases de données Neptune en lecture seule entièrement composé d'instances de réplica en lecture. Vous devez utiliser au moins une Région AWS secondaire.

Les exigences spécifiques suivantes s'appliquent aux clusters de bases de données Neptune qui composent une base de données globale :

• Exigences relatives aux classes d'instances de base de données : une base de données globale nécessite des classes d'instances de base de données r5 ou r6g optimisées pour les charges de travail gourmandes en mémoire, telles qu'un type d'instance db.r5.large.

• Exigences relatives aux Région AWS : une base de données globale a besoin d'un cluster de bases de données Neptune principal dans une Région AWS et d'au moins un cluster de bases de données Neptune secondaire dans une région différente. Vous pouvez créer jusqu'à cinq clusters de bases de données Neptune secondaires en lecture seule, chacun dans une région différente. En d'autres termes, deux clusters de bases de données Neptune d'une base de données globale Neptune ne peuvent pas se trouver dans la même Région AWS.

• Exigences relatives à la version du moteur : la version de moteur Neptune utilisée par tous les clusters de bases de données de la base de données globale doit être identique et doit être supérieure ou égale à. 1.2.0.0 Si vous ne spécifiez pas la version du moteur lors de la création d'une base de données globale, d'un cluster ou d'une instance, la version du moteur la plus récente est utilisée.

Important

Bien que les groupes de paramètres du cluster de bases de données puissent être configurés indépendamment pour chaque cluster d'une base de données globale, il est préférable de veiller à la cohérence des paramètres entre les clusters afin d'éviter des changements de comportement inattendus au cas où un cluster secondaire serait promu au statut principal. Par exemple, utilisez les mêmes paramètres pour les index d'objets, les flux, etc. dans tous les clusters de bases de données.

Utilisation de l'interface de ligne de commande (AWS CLI) pour créer une base de données globale dans Amazon Neptune

Note

Les exemples présentés dans cette section suivent la convention UNIX qui consiste à utiliser une barre oblique inverse (\) comme caractère d'extension de ligne. Pour Windows, remplacez la barre oblique inverse par un accent circonflexe (^).

Pour créer une base de données globale avec l'interface de ligne de commande (AWS CLI)

1. Commencez par créer une base de données globale vide à l'aide de la commande create-global-cluster d'AWS CLI (qui enveloppe l'API CreateGlobalCluster). Spécifiez le nom de la Région AWS que vous souhaitez utiliser comme région principale, définissez Neptune comme moteur de base de données et, si vous le souhaitez, spécifiez la version du moteur que vous souhaitez utiliser (il doit s'agir de la version 1.2.0.0 ou supérieure) :

   aws neptune create-global-cluster
     --region (primary region, such as us-east-1) \
     --global-cluster-identifier (ID for the global database) \
     --engine neptune \
     --engine-version (engine version; this is optional)

2. Quelques minutes peuvent s'écouler avant que la base de données globale ne soit disponible. Par conséquent, avant de passer à l'étape suivante, utilisez la commande d'interface describe-global-clusters (qui enveloppe l'API DescribeGlobalClusters) pour vérifier que la base de données globale est disponible :

   aws neptune describe-global-clusters \
     --region (primary region) \
     --global-cluster-identifier (global database ID)

3. Une fois que la base de données globale Neptune est disponible, vous pouvez créer un cluster de bases de données Neptune qui sera son cluster principal :

   aws neptune create-db-cluster \
     --region (primary region) \
     --db-cluster-identifier (ID for the primary DB cluster) \
     --engine neptune \
     --engine-version (engine version; must be >= 1.2.0.0) \
     --global-cluster-identifier (global database ID)

4. Utilisez la commande describe-db-clusters d'AWS CLI afin de confirmer que le nouveau cluster de bases de données vous permet à présent d'ajouter son instance de base de données principale :

   aws neptune describe-db-clusters \
     --region (primary region) \
     --db-cluster-identifier (primary DB cluster ID)

   Lorsque la réponse affiche "Status": "available", passez à l'étape suivante.

5. Créez l'instance de base de données principale pour le cluster principal à l'aide de la commande create-db-instance de l'AWS CLI. Vous devez utiliser l'un des types d'instance r5 ou r6g optimisés pour la mémoire, tels que db.r5.large.

   aws neptune create-db-instance \
     --region (primary region) \
     --db-cluster-identifier (primary cluster ID) \
     --db-instance-class (instance class) \
     --db-instance-identifier (ID for the DB instance) \
     --engine neptune \
     --engine-version (optional: engine version)

Note

Si vous prévoyez d'ajouter des données au nouveau cluster de bases de données principal à l'aide du chargeur en bloc Neptune, procédez avant d'ajouter des régions secondaires. Cette approche est plus rapide et plus rentable que d'effectuer un chargement en bloc une fois la base de données globale entièrement configurée.

Ajoutez maintenant une ou plusieurs régions secondaires à la nouvelle base de données globale, comme décrit dans la section Ajout d'une région secondaire à l'aide de l'AWS CLI.

Conversion d'un cluster de bases de données existant en base de données globale

Pour transformer un cluster de bases de données existant en base de données globale, utilisez la commande create-global-cluster de l'AWS CLI pour créer une autre base de données globale dans la même Région AWS que celle du cluster de bases de données existant, puis définissez son paramètre --source-db-cluster-identifier sur l'Amazon Resource Name (ARN) du cluster qui s'y trouve :

aws neptune create-global-cluster \
  --region (region where the existing cluster is located) \
  --global-cluster-identifier (provide an ID for the new global database) \
  --source-db-cluster-identifier (the ARN of the existing DB cluster) \
  --engine neptune \
  --engine-version (engine version; this is optional)

Ajoutez maintenant une ou plusieurs régions secondaires à la nouvelle base de données globale, comme décrit dans la section Ajout d'une région secondaire à l'aide de l'AWS CLI.

Utilisation d'un cluster de bases de données restauré à partir d'un instantané comme cluster principal

Vous pouvez convertir un cluster de bases de données restauré en base de données globale Neptune à partir d'un instantané. Une fois la restauration terminée, convertissez le cluster de bases de données créé en cluster principal d'une nouvelle base de données globale, comme décrit ci-dessus.

Ajout de régions de base de données globales secondaires à une région principale dans Amazon Neptune

Une base de données Neptune globale a besoin d'au moins un cluster de bases de données Neptune secondaire dans une Région AWS différente de celle du cluster de bases de données principal. Vous pouvez attacher jusqu'à cinq clusters de bases de données secondaires au cluster de bases de données principal.

Chaque cluster de bases de données secondaire que vous ajoutez réduit d'une unité le nombre maximum d'instances de réplicas en lecture que vous pouvez avoir sur le cluster principal. Par exemple, s'il existe quatre clusters secondaires, le nombre maximum d'instances de réplica en lecture que vous pouvez avoir sur le cluster principal est de 15 - 4 = 11. Par exemple, si vous avez 14 instances de lecteur dans le cluster de bases de données principal et un seul cluster secondaire, vous ne pouvez pas ajouter de cluster secondaire.

Utilisation de l'AWS CLI pour ajouter une région secondaire à une base de données globale dans Neptune

Pour ajouter une Région AWS secondaire à une base de données globale Neptune à l'aide de l'AWS CLI

1. Utilisez la commande create-db-cluster d'AWS CLI pour créer un cluster de bases de données dans une région différente de celle du cluster principal et définissez son paramètre --global-cluster-identifier pour spécifier l'ID de la base de données globale :

   aws neptune create-db-cluster \
     --region (the secondary region) \
     --db-cluster-identifier (ID for the new secondary DB cluster) \
     --global-cluster-identifier (global database ID)
     --engine neptune \
     --engine-version (optional: engine version)

2. Utilisez la commande describe-db-clusters d'AWS CLI afin de confirmer que le nouveau cluster de bases de données vous permet à présent d'ajouter son instance de base de données principale :

   aws neptune describe-db-clusters \
     --region (primary region) \
     --db-cluster-identifier (primary DB cluster ID)

   Lorsque la réponse affiche "Status": "available", passez à l'étape suivante.

3. Créez l'instance de base de données principale pour le cluster principal à l'aide de la commande create-db-instance de l'AWS CLI, en utilisant un type d'instance dans la classe d'instances r5 ou r6g :

   aws neptune create-db-instance \
     --region (secondary region) \
     --db-cluster-identifier (secondary cluster ID) \
     --db-instance-class (instance class) \
     --db-instance-identifier (ID for the DB instance) \
     --engine neptune \
     --engine-version (optional: engine version)

Note

Si vous n'avez pas l'intention de traiter un grand nombre de demandes de lecture dans la région secondaire et que vous souhaitez principalement y conserver vos données de manière fiable, vous pouvez créer un cluster de bases de données secondaire sans instances de base de données. Vous réalisez ainsi des économies, car vous ne payez alors que les frais correspondant au stockage du cluster secondaire, que Neptune synchronisera avec le stockage du cluster de bases de données principal.

Connexion à une base de données Neptune globale

Vous ne vous connectez pas de la même façon à une base de données Neptune globale selon que vous devez y écrire ou y lire des données :

• Pour les demandes ou requêtes en lecture seule, vous vous connectez au point de terminaison de lecteur du cluster Neptune dans votre Région AWS.

• Pour exécuter des requêtes de mutation, connectez-vous au point de terminaison du cluster de bases de données principal, qui peut se trouver dans une autre Région AWS que celle de votre application.