すべてのプロダクト
Search
ドキュメントセンター

DataWorks:コードテンプレートの設定

最終更新日:Sep 05, 2026

コードテンプレートは、ノードを作成する際にコードエディターに自動で入力される既定の内容を定義します。ノードタイプ、作成者、作成時刻などの情報が含まれており、ノードの識別と管理に役立ちます。このトピックでは、DataWorks がサポートするコードテンプレートの種類と、コードテンプレートの設定方法について説明します。

制限事項

[ストレージ管理者]のみがコードテンプレートを変更できます。他のユーザーにも変更を許可する場合は、そのユーザーに[ストレージ管理者]ロールを付与してください。詳細については、「Add a RAM user to a workspace as a member and assign roles to the member」をご参照ください。

コードテンプレートの設定

  1. [テンプレート管理] タブに移動します。

    1. DataWorks コンソールにログインします。 左側のナビゲーションウィンドウで、[データモデリングと開発] > [DataStudio] を選択します。 表示されるページで、ドロップダウンリストから目的のワークスペースを選択し、[DataStudioに移動] をクリックします。

    2. 左側のナビゲーションペインの下部で、Settings アイコンをクリックして 設定項目 ページを開きます。

    3. 設定項目 ページで、コードテンプレート タブをクリックし、コードテンプレート ページに移動します。

  2. コードテンプレートを設定します。

    コードテンプレート ページで、対象の コードタイプ の横にある 編集 をクリックして、そのノードタイプのコードテンプレートを変更します。テンプレートを保存すると、Data Studio で作成される当該タイプの新規ノードすべてに適用されます。DataWorks がサポートするテンプレートタイプについては、「サポートされているコードテンプレートタイプ」をご参照ください。

    次のコードは、ODPS SQL ノードのコードテンプレートの例です。

    --odps sql
    --**********************************************************
    --author: xxx
    --create time: 2023-06-26 11:33:05
    --**********************************************************

サポートされているコードテンプレートタイプ

コードテンプレートでは、次の変数を使用して新規ノードの情報を記録できます:

  • author:ノードの作成者を記録します。

  • createTime:ノードの作成時刻を記録します。

次の表に、DataWorks がサポートするノードタイプと、各ノードタイプに用意されている既定のコードテンプレートを示します。

エンジンタイプ

ノードタイプ

既定のテンプレート

[MaxCompute]

ODPS Script

ODPS Script コードテンプレートには、${author} (作成者) と ${createTime} (作成時間) というテンプレート変数が含まれています。 テンプレートの内容はコメント区切り線で囲まれています。

ODPS SQL

ODPS SQL コードテンプレートのデフォルトのコンテンツには、コメント行 --odps sql、テンプレート変数 ${author} (作成者)、および ${createTime} (作成時間) が含まれており、これらはアスタリスクの区切り線で区切られています。テンプレートを編集した後、[保存] をクリックします。

ODPS MR

ODPS MR ノードのデフォルトのコードテンプレートは -odps mr で、${author} (作成者) と ${createTime} (作成時刻) の変数プレースホルダーが含まれています。[コードテンプレート] ダイアログでテンプレートを編集し、[保存] をクリックします。

PyODPS 2

デフォルトの PyODPS 2 コードテンプレートには、以下のようなヒントが含まれています: MaxCompute から大量のデータをダウンロードすることは、極力避けてください。 関連するメソッドは、テーブルまたはインスタンスの open_reader と DataFrame の to_pandas です。 MaxCompute テーブルから作成された PyODPS DataFrame、または MaxCompute SQL を直接使用することをお勧めします。 参照: https://developer.aliyun.com/article/745029。 [コードテンプレート] ダイアログで、テンプレートを編集して [保存] をクリックするか、[キャンセル] をクリックして変更を破棄します。

PyODPS 3

PyODPS 3 コードテンプレートには、次の内容が含まれています。「MaxCompute から大量のデータをダウンロードすることは、極力避けてください。関連メソッドには、テーブルまたはインスタンスの open_reader や、DataFrame の to_pandas があります。MaxCompute テーブルから作成された PyODPS DataFrame、または MaxCompute SQL を直接使用することをお勧めします。参考: https://developer.aliyun.com/article/745029」

