Utilisation d'un AWS CloudFormation modèle pour mettre à jour la version du moteur de votre cluster de base de données Neptune - Amazon Neptune

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation d'un AWS CloudFormation modèle pour mettre à jour la version du moteur de votre cluster de base de données Neptune

Vous pouvez réutiliser le modèle AWS CloudFormation Neptune que vous avez utilisé pour créer votre cluster de base de données Neptune afin de mettre à jour la version de son moteur.

Les mises à niveau des versions du moteur Neptune peuvent être mineures ou majeures. L'utilisation d'un AWS CloudFormation modèle peut faciliter les mises à niveau des versions majeures, qui contiennent souvent des modifications importantes. Comme les mises à niveau de version majeures peuvent contenir des modifications de base de données qui ne sont pas rétrocompatibles avec les applications existantes, vous devrez peut-être également apporter des modifications à vos applications lors de la mise à niveau. Effectuez toujours des tests avant la mise à niveau. Nous vous recommandons aussi vivement de toujours créer un instantané manuel de votre cluster de bases de données avant la mise à niveau.

Notez que vous devez effectuer une mise à niveau du moteur distincte pour chaque version majeure. Vous ne pouvez pas ignorer une version majeure et passer directement à la version majeure suivante.

Avant le 17 mai 2023, si vous utilisiez la AWS CloudFormation pile Neptune pour mettre à niveau la version de votre moteur, elle créait simplement un nouveau cluster de base de données vide à la place de votre cluster actuel. Cependant, depuis le 17 mai 2023, la suite Neptune prend désormais en charge les mises AWS CloudFormation à niveau du moteur sur place qui préservent vos données existantes.

Note

Si vous utilisez le AWS Cloud Development Kit (AWS CDK), assurez-vous que la AWS CDK version utilisée est 2.82.0 ou ultérieure. Les versions antérieures à 2.82.0 ne prennent pas en charge les mises à niveau sur place du moteur Neptune.

Pour une mise à niveau de version majeure, votre modèle doit définir les propriétés suivantes dans DBCluster :

  • DBClusterParameterGroup (personnalisé ou par défaut)

  • DBInstanceParameterGroupName

  • EngineVersion

De même, pour DBInstances attached to, DBCluster vous devez définir :

  • DBParameterGroup (personnalisé/par défaut)

Assurez-vous que tous vos groupes de paramètres sont définis dans le modèle, qu'ils soient par défaut ou personnalisés.

Dans le cas d'un groupe de paramètres personnalisé, assurez-vous que la famille de votre groupe de paramètres personnalisé existant est compatible avec la nouvelle version du moteur. Les versions du moteur antérieures à 1.2.0.0 utilisaient une famille de groupes de paramètres neptune1, tandis que les versions du moteur à compter de la version 1.2.0.0 nécessitent une famille de groupes de paramètres neptune1.2. Pour plus d’informations, consultez Groupes de paramètres Amazon Neptune.

Pour les mises à niveau majeures des versions du moteur, spécifiez un groupe de paramètres avec la famille appropriée dans le champ DBInstanceParameterGroupName de DBCluster.

Un groupe de paramètres par défaut doit être mis à niveau vers un groupe compatible avec la nouvelle version du moteur.

Notez que Neptune redémarre automatiquement les instances de base de données après une mise à niveau du moteur.