Erstellen von API-Operationen - Amazon-DynamoDB

Erstellen von API-Operationen

Wenn Sie NoSQL Workbench zum Erstellen von DynamoDB-CRUD-APIs verwenden möchten, wählen Sie auf der linken Seite der Benutzeroberfläche von NoSQL Workbench die Option Operation Builder aus.

Wählen Sie dann Öffnen und anschließend eine Verbindung aus.

Sie können die folgenden Aktionen in Operation Builder durchführen:

Tabelle löschen

Gehen Sie folgendermaßen vor, um die Operation Delete Table auszuführen.

  1. Suchen Sie im Abschnitt Tabellen nach der zu löschenden Tabelle.

  2. Wählen Sie im Dreipunktmenü die Option Tabelle löschen aus.

  3. Bestätigen Sie, dass Sie die Tabelle löschen möchten, indem Sie den Tabellennamen eingeben.

  4. Wählen Sie Löschen aus.

Weitere Informationen zu dieser Operation finden Sie unter Tabelle löschen in der Amazon-DynamoDB-API-Referenz.

Löschen eines GSI

Gehen Sie folgendermaßen vor, um die Operation Delete GSI auszuführen.

  1. Suchen Sie im Abschnitt Tabellen nach dem zu löschenden GSI einer Tabelle.

  2. Wählen Sie im Dreipunktmenü die Option GSI löschen aus.

  3. Bestätigen Sie, dass Sie den GSI löschen möchten, indem Sie den Namen des GSI eingeben.

  4. Wählen Sie Löschen aus.

Weitere Informationen zu dieser Operation finden Sie unter Tabelle löschen in der Amazon-DynamoDB-API-Referenz.

Create table

Gehen Sie folgendermaßen vor, um die Operation Create Table auszuführen.

  1. Klicken Sie neben dem Abschnitt Tabellen auf das Pluszeichen.

  2. Geben Sie den gewünschten Tabellennamen ein.

  3. Erstellen Sie einen Partitionsschlüssel.

  4. Optional: Erstellen Sie einen Sortierschlüssel.

  5. Wenn Sie die Kapazitätseinstellungen anpassen möchten, deaktivieren Sie das Kontrollkästchen neben Standardkapazitätseinstellungen verwenden.

    • Sie können jetzt entweder Bereitgestellt oder On-Demand-Kapazität auswählen.

      Wenn „Bereitgestellt“ ausgewählt ist, können Sie minimale und maximale Lese- und Schreibkapazitätseinheiten festlegen. Sie können außerdem Auto Scaling aktivieren oder deaktivieren.

    • Wenn die Tabelle derzeit auf „On-Demand“ eingestellt ist, können Sie keinen bereitgestellten Durchsatz angeben.

    • Wenn Sie für den Durchsatz von „On-Demand“ zu „Bereitgestellt“ wechseln, wird Auto Scaling automatisch auf alle GSIs angewendet mit: min: 1, max: 10; Ziel: 70 %.

  6. Wählen Sie GSIs überspringen und erstellen aus, um diese Tabelle ohne GSI zu erstellen. Optional können Sie Weiter auswählen, um einen GSI mit dieser neuen Tabelle zu erstellen.

Weitere Informationen zu dieser Operation finden Sie in der Amazon-DynamoDB-API-Referenz unter Tabelle erstellen.

Erstellen eines GSI

Gehen Sie folgendermaßen vor, um die Operation Create GSI auszuführen.

  1. Suchen Sie eine Tabelle, der Sie einen GSI hinzufügen möchten.

  2. Wählen Sie im Dreipunktmenü die Option GSI erstellen aus.

  3. Benennen Sie den GSI unter Index-Name.

  4. Erstellen Sie einen Partitionsschlüssel.

  5. Optional: Erstellen Sie einen Sortierschlüssel.

  6. Wählen Sie aus der Dropdown-Liste einen Projektionstyp aus.

  7. Wählen Sie GSI erstellen.

Weitere Informationen zu dieser Operation finden Sie in der Amazon-DynamoDB-API-Referenz unter Tabelle erstellen.

Tabelle aktualisieren

Gehen Sie folgendermaßen vor, um die Kapazitätseinstellungen für eine Tabelle mit der Operation Update Table zu aktualisieren.

  1. Suchen Sie die Tabelle, deren Kapazitätseinstellungen aktualisiert werden sollen.

  2. Wählen Sie im Dreipunktmenü die Option Kapazitätseinstellungen aktualisieren aus.

  3. Sie können jetzt entweder Bereitgestellt oder On-Demand-Kapazität auswählen.

    Wenn Bereitgestellt ausgewählt ist, können Sie minimale und maximale Lese- und Schreibkapazitätseinheiten festlegen. Sie können außerdem Auto Scaling aktivieren oder deaktivieren.

  4. Wählen Sie Aktualisieren.

