DataWorks:SQL クエリ（新バージョン）

サポートされるデータソース

SQL クエリは、以下のデータソースタイプをサポートしています：MaxCompute、Hologres、EMR、CDH、ADB for PostgreSQL、ADB for MySQL、ClickHouse、StarRocks、MySQL、PostgreSQL、Oracle、SQL Server、Doris、および SelectDB。

データソースの権限

機能へのアクセス

DataWorks データ分析コンソール にログインし、ターゲットリージョンに切り替えた後、データ分析へ移動 をクリックします。

• ナビゲーションバーに 新データ分析へ移動 が表示されている場合は、これをクリックして新バージョンに切り替えます。

• ナビゲーションバーに 旧データ分析に戻る が表示されている場合は、すでに新バージョンのページにいます。

SQL クエリの作成

1. 個人フォルダー > マイファイル 上にマウスを合わせ、右側の > 新しい SQL ファイル をクリックします。

   SQL クエリファイル用にカスタムフォルダー構造を作成するには、「新しいフォルダー」をクリックすることもできます。

2. SQL エディター画面で、SQL クエリ文を作成します。

   重要

   以下の方法でも SQL 文を生成できます：

   • データカタログの追加 後、データカタログページで対象テーブルを検索し、右クリックして クエリ SQL の生成 を選択します。

   • 共有ファイル フォルダーから、他者と共有された SQL クエリをコピーします。

   • SQL の編集後、上部の フォーマット ボタンをクリックしてコードを整形します。

   • SQL クエリは Copilot をサポートしています。ナビゲーションバー右上隅の Copilot アイコン () をクリックすると、コード生成 や コード修正 などの機能を利用でき、コード作成を支援します。また、エディター内での自動コード補完もサポートしており、作成効率を向上させます。

   SQL の例

   以下の SQL ステートメントは、MaxCompute 内の パブリック GitHub イベントデータ をクエリします：

   -- セッションレベルのスキーマ構文を有効化します。
   SET odps.namespace.schema=true; 
   -- dwd_github_events_odps テーブルから 100 行をクエリします。
   SELECT * FROM bigdata_public_dataset.github_events.dwd_github_events_odps WHERE ds='${dt}' LIMIT 100;

   説明

   • スキーマ構文が有効になっている MaxCompute プロジェクトをクエリする場合、クエリ文の前に SET odps.namespace.schema=true; を追加してください。これにより、セッションレベルのスキーマ構文が有効になり、クエリの失敗を防ぐことができます。

   • デフォルトでは、現在の 実行設定 で指定されたデータソースに対してクエリが実行されます。参加済みの他の MaxCompute プロジェクトをクエリするには、クエリ文内でプロジェクト名を明示的に指定する必要があります。たとえば、実行設定の計算リソースが MaxCompute A であり、クエリ文が MaxCompute B を指定している場合（SELECT * FROM B.schema_name.table_name WHERE ****）、システムは A を実行エンジンとして使用し、B のデータをクエリします。

3. SQL クエリコードを作成した後、右側の 実行設定 をクリックします。SQL クエリの データソース、スクリプトパラメーター およびその他の設定を構成します。

   

   • タイプ：必要に応じて、SQL クエリの対象となる データソースタイプ を選択します。

   • 計算リソース：SQL クエリの対象となるデータソースを構成します。MaxCompute クエリのみが直接接続およびデータソース接続をサポートします。その他のデータソースタイプは、権限を持つワークスペース内のデータソースからのみデータをクエリできます。権限に関する詳細は、「データソースの権限」をご参照ください。

   • スクリプトパラメーター：SQL クエリにパラメーター変数が含まれる場合、ランタイムで値を割り当てます。

     重要

     解析に失敗した場合は、左下の「管理 > 設定」に移動し、「parsing」と入力して検索し、「DataWorks Isp コードパラメーター機能の有効化」設定項目を有効化してください。

4. SQL エディター ページの上部にあるツールバーで、[実行] をクリックします。[実行] ボタンの右側にあるドロップダウンアイコン をクリックして実行モードを切り替え、シナリオに基づいてモードを選択します。

   実行モード	利用シーン	トリガー条件	対応エンジン
   クエリモード（LIMIT 10000）	データの素早いプレビューおよびクエリロジックの検証。 少量の結果サンプルのみが必要な初期データ探索に適しています。	クエリ結果の表示行数 ≤ 10,000 行、サイズ ≤ 10 MB	制限なし
   需要モード（完全データ）	分析またはエクスポート用の完全な結果セットの取得。 全データを処理・閲覧する必要がある場合、システムが自動的にこのモードを起動します。	クエリ結果の表示行数 > 10,000 行、またはサイズ > 10 MB	制限なし
   一時テーブルモード	マルチステップの複雑なクエリで結果を再利用。 1 つのクエリの出力を次のクエリの入力として使用することで、開発およびデバッグ効率を向上させます。	クエリ結果の表示行数 ≤ 10,000 行、サイズ ≤ 10 MB であり、自動的に一時テーブルに書き込まれます	MaxCompute のみ

