本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建已配置的表 — Snowflake 数据源
<a name="create-config-table-snowflake"></a>

在此步骤中，[成员](glossary.md#glossary-member)将执行以下任务：
+ 配置现有的 Snowflake 表以在中使用。 AWS Clean Rooms（除非使用 Clean Rooms 加密计算，否则此步骤可以在加入协作之前或之后完成。）
+ 为[配置表](glossary.md#glossary-configured-table)命名，并选择要在协作中使用的列。

以下步骤假设：
+ 协作成员已经将其数据表上传到 Snowflake。
+ （可选）仅对于[加密](glossary.md#glossary-encryption)数据表，协作成员已经使用 C3R 加密客户端[准备了加密数据表](prepare-encrypted-data.md)。

**创建已配置的表-Snowflake 数据源**

1. 登录 AWS 管理控制台 并在 [https://console.aws.amazon.com/clean](https://console.aws.amazon.com/cleanrooms/home) room AWS Clean Rooms s 上打开控制台。

1. 在左侧导航窗格中，选择 **表**。

1. 在右上角，选择**配置新表**。

1. 对于**数据源**，在**第三方云和数据源**下，选择 **Snowflake**。

1. 使用现有密钥 ARN 或存储此表的新密钥指定 Sn **owflake 凭证**。

------
#### [ Use existing secret ARN ]

   1. 如果您有秘密 ARN，请将其输入到秘密 **ARN** 字段。

      您可以通过选择 “前**往**” 来查找您的秘密 ARN。 AWS Secrets Manager

   1. 如果您已有来自其他表的密钥，请选择从现有表**中导入密钥 ARN**。

**注意**  
秘密 ARN 可以是跨账户的。

------
#### [ Store a new secret for this table ]

   1. 输入以下 Snowflake 凭据：
      + **雪花用户名**
      + **雪花仓库**
      + **雪花角色**
      + **Snowflake 隐私增强邮件 (PEM) 私钥** 

   1. 要进行加密，请执行以下任一操作：
      + 要使用 AWS 托管式密钥 （默认），请清除 “**自定义加密设置”** 复选框。
      + 要使用自定义，请执行 AWS KMS key以下操作：
        + 选中 “**自定义加密设置”** 复选框。
        + 对于 **KMS 密钥**，请输入密钥 ARN 或从列表中选择一个密钥。

   1. 输入 S **ecret 名称**以帮助你以后找到你的凭证。

------

1. 有关 **Snowflake 表和架构的详细信息**，请手动输入详细信息或自动导入详细信息。

------
#### [ Enter the details manually ]

   1. 输入 Sn **owflake 账户标识符**。

      有关更多信息，请参阅 Snowflake 文档中的[账户标识符](https://docs.snowflake.com/en/user-guide/admin-account-identifier#finding-the-organization-and-account-name-for-an-account)。

      您的账户标识符必须采用 Snowflake 驱动程序使用的格式。你需要用连字符 (-) 替换句点 (.)，这样标识符的格式就是。**<orgname>-<account\_name>**

   1. 进入**雪花数据库**。

      有关更多信息，请参阅 [Snowflake 文档中的 Snowflake 数据库](https://docs.snowflake.com/en/sql-reference/snowflake-db)。

   1. 输入 **Snowflake 架构名称**。

   1. 输入 Sn **owflake 表**的名称。

      有关更多信息，请参阅 [Snowflake 文档中的了解 Snowflake 表结构](https://docs.snowflake.com/en/user-guide/tables-micro-partitions)。

   1. 对于**架构**，输入**列名**并从下拉列表中选择**数据类型**。

   1. 选择 “**添加列”** 以添加更多列。
      +  如果选择**对象数据类型**，请指定**对象架构**。  
**Example 对象架构示例**  

        ```
        name STRING,
        location OBJECT(
            x INT, 
            y INT, 
            metadata OBJECT(uuid STRING)
        ),
        history ARRAY(TEXT)
        ```
      + 如果选择**数组数据类型**，请指定**数组架构**。  
**Example 数组架构示例**  

        ```
        OBJECT(x INT, y INT)
        ```
      + 如果选择**地图数据类型**，请指定**地图架构**。  
**Example 地图架构示例**  

        ```
        STRING, OBJECT(x INT, y INT)
        ```

------
#### [ Automatically import the details ]

   1. 将你的 “列” 视图从 Snowflake 导出为 CSV 文件。

      有关 Snowflake COLUMNS 视图的更多信息，请参阅 Snowflake [文档中的列视图](https://docs.snowflake.com/en/sql-reference/info-schema/columns)。

   1. 选择 “**从文件导**入” 以导入 CSV 文件并指定任何其他信息。

      将自动导入数据库名称、架构名称、表名、列名和数据类型。
      +  如果选择**对象数据类型**，请指定**对象架构**。
      + 如果选择**数组数据类型**，请指定**数组架构**。
      + 如果选择**地图数据类型**，请指定**地图架构**。

   1. 输入 Sn **owflake 账户标识符**。

      有关更多信息，请参阅 Snowflake 文档中的[账户标识符](https://docs.snowflake.com/en/user-guide/admin-account-identifier#finding-the-organization-and-account-name-for-an-account)。

**注意**  
 只有编入目录的 S3 表 AWS Glue 才能用于自动检索表架构。

------

1. 对于**协作中允许的列**，请根据您的目标选择一个选项。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/clean-rooms/latest/userguide/create-config-table-snowflake.html)

1. 对于**已配置表的详细信息**，

   1. 为已配置的表输入**名称**。

      您可以使用默认名称或重命名此表。

   1. 输入表的**描述**。

      该描述有助于区分其他具有相似名称的已配置表。

   1. 如果要为已配置的表资源启用**标签**，请选择**添加新标签**，然后输入**键**和**值**对。

1. 选择**配置新表**。

现在您已经创建了一个配置表，您已准备好：
+ [为配置表添加分析规则](add-analysis-rule.md)
+ [将配置表与协作关联](associate-configured-table.md)