AWS Clean Rooms でのコラボレーションの管理 - AWS Clean Rooms
コラボレーションの編集コラボレーションの削除コラボレーションの表示テーブルと分析ルールの表示差分プライバシー使用状況ログの表示メンバーステータスの監視コラボレーションからメンバーを削除するコラボレーションからの退出設定済みテーブルの関連付けの編集設定済みテーブルの関連付けの解除差分プライバシーポリシーの編集差分プライバシーポリシーの削除計算された差分プライバシーパラメータの表示

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Clean Rooms でのコラボレーションの管理

以下のトピックでは、コラボレーションクリエーターが AWS Clean Rooms コンソールを使用して AWS Clean Rooms コラボレーションを管理する方法について説明します。

AWS SDK を使用してコラボレーションを管理する方法については、「AWS Clean Rooms API リファレンス」を参照してください。

コラボレーションの編集

コラボレーションのさまざまな部分を編集する方法を説明します。

コラボレーションの名前と説明の編集

コラボレーションの作成後は、コラボレーションの名前と説明のみを編集できます。

注記

[クエリログ記録] を有効にしている場合は、クエリログを Amazon CloudWatch Logs アカウントに保存するかどうかを編集できます。

コラボレーションの名前と説明を編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. コラボレーションの詳細ページで [アクション] を選択し、[コラボレーションを編集] を選択します。

  5. [詳細] で、コラボレーションの [名前] と [説明] を編集します。

  6. [Save changes] (変更の保存) をクリックします。

コラボレーションのタグ編集

コラボレーションクリエーターは、コラボレーションの作成後に、コラボレーションリソースのタグを管理できます。

コラボレーションのタグを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. 以下のうちのひとつを選択します。

    状況 操作
    コラボレーションのメンバーである場合 [詳細] タブを選択します。
    コラボレーションクリエーターだが、コラボレーションのメンバーではない場合 ページの [タグ] セクションまで下方向にスクロールします。

  5. [コラボレーションの詳細] で、[タグを管理] を選択します。

  6. [Manage tags] (タグの管理) ページで、次の操作を実行できます。

    • タグを削除するには、[削除] を選択します。

    • タグを追加するには、[新しいタグの追加] を選択します。

    • 変更を保存するには、[変更内容を保存] を選択します。

メンバーシップのタグ編集

コラボレーションクリエーターは、コラボレーションの作成後に、メンバーシップリソースのタグを管理できます。

メンバーシップのタグを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. [詳細] タブを選択します。

  5. [メンバーシップの詳細] で [タグを管理] を選択します。

  6. [メンバーシップタグを管理] ページで、次の操作を実行できます。

    • タグを削除するには、[削除] を選択します。

    • タグを追加するには、[新しいタグの追加] を選択します。

    • 変更を保存するには、変更の保存を選択します。

関連付けられているテーブルのタグ編集

コラボレーションクリエーターは、テーブルをコラボレーションに関連付けた後に、関連付けられているテーブルリソースのタグを管理できます。

関連付けられているテーブルのタグを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. [Tables] (テーブル) タブを選択します。

  5. [自分が関連付けたテーブル] で、テーブルを選択します。

  6. 設定済みテーブルの詳細ページの [タグ] で、[タグを管理] を選択します。

    [Manage tags] (タグの管理) ページで、次の操作を実行できます。

    • タグを削除するには、[削除] を選択します。

    • タグを追加するには、[新しいタグの追加] を選択します。

    • 変更を保存するには、変更の保存を選択します。

分析テンプレートのタグ編集

コラボレーションクリエーターは、コラボレーションの作成後に、分析テンプレートリソースのタグを管理できます。

メンバーシップのタグを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. [Templates (テンプレート)] タブを選択します。

  5. [自分で作成した分析テンプレート] セクションで、分析テンプレートを選択します。

  6. 分析テンプレートテーブルの詳細ページで、[タグ] セクションまで下方向にスクロールします。

  7. [Manage tags (タグの管理)] を選択します。

  8. [Manage tags] (タグの管理) ページで、次の操作を実行できます。

    • タグを削除するには、[削除] を選択します。

    • タグを追加するには、[新しいタグの追加] を選択します。

    • 変更を保存するには、変更の保存を選択します。