[EMR]

EMR MR

--EMR MR
--**********************************************************--
--author:${author}
--create time:${createTime}
--EMR MR ノードは専用リソースグループでのみ実行できます。
--**********************************************************--

EMR Shell

EMR Shell コードテンプレートには、テンプレート変数 ${author} と ${createTime}、および EMR Shell ノードは専用リソースグループでのみ実行できるという注意事項が含まれています。

EMR Presto

EMR Presto のコードテンプレートには、次のテンプレート変数と注記が含まれています:

  • --author:${author}

  • --作成時間:${createTime}

  • --EMR Presto ノードは、専用リソースグループでのみ実行できます。

EMR Spark Streaming

--EMR Spark Streaming
--***************************************************--

--author:${author}
--create time:${createTime}
--EMR Spark Streaming ノードは専用リソースグループでのみ実行できます。
--***************************************************--

EMR Trino

EMR Trino のコードテンプレートには、次の内容が含まれています:

  • --EMR Trino ヘッダー行

  • --author:${author} 作成者変数のプレースホルダー

  • 作成時間変数プレースホルダー --create time:${createTime}

  • 注記:EMR Trino ノードは専用リソースグループでのみ実行できます。

EMR Hive

EMR Hive ノードのコードテンプレートには、テンプレート変数 ${author} (作成者) と ${createTime} (作成時刻)、および「EMR Hive ノードは専用リソースグループでのみ実行できます。」という注釈が含まれています。

EMR Spark

--EMR Spark
--*******************************************--
--author:${author}
--create time:${createTime}
--EMR Spark ノードは専用リソースグループでのみ実行できます。
--*******************************************--

EMR Spark SQL

EMR Spark SQL ノードのデフォルトのコードテンプレートには、${author} (作成者) と ${createTime} (作成時間) の変数を定義するコメントブロック、および EMR Spark SQL ノードは、専用リソースグループでのみ実行できます。 という注意書きが含まれています。

CDH

CDH Hive

--CDH Hive
--*************************************************************--
--author:${author}
--create time:${createTime}
--CDH Hive ノードは専用リソースグループでのみ実行できます。
--*************************************************************--

CDH Spark

--CDH Spark
--**********************************************************--
--author:${author}
--create time:${createTime}
--CDH Spark ノードは専用リソースグループでのみ実行できます。
--**********************************************************--

CDH MR

--CDH MR
--**********************************************************************--
--author:${author}
--create time:${createTime}
--CDH MR ノードは専用リソースグループでのみ実行できます。
--**********************************************************************--

CDH Presto

--CDH Presto
--**********************************************************--
--author:${author}
--create time:${createTime}
--CDH Presto ノードは専用リソースグループでのみ実行できます。
--**********************************************************--

CDH Impala

CDH Impala コードテンプレートには、変数 ${author}(作成者)および ${createTime}(作成時間)と、CDH Impala ノードは専用リソースグループでのみ実行できるという注意書きが含まれています。

Hologres

Hologres SQL

デフォルトの Hologres SQL コードテンプレートのコメントヘッダーでは、${author} および ${createTime} 変数を使用して、作成者と作成時刻が自動的に入力されます。

その他

Shell

#!/bin/bash
#************************************************************#
##author:${author}
##create time:${createTime}
#************************************************************#

ClickHouse SQL

ClickHouse SQL コードテンプレートのコンテンツ例:上部と下部にアスタリスクの区切り線があり、その間に 2 つのテンプレート変数 --author:${author} と --create time:${createTime} があります。テンプレートを編集した後、[保存] をクリックします。

HTTP トリガー

--HTTP Trigger
--**********************************************************--

--author:${author}
--create time:${createTime}
-- HTTP Trigger は仮想ノードです。DataWorks OpenAPI の RunTriggerNode API を呼び出すことで、下流ノードをトリガーできます。
-- 通常、外部システムとの連携に使用されます。
-- 詳細については、https://www.alibabacloud.com/help/document_detail/190911.html をご参照ください。

--**********************************************************--