Version 1.0.3.0 du moteur Amazon Neptune (03/08/2020)

Depuis le 3 août 2020, la version 1.0.3.0 du moteur est déployée globalement. Notez que plusieurs jours sont nécessaires pour qu'une nouvelle version soit disponible dans chaque région.

Versions de correctifs ultérieures pour cette version

• Sortie : 1.0.3.0.R2 (12/10/2020)

• Sortie : 1.0.3.0.R3 (19/02/2021)

Nouvelles fonctionnalités pour cette version du moteur

• Neptune a introduit un nouveau moteur de requête alternatif (DFE) qui contribue à accélérer considérablement l'exécution des requêtes. Consultez Autre moteur de requête (DFE) Amazon Neptune.

• Ce DFE s'appuie sur des statistiques prégénérées concernant les données du graphe Neptune, qui sont gérées via de nouveaux points de terminaison de statistiques. Consultez Statistiques DFE.

• Vous pouvez désormais exclure les tâches de chargement en file d'attente de la liste des identifiants de chargement renvoyés par l'API Loader Get-Status en définissant le nouveau paramètre includeQueuedLoads sur FALSE. Consultez Paramètres de demande Neptune Loader Get-Status.

• Neptune prend désormais en charge les en-têtes de fin pour les réponses aux requêtes SPARQL, qui peuvent contenir un code d'erreur et un message si une demande échoue après avoir commencé à renvoyer des fragments de réponse. Consultez En-têtes de suivi HTTP facultatifs pour les réponses SPARQL en plusieurs parties.

• Neptune vous permet désormais également d'activer l'encodage des réponses fragmentées pour les requêtes Gremlin. Comme dans le cas de SPARQL, les segments de réponse ont des en-têtes de fin qui peuvent contenir un code d'erreur et un message en cas d'échec après que la requête a commencé à renvoyer des fragments de réponse. Consultez Utilisation d'en-têtes de suivi HTTP facultatifs pour activer les réponses Gremlin en plusieurs parties.

Améliorations de cette version du moteur

• Vous pouvez désormais indiquer la taille des demandes par lots à ElasticSearch pour les recherches en texte intégral dans Gremlin.

• Amélioration de l'utilisation de la mémoire pour les requêtes SPARQL GROUP BY.

• Ajout d'un nouvel optimiseur de requêtes Gremlin pour affiner certains filtres indépendants.

• Augmentation de la durée maximale pendant laquelle une connexion WebSocket authentifiée à l'aide d'IAM peut rester ouverte. Cette durée est passée de 36 heures à 10 jours.

Défauts corrigés dans cette version du moteur

• Correction d'un bogue selon lequel, si vous envoyiez un paramètre d'URL non encodé dans une requête POST, Neptune renvoyait le code de statut HTTP 500 et une exception InternalServerErrorException. Neptune renvoie maintenant le code de statut HTTP 400 et une exception BadRequestException, avec le message : Failure to process the POST request parameters.

• Correction d'un bogue Gremlin qui empêchait le signalement correct d'un échec de connexion WebSocket.

• Correction d'un bogue Gremlin lié à la disparition des effets secondaires.

• Correction d'un bogue Gremlin qui empêchait la prise en charge correcte du paramètre de recherche en texte intégral batchsize.

• Correction d'un bogue Gremlin pour gérer toV et fromV individuellement pour chaque direction. bothE

• Correction d'un bogue Gremlin impliquant Edge pathType dans l'étape hasLabel.

• Correction d'un bogue SPARQL en raison duquel la réorganisation des jointures avec des liaisons statiques ne fonctionnait pas correctement.

• Correction d'un bogue SPARQL UPDATE LOAD en raison duquel un compartiment Amazon S3 indisponible n'était pas correctement signalé.

• Correction d'un bogue SPARQL en raison duquel un problème avec un nœud SERVICE dans une sous-requête n'était pas correctement signalé.

• Correction d'un bogue SPARQL en raison duquel les requêtes contenant des conditions FILTER EXISTS ou FILTER NOT EXISTS imbriquées n'étaient pas correctement évaluées.

• Correction d'un bogue SPARQL pour gérer correctement les liaisons générées en double lors de l'appel des points de terminaison du service SPARQL via des requêtes de génération.

