SQL コードエディタを使用した設定済みテーブルのクエリ - AWS Clean Rooms

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

SQL コードエディタを使用した設定済みテーブルのクエリ

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

デフォルトでは、SQLコードエディタが表示されます。分析ビルダーを使用してクエリを作成する場合は、「Analysis Builder の使用」を参照してください。

重要

コードエディタでSQLクエリの書き込みを開始し、次に Analysis Builder UI をオンにすると、クエリは保存されません。

AWS Clean Rooms は、多くのSQLコマンド、関数、および条件をサポートしています。詳細については、「 AWS Clean Rooms SQLリファレンス」を参照してください。

ヒント

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

SQL コードエディタを使用して設定済みテーブルをクエリするには
  1. にサインイン AWS Management Console し、 でAWS Clean Rooms コンソールを開きます AWS アカウント (まだ開いていない場合)。

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

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

  4. [クエリ] タブの [分析] セクションに移動します。

    注記

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

  5. [クエリ] タブの [テーブル] に、テーブルのリストとそれに関連する分析ルールの種類 (集計分析ルールリスト分析ルール、またはカスタム分析ルール) が表示されます。

    注記

    想定したテーブルが表示されない場合は、次のいずれかの理由が考えられます。

  6. (オプション) テーブルのスキーマコントロールと分析ルールコントロールを表示するには、プラス記号アイコン (+) を選択してテーブルを展開します。

  7. SQL コードエディタにクエリを入力して、クエリを構築します。

    (オプション) クエリの例を使用する場合 (オプション) 列名または関数を挿入する場合
    1. テーブルの横にある 3 つの縦のドットを選択します。

    2. [エディタに挿入][クエリの例] を選択します。

      注記

      クエリの例を挿入すると、エディタに既に表示されているクエリに追加されます。

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

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

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

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

    3. 列で許可される関数を手動で挿入するには、列の横にある 3 つの縦のドットを選択し、エディタで挿入を選択し、許可された関数の名前 (INNER JOIN、、SUMSUMDISTINCT、 など) を選択しますCOUNT。

    4. Ctrl + スペースキーを押すと、コードエディタにテーブルスキーマが表示されます。

      注記

      クエリを行えるメンバーは、各設定済みテーブルの関連付けのパーティション列を表示して、使用できます。パーティション列が、設定済み AWS Glue テーブルの基盤となるテーブルのパーティション列としてラベル付けされていることを確認します。

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

  8. 結果の配信 では、結果の受信先を に送信する に指定します

  9. [Run] (実行) を選択します。

    注記

    結果を受け取れるメンバーがクエリ結果の設定を行っていないと、クエリを実行できません。

  10. 結果を表示します

    詳細については、「クエリ結果の使用」を参照してください。

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

注記

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