tMDMRestInput標準プロパティ - 7.3

MDM data processing

Version
7.3
Language
日本語 (日本)
Product
Talend Data Fabric
Talend MDM Platform
Module
Talend MDM Server
Talend MDM Web UI
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > MDMコンポーネント > MDMデータ処理コンポーネント
データガバナンス > サードパーティーシステム > MDMコンポーネント > MDMデータ処理コンポーネント
データクオリティとプレパレーション > サードパーティーシステム > MDMコンポーネント > MDMデータ処理コンポーネント

このプロパティはStandardジョブフレームワークで実行されているtMDMRestInputを設定するために使います。

Standard tMDMRestInputコンポーネントはTalend MDMファミリーのコンポーネントです。

このコンポーネントは、Talend MDM PlatformおよびTalend Data Fabricで使用できます。

基本設定

[Schema] (スキーマ)[Edit schema] (スキーマを編集)

スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドの数を定義するものです。スキーマは組み込まれるか、リポジトリーにリモートで保存されます。

スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを使用できます。

  • [View schema] (スキーマの表示): スキーマのみを表示する場合は、このオプションを選択します。

  • [Change to built-in property] (組み込みのプロパティに変更): ローカルで変更を行うためにスキーマを組み込みに変更する場合は、このオプションを選択します。

  • [Update repository connection] (リポジトリー接続を更新): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーのコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

 

[Built-In] (組み込み): スキーマは、このコンポーネント専用に作成され、保管されます。詳細は、 Talend Studio ユーザーガイドを参照してください。

 

[Repository] (リポジトリー): スキーマは既に存在し、リポジトリーに保管されています。さまざまなプロジェクトやジョブで再利用できます。詳細は、 Talend Studio ユーザーガイドを参照してください。

[Use an existing connection] (既存の接続を使用)

定義済みのtMDMConnectionコンポーネントを使用する場合は、このチェックボックスをオンにします。

URL

REST APIを介してMDMサーバーにアクセスするためのURLを入力します。

Username (ユーザー名)Password (パスワード)

MDMサーバーのユーザー認証データを入力します。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、[OK] をクリックして設定を保存します。

データコンテナー

読み取るデータを保持しているデータコンテナーの名前を入力します。

Type (タイプ)

[Master] (マスター)または[Staging] (ステージング)を選択して、読み取りアクションを実行するデータベースのタイプを指定します。

[Retrieve raw data] (ロウデータの取得)

必要に応じて、このチェックボックスをオンにして、クエリーされたすべてのデータを単一のフィールドに取得します。

  • [XML field] (XMLフィールド): 取得したデータを書き込む単一のフィールドの名前を選択します。

  • [Accept Type] (タイプを受け入れる): 取得するコンテンツのタイプ(XMLまたはJSON)を選択します。

[Query Text] (クエリーテキスト)

目的のデータレコードを取得するためにREST API呼び出しに含めるクエリーテキストを入力します。これは必須です。

デフォルトのサンプルクエリーを除き、クエリーテキストは次のようになります。

  • globalMap変数、例: ((String)globalMap.get("row1.query"))

  • 事前エスケープされたコンテキスト変数、例: context.lpcMDMRestQuery

  • globalMap変数またはコンテキスト変数を含むクエリー、例: "{'select':{'from':['"+context.myEntity +"'],'fields':[{'field':'"+ (String)globalMap.get("field") +"'}] }}"

クエリーテキストの各JSONフィールドを一重引用符または二重引用符で囲んで指定します。

クエリーテキストのフィールドの値に含まれる単一引用符は、バックスラッシュで二重にエスケープする必要があります。

たとえば、[Product] (製品) エンティティの [Name] (名前) フィールドに [This is Product's name] (これは製品の名前)という値がある場合、この特定の値をフィルタリングするには、次のいずれかの方法でクエリーテキストを記述します。

  • "{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"
  • "{\"select\":{\"from\":[\"Product\"],\"where\":{\"eq\":[{\"field\":\"Product/Name\"},{\"value\":\"This is Product\\'s name\"}]}}}"

クエリーテキストを入力したら、必ずクエリーテキストに基づいてスキーマを正しく設定してください。詳細は、「tMDMRestInputを使う時に、クエリーテキストに基づいてスキーマを正しく設定する方法」を参照してください。

警告: 照会したロウデータをXMLまたはJSON形式で自分で解析する場合にのみ、[Retrieve Raw Data] (ロウデータの取得)チェックボックスをオンにする必要があります。
注: このコンポーネントを使って、繰り返し外部キーエレメントを含むエンティティからデータを取得する場合は、選択クエリーでメインエンティティとリンクされたエンティティの間に結合句を追加する必要があります。

たとえば、Storeという名前の別のエンティティを指す外部キーのコレクションを含むProductという名前のエンティティを考慮し、StoreFKという名前の繰り返し外部キーエレメントのデータを取得する場合は、次のように記述します。

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] 
    }
}

正しくは次のように記述します。

{
   'select':{
        'from':['Product'],
        'fields':[
             {'field':'Product/Id'},
             {'field':'Product/StoreFK'}
         ] ,
         'joins': [
             {
             'from': 'Product/StoreFK',
             'on': 'Store/Id'
             }
          ] 
    }
}

結合句を使う選択クエリーについては、 Talend Help Center (https://help.talend.com)で、MDMクエリー言語とRESTデータアクセスという記事の他のタイプへの結合を参照してください。

[Die on error] (エラー発生時に強制終了)

このチェックボックスをオンにすると、エラーの発生した行がスキップされ、エラーが発生していない行の処理が完了されます。必要に応じて[Row] (行) > [Rejects] (リジェクト)リンクを使ってエラーの発生している行を取得できます。

詳細設定

[Batch Size] (バッチサイズ)

各処理バッチの行数。

現在のクエリーのレコード数がバッチサイズより大きい場合は、レコードにページ番号を付け、バッチごとに取得する必要があります。

[tStatCatcher Statistics] (tStatCatcher統計情報)

このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルで処理メタデータが収集されます。

グローバル変数

[Global Variables] (グローバル変数)

ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、Die on error (エラー時強制終了)がオフになっている場合にのみ機能します。

NB_LINE: 処理された行の数。これはAfter変数で、整数を返します。

Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入れるには、Ctrl + Spaceを押して変数リストにアクセスし、リストから使用する変数を選択します。

変数の詳細は、『 Talend Studio ユーザーガイド』を参照してください。

使用方法

使用ルール

tMDMRestInputは、tMDMConnection、tMDMCommit、MDMRollbackと一緒に使えます。

tMDMRestInputには出力リンクが必要です。