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.
# NoSQL Workbench pour DynamoDB
NoSQL Workbench pour Amazon DynamoDB est une application côté client multiplateforme pour le développement et les opérations de base de données moderne. Il est disponible pour Windows, macOS et Linux. NoSQL Workbench vous permet de concevoir des modèles de données DynamoDB, de définir des modèles d'accès en tant que véritables opérations DynamoDB et de les valider à l'aide d'exemples de données. Vous pouvez également organiser vos modèles de données en projets. NoSQL Workbench inclut DynamoDB local, qui permet de tester vos tables et vos index avant de transférer votre modèle de données dans le cloud. Pour en savoir plus sur DynamoDB local et ses exigences, consultez [Configuration de DynamoDB Local (version téléchargeable)](DynamoDBLocal.md).
**Modélisateur de données**
Avec NoSQL Workbench pour DynamoDB, vous pouvez démarrer un nouveau projet à partir de zéro ou utiliser un exemple de projet correspondant à votre cas d'utilisation. Ensuite, vous concevez des tables et des index secondaires globaux, définissez des attributs et configurez des exemples de données. Vous pouvez également visualiser vos modèles d'accès sous forme d'opérations DynamoDB réelles PutItem ( UpdateItem,, Query, etc.) et exécuter ces opérations sur les exemples de données configurés pour vérifier que le modèle d'accès fonctionne comme prévu, en ajustant le modèle de données en fonction des résultats de validation. Enfin, une fois validé, vous validez le modèle dans DynamoDB local ou dans AWS votre compte pour des tests supplémentaires et une utilisation en production. Pour la collaboration, vous pouvez importer et exporter des modèles de données conçus. Pour de plus amples informations, veuillez consulter [Création de modèles de données avec NoSQL Workbench](workbench.Modeler.md).
**Créateur d’opérations**
NoSQL Workbench fournit une interface utilisateur graphique enrichie pour développer et tester des requêtes. Vous pouvez utiliser le *créateur d’opérations* pour consulter, explorer et interroger des ensembles de données en temps réel. Le créateur d’opérations structurées prend en charge l’expression de projection ainsi que l’expression de condition et génère des exemples de code dans plusieurs langages. Vous pouvez cloner directement des tables d’un compte Amazon DynamoDB vers un autre dans différentes régions. Vous pouvez également cloner directement des tables entre DynamoDB local et un compte Amazon DynamoDB pour copier plus rapidement le schéma de clés de votre table (et éventuellement le schéma GSI et les éléments) entre vos environnements de développement. Pour plus d’informations, consultez [Exploration des jeux de données et des opérations de création avec NoSQL Workbench](workbench.querybuilder.md).
La vidéo ci-dessous détaille les concepts de modélisation des données avec NoSQL Workbench.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/p5va6ZX9_o0?si=vqQuf6FjoBuK1phR)
**Topics**
+ [Télécharger NoSQL Workbench pour DynamoDB](workbench.settingup.md)
+ [Création de modèles de données avec NoSQL Workbench](workbench.Modeler.md)
+ [Exploration des jeux de données et des opérations de création avec NoSQL Workbench](workbench.querybuilder.md)
+ [Exemples de modèle de données pour NoSQL Workbench](workbench.SampleModels.md)
+ [Historique de version pour NoSQL Workbench](WorkbenchDocumentHistory.md)
# Télécharger NoSQL Workbench pour DynamoDB
Suivez ces instructions pour télécharger NoSQL Workbench et DynamoDB local pour Amazon DynamoDB.
**Pour télécharger NoSQL Workbench et DynamoDB local**
+ Téléchargez la version appropriée de NoSQL Workbench pour votre système d’exploitation.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/workbench.settingup.html)
**Note**
NoSQL Workbench inclut DynamoDB local dans le cadre du processus d'installation.
La version 17.x ou ultérieure de Java Runtime Environment (JRE) est requise pour exécuter DynamoDB en local.
**Note**
NoSQL Workbench prend en charge Ubuntu 12.04, Fedora 21 et Debian 8, ou toute version plus récente de ces distributions Linux.
Deux logiciels prérequis sont requis pour les installations d'Ubuntu : `libfuse2` et`curl`.
Depuis Ubuntu 22.04, libfuse2 n’est plus installé par défaut. Pour résoudre ce problème, exécutez `sudo add-apt-repository universe && sudo apt install libfuse2` l'installation pour la dernière version d'Ubuntu.
Pour cURL, exécutez. `sudo apt update && sudo apt upgrade && sudo apt install curl`
# Création de modèles de données avec NoSQL Workbench
Vous pouvez utiliser l'outil de modélisation de données de NoSQL Workbench pour Amazon DynamoDB pour créer de nouveaux modèles de données ou pour concevoir des modèles basés sur des modèles de données existants qui répondent aux modèles d'accès aux données de votre application. Le modélisateur de données comprend quelques exemples de modèles de données pour vous aider à démarrer.
**Topics**
+ [Création d’un modèle de données](workbench.Modeler.CreateNew.md)
+ [Importation d’un modèle de données existant](workbench.Modeler.ImportExisting.md)
+ [Modification d’un modèle de données existant](workbench.Modeler.Edit.md)
+ [Ajout d’un exemple de données à un modèle de données](workbench.Modeler.AddData.md)
+ [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md)
+ [Importation des exemples de données à partir d’un fichier CSV](workbench.Modeler.ImportCSV.md)
+ [Facettes](workbench.Modeler.Facets.md)
+ [Affichage de toutes les tables dans un modèle de données à l’aide de la vue d’agrégation](workbench.Modeler.AggregateView.md)
+ [Exportation d’un modèle de données](workbench.Modeler.ExportModel.md)
+ [Validation d’un modèle de données dans DynamoDB](workbench.Modeler.Commit.md)
# Création d’un modèle de données
Procédez comme suit pour créer un modèle de données dans Amazon DynamoDB à l’aide de NoSQL Workbench.
**Pour créer un modèle de données**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, sélectionnez **Créer un** modèle manuellement.
Une nouvelle page s'ouvrira avec une configuration vide pour votre première table. **NoSQL Workbench crée tous les nouveaux modèles de données avec un nom par défaut (c'est-à-dire untitled-2) et les ajoute au dossier du projet Drafts.**
1. Sur l'**écran de configuration de la table**, spécifiez les éléments suivants :
+ **Table name (Nom de table)** – Saisissez un nom unique pour la table.
+ **Clé de partition** : entrez le nom de la clé de partition et spécifiez son type. De même, vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple.
+ Si vous souhaitez ajouter une **clé de tri**, spécifiez le nom de la clé de tri et son type. Vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple.
**Note**
Pour en savoir plus sur la conception des clés primaires, la conception et l’utilisation efficaces des clés de partition et l’utilisation des clés de tri, consultez les rubriques suivantes :
[Clé primaire](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey)
[Bonnes pratiques pour la conception et l’utilisation performantes de clés de partition dans DynamoDB](bp-partition-key-design.md)
[Bonnes pratiques concernant l’utilisation de clés de tri pour organiser les données dans DynamoDB](bp-sort-keys.md)
1. Vous pouvez ajouter d'autres attributs pour valider plus clairement votre modèle et vos modèles d'accès. Pour ajouter d'autres attributs :
+ Choisissez **Ajouter un attribut**.
+ Spécifiez le nom de l’attribut et son type.
+ Vous pouvez éventuellement sélectionner un format de type de données plus détaillé pour la génération de données d’exemple.
1. Si vous souhaitez ajouter un index secondaire global, choisissez **Add global secondary index (Ajouter un index secondaire global)**. Spécifiez le **Global secondary index name (Nom de l’index secondaire global)**, l’attribut **Partition key (Clé de partition)** et le **Projection type (Type de projection)**.
Pour plus d’informations sur l’utilisation des index secondaires globaux dans DynamoDB, consultez [Index secondaires globaux](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html).
1. **Ajoutez éventuellement une facette.** Une facette est une construction virtuelle dans NoSQL Workbench. Il ne s'agit pas d'une construction fonctionnelle dans DynamoDB. Les facettes de NoSQL Workbench vous aident à visualiser les différents modèles d'accès aux données d'une application pour DynamoDB avec uniquement un sous-ensemble des données d'une table.
**Note**
Nous vous recommandons de l'utiliser [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md) pour visualiser la manière dont votre application accèdera aux données dans DynamoDB plutôt que dans Facets. Les modèles d'accès reflètent les interactions réelles de votre base de données et vous aident à créer le modèle de données adapté à votre cas d'utilisation, tandis que les facettes sont des visualisations non fonctionnelles.
Choisissez **Add Facet (Ajouter une facette)**. Spécifiez les paramètres suivants :
+ Le **nom de la facette**.
+ Un **alias de clé de partition** pour mieux distinguer la vue de cette facette.
+ Un **alias de clé de tri** si vous avez fourni une **clé de tri** pour la table.
+ Choisissez les **attributs** qui font partie de cette facette.
Répétez cette étape si vous souhaitez ajouter d’autres facettes.
1. Enfin, cliquez sur le bouton **Enregistrer** pour créer le tableau.
1. Si vous avez besoin d'autres **tables** ou **index secondaires globaux**, cliquez sur l'**icône\$1** au-dessus de la table que vous venez de créer.
# Importation d’un modèle de données existant
Vous pouvez utiliser NoSQL Workbench pour Amazon DynamoDB afin de générer un modèle de données en important et en modifiant un modèle existant. Vous pouvez importer des modèles de données au format de modèle NoSQL Workbench ou au [Format de modèle JSON AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).
**Pour importer un modèle existant**
1. **Ouvrez NoSQL Workbench, puis sur l'écran principal, sélectionnez Importer le modèle.** Vous pouvez importer un format de modèle NoSQL Workbench ou CloudFormation un modèle JSON.
1. Vous pouvez ajouter le modèle importé à un projet existant ou créer un nouveau projet. Si vous ne choisissez pas un autre projet, votre modèle sera ajouté au dossier des brouillons du projet.
1. Cliquez sur **Parcourir votre bureau** et choisissez un modèle à importer depuis votre ordinateur.
# Modification d’un modèle de données existant
**Pour modifier un modèle existant**
1. Pour commencer à apporter des modifications à un modèle existant, ouvrez le modèle dans la page du modeleur.
1. Dans le panneau de sélection des ressources, vous verrez la liste des **tables** et des **index secondaires globaux**.
1. Pour modifier une **table** ou un **index secondaire global**, cliquez d'abord sur son nom dans le panneau de sélection des ressources, puis utilisez les icônes d'action situées en haut. Les actions disponibles sont **Supprimer**, **Dupliquer** et **Modifier**.
1. Si vous souhaitez modifier les **détails du modèle**, cliquez sur l'icône à trois points à côté du nom du modèle.
1. À partir de là, vous pouvez cliquer sur **Modifier les détails du modèle** et modifier les informations en conséquence.
1. Vous pouvez également **dupliquer**, **déplacer**, **supprimer** et **exporter** le modèle à partir du même menu.
1. Pour passer à un autre modèle, vous pouvez soit passer à nouveau par l'écran principal, soit utiliser le menu déroulant de sélection du modèle.
# Ajout d’un exemple de données à un modèle de données
**Pour générer automatiquement des échantillons de données**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle auquel vous souhaitez ajouter des exemples de données.
1. Cliquez sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale et sélectionnez **Ajouter des exemples de données**.
1. Entrez le nombre d'échantillons de données que vous souhaitez générer, puis sélectionnez **Confirmer**.
1. La génération automatique d'échantillons de données vous permet de générer entre 1 et 5 000 lignes de données pour une utilisation immédiate. Vous pouvez spécifier un type de données d’exemple détaillé pour créer des données réalistes en fonction de vos besoins de conception et de test. Pour pouvoir générer des données réalistes, vous devez spécifier le format du type de données d’exemple pour vos attributs dans le modélisateur de données. Voir [Création d’un modèle de données](workbench.Modeler.CreateNew.md) pour spécifier des exemples de formats de type de données.
**Pour ajouter des exemples de données, un élément à la fois**
1. Ouvrez le modèle que vous souhaitez modifier, puis choisissez la table à laquelle vous souhaitez ajouter des exemples de données. Cliquez sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale et sélectionnez **Modifier les données**.
1. Vous pouvez désormais ajouter, supprimer et modifier des lignes. Après avoir apporté les modifications nécessaires, cliquez sur le bouton **Enregistrer**.
# Ajouter et valider des modèles d'accès
*Vous pouvez utiliser NoSQL Workbench pour Amazon DynamoDB pour créer, stocker et valider des modèles d'accès.*
**Note**
Voir [Identifier vos modèles d'accès aux données](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html) pour plus de détails sur l'identification des bons modèles d'accès.
**Pour créer un modèle d'accès**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle auquel vous souhaitez ajouter des modèles d'accès.
1. Sur le côté gauche, choisissez l'onglet **Modèles d'accès**, puis cliquez sur l'icône **\$1**.
1. Sur l'écran suivant, indiquez un **nom**, une **description** facultative, le **type** du modèle d'accès et la **table** ou l'**index secondaire global** par rapport auxquels tester le modèle d'accès.
**Note**
NoSQL Workbench prend actuellement en charge les opérations suivantes pour les modèles d'accès :`Scan`,,, `Query``GetItem`,`PutItem`. `UpdateItem` `DeleteItem` Amazon DynamoDB prend en charge une liste plus étendue d'opérations.
1. Après avoir créé un modèle d'accès, vous pouvez passer à l'onglet **Valider** pour vérifier que votre modèle de données est conçu pour renvoyer les résultats attendus pour le modèle d'accès. Consultez [Ajout d’un exemple de données à un modèle de données](workbench.Modeler.AddData.md) pour plus de détails sur la façon de générer automatiquement des exemples de données pour vos tables. Différents types de modèles d'accès prendront en charge différents paramètres d'entrée.
**Note**
Pour valider les modèles d'accès, NoSQL Workbench démarre une base de données locale DynamoDB distincte sur le port `8001` (par défaut) avec des tables et des index stockés en mémoire.
NoSQL Workbench ajoute automatiquement les exemples de données de votre modèle aux tables temporaires.
Si vous modifiez les exemples de données ou le modèle de données lui-même, NoSQL Workbench met à jour les tables temporaires.
Cette base de données temporaire est effacée lorsque vous fermez l'application.
**Pour modifier vos modèles d'accès**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle pour lequel vous souhaitez modifier les modèles d'accès.
1. Sur le côté gauche, choisissez l'onglet **Modèles d'accès**.
1. Pour modifier un modèle d'accès, sélectionnez-le dans la liste de gauche.
1. Dans la barre supérieure, cliquez sur le bouton d'action **Modifier**.
# Importation des exemples de données à partir d’un fichier CSV
Si vous avez des exemples de données préexistants dans un fichier CSV, vous pouvez les importer dans NoSQL Workbench. Cela vous permet de remplir rapidement votre modèle avec des exemples de données sans avoir à les saisir ligne par ligne.
Les noms de colonnes du fichier CSV doivent correspondre aux noms d’attributs de votre modèle de données. Ils ne doivent pas nécessairement être dans le même ordre. Par exemple, si votre modèle de données comporte des attributs appelés `LoginAlias`, `FirstName` et `LastName`, vos colonnes CSV peuvent être `LastName`, `FirstName` et `LoginAlias`.
Vous pouvez importer jusqu'à 150 lignes à la fois à partir d'un fichier CSV.
**Pour importer des données à partir d’un fichier CSV dans NoSQL Workbench**
1. Pour importer des données CSV dans un **tableau**, cliquez d'abord sur le nom du tableau dans le panneau des ressources, puis sur les actions supplémentaires (icône à trois points) dans la barre d'outils de contenu principale.
1. Sélectionnez **Importer des échantillons de données**.
1. Sélectionnez le fichier CVS, puis choisissez **Ouvrir**. Les données CSV sont ajoutées à votre tableau.
# Facettes
Dans NoSQL Workbench, les *facettes* vous permettent de visualiser un sous-ensemble des données d'une table, sans avoir à consulter les enregistrements qui ne répondent pas aux contraintes de la facette. Les facettes sont considérées comme un outil de modélisation de données visuelles et n’existent pas en tant que construction utilisable dans DynamoDB, car elles sont purement une aide à la modélisation des modèles d’accès.
**Note**
Nous vous recommandons de l'utiliser [Ajouter et valider des modèles d'accès](workbench.Modeler.AccessPatterns.md) pour visualiser la manière dont votre application accèdera aux données dans DynamoDB plutôt que dans Facets. Les modèles d'accès reflètent les interactions réelles de votre base de données et vous aident à créer le modèle de données adapté à votre cas d'utilisation, tandis que les facettes sont des visualisations non fonctionnelles.
**Pour créer une facette**
1. Dans le panneau de sélection des ressources, choisissez le **tableau** que vous souhaitez modifier
1. Dans la barre supérieure, cliquez sur l'icône **Modifier** l'action.
1. Faites défiler la page jusqu'à la section **Filtres à facettes**.
1. Choisissez **Add Facet (Ajouter une facette)**. Spécifiez les paramètres suivants :
+ Le **nom de la facette**.
+ Un **alias de clé de partition** pour mieux distinguer la vue de cette facette.
+ Un **alias de clé de tri** si vous avez fourni une **clé de tri** pour la table.
+ Choisissez les **attributs** qui font partie de cette facette.
Répétez cette étape si vous souhaitez ajouter d’autres facettes.
# Affichage de toutes les tables dans un modèle de données à l’aide de la vue d’agrégation
La vue agrégée de NoSQL Workbench pour Amazon DynamoDB vous permet de visualiser toutes les tables et tous les index d'un modèle de données. Pour chaque table, les informations suivantes s’affichent :
+ Nom des colonnes de la table
+ Exemples de données
+ Tous les index secondaires globaux associés à la table. NoSQL Workbench affiche les informations suivantes pour chaque index :
+ Noms des colonnes de l’index
+ Exemples de données
**Pour afficher les informations de toutes les tables**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez ouvrir.
1. Dans la barre supérieure, cliquez sur **Vue agrégée**. Vous verrez les données de toutes les tables et de tous les index sur le même écran.
**Pour exporter une vue agrégée sous forme d'images**
1. Lorsque la **vue agrégée** est sélectionnée, cliquez sur l'icône à trois points et choisissez **Exporter la vue agrégée**
1. Une archive contenant des images PNG de toutes les tables et de tous les index sera présentée en téléchargement.
# Exportation d’un modèle de données
Après avoir créé un modèle de données à l’aide de NoSQL Workbench pour Amazon DynamoDB, vous pouvez enregistrer et exporter le modèle au format de modèle NoSQL Workbench ou au [Format de fichier JSON AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html).
**Pour exporter un modèle de données**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez modifier.
1. Cliquez sur l'icône à trois points à côté du nom du modèle de données et sélectionnez **Exporter le modèle**.
1. Choisissez d'exporter votre modèle de données au format de modèle NoSQL Workbench ou au format de modèle CloudFormation JSON.
+ Choisissez le format de modèle **NoSQL Workbench si vous souhaitez partager votre modèle** avec d'autres membres de l'équipe à l'aide de NoSQL Workbench ou l'importer ultérieurement dans NoSQL Workbench.
+ Choisissez le format de **modèle CloudFormation JSON** si vous souhaitez déployer votre modèle directement dans votre infrastructure-as-code flux de travail AWS ou l'intégrer à celui-ci.
# Validation d’un modèle de données dans DynamoDB
Lorsque vous êtes satisfait de votre modèle de données, vous pouvez valider le modèle dans Amazon DynamoDB.
**Note**
Cette action crée des ressources côté serveur AWS pour les tables et les index secondaires globaux représentés dans le modèle de données.
NoSQL Workbench crée des tables et des index dotés d'une capacité à la demande par défaut.
**Pour valider le modèle de données dans DynamoDB**
1. Ouvrez NoSQL Workbench, puis sur l'écran principal, cliquez sur le nom du modèle que vous souhaitez valider.
1. Dans la barre supérieure, cliquez sur **Valider**.
1. Choisissez une connexion existante ou créez-en une nouvelle en cliquant sur le bouton **Ajouter une nouvelle connexion**.
+ Pour ajouter une nouvelle connexion, spécifiez les informations suivantes.
+ **Alias du compte**
+ **AWS Région**
+ **ID de clé d’accès**
+ **Clé d’accès secrète**
Pour plus d'informations sur l'obtention des clés d'accès, voir [Obtenir une clé d' AWS accès](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials).
+ Le cas échéant, vous pouvez spécifier les options suivantes :
+ [Le **jeton de session**](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
+ [L’**ARN du rôle IAM**](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)
1. Si vous préférez utiliser [DynamoDB local](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) :
1. Choisissez l'onglet **Connexion locale**.
1. Cliquez sur le bouton **Ajouter une nouvelle connexion**.
1. Spécifiez le **Nom de la connexion** et le **Port**.
**Note**
Pour utiliser DynamoDB local, vous devez l'activer en utilisant le bouton **DynamoDB** local en bas à gauche de l'écran NoSQL Workbench.
1. Cliquez sur **Valider**.
# Exploration des jeux de données et des opérations de création avec NoSQL Workbench
NoSQL Workbench pour Amazon DynamoDB fournit une interface graphique utilisateur riche pour développer et tester des requêtes. Vous pouvez utiliser le créateur d’opérations dans NoSQL Workbench pour consulter, explorer et interroger des ensembles de données. Le créateur d’opérations structurées prend en charge l’expression de projection ainsi que l’expression de condition et génère des exemples de code dans plusieurs langages. Vous pouvez cloner directement des tables d’un compte Amazon DynamoDB vers un autre dans différentes régions. Vous pouvez également cloner directement des tables entre DynamoDB local et un compte Amazon DynamoDB pour copier plus rapidement le schéma clé de votre table (et éventuellement le schéma et les éléments des GSI) entre vos environnements de développement. Vous pouvez enregistrer jusqu’à 50 opérations de données DynamoDB dans le créateur d’opérations.
**Topics**
+ [Se connecter à des ensembles de données en temps réel](workbench.querybuilder.connect.md)
+ [Création d’opérations complexes](workbench.querybuilder.operationbuilder.md)
+ [Clonage de tables avec NoSQL Workbench](workbench.querybuilder.cloning-tables.md)
+ [Exportation des données dans un fichier CSV](workbench.querybuilder.exportcsv.md)
# Se connecter à des ensembles de données en temps réel
Pour vous connecter à vos tables Amazon DynamoDB avec NoSQL Workbench, vous devez d'abord vous connecter à votre compte. AWS
**Pour ajouter une connexion à votre base de données.**
1. Dans NoSQL Workbench, dans le panneau de navigation sur la gauche, choisissez l’icône **Operation builder (Créateur d’opérations)**.
1. Choisissez **Add Connection (Ajouter une connexion)**.
1. Spécifiez les informations suivantes :
+ **Connection name (Nom de la connexion)**
+ **AWS Région**
+ **ID de clé d’accès**
+ **Clé d’accès secrète**
Pour plus d'informations sur l'obtention des clés d'accès, voir [Obtenir une clé d' AWS accès](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials).
Le cas échéant, vous pouvez spécifier les options suivantes :
+ [Le **jeton de session**](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
+ [L’**ARN du rôle IAM**](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)
1. Choisissez **Se connecter**.
Si vous ne voulez pas créer un compte gratuit et que vous préférez utiliser [DynamoDB Local (version téléchargeable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) :
1. Choisissez l’onglet **Local** sur l’écran de connexion.
1. Spécifiez les informations suivantes :
+ **Connection name (Nom de la connexion)**
+ **Port**
1. Choisissez le bouton **Connect (Se connecter)**.
**Note**
Pour vous connecter à DynamoDB local, lancez DynamoDB local manuellement à l’aide de votre terminal (consultez [Déploiement de DynamoDB local sur votre ordinateur](DynamoDBLocal.DownloadingAndRunning.md)) ou lancez DynamoDB local directement à l’aide du bouton DDB local situé dans le menu de navigation de NoSQL Workbench. Assurez-vous que le port de connexion est le même que celui de votre port DynamoDB local.
1. Sur la connexion créée, choisissez **Open (Ouvrir)**.
Une fois que vous êtes connecté à votre base de données DynamoDB, la liste des tables disponibles s’affiche dans le volet gauche. Choisissez l’une des tables pour retourner un exemple des données stockées dans la table.
Vous pouvez désormais exécuter des requêtes sur la table sélectionnée.
Pour exécuter des requêtes sur une table, consultez la section suivante sur la création d’opérations de création, [Création d’opérations complexes](workbench.querybuilder.operationbuilder.md).
# Création d’opérations complexes
Le créateur d’opérations dans NoSQL Workbench pour Amazon DynamoDB fournit une interface visuelle dans laquelle vous pouvez effectuer des opérations complexes de plan de données. Il inclut la prise en charge des expressions de projection et de condition. Une fois que vous avez créé une opération, vous pouvez l’enregistrer en vue d’une utilisation ultérieure (vous pouvez enregistrer jusqu’à 50 opérations). Vous pouvez ensuite parcourir une liste de vos opérations de plan de données fréquemment utilisées dans le menu **Saved Operations (Opérations enregistrées)**, et les utiliser pour remplir et créer automatiquement une nouvelle opération. Vous pouvez également choisir de générer un exemple de code pour ces opérations dans plusieurs langages.
NoSQL Workbench prend en charge la création d’instructions [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) pour DynamoDB, ce qui vous permet d’interagir avec DynamoDB à l’aide d’un langage de requête compatible SQL. Il prend également en charge la création d’opérations d’API CRUD DynamoDB.
Pour utiliser NoSQL Workbench afin de créer des opérations, dans le panneau de navigation de gauche, choisissez l’icône **Operation builder** (Créateur d’opérations).
**Topics**
+ [Création d’instructions PartiQL](workbench.querybuilder.partiql.md)
+ [Création d’opérations d’API](workbench.querybuilder.operationbuilder.api.md)
# Création d’instructions PartiQL
Pour utiliser NoSQL Workbench afin de créer des instructions [PartiQL pour DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html), choisissez **Opérations PartiQL** dans l’angle supérieur droit de NoSQL Workbench.
Vous pouvez créer les types d’instructions PartiQL suivants dans le créateur d’opérations.
**Topics**
+ [Instructions singleton](#workbench.querybuilder.partiql.single)
+ [Transactions](#workbench.querybuilder.partiql.transaction)
+ [Par lots](#workbench.querybuilder.partiql.batch)
## Instructions singleton
Pour exécuter ou générer du code pour une instruction PartiQL, procédez comme suit.
1. Choisissez **Éditeur PartiQL** en haut de la fenêtre.
1. Entrez une [Instruction PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valide.
1. Si votre instruction utilise des paramètres :
1. Choisissez **Optional request parameters (Paramètres de demande facultatifs)**.
1. Choisissez **Add new parameters (Ajouter de nouveaux paramètres)**.
1. Entrez le type d’attribut et la valeur.
1. Si vous souhaitez ajouter des paramètres, répétez les étapes b et c.
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Sélectionnez votre langage souhaité dans les onglets affichés. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save** (Enregistrer). Entrez ensuite le nom de votre opération et choisissez **Save** (Enregistrer).
## Transactions
Pour exécuter ou générer du code pour une transaction PartiQL, procédez comme suit.
1. Choisissez **Partie** dans le QLTransaction menu déroulant **Autres opérations**.
1. Choisissez **Add a new statement (Ajouter une nouvelle instruction)**.
1. Saisissez une [Instruction PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valide.
**Note**
Les opérations de lecture et d’écriture ne sont pas prises en charge dans la même demande de transaction PartiQL. Une instruction SELECT ne peut pas figurer dans une même demande avec les instructions INSERT, UPDATE et DELETE. Pour plus d’informations, consultez [Exécution de transactions avec PartiQL pour DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html).
1. Si votre instruction utilise des paramètres
1. Choisissez **Optional request parameters (Paramètres de demande facultatifs)**.
1. Choisissez **Add new parameters (Ajouter de nouveaux paramètres)**.
1. Entrez le type d’attribut et la valeur.
1. Si vous souhaitez ajouter des paramètres, répétez les étapes b et c.
1. Si vous souhaitez ajouter d’autres instructions, répétez les étapes 2 à 4.
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Sélectionnez votre langage souhaité dans les onglets affichés. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save** (Enregistrer). Entrez ensuite le nom de votre opération et choisissez **Save** (Enregistrer).
## Par lots
Pour exécuter ou générer du code pour un lot PartiQL, procédez comme suit.
1. Choisissez **Partie** dans le QLBatch menu déroulant **Autres opérations**.
1. Choisissez **Add a new statement (Ajouter une nouvelle instruction)**.
1. Saisissez une [Instruction PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) valide.
**Note**
Les opérations de lecture et d’écriture n’étant pas prises en charge dans une même demande par lot PartiQL, une instruction SELECT ne peut pas figurer dans la même demande que les instructions INSERT, UPDATE et DELETE. Les opérations d’écriture sur le même élément ne sont pas autorisées. Comme pour l' BatchGetItemopération, seules les opérations de lecture singleton sont prises en charge. Les opérations d’analyse et de requête ne sont pas prises en charge. Pour plus d’informations, consultez [Exécution d’opérations par lot avec PartiQL pour DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html).
1. Si votre instruction utilise des paramètres :
1. Choisissez **Optional request parameters (Paramètres de demande facultatifs)**.
1. Choisissez **Add new parameters (Ajouter de nouveaux paramètres)**.
1. Entrez le type d’attribut et la valeur.
1. Si vous souhaitez ajouter des paramètres, répétez les étapes b et c.
1. Si vous souhaitez ajouter d’autres instructions, répétez les étapes 2 à 4.
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Sélectionnez votre langage souhaité dans les onglets affichés. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save** (Enregistrer). Entrez ensuite le nom de votre opération et choisissez **Save** (Enregistrer).
# Création d’opérations d’API
Pour utiliser NoSQL Workbench pour créer DynamoDB CRUD APIs, sélectionnez Operation **Builder dans la partie gauche de l'interface utilisateur de** NoSQL Workbench.
Sélectionnez ensuite **Ouvrir** et choisissez la connexion.
Vous pouvez effectuer les opérations suivantes dans le créateur d’opérations.
+ [Supprimer une table](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [Créer une table](#workbench.querybuilder.operationbuilder.CreateTable)
+ [Mettre à jour une table](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [Mettre un élément](#workbench.querybuilder.operationbuilder.Put)
+ [Mettre à jour un élément](#workbench.querybuilder.operationbuilder.update)
+ [Supprimer un élément](#workbench.querybuilder.operationbuilder.Delete)
+ [Interrogation](#workbench.querybuilder.operationbuilder.Query)
+ [Analyser](#workbench.querybuilder.operationbuilder.scan)
+ [Transaction Obtenir des éléments](#workbench.querybuilder.operationbuilder.transactget)
+ [Transaction des éléments en écriture](#workbench.querybuilder.operationbuilder.transactwrite)
## Supprimer une table
Pour exécuter une opération `Delete Table`, procédez comme suit.
1. Recherchez la table que vous souhaitez supprimer dans la section **Tables**.
1. Sélectionnez **Supprimer la table** dans le menu représentant des points de suspension.
1. Saisissez le **nom de la table** pour confirmer que vous voulez la supprimer.
1. Sélectionnez **Supprimer**.
Pour plus d’informations sur cette opération, consultez [Supprimer une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Suppression d’un index secondaire global
Pour exécuter une opération `Delete GSI`, procédez comme suit.
1. Recherchez le GSI d’une table que vous souhaitez supprimer dans la section **Tables**.
1. Sélectionnez **Supprimer le GSI** dans le menu représentant des points de suspension.
1. Saisissez le **nom du GSI** pour confirmer que vous voulez le supprimer.
1. Sélectionnez **Supprimer**.
Pour plus d’informations sur cette opération, consultez [Supprimer une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Create table
Pour exécuter une opération `Create Table`, procédez comme suit.
1. Cliquez sur l’icône **\$1** à côté de la section **Tables**.
1. Entrez le nom de table souhaité.
1. Créez une clé de partition.
1. Facultatif : créez une clé de tri.
1. Pour personnaliser les paramètres de capacité, décochez la case **Utiliser les paramètres de capacité par défaut**.
+ Vous pouvez désormais sélectionner l’une des options **Alloué** ou **Capacité à la demande.**
Lorsque l’option Alloué est sélectionnée, vous pouvez définir des unités de capacité de lecture et d’écriture minimale et maximale. Vous pouvez également activer ou désactiver la mise à l’échelle automatique.
+ Si la table est définie sur le mode à la demande, vous ne pourrez pas spécifier de débit provisionné.
+ Si vous passez d'un débit à la demande à un débit provisionné, l'Autoscaling sera automatiquement appliqué à tous GSIs avec : min : 1, max : 10 ; objectif : 70 %.
1. Sélectionnez **Ignorer GSIs et créer** pour créer cette table sans GSI. Vous avez aussi la possibilité de sélectionner **Suivant** pour créer un GSI avec cette nouvelle table.
Pour plus d’informations sur cette opération, consultez [Créer une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Création d’un GSI
Pour exécuter une opération `Create GSI`, procédez comme suit.
1. Trouvez une table à laquelle vous souhaitez ajouter un GSI.
1. Dans le menu représentant des points de suspension, sélectionnez **Créer un GSI**.
1. Donnez un nom à ce GSI sous **Nom d’index**.
1. Créez une clé de partition.
1. Facultatif : créez une clé de tri.
1. Choisissez une option de type de projection dans le menu déroulant.
1. Sélectionnez **Créer un GSI**.
Pour plus d’informations sur cette opération, consultez [Créer une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Mettre à jour une table
Pour mettre à jour les paramètres de capacité d’une table avec une opération `Update Table`, procédez comme suit.
1. Recherchez la table dont vous souhaitez mettre à jour les paramètres de capacité.
1. Dans le menu représentant des points de suspension, sélectionnez **Mettre à jour les paramètres de capacité**.
1. Sélectionnez **Alloué** ou **Capacité à la demande**.
Lorsque l’option **Alloué** est sélectionnée, vous pouvez définir des unités de capacité de lecture et d’écriture minimale et maximale. Vous pouvez également activer ou désactiver la mise à l’échelle automatique.
1. Tâche de sélection **Update (Mise à jour)**.
Pour plus d’informations sur cette opération, consultez [Mettre à jour une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Mise à jour d’un GSI
Pour mettre à jour les paramètres de capacité d’un GSI avec une opération `Update Table`, procédez comme suit.
**Note**
Par défaut, les index secondaires globaux héritent des paramètres de capacité de la table de base. Les index secondaires globaux ne peuvent avoir un mode de capacité différent que lorsque la table de base est en mode de capacité provisionnée. Lorsque vous créez un index secondaire global sur une table en mode approvisionné, vous devez spécifier des unités de capacité de lecture et d’écriture pour la charge de travail prévue sur cet index. Pour plus d’informations, consultez [Considérations sur le débit alloué pour les index secondaires globaux](GSI.md#GSI.ThroughputConsiderations).
1. Recherchez le GSI dont vous souhaitez mettre à jour les paramètres de capacité.
1. Dans le menu représentant des points de suspension, sélectionnez **Mettre à jour les paramètres de capacité**.
1. Vous pouvez désormais sélectionner l’une des options **Alloué** ou **Capacité à la demande.**
Lorsque l’option **Alloué** est sélectionnée, vous pouvez définir des unités de capacité de lecture et d’écriture minimale et maximale. Vous pouvez également activer ou désactiver la mise à l’échelle automatique.
1. Tâche de sélection **Update (Mise à jour)**.
Pour plus d’informations sur cette opération, consultez [Mettre à jour une table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) dans la *Référence d’API Amazon DynamoDB*.
## Mettre un élément
Pour créer un élément, utilisez l’opération `Put Item`. Pour exécuter ou générer du code pour une opération `Put Item`, procédez comme suit.
1. Recherchez la table dans laquelle vous souhaitez créer un élément.
1. Dans le menu déroulant **Actions**, sélectionnez **Créer un élément**.
1. Saisissez la valeur de la clé de partition.
1. Saisissez la valeur de la clé de tri, le cas échant.
1. Si vous souhaitez ajouter des attributs non-clés, procédez comme suit :
1. Sélectionnez **\$1 Ajouter d’autres attributs**.
1. Spécifiez les champs **Attribute name (Nom d’attribut)**, **Type** et **Value (Valeur)**.
1. Si une expression de condition doit être satisfaite pour garantir le succès de l’opération `Put Item`, procédez comme suit :
1. Choisissez **Condition**.
1. Spécifiez le nom d’attribut, l’opérateur de comparaison, le type d’attribut et la valeur d’attribut.
1. Si d’autres conditions sont nécessaires, choisissez de nouveau **Condition**.
Pour plus d’informations, consultez [Exemple de commande CLI d’expression de condition DynamoDB](Expressions.ConditionExpressions.md).
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Sélectionnez votre langage souhaité dans les onglets affichés. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save operation** (Enregistrer l’opération), entrez un nom pour votre opération, puis choisissez **Save** (Enregistrer).
Pour plus d'informations sur cette opération, consultez le [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)manuel *Amazon DynamoDB API Reference*.
## Mettre à jour un élément
Pour exécuter ou générer du code pour une opération `Update Item`, procédez comme suit.
1. Recherchez la table dans laquelle vous souhaitez mettre à jour un élément.
1. Sélectionnez l’élément.
1. Saisissez le nom d’attribut et la valeur d’attribut pour l’expression sélectionnée.
1. Si vous souhaitez ajouter davantage d’expressions, choisissez une autre expression dans la liste déroulante **Expression de mise à jour**, puis sélectionnez l’icône **\$1**.
1. Si une expression de condition doit être satisfaite pour garantir le succès de l’opération `Update Item`, procédez comme suit :
1. Choisissez **Condition**.
1. Spécifiez le nom d’attribut, l’opérateur de comparaison, le type d’attribut et la valeur d’attribut.
1. Si d’autres conditions sont nécessaires, choisissez de nouveau **Condition**.
Pour plus d’informations, consultez [Exemple de commande CLI d’expression de condition DynamoDB](Expressions.ConditionExpressions.md).
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Choisissez l’onglet du langage que vous souhaitez utiliser. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save operation** (Enregistrer l’opération), entrez un nom pour votre opération, puis choisissez **Save** (Enregistrer).
Pour plus d'informations sur cette opération, consultez le [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)manuel *Amazon DynamoDB API Reference*.
## Supprimer un élément
Pour exécuter une opération `Delete Item`, procédez comme suit.
1. Recherchez la table dans laquelle vous souhaitez supprimer un élément.
1. Sélectionnez l’élément.
1. Dans le menu **Actions**, sélectionnez **Supprimer un élément**.
1. Sélectionnez **Supprimer** pour confirmer la suppression de l’élément.
Pour plus d'informations sur cette opération, consultez le [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)manuel *Amazon DynamoDB API Reference*.
## Élément en double
Vous pouvez dupliquer un élément en créant un autre élément avec les mêmes attributs. Pour dupliquer un élément, procédez comme suit.
1. Recherchez la table dans laquelle vous souhaitez dupliquer un élément.
1. Sélectionnez l’élément.
1. Dans le menu **Actions**, sélectionnez **Dupliquer l’élément**.
1. Spécifiez une nouvelle clé de partition.
1. Spécifiez une nouvelle clé de tri (si nécessaire).
1. Sélectionnez **Exécuter**.
Pour plus d'informations sur cette opération, consultez le [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)manuel *Amazon DynamoDB API Reference*.
## Query
Pour exécuter ou générer du code pour une opération `Query`, procédez comme suit.
1. Sélectionnez **Requête** en haut de l’interface utilisateur de NoSQL Workbench.
1. Spécifiez la valeur de la clé de partition.
1. Si une clé de tri est nécessaire pour l’opération `Query`, procédez comme suit :
1. Sélectionnez **Sort key (Clé de tri)**.
1. Spécifiez l’opérateur de comparaison et la valeur d’attribut.
1. Sélectionnez **Requête** pour exécuter cette opération de requête. Si d’autres options sont nécessaires, cochez la case **Plus d’options** et passez aux étapes suivantes.
1. Si tous les attributs ne doivent pas être retournés avec le résultat de l’opération, sélectionnez **Projection expression (Expression de projection)**.
1. Choisissez l’icône **\$1**.
1. Saisissez l’attribut à retourner avec le résultat de la requête.
1. Si davantage d’attributs sont nécessaires, choisissez le **\$1**.
1. Si une expression de condition doit être satisfaite pour garantir le succès de l’opération `Query`, procédez comme suit :
1. Choisissez **Condition**.
1. Spécifiez le nom d’attribut, l’opérateur de comparaison, le type d’attribut et la valeur d’attribut.
1. Si d’autres conditions sont nécessaires, choisissez de nouveau **Condition**.
Pour plus d’informations, consultez [Exemple de commande CLI d’expression de condition DynamoDB](Expressions.ConditionExpressions.md).
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Choisissez l’onglet du langage que vous souhaitez utiliser. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save operation** (Enregistrer l’opération), entrez un nom pour votre opération, puis choisissez **Save** (Enregistrer).
Pour plus d’informations sur cette opération, consultez [Query](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html) dans la *Référence d’API Amazon DynamoDB*.
## Analyser
Pour exécuter ou générer du code pour une opération `Scan`, procédez comme suit.
1. Sélectionnez **Analyser** en haut de l’interface utilisateur de NoSQL Workbench.
1. Cliquez sur le bouton **Analyser** pour effectuer cette opération d’analyse de base. Si d’autres options sont nécessaires, cochez la case **Plus d’options** et passez aux étapes suivantes.
1. Spécifiez un nom d’attribut pour filtrer les résultats de l’analyse.
1. Si tous les attributs ne doivent pas être retournés avec le résultat de l’opération, sélectionnez **Projection expression (Expression de projection)**.
1. Si une expression de condition doit être satisfaite pour garantir le succès de l’opération Scan, procédez comme suit :
1. Choisissez **Condition**.
1. Spécifiez le nom d’attribut, l’opérateur de comparaison, le type d’attribut et la valeur d’attribut.
1. Si d’autres conditions sont nécessaires, choisissez de nouveau **Condition**.
Pour plus d’informations, consultez [Exemple de commande CLI d’expression de condition DynamoDB](Expressions.ConditionExpressions.md).
1. Si vous souhaitez générer un code, choisissez **Generate code (Générer un code)**.
Choisissez l’onglet du langage que vous souhaitez utiliser. Vous pouvez désormais copier ce code et l’utiliser dans votre application.
1. Si vous souhaitez que l’opération soit exécutée immédiatement, choisissez **Run (Exécuter)**.
1. Si vous souhaitez enregistrer cette opération en vue d’une utilisation ultérieure, choisissez **Save operation** (Enregistrer l’opération), entrez un nom pour votre opération, puis choisissez **Save** (Enregistrer).
## TransactGetItems
Pour exécuter ou générer du code pour une opération `TransactGetItems`, procédez comme suit.
1. Dans le menu déroulant **Autres opérations** en haut de l'interface utilisateur de NoSQL Workbench, sélectionnez. **TransactGetItems**
1. Cliquez sur l'**icône\$1** à proximité **TransactGetItem**.
1. Spécifiez une clé de partition.
1. Spécifiez une clé de tri (si nécessaire).
1. Sélectionnez **Exécuter** pour effectuer l’opération, **Enregistrer l’opération** pour l’enregistrer ou **Générer le code** pour générer le code correspondant.
Pour de plus amples informations sur les transactions, consultez [Transactions Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).
## TransactWriteItems
Pour exécuter ou générer du code pour une opération `TransactWriteItems`, procédez comme suit.
1. Dans le menu déroulant **Autres opérations** en haut de l'interface utilisateur de NoSQL Workbench, sélectionnez. **TransactWriteItems**
1. Choisissez une opération dans le menu déroulant **Actions**.
1. Cliquez sur l'**icône\$1** à proximité **TransactWriteItem**.
1. Dans le menu déroulant **Actions**, choisissez l’opération que vous souhaitez effectuer.
+ Pour `DeleteItem`, suivez les instructions pour l’opération [Supprimer un élément](#workbench.querybuilder.operationbuilder.Delete).
+ Pour `PutItem`, suivez les instructions pour l’opération [Mettre un élément](#workbench.querybuilder.operationbuilder.Put).
+ Pour `UpdateItem`, suivez les instructions pour l’opération [Mettre à jour un élément](#workbench.querybuilder.operationbuilder.update).
Pour modifier l’ordre des actions, choisissez une action dans la liste à gauche, puis utilisez la flèche du haut ou du bas pour la déplacer dans la liste.
Pour supprimer une action, choisissez l’action dans la liste, puis choisissez l’icône **supprimer** (corbeille).
1. Sélectionnez **Exécuter** pour effectuer l’opération, **Enregistrer l’opération** pour l’enregistrer ou **Générer le code** pour générer le code correspondant.
Pour de plus amples informations sur les transactions, consultez [Transactions Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).
# Clonage de tables avec NoSQL Workbench
Le clonage des tables permet de copier le schéma de clés d’une table (et éventuellement le schéma GSI et les éléments) entre vos environnements de développement. Vous pouvez cloner une table entre DynamoDB local et un compte Amazon DynamoDB, voire cloner une table d’un compte à un autre dans différentes régions pour accélérer les tests.
**Pour cloner une table**
1. Dans le **Créateur d’opérations**, sélectionnez votre connexion et votre région (la sélection de la région n’est pas disponible pour DynamoDB local).
1. Une fois connecté à DynamoDB, parcourez vos tables et sélectionnez celle que vous souhaitez cloner.
1. Dans le menu représentant des points de suspension, sélectionnez l’option **Cloner**.
1. Entrez les détails de la destination du clone :
1. Sélectionnez une connexion.
1. Sélectionnez une région (la région n’est pas disponible pour DynamoDB local).
1. Entrez un nom pour la nouvelle table.
1. Choisissez une option de clonage :
1. L’option **Schéma de clés** est sélectionnée par défaut et ne peut pas être désélectionnée. Par défaut, le clonage d’une table copie votre clé primaire et votre clé de tri si elles sont disponibles.
1. L’option **Schéma GSI** est sélectionnée par défaut si votre table à cloner possède un GSI. Le clonage d’une table copie la clé primaire et la clé de tri de votre GSI si elles sont disponibles. Vous avez la possibilité de désélectionner l’option Schéma GSI pour ignorer le clonage du schéma GSI. Le clonage d’une table copie les paramètres de capacité de votre table de base en tant que paramètres de capacité du GSI. Vous pouvez utiliser l’opération `UpdateTable` dans le créateur d’opérations pour mettre à jour le paramètre de capacité du GSI de la table une fois le clonage terminé.
1. Entrez le nombre d’éléments à cloner. Pour cloner uniquement le schéma de clés et éventuellement le schéma GSI, vous pouvez conserver la valeur 0 pour **Éléments à cloner**. Le nombre maximum d’éléments pouvant être clonés est de 5 000.
1. Choisissez un mode de capacité :
1. Le **mode à la demand**e est sélectionné par défaut. DynamoDB à la demande pay-per-request propose des tarifs pour les demandes de lecture et d'écriture afin que vous ne payiez que pour ce que vous utilisez. Pour en savoir plus, consultez [DynamoDB On-demand mode](capacity-mode.md#capacity-mode-on-demand).
1. Le **mode provisionné** vous permet de spécifier le nombre de lectures et d’écritures par seconde nécessaires pour votre application. Vous pouvez recourir à l’autoscaling pour ajuster automatiquement la capacité allouée de votre table en fonction de l’évolution du trafic. Pour en savoir plus, consultez [Mode provisionné DynamoDB](provisioned-capacity-mode.md).
1. Sélectionnez **Cloner** pour commencer le clonage.
1. Le processus de clonage s’exécute en arrière-plan. L’onglet **Créateur d’opérations** affiche une notification en cas de modification de l’état de la table de clonage. Vous pouvez accéder à cet état en sélectionnant l’onglet **Créateur d’opérations**, puis en sélectionnant le bouton fléché. Le bouton fléché se trouve sur le widget d’état de la table de clonage situé en bas de la barre latérale du menu.
# Exportation des données dans un fichier CSV
Vous pouvez exporter les résultats d’une requête depuis Operation Builder vers un fichier CSV. Cela vous permet de charger les données dans une feuille de calcul ou de les traiter à l’aide de votre langage de programmation préféré.
**Exportation vers CSV**
1. Dans Operation Builder, exécutez une opération de votre choix, telle qu’une analyse ou une requête.
**Note**
Vous ne pouvez exporter que les résultats des opérations d’API de lecture et des instructions PartiQL vers un fichier CSV. Vous ne pouvez pas exporter les résultats des instructions de lecture des transactions.
À l’heure actuelle, vous pouvez exporter les résultats vers un fichier CSV page par page. S’il existe plusieurs pages de résultats, vous devez exporter chaque page individuellement.
1. Sélectionnez les éléments que vous souhaitez exporter dans les résultats.
1. Dans le menu déroulant **Actions**, choisissez **Exporter au format CSV**.
1. Choisissez un nom de fichier et un emplacement pour votre fichier CVS et sélectionnez **Enregistrer**.
# Exemples de modèle de données pour NoSQL Workbench
La page d'accueil du modeleur affiche un certain nombre d'exemples de modèles fournis avec le NoSQL Workbench. Cette section décrit ces modèles et leurs utilisations potentielles.
**Topics**
+ [Modèle de données d'employé](#workbench.SampleModels.EmployeeDataModel)
+ [Modèle de données de forum de discussion](#workbench.SampleModels.DiscussionForumDataModel)
+ [Modèle de données de bibliothèque musicale](#workbench.SampleModels.MusicLibraryDataModel)
+ [Modèle de données de station de ski](#workbench.SampleModels.SkiResortDataModel)
+ [Modèle de données d'offres de carte de crédit](#workbench.SampleModels.CreditCardOffersDataModel)
+ [Modèle de données de signets](#workbench.SampleModels.BookmarksDataModel)
## Modèle de données d'employé
Ce modèle de données est un modèle d'introduction. Il représente les détails de base d'un employé, tels qu’un alias unique, son prénom, son nom de famille, son intitulé de poste, son responsable et ses compétences.
Ce modèle de données décrit quelques techniques telles que la gestion d'attributs complexes (par exemple, le fait d’avoir plusieurs compétences). Ce modèle est également un exemple de one-to-many relation établie par l'intermédiaire du gestionnaire et de ses employés subalternes grâce à l'indice secondaire DirectReports.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Récupération d'un enregistrement d'employé à l'aide de l'alias de connexion de l'employé. Cette récupération est facilitée par une table appelée `Employee`.
+ Recherchez les employés par nom. Cette recherche est facilitée par l'index secondaire global de la table Employee appelé `Name`.
+ Récupération de tous les rapports directs d'un responsable à l'aide de l'alias de connexion du responsable. Cette récupération est facilitée par l'index secondaire global de la table Employee appelé `DirectReports`.
## Modèle de données de forum de discussion
Ce modèle de données représente un forum de discussion. En utilisant ce modèle, les clients peuvent dialoguer avec la communauté de développeurs, poser des questions et répondre aux messages des autres clients. Chaque service AWS a un forum dédié. N'importe qui peut démarrer un nouveau fil de discussion en publiant un message dans un forum, chaque fil recevant un nombre quelconque de réponses.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Récupération d'un enregistrement de forum à l’aide du nom du forum. Cette récupération est facilitée par une table appelée `Forum`.
+ Récupération d'un fil spécifique ou de tous les fils d’un forum. Cette récupération est facilitée par une table appelée `Thread`.
+ Recherchez des réponses à l'aide de l'adresse e-mail de l'utilisateur à l’origine de la publication. Cette recherche est facilitée par l'index secondaire global de la table Reply appelé `PostedBy-Message-Index`.
## Modèle de données de bibliothèque musicale
Ce modèle de données représente une bibliothèque musicale qui possède une importante collection de chansons et met en avant les chansons les plus téléchargées en temps quasi réel.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Récupération d'un enregistrement de chanson. Cette récupération est facilitée par une table appelée `Songs`.
+ Récupération d'un enregistrement de téléchargement spécifique ou de tous les enregistrements de téléchargement d'une chanson. Cette récupération est facilitée par une table appelée `Songs`.
+ Récupération d'un enregistrement mensuel spécifique du nombre de téléchargements ou de tous les enregistrements mensuels du nombre de téléchargements pour une chanson. Cette récupération est facilitée par une table appelée `Song`.
+ Récupération de tous les enregistrements (y compris les enregistrements de chanson, les enregistrements de téléchargement et les enregistrements mensuels du nombre de téléchargements) pour une chanson. Cette récupération est facilitée par une table appelée `Songs`.
+ Recherchez les chansons les plus téléchargées. Cette recherche est facilitée par l'index secondaire global de la table Songs appelé `DownloadsByMonth`.
## Modèle de données de station de ski
Ce modèle de données représente une station de ski qui dispose d'une importante collection de données pour chaque remontée mécanique recueillies quotidiennement.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Récupération de toutes les données (dynamiques et statiques) pour une remontée mécanique ou l’ensemble d’une station donnée. Cette récupération est facilitée par une table appelée `SkiLifts`.
+ Récupération de toutes les données dynamiques (y compris les utilisateurs d’une remontée, la couverture de neige, le danger d'avalanche et l'état de la remontée) pour une remontée mécanique ou l'ensemble de la station à une date précise. Cette récupération est facilitée par une table appelée `SkiLifts`.
+ Récupération de toutes les données statiques (y compris le fait de savoir si la remontée est conçue pour des utilisateurs expérimentés uniquement, le dénivelé couvert par la remontée et le temps nécessaire pour la montée) pour une remontée mécanique spécifique, facilitée par une table appelée `SkiLifts`.
+ Récupération de la date des données enregistrées pour une remontée mécanique spécifique ou pour l'ensemble de la station, triées par nombre total de cyclistes uniques, facilitée par l'index secondaire global du SkiLifts tableau appelé`SkiLiftsByRiders`.
## Modèle de données d'offres de carte de crédit
Ce modèle de données est utilisé par une application d'offres de carte de crédit.
Un fournisseur de cartes de crédit produit des offres au fil du temps. Ces offres comprennent des transferts de solde sans frais, des augmentations de limite de crédit, des baisses de taux d'intérêt, des remboursements et des miles aériens. Lorsqu’un client accepte ou refuse ces offres, le statut de l'offre respective est mis à jour en conséquence.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Récupération des enregistrements de compte à l'aide de `AccountId`. Cette récupération est facilitée par la table principale.
+ Récupération de tous les comptes avec quelques éléments projetés. Cette récupération est facilitée par l'index secondaire `AccountIndex`.
+ Récupération des comptes et tous les enregistrements d'offre associés à ces comptes à l’aide de `AccountId`. Cette récupération est facilitée par la table principale.
+ Récupération des comptes et des enregistrements d'offre spécifique associés à ces comptes à l’aide de `AccountId` et `OfferId`. Cette récupération est facilitée par la table principale.
+ Récupération de tous les enregistrements d'offre `ACCEPTED/DECLINED` avec `OfferType` spécifique associés à des comptes à l'aide de `AccountId`, `OfferType` et `Status`. Cette récupération est facilitée par l'index secondaire `GSI1`.
+ Récupération des offres et des enregistrements d'élément d'offre associés à l'aide de `OfferId`. Cette récupération est facilitée par la table principale.
## Modèle de données de signets
Ce modèle de données permet de stocker des signets pour des clients.
Un client peut avoir de nombreux signets et un signet peut appartenir à de nombreux clients. Ce modèle de données représente une many-to-many relation.
Les modèles d'accès facilités par ce modèle de données sont les suivants :
+ Une requête unique par `customerId` peut désormais renvoyer des données client ainsi que des signets.
+ Un index de requête `ByEmail` renvoie les données client par adresse e-mail. Notez que les signets ne sont pas récupérés par cet index.
+ Un index de requête `ByUrl` permet d’obtenir les données de signets par URL. Notez que CustomerID constitue la clé de tri pour l'index, car la même URL peut être marquée par plusieurs clients.
+ Un index de requête `ByCustomerFolder` permet d’obtenir des signets par dossier pour chaque client.
# Historique de version pour NoSQL Workbench
Le tableau ci-après décrit les modifications importantes apportées à chaque version de l’outil client *NoSQL Workbench*.
****
| Version | Modifier | Description | Date |
| --- | --- | --- | --- |
| 3,20,0 | Nouveau modélisateur de données pour DynamoDB | L'expérience utilisateur de Data Modeler pour DynamoDB est actualisée. Data Modeler pour DynamoDB prend désormais en charge les modèles d'accès. | 16 février 2026 |
| 3.13,5 | Le mode de capacité pour les paramètres de table par défaut est désormais à la demande | Lorsque vous créez une table avec les paramètres par défaut, DynamoDB crée une table qui utilise le mode de capacité à la demande au lieu du mode de capacité provisionnée. | 24 février 2025 |
| 3,13,0 | Améliorations du créateur d’opérations NoSQL Workbench | NoSQL Workbench inclut désormais la prise en charge native du mode sombre. Amélioration des opérations sur les tables et les éléments dans le créateur d’opérations. Les informations sur les résultats des éléments et les demandes du créateur d’opérations sont disponibles au format JSON. | 24 avril 2024 |
| 3.12.0 | Clonage de tables avec NoSQL Workbench et affichage de la capacité consommée | Vous pouvez désormais cloner des tables entre DynamoDB local et un compte de service Web DynamoDB ou entre des comptes de service Web DynamoDB pour accélérer les itérations de développement. Affichez les RCU ou WCU consommées après l’exécution d’une opération à l’aide du créateur d’opérations. Nous avons résolu le problème d’écrasement des données lors de l’importation à partir d’un fichier CSV. | 26 février 2024 |
| 3.11.0 | Améliorations de DynamoDB Local | Vous pouvez désormais spécifier le port lors du lancement de l’instance DynamoDB local intégrée. NoSQL Workbench peut désormais être installé sur Windows sans droits d’administrateur. Nous avons mis à jour les modèles de données. | 17 janvier 2024 |
| 3.10.0 | Prise en charge native pour le silicium Apple | NoSQL Workbench inclut désormais une prise en charge native pour Mac avec le silicium Apple. Vous pouvez désormais configurer le format de génération des données d’échantillonnage pour les attributs de type `Number`. | 5 décembre 2023 |
| 3.9.0 | Améliorations du modélisateur de données | Le visualiseur prend désormais en charge la validation des modèles de données dans DynamoDB Local avec la possibilité de remplacer les tables existantes. | 3 novembre 2023 |
| 3.8.0 | Génération de données d’exemple | NoSQL Workbench prend désormais en charge la génération de données d’exemple pour vos modèles de données DynamoDB. | 25 septembre 2023 |
| 3.6.0 | Améliorations apportées au créateur d’opérations | Améliorations de la gestion des connexions dans le créateur d’opérations. Les noms d’attributs dans Data Modeler peuvent désormais être modifiés sans suppression de données. Autres correctifs de bogues. | 11 avril 2023 |
| 3.5.0 | Support aux nouvelles AWS régions | NoSQL Workbench prend désormais en charge les régions ap-south-2, ap-southeast-3, ap-southeast-4, eu-central-2, eu-south-2, me-central-1 et me-west-1. | 23 février 2023 |
| 3.4.0 | Prise en charge de DynamoDB local | NoSQL Workbench prend désormais en charge DynamoDB local dans le cadre du processus d’installation. | 6 décembre 2022 |
| 3.3.0 | Support des opérations de plans de contrôle | Operation Builder prend désormais en charge les opérations de contrôle. | 1er juin 2022 |
| 3.2.0 | Importation et exportation de fichiers CSV | Vous pouvez désormais importer des exemples de données à partir d’un fichier CSV dans l’outil Visualizer. Vous pourrez également exporter les résultats d’une requête Operation Builder vers un fichier CSV. | 11 octobre 2021 |
| 3.1.0 | Enregistrer des opérations | Le créateur d’opérations dans NoSQL Workbench prend désormais en charge les opérations d’enregistrement en vue d’une utilisation ultérieure. | 12 Juillet 2021 |
| 3.0.0 | Paramètres de capacité et CloudFormation importation/exportation | NoSQL Workbench pour Amazon DynamoDB prend désormais en charge la spécification d’un mode de capacité de lecture/écriture pour les tables, et peut importer et exporter des modèles de données au format CloudFormation . | 21 avril 2021 |
| 2.2.0 | Prise en charge de PartiQL | NoSQL Workbench pour Amazon DynamoDB ajoute la prise en charge de la création d’instructions PartiQL pour DynamoDB. | 4 décembre 2020 |
| 1.1.0 | Prise en charge de Linux. | NoSQL Workbench pour Amazon DynamoDB est pris en charge sur Linux Ubuntu, Fedora et Debian. | 4 mai 2020 |
| 1.0.0 | NoSQL Workbench for Amazon DynamoDB – GA. | NoSQL Workbench pour Amazon DynamoDB est généralement disponible. | 2 mars 2020 |
| 0,4.1 | Prise en charge des rôles IAM et des informations d’identification de sécurité temporaires. | NoSQL Workbench pour Amazon DynamoDB ajoute la prise en charge des rôles et des informations d’identification de sécurité temporaires Gestion des identités et des accès AWS (IAM). | 19 décembre 2019 |
| 0,3.1 | Prise en charge de [DynamoDB local (version téléchargeable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) | NoSQL Workbench prend désormais en charge la connexion à [DynamoDB local (version téléchargeable)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) pour concevoir, créer, interroger et gérer des tables DynamoDB. | 8 novembre 2019 |
| 0,2.1 | Version préliminaire de NoSQL Workbench. | Il s’agit de la version initiale de NoSQL Workbench pour DynamoDB. Utilisez NoSQL Workbench pour concevoir, créer, interroger et gérer des tables DynamoDB. | 16 septembre 2019 |