在 DynamoDB 中请求表导入

通过 DynamoDB 导入，您可以将数据从 Amazon S3 存储桶导入新 DynamoDB 表。您可以使用 DynamoDB 控制台、CLI、CloudFormation 或 DynamoDB API 请求表导入。

如果要使用 AWS CLI，必须先对其进行配置。有关更多信息，请参阅 访问 DynamoDB。

设置 IAM 权限

可以从您具有读取权限的任何 Amazon S3 存储桶导入数据。源存储桶无需与源表位于同一区域或具有同一所有者。您的 AWS Identity and Access Management (IAM) 必须包含对源 Amazon S3 存储桶的相关操作，以及提供调试信息所需的 CloudWatch 权限。下面显示了一个示例策略。

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

在另一个账户拥有的 Amazon S3 存储桶源上开始导入时，请确保该角色或用户有权访问 Amazon S3 对象。您可以通过执行 Amazon S3 GetObject 命令并使用凭据进行检查。使用 API 时，Amazon S3 存储桶拥有者参数默认为当前用户的账户 ID。对于跨账户导入，请确保使用存储桶拥有者的账户 ID 正确填充此参数。下面的代码是源账户中的示例 Amazon S3 存储桶策略。

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

AWS Key Management Service

创建用于导入的新表时，如果您选择的静态加密密钥不是由 DynamoDB 拥有，则必须提供相应的 AWS KMS 权限，这些权限是操作使用客户自主管理型密钥加密的 DynamoDB 表所需要的。有关更多信息，请参阅授权使用 AWS KMS 密钥。如果 Amazon S3 对象使用服务器端加密 KMS（SSE-KMS）进行加密，请确保启动导入的角色或用户有权使用 AWS KMS 密钥进行解密。此功能不支持使用客户提供的加密密钥（SSE-C）加密的 Amazon S3 对象。

CloudWatch 权限

启动导入的角色或用户针对与导入关联的日志组和日志流，将需要具有创建和管理权限。

请求使用 AWS Management Console 导入

以下示例演示如何使用 DynamoDB 控制台将现有数据导入名为 MusicCollection 的新表中。

在 AWS Management Console 中获取以前导入的详细信息

单击导航侧边栏的 Import from S3（从 S3 导入），然后选择 Imports（导入）选项卡，查找过去运行的导出任务的信息。导入面板包含过去 90 天创建的所有导入的列表。选择“Imports”（导入）选项卡中列出任务的 ARN 将检索该导入的信息，包括您选择的任何高级配置设置。

请求使用 AWS CLI 导入

以下示例将 CSV 格式的数据从名为 bucket 且前缀为 prefix 的 S3 存储桶导入到名为 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": ";"}}'

在 AWS CLI 中获取以前导入的详细信息

您可以使用 list-imports 命令，查找以前运行的导入任务信息。此命令返回过去 90 天创建的所有导入的列表。请注意，尽管导入任务元数据会在 90 天后过期，列表中不再显示早于该日期的作业，但 DynamoDB 不会删除 Amazon S3 存储桶中的任何对象或导入期间创建的表。

aws dynamodb list-imports

要检索有关特定导入任务的详细信息（包括任何高级配置设置），请使用 describe-import 命令。

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