Weitere Informationen zu dieser Operation finden Sie in der Amazon-DynamoDB-API-Referenz unter Tabelle aktualisieren.

Aktualisieren eines GSI

Gehen Sie folgendermaßen vor, um die Kapazitätseinstellungen für einen GSI mit der Operation Update Table zu aktualisieren.

Anmerkung

Standardmäßig übernehmen globale sekundäre Indizes die Kapazitätseinstellungen der Basistabelle. Globale sekundäre Indizes können nur dann einen anderen Kapazitätsmodus haben, wenn sich die Basistabelle im Modus „Bereitgestellte Kapazität“ befindet. Wenn Sie einen globalen sekundären Index für eine Tabelle mit dem Modus bereitgestellter Kapazität erstellen, müssen Sie Lese- und Schreibkapazitätseinheiten für den erwarteten Workload dieses Indexes angeben. Weitere Informationen finden Sie unter Überlegungen im Hinblick auf die bereitgestellte Durchsatzkapazität für globale sekundäre Indizes.

  1. Suchen Sie den GSI, dessen Kapazitätseinstellungen aktualisiert werden sollen.

  2. Wählen Sie im Dreipunktmenü die Option Kapazitätseinstellungen aktualisieren aus.

  3. Sie können jetzt entweder Bereitgestellt oder On-Demand-Kapazität auswählen.

    Wenn Bereitgestellt ausgewählt ist, können Sie minimale und maximale Lese- und Schreibkapazitätseinheiten festlegen. Sie können außerdem Auto Scaling aktivieren oder deaktivieren.

  4. Wählen Sie Aktualisieren.

Weitere Informationen zu dieser Operation finden Sie in der Amazon-DynamoDB-API-Referenz unter Tabelle aktualisieren.

Element einfügen

Sie erstellen ein Element mithilfe der Operation Put Item. Zum Ausführen oder Generieren von Code für eine Put Item-Operation gehen Sie folgendermaßen vor.

  1. Suchen Sie die Tabelle, in der Sie ein Element erstellen möchten.

  2. Wählen Sie im Dropdown-Menü Aktionen die Option Element erstellen aus.

  3. Geben Sie den Partitionsschlüsselwert ein.

  4. Geben Sie den Sortierschlüsselwert ein, falls vorhanden.

  5. Gehen Sie folgendermaßen vor, falls Sie Nicht-Schlüssel-Attribute hinzufügen möchten:

    1. Wählen Sie + Weitere Attribute hinzufügen aus.

    2. Geben Sie Attribute name (Attributname), Type (Typ) und Value (Wert) an.

  6. Falls ein Bedingungsausdruck erfüllt sein muss, damit die Put Item-Operation erfolgreich ist, gehen Sie folgendermaßen vor:

    1. Wählen Sie Condition (Bedingung).

    2. Geben Sie den Attributnamen, Vergleichsoperator, Attributtyp und Attributwert an.

    3. Falls weitere Bedingungen erforderlich sind, wählen Sie erneut Condition (Bedingung).

    Weitere Informationen finden Sie unter CLI-Beispiel für DynamoDB-Bedingungsausdrücke.

  7. Falls Sie Code generieren möchten, wählen Sie Generate code (Code generieren) aus.

    Wählen Sie in den angezeigten Tabs Ihre gewünschte Sprache aus. Sie können diesen Code jetzt kopieren und in Ihrer Anwendung verwenden.

  8. Falls die Operation sofort ausgeführt werden soll, wählen Sie Run (Ausführen).

  9. Wenn Sie diese Operation für die spätere Verwendung speichern möchten, wählen Sie Save operation (Operation speichern) aus, geben Sie einen Namen für Ihre Operation ein und wählen Sie Save (Speichern) aus.

Weitere Informationen zu dieser Operation finden Sie unter PutItem in den Amazon-DynamoDB-API-Referenzen.

Element aktualisieren