差分プライバシーポリシータグの編集

コラボレーションクリエーターは、コラボレーションの作成後に、分析テンプレートリソースのタグを管理できます。

メンバーシップのタグを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 編集する差分プライバシーポリシーを含むコラボレーションを選択します。

  4. [Tables] (テーブル) タブを選択します。

  5. [タグ] タブで、[タグ管理] を選択します。

  6. [Manage tags] (タグの管理) ページで、次の操作を実行できます。

    • タグを削除するには、[削除] を選択します。

    • タグを追加するには、[新しいタグの追加] を選択します。

    • 変更を保存するには、変更の保存を選択します。

コラボレーションの削除

コラボレーションクリエーターは、作成したコラボレーションを削除できます。

注記

コラボレーションを削除すると、作成者もどのメンバーも、クエリを実行したり、結果を受け取ったり、データを寄稿したりできません。コラボレーションの各メンバーは、メンバーシップの一環として引き続き自分のデータにアクセスできます。

コラボレーションを削除するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 削除するコラボレーションを選択します。

  4. [アクション] で [コラボレーションを削除] を選択します。

  5. 削除を確定し、[削除] を選択します。

コラボレーションの表示

コラボレーションクリエーターは、自分が作成したすべてのコラボレーションを表示できます。

コラボレーションを表示するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. [コラボレーション] ページの [最終使用日] に、直近に使用した 5 つのコラボレーションが表示されます。

  4. [アクティブメンバーシップあり] タブには、[アクティブメンバーシップとのコラボレーション] のリストが表示されます。

    [名前]、[メンバーシップの作成日]、[あなたのメンバー情報] で並べ替えることができます。

    [検索] バーを使用してコラボレーションを検索できます。

  5. [参加可能] タブには、[参加可能なコラボレーション] のリストが表示されます。

  6. [利用できなくなりました] タブには、削除されたコラボレーションのリストと、[利用できなくなったコラボレーションのメンバーシップ] (削除されたメンバーシップ) が表示されます。

テーブルと分析ルールの表示

コラボレーションに関連付けられたテーブルと分析ルールを表示するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. [Tables] (テーブル) タブを選択します。

  5. 以下のうちのひとつを選択します。

    1. コラボレーションに関連付けられている自分のテーブルを表示するには、[自分が関連付けたテーブル] でテーブル (青色のテキスト) を選択します。

    2. コラボレーションに関連付けられている他のテーブルを表示するには、[コラボレーターが関連付けたテーブル] でテーブル (青色のテキスト) を選択します。

  6. テーブルの詳細と分析ルールが、テーブルの詳細ページに表示されます。

差分プライバシー使用状況ログの表示

差分プライバシーでデータを保護しているコラボレーションメンバーは、差分プライバシーでコラボレーションを作成した後で、プライバシー予算の使用状況をモニタリングできます。

集計が行われた回数と使用されたプライバシー予算の金額を確認するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. [Tables] (テーブル) タブを選択します。

  5. [使用状況ログを表示] (青色のテキスト) を選択します。

  6. プライバシー予算や提供したユーティリティの提供量など、使用状況の詳細を表示します。

メンバーステータスの監視

コラボレーションクリエーターは、コラボレーションの作成後に、[メンバー] タブですべてのメンバーのステータスを監視できます。

メンバーのステータスを確認するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. [メンバー] タブを選択します。

  5. 各メンバーの [メンバーステータス] を表示します。

コラボレーションからメンバーを削除する

注記

メンバーを削除すると、そのメンバーが関連付けられているデータセットもすべてコラボレーションから削除されます。

