Verwenden von Amazon DynamoDB in der AWS CLI

Die AWS Command Line Interface (AWS CLI) unterstützt alle AWS-Datenbank-Services, einschließlich Amazon DynamoDB. Sie können die AWS CLI für improvisierte Vorgänge wie das Erstellen einer Tabelle verwenden. Sie können damit auch DynamoDB-Vorgänge in Hilfsprogrammskripts einbetten.

Weitere Informationen zur Verwendung der AWS CLI mit DynamoDB finden Sie unter 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. Die AWS CLI unterstützt die CLI-Syntax-Kurznotation für die Parameterwerte und JSON (vollständig).

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, kann die AWS CLI 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

Außer mit DynamoDB können Sie die AWS CLI auch 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 der Verwendung mit AWS CLI finden Sie in den folgenden Abschnitten im Amazon-DynamoDB-Entwicklerhandbuch:

Ressourcen

AWS CLI-Referenz:

Service-Referenz: