DataWorks:ワークスペースレベルのパラメーターの使用

背景情報

スケジューリングパラメーターは、DataWorks タスクのスケジューリングで使用される変数です。設定されたルールに基づき、DataWorks はタスク実行時に自動的にその値を置換します。スケジューリングパラメーターの詳細については、「スケジューリングパラメーター」をご参照ください。

前提条件

• ワークスペースがすでに作成されている必要があります。ワークスペースの作成方法の詳細については、「ワークスペースの構成」をご参照ください。

• 対象ワークスペースで ワークスペース管理者 ロールを保有している必要があります。詳細については、「ワークスペースメンバーの追加とロール管理」をご参照ください。

• DataWorks Professional Edition 以上が必要です。詳細については、「DataWorks エディションの購入またはスペックアップ」をご参照ください。

制限事項

• この機能は、専用スケジューリングリソースグループでのみ利用可能です。

• January 1, 2024 以降に専用スケジューリングリソースグループを購入した場合、この機能を利用できます。それ以前に購入した場合は、テクニカルサポートに連絡してスペックアップを依頼してください。

ワークスペースレベルのパラメーターの作成

1. ワークスペースレベルのパラメーター作成ページに移動します。

   1. DataWorks コンソール にログインします。対象のリージョンで、左側のナビゲーションウィンドウから データ開発と О&М > オペレーションセンター をクリックします。ドロップダウンリストからワークスペースを選択し、移動 オペレーションセンター をクリックします。

   2. オペレーションセンターの左側ナビゲーションウィンドウで、その他 > スケジューリング設定 をクリックし、ワークスペースパラメーター タブをクリックします。

2. ワークスペースレベルのパラメーターを作成します。

   1. ワークスペースレベルのパラメーター タブで、新規ワークスペースのパラメーター をクリックしてパラメーターを構成します。

      説明

      複数のパラメーターを一度に作成するには、ワークスペースのバッチ作成パラメーター をクリックします。

      パラメーター	説明
      パラメーター名	パラメーターのカスタム名を指定します。名前は workspace. で始まる必要があり、かつ一意である必要があります。
      所有者	ワークスペースレベルのパラメーターのオーナーを指定します。 説明 ワークスペース管理者 は、任意のワークスペースメンバーをパラメーターオーナーとして指定できます。 ワークスペース管理者 のみが、ワークスペースレベルのパラメーターを変更または削除できます。 これらの管理操作を行う必要がある場合は、ユーザーをワークスペースに追加し、必要なロールを付与してください。詳細については、「ワークスペースメンバーの追加とロール管理」をご参照ください。
      適用ワークスペース	このパラメーターを使用するワークスペースを選択します。構成後、ワークスペース内のすべてのタスクがこのパラメーターを参照できます。 説明 リストには、現在のユーザーがワークスペース管理者であるワークスペースのみ表示されます。 ワークスペースレベルのパラメーターは、1 つのワークスペースでのみ使用できます。
      パラメータータイプ および パラメーター値	タスク実行時の置換値を定義します。以下の種別がサポートされています。 定数（プレーンテキスト）：すべてのユーザーに表示される固定値。例：123。 定数（暗号化テキスト）：マスクされた固定値（デフォルトで ****** と表示）。機密データに使用します。たとえば、123 を入力すると、****** と表示されます。 変数：システム変数に基づいて動的に生成される値。 たとえば、タスクのスケジュール時刻を取得するには $[yyyy-mm-dd] を、タスク実行時のデータタイムスタンプを取得するには ${yyyy-mm-dd} を値として設定できます。サポートされるフォーマットの詳細については、「スケジューリングパラメーターでサポートされるフォーマット」をご参照ください。 説明 パラメーター値 には特殊文字を使用できます。詳細については、UI 上のプロンプトをご確認ください。 パラメーター値内では、他のワークスペースレベルのパラメーターを参照できません。 標準モードのワークスペースでは、開発環境と本番環境で同一パラメーターに異なる値を設定できます。ワークスペースモードの詳細については、「ワークスペースモードの違い」をご参照ください。

   2. OK をクリックしてパラメーターを作成します。

ワークスペースレベルのパラメーターの使用

ワークスペースレベルのパラメーターを作成後、権限のあるワークスペース内の任意のノードで参照できます。使用方法は標準的なスケジューリングパラメーターと同じです。

1. ノードのコード内で変数を定義します。

2. ノード構成ページで、スケジューリング設定 > スケジューリングパラメータ セクションに移動し、ワークスペースレベルのパラメーターを変数に割り当てます。

構成後、パラメーター値をプレビューして出力を確認し、必要に応じて調整してください。スケジューリングパラメーターの使用方法の詳細については、「スケジューリングパラメーターの構成と使用」をご参照ください。

スケジューリングパラメータ の値入力フィールドをクリックしてポップオーバーを開き、ワークスペースパラメーター タブに切り替えて、目的のワークスペースレベルのパラメーター（例：${workspace.test}）を選択して割り当てを完了します。

ワークスペースレベルのパラメーターの管理

ワークスペースパラメーター ページでは、以下の操作を実行できます。

• パラメーターの表示： パラメーターの詳細、関連付けられたワークスペース、および参照しているタスクを表示できます。タスク ID からタスクに移動して開発操作を実行できます。

• パラメーターの変更：

  • オーナー、値、および説明のみを変更できます。各変更により新しいバージョンが作成されます。

  • パラメーターがタスクから参照されている場合、変更によりそれらのタスクに影響が及びます。慎重に操作してください。

  • 変更は 10 分以内に有効になります。

• バージョンの比較とロールバック：パラメーターのバージョン履歴を表示し、バージョンを比較して以前のバージョンにロールバックできます。

• パラメーターの削除：

  • 他のタスクから参照されているパラメーターは削除できません。

  • パラメーターを削除すると、関連するタスクが失敗します。慎重に操作してください。

  • ワークスペースレベルのパラメーター ページ上では即時に削除されますが、パラメーターを参照しているタスクは最大 10 分間、ランタイムでその値を取得できる場合があります。