Zum Ausführen oder Generieren von Code für eine Update Item-Operation gehen Sie folgendermaßen vor.

  1. Suchen Sie die Tabelle, in der Sie ein Element aktualisieren möchten.

  2. Wählen Sie das Element aus.

  3. Geben Sie den Namen und den Wert des Attributs für den ausgewählten Ausdruck ein.

  4. Falls Sie weitere Ausdrücke hinzufügen möchten, wählen Sie einen anderen Ausdruck in der Dropdown-Liste Ausdruck aktualisieren aus und klicken Sie anschließend auf das Pluszeichen.

  5. Falls ein Bedingungsausdruck erfüllt sein muss, damit die Update Item-Operation erfolgreich ist, gehen Sie folgendermaßen vor:

    1. Wählen Sie Condition (Bedingung).

    2. Geben Sie den Attributnamen, Vergleichsoperator, Attributtyp und Attributwert an.

    3. Falls weitere Bedingungen erforderlich sind, wählen Sie erneut Condition (Bedingung).

    Weitere Informationen finden Sie unter CLI-Beispiel für DynamoDB-Bedingungsausdrücke.

  6. Falls Sie Code generieren möchten, wählen Sie Generate code (Code generieren).

    Wählen Sie den Tab für die gewünschte Sprache. Sie können diesen Code jetzt kopieren und in Ihrer Anwendung verwenden.

  7. Falls die Operation sofort ausgeführt werden soll, wählen Sie Run (Ausführen).

  8. Wenn Sie diese Operation für die spätere Verwendung speichern möchten, wählen Sie Save operation (Operation speichern) aus, geben Sie einen Namen für Ihre Operation ein und wählen Sie Save (Speichern) aus.

Weitere Informationen zu dieser Operation finden Sie unter Updatetem in den Amazon-DynamoDB-API-Referenzen.

Element löschen

Gehen Sie folgendermaßen vor, um die Operation Delete Item auszuführen.

  1. Suchen Sie die Tabelle, in der Sie ein Element löschen möchten.

  2. Wählen Sie das Element aus.

  3. Wählen Sie im Dropdown-Menü Aktionen die Option Element löschen aus.

  4. Bestätigen Sie, dass Sie das Element löschen möchten, indem Sie Löschen auswählen.

Weitere Informationen zu dieser Operation finden Sie unter DeleteItem in den Amazon-DynamoDB-API-Referenzen.

Duplizieren eines Elements

Sie können ein Element duplizieren, indem Sie ein neues Element mit den gleichen Attributen erstellen. Gehen Sie folgendermaßen vor, um ein Element zu duplizieren.

  1. Suchen Sie die Tabelle, in der Sie ein Element duplizieren möchten.

  2. Wählen Sie das Element aus.

  3. Wählen Sie im Dropdown-Menü Aktionen die Option Element duplizieren aus.

  4. Geben Sie einen neuen Partitionsschlüssel an.

  5. Geben Sie einen neuen Sortierschlüssel an (falls erforderlich).

  6. Wählen Sie Ausführen aus.

Weitere Informationen zu dieser Operation finden Sie unter DeleteItem in den Amazon-DynamoDB-API-Referenzen.

Abfrage

Zum Ausführen oder Generieren von Code für eine Query-Operation gehen Sie folgendermaßen vor.

  1. Wählen Sie oben in der NoSQL Workbench-Benutzeroberfläche die Option Abfrage aus.

  2. Geben Sie den Partitionsschlüsselwert an.

  3. Falls ein Sortierschlüssel für die Query-Operation erforderlich ist:

    1. Wählen Sie Sortierschlüssel aus:

    2. Geben Sie den Vergleichsoperator und Attributwert an.

  4. Wählen Sie Abfrage aus, um den Abfragevorgang auszuführen. Wenn weitere Optionen benötigt werden, aktivieren Sie das Kontrollkästchen Weitere Optionen und fahren Sie mit den folgenden Schritten fort.

  5. Falls nicht alle Attribute mit dem Operationsergebnis zurückgegeben werden sollen, wählen Sie Projection expression (Projektionsausdruck)aus.

  6. Klicken Sie auf das Pluszeichen (+).

  7. Geben Sie das Attribut ein, das mit dem Abfrageergebnis zurückgegeben werden soll.

  8. Falls weitere Attribute erforderlich sind, wählen Sie + (Pluszeichen).

  9. Falls ein Bedingungsausdruck erfüllt sein muss, damit die Query-Operation erfolgreich ist, gehen Sie folgendermaßen vor:

    1. Wählen Sie Condition (Bedingung).

    2. Geben Sie den Attributnamen, Vergleichsoperator, Attributtyp und Attributwert an.

    3. Falls weitere Bedingungen erforderlich sind, wählen Sie erneut Condition (Bedingung).

    Weitere Informationen finden Sie unter CLI-Beispiel für DynamoDB-Bedingungsausdrücke.

  10. Falls Sie Code generieren möchten, wählen Sie Generate code (Code generieren).

    Wählen Sie den Tab für die gewünschte Sprache. Sie können diesen Code jetzt kopieren und in Ihrer Anwendung verwenden.

  11. Falls die Operation sofort ausgeführt werden soll, wählen Sie Run (Ausführen).

  12. Wenn Sie diese Operation für die spätere Verwendung speichern möchten, wählen Sie Save operation (Operation speichern) aus, geben Sie einen Namen für Ihre Operation ein und wählen Sie Save (Speichern) aus.

