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.

Verwendung der AWS CLI um eine Verbindung zu Amazon Keyspaces herzustellen

Sie können das AWS Command Line Interface (AWS CLI) um mehrere zu steuern AWS Dienste von der Befehlszeile aus und automatisieren sie mithilfe von Skripten. Mit Amazon Keyspaces können Sie die AWS CLI für Operationen in der Datendefinitionssprache (DDL), wie z. B. das Erstellen einer Tabelle. Darüber hinaus können Sie Dienste und Tools für Infrastructure-as-Code (IaC) verwenden, z. B. AWS CloudFormation und Terraform.

Bevor du das benutzen kannst AWS CLI Bei Amazon Keyspaces benötigen Sie eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel. Weitere Informationen finden Sie unter Erstellen und Konfigurieren AWS Anmeldeinformationen für Amazon Keyspaces.

Eine vollständige Liste aller für Amazon Keyspaces verfügbaren Befehle finden Sie in der AWS CLI, siehe AWS CLI Befehlsreferenz .

Herunterladen und Konfigurieren des AWS CLI

Das Tool AWS CLI ist verfügbar unterhttps://aws.amazon.com/cli. Sie kann auf Windows, macOS oder Linux ausgeführt werden. Nach dem Herunterladen der AWS CLI, folgen Sie diesen Schritten, um es zu installieren und zu konfigurieren:

Verwendung der AWS CLI mit Amazon Keyspaces

Das Befehlszeilenformat besteht aus einem Amazon Keyspaces-Operationsnamen, gefolgt von den Parametern für diesen Vorgang. Das Tool AWS CLI unterstützt auch eine Kurzsyntax für die Parameterwerte. JSON Die folgenden Amazon Keyspaces-Beispiele verwenden AWS CLI Abkürzungssyntax. Weitere Informationen finden Sie unter Verwenden der Kurzsyntax mit dem AWS CLI.

Der folgende Befehl erstellt einen Schlüsselraum mit dem Namen catalog.

aws keyspaces create-keyspace --keyspace-name 'catalog'

Der Befehl gibt die Ressource Amazon Resource Name (ARN) in der Ausgabe zurück.

{
    "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/"
}

Um zu bestätigen, dass der Keyspace-Katalog existiert, können Sie den folgenden Befehl verwenden.

aws keyspaces get-keyspace --keyspace-name 'catalog'

Die Ausgabe des Befehls gibt die folgenden Werte zurück.

{
    "keyspaceName": "catalog",
    "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/"
}

Der folgende Befehl erstellt eine Tabelle mit dem Namen book_awards. Der Partitionsschlüssel der Tabelle besteht aus den Spalten year award und der Gruppierungsschlüssel besteht aus den Spaltenrank, category und beide Clusterspalten verwenden die aufsteigende Sortierreihenfolge. (Für eine bessere Lesbarkeit werden lange Befehle in diesem Abschnitt über mehrere Zeilen verteilt.)

aws keyspaces create-table --keyspace-name 'catalog' --table-name 'book_awards' 
            --schema-definition 'allColumns=[{name=year,type=int},{name=award,type=text},{name=rank,type=int},
            {name=category,type=text}, {name=author,type=text},{name=book_title,type=text},{name=publisher,type=text}],
            partitionKeys=[{name=year},{name=award}],clusteringKeys=[{name=category,orderBy=ASC},{name=rank,orderBy=ASC}]'

Dieser Befehl führt zu der folgenden Ausgabe.

{
    "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/table/book_awards"
}

Um die Metadaten und Eigenschaften der Tabelle zu bestätigen, können Sie den folgenden Befehl verwenden.

aws keyspaces get-table --keyspace-name 'catalog' --table-name 'book_awards'

Dieser Befehl gibt die folgende Ausgabe zurück.

