Creating a membership and joining a collaboration

A membership is a resource that's created when a member joins a collaboration in AWS Clean Rooms.

You can join a collaboration as a member who can query data, member who can receive results of a query, or both. You can also join a collaboration as a member paying for query compute costs. All members can contribute data.

For information about how to create a membership and join a collaboration using the AWS SDKs, see the AWS Clean Rooms API Reference.

In this procedure, the invited member joins the collaboration by creating a membership resource.

If the invited member is the member who can receive results, they specify the query results destination and format. They also provide a service role ARN to write to the query results destination.

If the invited member is the member who is responsible to pay for query compute costs, they accept their payment responsibilities before joining the collaboration.

To create a membership and join a collaboration

1. Sign in to the AWS Management Console and open the AWS Clean Rooms console with your member AWS account.

2. In the left navigation pane, choose Collaborations.

3. On the Available to join tab, for Collaborations available to join, choose the Name of the collaboration.

4. On the collaboration details page, view the collaboration details, including your member details and a list of the other members.

   Verify that the AWS account IDs for each member of the collaboration are the ones with whom you intend to enter in to the collaboration.

5. Choose Create membership.

6. On the Create membership page, in the Overview, view the Collaboration name, Collaboration description, AWS account ID of the Collaboration creator, Your member abilities, and the AWS account ID of the member who will Pay for queries.

7. If the collaboration creator has chosen to enable Query logging, choose one of the following options for Log storage in Amazon CloudWatch Logs:

   If you choose...	Then ...
   Turn on	The query logs relevant to you are stored in Amazon CloudWatch Logs. Each member can receive only logs for queries that they initiated or that contain their data. The member who can receive results also receives logs for all queries run in a collaboration, even if their data isn't accessed in a query.
   Turn off	The query logs relevant to you aren't stored in your Amazon CloudWatch Logs account.

   Note

   After you turn on Query logging, it can take a few minutes for log storage to be set up and start receiving logs in Amazon CloudWatch Logs. During this brief period, the member who can query might run queries that don’t actually send logs.

8. If Your member abilities includes Receive results:

   1. For Query results settings,

      1. Specify the Results destination in Amazon S3 by entering the S3 destination or choose Browse S3 to select from a list of available S3 buckets.

         For example: s3://bucket/prefix

      2. Choose the Result format (either CSV or PARQUET).

   2. For Service access, choose to either Create and use a new service role or Use an existing service role.

      Note

      You must either select an existing service role or have permissions to create a new one. For more information, see Create a service role to receive results.

9. If you want to enable Tags for the membership resource, choose Add new tag and then enter the Key and Value pair.

10. If the collaboration creator has designated you as the member who will Pay for queries, indicate your acceptance by selecting the I agree to pay for the query compute costs in this collaboration check box.

    Note

    You must select this check box to proceed.

    For more information about how pricing is calculated, see Pricing for AWS Clean Rooms.

    If you are the member paying for query compute costs but not the member who can query, it is recommended that you use AWS Budgets to configure a budget for AWS Clean Rooms and receive notifications once the maximum budget has been reached. For more information about setting up a budget, see Managing your costs with AWS Budgets in the AWS Cost Management User Guide. For more information about setting up notifications, see Creating an Amazon SNS topic for budget notifications in the AWS Cost Management User Guide. If the maximum budget has been reached, you can contact the member who can run queries or leave the collaboration. If you leave the collaboration, no more queries will be allowed to run, and therefore you will no longer be billed for query compute costs.

11. If you are sure that you want to create a membership and join the collaboration, choose Create membership.

You are given read access to the collaboration metadata. This includes information such as the display name and description of the collaboration, in addition to all the names and AWS account IDs of other members.

You are now ready to:

• Prepare your data table to be queried in AWS Clean Rooms. (Optional if you want to query your own event data or if you want to query identity data.)

• Associate the configured table to your collaboration – if you want to query event data.

• Add an analysis rule for the configured table – if you want to query event data.

• Create and associate a new ID namespace – if you want to create an ID mapping table to query identity data,

For information about how to leave a collaboration, see Leaving a collaboration.