@salesforce/plugin-data 4.0.51 → 4.0.53
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +46 -67
- package/lib/bulkIngest.js +2 -10
- package/lib/bulkIngest.js.map +1 -1
- package/lib/commands/data/delete/bulk.js +0 -1
- package/lib/commands/data/delete/bulk.js.map +1 -1
- package/lib/commands/data/export/bulk.js +1 -7
- package/lib/commands/data/export/bulk.js.map +1 -1
- package/lib/commands/data/import/bulk.js +0 -8
- package/lib/commands/data/import/bulk.js.map +1 -1
- package/lib/commands/data/update/bulk.js +0 -6
- package/lib/commands/data/update/bulk.js.map +1 -1
- package/lib/commands/data/upsert/bulk.js +0 -1
- package/lib/commands/data/upsert/bulk.js.map +1 -1
- package/messages/data.export.bulk.md +2 -6
- package/messages/data.export.resume.md +1 -1
- package/messages/data.import.bulk.md +1 -5
- package/messages/data.import.resume.md +1 -1
- package/messages/data.update.bulk.md +1 -5
- package/messages/data.update.resume.md +1 -1
- package/oclif.manifest.json +481 -547
- package/package.json +6 -6
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk.js","sourceRoot":"","sources":["../../../../src/commands/data/upsert/bulk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEhH,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;AAEnF,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,SAAuB;IAClD,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,GAAG,qBAAqB;QACxB,aAAa,EAAE,cAAc;QAC7B,kBAAkB,EAAE,mBAAmB;QACvC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC;YACzD,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,CAAC,YAAY,CAAC;YACvB,gBAAgB,EAAE,IAAI;SACvB,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC;YAC3B,WAAW,EAAE,oBAAoB;YACjC,UAAU,EAAE,gBAAgB;YAC5B,MAAM,EAAE,KAAK,CAAC,OAAO;YACrB,SAAS,EAAE,QAAQ;YACnB,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;YAChC,eAAe,EAAE,KAAK,CAAC,kBAAkB,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAC7D,KAAK,EAAE,MAAM,sBAAsB,CAAC,MAAM,EAAE;YAC5C,
|
|
1
|
+
{"version":3,"file":"bulk.js","sourceRoot":"","sources":["../../../../src/commands/data/upsert/bulk.ts"],"names":[],"mappings":"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"}
|
|
@@ -6,9 +6,9 @@ Bulk export records from an org into a file using a SOQL query. Uses Bulk API 2.
|
|
|
6
6
|
|
|
7
7
|
You can use this command to export millions of records from an org, either to migrate data or to back it up.
|
|
8
8
|
|
|
9
|
-
Use a SOQL query to specify the fields of a standard or custom object that you want to export. Specify the SOQL query either at the command line with the --query flag or read it from a file with the --query-file flag; you can't specify both flags. The --output-file flag is required, which means you can only write the records to a file, in either CSV or JSON format.
|
|
9
|
+
Use a SOQL query to specify the fields of a standard or custom object that you want to export. Specify the SOQL query either at the command line with the --query flag or read it from a file with the --query-file flag; you can't specify both flags. The --output-file flag is required, which means you can only write the records to a file, in either CSV or JSON format.
|
|
10
10
|
|
|
11
|
-
Bulk exports can take a while, depending on how many records are returned by the SOQL query. If the command times out,
|
|
11
|
+
Bulk exports can take a while, depending on how many records are returned by the SOQL query. If the command times out, the command displays the job ID. To see the status and get the results of the job, run "sf data export resume" and pass the job ID to the --job-id flag.
|
|
12
12
|
|
|
13
13
|
IMPORTANT: This command uses Bulk API 2.0, which limits the type of SOQL queries you can run. For example, you can't use aggregate functions such as count(). For the complete list of limitations, see the "SOQL Considerations" section in the "Bulk API 2.0 and Bulk API Developer Guide" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm).
|
|
14
14
|
|
|
@@ -22,10 +22,6 @@ IMPORTANT: This command uses Bulk API 2.0, which limits the type of SOQL queries
|
|
|
22
22
|
|
|
23
23
|
<%= config.bin %> <%= command.id %> --query "SELECT Id, Name, Account.Name FROM Contact" --output-file export-accounts.json --result-format json --wait 10 --all-rows
|
|
24
24
|
|
|
25
|
-
- Export asynchronously; the command immediately returns a job ID that you then pass to the "sf data export resume" command:
|
|
26
|
-
|
|
27
|
-
<%= config.bin %> <%= command.id %> --query "SELECT Id, Name, Account.Name FROM Contact" --output-file export-accounts.json --result-format json --async
|
|
28
|
-
|
|
29
25
|
# flags.wait.summary
|
|
30
26
|
|
|
31
27
|
Time to wait for the command to finish, in minutes.
|
|
@@ -4,7 +4,7 @@ Resume a bulk export job that you previously started. Uses Bulk API 2.0.
|
|
|
4
4
|
|
|
5
5
|
# description
|
|
6
6
|
|
|
7
|
-
When the original "data export bulk" command
|
|
7
|
+
When the original "data export bulk" command times out, it displays a job ID. To see the status and get the results of the bulk export, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk export job.
|
|
8
8
|
|
|
9
9
|
Using either `--job-id` or `--use-most-recent` will properly resolve to the correct org where the bulk job was started based on the cached data by "data export bulk".
|
|
10
10
|
|
|
@@ -8,7 +8,7 @@ You can use this command to import millions of records into the object from a fi
|
|
|
8
8
|
|
|
9
9
|
All the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag.
|
|
10
10
|
|
|
11
|
-
Bulk imports can take a while, depending on how many records are in the CSV file. If the command times out,
|
|
11
|
+
Bulk imports can take a while, depending on how many records are in the CSV file. If the command times out, the command displays the job ID. To see the status and get the results of the job, run "sf data import resume" and pass the job ID to the --job-id flag.
|
|
12
12
|
|
|
13
13
|
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).
|
|
14
14
|
|
|
@@ -18,10 +18,6 @@ For information and examples about how to prepare your CSV files, see "Prepare D
|
|
|
18
18
|
|
|
19
19
|
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
|
|
20
20
|
|
|
21
|
-
- 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:
|
|
22
|
-
|
|
23
|
-
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async
|
|
24
|
-
|
|
25
21
|
# flags.async.summary
|
|
26
22
|
|
|
27
23
|
Don't wait for the command to complete.
|
|
@@ -4,7 +4,7 @@ Resume a bulk import job that you previously started. Uses Bulk API 2.0.
|
|
|
4
4
|
|
|
5
5
|
# description
|
|
6
6
|
|
|
7
|
-
When the original "sf data import bulk" command
|
|
7
|
+
When the original "sf data import bulk" command times out, it displays a job ID. To see the status and get the results of the bulk import, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk import job.
|
|
8
8
|
|
|
9
9
|
# examples
|
|
10
10
|
|
|
@@ -8,7 +8,7 @@ You can use this command to update millions of Salesforce object records based o
|
|
|
8
8
|
|
|
9
9
|
All the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using "sf data upsert bulk" if you also want to insert new records.
|
|
10
10
|
|
|
11
|
-
Bulk updates can take a while, depending on how many records are in the CSV file. If the command times out,
|
|
11
|
+
Bulk updates can take a while, depending on how many records are in the CSV file. If the command times out, the command displays the job ID. To see the status and get the results of the job, run "sf data update resume" and pass the job ID to the --job-id flag.
|
|
12
12
|
|
|
13
13
|
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).
|
|
14
14
|
|
|
@@ -18,10 +18,6 @@ For information and examples about how to prepare your CSV files, see "Prepare D
|
|
|
18
18
|
|
|
19
19
|
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch
|
|
20
20
|
|
|
21
|
-
- Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the "sf data update resume" command:
|
|
22
|
-
|
|
23
|
-
<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async
|
|
24
|
-
|
|
25
21
|
# flags.async.summary
|
|
26
22
|
|
|
27
23
|
Don't wait for the command to complete.
|
|
@@ -4,7 +4,7 @@ Resume a bulk update job that you previously started. Uses Bulk API 2.0.
|
|
|
4
4
|
|
|
5
5
|
# description
|
|
6
6
|
|
|
7
|
-
When the original "sf data update bulk" command
|
|
7
|
+
When the original "sf data update bulk" command times out, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.
|
|
8
8
|
|
|
9
9
|
Using either `--job-id` or `--use-most-recent` will properly resolve to the correct org where the bulk job was started based on the cached data by "data update bulk".
|
|
10
10
|
|