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

# 分析ビルダーを使用してクエリを実行する
<a name="query-data-analysis-builder"></a>

分析ビルダーを使用すると、SQL コードを記述しなくてもクエリを作成できます。分析ビルダーでは、次のようなテーブルが含まれるコラボレーションのクエリを作成できます。
+ JOIN を必要とせず、[集計分析ルール](analysis-rules-aggregation.md)を使用する 1 つのテーブル
+ [集計分析ルール](glossary.md#glossary-agg-analysis-rule)を両方で使用する 2 つのテーブル (各メンバーから 1 つ)
+ [リスト分析ルール](glossary.md#glossary-list-analysis-rule)を両方で使用する 2 つのテーブル (各メンバーから 1 つ)
+ 集計分析ルールを両方で使用する 2 つのテーブル (各メンバーから 1 つ) と、リスト分析ルールを両方で使用する 2 つのテーブル (各メンバーから 1 つ)

SQL クエリを手動で記述する場合は、「[SQL コードエディタを使用して設定済みテーブルのクエリを実行する](use-sql-editor.md)」を参照してください。

Analysis Builder は、 AWS Clean Rooms コンソールの **Analysis タブの Analysis セクションに Analysis Builder UI** オプションとして表示されます。 **** ****

**重要**  
**[分析ビルダー UI]** をオンにし、分析ビルダーでクエリの作成を開始してから、**[分析ビルダー UI]** をオフにした場合、クエリは保存されません。

**ヒント**  
スケジュールされた保守管理がクエリの実行中に発生した場合、クエリは終了し、ロールバックされます。この場合は、クエリをやり直す必要があります。

以下のトピックでは、分析ビルダの使用方法について説明します。

**Topics**
+ [分析ビルダーを使用して 1 つのテーブルにクエリを実行する (集計)](#use-analysis-builder-one-table)
+ [分析ビルダーを使用して 2 つのテーブルにクエリを実行する (集計またはリスト)](#use-analysis-builder-two-tables)

## 分析ビルダーを使用して 1 つのテーブルにクエリを実行する (集計)
<a name="use-analysis-builder-one-table"></a>

この手順では、 AWS Clean Rooms コンソールで **Analysis Builder UI** を使用してクエリを構築する方法を示します。このクエリは、JOIN を必要とせず、[集計分析ルール](analysis-rules-aggregation.md)を使用するテーブルが 1 つだけ含まれるコラボレーション用です。

**分析ビルダーを使用して 1 つのテーブルにクエリを実行するには**

にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

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

1. **[自身のメンバー能力]** のステータスが **[クエリの実行]** になっているコラボレーションを選択します。

1. **分析**タブ**のテーブル**で、テーブルと関連する分析ルールタイプを表示します。(分析ルールの種類は**集計分析ルール**でなければなりません)。
**注記**  
想定したテーブルが表示されない場合は、次のいずれかの理由が考えられます。  
テーブルが[関連付け](associate-configured-table.md)られていない。
テーブルに[分析ルールが設定](add-analysis-rule.md)されていない。

1. **[分析]** セクションで、**[分析ビルダー UI]** をオンにします。

1. クエリを作成します。

   集計メトリクスをすべて表示する場合は、ステップ 9 に進んでください。

   1. **[メトリクスを選択]** で、デフォルトで事前に選択されている集計メトリクスを確認し、必要に応じてメトリクスを削除します。

   1. (オプション) **[セグメントを追加 – オプション]** で、1 つ以上のパラメータを選択します。
**注記**  
**[セグメントを追加 – オプション]** はテーブルにディメンションが指定されている場合にのみ表示されます。

   1. (オプション) **[フィルターを追加 – オプション]** で **[フィルターを追加]** を選択し、**パラメータ**、演算子、および**値**を選択します。

      さらにフィルターを追加するには、**[別のフィルターを追加]** を選択します。

      フィルターを削除するには、**[削除]** を選択します。
**注記**  
集計クエリでは ORDER BY はサポートされていません。  
AND 演算子のみがフィルターでサポートされています。

   1. (オプション) **[説明を追加 – オプション]** に、クエリのリストでクエリを識別しやすくするための説明を入力します。

1. **[SQL コードをプレビュー]** を展開します。

   1. 分析ビルダーから生成された SQL コードを表示します。

   1. SQL コードをコピーするには、**[コピー]** を選択します。

   1. SQL コードを編集するには、**[SQL コードエディタで編集]** を選択します。

1. **[Run]** (実行) を選択します。
**注記**  
結果を受け取れるメンバーがクエリ結果の設定を行っていないと、クエリを実行できません。

1. 引き続きパラメータを調整してクエリを再度実行するか、**[\$1]** ボタンを選択して新しいタブで新しいクエリを開始します。

**注記**  
AWS Clean Rooms は、明確なエラーメッセージを提供することを目指しています。トラブルシューティングに役立つ情報がエラーメッセージに不足している場合は、アカウントチームに連絡し、エラーが発生した経緯とエラーメッセージ (ID を含む) の詳細を伝えてください。詳細については、「[トラブルシューティング AWS Clean Rooms](troubleshooting.md)」を参照してください。

## 分析ビルダーを使用して 2 つのテーブルにクエリを実行する (集計またはリスト)
<a name="use-analysis-builder-two-tables"></a>

この手順では、 AWS Clean Rooms コンソールで Analysis Builder を使用して、以下を含むコラボレーションのクエリを構築する方法について説明します。
+ [集計分析ルール](analysis-rules-aggregation.md)を両方で使用する 2 つのテーブル (各メンバーから 1 つ)
+ [リスト分析ルール](analysis-rules-list.md)を両方で使用する 2 つのテーブル (各メンバーから 1 つ)
+ 集計分析ルールを両方で使用する 2 つのテーブル (各メンバーから 1 つ) と、リスト分析ルールを両方で使用する 2 つのテーブル (各メンバーから 1 つ)

**分析ビルダーを使用して 2 つのテーブルにクエリを実行する**

にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) で AWS Clean Rooms コンソールを開きます。

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

1. **メンバーの能力**ステータスが **Run クエリ**のコラボレーションを選択します。

1. **分析**タブ**のテーブル**で、2 つのテーブルと関連する分析ルールタイプ (**集計分析ルール**または**リスト分析ルール**) を表示します。
**注記**  
想定したテーブルが表示されない場合は、次のいずれかの理由が考えられます。  
テーブルが[関連付け](associate-configured-table.md)られていない。
テーブルに[分析ルールが設定](add-analysis-rule.md)されていない。

1. **[分析]** セクションで、**[分析ビルダー UI]** をオンにします。

1. クエリを作成します。

   コラボレーションに、**集計分析ルール**を使用する 2 つのテーブルと、**リスト分析ルール**を使用する 2 つのテーブルが含まれている場合は、まず **[集約]** または **[リスト]** のどちらかを選択し、選択した分析ルールに基づいてプロンプトに従います。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/query-data-analysis-builder.html)

1. **[SQL コードをプレビュー]** を展開します。

   1. 分析ビルダーから生成された SQL コードを表示します。

   1. SQL コードをコピーするには、**[コピー]** を選択します。

   1. SQL コードを編集するには、**[SQL コードエディタで編集]** を選択します。

1. **[Run]** (実行) を選択します。
**注記**  
結果を受け取れるメンバーがクエリ結果の設定を行っていないと、クエリを実行できません。

1. 引き続きパラメータを調整してクエリを再度実行するか、**[\$1]** ボタンを選択して新しいタブで新しいクエリを開始します。

**注記**  
AWS Clean Rooms は、明確なエラーメッセージを提供することを目指しています。トラブルシューティングに役立つ情報がエラーメッセージに不足している場合は、アカウントチームに連絡し、エラーが発生した経緯とエラーメッセージ (ID を含む) の詳細を伝えてください。詳細については、「[トラブルシューティング AWS Clean Rooms](troubleshooting.md)」を参照してください。