複雑な SQL ノードをデバッグする場合、SQL 演算子の接続方法を理解したり、長いスクリプト内で特定の文を見つけたりすることが困難な場合があります。DataStudio の [コード構造] パネルは、SQL ノードのコードを解析して視覚的なフロー図に変換します。これにより、演算子の依存関係をトレースし、確認や編集のために任意のコードブロックに直接ジャンプできます。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
-
少なくとも 1 つの SQL ノードを含む DataWorks ワークスペース
-
DataWorks コンソールへのアクセス権限
コード構造の表示
-
DataWorks コンソール にログインします。上部ナビゲーションバーから対象リージョンを選択します。左側ナビゲーションウィンドウで、データ開発およびガバナンス > データ開発 を選択します。ドロップダウンリストから対象のワークスペースを選択し、データ開発へ移動 をクリックします。
-
スケジュール実行ワークフロー または 手動実行ワークフロー パネルで対象ノードを検索し、ダブルクリックして構成タブを開きます。
-
右側ナビゲーションウィンドウで、コード構造 をクリックします。パネルは「クラシックモード」または「アウトラインモード」で開きます。ご使用目的に応じてモードを選択してください。
モード 主な用途 クラシックモード SQL 演算子間の接続関係およびそれら間のデータフローをトレースする場合 アウトラインモード 大規模スクリプト内の特定の SQL ステートメントへ素早くジャンプする場合 
クラシックモード
クラシックモードでは、SQL コードが演算子とその関連性を表す有向グラフとしてレンダリングされます。これは、他の SQL ツールにおける実行計画ビューと類似しています。グラフ内の各ノードは、SQL 実行における 1 つのステップを表します。
演算子の種類を確認するには、マウスをその演算子上にホバーしてください。グラフに表示される主な演算子は以下のとおりです。
-
ソーステーブル — クエリ対象となるテーブル。
-
フィルター — ソーステーブル内のパーティションをフィルタリングするための条件。
-
中間テーブル（クエリビュー） — 中間クエリ結果を格納する一時テーブル。
たとえば、2 つのソーステーブルを結合する SQL スクリプトでは、3 つの中間テーブルが作成されます。それぞれ、各ソーステーブルのクエリ結果用と、結合結果用です。中間テーブルは 3 日間保持され、その後自動的に削除されます。 -
結合 — 複数のテーブルから得られた結果を統合する操作。
アウトラインモード
アウトラインモードでは、スクリプト内の主要な SQL ステートメントをディレクトリ形式で表示します。これは、VS Code や JetBrains などの IDE におけるアウトラインビューまたはシンボルビューと類似しています。このモードを使用すると、スクリプトの全体構造を俯瞰的に把握し、任意のステートメントへ素早くナビゲートできます。
コードブロックへのナビゲートと編集
-
クラシックモード：グラフ内の SQL 演算子をクリックします。
-
アウトラインモード：ディレクトリ内のステートメントをクリックします。
エディターが該当するコードブロックまでスクロールし、ハイライト表示します。必要に応じてコードを編集してください。