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