

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erkunden von Datasets und Erstellen von Vorgängen mit NoSQL Workbench
<a name="workbench.querybuilder"></a>

NoSQL Workbench für Amazon DynamoDB stellt eine umfassende Grafikbenutzeroberfläche für die Entwicklung und den Test von Abfragen bereit. Sie können den Operation Builder in NoSQL Workbench verwenden, um Live-Datensätze anzuzeigen, zu erkunden und abzufragen. Der strukturierte Operation Builder unterstützt Projektionsausdrücke und Bedingungsausdrücke und generiert Beispielcode in mehreren Sprachen. Sie können Tabellen von einem Amazon-DynamoDB-Konto direkt in ein anderes in verschiedenen Regionen klonen. Sie können Tabellen auch direkt zwischen einer lokalen Version von DynamoDB und einem Amazon-DynamoDB-Konto klonen, um das Schlüsselschema Ihrer Tabelle (und optional das Schema und Elemente des GSI) schneller zwischen Ihren Entwicklungsumgebungen zu kopieren. Im Operation Builder lassen sich bis zu 50 DynamoDB-Datenoperationen speichern.

**Topics**
+ [Herstellen einer Verbindung zu Live-Datensätzen](workbench.querybuilder.connect.md)
+ [Erstellen komplexer Operationen](workbench.querybuilder.operationbuilder.md)
+ [Klonen von Tabellen mit NoSQL Workbench](workbench.querybuilder.cloning-tables.md)
+ [Exportieren von Daten in eine CSV-Datei](workbench.querybuilder.exportcsv.md)

# Herstellen einer Verbindung zu Live-Datensätzen
<a name="workbench.querybuilder.connect"></a>

Um mit NoSQL Workbench eine Verbindung zu Ihren Amazon DynamoDB-Tabellen herzustellen, müssen Sie zunächst eine Verbindung zu Ihrem Konto herstellen. AWS 

**Hinzufügen einer Verbindung zu Ihrer Datenbank**

1. Wählen Sie in NoSQL Workbench im Navigationsbereich auf der linken Seite das Symbol **Operation Builder**.

1. Wählen Sie **Add connection** (Verbindung hinzufügen).

1. Geben Sie folgende Informationen an:
   + **Verbindungsname**
   + **AWS Region**
   + **Zugriffsschlüssel-ID**
   + **Geheimer Zugriffsschlüssel**

   Weitere Informationen darüber, wie Sie die Zugriffsschlüssel erhalten, finden Sie unter Einen Zugriffsschlüssel [abrufen](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials). AWS 

   Optional können Sie Folgendes angeben:
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
   + [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)

1. Wählen Sie **Connect** (Verbinden) aus.

    Wenn Sie sich nicht für ein Konto mit kostenlosem Kontingent registrieren möchten und lieber [die lokale Version von DynamoDB (herunterladbare Version)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) verwenden möchten: 

   1. Wählen Sie die Registerkarte **Local** (Lokal) auf dem Verbindungsbildschirm aus.

   1. Geben Sie folgende Informationen an:
      + **Verbindungsname**
      + **Port**

   1. Wählen Sie die Schaltfläche **connect** (Verbinden).
**Anmerkung**  
Um eine Verbindung zur lokalen Version von DynamoDB herzustellen, starten Sie diese entweder manuell über Ihr Terminal (siehe [Bereitstellen von DynamoDB Locally lokal auf Ihrem Computer](DynamoDBLocal.DownloadingAndRunning.md)) oder direkt mit dem Schalter für die lokale Version von DDB im NoSQL-Workbench-Navigationsmenü. Stellen Sie sicher, dass der Verbindungsport mit Ihrem lokalen DynamoDB-Port identisch ist.

1. Wählen Sie für die erstellte Verbindung die Option **Open** (Öffnen).

