変数の作成

変数は、単一の値(文字列、数値または日付)を格納するオブジェクトです。変数の作成時に変数の値を指定することも、問合せ式を使用して値を設定することもできます。

「変数」ページには、既存のすべての変数がリストされます。変数の「アクション」アイコン(「アクション」アイコン)をクリックして、編集、リフレッシュまたは削除します。使用可能なすべての変数は、「ワークフローの詳細」ページの左パネルにもリストされます。変数は、データ・フローおよびワークフローのステップとして使用できます。

変数を作成するには:

  1. ホームページで、必要なプロジェクト・タイトルをクリックします。「プロジェクト詳細」ページに移動します。
  2. 左ペインで、「変数」をクリックします。変数の作成ページが表示されます。
  3. 変数の名前を入力します。
  4. 「データ型」ドロップダウンから、次のいずれかを選択します:
    • 短いテキスト - 値は英数字にでき、特殊文字を含めることができ、255文字を超えることはできません。
    • 長いテキスト - 値は英数字にでき、特殊文字を含めることができ、64000文字を超えることはできません。
    • 数値 - 値は数値にでき、前にマイナス(-)記号を付けることができます。値は10桁を超えることはできません。指定可能な値の範囲は-999999999から99999999999です。
    • 日付 - 値は日付書式です。
  5. 「デフォルト値」フィールドに、変数に割り当てる値を入力します。許可される値は、選択した「データ型」によって異なります。
  6. 変更する変数の場合は、変数の横にある「アクション」メニューをクリックして、「変数のリフレッシュ」ページを開き、値を更新できます。「履歴の保持」ドロップダウンから、変数のリフレッシュ・ページでの変数値の表示方法を選択します:
    • すべての値 - この変数が所有するすべての値の履歴を表示できます。
    • 最新の値 - 変数に指定された最新の値のみを表示できます。
    • 履歴なし - データ変換では、この変数が保持する値の履歴は保持されません。
    • セキュアな値 - これは、変数にパスワードやその他の機密データが含まれている場合に便利です。値は、変数のリフレッシュ ページに表示されません。
  7. 変数の説明を入力します。
  8. 問合せによって変数値を設定する場合は、「リフレッシュ」タブをクリックします。コマンドを実行する接続タイプとスキーマを選択します。問合せを入力し、「検証」をクリックして式の構文をチェックします。
  9. 「保存」をクリックします

    新しく作成した変数は、「ワークフローの詳細」ページの左パネルの「変数」ノードだけでなく、「変数」ページにリストされます。

データ・フローでの変数の使用

データ・フロー内の変数は、#<variable_name>という形式を使用して参照できます。実行中、変数は値で置換されます。

次に、データ・フローでの変数の使用例を示します。


variables_in_data_flows.pngの説明が続きます

この例では、データ・フローは、次のようにフィルタ条件が設定されたステップとして変数DEVICE_TYPEを使用します。

MOVIESALES_CA.DEVICE = '#DEVICE_TYPE'

置換値を引用符で囲む必要があるため、変数は引用符で囲みます。変数値は実行中に置換されるため、マッピングの変換式など、多くのユースケースに使用できます。

ワークフローでの変数の使用

「ワークフローの詳細」ページの左パネルには、ワークフロー内のステップとして使用できる変数がリストされます。

使用する変数を設計キャンバスのワークフローにドラッグ・アンド・ドロップできます。デザイン・キャンバスの右側にある「プロパティ」パネルには、次のようなステップに関する様々な詳細が表示されます。
  • 「名前」「タイプ」および「ステップ」シーケンス番号。これらは編集できない値です。
  • 「リンクされたオブジェクト」の下にあるリンクをクリックして、変数の詳細を表示および更新します。
  • 操作: 次のいずれかを選択します:
    • 変数の設定 - このステップには2つの機能があります:

      更新では、変数の現在の値を設定します。

      増分では、指定された量ずつ数値を増減します。

    • 変数のリフレッシュ - この変数ステップは、変数定義に指定されている問合せを実行して変数をリフレッシュします。
    • 変数の評価: この変数ステップ・タイプは、変数の値と指定された値を演算子に従って比較します。条件を満たすと、評価ステップはtrueとなり、それ以外の場合はfalseとなります。
  • 失敗時の試行回数
  • 試行間隔(秒)
  • ジャーナルにステップをログ - 「常に」、「なし」または「エラー」から選択できます。

次に、ワークフローでの変数の使用例を示します:


variables_in_workflows.pngの説明が続きます

この例では、値iphoneを持つDEVICE _TYPEという変数がワークフローのステップとして使用されます。ワークフローでは、次の処理が実行されます。

  1. REFRESH_DEVICEデータ・フローを実行します。
  2. REFRESH_DEVICEデータ・フローの実行に成功した場合は、Load_movies_for_deviceデータ・フローを実行します。
  3. 「Load_movies_for_device」データ・フローの実行が成功した場合は、「IF_IPHONE」変数評価ステップを実行します。
  4. 変数値が'iphone'の場合は、trueのパスを実行します。
  5. 変数値が'iphone'と等しくない場合は、falseのパスを実行します。