Anfordern eines Tabellenexports in DynamoDB

Der DynamoDB-Import ermöglicht Ihnen, Daten aus einem Amazon-S3-Bucket in eine neue DynamoDB-Tabelle zu importieren. Sie können einen Tabellenimport anfordern, indem Sie die DynamoDB-Konsole, die CLI, CloudFormation oder die DynamoDB-API verwenden.

Wenn Sie die AWS CLI verwenden möchten, müssen Sie sie zunächst konfigurieren. Weitere Informationen finden Sie unter Zugreifen auf DynamoDB.

Einrichten von IAM-Berechtigungen

Sie können Daten aus jedem Amazon S3-Bucket importieren, für den Sie über Leseberechtigung verfügen. Der Quell-Bucket muss sich nicht in derselben Region befinden oder denselben Besitzer wie die Quelltabelle haben. Ihre AWS Identity and Access Management (IAM) muss die relevanten Aktionen im Quell-Bucket aus Amazon S3 und die erforderlichen CloudWatch-Berechtigungen für die Bereitstellung von Debugging-Informationen enthalten. Nachfolgend eine Beispielrichtlinie.

JSON

{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "AllowDynamoDBImportAction",
      "Effect": "Allow",
      "Action": [
        "dynamodb:ImportTable",
        "dynamodb:DescribeImport"
      ],
      "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/my-table*"
    },
    {
      "Sid": "AllowS3Access",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket/*",
        "arn:aws:s3:::your-bucket"
      ]
    },
    {
      "Sid": "AllowCloudwatchAccess",
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams",
        "logs:PutLogEvents",
        "logs:PutRetentionPolicy"
      ],
      "Resource": "arn:aws:logs:us-east-1:111122223333:log-group/aws-dynamodb/*"
    },
    {
      "Sid": "AllowDynamoDBListImports",
      "Effect": "Allow",
      "Action": "dynamodb:ListImports",
      "Resource": "*"
    }
  ]
}

Amazon-S3-Berechtigungen

Wenn Sie einen Import auf einer Bucket-Quelle aus Amazon S3 starten, die einem anderen Konto gehört, stellen Sie sicher, dass die Rolle oder der Benutzer Zugriff auf die Amazon-S3-Objekte hat. Sie können dies überprüfen, indem Sie einen Amazon-S3–Befehl GetObject ausführen und die Anmeldeinformationen verwenden. Bei Verwendung der API wird für den Bucket-Besitzer-Parameter von Amazon S3 standardmäßig die Konto-ID des aktuellen Benutzers verwendet. Stellen Sie bei kontoübergreifenden Importen sicher, dass dieser Parameter korrekt mit der Konto-ID des Bucket-Besitzers ausgefüllt ist. Der folgende Code ist ein Beispiel für eine S3-Bucket-Richtlinie im Quellkonto.

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {"Sid": "ExampleStatement",
            "Effect": "Allow",
            "Principal": {"AWS": "arn:aws:iam::123456789012:user/Dave"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
        }
    ]
}

AWS Key Management Service

Wenn Sie beim Erstellen der neuen Tabelle für den Import einen Schlüssel zur Verschlüsselung im Ruhezustand auswählen, der nicht im Besitz von DynamoDB ist, müssen Sie die AWS KMS-Berechtigungen, angeben, die für den Betrieb einer DynamoDB-Tabelle erforderlich sind, die mit kundenverwalteten Schlüsseln verschlüsselt ist. Weitere Informationen finden Sie unter Autorisieren der Nutzung Ihres AWS KMS-Schlüssels. Wenn die Amazon-S3-Objekte mit serverseitigen Verschlüsselungs-KMS (SSE-KMS) verschlüsselt sind, stellen Sie sicher, dass die Rolle oder der Benutzer, die/der den Import initiiert, Zugriff zum Entschlüsseln mithilfe des AWS KMS-Schlüssels hat. Diese Funktion unterstützt keine Amazon-S3-Objekte, die mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (SSE-C) verschlüsselt sind.

CloudWatch-Berechtigungen

Die Rolle oder der Benutzer, die/der den Import initiiert, benötigt Erstellungs- und Verwaltungsberechtigungen für die Protokollgruppe und die Protokollstreams, die mit dem Import verknüpft sind.

Anfordern eines Imports mit der AWS Management Console

Das folgende Beispiel zeigt, wie Sie mit der DynamoDB-Konsole vorhandene Daten in eine neue Tabelle mit der Bezeichnung MusicCollection importieren.

Abrufen von Details zu früheren Importen in der AWS Management Console

Informationen zu Importaufgaben, die Sie in der Vergangenheit ausgeführt haben, finden Sie, indem Sie auf Import from S3 (Import aus S3) in der Navigationsseitenleiste klicken und dann die Registerkarte Exports (Exporte) wählen. Das Importfenster enthält eine Liste aller Importe, die Sie in den letzten 90 Tagen erstellt haben. Wenn Sie den ARN einer Aufgabe auswählen, die auf der Registerkarte „Exports (Exporte)“ aufgeführt ist, werden Informationen über diesen Export abgerufen, einschließlich aller von Ihnen gewählten erweiterten Konfigurationseinstellungen.

Anfordern eines Imports mit der AWS CLI

Im folgenden Beispiel werden CSV-formatierte Daten aus einem S3-Bucket mit der Bezeichnung „Bucket“ mit einem Präfix in eine neue Tabelle mit der Bezeichnung „target-Table“ importiert.

aws dynamodb import-table --s3-bucket-source S3Bucket=bucket,S3KeyPrefix=prefix \ 
            --input-format CSV --table-creation-parameters '{"TableName":"target-table","KeySchema":  \
            [{"AttributeName":"hk","KeyType":"HASH"}],"AttributeDefinitions":[{"AttributeName":"hk","AttributeType":"S"}],"BillingMode":"PAY_PER_REQUEST"}' \ 
            --input-format-options '{"Csv": {"HeaderList": ["hk", "title", "artist", "year_of_release"], "Delimiter": ";"}}'

Abrufen von Details zu früheren Importen in der AWS CLI

Informationen zu Importaufgaben, die Sie in der Vergangenheit ausgeführt haben, finden Sie mithilfe des list-imports-Befehls. Dieser Befehl gibt eine Liste aller Importe zurück, die Sie in den letzten 90 Tagen erstellt haben. Beachten Sie, dass die Metadaten für die Importaufgabe nach 90 Tagen ablaufen und Aufträge, die älter sind als diese, in dieser Liste nicht mehr gefunden werden können; DynamoDB löscht keine Objekte in Ihrem Amazon S3-Bucket oder in der Tabelle, die beim Importieren erstellt wurden.

aws dynamodb list-imports

Um detaillierte Informationen zu einer bestimmten Importaufgabe, einschließlich erweiterter Konfigurationseinstellungen, abzurufen, verwenden Sie den describe-import-Befehl.

aws dynamodb describe-import \
    --import-arn arn:aws:dynamodb:us-east-1:123456789012:table/ProductCatalog/exp