tSalesforceOutputBulkExecの標準プロパティ - Cloud - 8.0

[Property Type] (プロパティタイプ)

接続の詳細を設定する方法を選択します。

• [Built-In] (組み込み): このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。

• [Repository] (リポジトリー): [Repository] (リポジトリー) > [Metadata] (メタデータ)で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。

  このチェックボックスの横にある [...] ボタンをクリックし、表示された [Repository Content] (リポジトリーのコンテンツ)ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。

[Connection Component] (接続コンポーネント)ドロップダウンリストから、他の接続コンポーネントを選択した場合、このプロパティは、利用できません。

[Connection Component] (接続コンポーネント)

このコンポーネントで再利用するデータベース接続を開くコンポーネントを選択します。

[Connection type] (接続タイプ)

ドロップダウンリストから、接続のタイプを選択します。接続のプロパティは、選択した接続タイプによって異なります。

• [Basic] (基本): Salesforceのユーザー名とパスワードを入力してSalesforceにアクセスするには、このオプションを選択します。

• OAuth: OAuth (Open Authorization) 2.0プロトコルを使ってSalesforceにアクセスし、OAuth 2.0認証フロータイプとして[Json Web Token Flow] (Json Webトークンフロー)を使ってユーザーを認証するには、このオプションを選択します。このオプションを使用するためには、Salesforceで接続アプリケーションを作成し、Salesforce認証プロバイダーを設定する必要があります。

  OAuth認証フローの詳細は、Authenticate Apps with OAuthをご覧ください。

  Salesforceで接続アプリケーションを作成する方法は、接続アプリケーションを作成をご覧ください。

[User Id] (ユーザーID)

Salesforceのユーザー名。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Password] (パスワード)

ユーザー名に関連付けられたSalesforceのパスワード。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Security Token] (セキュリティトークン)

Salesforceのセキュリティトークン。詳細は、セキュリティトークンのリセットをご覧ください。

このプロパティは、[Basic] (基本)接続タイプが選択されている場合のみ利用できます。

[Mutual authentication] (相互認証)

このオプションを選択すると、Salesforceへの接続を確立するための相互認証を有効にできます。Salesforceでの相互認証の詳細は、Set Up a Mutual Authentication Certificateをご覧ください。

このオプションを使用する場合:

デフォルトでは、このオプションは選択されていません。

[Mutual auth keystore] (相互認証キーストア) (非推奨)

相互認証Keystoreファイル(キーと証明書を含むパスワードで保護されたファイル)へのパスを入力します。

このオプションは非推奨です。tSetKeystoreコンポーネントを使って相互認証キーストアとキーストアパスワードを提供することをお勧めします。

このオプションは、接続タイプが[Basic] (基本)で、[Mutual authentication] (相互認証)チェックボックスがオンになっている時に利用できます。

[Mutual auth keystore password] (相互認証Keystoreパスワード)

相互認証Keystoreファイルのパスワードを入力します。

このオプションは、接続タイプが[Basic] (基本)で、[Mutual authentication] (相互認証)チェックボックスがオンになっている時に利用できます。

[Issuer] (発行者)

接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーキー。詳細は、接続アプリケーションを作成をご覧ください。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Subject] (件名)

Salesforceのユーザー名。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Audience] (オーディエンス)

Json Webトークンのオーディエンス。

独自のJson Webトークンオーディエンスを設定できます。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Expiration time (in seconds)] (有効期限(秒))

5分以内のアサーションの有効期限(秒)。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Key store] (キーストア)

Java KeyStore (JKS)形式のキーストアファイルへのパス。

Keystoreファイルは、Salesforceによって署名された証明書を作成し、それをKeystoreにエクスポートすることで生成できます。詳細は、自己署名証明書の生成をご覧ください。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[KeyStore password] (KeyStoreパスワード)

Keystoreのパスワード。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Certificate alias] (証明書の別名)

Salesforceによって署名された証明書の一意の名前。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[Client Id] (クライアントID)

接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーキー。詳細は、接続アプリケーションを作成をご覧ください。

このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。

[Client Secret] (クライアントシークレット)