Weitere Informationen zu dieser Operation finden Sie unter Abfragen in den Amazon-DynamoDB-API-Referenzen.

Scan

Zum Ausführen oder Generieren von Code für eine Scan-Operation gehen Sie folgendermaßen vor.

  1. Wählen Sie oben in der NoSQL Workbench-Benutzeroberfläche die Option Scan aus.

  2. Klicken Sie auf die Schaltfläche Scan, um diesen einfachen Scanvorgang durchzuführen. Wenn weitere Optionen benötigt werden, aktivieren Sie das Kontrollkästchen Weitere Optionen und fahren Sie mit den folgenden Schritten fort.

  3. Geben Sie einen Attributnamen an, um die Scanergebnisse zu filtern.

  4. Falls nicht alle Attribute mit dem Operationsergebnis zurückgegeben werden sollen, wählen Sie Projection expression (Projektionsausdruck)aus.

  5. Falls ein Bedingungsausdruck erfüllt sein muss, damit die Scan-Operation erfolgreich ist, gehen Sie folgendermaßen vor:

    1. Wählen Sie Condition (Bedingung).

    2. Geben Sie den Attributnamen, Vergleichsoperator, Attributtyp und Attributwert an.

    3. Falls weitere Bedingungen erforderlich sind, wählen Sie erneut Condition (Bedingung).

    Weitere Informationen finden Sie unter CLI-Beispiel für DynamoDB-Bedingungsausdrücke.

  6. Falls Sie Code generieren möchten, wählen Sie Generate code (Code generieren).

    Wählen Sie den Tab für die gewünschte Sprache. Sie können diesen Code jetzt kopieren und in Ihrer Anwendung verwenden.

  7. Falls die Operation sofort ausgeführt werden soll, wählen Sie Run (Ausführen).

  8. Wenn Sie diese Operation für die spätere Verwendung speichern möchten, wählen Sie Save operation (Operation speichern) aus, geben Sie einen Namen für Ihre Operation ein und wählen Sie Save (Speichern) aus.

TransactGetItems

Zum Ausführen oder Generieren von Code für eine TransactGetItems-Operation gehen Sie folgendermaßen vor.

  1. Wählen Sie im Dropdown-Menü Weitere Operationen oben in der NoSQL-Workbench-Benutzeroberfläche die Option TransactGetItems aus.

  2. Klicken Sie auf das Pluszeichen neben TransactGetItem.

  3. Geben Sie einen Partitionsschlüssel an.

  4. Geben Sie einen Sortierschlüssel an (falls erforderlich).

  5. Wählen Sie Ausführen, um den Vorgang auszuführen, Vorgang speichern, um ihn zu speichern, oder Code generieren, um Code dafür zu generieren.

Weitere Informationen über Transaktionen finden Sie unter Amazon DynamoDB Transactions.

TransactWriteItems

Zum Ausführen oder Generieren von Code für eine TransactWriteItems-Operation gehen Sie folgendermaßen vor.

  1. Wählen Sie im Dropdown-Menü Weitere Operationen oben in der NoSQL-Workbench-Benutzeroberfläche die Option TransactWriteItems aus.

  2. Wählen Sie aus dem Dropdown-Menü Aktionen einen Vorgang aus.

  3. Klicken Sie auf das Pluszeichen neben TransactWriteItem.

  4. Wählen Sie im Dropdown-Menü Aktionen die gewünschte Operation.

    Zum Ändern der Reihenfolge der Aktionen wählen Sie eine Aktion in der Liste auf der linken Seite und dann den Nach-oben- oder Nach-unten-Pfeil, um sie in der Liste nach oben oder unten zu verschieben.

    Zum Löschen einer Aktion wählen Sie diese in der Liste und dann das Symbol Delete (Löschen) (Papierkorb).

  5. Wählen Sie Ausführen, um den Vorgang auszuführen, Vorgang speichern, um ihn zu speichern, oder Code generieren, um Code dafür zu generieren.

Weitere Informationen über Transaktionen finden Sie unter Amazon DynamoDB Transactions.