创建元数据表配置

创建元数据表配置

在创建元数据表配置之前，请确保您已查看并满足先决条件，并且已经查看了元数据表限制和局限性。

1. 登录到 Amazon Web Services Management Console，然后通过以下网址打开 Amazon S3 控制台：https://console.aws.amazon.com/s3/。

2. 在左侧导航窗格中，选择通用存储桶。

3. 选择要为其创建元数据表配置的通用存储桶。

   注意

   请确保此通用存储桶位于表存储桶可用的 Amazon Web Services 区域。表存储桶仅在美国东部（弗吉尼亚州北部）、美国东部（俄亥俄州）和美国西部（俄勒冈州）区域中提供。

4. 在存储桶详细信息页面上，选择元数据选项卡。

5. 在元数据选项卡上，选择创建元数据配置。

6. 在创建元数据配置页面的目标表存储桶下，指定用于存储元数据表的表存储桶。表存储桶必须与通用存储桶位于相同的 Amazon Web Services 账户和 Amazon Web Services 区域中。

   如果您还没有表存储桶，选择创建表存储桶。表存储桶名称必须为 3 到 63 个字符，并且在您选择的 Amazon Web Services 区域的 Amazon Web Services 账户中是唯一的。有效字符：a-z、0-9 和连字符（-）。有关创建表存储桶的更多信息，请参阅创建表存储桶。

   在创建表存储桶时，请确保将其与 Amazon Glue Data Catalog 集成。有关更多信息，请参阅 使用 Amazon 分析服务查询元数据表。

7. 对于元数据表名称，指定您希望表具有的名称。元数据表名称必须介于 1 到 255 个字符之间，并且在表存储桶的 aws_s3_metadata 命名空间中是唯一的。有效的字符为小写字母、数字和下划线 (_)。

8. 选择创建元数据表配置。

使用 Amazon CLI 创建元数据表配置

在创建元数据表配置之前，请确保您已查看并满足先决条件，并且已经查看了元数据表限制和局限性。

要使用以下示例命令，请将 user input placeholders 替换为您自己的信息。

1. 如果您还没有表存储桶，请使用以下命令创建一个用于存储元数据表的表存储桶。确保表存储桶与您要为其创建元数据表配置的通用存储桶位于同一 Amazon Web Services 区域中。

   aws s3tables create-table-bucket --name amzn-s3-demo-bucket --region us-east-2

2. 要验证表存储桶是否已创建，请使用以下命令：

   aws s3tables list-table-buckets --region us-east-2

3. 创建包含元数据表配置的 JSON 文件并将其保存（例如 metadata-config.json）。以下是一个示例配置：

   表存储桶名称必须为 3 到 63 个字符，并且在您选择的 Amazon Web Services 区域的 Amazon Web Services 账户中是唯一的。有效字符：a-z、0-9 和连字符（-）。有关创建表存储桶的更多信息，请参阅创建表存储桶。

   元数据表名称必须介于 1 到 255 个字符之间，并且在表存储桶的 aws_s3_metadata 命名空间中是唯一的。有效的字符为小写字母、数字和下划线 (_)。

   {
     "S3TablesDestination": {
       "TableBucketArn": "arn:aws:s3tables:us-east-2:111122223333:bucket/amzn-s3-demo-bucket",
       "TableName": "test_metadata_table"
     }
   }

4. 使用以下命令将元数据表配置应用于通用存储桶（例如 amzn-s3-demo-source-bucket）：

   aws s3api create-bucket-metadata-table-configuration \
   --bucket amzn-s3-demo-source-bucket \
   --metadata-table-configuration  file://./metadata-config.json \
   --region us-east-2

5. 要验证配置是否已创建，请使用以下命令：

   aws s3api get-bucket-metadata-table-configuration \
   --bucket amzn-s3-demo-source-bucket \
   --region us-east-2