diff --git a/CHANGELOG.md b/CHANGELOG.md index 1cb67da7..641b1641 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,13 @@ +# [3.13.0](https://github.com/salesforcecli/plugin-data/compare/3.12.3...3.13.0) (2024-12-06) + +### Bug Fixes + +- update command snapshot ([334f50b](https://github.com/salesforcecli/plugin-data/commit/334f50b632bbb86005a8369935972fcc4b240667)) + +### Features + +- **data:query:** add `--output-file` flag ([324c5a4](https://github.com/salesforcecli/plugin-data/commit/324c5a4c920bccfa8664e642dcbb3584d3f59166)) + ## [3.12.3](https://github.com/salesforcecli/plugin-data/compare/3.12.2...3.12.3) (2024-12-01) ### Bug Fixes diff --git a/README.md b/README.md index f7aed948..d4c137f9 100644 --- a/README.md +++ b/README.md @@ -145,7 +145,7 @@ EXAMPLES $ sf data bulk results --job-id 7507i000fake341G --target-org my-scratch ``` -_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/bulk/results.ts)_ +_See code: [src/commands/data/bulk/results.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/bulk/results.ts)_ ## `sf data create file` @@ -194,7 +194,7 @@ EXAMPLES $ sf data create file --file path/to/astro.png --parent-id a03fakeLoJWPIA3 ``` -_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/create/file.ts)_ +_See code: [src/commands/data/create/file.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/create/file.ts)_ ## `sf data create record` @@ -250,7 +250,7 @@ EXAMPLES TracedEntityId=01p17000000R6bLAAS" ``` -_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/create/record.ts)_ +_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/create/record.ts)_ ## `sf data delete bulk` @@ -311,7 +311,7 @@ FLAG DESCRIPTIONS and can be enabled only by a system administrator. ``` -_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/delete/bulk.ts)_ +_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/delete/bulk.ts)_ ## `sf data delete record` @@ -372,7 +372,7 @@ EXAMPLES $ sf data delete record --use-tooling-api --sobject TraceFlag --record-id 7tf8c ``` -_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/delete/record.ts)_ +_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/delete/record.ts)_ ## `sf data delete resume` @@ -411,7 +411,7 @@ EXAMPLES $ sf data delete resume --use-most-recent --target-org my-scratch ``` -_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/delete/resume.ts)_ +_See code: [src/commands/data/delete/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/delete/resume.ts)_ ## `sf data export bulk` @@ -485,7 +485,7 @@ EXAMPLES --result-format json --async ``` -_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/export/bulk.ts)_ +_See code: [src/commands/data/export/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/export/bulk.ts)_ ## `sf data export resume` @@ -521,7 +521,7 @@ EXAMPLES $ sf data export resume --use-most-recent --target-org my-scratch ``` -_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/export/resume.ts)_ +_See code: [src/commands/data/export/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/export/resume.ts)_ ## `sf data export tree` @@ -582,7 +582,7 @@ EXAMPLES my-scratch ``` -_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/export/tree.ts)_ +_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/export/tree.ts)_ ## `sf data get record` @@ -646,7 +646,7 @@ EXAMPLES $ sf data get record --use-tooling-api --sobject TraceFlag --record-id 7tf8c ``` -_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/get/record.ts)_ +_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/get/record.ts)_ ## `sf data import bulk` @@ -704,7 +704,7 @@ EXAMPLES $ sf data import bulk --file accounts.csv --sobject Account --async ``` -_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/import/bulk.ts)_ +_See code: [src/commands/data/import/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/import/bulk.ts)_ ## `sf data import resume` @@ -740,7 +740,7 @@ EXAMPLES $ sf data import resume --use-most-recent --target-org my-scratch ``` -_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/import/resume.ts)_ +_See code: [src/commands/data/import/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/import/resume.ts)_ ## `sf data import tree` @@ -805,7 +805,7 @@ FLAG DESCRIPTIONS - files(array) - Files: An array of files paths to load ``` -_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/import/tree.ts)_ +_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/import/tree.ts)_ ## `sf data query` @@ -814,7 +814,7 @@ Execute a SOQL query. ``` USAGE $ sf data query -o [--json] [--flags-dir ] [--api-version ] [-q ] [-f ] - [-t | -b] [-w ] [--async ] [--all-rows] [-r human|csv|json] + [-t | -b] [-w ] [--async ] [--all-rows] [-r human|csv|json] [--output-file ] FLAGS -b, --bulk Use Bulk API 2.0 to run the query. @@ -829,6 +829,7 @@ FLAGS --all-rows Include deleted records. By default, deleted records are not returned. --api-version= Override the api version used for api requests made by this command --async Use Bulk API 2.0, but don't wait for the job to complete. + --output-file= File where records are written; only CSV and JSON output formats are supported. GLOBAL FLAGS --flags-dir= Import flag values from a directory. @@ -856,9 +857,10 @@ EXAMPLES $ sf data query --query "SELECT Id, Name, Account.Name FROM Contact" - Read the SOQL query from a file called "query.txt"; the command uses the org with alias "my-scratch": + Read the SOQL query from a file called "query.txt" and write the CSV-formatted output to a file; the command uses + the org with alias "my-scratch": - $ sf data query --file query.txt --target-org my-scratch + $ sf data query --file query.txt --output-file output.csv --result-format csv --target-org my-scratch Use Tooling API to run a query on the ApexTrigger Tooling API object: @@ -869,7 +871,7 @@ EXAMPLES $ sf data query --query "SELECT Id FROM Contact" --bulk --wait 0 ``` -_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/query.ts)_ +_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/query.ts)_ ## `sf data query resume` @@ -906,7 +908,7 @@ EXAMPLES $ sf data query resume --bulk-query-id 7500x000005BdFzXXX ``` -_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/query/resume.ts)_ +_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/query/resume.ts)_ ## `sf data resume` @@ -943,7 +945,7 @@ EXAMPLES $ sf data resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA ``` -_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/resume.ts)_ +_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/resume.ts)_ ## `sf data search` @@ -993,7 +995,7 @@ EXAMPLES $ sf data search --file query.txt --target-org my-scratch --result-format csv ``` -_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/search.ts)_ +_See code: [src/commands/data/search.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/search.ts)_ ## `sf data update bulk` @@ -1054,7 +1056,7 @@ EXAMPLES $ sf data update bulk --file accounts.csv --sobject Account --async ``` -_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/update/bulk.ts)_ +_See code: [src/commands/data/update/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/update/bulk.ts)_ ## `sf data update record` @@ -1116,7 +1118,7 @@ EXAMPLES "ExpirationDate=2017-12-01T00:58:04.000+0000" ``` -_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/update/record.ts)_ +_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/update/record.ts)_ ## `sf data update resume` @@ -1152,7 +1154,7 @@ EXAMPLES $ sf data update resume --use-most-recent --target-org my-scratch ``` -_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/update/resume.ts)_ +_See code: [src/commands/data/update/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/update/resume.ts)_ ## `sf data upsert bulk` @@ -1211,7 +1213,7 @@ EXAMPLES my-scratch ``` -_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/upsert/bulk.ts)_ +_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/upsert/bulk.ts)_ ## `sf data upsert resume` @@ -1250,7 +1252,7 @@ EXAMPLES $ sf data upsert resume --use-most-recent --target-org my-scratch ``` -_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/data/upsert/resume.ts)_ +_See code: [src/commands/data/upsert/resume.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/data/upsert/resume.ts)_ ## `sf force data bulk delete` @@ -1297,7 +1299,7 @@ EXAMPLES $ sf force data bulk delete --sobject MyObject__c --file files/delete.csv --wait 5 --target-org my-scratch ``` -_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/force/data/bulk/delete.ts)_ +_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/force/data/bulk/delete.ts)_ ## `sf force data bulk status` @@ -1334,7 +1336,7 @@ EXAMPLES $ sf force data bulk status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA --target-org my-scratch ``` -_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/force/data/bulk/status.ts)_ +_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/force/data/bulk/status.ts)_ ## `sf force data bulk upsert` @@ -1392,6 +1394,6 @@ EXAMPLES --target-org my-scratch ``` -_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.12.3/src/commands/force/data/bulk/upsert.ts)_ +_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/3.13.0/src/commands/force/data/bulk/upsert.ts)_ diff --git a/package.json b/package.json index 7ec50b95..f5428d7d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@salesforce/plugin-data", - "version": "3.12.3", + "version": "3.13.0", "description": "Plugin for salesforce data commands", "author": "Salesforce", "homepage": "https://github.com/salesforcecli/plugin-data",