コラボレーションからメンバーを削除するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. 作成したコラボレーションを選択します。

  4. [メンバー] タブを選択します。

  5. 削除するメンバーの横にあるオプションボタンを選択します。

    注記

    コラボレーションクリエーターは自分のアカウント ID を選択できません。

  6. [削除] を選択します。

  7. ダイアログボックスのテキスト入力フィールドに「confirm」と入力して、メンバーの削除を確定します。

    注記

    クエリの計算コストを負担するメンバーを削除すると、コラボレーション内でそれ以上クエリを実行できなくなります。

コラボレーションからの退出

コラボレーションメンバーは、自分のメンバーシップを削除することでコラボレーションから退出できます。コラボレーションクリエーターは、コラボレーションを削除しないとコラボレーションから退出できません。

注記

メンバーシップを削除すると、コラボレーションから退出することになり、再び参加することはできません。クエリの計算コストを負担するメンバーがメンバーシップを削除すると、それ以上クエリを実行できなくなります。

コラボレーションから退出するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. [アクティブメンバーシップあり] で、自分がメンバーになっているコラボレーションを選択します。

  4. [アクション] を選択します。

  5. [メンバーシップを削除] を選択します。

  6. ダイアログボックスのテキスト入力フィールドに「confirm」と入力してコラボレーションからの退出を確定し、[メンバーシップを空にして削除] を選択します。

    メンバーシップが削除されたことを示すメッセージがコンソールに表示されます。

    コラボレーションクリエーターには、[メンバーステータス] に [退出済み] と表示されます。

設定済みテーブルの関連付けの編集

コラボレーションメンバーは、作成した設定済みテーブルの関連付けを編集できます。

設定済みテーブルの関連付けを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. [テーブル] タブを選択します。

  5. [自分が関連付けたテーブル] で、テーブルを選択します。

  6. テーブルの詳細ページで、[テーブルの関連付けの詳細] まで下方向にスクロールします。

  7. [編集] を選択します。

  8. [設定済みのテーブル関連付けを編集] ページで、[説明] または [サービスアクセス情報] を更新します。

  9. [Save changes] (変更の保存) をクリックします。

設定済みテーブルの関連付けの解除

コラボレーションメンバーは、設定済みテーブルとコラボレーションの関連付けを解除できます。このアクションにより、クエリを行えるメンバーはテーブルでクエリを実行できなくなります。

設定済みテーブルの関連付けを解除するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. [テーブル] タブを選択します。

  5. [自分が関連付けたテーブル] で、関連付けを解除するテーブルの横にあるオプションボタンを選択します。

  6. [Disassociate] (関連付け解除) を選択します。

  7. ダイアログボックスで [関連付け解除] を選択すると、設定済みテーブルの関連付けの解除が確定し、クエリを行えるメンバーがテーブルでクエリを実行できなくなります。

差分プライバシーポリシーの編集

差分プライバシーポリシーを設定した後は、プライバシーのニーズをより適切に反映するようにいつでも更新できます。

差分プライバシーポリシーを編集するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. コラボレーションページの [テーブル] タブの [自分が関連付けたテーブル] で、[編集] を選択します。

  5. [差分プライバシーの編集] ページで、次のプロパティの新しい値を選択します。

    • [プライバシー予算] — コラボレーション中の任意の時点で、スライダーバーを動かして予算を増減できます。クエリを実行できるメンバーがデータのクエリを開始した後は、予算を減らすことはできません。[プライバシー予算] が増加した場合、AWS Clean Rooms は、新しく追加されたプライバシー予算を使用する前に、既存の予算を完全に消費するまで使用し続けます。

    • [クエリごとに追加されるノイズ] — コラボレーション中の任意の時点で、スライダーバーを動かして [クエリごとに追加されるノイズ] を増減できます。

    注記

    [インタラクティブサンプル] を選択して、[プライバシー予算] と [クエリごとに追加されるノイズ] の値が異なると、実行できる集計関数の数にどのように影響するかを調べることができます。

    [プライバシー予算の更新] の値は変更できません。選択を変更するには、差分プライバシーポリシーを削除し、新しく作成する必要があります。

  6. [Save changes] (変更の保存) をクリックします。

