Version 1.0.4.2.R2 du moteur Amazon Neptune (01/06/2021)

Depuis le 1er juin 2021, la version 1.0.4.2.R2 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.4.2.R3 (28/06/2021)

Problèmes connus dans cette version du moteur

Problème :

Bogue SPARQL qui ne respecte pas le type de média dans un en-tête Accepten cas d'espaces.

Par exemple, une requête -H "Accept: text/csv; q=1.0, */*; q=0.1" renvoie une sortie JSON plutôt qu'une sortie CSV.

Solution :

Si vous supprimez les espaces dans la clause Accept de l'en-tête, le moteur renvoie le résultat dans le format demandé correct. En d'autres termes, au lieu de -H "Accept: text/csv; q=1.0, */*; q=0.1" , utilisez :

  -H "Accept: text/csv;q=1.0,*/*;q=0.1"

Nouvelles fonctionnalités pour cette version du moteur

• Ajout du nouveau type d'instance R5d, qui inclut un cache de recherche pour accélérer les lectures dans les cas d'utilisation impliquant un volume élevé de recherche de valeurs de propriété ou de littéraux RDF. Consultez Le cache de recherche Neptune peut accélérer les requêtes de lecture.

• Ajout d'un nouveau paramètre en mode laboratoire qui permet au moteur DFE expérimental d'être invoqué uniquement par requête avec l'indicateur de requête useDFE.

Améliorations de cette version du moteur

• Ajout de la prise en charge de TinkerPop 3.4.10.

• Ajout de la prise en charge de l'utilisation de l'étape de configuration withStrategies( ) lors de l'envoi de requêtes de script Gremlin. Plus précisément, les étapes SubgraphStrategy, PartitionStrategy, ReadOnlyStrategy, EdgeLabelVerificationStrategy et ReservedKeysVerificationStrategy sont toutes prises en charge.

• Ajout de l'optimisation des traversées V() au milieu d'une requête. Auparavant, ces traversées n'étaient pas optimisées dans Neptune.

• Ajout de la prise en charge des URN RFC 2141 à utiliser comme paramètres baseUri et namedGraphUri pour un chargement en bloc.

Défauts corrigés dans cette version du moteur

• Correction d'un bogue Gremlin dans l'analyseur dans lequel les requêtes incorrectes étaient considérées comme valides.

• Correction d'un bogue Gremlin où le déploiement d'un effet secondaire aggregate() avec cap().unfold() pour le remplacer par valueMap() provoquait une exception.

• Correction d'un bogue Gremlin qui provoquait l'échec de certaines étapes property() après une étape addV() avec l'erreur « cannot cast to String » (Conversion en chaîne impossible).

• Correction d'un bogue Gremlin qui empêchait certains modèles d'insertion conditionnelle de déclencher des exceptions de modification simultanée.

• Correction d'un bogue Gremlin de sorte que le délai d'expiration de la demande de requête ne puisse plus dépasser le délai d'expiration de la session.

• Correction d'un bogue SPARQL en raison duquel les mises à jour utilisant LOAD ou UNLOAD pouvaient échouer avec un code HTTP 500 au lieu du code HTTP 400 lorsque le serveur distant n'était pas disponible.

• Correction d'un bogue où les appels d'API de flux échouaient lorsque des valeurs commitNum ou opNum supérieures à la limite d'entiers signés de 32 bits (2 147 483 647) étaient utilisées.

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.4.2.R2, assurez-vous que votre projet est compatible avec les versions de langage de requête suivantes :

• Version Gremlin : 3.4.10

• Version SPARQL : 1.1

Chemins de mise à niveau vers la version de moteur 1.0.4.2.R2

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

La mise à niveau vers cette version n'est pas automatique.

Mise à niveau vers cette version

Amazon Neptune 1.0.4.2.R2 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.4.2 \
    --apply-immediately

Pour Windows :

aws neptune modify-db-cluster ^
    --db-cluster-identifier (your-neptune-cluster) ^
    --engine-version 1.0.4.2 ^
    --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.