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. # 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**.