Grundlegende Operationen für DynamoDB-Tabellen

Ähnlich wie andere Datenbanksysteme speichert Amazon DynamoDB Daten in Tabellen. Sie können Ihre Tabellen mit einigen grundlegenden Operationen verwalten.

Erstellen einer Tabelle

Verwenden Sie CreateTable, um eine Tabelle in Amazon DynamoDB zu erstellen. Zum Erstellen einer Tabelle müssen Sie folgende Informationen angeben:

Beispiel 1: Erstellen einer Tabelle im Modus bereitgestellter Kapazität

Das folgende AWS CLI Beispiel zeigt, wie eine Tabelle () erstellt wird. Music Der Primärschlüssel besteht aus Artist (Partitionsschlüssel) und SongTitle (Sortierschlüssel), die beide vom Datentyp String sind. Der maximale Durchsatz für diese Tabelle ist 10 Lesekapazitätseinheiten und 5 Schreibkapazitätseinheiten.

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

Die CreateTable-Operation gibt Metadaten für die Tabelle, wie unten gezeigt, zurück.

{
    "TableDescription": {
        "TableArn": "arn:aws:dynamodb:us-east-1:123456789012:table/Music",
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "WriteCapacityUnits": 5,
            "ReadCapacityUnits": 10
        },
        "TableSizeBytes": 0,
        "TableName": "Music",
        "TableStatus": "CREATING",
        "TableId": "12345678-0123-4567-a123-abcdefghijkl",
        "KeySchema": [
            {
                "KeyType": "HASH",
                "AttributeName": "Artist"
            },
            {
                "KeyType": "RANGE",
                "AttributeName": "SongTitle"
            }
        ],
        "ItemCount": 0,
        "CreationDateTime": 1542397215.37
    }
}

Das Element TableStatus gibt den aktuellen Status der Tabelle an (CREATING). Es kann eine Weile dauern die Tabelle zu erstellen, abhängig von den Werten die Sie für ReadCapacityUnits und WriteCapacityUnits angeben. Größere Werte für diese erfordern, dass DynamoDB der Tabelle mehr Ressourcen zuweist.

Beispiel 2: Erstellen einer On-Demand-Tabelle

So erstellen Sie dieselbe Tabelle Music im On-Demand-Modus

aws dynamodb create-table \
    --table-name Music \
    --attribute-definitions \
        AttributeName=Artist,AttributeType=S \
        AttributeName=SongTitle,AttributeType=S \
    --key-schema \
        AttributeName=Artist,KeyType=HASH \
        AttributeName=SongTitle,KeyType=RANGE \
    --billing-mode=PAY_PER_REQUEST

Die CreateTable-Operation gibt Metadaten für die Tabelle, wie unten gezeigt, zurück.

{
    "TableDescription": {
        "TableArn": "arn:aws:dynamodb:us-east-1:123456789012:table/Music",
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "WriteCapacityUnits": 0,
            "ReadCapacityUnits": 0
        },
        "TableSizeBytes": 0,
        "TableName": "Music",
        "BillingModeSummary": {
            "BillingMode": "PAY_PER_REQUEST"
        },
        "TableStatus": "CREATING",
        "TableId": "12345678-0123-4567-a123-abcdefghijkl",
        "KeySchema": [
            {
                "KeyType": "HASH",
                "AttributeName": "Artist"
            },
            {
                "KeyType": "RANGE",
                "AttributeName": "SongTitle"
            }
        ],
        "ItemCount": 0,
        "CreationDateTime": 1542397468.348
    }
}

Beispiel 3: Erstellen Sie eine Tabelle mit der Tabellenklasse DynamoDB Standard-Infrequent Access

So erstellen Sie dieselbe Music-Tabelle mit der Tabellenklasse DynamoDB Standard-Infrequent Access.

aws dynamodb create-table \
    --table-name Music \
    --attribute-definitions \
        AttributeName=Artist,AttributeType=S \
        AttributeName=SongTitle,AttributeType=S \
    --key-schema \
        AttributeName=Artist,KeyType=HASH \
        AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput \
        ReadCapacityUnits=10,WriteCapacityUnits=5 \
    --table-class STANDARD_INFREQUENT_ACCESS

Die CreateTable-Operation gibt Metadaten für die Tabelle, wie unten gezeigt, zurück.

