データ・フロー・パラメータの使用

式でパラメータを使用すると、設計時または実行時に異なる値で式を柔軟に再利用できます。

式を使用する演算子を構成するときには、データ・フロー・レベルで式にパラメータを追加します。式パラメータ(スカラー・パラメータとも呼ばれる)は、フィルタ演算子、結合演算子、参照演算子、分割演算子、式演算子および集計演算子に適用できます。演算子に応じて式ビルダーか条件ビルダーのどちらかを使用して、式パラメータを追加します。

演算子に追加した式パラメータはデータ・フローに保存され、データ・フロー内の該当する他の演算子に対して使用できるようになります。

式パラメータは名前とデフォルト値を持ち、データ型に関連付けられています。次の型がサポートされています。

• NUMERIC
• VARCHAR
• DATE
• DATETIME
• DECIMAL
• DOUBLE
• FLOAT
• INTEGER
• TIMESTAMP
• TINYINT
• BOOLEAN
• LONG
• STRING

式パラメータを作成した後は、パラメータの名前または型を変更できません。また、型によっては他のどのプロパティも変更できません。変更できるのはデフォルト値のみです。デフォルト値は、設計時および実行時に変更できます。

たとえば、次の式をデータ・フロー内の条件フィルタに使用するとします。

FILTER_1.COUNTRIES.CITY='Redwood Shores'

CITYに明示的な値を指定するかわりに、式でパラメータを使用できます。VARCHAR式パラメータ(P_VARCHARなど)を作成し、デフォルト値をRedwood Shoresに設定するとします。その後、この式パラメータを使用するように条件フィルタを編集できます:

FILTER_1.COUNTRIES.CITY=$P_VARCHAR

設計時には、そのデータ・フローを使用する統合タスクを作成するときに、P_VARCHARのデフォルト値を変更できます。実行時には、統合タスク内に設定されているデフォルト値を使用することも、値を編集することもできます。

データ・フローに追加した式パラメータはすべて、「パラメータ」パネルで使用できます。

システム・パラメータには、名前とタイプがあります。システム・パラメータの値はバインドできますが、値を変更することはできません。

データ・フロー内の式演算子に式を追加するときに、「式ビルダー」の「パラメータ」タブを使用して、システム・パラメータのリストを参照します。式でシステム・パラメータを使用すると、システム情報を記録できます。

次の表に、使用できるシステム・パラメータを示します。

ノート: OCID値はSTRINGです。

データ・フローにソース演算子またはターゲット演算子を構成する場合、${PARAMETER_NAME}構文を使用して、データ・エンティティ名に1つ以上のパラメータを含めることができます。

パラメータ名では大文字と小文字が区別され、使用する各パラメータにはデフォルト値が必要です。

たとえば、CUSTOMERS_${COUNTRY}がデータベース表CUSTOMERS_USAを返し、BANK_${COUNTRY}/*がBANK_EUのオブジェクト・ストレージ・ファイルを返すことがあります。

データ・エンティティ名でパラメータを使用するには、データ演算子を追加する前にデータ・フローにパラメータを追加できます。演算子のデータ・エンティティを構成するときにパラメータを追加することもできます。

• データ・フローにパラメータを追加するには、データ・フローで、キャンバス・ツールバーの「表示」メニューから「パラメータ」を選択して「パラメータ」パネルを開きます。

  「パラメータ」パネルで、「構成」をクリックし、「追加」をクリックします。

  「パラメータの追加」パネルで、適切なデータ型(VARCHARやNUMERICなど)のパラメータを構成し、デフォルト値を追加します。

• データ・エンティティ構成時にパラメータを追加するには(「データ・エンティティの参照」パネル):

  • 「その他のアクション」メニューから、「データ・フロー・パラメータの追加」を選択します。

  • 検索フィールドに、${に続けて任意の文字を入力します。パラメータ名の先頭部分がデータ・フロー内の既存パラメータと一致すると、候補名のリストが表示されます。リストからパラメータを選択するには、パラメータ名をクリックし、}を追加して構文を完了してから、[Enter]を押します。

  • 検索フィールドにパラメータ名を入力します。そのパラメータ名がデータ・フローにまだ存在していない場合は、[Enter]を押すと、データ統合に「データ・フロー・パラメータの追加」パネルが表示されます。または、パラメータ名を入力した後、「その他のアクション」メニューから「データ・フロー・パラメータの追加」を選択します。

    「データ・フロー・パラメータの追加」パネルで、追加して使用するパラメータのデータ型、デフォルト値およびその他のプロパティを指定します。

  ソース演算子のオブジェクト・ストレージの場合のみ: オブジェクト・ストレージ・データ・アセットを使用するソース演算子に対してデータ・エンティティを構成するときは、パラメータとファイル・パターンを使用できます。「データ・エンティティをパターンで参照」パネルで、パラメータおよびパターンを使用して式を入力し、1つ以上のエンティティを選択します。例: ADDRESSES_${STATE}/*

データ・フローの「パラメータ」パネルには、データ・フロー全体で定義されているパラメータが表示されます。

「パラメータ」パネルを使用して、次のものを表示します:

• データ・フローで使用されるデータ・アセット、接続、スキーマまたはバケット、データ・エンティティに対して作成されたすべてのパラメータ。
• フィルタ、結合、ルックアップなどの整形演算子に対して作成されたすべてのパラメータ
• 式演算子、集計演算子および整形演算子(フィルタ、結合、ルックアップ、分割など)に対して作成されたすべての式パラメータ。
• データ・フローのデータ・エンティティ名に対して作成されたすべてのデータ・フロー・パラメータ。

デザイナ・キャンバスでデータ・フローを開いたときに「パラメータ」パネルにアクセスするには、キャンバス・ツールバーの「表示」メニューから「パラメータ」を選択します。

「パラメータ」パネルには、「表示」と「構成」の2つのタブがあります。どちらのタブでも、パラメータの完全名を入力して、リストを検索できます。

「表示」タブでは、次を行うことができます:

• データ・フロー内に作成されたパラメータを表示します。パラメータがオブジェクトに割り当てられているかどうかは関係ありません。「使用先」の横に値が表示されていれば、パラメータが割り当てられています。
• 各パラメータの詳細を縮小および展開します。
• 割り当てられたパラメータの「使用先」リンクをクリックします。そのパラメータを参照する演算子が、キャンバスおよび「プロパティ」パネル(「詳細」タブ)でフォーカスして表示されます。

「構成」タブでは、次を行うことができます:

• 式パラメータおよびデータ・フロー・パラメータを追加します。「追加」をクリックし、表示される「パラメータの追加」パネルを使用してパラメータを定義します。
• パラメータのデフォルト値を変更します。パラメータのアクション・メニューで「編集」を選択し、「パラメータの編集」パネルを使用して値を編集します。
• 1つ以上のパラメータを削除します。パラメータの削除を参照してください。