接続アプリケーションが作成され、Salesforceの接続アプリケーションの詳細ページに表示される時に生成されるOAuthコンシューマーシークレット。詳細は、接続アプリケーションを作成をご覧ください。

このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。

[Callback Host] (コールバックホスト)

接続アプリケーションの作成中に定義され、Salesforceの接続アプリケーション詳細ページのAPI (OAuth設定の有効化)エリアに表示されるOAuth認証コールバックURLのホスト値。

このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。

[Callback Port] (コールバックポート)

接続アプリケーションの作成中に定義され、Salesforceの接続アプリケーション詳細ページのAPI (OAuth設定の有効化)エリアに表示されるOAuth認証コールバックURLのポート値。

このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。

[Token File] (トークンファイル)

認証なしでのアクセストークンの取得に使う更新トークンを保管するトークンファイルへのパス。

このプロパティは、[Implicit Flow] (Implicitフロー)タイプが選択されている場合のみ利用できます。

[Module Name] (モジュール名)

フィールドの横にある[...]ボタンをクリックし、表示されたダイアログボックスで、使われるモジュールを選択します。または、[Use custom object] (カスタムオブジェクトの使用)チェックボックスをオンにして、[Object Name] (オブジェクト名)フィールドにモジュール名を指定します。

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

スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

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

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

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

• [Update repository connection] (リポジトリー接続をアップデート): リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。

  変更を現在のジョブにのみ反映する場合は、変更後、[No] (いいえ)を選択し、[Repository Content] (リポジトリーコンテンツ)ウィンドウで再びこのスキーマのメタデータを選択します。

ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、ダイナミックスキーマをご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。

[Output Action] (出力アクション)

ドロップダウンリストから、実行する次のいずれかの操作を選択します。

• [INSERT] (インサート): 1つ以上の新しいレコードをSalesforceに挿入します。

• [UPDATE] (アップデート): Salesforceの1つ以上の既存のレコードをアップデートします。

• [UPSERT] (アップサート): 新しいレコードを作成するか、既存のレコードをアップデートします。表示された[Upsert Key Column] (アップサートキーカラム)フィールドにアップサート操作のキーカラムを指定します。[Output upsert column] (アップサートカラムの出力)を選択すると、UpsertColumnValueという名前のカラムが出力スキーマに追加されます。このカラムにはアップサートキーの値が保持されるため、アップサートキーの監視に使えます。アップサートキーが変数の場合は、[Output upsert column] (アップサートカラムの出力)を選択できます。

• [DELETE] (削除): Salesforceで1つ以上のレコードを削除します。

[Bulk File Path] (バルクファイルパス)

処理するデータを保管するファイルへのパスを指定します。

[Append] (追加)

このチェックボックスを選択すると、ファイルが既に存在する場合は、既存のデータが上書きされるのではなく、ファイルの末尾に新しいデータが追加されます。

[Ignore Null] (Nullを無視)

NULL値を無視する場合は、このチェックボックスを選択します。

Salesforce URL

Salesforceへの接続に必要なWebService URL。

[API version] (APIバージョン)

Salesforce APIバージョン。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

圧縮が必要

SOAPメッセージ圧縮を有効にする場合は、このチェックボックスを選択します。これにより、パフォーマンスが向上する場合があります。

[Trace HTTP message] (HTTPメッセージをトレース)

コンソールでのHTTPインタラクションを出力する場合は、このチェックボックスを選択します。

[Client Id] (クライアントID)

Salesforce Webサイトへのアクセスに同じアカウントとパスワードを使うユーザーを区別するには、実際のユーザーのIDを入力します。

[Timeout] (タイムアウト)

Salesforceでクエリータイムアウトの予定数をミリ秒で入力します。

[Use Proxy] (プロキシを使用)

SOCKSプロキシサーバーを使う場合は、このチェックボックスをオンにして、表示された[Host] (ホスト)、[Port] (ポート)、[User Id] (ユーザーID)、[Password] (パスワード)フィールドで、SOCKSプロキシサーバーの接続パラメーターを指定します。

