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

# SQL コードエディタを使用して設定済みテーブルのクエリを実行する
<a name="use-sql-editor"></a>

クエリを行えるメンバーは、SQL コードエディタで SQL コードを記述して手動でクエリを作成できます。SQL コードエディタは、 AWS Clean Rooms コンソールの分析****タブの分析****セクションにあります。

SQL コードエディタはデフォルトで表示されます。分析ビルダーを使用してクエリを作成する場合は、「[分析ビルダーを使用してクエリを実行する](query-data-analysis-builder.md)」を参照してください。

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

AWS Clean Rooms は、多くの SQL コマンド、関数、および条件をサポートしています。詳細については、「[AWS Clean Rooms SQL リファレンス](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)」を参照してください。

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

**SQL コードエディタを使用して設定済みテーブルのクエリを実行するには**

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. (オプション) テーブルのスキーマコントロールと分析ルールコントロールを表示するには、プラス記号アイコン (**\$1**) を選択してテーブルを展開します。

1. **分析**セクションの分析**モード** で、**SQL コードの書き込み** を選択します。
**注記**  
**[分析]** セクションは、結果を受け取れるメンバーとクエリの計算コストを負担するメンバーが、アクティブなメンバーとしてコラボレーションに参加している場合にのみ表示されます。

1. SQL コードエディタにクエリを入力してクエリを作成します。

   サポートされている SQL コマンドと関数の詳細については、[AWS Clean Rooms 「SQL リファレンス」を参照してください。](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)

   次のオプションを使用してクエリを構築することもできます。

------
#### [ Use an example query ]

   サンプルクエリを使用するには

   1. テーブルの横にある 3 つの縦のドットを選択します。

   1. **[エディタに挿入]** で **[クエリの例]** を選択します。
**注記**  
**サンプルクエリ**を挿入すると、既にエディタにあるクエリに追加されます。

      クエリの例が表示されます。**[テーブル]** の下に表示されているすべてのテーブルがクエリに含まれます。

   1. クエリのプレースホルダー値を編集します。

------
#### [ Insert column names or functions ]

   列名または関数を挿入するには

   1. 列の横にある 3 つの縦のドットを選択します。

   1. **[エディタに挿入]** で **[列名]** を選択します。

   1. 列で許可されている関数を手動で挿入するには、

      1. 列の横にある 3 つの縦のドットを選択します。

      1. **エディタで挿入**を選択します。

      1. 許可された関数の名前 (INNER JOIN、、SUM DISTINCT、 SUMなど) を選択しますCOUNT。

   1. **Ctrl** \$1 **スペース**キーを押すと、コードエディタにテーブルスキーマが表示されます。
**注記**  
クエリを行えるメンバーは、各設定済みテーブルの関連付けのパーティション列を表示して、使用できます。パーティション列が、設定済み AWS Glue テーブルの基盤となるテーブルのパーティション列としてラベル付けされていることを確認します。

   1. クエリのプレースホルダー値を編集します。

------

1. サポートされている**ワーカータイプ**と**ワーカー数**を指定します。

   SQL クエリを実行するインスタンスタイプとインスタンス数 (ワーカー) を選択できます。

   CR.1X では、最大 128 人のワーカーまたは最低 4 人のワーカーを選択できます。

   CR.4X では、最大 32 人のワーカーまたは最低 4 人のワーカーを選択できます。

   次の表を使用して、ユースケースに必要なタイプと数、またはワーカーを決定します。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/use-sql-editor.html)
**注記**  
さまざまなワーカータイプとワーカー数には関連コストがあります。料金の詳細については、「 [AWS Clean Rooms の料金](https://aws.amazon.com/clean-rooms/pricing/)」を参照してください。

1. **結果の送信先**には、結果を受け取るユーザーを指定します。
**注記**  
結果を受け取るには、コラボレーションメンバーを結果レシーバーとして設定し、コラボレーションのアクティブな参加者である必要があります (**ステータス: アクティブ**)

1. (クエリのみできるメンバー) **デフォルトでは、デフォルトの結果設定**を使用するチェックボックスが選択されています。デフォルトの結果設定を維持する場合は、これを選択します。

   このクエリに異なる結果設定を指定する場合は、「デフォルトの**結果設定を使用する**」チェックボックスをオフにしてから、以下を選択します。

   1. **結果形式** (**CSV** または **PARQUET**)

   1. **結果ファイル** (**単一**または**複数**)

   1. **Amazon S3 の結果の送信先**

   結果を受け取ることができる各メンバーは、Amazon S3 で異なる**結果形式**、**結果ファイル**、結果の送信先を指定できます。 ** Amazon S3**

1. **Spark プロパティ**を指定するには:

   1. **[Spark のプロパティ]** を拡張します。

   1. **Spark プロパティの追加**を選択します。

   1. **Spark プロパティ**ダイアログボックスで、ドロップダウンリストから**プロパティ名**を選択し、**値**を入力します。

   次の表は、各プロパティの定義を示しています。

   Spark プロパティの詳細については、Apache [Spark](https://spark.apache.org/docs/latest/configuration.html#spark-properties) ドキュメントの「Spark Properties」を参照してください。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/clean-rooms/latest/userguide/use-sql-editor.html)

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

1. **[結果]** を表示します。

   詳細については、「[分析結果の受信と使用](receive-query-results.md)」を参照してください。

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

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