Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Richiesta di importazione di una tabella in DynamoDB

L'importazione DynamoDB consente di importare i dati da un bucket Amazon S3 a una nuova tabella DynamoDB. È possibile richiedere l'importazione di una tabella utilizzando la console DynamoDB, CLICloudFormationo DynamoDB. API

Se si desidera utilizzare il AWS CLI, è necessario prima configurarlo. Per ulteriori informazioni, consulta Accesso a DynamoDB.

Configurazione delle autorizzazioni IAM

È possibile importare dati da qualsiasi bucket Amazon S3 per il quale si dispone dell'autorizzazione di lettura. Non è necessario che il bucket di origine si trovi nella stessa regione o abbia lo stesso proprietario della tabella di origine. Il tuo AWS Identity and Access Management (IAM) deve includere le azioni pertinenti sul bucket Amazon S3 di origine e le CloudWatch autorizzazioni necessarie per fornire informazioni di debug. Di seguito è riportata una policy di esempio.

{
  "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": "*"
    }
  ]
}

Autorizzazioni di Amazon S3

Quando si avvia un'importazione in bucket Amazon S3 di origine di proprietà di un altro account, assicurati che il ruolo o l'utente abbia accesso agli oggetti Amazon S3. A tale scopo, esegui il comando Amazon S3 GetObject e usa le credenziali. Quando si utilizzaAPI, il parametro del proprietario del bucket Amazon S3 utilizza per impostazione predefinita l'ID dell'account dell'utente corrente. Per le importazioni tra account, assicurati che questo parametro sia correttamente popolato con l'ID dell'account del proprietario del bucket. Il codice seguente è un esempio di policy del bucket S3 nell'account di destinazione.

{
    "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

Quando si crea la nuova tabella per l'importazione, se si seleziona una chiave di crittografia a riposo che non è di proprietà di DynamoDB, è necessario fornire AWS KMS le autorizzazioni necessarie per utilizzare una tabella DynamoDB crittografata con chiavi gestite dal cliente. Per ulteriori informazioni, consulta Autorizzazione dell'uso della chiave. AWS KMS Se gli oggetti Amazon S3 sono crittografati con crittografia lato server KMS (SSE-KMS), assicurati che il ruolo o l'utente che avvia l'importazione abbia accesso alla decrittografia utilizzando la chiave. AWS KMS Questa funzionalità non supporta oggetti Amazon S3 crittografati con chiavi di crittografia (SSE-C) fornite dal cliente.

CloudWatch autorizzazioni

Il ruolo o l'utente che sta avviando l'importazione necessita delle autorizzazioni di creazione e gestione per il gruppo di log e i flussi di log associati all'importazione.

Richiesta di un'importazione utilizzando la AWS Management Console

L'esempio seguente mostra come utilizzare la console DynamoDB per importare i dati esistenti in una nuova tabella denominata MusicCollection.

Ottenere dettagli sulle importazioni passate in AWS Management Console

Per informazioni sulle attività di importazione eseguite in passato, fai clic su Import from S3 (Importazione da S3) nella barra laterale di navigazione, quindi seleziona la scheda Imports (Importazioni). Il pannello delle importazioni contiene l'elenco di tutte le importazioni create negli ultimi 90 giorni. Selezionando ARN un'attività elencata nella scheda Importazioni verranno recuperate le informazioni sull'importazione, incluse le impostazioni di configurazione avanzate scelte.

Richiedere un'importazione utilizzando il AWS CLI

L'esempio seguente importa dati CSV formattati da un bucket S3 chiamato bucket con un prefisso o prefisso in una nuova tabella denominata target-table.

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": ";"}}'

Ottenere dettagli sulle importazioni passate in AWS CLI

Le informazioni sulle attività di importazione eseguite in passato possono essere recuperate utilizzando il comando list-imports. Questo comando restituisce un elenco di tutte le importazioni create negli ultimi 90 giorni. Si noti che, sebbene le attività di importazione scadano dopo 90 giorni e i processi più vecchi non siano più presenti in questo elenco, DynamoDB non elimina nessuno degli oggetti nel bucket Amazon S3 o nella tabella creata durante l'importazione.

aws dynamodb list-imports

Per recuperare informazioni dettagliate su un'attività di importazione specifica, incluse le impostazioni di configurazione avanzate, utilizza il comando describe-import.

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