[Bulk API V2] (バルクAPI V2)

このチェックボックスを選択し、バルクAPI V2ジョブを作成してから、CSVデータ用に、[Column Delimiter] (カラム区切り)ドロップダウンリストから、フィールド区切りのタイプを、[Line Ending] (行末)ドロップダウンリストから、行末処理の方法をそれぞれ選択します。

Bulk API V1と比べると、Bulk API v2ではデータの処理方法が簡素化されています。

このプロパティは、OAuth接続タイプが選択されている場合のみ利用できます。

[+]ボタンをクリックして、必要に応じて行を追加し、入力フローの外部IDフィールド、アップサートモジュールのルックアップリレーションシップフィールド、ルックアップモジュール、ルックアップモジュールの外部IDフィールドを指定します。

• [Column name of Talend Schema] (Talendスキーマのカラム名): 入力フローの外部IDフィールドの名前。これは、先行コンポーネントのスキーマのフィールドを参照しています。このカラムは、[External id name] (外部ID名)カラムで指定された外部IDフィールド([Module name] (モジュール名)カラムで指定されたルックアップモジュールのフィールド)と照合することを目的としています。

• [Lookup relationship field name] (ルックアップリレーションシップフィールド名): ルックアップリレーションシップフィールドの名前。これは、[Basic settings] (基本設定)ビューの[Module Name] (モジュール名)フィールドで指定されたモジュールのルックアップリレーションシップフィールドを参照し、このテーブルの[Module name] (モジュール名)カラムで指定されたルックアップモジュールとのリレーションシップを確立することを目的としています。組み込みリレーションシップフィールドとカスタムリレーションシップフィールドを入力できます。ルックアップリレーションシップフィールドを定義する方法、および[Lookup relationship field name] (ルックアップリレーションシップフィールド名)フィールドに正しい名前を入力する方法は、Salesforce Webサイトにアクセスし、Salesforce Data Loaderアプリケーションを起動して適切なアクションと情報を入手してください。

• [Module name] (モジュール名): ルックアップモジュールの名前。

• [Polymorphic] (ポリモーフィック): リレーションシップマッピングにポリモーフィックフィールドが使われている場合のみ、このチェックボックスを選択します。このチェックボックスをポリモーフィックフィールドに対してオフのままにするか、ポリモーフィックではないフィールドに対してオンにすると、エラーが発生します。ポリモーフィックフィールドの詳細は、http://www.salesforce.com/us/developer/docs/api_asynch/でpolymorphicを検索してください。

• [External id name] (外部ID名): [Module name] (モジュール名)カラムで指定されたルックアップモジュールの外部IDフィールドの名前。

このプロパティは、[Output Action] (出力アクション)ドロップダウンリストから、[UPSERT] (アップサート)が選択されている場合のみ利用できます。

[Concurrency Mode] (同時モード)

ジョブの同時モードを選択します。

• [Parallel] (並列): バッチを並列モードで処理します。

• [Serial] (シリアル): バッチをシリアルモードで処理します。

[Rows to Commit] (コミットする行数)

処理するデータバッチごとの行数を指定します。

[Bytes to Commit] (コミットするバイト数)

処理するデータバッチごとのバイト数を指定します。

[Wait Time Check Batch State] (バッチ状態確認の待機時間)

すべてのバッチが最終的に処理されるまで、ジョブ内のバッチが処理されたかどうかを確認するための待機時間(ミリ秒)を指定します。

クエリーするモジュールのカラムの長さが100,000文字を超える場合は、このチェックボックスをオフにします。デフォルトでは、このチェックボックスは過剰なメモリ使用を防ぐためにオンになっています。

このプロパティは、[Query Mode] (クエリーモード)ドロップダウンリストから、[Bulk] (バルク)またはBulkV2が選択されている場合に利用できます。

[tStatCatcher Statistics] (tStatCatcher統計)

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

ERROR_MESSAGE

エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。

使用ルール

このコンポーネントは、Salesforceにロードするデータが特定の変換を必要としない場合に主に使います。

制限事項

Salesforceで処理されるバルクデータは.csv形式である必要があります。