DataWorks:SQL クエリと分析 (レガシー)

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

SQL クエリ機能は、MaxCompute、Hologres、EMR、CDH、StarRocks、ClickHouse、SelectDB、Doris、AnalyticDB for MySQL 3.0、AnalyticDB for PostgreSQL、Tablestore、MySQL、PostgreSQL、Oracle、SQL Server などのデータソースをサポートしています。

データソースの権限

機能へのアクセス

DataWorks データ分析 にログインし、対象のリージョンに切り替えて、[データ分析を開始] をクリックします。

• ナビゲーションバーに [新しいデータ分析に移動] が表示されている場合、レガシーデータ分析ページが表示されています。

• (非推奨) ナビゲーションバーに [旧バージョンのデータ分析へ戻る] が表示されている場合は、それをクリックしてレガシーデータ分析ページに戻ります。

ステップ 1：ディレクトリの追加

システムが推奨するディレクトリや、権限のあるデータソースからテーブルをディレクトリに追加できます。ディレクトリを追加すると、ディレクトリ内のテーブルをすばやく表示したり、テーブルスキーマを表示したり、SQL クエリを生成したりできます。

1. SQL 分析ページで、ディレクトリの上にある検索ボックスの右側にある ボタンをクリックして、ディレクトリを追加します。

   • [データマップ - メタデータ]：Data Map で 収集 されたテーブルメタデータ。各データソースまたはコンピューティングリソースは、データセットとして追加できます。

   • [データマップ - データコレクション]：Data Map で特定のトピックのテーブルを集約する データコレクション。

   • [お気に入り]：Data Map でお気に入りに追加したテーブル。

   • [マイ MaxCompute テーブル]：現在のログインアカウントがオーナーであるすべての MaxCompute テーブル。

   • [パブリックデータ]：MaxCompute が提供する パブリックデータセット。テストデータをすばやく生成するのに利用できます。

   説明

   最大 12 個のデータセットを追加できます。不要になったデータセットは削除できます。

ステップ 2：SQL クエリの作成

ステップ 3：クエリエンジンの設定とクエリの実行

1. SQL 詳細ページの右上隅にある ボタンをクリックして、SQL クエリエンジンを設定します。

   パラメーター	説明
   [ワークスペース]	実行エンジンが属するワークスペース。 重要 ワークスペースに対するアクセス権限があることを確認してください。ない場合は、ワークスペース管理者に連絡して、 ワークスペースメンバーとして追加 してもらってください。
   [データソースタイプ]	実行エンジンのタイプと名前。 重要 SQL 文で特定のプロジェクトが指定されていない場合、実行エンジンがデフォルトのデータソースとして機能します。
   [データソース]
   [アイデンティティアクセスパターン]	SQL クエリのアクセスモードを選択します： [実行ロール]：MaxCompute および Hologres エンジンでのみサポートされます。MaxCompute プロジェクトまたは Hologres インスタンスのメンバーであり、SELECT 権限を持っている場合に、このモードを推奨します。 [デフォルトのデータソースアクセスアイデンティティ]：現在のアカウントがデータソースの作成時に設定されたデフォルトアクセス ID と異なる場合は、現在のアカウントにその ID を付与してください。

2. スクリプト全体を実行するか、一部を選択して 部分実行 することができます。実行ボタンの横にあるドロップダウンアイコン をクリックして、実行モードを切り替えます。シナリオに応じて異なるモードを選択できます。

   MaxCompute SQL 文が実行される前に、推定コストが表示されます。SQL ファイルの上にあるツールバーで 詳細 > コスト見積り をクリックしてコストを見積もることもできます。

   実行モード	シナリオ	トリガー条件	適用可能なエンジン
   クエリモード (LIMIT 10000)	データの迅速なプレビューとクエリ ロジックの検証。このモードは、初期のデータ探索のために結果の小さなサンプルのみを表示したいシナリオに適しています。	クエリ結果は 10,000 行以下、10 MB 以下で表示されます。	制限なし
   クエリモード (全データ)	分析またはエクスポートのために完全な結果セットを取得。すべてのデータを処理して表示する必要がある場合に、このモードに切り替えます。	クエリ結果は 10,000 行を超えるか、10 MB を超える場合に表示されます。	MaxCompute、Hologres、StarRocks、ClickHouse、MySQL
   一時テーブルモード	複数ステップの複雑なクエリで結果を再利用。あるクエリの出力を次のクエリの入力として使用し、開発とデバッグの効率を向上させます。	クエリ結果は 10,000 行以下、10 MB 以下で表示され、自動的に一時テーブルに書き込まれます。	MaxCompute のみ