{
    "keyspaceName": "catalog",
    "tableName": "book_awards",
    "resourceArn": "arn:aws:cassandra:us-east-1:111222333444:/keyspace/catalog/table/book_awards",
    "creationTimestamp": 1645564368.628,
    "status": "ACTIVE",
    "schemaDefinition": {
        "allColumns": [
            {
                "name": "year",
                "type": "int"
            },
            {
                "name": "award",
                "type": "text"
            },
            {
                "name": "category",
                "type": "text"
            },
            {
                "name": "rank",
                "type": "int"
            },
            {
                "name": "author",
                "type": "text"
            },
            {
                "name": "book_title",
                "type": "text"
            },
            {
                "name": "publisher",
                "type": "text"
            }
        ],
        "partitionKeys": [
            {
                "name": "year"
            },
            {
                "name": "award"
            }
        ],
        "clusteringKeys": [
            {
                "name": "category",
                "orderBy": "ASC"
            },
            {
                "name": "rank",
                "orderBy": "ASC"
            }
        ],
        "staticColumns": []
    },
    "capacitySpecification": {
        "throughputMode": "PAY_PER_REQUEST",
        "lastUpdateToPayPerRequestTimestamp": 1645564368.628
    },
    "encryptionSpecification": {
        "type": "AWS_OWNED_KMS_KEY"
    },
    "pointInTimeRecovery": {
        "status": "DISABLED"
    },
    "ttl": {
        "status": "ENABLED"
    },
    "defaultTimeToLive": 0,
    "comment": {
        "message": ""
    }
}

Beim Erstellen von Tabellen mit komplexen Schemas kann es hilfreich sein, die Schemadefinition der Tabelle aus einer JSON Datei zu laden. Das Folgende ist ein Beispiel dafür. Laden Sie die JSON Beispieldatei für die Schemadefinition von schema_definition.zip herunter und entpacken Sie sieschema_definition.json, wobei Sie sich den Pfad zur Datei notieren. In diesem Beispiel befindet sich die JSON Schemadefinitionsdatei im aktuellen Verzeichnis. Informationen zu verschiedenen Dateipfadoptionen finden Sie unter So laden Sie Parameter aus einer Datei.

aws keyspaces create-table --keyspace-name 'catalog' 
            --table-name 'book_awards' --schema-definition 'file://schema_definition.json'

Die folgenden Beispiele zeigen, wie Sie eine einfache Tabelle mit dem Namen myTablemit zusätzlichen Optionen erstellen. Beachten Sie, dass die Befehle zur besseren Lesbarkeit in separate Zeilen aufgeteilt sind. Dieser Befehl zeigt, wie eine Tabelle erstellt wird und:

aws keyspaces create-table --keyspace-name 'catalog' --table-name 'myTable' 
            --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' 
            --capacity-specification 'throughputMode=PROVISIONED,readCapacityUnits=5,writeCapacityUnits=5' 
            --point-in-time-recovery 'status=ENABLED' 
            --default-time-to-live '31536000' 
            --tags 'key=env,value=test' 'key=dpt,value=sec'

Dieses Beispiel zeigt, wie Sie eine neue Tabelle erstellen, die einen vom Kunden verwalteten Schlüssel für die Verschlüsselung verwendet und TTL aktiviert ist, damit Sie Ablaufdaten für Spalten und Zeilen festlegen können. Um dieses Beispiel ausführen zu können, müssen Sie die Ressource ARN für die vom Kunden verwaltete Ressource ersetzen AWS KMS geben Sie Ihren eigenen Schlüssel ein und stellen Sie sicher, dass Amazon Keyspaces Zugriff darauf hat.

aws keyspaces create-table --keyspace-name 'catalog' --table-name 'myTable' 
            --schema-definition 'allColumns=[{name=id,type=int},{name=name,type=text},{name=date,type=timestamp}],partitionKeys=[{name=id}]' 
            --encryption-specification 'type=CUSTOMER_MANAGED_KMS_KEY,kmsKeyIdentifier=arn:aws:kms:us-east-1:111222333444:key/11111111-2222-3333-4444-555555555555'  
            --ttl 'status=ENABLED'