{
    "TableDescription": {
        "TableArn": "arn:aws:dynamodb:us-east-1:123456789012:table/Music",
        "AttributeDefinitions": [
            {
                "AttributeName": "Artist",
                "AttributeType": "S"
            },
            {
                "AttributeName": "SongTitle",
                "AttributeType": "S"
            }
        ],
        "ProvisionedThroughput": {
            "NumberOfDecreasesToday": 0,
            "WriteCapacityUnits": 5,
            "ReadCapacityUnits": 10
        },
        "TableClassSummary": {
            "LastUpdateDateTime": 1542397215.37,
            "TableClass": "STANDARD_INFREQUENT_ACCESS"
        },
        "TableSizeBytes": 0,
        "TableName": "Music",
        "TableStatus": "CREATING",
        "TableId": "12345678-0123-4567-a123-abcdefghijkl",
        "KeySchema": [
            {
                "KeyType": "HASH",
                "AttributeName": "Artist"
            },
            {
                "KeyType": "RANGE",
                "AttributeName": "SongTitle"
            }
        ],
        "ItemCount": 0,
        "CreationDateTime": 1542397215.37
    }
}

Beschreiben einer Tabelle

Um Details über eine Tabelle anzuzeigen, verwenden Sie die DescribeTable-Operation. Sie müssen den Tabellennamen angeben. Die Ausgabe von DescribeTable erfolgt in demselben Format wie bei CreateTable. Sie enthält den Zeitstempel, mit dem die Tabelle erstellt wurde, ihr Schlüsselschema, ihre bereitgestellten Durchsatzeinstellungen, ihre geschätzte Größe und alle vorhandenen sekundären Indexe.

aws dynamodb describe-table --table-name Music

Die Tabelle ist einsatzbereit, wenn der TableStatus sich von CREATING in ACTIVE ändert.

Aktualisieren einer Tabelle

Die UpdateTable-Operation ermöglicht es Ihnen einen der folgenden Schritte ausführen:

aws dynamodb update-table --table-name Music \
    --provisioned-throughput ReadCapacityUnits=20,WriteCapacityUnits=10

aws dynamodb update-table --table-name Music \
    --billing-mode PAY_PER_REQUEST

Löschen einer Tabelle

Sie können eine ungenutzte Tabelle mit der DeleteTable-Operation entfernen. Das Löschen einer Tabelle ist ein unwiederbringlicher Vorgang.

aws dynamodb delete-table --table-name Music

Wenn Sie eine DeleteTable-Anforderung ausgeben, ändert sich der Tabellenstatus von ACTIVE in DELETING. Es kann eine Weile dauern die Tabelle zu löschen, abhängig von den verwendeten Ressourcen (z. B. die in der Tabelle gespeicherten Daten und alle Streams oder Indizes der Tabelle).

Wenn die DeleteTable-Operation abschließt, ist die Tabelle in DynamoDB nicht mehr vorhanden.

Löschschutz verwenden

Mit der Löschschutz-Eigenschaft können Sie eine Tabelle vor dem versehentlichen Löschen schützen. Wenn Sie diese Eigenschaft für Tabellen aktivieren, können Sie sicherstellen, dass Tabellen nicht versehentlich während regulärer Tabellenverwaltungsvorgängen durch Ihre Administratoren gelöscht werden. Auf diese Weise können Sie Störungen des normalen Geschäftsbetriebs vermeiden.

Der Tabelleneigentümer oder ein autorisierter Administrator steuert die Löschschutz-Eigenschaft für jede Tabelle. Die Löschschutz-Eigenschaft ist bei Tabellen standardmäßig deaktiviert. Dies umfasst globale Replikate und Tabellen, die aus Backups wiederhergestellt wurden. Wenn der Löschschutz für eine Tabelle deaktiviert ist, kann die Tabelle von allen Benutzern gelöscht werden, die durch eine Identity and Access Management (IAM) -Richtlinie autorisiert wurden. Wenn der Löschschutz für eine Tabelle aktiviert ist, kann die Tabelle von niemandem gelöscht werden.

Wenn Sie diese Einstellung ändern möchten, rufen Sie Zusätzliche Einstellungen für die Tabelle auf, navigieren Sie zum Bereich Löschschutz und wählen Sie Löschschutz aktivieren aus.

Die Löschschutzeigenschaft wird von der DynamoDB-Konsole,API,CLI/SDKund unterstützt. AWS CloudFormation Die CreateTable API unterstützt die Löschschutzeigenschaft bei der Tabellenerstellung und UpdateTable API unterstützt das Ändern der Löschschutzeigenschaft für bestehende Tabellen.

Auflisten von Tabellennamen

Die ListTables Operation gibt die Namen der DynamoDB-Tabellen für das AWS Girokonto und die Region zurück.

aws dynamodb list-tables

Beschreiben der bereitgestellten Durchsatzkontingente

Der DescribeLimits Vorgang gibt die aktuellen Lese- und Schreibkapazitätskontingente für das aktuelle AWS Konto und die Region zurück.

aws dynamodb describe-limits

Weitere Informationen zu diesen Kontingenten und zum Anfordern einer Kontingenterhöhung finden Sie unter Standardkontingente für den Durchsatz.