Exploitation API des bâtiments - Amazon DynamoDB

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.

Exploitation API des bâtiments

Pour utiliser No SQL Workbench pour créer CRUD APIs DynamoDB, sélectionnez Operation Builder dans la partie gauche de l'interface utilisateur de No Workbench. SQL

Sélectionnez ensuite Ouvrir et choisissez une connexion.

Vous pouvez effectuer les opérations suivantes dans le créateur d'opérations.

Supprimer une table

Pour exécuter une Delete Table opération, procédez comme suit.

  1. Recherchez le tableau que vous souhaitez supprimer dans la section Tables.

  2. Sélectionnez Supprimer le tableau dans le menu représentant des points de suspension horizontaux.

  3. Confirmez que vous souhaitez supprimer la table en saisissant le nom de la table.

  4. Sélectionnez Delete (Supprimer).

Pour plus d'informations sur cette opération, consultez Supprimer une table dans le manuel Amazon API DynamoDB Reference.

Supprimer GSI

Pour exécuter une Delete GSI opération, procédez comme suit.

  1. Recherchez le GSI tableau que vous souhaitez supprimer dans la section Tables.

  2. Sélectionnez Supprimer dans le GSI menu représentant des points de suspension horizontaux.

  3. Confirmez que vous souhaitez supprimer le GSI en saisissant le GSInom.

  4. Sélectionnez Delete (Supprimer).

Pour plus d'informations sur cette opération, consultez Supprimer une table dans le manuel Amazon API DynamoDB Reference.

Create table

Pour exécuter une Create Table opération, procédez comme suit.

  1. Cliquez sur l'icône + à côté de la section Tables.

  2. Entrez le nom de table souhaité.

  3. Créez une clé de partition.

  4. Facultatif : créez une clé de tri.

  5. 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é, 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 le tableau est actuellement défini sur On-Demand, 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 %.

  6. Sélectionnez Ignorer GSIs et créer pour créer ce tableau sansGSI. Vous pouvez éventuellement sélectionner Suivant pour créer une table GSI avec cette nouvelle table.

Pour plus d'informations sur cette opération, consultez la section Créer une table dans le manuel Amazon API DynamoDB Reference.

Créez GSI

Pour exécuter une Create GSI opération, procédez comme suit.

  1. Trouvez une table à laquelle vous souhaitez GSI ajouter un.

  2. Dans le menu représentant des points de suspension horizontaux, sélectionnez Créer GSI.

  3. Nommez-le GSI sous le nom de l'index.

  4. Créez une clé de partition.

  5. Facultatif : créez une clé de tri.

  6. Choisissez une option de type de projection dans le menu déroulant.

  7. Sélectionnez Créer GSI.

Pour plus d'informations sur cette opération, consultez la section Créer une table dans le manuel Amazon API DynamoDB Reference.

Mettre à jour une table

Pour mettre à jour les paramètres de capacité d'une table comportant une Update Table opération, procédez comme suit.

  1. Recherchez le tableau pour lequel vous souhaitez mettre à jour les paramètres de capacité.

  2. Dans le menu représentant des points de suspension horizontaux, sélectionnez Mettre à jour les paramètres de capacité.

  3. Sélectionnez la capacité provisionnée ou à la demande.

    Lorsque Provisioned est sélectionné, vous pouvez définir des unités de capacité de lecture et d'écriture minimales et maximales. Vous pouvez également activer ou désactiver la mise à l'échelle automatique.

  4. Tâche de sélection Update (Mise à jour).

Pour plus d'informations sur cette opération, consultez le tableau de mise à jour dans le manuel Amazon API DynamoDB Reference.

Mettre à jour GSI

Pour mettre à jour les paramètres de capacité d'une Update Table opération GSI avec une opération, 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 peuvent avoir un mode de capacité différent uniquement lorsque la table de base est en mode 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 de plus amples informations, veuillez consulter Considérations sur le débit alloué pour les index secondaires globaux.

  1. Trouvez celui pour GSI lequel vous souhaitez mettre à jour les paramètres de capacité.

  2. Dans le menu représentant des points de suspension horizontaux, sélectionnez Mettre à jour les paramètres de capacité.

  3. Vous pouvez désormais sélectionner l'une des options Alloué ou Capacité à la demande.

    Lorsque Provisioned est sélectionné, vous pouvez définir des unités de capacité de lecture et d'écriture minimales et maximales. Vous pouvez également activer ou désactiver la mise à l'échelle automatique.

  4. Tâche de sélection Update (Mise à jour).

Pour plus d'informations sur cette opération, consultez le tableau de mise à jour dans le manuel Amazon API DynamoDB Reference.

Mettre un élément

