Bulk import records into a Salesforce object from a CSV file. Uses Bulk API 2.0.
You can use this command to import millions of records into the object from a file in comma-separated values (CSV) format.
All the records in the CSV file must be for the same Salesforce object. Specify the object with the --sobject flag.
Bulk imports can take a while, depending on how many records are in the CSV file. For this reason, the command is asynchronous by default and immediately displays the "sf data import resume" command that you run to see the status and get the results of the job; the command includes the job ID. You can use the --wait flag to wait a specific number of minutes for this command to complete.
For information and examples about how to prepare your CSV files, see "Prepare Data to Ingest" in the "Bulk API 2.0 and Bulk API Developer Guide" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).
-
Import Account records from a CSV-formatted file into an org with alias "my-scratch"; if the import doesn't complete in 10 minutes, the command ends and displays a job ID:
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
-
Import asynchronously and use the default org; the command immediately returns a job ID that you then pass to the "sf data import resume" command:
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account
CSV file that contains the Salesforce object records you want to import.
API name of the Salesforce object, either standard or custom, into which you're importing records.
Time to wait for the command to finish, in minutes.
Line ending used in the CSV file. Default value on Windows is CRLF; on macOS and Linux it's LF.