# tSalesforceEinsteinBulkExec

ローカルファイルからSalesforce Analytics Cloudにデータをロードします。

## tSalesforceEinsteinBulkExecの標準プロパティ

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

標準のtSalesforceEinsteinBulkExecコンポーネントは、ビジネスファミリーとCloudファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| プロパティタイプ | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br><ul> <li> <span>[Built-In] (組み込み)</span>: 一元的に保存されるプロパティデータはありません。</li> <li> <span>[Repository] (リポジトリー)</span>: プロパティが保管されるリポジトリーファイルを選択します。続く接続フィールドは、取得されたデータを使って自動的に入力されます。</li> </ul> |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。<br><br>ジョブに親ジョブと子ジョブが含まれている場合、[Component List] (コンポーネントリスト)には同じジョブレベルの接続コンポーネントのみが表示されます。 |
| [User Name] (ユーザー名)と[Password] (パスワード) | Webサービス認証の詳細を入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [End Point] (エンドポイント) | Salesforceへの接続に必要なWebService URLを入力します。たとえば*https://login.salesforce.com/services/Soap/u/37.0*です。URLのバージョンは32.0以降である必要があります。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p>数値型のフィールド(たとえば、byte、short、int、long、float、double、BigDecimal)の場合、フィールドの長さと精度の値を指定する必要があります。デフォルトの長さと精度の値は<em>10</em>と<em>2</em>で、スキーマエディターでそれらのカスタム値を指定することもできます。</p> </li> <li> <p>日付型のフィールドの場合、スキーマエディターで日付の形式を指定する必要があります。サポートされている日付形式の詳細は、<a href="http://www.salesforce.com/us/developer/docs/bi_dev_guide_ext_data_format/bi_dev_guide_ext_data_format.pdf" target="_blank">Analytics Cloud External Data Format Reference</a>をご覧ください。</p> </li> </ul><br><br>[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスをオンにすると、[Schema] (スキーマ)リストと[Editor schema] (エディタースキーマ)ボタンが非表示になります。<br><br>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。<br><br>ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。<br><br>[Built-in] (組み込み): そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。<br><br>[Repository] (リポジトリー): スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| [Operation] (操作) | データセットに対して実行する操作を選択します。<br><br><ul> <li> <p> <span>[Append] (追加)</span>: すべてのデータをデータセットに追加します。データセットが存在しない場合は作成します。</p> </li> <li> <p> <span>[Upsert] (アップサート)</span>: データセットの行を挿入またはアップデートします。データセットが存在しない場合は作成します。</p> </li> <li> <p> <span>[Overwrite] (上書き)</span>: 指定されたデータで新しいデータセットを作成し、データセットが既に存在する場合はそれを置き換えます。</p> </li> <li> <p> <span>[Delete] (削除)</span>: データセットから行を削除します。</p> </li> </ul><br><br>情報メモ注:<br><br><ul> <li> <p><span>[Append] (追加)</span>、<span>[Upsert] (アップサート)</span>、<span>[Delete] (削除)</span>操作には、メタデータJSONファイルが必要です。</p> </li> <li> <p><span>[Append] (追加)</span>および<span>[Upsert] (アップサート)</span>操作のデータとメタデータは、操作が発生しているデータセットと一致している必要があります。すべてのカラム、ディメンション、メジャーが完全に一致する必要があります。 </p> </li> <li> <p>プライマリキーとしてカラムを指定した場合、<span>[Append] (追加)</span>操作は許可されません。</p> </li> <li> <p><span>[Upsert] (アップサート)</span>または<span>[Delete] (削除)</span>操作の対象となるプライマリキーとして、カラムを1つだけ指定する必要があります。それには、<span>[Edit schema] (スキーマを編集)</span>をクリックし、プライマリキーに指定するカラムの横にあるチェックボックスをオンにします。</p> </li> <li> <p><span>[Delete] (削除)</span>操作のメタデータは、データセットカラムのサブセットである必要があります。</p> </li> </ul> |
| [Name] (名前) | データが読み取られるデータセットの名前を入力します。 |
| [CSV File] (CSVファイル) | ロードするローカルCSVファイルへのパスを指定します。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [CSV Encoding] (CSVエンコーディング) | CSVファイルのエンコーディングタイプを入力します。<br><br>このフィールドは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合には表示されません。 |
| [Fields Delimiter] (フィールド区切り) | CSVファイルのフィールド値を区切る文字を入力します。<br><br>このフィールドは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合には表示されません。 |
| [Fields Enclosed By] (エンクロージャ) | CSVファイルでフィールド値を囲むために使う文字を入力します。<br><br>このフィールドは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合には表示されません。 |
| [Line Terminated By] (行終端記号) | 行の最後を表す文字を入力します。<br><br>このフィールドは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合には表示されません。 |
| [Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) | このチェックボックスをオンにすると、JSONメタデータデスクリプションが自動的に生成されます。 |
| [Header] (ヘッダー) | CSVファイルで無視する行数を指定します。<br><br>このフィールドは、[Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) チェックボックスがオフの場合のみ利用できます。 |
| [Unique API Name] (一意のAPI名) | JSONメタデータデスクリプションでオブジェクトに一意のAPI名を指定します。<br><br>このフィールドは、[Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) チェックボックスがオフの場合のみ利用できます。 |
| [Label] (ラベル) | JSONメタデータデスクリプションでオブジェクトに表示名を指定します。<br><br>このフィールドは、[Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) チェックボックスがオフの場合のみ利用できます。 |
| [Fully Qualified Name] (完全修飾名) | JSONメタデータデスクリプションでレコードを一意に識別する完全パスを指定します。<br><br>このフィールドは、[Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) チェックボックスがオフの場合のみ利用できます。 |
| [Custom JSON Metadata] (カスタムJSONメタデータ) | カスタマイズされたJSONメタデータファイルを使うには、このチェックボックスをオンにします。<br><br>このチェックボックスは、[Auto Generate JSON Metadata Description] (JSONメタデータデスクリプションを自動生成) チェックボックスがオフの場合のみ利用できます。 |
| [JSON Metadata] (JSONメタデータ) | カスタマイズされたJSONメタデータファイルへのパスを指定します。<br><br>このフィールドは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合のみ利用できます。 |
| [Generate JSON in File] (JSONをファイル内に生成) | このチェックボックスをオンにすると、JSONメタデータデスクリプションがローカルファイルに書き込まれます。<br><br>このチェックボックスは、[Custom JSON Metadata] (カスタムJSONメタデータ)チェックボックスがオンの場合には表示されません。 |
| [Generated JSON Folder] (JSONフォルダーを生成) | 生成されたJSONメタデータファイルを保管するディレクトリーを指定します。<br><br>このフィールドは、[Generate JSON in File] (JSONをファイル内に生成)チェックボックスがオンの場合のみ利用できます。 |
| [Retrieve Upload Status] (アップロードステータスの取得) | データアップロードのステータスを取得するには、このチェックボックスをオンにします。 |
| [Time to wait for server answer (seconds)] (サーバー応答待機時間(秒)) | サーバーからのアップロードステータスの応答を待機する時間を秒単位で指定します。<br><br>このフィールドは、[Retrieve Upload Status] (アップロードステータスの取得)チェックボックスがオンの場合のみ利用できます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

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

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、スタンドアロンコンポーネントとして使用できます。 |