Versions de langage de requête prises en charge dans cette version

Avant de mettre à niveau un cluster de bases de données vers la version 1.0.3.0, assurez-vous que votre projet est compatible avec les versions de langage de requête suivantes :

• Version Gremlin : 3.4.3

• Version SPARQL : 1.1

Chemins de mise à niveau vers la version de moteur 1.0.3.0

Vous pouvez mettre à niveau manuellement n'importe quelle version antérieure du moteur Neptune vers cette version.

Si le paramètre AutoMinorVersionUpgrade de votre cluster est défini sur True, votre cluster sera automatiquement mis à niveau vers cette version de moteur deux à trois semaines après la date de cette version, au cours d'une fenêtre de maintenance.

Mise à niveau vers cette version

Amazon Neptune 1.0.3.0 est désormais disponible globalement.

Si un cluster de bases de données exécute une version de moteur à partir de laquelle il existe un chemin de mise à niveau vers cette version, il peut être mis à niveau dès maintenant. Vous pouvez mettre à niveau n'importe quel cluster éligible à l'aide des opérations de cluster de bases de données sur la console ou à l'aide du kit SDK. La commande CLI suivante met immédiatement à niveau un cluster éligible :

Pour Linux, OS X ou Unix :

aws neptune modify-db-cluster \
    --db-cluster-identifier (your-neptune-cluster) \
    --engine-version 1.0.3.0 \
    --apply-immediately

Pour Windows :

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.3.0 ^
    --apply-immediately

Les mises à jour sont appliquées simultanément à toutes les instances figurant dans un cluster de bases de données. Une mise à jour nécessite un redémarrage de la base de données sur ces instances. Vous subirez donc un temps d'arrêt allant de 20-30 secondes à plusieurs minutes, après quoi vous pourrez reprendre l'utilisation du cluster de bases de données.

Toujour effectuer des tests avant la mise à niveau

Lorsqu'une nouvelle version majeure ou mineure du moteur Neptune est publiée, testez toujours vos applications Neptune sur cette version avant de procéder à la mise à niveau. Même une mise à niveau mineure peut introduire de nouvelles fonctionnalités ou de nouveaux comportements susceptibles d'affecter le code.

Commencez par comparer les pages de notes de mise à jour de votre version actuelle à celles de la version cible pour déterminer s'il existe des modifications des versions de langage de requête ou d'autres changements majeurs.

Le meilleur moyen de tester une nouvelle version avant de mettre à niveau le cluster de bases de données de production est de cloner ce cluster pour qu'il exécute cette nouvelle version du moteur. Vous pouvez ainsi exécuter des requêtes sur le clone sans affecter le cluster de bases de données de production.

Toujours créer un instantané manuel avant de procéder à la mise à niveau

Avant la mise à niveau, nous vous recommandons vivement de toujours créer un instantané manuel du cluster de bases de données. Un instantané automatique n'offre qu'une protection à court terme, tandis qu'un instantané manuel reste disponible jusqu'à ce que vous le supprimiez explicitement.

Dans certains cas, Neptune crée un instantané manuel pour vous dans le cadre du processus de mise à niveau, mais il est préférable de ne pas compter sur ce mécanisme et de créer dans tous les cas votre propre instantané manuel.

Lorsque vous êtes certain de ne pas avoir besoin de rétablir l'état antérieur à la mise à niveau de votre cluster de bases de données, vous pouvez supprimer explicitement l'instantané manuel que vous avez créé vous-même, ainsi que celui que Neptune a éventuellement créé. Si Neptune crée un instantané manuel, il porte un nom commençant par preupgrade, suivi du nom de votre cluster de bases de données, de la version du moteur source, de la version du moteur cible et de la date.

Note

Si vous essayez de procéder à une mise à niveau alors qu'une action en attente est en cours, une erreur telle que la suivante peut survenir :

   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.

Si vous rencontrez cette erreur, attendez que l'action en attente soit terminée ou déclenchez immédiatement une fenêtre de maintenance pour laisser la mise à niveau précédente se terminer.

Pour plus d'informations sur la mise à niveau de la version du moteur , consultez Maintenance du cluster de bases de données Amazon Neptune. En cas de question ou de doute, l'équipe AWS Support est disponible sur les forums de la communauté et via AWS Premium Support.