Nach dem Herstellen der Verbindung mit Ihrer DynamoDB-Datenbank erscheint die Liste der verfügbaren Tabellen im linken Bereich. Wählen Sie eine der Tabellen aus, um ein Beispiel der in der Tabelle gespeicherten Daten zurückzugeben.

Sie können jetzt Abfragen an der ausgewählten Tabelle ausführen.

Informationen zum Ausführen von Abfragen für eine Tabelle finden Sie im nächsten Abschnitt über das Erstellen von Operationen unter [Erstellen komplexer Operationen](workbench.querybuilder.operationbuilder.md).

# Erstellen komplexer Operationen
<a name="workbench.querybuilder.operationbuilder"></a>

Der Operation Builder in NoSQL Workbench für Amazon DynamoDB stellt eine visuelle Schnittstelle bereit, auf der Sie komplexe Datenebenen-Operationen durchführen können. Er beinhaltet Unterstützung für Projektionsausdrücke und Bedingungsausdrücke. Nachdem Sie einen Vorgang erstellt haben, können Sie ihn für die spätere Verwendung speichern (bis zu 50 Vorgänge können gespeichert werden). Anschließend können Sie im Menü **Gespeicherte Vorgänge** eine Liste der häufig verwendeten Datenebenenvorgänge durchsuchen und diese verwenden, um automatisch einen neuen Vorgang aufzufüllen und zu erstellen. Sie können auch Beispielcode für diese Vorgänge in mehreren Sprachen erstellen.

NoSQL Workbench unterstützt das Erstellen von [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) für DynamoDB-Anweisungen, sodass Sie mithilfe einer SQL-kompatiblen Abfragesprache mit DynamoDB interagieren können. NoSQL Workbench unterstützt auch das Erstellen von DynamoDB-CRUD-API-Operationen.

Um NoSQL Workbench zum Erstellen von Operationen zu verwenden, wählen Sie im Navigationsbereich auf der linken Seite das Symbol **Operation Builder** aus.

**Topics**
+ [Erstellen von PartiQL-Anweisungen](workbench.querybuilder.partiql.md)
+ [Erstellen von API-Operationen](workbench.querybuilder.operationbuilder.api.md)

# Erstellen von PartiQL-Anweisungen
<a name="workbench.querybuilder.partiql"></a>

Wenn Sie mit NoSQL Workbench [PartiQL-für-DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html)-Anweisungen erstellen möchten, wählen Sie oben in NoSQL Workbench **PartiQL-Editor** aus.

Sie können die folgenden PartiQL-Anweisungstypen in Operation Builder erstellen:

