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

# 建立成員資格並加入協同合作
<a name="create-membership"></a>

*成員*資格是在成員加入協同合作時建立的資源 AWS Clean Rooms。

您可以將協同合作加入為 
+ [可查詢的成員](glossary.md#glossary-member-who-can-query)
+ [可執行查詢和任務的成員](glossary.md#glossary-member-who-can-run-queries-jobs)
+ [可接收查詢或任務結果的成員](glossary.md#glossary-member-who-can-receive-results) 
+ [成員支付查詢運算成本](glossary.md#glossary-member-paying-for-query-compute)
+ [支付查詢和任務費用的成員](glossary.md#glossary-member-paying-for-query-job-compute)

所有成員都可以貢獻資料。

如需有關如何使用 SDKs 建立成員資格和加入協同合作 AWS 的資訊，請參閱 *[AWS Clean Rooms API 參考](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html)*。

在此程序中，受邀成員[會透過建立成員資格資源來加入協同合作](#create-membership)。

如果受邀成員是可以接收結果的成員，他們會指定結果目的地和格式。他們也提供服務角色 ARN 來寫入結果目的地。

如果受邀成員是負責支付運算成本的成員，他們在加入協同合作之前會接受其付款責任。

**建立成員資格並加入協同合作**

1. 登入 AWS 管理主控台 ，並使用您的成員 開啟[AWS Clean Rooms 主控台](https://console.aws.amazon.com/cleanrooms/home) AWS 帳戶。

1. 在左側導覽窗格中，選擇**協同合作**。

1. 在**可加入**索引標籤上，針對**可加入的協同合作**，選擇協同合作**的名稱**。

1. 在協同合作詳細資訊頁面的**概觀**區段中，檢視協同合作詳細資訊，包括**您的成員詳細資訊**和其他成員的清單。

   確認每個協同合作成員的 AWS 帳戶 IDs 是您打算加入協同合作的 ID。

1. 選擇**建立成員資格**。

1. 在**建立成員**資格頁面上的**概觀**中，檢視**協作名稱**、**協作描述**、**協作建立者的** AWS 帳戶 ID、**您的成員詳細資訊**，以及將**支付查詢**費用的成員 AWS 帳戶 ID。

1. 如果協同合作建立者已選擇啟用**分析記錄**，請在 **Amazon CloudWatch Logs 中為日誌儲存**選擇下列其中一個選項：    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/userguide/create-membership.html)
**注意**  
開啟**分析記錄**後，可能需要幾分鐘的時間才能設定日誌儲存，並開始在 Amazon CloudWatch Logs 中接收日誌。在此短暫期間內，可以查詢的成員可能會執行未實際傳送日誌的查詢。

1. 如果協同合作建立者已啟用此協同合作**的詳細監控**，請選擇是否要在 CloudWatch 帳戶中接收詳細的可觀測性指標。

   如需**詳細監控**：  
**詳細監控選項**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/userguide/create-membership.html)
**注意**  
詳細的監控指標僅適用於可執行查詢 （分析執行器） 的成員，以及設定為協同合作付款人的成員。

1. **如果您的成員能力**包含**接收結果**，則**結果設定預設為**：

   1. 針對**查詢結果**，選擇**設定查詢的預設設定**核取方塊，然後在 **Amazon S3 中輸入** S3 目的地，或在可用的 S3 儲存貯體清單中選擇**瀏覽 S3**3 以選取結果目的地。 S3   
**Example**  

      例如：**s3://bucket/prefix**

      1. 針對**結果格式**，選擇 **CSV** 或 **PARQUET**。

      1. （僅限 Spark) 對於**結果檔案**，選擇**多個**或**單一**。

      1. （選用） 對於**服務存取**，如果您想要將最多需要 24 小時的查詢交付到 S3 目的地，請選取**新增服務角色以支援最多需要 24 小時才能完成的查詢**核取方塊。

         最多需要 24 小時才能完成的大型查詢將會傳送到您的 S3 目的地。

         如果您未選取核取方塊，則只會將 12 小時內完成的查詢傳送到您的 S3 位置。
**注意**  
您必須選取現有的服務角色，或具有建立新角色的許可。如需詳細資訊，請參閱[建立服務角色以接收結果](setting-up-roles.md#create-role-write-results)。

      1. 選取**建立和使用新的服務角色**或使用**現有的服務角色，**以指定服務**存取**許可。

------
#### [ Create and use a new service role ]
         + AWS Clean Rooms 會建立具有此資料表所需政策的服務角色。
         + 預設**的服務角色名稱**為 `cleanrooms-result-receiver-<timestamp>`
         + 您必須具有建立角色和連接政策的許可。

------
#### [ Use an existing service role ]

         1. 從下拉式清單中選擇**現有的服務角色名稱**。

            如果您具有列出角色的許可，則會顯示角色清單。

            如果您沒有列出角色的許可，您可以輸入要使用的角色的 Amazon Resource Name (ARN)。

         1. 選擇在 **IAM 外部連結中檢視**，以檢視服務角色。

            如果沒有現有的服務角色，則無法使用**使用現有服務角色**的選項。

            根據預設， AWS Clean Rooms 不會嘗試更新現有的角色政策來新增必要的許可。

------
**注意**  
AWS Clean Rooms 需要根據分析規則查詢的許可。如需 許可的詳細資訊 AWS Clean Rooms，請參閱 [AWS 的 受管政策 AWS Clean Rooms](security-iam-awsmanpol.md)。
如果角色沒有足夠的許可 AWS Clean Rooms，您會收到錯誤訊息，指出角色沒有足夠的許可 AWS Clean Rooms。必須先新增角色政策，才能繼續。
如果您無法修改角色政策，您會收到錯誤訊息，指出 AWS Clean Rooms 找不到服務角色的政策。

   1. 針對**任務結果**，選擇**設定任務的預設設定**核取方塊，然後在 **Amazon S3 中輸入** S3 目的地，或在可用的 S3 儲存貯體清單中選擇**瀏覽 S3**3 以選取結果目的地。 S3   
**Example**  

      例如：**s3://bucket/prefix**

      1. 從下拉式清單中選擇**現有的服務角色名稱**，以指定服務**存取**許可。

1. 如果您想要為成員資格資源啟用**標籤**，請選擇**新增標籤**，然後輸入**金鑰**和**值**對。

1. 如果協同合作建立者已將您指定為將**支付查詢**費用或**支付查詢和任務費用**的成員，請選取**我同意為此協同合作核取方塊中的運算成本**來表示接受。
**注意**  
您必須選取此核取方塊才能繼續。  
如需如何計算定價的詳細資訊，請參閱 [的定價 AWS Clean Rooms](what-is.md#pricing)。

   如果您是[支付查詢運算成本的成員](glossary.md#glossary-member-paying-for-query-compute)，或[支付查詢和任務運算成本的成員](glossary.md#glossary-member-paying-for-query-job-compute)，但不是[可以查詢的成員](glossary.md#glossary-member-who-can-query)，建議您使用 AWS Budgets 來設定預算， AWS Clean Rooms 並在達到預算上限時接收通知。如需設定預算的詳細資訊，請參閱*AWS Cost Management 《 使用者指南*》中的[使用 管理您的成本 AWS Budgets](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-managing-costs.html)。如需設定通知的詳細資訊，請參閱[《 使用者指南》中的為預算通知建立 Amazon SNS 主題](https://docs.aws.amazon.com/cost-management/latest/userguide/budgets-sns-policy.html)。 *AWS Cost Management *如果已達到預算上限，您可以聯絡可執行查詢和任務或[離開協同合作](leave-collab.md)的成員。如果您離開協同合作，將不再允許執行任何查詢，因此您將不再支付查詢運算成本。

1. 如果您確定要建立成員資格並加入協同合作，請選擇**建立成員資格**。

您獲得協同合作中繼資料的讀取存取權。除了其他成員的所有名稱和 AWS 帳戶 IDs 之外，還包括協同合作的顯示名稱和描述等資訊。

您現在已準備好：
+ [準備要在 中查詢的資料表 AWS Clean Rooms](prepare-data.md)。（如果您想要查詢自己的事件資料，或想要查詢身分資料，則為選用。)
+ 如果您想要查詢事件資料[，請將設定的資料表與協同合作建立關聯](associate-configured-table.md)。
+ 若要查詢事件資料[，請新增已設定資料表的分析規則](add-analysis-rule.md)。
+ [建立新的 ID 命名空間並建立關聯](create-new-id-namespace.md) – 如果您想要建立 ID 映射表來查詢身分資料。

如需如何離開協同合作的詳細資訊，請參閱 [離開協同合作](leave-collab.md)。