5. SQL 実行が完了すると、クエリ結果ページで 運用ログ、結果、および対応する SQL コンテンツを確認できます。

   クエリ結果の右上隅にあるボタンをクリックすると、ページレイアウトを横並び表示と上下表示の間で切り替えることができます。

クエリ結果の可視化

クエリ結果の左側ツールバーで、 ボタンをクリックすると、結果から自動的に可視化チャートが生成されます。

エクスポートおよび共有

SQL クエリ結果の右側で、エクスポート をクリックします。以下のエクスポートオプションがサポートされています：

• ローカルファイル：クエリ結果を CSV 形式でローカルコンピューターにダウンロードします。主なポイントは以下のとおりです：

  項目	説明
  ダウンロード制限	MaxCompute および EMR エンジンのみがサポートされます。詳細については、「データダウンロード制限」をご参照ください。 MaxCompute プロジェクトで データ保護メカニズム（データダウンロードを禁止）が有効になっている場合、DataAnalysis によるデータダウンロードは失敗します。
  ダウンロード範囲	テーブルに表示されているデータのみ または すべてのデータ を選択できます。 テーブルに表示されているデータのみ：現在のページに表示されているデータのみをダウンロードします（デフォルト最大 10000 行）。 すべてのデータ：エクスポート制限内のすべてのクエリ結果をエクスポートします。
  ダウンロード方法	承認ありダウンロード および 承認なしダウンロード をサポートします。 承認ありダウンロード：設定可能な Fraud Detection ルール を用いて、データダウンロード操作におけるリスクを特定できます。ダウンロード時には、データのコンプライアンスおよびセキュリティを確保するために、ダウンロード承認リクエストを提出する必要があります。 説明 Fraud Detection ルールの設定および有効化は、DataWorks Enterprise Edition のみがサポートします。 承認なしダウンロード： デフォルトの方法です。ダウンロードプロセス中に権限リクエストは不要です。

• Object Storage Service (OSS)：クエリ結果を、CSV や Parquet などの指定フォーマットで、Alibaba Cloud Object Storage Service (OSS) バケットにエクスポートします。大量のデータ量のアーカイブや、他のクラウド製品との統合に適しています。

  本機能を初めて使用する場合、DataWorks が OSS リソースにアクセスできるよう、事前に権限を付与する必要があります。[ファイルパス] のドロップダウンリストで、プロンプト内の [ワンクリック認可] リンクをクリックし、画面上の指示に従って RAM 認可を完了してください。

  設定項目	説明
  ファイルパス	右側のフォルダーボタンをクリックして、結果ファイルを保存する OSS バケットおよびディレクトリを選択します。
  ファイル名	システムが自動的にファイル名を生成します。手動で変更することもできます。
  テキスト形式	エクスポートするファイル形式を選択します。サポートされる形式には、csv、text、orc、および parquet があります。
  区切り文字	列間のデリミタを指定します。デフォルトはカンマ (,) です。
  エンコード形式	ファイルのエンコード形式を選択します（例：UTF-8、GBK）。
  CU	本エクスポートタスクの計算ユニット（CU）数を構成します。デフォルト値は 1 CU です。
  リソースグループ	本エクスポートタスクを実行する Serverless リソースグループを選択します。選択しない場合、データ分析 > システム管理 で設定されたデータ統合リソースグループがデフォルトで使用されます。

  構成を完了したら、OK をクリックしてエクスポートタスクを開始します。タスク実行ページで、エクスポートの進行状況、運用ログ、および構成詳細を確認できます。タスクが成功した後、OSS コンソールに移動して、エクスポートされたオブジェクトファイルをローカルコンピューターにダウンロードしてください。

• DingTalk Sheet：結果を DingTalk Sheet にエクスポートできます。

• ワークブック／ワークブックの共有：結果をワークブックに保存して、クエリデータのさらなる 分析 に活用できます。また、ワークブック から最新の分析結果を他のユーザーと共有することもできます。