データローダーをバッチモードで使用してみた

はじめに

データローダーは、データを一括でインポートまたはエクスポートするためのクライアントアプリケーションで、Salesforceレコードの挿入、更新、削除、またはエクスポートに使用できます。
さまざまな操作を実行できるデータローダーですが、Windowsコマンドラインからバッチモードで実行することで、データのインポートとエクスポートを自動化することができます！

この記事では、実際にデータローダーをバッチモードで使用する際の注意事項を３つご紹介いたします✍️

本記事は、Salesforce社のペルプページにある、設定手順を参考にしています。
https://help.salesforce.com/s/articleView?id=000386154&type=1

注意事項

⚠️その１：実行環境に注意！

データローダーのコマンドラインインターフェースは、Windows環境でのみ サポートされています。
バッチモードでは、バッチ（.bat）ファイルを使用して、一連のデータローダープロセスが特定の順序で実行されます。そのため、LinuxやMacOS環境はサポートされておりませんので、実行環境には注意が必要です。

⚠️その２：文字化けに注意！

Windowsのコマンドプロンプトは、通常 Shift_JIS（日本語環境）をデフォルトの文字コードとして使用します。そのため、UTF-8で保存されたバッチファイルやCSVファイルをUTF-8で保存した場合に、文字化けが発生する可能性があります。
この事象は、バッチファイルで使用する文字コードの設定する もしくは、バッチファイルのエンコードを指定する ことで文字化けを防ぐことができます。

指定可能なコードページ番号は、以下の記事を参照ください。
https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers

比較的よく利用されるものは次の通りです。

文字コード	コードページ番号
Shift_JIS	932
UTF-8	65001

通常、データローダーを使用する際も、CSVファイルの文字コードやデータローダーの設定に注意する必要がありますが、バッチモードでも同様に、文字化けや不安定な動作をすることがありますので注意が必要です。

⚠️その３：セキュリティトークンのリセットに注意！

データローダーのバージョンは、メジャーリリースごとに 1 ずつ増加し、Salesforce社からは、常に最新のバージョンのデータローダーを使用することが推奨されています。
最新のデータローダー（バージョン 62以降）のログイン時のパスワードには、Salesforceにログインするためのパスワードに加えて、セキュリティトークン が必要になります。ただ、何らかの理由でセキリティトークンのリセットすると、リセット以前に使用していたセキュリティトークンは無効となるため、新しいセキュリティトークンを使用して、暗号化パスワードの作成および再設定が必要となります。

セキュリティトークンを使用する場合、ログインパスワードの末尾にセキュリティートークンを続けて記述したうえで暗号化し、sfdc.password に設定いただく必要がございます。
セキュリティトークンの取得方法については、以下を参照ください。
https://help.salesforce.com/s/articleView?id=xcloud.user_security_token.htm&type=5

セキュリティトークンのリセットが必要になった場合には、暗号化パスワードにも影響がありますので注意が必要です。

さいごに

データローダーをバッチモードで実行することは、コマンドライン操作が必要になるので、GUIに慣れていない方にとっては、少し敷居が高いかもしれません。また、バッチ（.bat）ファイルの作成や、設定ファイルの整備等も必要になるので、初期設定に若干時間がかかります、、。
とはいえ、定期的なインポートやエクスポートが必要な場合に、非常に便利だと思います🙌