Vous créez un élément à l'aide de l'Put Itemopération. Pour exécuter ou générer du code pour une opération Put Item, procédez comme suit.

  1. Trouvez le tableau dans lequel vous souhaitez créer un élément.

  2. Dans le menu déroulant Actions, sélectionnez Créer un article.

  3. Saisissez la valeur de la clé de partition.

  4. Saisissez la valeur de la clé de tri, le cas échant.

  5. Si vous souhaitez ajouter des attributs non-clés, procédez comme suit :

    1. Sélectionnez + Ajouter d'autres attributs.

    2. Spécifiez les champs Attribute name (Nom d'attribut), Type et Value (Valeur).

  6. 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.

    2. Spécifiez le nom d'attribut, l'opérateur de comparaison, le type d'attribut et la valeur d'attribut.

    3. Si d'autres conditions sont nécessaires, choisissez de nouveau Condition.

    Pour de plus amples informations, veuillez consulter Exemple d'expression de condition DynamoDB CLI.

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

  8. Si vous souhaitez que l'opération soit exécutée immédiatement, choisissez Run (Exécuter).

  9. 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 PutItemmanuel Amazon API DynamoDB 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 le tableau dans lequel vous souhaitez mettre à jour un élément.

  2. Sélectionnez l'article.

  3. Saisissez le nom d'attribut et la valeur d'attribut pour l'expression sélectionnée.

  4. Si vous souhaitez ajouter d'autres expressions, choisissez-en une autre dans la liste déroulante Mettre à jour l'expression, puis sélectionnez l'icône +.

  5. 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.

    2. Spécifiez le nom d'attribut, l'opérateur de comparaison, le type d'attribut et la valeur d'attribut.

    3. Si d'autres conditions sont nécessaires, choisissez de nouveau Condition.

    Pour de plus amples informations, veuillez consulter Exemple d'expression de condition DynamoDB CLI.

  6. 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.

  7. Si vous souhaitez que l'opération soit exécutée immédiatement, choisissez Run (Exécuter).

  8. 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 UpdateItemmanuel Amazon API DynamoDB Reference.

Supprimer un élément

Pour exécuter une Delete Item opération, procédez comme suit.

  1. Recherchez le tableau dans lequel vous souhaitez supprimer un élément.

  2. Sélectionnez l'article.

  3. Dans le menu déroulant Actions, sélectionnez Supprimer l'élément.

  4. Confirmez que vous souhaitez supprimer l'élément en sélectionnant Supprimer.

Pour plus d'informations sur cette opération, consultez le DeleteItemmanuel Amazon API DynamoDB Reference.

Article dupliqué

Vous pouvez dupliquer un article en créant un nouvel article avec les mêmes attributs. Pour dupliquer un élément, procédez comme suit.

  1. Recherchez le tableau dans lequel vous souhaitez dupliquer un élément.

  2. Sélectionnez l'article.

  3. Dans le menu déroulant Actions, sélectionnez Dupliquer l'article.

  4. Spécifiez une nouvelle clé de partition.

  5. Spécifiez une nouvelle clé de tri (si nécessaire).

  6. Sélectionnez Exécuter.

Pour plus d'informations sur cette opération, consultez le DeleteItemmanuel Amazon API DynamoDB Reference.

Requête

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 No SQL Workbench.

  2. Spécifiez la valeur de la clé de partition.

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

    2. Spécifiez l'opérateur de comparaison et la valeur de l'attribut.

  4. 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 poursuivez les étapes suivantes.

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

  6. Choisissez l'icône +.

  7. Saisissez l'attribut à retourner avec le résultat de la requête.

  8. Si davantage d'attributs sont nécessaires, choisissez le +.

  9. 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.

    2. Spécifiez le nom d'attribut, l'opérateur de comparaison, le type d'attribut et la valeur d'attribut.

    3. Si d'autres conditions sont nécessaires, choisissez de nouveau Condition.

    Pour de plus amples informations, veuillez consulter Exemple d'expression de condition DynamoDB CLI.

  10. 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.

  11. Si vous souhaitez que l'opération soit exécutée immédiatement, choisissez Run (Exécuter).

  12. 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 la section Requête du manuel Amazon API DynamoDB Reference.

Analyser

Pour exécuter ou générer du code pour une opération Scan, procédez comme suit.

  1. Sélectionnez Scan en haut de l'interface utilisateur de No SQL Workbench.

  2. Cliquez sur le bouton Numériser pour effectuer cette opération de numérisation de base. Si d'autres options sont nécessaires, cochez la case Plus d'options et poursuivez les étapes suivantes.

  3. Spécifiez un nom d'attribut pour filtrer les résultats de votre analyse.

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

  5. 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.

    2. Spécifiez le nom d'attribut, l'opérateur de comparaison, le type d'attribut et la valeur d'attribut.

    3. Si d'autres conditions sont nécessaires, choisissez de nouveau Condition.

    Pour de plus amples informations, veuillez consulter Exemple d'expression de condition DynamoDB CLI.

  6. 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.

  7. Si vous souhaitez que l'opération soit exécutée immédiatement, choisissez Run (Exécuter).

  8. 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 No SQL Workbench, choisissez. TransactGetItems

  2. Cliquez sur l'icône+ à proximité TransactGetItem.

  3. Spécifiez une clé de partition.

  4. Spécifiez une clé de tri (si nécessaire).

  5. 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.

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 No SQL Workbench, choisissez. TransactWriteItems

  2. Choisissez une opération dans le menu déroulant Actions.

  3. Cliquez sur l'icône+ à proximité TransactWriteItem.

  4. Dans le menu déroulant Actions, choisissez l'opération que vous souhaitez effectuer.

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

  5. 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.