Dataphin では、グローバル変数を作成できるため、冗長な定義を排除し、メンテナンス作業を削減することで、タスクコードを合理化できます。 これらのグローバル変数には、権限制御とコードレビュー機能が含まれており、セキュリティが強化されています。 このトピックでは、変数グループとグローバル変数の作成方法について説明します。
変数グループの作成
変数グループは、変数を整理して、管理と取得を簡素化します。
Dataphin ホームページの上部にあるメニューバーで、[計画] > [共通ビジネスロジック] を選択します。
[共通ビジネスロジック] ページで、[グローバル変数] タブをクリックします。
[グローバル変数] タブで、[変数グループの作成] をクリックして、[変数グループの作成] ダイアログボックスを開きます。
[変数グループの作成] ダイアログボックスで、以下の表に示すように、[変数グループ名] と [変数グループコード] を入力します。
パラメーター
説明
変数グループ名
変数グループ名をカスタマイズします。 名前は次の要件を満たしている必要があります。
グローバルに一意である必要があります。
長さは 64 文字を超えることはできません。
変数グループコード
変数グループの一意性を検証するために使用される変数グループコードをカスタマイズします。 コードは次の要件を満たしている必要があります。
グローバルに一意である必要があります。
数字、文字、およびアンダースコアのみを含めることができます。
長さは 64 文字を超えることはできません。
[OK] をクリックして、変数グループの作成を完了します。
グローバル変数の作成
[グローバル変数] タブで、[グローバル変数の作成] をクリックします。
[グローバル変数の作成] ダイアログボックスで、グローバル変数パラメーターを構成します。
システムは、[共通変数]、[日付と時刻]、[アカウントパスワード] の 3 つの変数タイプをサポートしています。 各タイプには、異なる構成要件があります。 各変数タイプのパラメーターは、次のように説明されています。
共通変数とアカウントパスワード
パラメータ
説明
基本情報
変数名
変数名をカスタマイズします。 64 文字を超えることはできません。
変数グループ
デフォルトは [デフォルト変数グループ] です。 ドロップダウンリストをクリックして、他の変数グループを選択できます。
コード
変数の参照名として機能するコードをカスタマイズします。これは、固定プレフィックス dp_glb から始まります。コードは次の要件を満たしている必要があります。
グローバルに一意である必要があります。
数字、文字、およびアンダースコア（_）のみを含めることができます。
長さは 64 文字（dp_glb_ の全長を含む）を超えることはできません。
説明コードでは大文字と小文字は区別されません。大文字は自動的に小文字に変換されます。
権限管理
有効になっている場合、作成されたグローバル変数が初めて参照されるときに権限をリクエストする必要があります。
コードレビュー
有効になっている場合、コードレビュー担当者を指定できます。このグローバル変数がコード内で参照されている場合、コードレビュー担当者は送信を承認する必要があります。
説明
説明をカスタマイズします。これはグローバル変数のメモ情報です。
変数値
本番環境と開発環境の分離
無効: 本番環境と開発環境は同じ変数値を使用します。
有効: 本番環境と開発環境に対して異なる値を設定できます。開発値は、開発環境でのデバッグ中に使用されます。本番値は、スケジュールされた本番実行と手動操作で使用されます。
変数値
本番環境または開発環境の変数値を設定します。値は大文字と小文字が区別されます。
[共通変数]: 512 文字を超えることはできません。
[アカウントパスワード]: 5000 文字を超えることはできません。
日付と時刻
パラメータ
説明
基本情報
変数名
変数名をカスタマイズします。 64 文字を超えることはできません。
コード
変数の参照名として機能するコードをカスタマイズします。固定プレフィックス dp_glb で始まります。コードは次の要件を満たしている必要があります。
グローバルに一意である必要があります。
数字、文字、およびアンダースコア（_）のみを含めることができます。
長さは 64 文字を超えることはできません（dp_glb_ の全長を含みます）。
説明コードは大文字と小文字を区別しません。大文字は自動的に小文字に変換されます。
変数グループ
デフォルトは デフォルト変数グループ です。ドロップダウンリストをクリックして、他の変数グループを選択できます。
権限管理
有効にすると、作成されたグローバル変数が最初に参照されるときに権限をリクエストする必要があります。
コードレビュー
有効にすると、コードレビュー担当者を指定できます。このグローバル変数がコードで参照されている場合、コードレビュー担当者は送信を承認する必要があります。
説明
説明をカスタマイズします。これは、グローバル変数のメモ情報です。
変数値
本番環境と開発環境の分離
無効：本番環境と開発環境は同じ変数値を使用します。
有効：本番環境と開発環境に異なる値を設定できます。開発値は、開発環境でのデバッグ中に使用されます。本番値は、スケジュールされた本番実行と手動操作中に使用されます。
基準日タイプ が データタイムスタンプ（bizdate-yyyymmdd） に設定されている
すべてのノードに適用されます。
変数出力フォーマット：日付と時刻の変数の計算後の結果値のフォーマット。ドロップダウンリストをクリックして、次のフォーマットから選択します。
yyyyMMdd：
YYYYMMDD。たとえば、20220604 です。yyyy-MM-dd：
年-月-日。たとえば、2022-06-04 です。yyyy/MM/dd：
年/月/日。たとえば、2022/06/04 です。yyyyMMddHHmmss：
YYYYMMDDHHMMSS。たとえば、20220604000000 です。yyyy-MM-dd HH:mm:ss：
年-月-日 時:分:秒。たとえば、2022-06-04 00:00:00 です。unixtimestamp：UNIX タイムスタンプ。 1970 年 1 月 1 日 00:00:00 からの経過秒数を表します。たとえば、2022-06-04 00:00:00 を UNIX タイムスタンプに変換すると、1654272000 と表示されます。
クイック日付選択：よく使用される変数日付。
クイック日付選択 を設定した後、対応する計算ロジックが 変数日付 に自動的に入力されます。 変数日付 設定をカスタマイズすることもできます。
プレビュー基準日：変数値のプレビュー時に使用される基準日。構成効果のプレビューにのみ使用されます。
変数日付：基準日をインプットとして使用し、年、四半期、月、週、日 のディメンションでオフセットを実行することにより、変数の計算ロジックを定義します。
オフセット時間追加 が有効になっている場合、各行の計算の入力日付は、前の行の計算の出力日付です。
変数日付 を構成した後：
日付プレビュー で、この行の計算から得られた日付を表示できます。
変数出力フォーマット で、選択した 変数出力フォーマット に従って表示される、この行の計算後の変数値を表示できます。
基準日タイプ が 営業時間（bizdatetime-yyyymmddhhmmss） に設定されている
時間または分でスケジュールされたノードにのみ使用されます。
変数出力フォーマット：日付と時刻の変数の計算後の結果値のフォーマット。ドロップダウンリストをクリックして、次のフォーマットから選択します。
yyyyMMdd：
YYYYMMDD。たとえば、20220604 です。yyyy-MM-dd：
年-月-日。たとえば、2022-06-04 です。yyyy/MM/dd：
年/月/日。たとえば、2022/06/04 です。yyyyMMddHHmmss：
YYYYMMDDHHMMSS。たとえば、20220604000000 です。yyyy-MM-dd HH:mm:ss：
年-月-日 時:分:秒。たとえば、2022-06-04 00:00:00 です。unixtimestamp：UNIX タイムスタンプ。 1970 年 1 月 1 日 00:00:00 からの経過秒数を表します。たとえば、2022-06-04 00:00:00 を UNIX タイムスタンプに変換すると、1654272000 と表示されます。
クイック日付選択：よく使用される変数日付。
クイック日付選択 を設定した後、対応する計算ロジックが 変数日付 に自動的に入力されます。 変数日付 設定をカスタマイズすることもできます。
プレビュー基準時刻：変数値のプレビュー時に使用される基準時刻。構成効果のプレビューにのみ使用されます。
変数日付：基準日をインプットとして使用し、年、四半期、月、週、日 のディメンションでオフセットを実行することにより、変数の計算ロジックを定義します。
オフセット時間追加 が有効になっている場合、各行の計算の入力日付は、前の行の計算の出力日付です。
変数日付 を構成した後：
日付プレビュー で、この行の計算から得られた日付を表示できます。
[変数出力形式] では、この行の計算後の変数の値を、選択した [変数出力形式] に従って表示できます。
クイック時刻選択：クイック時刻選択 を設定した後、対応する計算ロジックが 変数時刻 に自動的に入力されます。 変数時刻 設定をカスタマイズすることもできます。
変数時刻：基準日をインプットとして使用し、日、時、分、秒 のディメンションでオフセットを実行することにより、変数の計算ロジックを定義します。
オフセット時間追加 が有効になっている場合、各行の計算の入力日付は、前の行の計算の出力日付です。
変数時刻 を構成した後：
時刻プレビュー で、この行の計算から得られた時刻を表示できます。
変数出力フォーマット で、選択した 変数出力フォーマット に従って表示される、この行の計算後の変数値を表示できます。
[OK] をクリックして、グローバル変数の作成を完了します。
変数グループとグローバル変数を管理する
変数グループでサポートされている操作
デフォルト変数グループは、編集または削除の操作をサポートしていません。
変数が含まれている 変数グループは、編集または削除操作をサポートしていません。
操作 | 説明 |
編集 | 変数グループの名前とコードを編集します。
|
削除 | 対象の変数グループの [アクション] 列（グローバル変数リストの最後の列）にある [削除] アイコンをクリックして、現在の変数グループを削除します。 |
グローバル変数でサポートされている操作
システム変数 は、操作をサポートしていません。
操作 | 説明 |
検索 | 検索バーにキーワードを入力すると、システムは自動的に変数名、コード、および値/計算ロジック（アカウントパスワードタイプの変数の値を除く）を照合し、関連するグローバル変数をフィルタリングします。 |
編集 | 対象のグローバル変数の [アクション] 列（グローバル変数リストの最後から2番目の列）にある [編集] アイコンをクリックして、[グローバル変数の編集] ダイアログボックスを開きます。ダイアログボックスで、関連するパラメーターを編集します。パラメーターの構成は、新しいグローバル変数を作成する場合と同じです。詳細については、「グローバル変数を作成する」をご参照ください。編集が完了すると、新しいバージョンが生成されます。 説明
|
依存関係の表示 | 現在のグローバル変数を参照し、送信済みのすべての統合ノードと計算ノードを表示します。
|
削除 | 重要 依存関係のない グローバル変数のみ削除できます。削除された変数は回復できません。ご注意ください。 対象のグローバル変数の [アクション] 列（グローバル変数リストの最後から2番目の列）にある [削除] アイコンをクリックします。表示されるダイアログボックスで、[確認] をクリックして削除を完了します。 |
バージョン履歴の表示 | 対象のグローバル変数の [アクション] 列（グローバル変数リストの最後から2番目の列）にある [バージョン履歴の表示] アイコンをクリックします。[バージョン履歴の表示] ダイアログボックスで、[バージョン番号]、[送信者]、[送信日時]、[値/計算ロジック]、および [説明] を含むバージョンリストを表示できます。対象のバージョンの [アクション] 列にある [バージョンの比較] または [バージョンのロールバック] アイコンをクリックして、対応する操作を実行できます。
|
権限のリクエスト | 対象のグローバル変数の [アクション] 列（グローバル変数リストの最後から2番目の列）にある [詳細] アイコンをクリックし、[権限のリクエスト] を選択します。[変数権限のリクエスト] ダイアログボックスにリダイレクトされます。関連するパラメーター構成を入力して、権限リクエストを完了します。詳細については、「変数権限のリクエスト、更新、および返却」をご参照ください。 |