差分プライバシーポリシーが正常に編集されたことを示す確認メッセージが表示されます。

差分プライバシーポリシーの削除

差分プライバシーポリシーはコラボレーションの [テーブル] タブから削除できます。

差分プライバシーポリシーを削除するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. コラボレーションページの [テーブル] タブで、[差分プライバシーポリシー] の横にある [削除] を選択します。

  5. 差分プライバシーポリシーを削除してよい場合は、[削除] を選択します。

差分プライバシーポリシーを削除すると、そのポリシーのプライバシー予算使用状況ログにアクセスできなくなります。差分プライバシーポリシーが削除されると、差分プライバシーがオンになっているテーブルをクエリできなくなります。

計算された差分プライバシーパラメータの表示

差分プライバシーに関する専門知識を持つユーザーは、コラボレーションの [クエリ] タブから計算された差分プライバシーパラメータを表示できます。

計算された差分プライバシーパラメータを表示するには

  1. 自身の AWS アカウントで AWS Management Consoleにサインインし、AWS Clean Rooms コンソールを開きます (まだ開いていない場合)。

  2. 左のナビゲーションペインで、[コラボレーション] を選択します。

  3. コラボレーションを選択します。

  4. [クエリ] タブの [結果] セクションで、[計算された差分プライバシーパラメータを表示] を選択します。

[計算された差分プライバシーパラメータ] のテーブルでは、集計関数の感度値が表示されます。これは、1 人のユーザーのレコードが追加、削除、または変更された場合に関数の結果が変化する可能性のある最大値として定義されます。リストには、次の差分プライバシーパラメータが含まれます。

  • [ユーザー寄与度上限] (UCL) は、SQL クエリでユーザーが入力する行の最大数です。例えば、各ユーザーが複数のインプレッションを持つことができる特定のキャンペーンで一致したインプレッションの合計数をカウントする場合、差分プライバシーの計算が正確になるように、AWS Clean Rooms の差分プライバシーは、単一のユーザーのインプレッション数を制限する必要があります。つまり、あるユーザーのインプレッション数が上限を超える場合、AWS Clean Rooms は自動的に、計算された UCL 値に従ってそのユーザーのインプレッションの均一なランダムサンプルを取得し、クエリの実行中にそのユーザーの残りのインプレッションを除外します。一意のユーザー数をカウントする場合、UCL 値は 1 に等しくなります。これは、1 人のユーザーを追加、削除、または変更することで、個々のユーザーのカウントが最大で 1 だけ変更される可能性があるためです。

  • [最小値] は、sum() のような集計関数内で使用される式の下限値です。例えば、式が purchase_value という列の場合、最小値はその列の下限値です。

  • [最大値] は、sum() のような集計関数内で使用される式の上限値です。例えば、式が purchase_value という列の場合、最大値はその列の上限値です。

[計算された差分プライバシーパラメータ] のテーブルでは、これらのパラメータを使用してクエリ結果のノイズの総量の理解を深めることができます。例えば、[クエリごとに追加されるノイズ] が 30 ユーザーに設定されている状態で COUNT DISTINCT (user_id) クエリを実行すると、COUNT DISTINCT の感度が 1 であるため、AWS Clean Rooms 差分プライバシーは高い確率で -30～30 の範囲のランダムなノイズを追加します。同じ設定の COUNT クエリの場合、AWS Clean Rooms 差分プライバシーは、1 人のユーザーがクエリ結果に複数の行を寄稿する可能性があるため、ユーザーの寄与度上限に応じてスケールされる統計的ノイズを追加します。SUM (purchase_value) のようなすべての列の値が正の値である SUM クエリの場合、ノイズの合計は、ユーザー寄与度上限に最大値を掛けた値によってスケーリングされます。AWS Clean Rooms差分プライバシーは、クエリの実行時に自動的に感度パラメータを計算してノイズを追加し、プライバシー予算を使い果たします。感度パラメータはデータに依存するため、プライバシー予算を使い果たす必要があります。