3. SQL 文が実行された後、クエリ結果ページで ランタイムログ、結果、および対応する SQL 文を表示できます。

   クエリ結果エリアの右上隅にあるボタンをクリックして、ページのレイアウトを左右分割と上下分割で切り替えることができます。

ステップ 4：クエリ結果の可視化

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

ステップ 5：エクスポートと共有

SQL クエリの結果は、次の形式でエクスポートできます：

• ローカルファイル：クエリ結果を CSV、TXT、または XLS 形式でローカルマシンにダウンロードします。主な情報は次のとおりです：

  項目	説明
  ダウンロード制限	サポートされているのは MaxCompute および EMR エンジンのみです。詳細については、「ダウンロード行数の制限」をご参照ください。 MaxCompute プロジェクトで データダウンロード制限 が有効になっている (データダウンロードが禁止されている) 場合、データ分析経由でのデータダウンロードは失敗します。 重要 このオプションが表示されない場合は、トラブルシューティングについては「よくある質問」をご参照ください。
  [ダウンロード範囲]	[テーブルにのみデータを表示] または [すべてのデータ] のどちらをダウンロードするかを選択できます。 [テーブルにのみデータを表示]: 現在のページに表示されているデータ (デフォルトでは最大 10000 行) のみをダウンロードします。 [すべてのデータ]：ダウンロード制限内で、クエリで取得したすべての結果データをエクスポートします。
  ダウンロード方法	ダウンロード方法には、[ダウンロードの承認]と[承認不要ダウンロード]の 2 つがあります。 承認後ダウンロード： リスク識別ルール を設定して、データダウンロード操作のリスクを識別できます。データをダウンロードする際には、データのコンプライアンスとセキュリティを確保するために、ダウンロード承認リクエストを送信する必要があります。 説明 リスク識別ルールの設定と有効化は、DataWorks の Enterprise Edition でのみサポートされています。 承認なしでダウンロード：デフォルトでは、ダウンロードに承認は不要です。ダウンロードプロセス中に権限リクエストは必要ありません。

• OSS：クエリ結果を Alibaba Cloud Object Storage Service (OSS) に指定された形式 (CSV や Parquet など) でエクスポートします。この方法は、大量のデータをアーカイブしたり、他のクラウドサービスと統合したりする場合に適しています。

  この機能を初めて使用する場合、DataWorks が OSS リソースにアクセスすることを認可する必要があります。ファイルパス ドロップダウンリストで、プロンプトの 認可 リンクをクリックし、指示に従って RAM 認可を完了します。

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

  設定が完了したら、OK をクリックしてエクスポートタスクを開始します。タスク実行ページで、エクスポートの進行状況、ランタイムログ、および設定の詳細を表示できます。タスクが成功したら、OSS コンソールに移動して、エクスポートされたファイルをローカルマシンにダウンロードします。

• MaxCompute テーブル：データをローカルマシンにダウンロードすることなく、クエリ結果を直接 MaxCompute テーブルにエクスポートできます。必要に応じて、テーブルのライフサイクルを設定できます。

  このオプションは、MaxCompute エンジンでクエリする場合にのみ使用できます。

• スプレッドシート：結果をスプレッドシートに保存して、さらに詳細な データ分析 を行えます。最新の分析結果を他のユーザーと 共有 することもできます。

関連操作

よくある質問