**Topics**
+ [Singleton-Anweisungen](#workbench.querybuilder.partiql.single)
+ [Transaktionen](#workbench.querybuilder.partiql.transaction)
+ [Batch](#workbench.querybuilder.partiql.batch)

## Singleton-Anweisungen
<a name="workbench.querybuilder.partiql.single"></a>

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

1. Wählen Sie oben im Fenster den **PartiQL-Editor** aus.

1. Geben Sie eine gültige [PartiQL-Anweisung](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) ein.

1. Wenn Ihre Anweisung Parameter verwendet:

   1. Klicken Sie auf **Optional request parameter** (Optionale Anfrageparameter).

   1. Klicken Sie auf **Add new parameters** (Fügen Sie neue Parameter hinzu).

   1. Geben Sie den Attributtyp und -wert ein.

   1. Wenn Sie zusätzliche Parameter hinzufügen möchten, wiederholen Sie die Schritte b und c.

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

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

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

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

## Transaktionen
<a name="workbench.querybuilder.partiql.transaction"></a>

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

1. Wählen Sie **Parti QLTransaction** aus der Dropdownliste **Weitere Operationen** aus.

1. Wählen Sie **Add new statement** (Neue Anweisung hinzufügen) aus.

1. Geben Sie eine gültige [PartiQL-Anweisung](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) ein.
**Anmerkung**  
Lese- und Schreibvorgänge werden in derselben PartiQL-Transaktionsanforderung nicht unterstützt. Eine SELECT-Anweisung darf sich nicht in derselben Anforderung mit INSERT-, UPDATE- und DELETE-Anweisungen befinden. Weitere Details finden Sie in unter [Ausführen von Transaktionen mit PartiQL für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html)

1. Wenn Ihre Anweisung Parameter verwendet

   1. Wählen Sie **Optional request parameters** (Optionale Anforderungsparameter) aus.

   1. Klicken Sie auf **Add new parameters** (Fügen Sie neue Parameter hinzu).

   1. Geben Sie den Attributtyp und -wert ein.

   1. Wenn Sie zusätzliche Parameter hinzufügen möchten, wiederholen Sie die Schritte b und c.

1. Wenn Sie weitere Anweisungen hinzufügen möchten, wiederholen Sie die Schritte 2 bis 4.

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

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

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

## Batch
<a name="workbench.querybuilder.partiql.batch"></a>

Zum Ausführen oder Generieren von Code für einen PartiQL-Batch gehen Sie folgendermaßen vor.

1. Wählen Sie **Parti QLBatch aus dem Drop-down-Menü** **Weitere** Operationen aus.

1. Wählen Sie **Add new statement** (Neue Anweisung hinzufügen) aus.

1. Geben Sie eine gültige [PartiQL-Anweisung](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) ein.
**Anmerkung**  
 Lese- und Schreibvorgänge werden in derselben PartiQL-Batchanforderung nicht unterstützt, was bedeutet, dass sich eine SELECT-Anweisung nicht in derselben Anforderung mit INSERT-, UPDATE- und DELETE-Anweisungen befinden kann. Schreibvorgänge auf dasselbe Element sind nicht zulässig. Wie bei der BatchGetItem Operation werden nur Singleton-Lesevorgänge unterstützt. Scan- und Abfragevorgänge werden nicht unterstützt. Weitere Details finden Sie in unter [Ausführen von Batchvorgängen mit PartiQL für DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html).

1. Wenn Ihre Anweisung Parameter verwendet:

   1. Klicken Sie auf **Optional request parameter** (Optionale Anfrageparameter).

   1. Klicken Sie auf **Add new parameters** (Fügen Sie neue Parameter hinzu).

   1. Geben Sie den Attributtyp und -wert ein.

   1. Wenn Sie zusätzliche Parameter hinzufügen möchten, wiederholen Sie die Schritte b und c.

1. Wenn Sie weitere Anweisungen hinzufügen möchten, wiederholen Sie die Schritte 2 bis 4.

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

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

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

# Erstellen von API-Operationen
<a name="workbench.querybuilder.operationbuilder.api"></a>

Um NoSQL Workbench zum Erstellen von DynamoDB CRUD zu verwenden APIs, wählen Sie **Operation Builder** auf der linken Seite der NoSQL Workbench-Benutzeroberfläche 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](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [Tabelle erstellen](#workbench.querybuilder.operationbuilder.CreateTable)
+ [Tabelle aktualisieren](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [PutItem](#workbench.querybuilder.operationbuilder.Put)
+ [Element aktualisieren](#workbench.querybuilder.operationbuilder.update)
+ [Element löschen](#workbench.querybuilder.operationbuilder.Delete)
+ [Query](#workbench.querybuilder.operationbuilder.Query)
+ [Scan](#workbench.querybuilder.operationbuilder.scan)
+ [TransactGetItems](#workbench.querybuilder.operationbuilder.transactget)
+ [TransactWriteItems](#workbench.querybuilder.operationbuilder.transactwrite)

## Tabelle löschen
<a name="workbench.querybuilder.operationbuilder.DeleteTable"></a>

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

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

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

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

1. Wählen Sie **Löschen** aus.

Weitere Informationen zu dieser Operation finden Sie unter [Tabelle löschen](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) in der *Amazon-DynamoDB-API-Referenz*. 

## Löschen eines GSI
<a name="workbench.querybuilder.operationbuilder.DeleteGSI"></a>

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.

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

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

1. Wählen Sie **Löschen** aus.

Weitere Informationen zu dieser Operation finden Sie unter [Tabelle löschen](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) in der *Amazon-DynamoDB-API-Referenz*. 

## Tabelle erstellen
<a name="workbench.querybuilder.operationbuilder.CreateTable"></a>

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

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

1. Geben Sie den gewünschten Tabellennamen ein.

1. Erstellen Sie einen Partitionsschlüssel.

1. Optional: Erstellen Sie einen Sortierschlüssel.

1. 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 von On-Demand-Durchsatz zu Bereitgestelltem Durchsatz wechseln, wird Autoscaling automatisch auf alle GSIs mit folgenden Werten angewendet: min: 1, max.: 10; Ziel: 70%

1. Wählen Sie **Überspringen GSIs 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html). 

## Erstellen eines GSI
<a name="workbench.querybuilder.operationbuilder.CreateGSI"></a>

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.

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

1. Benennen Sie den GSI unter **Index-Name**.

1. Erstellen Sie einen Partitionsschlüssel.

1. Optional: Erstellen Sie einen Sortierschlüssel.

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

1. Wählen Sie **GSI erstellen**.

Weitere Informationen zu dieser Operation finden Sie unter [Tabelle erstellen](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) in der *Amazon-DynamoDB-API-Referenz*. 

## Tabelle aktualisieren
<a name="workbench.querybuilder.operationbuilder.UpdateTable"></a>

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.

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

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

1. Wählen Sie **Aktualisieren**.

Weitere Informationen zu dieser Operation finden Sie in der *Amazon-DynamoDB-API-Referenz* unter [Tabelle aktualisieren](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html).

## Aktualisieren eines GSI
<a name="workbench.querybuilder.operationbuilder.UpdateGSI"></a>

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](GSI.md#GSI.ThroughputConsiderations).

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

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

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

1. Wählen Sie **Aktualisieren**.

Weitere Informationen zu dieser Operation finden Sie in der *Amazon-DynamoDB-API-Referenz* unter [Tabelle aktualisieren](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html).

## Element einfügen
<a name="workbench.querybuilder.operationbuilder.Put"></a>

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.

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

1. Geben Sie den Partitionsschlüsselwert ein.

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

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

   1. Wählen Sie **\$1 Weitere Attribute hinzufügen** aus.

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

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

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

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

   Weitere Informationen finden Sie unter [CLI-Beispiel für DynamoDB-Bedingungsausdrücke](Expressions.ConditionExpressions.md).

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

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

1. 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 diesem Vorgang finden Sie [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)in der *Amazon DynamoDB DynamoDB-API-Referenz*. 

## Element aktualisieren
<a name="workbench.querybuilder.operationbuilder.update"></a>

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.

1. Wählen Sie das Element aus.

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

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

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

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

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

   Weitere Informationen finden Sie unter [CLI-Beispiel für DynamoDB-Bedingungsausdrücke](Expressions.ConditionExpressions.md).

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

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

1. 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 diesem Vorgang finden Sie [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)in der *Amazon DynamoDB DynamoDB-API-Referenz*. 

## Element löschen
<a name="workbench.querybuilder.operationbuilder.Delete"></a>

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. 

1. Wählen Sie das Element aus.

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

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

Weitere Informationen zu diesem Vorgang finden Sie [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)in der *Amazon DynamoDB DynamoDB-API-Referenz*.

## Duplizieren eines Elements
<a name="workbench.querybuilder.operationbuilder.Duplicate"></a>

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.

1. Wählen Sie das Element aus.

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

1. Geben Sie einen neuen Partitionsschlüssel an.

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

1. Wählen Sie **Ausführen** aus.

Weitere Informationen zu diesem Vorgang finden Sie [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)in der *Amazon DynamoDB DynamoDB-API-Referenz*.

## Query
<a name="workbench.querybuilder.operationbuilder.Query"></a>

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.

1. Geben Sie den Partitionsschlüsselwert an.

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

   1. Wählen Sie **Sortierschlüssel** aus:

   1. Geben Sie den Vergleichsoperator und Attributwert an.

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

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

1. Klicken Sie auf das Pluszeichen (**\$1**).

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

1. Falls weitere Attribute erforderlich sind, wählen Sie **\$1** (Pluszeichen).

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

   1. Wählen Sie **Condition** (Bedingung).

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

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

   Weitere Informationen finden Sie unter [CLI-Beispiel für DynamoDB-Bedingungsausdrücke](Expressions.ConditionExpressions.md).

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

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

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html) in den *Amazon-DynamoDB-API-Referenzen*. 

## Scan
<a name="workbench.querybuilder.operationbuilder.scan"></a>

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.

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

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

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

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

   1. Wählen Sie **Condition** (Bedingung).

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

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

   Weitere Informationen finden Sie unter [CLI-Beispiel für DynamoDB-Bedingungsausdrücke](Expressions.ConditionExpressions.md).

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

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

1. 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
<a name="workbench.querybuilder.operationbuilder.transactget"></a>

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

1. Wählen Sie in der Dropdownliste **Weitere Operationen** oben in der NoSQL Workbench-Benutzeroberfläche die Option aus. **TransactGetItems**

1. Wählen Sie das Pluszeichen (**\$1) in der Nähe**. **TransactGetItem**

1. Geben Sie einen Partitionsschlüssel an.

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

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

## TransactWriteItems
<a name="workbench.querybuilder.operationbuilder.transactwrite"></a>

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

1. Wählen Sie in der Dropdownliste **Weitere Operationen** oben in der NoSQL Workbench-Benutzeroberfläche die Option aus. **TransactWriteItems**

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

1. Wählen Sie das Pluszeichen (**\$1) in der Nähe**. **TransactWriteItem**

1. Wählen Sie im Dropdown-Menü **Aktionen** die gewünschte Operation.
   + Befolgen Sie für `DeleteItem` die Anweisungen für die [Element löschen](#workbench.querybuilder.operationbuilder.Delete)-Operation. 
   + Befolgen Sie für `PutItem` die Anweisungen für die [Element einfügen](#workbench.querybuilder.operationbuilder.Put)-Operation. 
   + Befolgen Sie für `UpdateItem` die Anweisungen für die [Element aktualisieren](#workbench.querybuilder.operationbuilder.update)-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). 

1. 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](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).

# Klonen von Tabellen mit NoSQL Workbench
<a name="workbench.querybuilder.cloning-tables"></a>

Durch das Klonen von Tabellen werden die wichtigsten Schemata einer Tabelle (und optional das GSI-Schema und Elemente) zwischen Ihren Entwicklungsumgebungen kopiert. Sie können eine Tabelle von der lokalen Version von DynamoDB zu einem Amazon-DynamoDB-Konto klonen und sogar von einem Konto in ein anderes in verschiedenen Regionen, um Tests zu beschleunigen.

**So klonen Sie eine Tabelle**

1. Wählen Sie im **Operation Builder** Ihre Verbindung und Region aus (die Regionsauswahl ist für die lokale Version von DynamoDB nicht verfügbar).

1. Sobald Sie mit DynamoDB verbunden sind, durchsuchen Sie Ihre Tabellen und wählen Sie die Tabelle aus, die Sie klonen möchten.

1. Wählen Sie im Dreipunktmenü die Option **Klonen** aus.

1. Geben Sie die Details zum Klonziel ein:

   1. Wählen Sie eine Verbindung aus.

   1. Wählen Sie eine Region aus („Region“ ist für die lokale Version von DynamoDB nicht verfügbar).

   1. Geben Sie einen neuen Tabellennamen ein.

   1. Wählen Sie eine Klonoption:

      1. Das **Schlüsselschema** ist standardmäßig ausgewählt und kann nicht deaktiviert werden. Standardmäßig werden beim Klonen einer Tabelle der Primärschlüssel und der Sortierschlüssel kopiert, sofern sie verfügbar sind.

      1. Das **GSI-Schema** ist standardmäßig ausgewählt, wenn die zu klonende Tabelle über einen GSI verfügt. Standardmäßig werden beim Klonen einer Tabelle der Primärschlüssel und der Sortierschlüssel des GSI kopiert, sofern sie verfügbar sind. Sie können das GSI-Schema deaktivieren, um das Klonen des GSI-Schemas zu überspringen. Beim Klonen einer Tabelle werden die Kapazitätseinstellungen der Basistabelle für den GSI kopiert. Sie können den Vorgang `UpdateTable` in Operation Builder verwenden, um die GSI-Kapazitätseinstellung der Tabelle zu aktualisieren, nachdem das Klonen abgeschlossen ist.

1. Geben Sie die Anzahl der zu klonenden Elemente ein. Um nur das Schlüsselschema und optional das GSI-Schema zu klonen, können Sie den Wert **Zu klonende Elemente** bei 0 belassen. Maximal können 5 000 Elemente geklont werden.

1. Wählen Sie einen Kapazitätsmodus:

   1. Der Modus **On-Demand** ist standardmäßig ausgewählt. DynamoDB On-Demand bietet pay-per-request Preise für Lese- und Schreibanforderungen, sodass Sie nur für das bezahlen, was Sie tatsächlich nutzen. Weitere Informationen finden Sie unter [DynamoDB On-demand mode](capacity-mode.md#capacity-mode-on-demand).

   1. Im **bereitgestellten Modus** können Sie die Anzahl der Lese- und Schreibvorgänge pro Sekunde festlegen, die Sie für Ihre Anwendung benötigen. Die bereitgestellte Kapazität Ihrer Tabelle kann mithilfe von Auto Scaling als Reaktion auf Datenverkehrsänderungen automatisch angepasst werden. Weitere Informationen finden Sie unter [DynamoDB Provisioned mode](provisioned-capacity-mode.md).

1. Wählen Sie **Klonen**, um mit dem Klonen zu beginnen.

1. Der Klonvorgang wird im Hintergrund ausgeführt. Auf der Registerkarte **Operation Builder** wird eine Benachrichtigung angezeigt, wenn sich der Status der Klontabelle ändert. Sie können diesen Status abrufen, indem Sie die Registerkarte **Operation Builder** und dann die Pfeilschaltfläche auswählen. Die Pfeilschaltfläche befindet sich im Status-Widget zum Klonen von Tabellen am unteren Rand der Menüseitenleiste.

# Exportieren von Daten in eine CSV-Datei
<a name="workbench.querybuilder.exportcsv"></a>

Sie können die Ergebnisse einer Abfrage aus dem Operation Builder in eine CSV-Datei exportieren. Auf diese Weise können Sie die Daten in eine Tabelle laden oder in Ihrer bevorzugten Programmiersprache verarbeiten.

**Exportieren in CSV**

1. Führen Sie im Operation Builder einen Vorgang Ihrer Wahl aus, z. B. einen Scan oder eine Abfrage.
**Anmerkung**  
Sie können nur Ergebnisse von API-Lesevorgängen und PartiQL-Anweisungen in eine CSV-Datei exportieren. Ergebnisse von Transaktionsleseanweisungen können nicht exportiert werden.
Derzeit können Sie Ergebnisse nur seitenweise in eine CSV-Datei exportieren. Wenn mehrere Ergebnisseiten vorliegen, muss jede Seite einzeln exportiert werden.

1. Wählen Sie aus den Ergebnissen die Elemente aus, die exportiert werden sollen.

1. Wählen Sie im Dropdown-Menü **Aktionen** die Option **Als CSV exportieren** aus.

1. Wählen Sie einen Dateinamen und einen Speicherort für die CSV-Datei und anschließend **Speichern** aus.