本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立設定的資料表 – 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：//[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) 開啟 AWS Clean Rooms 主控台。

1. 在左側導覽窗格中，選擇 **Tables (資料表)**。

1. 在右上角，選擇**設定新資料表**。

1. 對於**資料來源**，在**第三方雲端和資料來源**下，選擇 **Snowflake**。

1. 使用現有的秘密 ARN 指定 **Snowflake 登入**資料，或儲存此資料表的新秘密。

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

   1. 如果您有秘密 ARN，請在**秘密 ARN** 欄位中輸入它。

      您可以選擇 **Go to AWS Secrets Manager** 來查詢秘密 ARN。

   1. 如果您有來自另一個資料表的現有秘密，請選擇**從現有資料表匯入秘密 ARN**。

**注意**  
秘密 ARN 可以是跨帳戶。

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

   1. 輸入下列 Snowflake 登入資料：
      + **Snowflake 使用者名稱**
      + **Snowflake 倉儲**
      + **Snowflake 角色**
      + **Snowflake 隱私權增強型郵件 (PEM) 私有金鑰** 

   1. 對於加密，請執行下列其中一項操作：
      + 若要使用 AWS 受管金鑰 （預設），請清除**自訂加密設定**核取方塊。
      + 若要使用自訂 AWS KMS key：
        + 選取**自訂加密設定**核取方塊。
        + 對於 **KMS 金鑰**，輸入金鑰 ARN，或從清單中選擇一個金鑰 ARN。

   1. 輸入**秘密名稱**以協助您稍後尋找登入資料。

------

1. 對於 **Snowflake 資料表和結構描述詳細資訊**，請手動輸入詳細資訊或自動匯入詳細資訊。

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

   1. 輸入 **Snowflake 帳戶識別符**。

      如需詳細資訊，請參閱 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)中的 Snowflake 資料庫。

   1. 輸入 **Snowflake 結構描述名稱**。

   1. 輸入 **Snowflake 資料表名稱**。

      如需詳細資訊，請參閱 [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 匯出您的 COLUMNS 檢視做為 CSV 檔案。

      如需 Snowflake COLUMNS 檢視的詳細資訊，請參閱 Snowflake 文件中的 [COLUMNS 檢視](https://docs.snowflake.com/en/sql-reference/info-schema/columns)。

   1. 選擇**從檔案匯入**以匯入 CSV 檔案，並指定任何其他資訊。

      系統會自動匯入資料庫名稱、結構描述名稱、資料表名稱、資料欄名稱和資料類型。
      +  如果您選擇**物件資料類型**，請指定**物件結構描述**。
      + 如果您選擇**陣列資料類型**，請指定**陣列結構描述**。
      + 如果您選擇**映射資料類型**，請指定**映射結構描述**。

   1. 輸入 **Snowflake 帳戶識別符**。

      如需詳細資訊，請參閱 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_tw/clean-rooms/latest/userguide/create-config-table-snowflake.html)

1. 對於**已設定的資料表詳細資訊**，

   1. 輸入已設定資料表**的名稱**。

      您可以使用預設名稱或重新命名此資料表。

   1. 輸入資料表的**描述**。

      描述有助於區分具有類似名稱的其他已設定資料表。

   1. 如果您想要為設定的資料表資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。

1. 選擇**設定新資料表**。

現在您已建立已設定的資料表，即可：
+ [將分析規則新增至設定的資料表](add-analysis-rule.md)
+ [將設定的資料表與協同合作建立關聯](associate-configured-table.md)