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.
QLDBpilote Amazon pour Node.js
Important
Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre
Pour utiliser les données de votre registre, vous pouvez vous connecter à Amazon QLDB depuis votre application Node.js à l'aide d'un pilote AWS fourni. Les rubriques suivantes décrivent comment démarrer avec le QLDB pilote pour Node.js.
Rubriques
Ressources pour les conducteurs
Pour plus d'informations sur les fonctionnalités prises en charge par le pilote Node.js, consultez les ressources suivantes :
Prérequis
Avant de commencer à utiliser le QLDB pilote pour Node.js, vous devez effectuer les opérations suivantes :
-
Suivez les instructions AWS de configuration indiquées dansAccès à Amazon QLDB. Cela inclut les éléments suivants :
-
Inscrivez-vous pour AWS.
-
Créez un utilisateur doté des QLDB autorisations appropriées.
-
Accordez un accès programmatique pour le développement.
-
-
Installez Node.js version 14.x ou ultérieure à partir du site de téléchargement de Node.js
. (Les versions précédentes du pilote prennent en charge la version 10.x ou ultérieure de Node.js.) -
Configurez votre environnement de développement pour le AWS SDKfor JavaScript dans Node.js
: -
Configurez vos AWS informations d'identification. Nous vous recommandons de créer un fichier d'informations d'identification partagé.
Pour obtenir des instructions, consultez la section Chargement des informations d'identification dans le fichier Node.js à partir du fichier d'informations d'identification partagé du manuel du AWS SDK for JavaScript développeur.
-
Définissez votre valeur par défaut Région AWS. Pour savoir comment procéder, reportez-vous à la section Configuration du Région AWS.
Pour obtenir la liste complète des régions disponibles, consultez la section QLDBPoints de terminaison et quotas Amazon dans le Références générales AWS.
-
Ensuite, vous pouvez télécharger l'exemple d'application complet du didacticiel, ou vous pouvez installer uniquement le pilote dans un projet Node.js et exécuter des exemples de code abrégé.
-
Pour installer le QLDB pilote et le AWS SDK for JavaScript dans le fichier Node.js dans un projet existant, passez àInstallation.
-
Pour configurer un projet et exécuter des exemples de codes abrégés illustrant les transactions de données de base sur un registre, consultez leTutoriel de démarrage rapide.
-
Pour obtenir des exemples plus approfondis d'APIopérations de gestion et de données dans l'exemple d'application complet du didacticiel, consultez leTutoriel Node.js.
Installation
QLDBprend en charge les versions de pilotes suivantes et leurs dépendances avec Node.js.
Pour installer le QLDB pilote à l'aide de npm (le gestionnaire de packages Node.js)
Le pilote a des dépendances entre pairs sur les packages suivants. Vous devez également installer ces packages en tant que dépendances dans votre projet.
Utiliser le pilote pour se connecter à un registre
Vous pouvez ensuite importer le pilote et l'utiliser pour vous connecter à un registre. L'exemple de TypeScript code suivant montre comment créer une instance de pilote pour un nom de registre spécifié et Région AWS.
Pour des exemples de code abrégé expliquant comment exécuter des transactions de données de base sur un registre, consultez leRéférence de livre de cuisine.
Recommandations de configuration
Réutilisation des connexions avec keep-alive
L'HTTPSagent Node.jsHTTP/par défaut crée une nouvelle TCP connexion pour chaque nouvelle demande. Pour éviter les coûts liés à l'établissement d'une nouvelle connexion, la AWS SDK for JavaScript v3 réutilise les TCP connexions par défaut. Pour plus d'informations et pour savoir comment désactiver la réutilisation des connexions, consultez la section Réutilisation des connexions avec keep-alive dans le fichier Node.js du manuel du développeur.AWS SDK for JavaScript
Nous vous recommandons d'utiliser le paramètre par défaut pour réutiliser les connexions dans le QLDB pilote pour Node.js. Lors de l'initialisation du pilote, définissez l'HTTPoption client de bas niveau maxSockets
sur la même valeur que celle que vous avez définie. maxConcurrentTransactions
Par exemple, reportez-vous au TypeScript code suivant JavaScript .
L'HTTPSagent Node.jsHTTP/par défaut crée une nouvelle TCP connexion pour chaque nouvelle demande. Pour éviter les coûts liés à l'établissement d'une nouvelle connexion, nous vous recommandons de réutiliser une connexion existante.
Pour réutiliser les connexions dans le QLDB pilote pour Node.js, utilisez l'une des options suivantes :
-
Lors de l'initialisation du pilote, définissez les options client HTTP de bas niveau suivantes :
-
keepAlive
–true
-
maxSockets
— La même valeur que celle que vous avez définie pourmaxConcurrentTransactions
Par exemple, reportez-vous au TypeScript code suivant JavaScript .
-
-
Vous pouvez également définir la variable d'
AWS_NODEJS_CONNECTION_REUSE_ENABLED
environnement sur1
. Pour plus d'informations, consultez la section Réutilisation des connexions avec Keep-Alive dans Node.js dans le manuel du AWS SDK for JavaScript développeur.Note
Si vous définissez cette variable d'environnement, elle affecte tous ceux Services AWS qui utilisent le AWS SDK for JavaScript.