データローダーガイド
jデータローダープロセスの設定パラメーター
| 使用可能なインターフェース: Salesforce Classic (使用できない組織もあります) および Lightning Experience の両方 |
| 使用可能なエディション: Enterprise Edition、Performance Edition、Unlimited Edition、および Developer Edition |
| パラメーター名 | データ型 | [設定] ダイアログにある同等のオプション | 説明 |
|---|---|---|---|
| dataAccess.readUTF8 | boolean | Read all CSVs with UTF-8 encoding | このオプションを選択すると、保存されている文字コードの形式に関係なく、ファイルを強制的に UTF-8 文字コードで開きます。 サンプル値: true |
| dataAccess.writeUTF8 | boolean | Write all CSVs with UTF-8 encoding | このオプションを選択すると、ファイルを強制的に UTF-8 文字コードで書き込みます。 サンプル値: true |
| dataAccess.name | string | 該当データなし (N/A) | CSV ファイル名など、使用するデータソースの名前。データベースの場合、database-conf.xml にあるデータベース設定の名前を使用します。 サンプル値: c:\dataloader\data\extractLead.csv |
| dataAccess.readBatchSize | integer | なし | データベースから一度に読み取るレコード数。最大値は、200 です。 サンプル値: 50 |
| dataAccess.type | string | なし | 標準またはカスタムのデータソース種別。標準タイプは、csvWrite、csvRead、databaseWrite、databaseRead です。 サンプル値: csvWrite |
| dataAccess.writeBatchSize | integer | なし | データベースから一度に書き込むレコード数。最大値は、2,000 です。パラメーター値が大きい場合、エラーが発生したときに、一括処理されているすべてのレコードがロールバックされることになるため、注意してください。それに対して、値が 1 に設定されていれば、レコードは (一括ではなく) 1 つずつ処理され、エラーはその 1 つのレコードに対してのエラーとなります。データベースへの書き込みの問題を診断する必要がある場合は、値を 1 に設定することをお勧めします。 サンプル値: 500 |
| loader.csvComma | boolean | Allow comma as a CSV delimiter | CSV ファイルでカンマを使用してレコードを区切る場合にこのオプションを選択します。 |
| loader.csvTab | boolean | Allow tab as a CSV delimiter | CSV ファイルでタブ文字を使用してレコードを区切る場合にこのオプションを選択します。 |
| loader.csvOther | boolean | Allow other characters as CSV delimiters | CSV ファイルでカンマまたはタブ以外の文字を使用してレコードを区切る場合にこのオプションを選択します。 |
| loader.csvOtherValue | string | Other delimiters (enter multiple values with no separator; for example, !+?) | この項目の文字が使用されるのは、[Allow other characters as CSV delimiters (CSV の区切りとしてその他の文字を許可)] オプションが選択されている場合のみです��たとえば、| (パイプ) 文字を使用してデータレコードを区切る場合、その文字をこの項目に入力します。 |
| process.enableExtractStatusOutput | boolean | Generate status files for exports | データをエクスポートするときに成功とエラーのファイルを生成する場合は、このオプションを選択します。 サンプル値: true |
| process.enableLastRunOutput | boolean | なし | データローダーをバッチモードで実行しているときに、sendAccountsFile_lastRun.properties などの出力ファイルの生成を無効にできます。このタイプのファイルは、デフォルトで conf ディレクトリに保存されます。これらのファイルへの書き込みを停止するには、このオプションを false に設定します。 また、ファイルを保存するディレクトリの場所は、process.lastRunOutputDirectory を使用して変更できます。 サンプル値: true |
| process.encryptionKeyFile | string (ファイル名) | なし | 暗号化鍵が入っているファイルの名前。このパラメーターはデータローダーバージョン 43.0 以降で必須です。「コマンドラインからの暗号化」を参照してください。 サンプル値: c:\Users\{user}\.dataloader\dataloader.key |
| process.initialLastRunDate | date | なし |
process.lastRunDate パラメーターの初期設定。SQL 文で使用でき、プロセスの実行が成功すると自動的に更新されます。日付形式の構文についての詳細は、「日付形式」を参照してください。 形式は yyyy-MM-ddTHH:mm:ss.SSS+/-HHmm です。たとえば、2006-04-13T13:50:32.423-0700 となります。 |
| process.lastRunOutputDirectory | string (ディレクトリ) | なし | データローダーをバッチモードで実行しているときに、sendAccountsFile_lastRun.properties などの出力ファイルが書かれる場所を変更できます。このタイプのファイルは、デフォルトで \conf ディレクトリに保存されます。場所を変更するには、このオプションの値を、出力ファイルを書き込む場所のフルパスに変更します。 また、process.enableLastRunOutput を使用してファイルの書き込みを停止できます。 |
| process.loadRowToStartAt | number | Start at row | 前回に実行した操作が失敗した場合に、最後に成功した操作の完了時点から開始するよう設定できます。 サンプル値: 1008 |
| process.mappingFile | string (ファイル名) | なし | 使用する項目の対応付けファイルの名前。「列の対応付け」を参照してください。 サンプル値: c:\dataloader\conf\accountExtractMap.sdl |
| process.operation | string | なし | 実行する操作。「データローダーのコマンドライン操作」を参照してください。 サンプル値: extract |
| process.statusOutputDirectory | string (ディレクトリ) | なし | 「success」または「error」の出力ファイルを保存するディレクトリ。ファイル名は、process-conf.xml で他の方法を指定しない限り、操作ごとに自動的に生成されます。 サンプル値: c:\dataloader\status |
| process.outputError | string (ファイル名) | なし | 最新の操作によるエラーデータを保存する CSV ファイルの名前。 サンプル値: c:\dataloader\status\myProcessErrors.csv |
| process.outputSuccess | string (ファイル名) | なし | 最新の操作による成功データを保存する CSV ファイルの名前。「process.enableExtractStatusOutput」も参照してください。 サンプル値: c:\dataloader\status\myProcessSuccesses.csv |
| process.useEuropeanDates | boolean | Use European date format | このオプションを有効にすると、日付の形式として dd/MM/yyyy および dd/MM/yyyy HH:mm:ss が使用できます。 サンプル値: true |
| sfdc.assignmentRule | string | Assignment rule | 挿入、更新、更新/挿入に使う割り当てルールの ID を指定します。このオプションは、ケースとリードでの挿入、更新、更新/挿入に適用されます。割り当てルールは、CSV ファイルの [Owner (所有者)] の値を上書きします。 サンプル値: 03Mc00000026J7w |
| sfdc.bulkApiCheckStatusInterval | integer | なし | 連続する次のチェックを待つ時間 (ミリ秒)。チェックでは、非同期の Bulk API 操作が完了しているかどうか、または処理したレコードの数を確認します。「sfdc.useBulkApi」を参照してください。値を 5000 にすることをお勧めします。 サンプル値: 5000 |
| sfdc.bulkApiSerialMode | boolean | Enable serial mode for Bulk API | Bulk API に並列処理ではなく順次処理を使用する場合、このオプションを選択します。並列処理を行うと、データベースの競合が生じる可能性があります。競合が激しいと、読み込みに失敗する可能性があります。順次モードでは、バッチが 1 つずつ処理されますが、読み込みの処理時間が長くなる可能性があります。「sfdc.useBulkApi」を参照してください。 サンプル値: false |
| sfdc.bulkApiZipContent | boolean | Upload Bulk API Batch as Zip File | Bulk API を使用して、添付ファイルレコードや Salesforce CRM Content などのバイナリ添付ファイルを含む zip ファイルをアップロードするには、このオプションを選択します。「sfdc.useBulkApi」を参照してください。 サンプル値: true |
| sfdc.connectionTimeoutSecs | integer | なし | API コール中の接続待ち時間 (秒)。 サンプル値: 60 |
| sfdc.debugMessages | boolean | なし | true の場合、SOAP メッセージデバッグを有効にします。デフォルトでは、sfdc.debugMessagesFile で他の場所を指定しない限り、メッセージは STDOUT に送信されます。 サンプル値: false |
| sfdc.debugMessagesFile | string (ファイル名) | なし | 「process.enableExtractStatusOutput」を参照してください。Salesforce で送受信する SOAP メッセージを保存します。メッセージを送信または受信すると、メッセージがファイルの最後に追加されます。ファイルにはサイズ制限がないため、使用できるディスク容量を監視してください。 サンプル値: \lexiloader\status\sfdcSoapTrace.log |
| sfdc.enableRetries | boolean | なし | true の場合、Salesforce サーバーへの接続を繰り返し試行できます。「sfdc.maxRetries」および「sfdc.minRetrySleepSecs」を参照してください。 サンプル値: true |
| sfdc.endpoint | URL | Server host | 通信対象となる Salesforce サーバーの URL を入力します。たとえば、データを Sandbox に読み込む場合は、URL を https://MyDomainName--SandboxName.sandbox.my.salesforce.com または https://test.salesforce.com に変更します。 本番のサンプル値: https://MyDomainName.my.salesforce.com/services/Soap/u/53.0 および https://login.salesforce.com/services/Soap/u/53.0 |
| sfdc.entity | string | なし | 操作で使用される Salesforce オブジェクト。 サンプル値: Lead |
| sfdc.externalIdField | string | なし | 更新/挿入操作で使用されます。データを一致させるための一意の ID として使用される「External ID (外部 ID)」属性を持つカスタム項目を指定します。 サンプル値: LegacySKU__c |
| sfdc.extractionRequestSize | integer | Query request size | 一度のエクスポートまたはクエリ操作で Salesforce から返されるレコードは、このオプションで指定したサイズで増分されます。値が大きいほどパフォーマンスは向上しますが、クライアントでのメモリ消費量が多くなります。 サンプル値: 500 |
| sfdc.extractionSOQL | string | なし | データエクスポート用の SOQL クエリ。 サンプル値: SELECT Id, LastName, FirstName, Rating, AnnualRevenue, OwnerId FROM Lead |
| sfdc.insertNulls | boolean | Insert null values | このオプションを選択すると、null 値として空白の対応値がデータ操作中に挿入されます。レコードを更新するときにこのオプションが有効になっていると、対応付けが行われた項目の既存データがデータローダーによってすべて上書きされます。 サンプル値: false |
| sfdc.loadBatchSize | integer | Batch size | 一度の挿入、更新、更新/挿入、削除操作で Salesforce に対して入出力されるレコードは、このオプションで指定したサイズで増分されます。最大 200 レコードです。50 ～ 100 の値をお勧めします。 サンプル値: 100 |
| sfdc.maxRetries | integer | なし | Salesforce への接続を繰り返し試行する場合の最大数。「sfdc.enableRetries」を参照してください。 サンプル値: 3 |
| sfdc.minRetrySleepSecs | integer | なし | 接続再試行の待ち時間の最少値 (秒数)。待ち時間は、試行ごとに増えていきます。「sfdc.enableRetries」を参照してください。 サンプル値: 2 |
| sfdc.noCompression | boolean | Compression | 圧縮はデータローダーのパフォーマンスを向上させます。この機能はデフォルトで有効になっています。基盤となる SOAP メッセージのデバッグ時に圧縮を無効にするには、このオプションを有効にします。 サンプル値: false |
| sfdc.password | 暗号化された文字列 | なし |
sfdc.username で指定したユーザー名に対応する暗号化された Salesforce パスワード。このパラメーターはデータローダーバージョン 43.0 以降で必須です。「コマンドラインからの暗号化」も参照してください。 サンプル値: 4285b36161c65a22 |
| sfdc.proxyHost | URL | Proxy host | プロキシサーバーのホスト名です (該当する場合のみ)。 サンプル値: http://myproxy.internal.company.com |
| sfdc.proxyPassword | 暗号化された文字列 | Proxy password |
sfdc.proxyUsername で指定したプロキシユーザー名に対応する暗号化されたパスワード。「コマンドラインからの暗号化」も参照してください。 サンプル値: 4285b36161c65a22 |
| sfdc.proxyPort | integer | Proxy port | プロキシサーバーのポートです。 サンプル値: 8000 |
| sfdc.proxyUsername | string | Proxy username | プロキシサーバー認証用のユーザー名です。 サンプル値: jane.doe |
| sfdc.resetUrlOnLogin | boolean | Reset URL on Login | デフォルトでは、Salesforce は sfdc.endpoint で指定した URL にログインした後、その URL をリセットします。この自動リセットを無効にするには、このオプションを false に設定して無効にします。 有効な値: true (デフォルト)、false |
| sfdc.timeoutSecs | integer | Timeout | 要求のエラーが返されるまでに、データローダーがサーバーからの応答を待つ時間を秒数で指定します。 サンプル値: 540 |
| sfdc.timezone | string | Time Zone |
日付値にタイムゾーンが含まれない場合は、この値が使用されます。有効な値は、Java getTimeZone(java.lang.String) メソッドに渡すことができるタイムゾーン識別子です。値は、America/Los_Angeles などのフルネームか、GMT-8:00 などのカスタム ID にできます。
Java で書かれている TimeZone.getDefault() メソッドを実行して、デフォルト値を取得できます。この値は、データローダーがインストールされたコンピューターのタイムゾーンです。 |
| sfdc.truncateFields | boolean | Allow field truncation | このオプションを選択すると、データが Salesforce に読み込まれたときに、メール、複数選択の選択リスト、電話、選択リスト、テキスト、および暗号化テキストの項目のデータを切り捨てます。 バージョン 14.0 以前のデータローダーでは、データが大きすぎる場合にはデータローダーが、これらの種類の項目の値を切り捨てます。バージョン 15.0 以降のデータローダーでは、指定された値が大きすぎる場合の読み込み処理がエラーになります。 このオプションを指定すると、バージョン 15.0 以降のデータローダーでの新しい動作ではなく、以前の動作である切り取りを使用するように指定できます。このオプションはデフォルトで選択されており、バージョン 14.0 以前の製品には無効です。 [Use Bulk API (Bulk API を使用)] オプションがオンの場合、このオプションは使用できません。この場合、項目に対して大きすぎる値が指定されると、その行の読み込み処理は失敗します。 サンプル値: true |
| sfdc.useBulkApi | boolean | Use Bulk API | このオプションを選択すると、Bulk API を使用して、レコードの挿入、更新、更新/挿入、削除、および物理削除が行われます。Bulk API は、多数のレコードを非同期で読み込みまたは削除するように最適化されます。並列処理を行い、ネットワーク往復数を少なくすることで、デフォルトの SOAP ベースの API よりも高速に動作します。「sfdc.bulkApiSerialMode」も参照してください。 サンプル値: true |
| sfdc.username | string | なし | Salesforce ユーザー名。「sfdc.password」を参照してください。 サンプル値: jdoe@mycompany.com |