Verwendung von Amazon DynamoDB in der AWS CLI

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

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.

Die AWS Command Line Interface (AWS CLI) bietet Unterstützung für alle AWS Datenbankdienste, einschließlich Amazon DynamoDB. Sie können das AWS CLI für spontane Operationen verwenden, z. B. das Erstellen einer Tabelle. Sie können damit auch DynamoDB-Vorgänge in Hilfsprogrammskripts einbetten.

Weitere Informationen zur Verwendung von AWS CLI mit DynamoDB finden Sie dynamodb in der AWS CLI Befehlsreferenz.

Verwenden Sie den folgenden Befehl, um die AWS CLI Befehle für DynamoDB aufzulisten.

$ aws dynamodb help

Voraussetzungen

Zur Ausführung von dynamodb-Befehlen ist Folgendes erforderlich:

Erstellen und Verwenden von DynamoDB-Tabellen

Das Befehlszeilenformat besteht aus einem DynamoDB-Befehlsnamen, gefolgt von den Parametern für diesen Befehl. Das AWS CLI unterstützt die CLI-Kurzsyntax für die Parameterwerte und vollständiges JSON.

Im folgenden Beispiel wird eine Tabelle mit dem Namen MusicCollection erstellt.

$ aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1

Sie können neue Zeilen zur Tabelle hinzufügen mithilfe von Befehlen, die denen im folgenden Beispiel ähneln. Diese Beispiele verwenden eine Kombination von Syntax-Kurznotation und JSON.

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{
        "Artist": {"S": "No One You Know"},
        "SongTitle": {"S": "Call Me Today"} ,
        "AlbumTitle": {"S": "Somewhat Famous"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{ 
        "Artist": {"S": "Acme Band"}, 
        "SongTitle": {"S": "Happy Day"} , 
        "AlbumTitle": {"S": "Songs About Life"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

Es ist nicht einfach, einen gültigen JSON-Code in einem einzeiligen Befehl unterzubringen. Um dies zu vereinfachen, AWS CLI können sie JSON-Dateien lesen. Betrachten Sie dazu das folgende Beispiel für einen JSON-Codeausschnitt. Er wird in einer Datei mit dem Namen expression-attributes.json gespeichert.

{
  ":v1": {"S": "No One You Know"},
  ":v2": {"S": "Call Me Today"}
}

Sie können diese Datei verwenden, um eine query-Anfrage mithilfe der AWS CLI auszugeben. Im folgenden Beispiel wird der Inhalt der Datei expression-attributes.json für den Wert des Parameters --expression-attribute-values verwendet.

$ aws dynamodb query --table-name MusicCollection \
    --key-condition-expression "Artist = :v1 AND SongTitle = :v2" \
    --expression-attribute-values file://expression-attributes.json
{
    "Count": 1,
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "SongTitle": {
                "S": "Call Me Today"
            },
            "Artist": {
                "S": "No One You Know"
            }
        }
    ],
    "ScannedCount": 1,
    "ConsumedCapacity": null
}

Verwenden von DynamoDB Local

Zusätzlich zu DynamoDB können Sie den AWS CLI mit DynamoDB Local verwenden. DynamoDB Local ist eine kleine clientseitige Datenbank, die nach dem Vorbild des DynamoDB-Service funktioniert. Mit DynamoDB Local können Sie Anwendungen schreiben, die die DynamoDB-API verwenden, ohne Tabellen oder Daten im DynamoDB-Webservice zu ändern. Stattdessen werden alle API-Aktionen an eine lokale Datenbank umgeleitet. Dies ermöglicht Ihnen Einsparungen, die den bereitgestellten Durchsatz, die Datenspeicherung und Datenübertragungsgebühren betreffen.

Weitere Informationen zu DynamoDB Local und zur Verwendung mit dem finden Sie in den AWS CLI folgenden Abschnitten des Amazon DynamoDB Developer Guide:

Ressourcen

AWS CLI Referenz:

Service-Referenz: