@salesforce/plugin-data 2.1.21 → 2.1.22

package/README.md

@@ -76,529 +76,1156 @@ sfdx plugins
 
 <!-- commands -->
 
-- [`sfdx force:data:bulk:delete -f <filepath> -s <string> [-w <minutes>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatabulkdelete--f-filepath--s-string--w-minutes--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:bulk:status -i <string> [-b <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatabulkstatus--i-string--b-string--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:bulk:upsert -i <string> -f <filepath> -s <string> [-w <minutes>] [-r] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatabulkupsert--i-string--f-filepath--s-string--w-minutes--r--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:record:create -s <string> -v <string> [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatarecordcreate--s-string--v-string--t---perflog---json--u-string---apiversion-string---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:record:delete -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatarecorddelete--s-string--i-id---w-string--t---perflog---json--u-string---apiversion-string---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:record:get -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatarecordget--s-string--i-id---w-string--t---perflog---json--u-string---apiversion-string---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:record:update -s <string> -v <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatarecordupdate--s-string--v-string--i-id---w-string--t---perflog---json--u-string---apiversion-string---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:soql:bulk:report -i <string> [-r human|csv|json] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatasoqlbulkreport--i-string--r-humancsvjson--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:soql:query [-q <string> | -f <filepath>] [-w <minutes> [-b | -t]] [-r human|csv|json] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatasoqlquery--q-string---f-filepath--w-minutes--b---t--r-humancsvjson---perflog---json--u-string---apiversion-string---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:tree:export -q <string> [-p] [-x <string>] [-d <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatatreeexport--q-string--p--x-string--d-directory--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
-- [`sfdx force:data:tree:import [-f <array> | -p <filepath>] [--confighelp] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`](#sfdx-forcedatatreeimport--f-array---p-filepath---confighelp--u-string---apiversion-string---json---loglevel-tracedebuginfowarnerrorfataltracedebuginfowarnerrorfatal)
+- [`sfdx data:create:record`](#sfdx-datacreaterecord)
+- [`sfdx data:delete:bulk`](#sfdx-datadeletebulk)
+- [`sfdx data:delete:record`](#sfdx-datadeleterecord)
+- [`sfdx data:export:tree`](#sfdx-dataexporttree)
+- [`sfdx data:get:record`](#sfdx-datagetrecord)
+- [`sfdx data:import:tree`](#sfdx-dataimporttree)
+- [`sfdx data:query`](#sfdx-dataquery)
+- [`sfdx data:query:resume`](#sfdx-dataqueryresume)
+- [`sfdx data:resume`](#sfdx-dataresume)
+- [`sfdx data:update:record`](#sfdx-dataupdaterecord)
+- [`sfdx data:upsert:bulk`](#sfdx-dataupsertbulk)
+- [`sfdx force:data:bulk:delete`](#sfdx-forcedatabulkdelete)
+- [`sfdx force:data:bulk:status`](#sfdx-forcedatabulkstatus)
+- [`sfdx force:data:bulk:upsert`](#sfdx-forcedatabulkupsert)
+- [`sfdx force:data:record:create`](#sfdx-forcedatarecordcreate)
+- [`sfdx force:data:record:delete`](#sfdx-forcedatarecorddelete)
+- [`sfdx force:data:record:get`](#sfdx-forcedatarecordget)
+- [`sfdx force:data:record:update`](#sfdx-forcedatarecordupdate)
+- [`sfdx force:data:soql:bulk:report`](#sfdx-forcedatasoqlbulkreport)
+- [`sfdx force:data:soql:query`](#sfdx-forcedatasoqlquery)
+- [`sfdx force:data:tree:export`](#sfdx-forcedatatreeexport)
+- [`sfdx force:data:tree:import`](#sfdx-forcedatatreeimport)
+
+## `sfdx data:create:record`
+
+Create and insert a record into a Salesforce or Tooling API object.
 
-## `sfdx force:data:bulk:delete -f <filepath> -s <string> [-w <minutes>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+```
+USAGE
+  $ sfdx data:create:record -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-t]
+
+FLAGS
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're inserting a record
+                            into.
+  -t, --use-tooling-api     Use Tooling API so you can insert a record in a Tooling API object.
+  -v, --values=<value>      (required) Values for the flags in the form <fieldName>=<value>, separate multiple pairs
+                            with spaces.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Create and insert a record into a Salesforce or Tooling API object.
+
+  You must specify a value for all required fields of the object.
+
+  When specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double
+  quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
 
-bulk delete records from a csv file
+  This command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:create
+
+EXAMPLES
+  Insert a record into the Account object of your default org; only the required Name field has a value:
+
+    $ sfdx data:create:record --sobject Account --values "Name=Acme"
+
+  Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias
+  "my-scratch":
+
+    $ sfdx data:create:record --sobject Account --values "Name='Universal Containers' Website=www.example.com" \
+      --target-org my-scratch
+
+  Insert a record into the Tooling API object TraceFlag:
+
+    $ sfdx data:create:record --use-tooling-api --sobject TraceFlag --values "DebugLevelId=7dl170000008U36AAE \
+      StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING \
+      TracedEntityId=01p17000000R6bLAAS"
+```
+
+_See code: [src/commands/data/create/record.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/create/record.ts)_
+
+## `sfdx data:delete:bulk`
+
+Bulk delete records from an org using a CSV file.
 
 ```
 USAGE
-  $ sfdx force:data:bulk:delete -f <filepath> -s <string> [-w <minutes>] [-u <string>] [--apiversion <string>] [--json]
-    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:delete:bulk -o <value> -f <value> -s <value> [--json] [--api-version <value>] [-w <value>]
 
 FLAGS
-  -f, --csvfile=<value>                                                             (required) the path to the CSV file
-                                                                                    containing the ids of the records to
-                                                                                    delete
-  -s, --sobjecttype=<value>                                                         (required) the sObject type of the
-                                                                                    records you’re deleting
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -w, --wait=<value>                                                                the number of minutes to wait for
-                                                                                    the command to complete before
-                                                                                    displaying the results
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -f, --file=<value>        (required) CSV file that contains the IDs of the records to delete.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce object, either standard or custom, that you want to
+                            delete records from.
+  -w, --wait=<value>        [default: 0 minutes] Number of minutes to wait for the command to complete before displaying
+                            the results.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  bulk delete records from a csv file
+  Bulk delete records from an org using a CSV file.
 
-  The file must be a CSV file with only one column: "Id".
+  The CSV file must have only one column ("Id") and then the list of record IDs you want to delete, one ID per line.
 
-  One job can contain many batches, depending on the length of the CSV file.
+  When you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately
+  returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of
+  minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with
+  the "sfdx data resume" command. A single job can contain many batches, depending on the length of the CSV file.
 
-  Returns a job ID and a batch ID. Use these IDs to check job status with data:bulk:status.
+ALIASES
+  $ sfdx force:data:bulk:delete
 
 EXAMPLES
-  $ sfdx force:data:bulk:delete -s Account -f ./path/to/file.csv
+  Bulk delete Account records using the list of IDs in the "files/delete.csv" file:
+
+    $ sfdx data:delete:bulk --sobject Account --file files/delete.csv
 
-  $ sfdx force:data:bulk:delete -s MyObject__c -f ./path/to/file.csv
+  Bulk delete records from a custom object and wait 5 minutes for the command to complete:
+
+    $ sfdx data:delete:bulk --sobject MyObject__c --file files/delete.csv --wait 5
 ```
 
-_See code: [src/commands/force/data/bulk/delete.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/bulk/delete.ts)_
+_See code: [src/commands/data/delete/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/delete/bulk.ts)_
 
-## `sfdx force:data:bulk:status -i <string> [-b <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:delete:record`
 
-view the status of a bulk data load job or batch
+Deletes a single record from a Salesforce or Tooling API object.
 
 ```
 USAGE
-  $ sfdx force:data:bulk:status -i <string> [-b <string>] [-u <string>] [--apiversion <string>] [--json] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:delete:record -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
 
 FLAGS
-  -b, --batchid=<value>                                                             the ID of the batch whose status you
-                                                                                    want to view
-  -i, --jobid=<value>                                                               (required) the ID of the job you
-                                                                                    want to view or of the job whose
-                                                                                    batch you want to view
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -i, --record-id=<value>   ID of the record you’re deleting.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're deleting a record
+                            from.
+  -t, --use-tooling-api     Use Tooling API so you can delete a record from a Tooling API object.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to delete.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  view the status of a bulk data load job or batch
+  Deletes a single record from a Salesforce or Tooling API object.
 
-  Run this command using the job ID or batch ID returned from the force:data:bulk:delete or force:data:bulk:upsert
-  commands.
+  Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record.
+  If your list of fields identifies more than one record, the delete fails; the error displays how many records were
+  found.
+
+  When specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of
+  double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
+
+  This command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:delete
 
 EXAMPLES
-  $ sfdx force:data:bulk:status -i 750xx000000005sAAA
+  Delete a record from Account with the specified (truncated) ID:
+
+    $ sfdx data:delete:record --sobject Account --record-id 00180XX
+
+  Delete a record from Account whose name equals "Acme":
+
+    $ sfdx data:delete:record --sobject Account --where "Name=Acme"
+
+  Delete a record from Account identified with two field values, one that contains a space; the command uses the org
+  with alias "my-scratch":
+
+    $ sfdx data:delete:record --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
+      --target-org myscratch
+
+  Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:
 
-  $ sfdx force:data:bulk:status -i 750xx000000005sAAA -b 751xx000000005nAAA
+    $ sfdx data:delete:record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/force/data/bulk/status.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/bulk/status.ts)_
+_See code: [src/commands/data/delete/record.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/delete/record.ts)_
 
-## `sfdx force:data:bulk:upsert -i <string> -f <filepath> -s <string> [-w <minutes>] [-r] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:export:tree`
 
-bulk upsert records from a CSV file
+Export data from an org into one or more JSON files.
 
 ```
 USAGE
-  $ sfdx force:data:bulk:upsert -i <string> -f <filepath> -s <string> [-w <minutes>] [-r] [-u <string>] [--apiversion
-    <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:export:tree -o <value> -q <value> [--json] [--api-version <value>] [-p] [-x <value>] [-d <value>]
 
 FLAGS
-  -f, --csvfile=<value>                                                             (required) the path to the CSV file
-                                                                                    that defines the records to upsert
-  -i, --externalid=<value>                                                          (required) the column name of the
-                                                                                    external ID
-  -r, --serial                                                                      run batches in serial mode
-  -s, --sobjecttype=<value>                                                         (required) the sObject type of the
-                                                                                    records you want to upsert
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -w, --wait=<value>                                                                the number of minutes to wait for
-                                                                                    the command to complete before
-                                                                                    displaying the results
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-dir=<value>  Directory in which to generate the JSON files; default is current directory.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -p, --plan                Generate multiple sObject tree files and a plan definition file for aggregated import.
+  -q, --query=<value>       (required) SOQL query, or filepath of a file that contains the query, to retrieve records.
+  -x, --prefix=<value>      Prefix of generated files.
+  --api-version=<value>     Override the api version used for api requests made by this command
 
-DESCRIPTION
-  bulk upsert records from a CSV file
+GLOBAL FLAGS
+  --json  Format output as json.
 
-  Inserts or updates records from a CSV file.
+DESCRIPTION
+  Export data from an org into one or more JSON files.
 
-  One job can contain many batches, depending on the length of the CSV file.
+  Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to
+  export. The exported data is written to JSON files in sObject tree format, which is a collection of nested,
+  parent-child records with a single root record. Use these JSON files to import data into an org with the "sfdx data
+  import tree" command.
 
-  Returns a job ID and a batch ID. Use these IDs to check job status with data:bulk:status.
+  If your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify
+  the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You
+  then specify just this plan definition file when you import the data into an org.
 
-  For information about formatting your CSV file, see "Prepare CSV Files" in the Bulk API Developer Guide.
+  The SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).
 
-  By default, the job runs the batches in parallel. Specify --serial to run them serially.
+ALIASES
+  $ sfdx force:data:tree:export
 
 EXAMPLES
-  $ sfdx force:data:bulk:upsert -s MyObject__c -f ./path/to/file.csv -i MyField__c
+  Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command
+  uses your default org:
+
+    $ sfdx data:export:tree --query "SELECT Id, Name, (SELECT Name, Address\_\_c FROM Properties\_\_r) FROM \
+      Broker\_\_c"
+
+  Export data using a SOQL query in the "query.txt" file and generate JSON files for each object and a plan that
+  aggregates them:
+
+    $ sfdx data:export:tree --query query.txt --plan
 
-  $ sfdx force:data:bulk:upsert -s MyObject__c -f ./path/to/file.csv -i Id -w 2
+  Prepend "export-demo" before each generated file and generate the files in the "export-out" directory; run the
+  command on the org with alias "my-scratch":
+
+    $ sfdx data:export:tree --query query.txt --plan --prefix export-demo --output-dir export-out --target-org \
+      my-scratch
 ```
 
-_See code: [src/commands/force/data/bulk/upsert.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/bulk/upsert.ts)_
+_See code: [src/commands/data/export/tree.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/export/tree.ts)_
 
-## `sfdx force:data:record:create -s <string> -v <string> [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:get:record`
 
-creates and inserts a record
+Retrieve and display a single record of a Salesforce or Tooling API object.
 
 ```
 USAGE
-  $ sfdx force:data:record:create -s <string> -v <string> [-t] [--perflog --json] [-u <string>] [--apiversion <string>]
-    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:get:record -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
 
 FLAGS
-  -s, --sobjecttype=<value>                                                         (required) the type of the record
-                                                                                    you’re creating
-  -t, --usetoolingapi                                                               create the record with tooling api
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -v, --values=<value>                                                              (required) the <fieldName>=<value>
-                                                                                    pairs you’re creating
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
-  --perflog                                                                         get API performance data
+  -i, --record-id=<value>   ID of the record you’re retrieving.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're retrieving a record
+                            from.
+  -t, --use-tooling-api     Use Tooling API so you can retrieve a record from a Tooling API object.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to display.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  creates and inserts a record
+  Retrieve and display a single record of a Salesforce or Tooling API object.
 
-  The format of a field-value pair is <fieldName>=<value>.
+  Specify the record you want to retrieve with either its ID or with a list of field-value pairs that identify the
+  record. If your list of fields identifies more than one record, the command fails; the error displays how many records
+  were found.
 
-  Enclose all field-value pairs in one set of double quotation marks, delimited by spaces.
+  When specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of
+  double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
 
-  Enclose values that contain spaces in single quotes.
+  The command displays all the record's fields and their values, one field per terminal line. Fields with no values are
+  displayed as "null".
 
-  To get data on API performance metrics, specify both --perflog and --json.
+  This command retrieves a record from Salesforce objects by default. Use the --use-tooling-api flag to retrieve from a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:get
 
 EXAMPLES
-  $ sfdx force:data:record:create -s Account -v "Name=Acme"
+  Retrieve and display a record from Account with the specified (truncated) ID:
+
+    $ sfdx data:get:record --sobject Account --record-id 00180XX
 
-  $ sfdx force:data:record:create -s Account -v "Name='Universal Containers'"
+  Retrieve a record from Account whose name equals "Acme":
 
-  $ sfdx force:data:record:create -s Account -v "Name='Universal Containers' Website=www.example.com"
+    $ sfdx data:get:record --sobject Account --where "Name=Acme"
 
-  $ sfdx force:data:record:create -t -s TraceFlag -v "DebugLevelId=7dl170000008U36AAE StartDate=2017-12-01T00:26:04.000+0000 ExpirationDate=2017-12-01T00:56:04.000+0000 LogType=CLASS_TRACING TracedEntityId=01p17000000R6bLAAS"
+  Retrieve a record from Account identified with two field values, one that contains a space; the command uses the org
+  with alias "my-scratch":
 
-  $ sfdx force:data:record:create -s Account -v "Name=Acme" --perflog --json
+    $ sfdx data:get:record --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
+      --target-org myscratch
+
+  Retrieve a record from the Tooling API object TraceFlag with the specified (truncated) ID:
+
+    $ sfdx data:get:record --use-tooling-api --sobject TraceFlag --record-id 7tf8c
 ```
 
-_See code: [src/commands/force/data/record/create.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/record/create.ts)_
+_See code: [src/commands/data/get/record.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/get/record.ts)_
 
-## `sfdx force:data:record:delete -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:import:tree`
 
-deletes a single record
+Import data from one or more JSON files into an org.
 
 ```
 USAGE
-  $ sfdx force:data:record:delete -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion
-    <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:import:tree -o <value> [--json] [--api-version <value>] [-f <value> | -p <value>] [--config-help]
 
 FLAGS
-  -i, --sobjectid=<value>                                                           the ID of the record you’re deleting
-  -s, --sobjecttype=<value>                                                         (required) the type of the record
-                                                                                    you’re deleting
-  -t, --usetoolingapi                                                               delete the record with Tooling API
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -w, --where=<value>                                                               a list of <fieldName>=<value> pairs
-                                                                                    to search for
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
-  --perflog                                                                         get API performance data
+  -f, --files=<value>...    Comma-separated and in-order JSON files that contain the records, in sObject tree format,
+                            that you want to insert.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -p, --plan=<value>        Plan definition file to insert multiple data files.
+  --api-version=<value>     Override the api version used for api requests made by this command
+  --config-help             Display schema information for the --plan configuration file to stdout; if you specify this
+                            flag, all other flags except --json are ignored.
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  deletes a single record
+  Import data from one or more JSON files into an org.
+
+  The JSON files that contain the data are in sObject tree format, which is a collection of nested, parent-child records
+  with a single root record. Use the "sfdx data export tree" command to generate these JSON files.
+
+  If you used the --plan flag when exporting the data to generate a plan definition file, use the --plan flag to
+  reference the file when you import. If you're not using a plan, use the --files flag to list the files. If you specify
+  multiple JSON files that depend on each other in a parent-child relationship, be sure you list them in the correct
+  order.
+
+  The sObject Tree API supports requests that contain up to 200 records. For more information, see the REST API
+  Developer Guide.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm)
+
+ALIASES
+  $ sfdx force:data:tree:import
+
+EXAMPLES
+  Import the records contained in two JSON files into the org with alias "my-scratch":
+
+    $ sfdx data:import:tree --files Contact.json,Account.json --target-org my-scratch
 
-  Specify an sObject type and either an ID or a list of <fieldName>=<value> pairs.
+  Import records using a plan definition file into your default org:
 
-  The format of a field-value pair is <fieldName>=<value>.
+    $ sfdx data:import:tree --plan Account-Contact-plan.json
+```
 
-  Enclose all field-value pairs in one set of double quotation marks, delimited by spaces.
+_See code: [src/commands/data/import/tree.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/import/tree.ts)_
 
-  Enclose values that contain spaces in single quotes.
+## `sfdx data:query`
 
-  To get data on API performance metrics, specify both --perflog and --json.
+Execute a SOQL query.
+
+```
+USAGE
+  $ sfdx data:query -o <value> [--json] [--api-version <value>] [-q <value>] [-f <value>] [-w <value> [-b | -t]]
+    [--async ] [-r human|json|csv]
+
+FLAGS
+  -b, --bulk                            Use Bulk API 2.0 to run the query.
+  -f, --file=<value>                    File that contains the SOQL query.
+  -o, --target-org=<value>              (required) Username or alias of the target org.
+  -q, --query=<value>                   SOQL query to execute.
+  -r, --result-format=(human|json|csv)  [default: human] Format to display the results; the --json flag overrides this
+                                        flag.
+  -t, --use-tooling-api                 Use Tooling API so you can run queries on Tooling API objects.
+  -w, --wait=<value>                    Time to wait for the command to finish, in minutes.
+  --api-version=<value>                 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.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Execute a SOQL query.
+
+  Specify the SOQL query at the command line with the --query flag or read the query from a file with the --file flag.
+
+  If your query returns more than 10,000 records, specify the --bulk flag. The command then runs the query using Bulk
+  API 2.0, which has higher limits than the default API used by the command.
+
+  When using --bulk, the command waits 3 minutes by default for the query to complete. Use the --wait parameter to
+  specify a different number of minutes to wait, or set --wait to 0 to immediately return control to the terminal. If
+  you set --wait to 0, or you use the --async flag, or the command simply times out, the command displays an ID. Pass
+  this ID to the the "data query resume" command using the --bulk-query-id flag to get the results; pass the ID to the
+  "data resume" command to get the job status.
+
+ALIASES
+  $ sfdx force:data:soql:query
 
 EXAMPLES
-  $ sfdx force:data:record:delete -s Account -i 001D000000Kv3dl
+  Specify a SOQL query at the command line; the command uses your default org:
+
+    $ sfdx 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":
+
+    $ sfdx data:query --file query.txt --target-org my-scratch
 
-  $ sfdx force:data:record:delete -s Account -w "Name=Acme"
+  Use Tooling API to run a query on the ApexTrigger Tooling API object:
 
-  $ sfdx force:data:record:delete -s Account -w "Name='Universal Containers'"
+    $ sfdx data:query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
 
-  $ sfdx force:data:record:delete -s Account -w "Name='Universal Containers' Phone='(123) 456-7890'"
+  Use Bulk API 2.0 to run a query that returns many rows, and return control to the terminal immediately:
 
-  $ sfdx force:data:record:delete -t -s TraceFlag -i 7tf170000009cU6AAI --perflog --json
+    $ sfdx data:query --query "SELECT Id FROM Contact" --bulk --wait 0
 ```
 
-_See code: [src/commands/force/data/record/delete.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/record/delete.ts)_
+_See code: [src/commands/data/query.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/query.ts)_
 
-## `sfdx force:data:record:get -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:query:resume`
 
-displays a single record
+View the status of a bulk query.
 
 ```
 USAGE
-  $ sfdx force:data:record:get -s <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion
-    <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:query:resume -o <value> -i <value> [--json] [--api-version <value>] [-r human|json|csv]
 
 FLAGS
-  -i, --sobjectid=<value>                                                           the ID of the record you’re
-                                                                                    retrieving
-  -s, --sobjecttype=<value>                                                         (required) the type of the record
-                                                                                    you’re retrieving
-  -t, --usetoolingapi                                                               retrieve the record with Tooling API
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -w, --where=<value>                                                               a list of <fieldName>=<value> pairs
-                                                                                    to search for
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
-  --perflog                                                                         get API performance data
+  -i, --bulk-query-id=<value>           (required) Job ID of the bulk query.
+  -o, --target-org=<value>              (required) Username or alias of the target org.
+  -r, --result-format=(human|json|csv)  [default: human] Format to display the results; the --json flag overrides this
+                                        flag.
+  --api-version=<value>                 Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  View the status of a bulk query.
+
+  Run this command using the job ID returned from the "sfdx data query --bulk" command.
+
+ALIASES
+  $ sfdx force:data:soql:bulk:report
+
+EXAMPLES
+  View the status of a bulk query with the specified ID:
+
+    $ sfdx data:query:resume --bulk-query-id 7500x000005BdFzXXX
+```
+
+_See code: [src/commands/data/query/resume.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/query/resume.ts)_
+
+## `sfdx data:resume`
+
+View the status of a bulk data load job or batch.
+
+```
+USAGE
+  $ sfdx data:resume -o <value> -i <value> [--json] [--api-version <value>] [-b <value>]
+
+FLAGS
+  -b, --batch-id=<value>    ID of the batch whose status you want to view; you must also specify the job ID.
+  -i, --job-id=<value>      (required) ID of the job whose status you want to view.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  displays a single record
+  View the status of a bulk data load job or batch.
+
+  Run this command using the job ID or batch ID returned from the "sfdx data delete bulk" or "sfdx data upsert bulk"
+  commands.
+
+ALIASES
+  $ sfdx force:data:bulk:status
+
+EXAMPLES
+  View the status of a bulk load job:
+
+    $ sfdx data:resume --job-id 750xx000000005sAAA
+
+  View the status of a bulk load job and a specific batches:
+
+    $ sfdx data:resume --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
+```
+
+_See code: [src/commands/data/resume.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/resume.ts)_
+
+## `sfdx data:update:record`
+
+Updates a single record of a Salesforce or Tooling API object.
+
+```
+USAGE
+  $ sfdx data:update:record -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-i <value>] [-w <value>]
+    [-t]
+
+FLAGS
+  -i, --record-id=<value>   ID of the record you’re updating.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that contains the record you're
+                            updating.
+  -t, --use-tooling-api     Use Tooling API so you can update a record in a Tooling API object.
+  -v, --values=<value>      (required) Fields that you're updating, in the format of <fieldName>=<value> pairs.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to update.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
-  Specify an sObject type and either an ID or a list of <fieldName>=<value> pairs.
+DESCRIPTION
+  Updates a single record of a Salesforce or Tooling API object.
 
-  The format of a field-value pair is <fieldName>=<value>.
+  Specify the record you want to update with either its ID or with a list of field-value pairs that identify the record.
+  If your list of fields identifies more than one record, the delete fails; the error displays how many records were
+  found.
 
-  Enclose all field-value pairs in one set of double quotation marks, delimited by spaces.
+  When using field-value pairs for both identifying the record and specifiyng the new field values, use the format
+  <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose
+  values that contain spaces in single quotes.
 
-  Enclose values that contain spaces in single quotes.
+  This command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API
+  object.
 
-  To get data on API performance metrics, specify both --perflog and --json.
+ALIASES
+  $ sfdx force:data:record:update
 
 EXAMPLES
-  $ sfdx force:data:record:get -s Account -i 001D000000Kv3dl
+  Update the Name field of an Account record with the specified (truncated) ID:
+
+    $ sfdx data:update:record --sobject Account --record-id 001D0 --values "Name=NewAcme"
+
+  Update the Name field of an Account record whose current name is 'Old Acme':
+
+    $ sfdx data:update:record --sobject Account --where "Name='Old Acme'" --values "Name='New Acme'"
 
-  $ sfdx force:data:record:get -s Account -w "Name=Acme"
+  Update the Name and Website fields of an Account record with the specified (truncated) ID:
 
-  $ sfdx force:data:record:get -s Account -w "Name='Universal Containers'"
+    $ sfdx data:update:record --sobject Account --record-id 001D0 --values "Name='Acme III' Website=www.example.com"
 
-  $ sfdx force:data:record:get -s Account -w "Name='Universal Containers' Phone='(123) 456-7890'"
+  Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:
 
-  $ sfdx force:data:record:get -t -s TraceFlag -i 7tf170000009cUBAAY --perflog --json
+    $ sfdx data:update:record -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \
+      "ExpirationDate=2017-12-01T00:58:04.000+0000"
 ```
 
-_See code: [src/commands/force/data/record/get.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/record/get.ts)_
+_See code: [src/commands/data/update/record.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/update/record.ts)_
 
-## `sfdx force:data:record:update -s <string> -v <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+## `sfdx data:upsert:bulk`
 
-updates a single record
+Bulk upsert records to an org from a CSV file.
 
 ```
 USAGE
-  $ sfdx force:data:record:update -s <string> -v <string> [-i <id> | -w <string>] [-t] [--perflog --json] [-u <string>]
-    [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx data:upsert:bulk -o <value> -i <value> -f <value> -s <value> [--json] [--api-version <value>] [-w <value>]
+    [-r]
 
 FLAGS
-  -i, --sobjectid=<value>                                                           the ID of the record you’re updating
-  -s, --sobjecttype=<value>                                                         (required) the sObject type of the
-                                                                                    record you’re updating
-  -t, --usetoolingapi                                                               update the record with Tooling API
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -v, --values=<value>                                                              (required) the <fieldName>=<value>
-                                                                                    pairs you’re updating
-  -w, --where=<value>                                                               a list of <fieldName>=<value> pairs
-                                                                                    to search for
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
-  --perflog                                                                         get API performance data
+  -f, --file=<value>         (required) CSV file that contains the records to upsert.
+  -i, --external-id=<value>  (required) Name of the external ID field, or the Id field.
+  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -r, --serial               Run batches in serial mode.
+  -s, --sobject=<value>      (required) API name of the Salesforce object, either standard or custom, that you want to
+                             upsert records to.
+  -w, --wait=<value>         [default: 0 minutes] Number of minutes to wait for the command to complete before
+                             displaying the results.
+  --api-version=<value>      Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  updates a single record
+  Bulk upsert records to an org from a CSV file.
 
-  The format of a field-value pair is <fieldName>=<value>.
+  An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if
+  it does exist.
 
-  Enclose all field-value pairs in one set of double quotation marks, delimited by spaces.
+  When you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately
+  returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of
+  minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with
+  the "sfdx data resume" command. A single job can contain many batches, depending on the length of the CSV file.
 
-  Enclose values that contain spaces in single quotes.
+  See "Prepare CSV Files" in the Bulk API Developer Guide for details on formatting your CSV file.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm)
 
-  To get data on API performance metrics, specify both --perflog and --json.
+  By default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the
+  --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and
+  you can't reorganize your batches to avoid the locks.
+
+ALIASES
+  $ sfdx force:data:bulk:upsert
 
 EXAMPLES
-  $ sfdx force:data:record:update -s Account -i 001D000000Kv3dl -v "Name=NewAcme"
+  Bulk upsert records to the Contact object:
+
+    $ sfdx --sobject Contact --file files/contacts.csv --external-id Id
 
-  $ sfdx force:data:record:update -s Account -w "Name='Old Acme'" -v "Name='New Acme'"
+  Bulk upsert records to a custom object and wait 5 minutes for the command to complete:
+
+    $ sfdx data:upsert:bulk --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5
+```
 
-  $ sfdx force:data:record:update -s Account -i 001D000000Kv3dl -v "Name='Acme III' Website=www.example.com"
+_See code: [src/commands/data/upsert/bulk.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.21/src/commands/data/upsert/bulk.ts)_
 
-  $ sfdx force:data:record:update -t -s TraceFlag -i 7tf170000009cUBAAY -v "ExpirationDate=2017-12-01T00:58:04.000+0000"
+## `sfdx force:data:bulk:delete`
+
+Bulk delete records from an org using a CSV file.
 
-  $sfdx force:data:record:update -s Account -i 001D000000Kv3dl -v "Name=NewAcme" --perflog --json
 ```
+USAGE
+  $ sfdx force:data:bulk:delete -o <value> -f <value> -s <value> [--json] [--api-version <value>] [-w <value>]
+
+FLAGS
+  -f, --file=<value>        (required) CSV file that contains the IDs of the records to delete.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce object, either standard or custom, that you want to
+                            delete records from.
+  -w, --wait=<value>        [default: 0 minutes] Number of minutes to wait for the command to complete before displaying
+                            the results.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Bulk delete records from an org using a CSV file.
+
+  The CSV file must have only one column ("Id") and then the list of record IDs you want to delete, one ID per line.
 
-_See code: [src/commands/force/data/record/update.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/record/update.ts)_
+  When you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately
+  returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of
+  minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with
+  the "sfdx data resume" command. A single job can contain many batches, depending on the length of the CSV file.
 
-## `sfdx force:data:soql:bulk:report -i <string> [-r human|csv|json] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+ALIASES
+  $ sfdx force:data:bulk:delete
 
-view the status of a bulk query
+EXAMPLES
+  Bulk delete Account records using the list of IDs in the "files/delete.csv" file:
+
+    $ sfdx force:data:bulk:delete --sobject Account --file files/delete.csv
+
+  Bulk delete records from a custom object and wait 5 minutes for the command to complete:
+
+    $ sfdx force:data:bulk:delete --sobject MyObject__c --file files/delete.csv --wait 5
+```
+
+## `sfdx force:data:bulk:status`
+
+View the status of a bulk data load job or batch.
 
 ```
 USAGE
-  $ sfdx force:data:soql:bulk:report -i <string> [-r human|csv|json] [-u <string>] [--apiversion <string>] [--json] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx force:data:bulk:status -o <value> -i <value> [--json] [--api-version <value>] [-b <value>]
 
 FLAGS
-  -i, --bulkqueryid=<value>                                                         (required) the job ID of the bulk
-                                                                                    query
-  -r, --resultformat=(human|csv|json)                                               [default: human] result format
-                                                                                    emitted to stdout; --json flag
-                                                                                    overrides this parameter
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -b, --batch-id=<value>    ID of the batch whose status you want to view; you must also specify the job ID.
+  -i, --job-id=<value>      (required) ID of the job whose status you want to view.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  view the status of a bulk query
+  View the status of a bulk data load job or batch.
 
-  Run this command using the job ID returned from the force:data:soql:query --bulk command.
+  Run this command using the job ID or batch ID returned from the "sfdx data delete bulk" or "sfdx data upsert bulk"
+  commands.
+
+ALIASES
+  $ sfdx force:data:bulk:status
 
 EXAMPLES
-  $ sfdx force:data:soql:bulk:report -i 7500x000005BdFzXXX
+  View the status of a bulk load job:
+
+    $ sfdx force:data:bulk:status --job-id 750xx000000005sAAA
+
+  View the status of a bulk load job and a specific batches:
+
+    $ sfdx force:data:bulk:status --job-id 750xx000000005sAAA --batch-id 751xx000000005nAAA
 ```
 
-_See code: [src/commands/force/data/soql/bulk/report.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/soql/bulk/report.ts)_
+## `sfdx force:data:bulk:upsert`
 
-## `sfdx force:data:soql:query [-q <string> | -f <filepath>] [-w <minutes> [-b | -t]] [-r human|csv|json] [--perflog --json] [-u <string>] [--apiversion <string>] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+Bulk upsert records to an org from a CSV file.
 
-execute a SOQL query
+```
+USAGE
+  $ sfdx force:data:bulk:upsert -o <value> -i <value> -f <value> -s <value> [--json] [--api-version <value>] [-w <value>]
+    [-r]
+
+FLAGS
+  -f, --file=<value>         (required) CSV file that contains the records to upsert.
+  -i, --external-id=<value>  (required) Name of the external ID field, or the Id field.
+  -o, --target-org=<value>   (required) Username or alias of the target org.
+  -r, --serial               Run batches in serial mode.
+  -s, --sobject=<value>      (required) API name of the Salesforce object, either standard or custom, that you want to
+                             upsert records to.
+  -w, --wait=<value>         [default: 0 minutes] Number of minutes to wait for the command to complete before
+                             displaying the results.
+  --api-version=<value>      Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Bulk upsert records to an org from a CSV file.
+
+  An upsert refers to inserting a record into a Salesforce object if the record doesn't already exist, or updating it if
+  it does exist.
+
+  When you execute this command, it starts a job and one or more batches, displays their IDs, and then immediately
+  returns control of the terminal to you by default. If you prefer to wait, set the --wait flag to the number of
+  minutes; if it times out, the command outputs the IDs. Use the job and batch IDs to check the status of the job with
+  the "sfdx data resume" command. A single job can contain many batches, depending on the length of the CSV file.
+
+  See "Prepare CSV Files" in the Bulk API Developer Guide for details on formatting your CSV file.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_csv_preparing.htm)
+
+  By default, the job runs the batches in parallel, which we recommend. You can run jobs serially by specifying the
+  --serial flag. But don't process data in serial mode unless you know this would otherwise result in lock timeouts and
+  you can't reorganize your batches to avoid the locks.
+
+ALIASES
+  $ sfdx force:data:bulk:upsert
+
+EXAMPLES
+  Bulk upsert records to the Contact object:
+
+    $ sfdx --sobject Contact --file files/contacts.csv --external-id Id
+
+  Bulk upsert records to a custom object and wait 5 minutes for the command to complete:
+
+    $ sfdx force:data:bulk:upsert --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5
+```
+
+## `sfdx force:data:record:create`
+
+Create and insert a record into a Salesforce or Tooling API object.
+
+```
+USAGE
+  $ sfdx force:data:record:create -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-t]
+
+FLAGS
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're inserting a record
+                            into.
+  -t, --use-tooling-api     Use Tooling API so you can insert a record in a Tooling API object.
+  -v, --values=<value>      (required) Values for the flags in the form <fieldName>=<value>, separate multiple pairs
+                            with spaces.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Create and insert a record into a Salesforce or Tooling API object.
+
+  You must specify a value for all required fields of the object.
+
+  When specifying fields, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double
+  quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
+
+  This command inserts a record into Salesforce objects by default. Use the --use-tooling-api flag to insert into a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:create
+
+EXAMPLES
+  Insert a record into the Account object of your default org; only the required Name field has a value:
+
+    $ sfdx force:data:record:create --sobject Account --values "Name=Acme"
+
+  Insert an Account record with values for two fields, one value contains a space; the command uses the org with alias
+  "my-scratch":
+
+    $ sfdx force:data:record:create --sobject Account --values "Name='Universal Containers' Website=www.example.com" \
+      --target-org my-scratch
+
+  Insert a record into the Tooling API object TraceFlag:
+
+    $ sfdx force:data:record:create --use-tooling-api --sobject TraceFlag --values "DebugLevelId=7dl170000008U36AAE \
+      StartDate=2022-12-15T00:26:04.000+0000 ExpirationDate=2022-12-15T00:56:04.000+0000 LogType=CLASS_TRACING \
+      TracedEntityId=01p17000000R6bLAAS"
+```
+
+## `sfdx force:data:record:delete`
+
+Deletes a single record from a Salesforce or Tooling API object.
+
+```
+USAGE
+  $ sfdx force:data:record:delete -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
+
+FLAGS
+  -i, --record-id=<value>   ID of the record you’re deleting.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're deleting a record
+                            from.
+  -t, --use-tooling-api     Use Tooling API so you can delete a record from a Tooling API object.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to delete.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Deletes a single record from a Salesforce or Tooling API object.
+
+  Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record.
+  If your list of fields identifies more than one record, the delete fails; the error displays how many records were
+  found.
+
+  When specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of
+  double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
+
+  This command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:delete
+
+EXAMPLES
+  Delete a record from Account with the specified (truncated) ID:
+
+    $ sfdx force:data:record:delete --sobject Account --record-id 00180XX
+
+  Delete a record from Account whose name equals "Acme":
+
+    $ sfdx force:data:record:delete --sobject Account --where "Name=Acme"
+
+  Delete a record from Account identified with two field values, one that contains a space; the command uses the org
+  with alias "my-scratch":
+
+    $ sfdx force:data:record:delete --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
+      --target-org myscratch
+
+  Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:
+
+    $ sfdx force:data:record:delete --use-tooling-api --sobject TraceFlag --record-id 7tf8c
+```
+
+## `sfdx force:data:record:get`
+
+Retrieve and display a single record of a Salesforce or Tooling API object.
 
 ```
 USAGE
-  $ sfdx force:data:soql:query [-q <string> | -f <filepath>] [-w <minutes> [-b | -t]] [-r human|csv|json] [--perflog
-    --json] [-u <string>] [--apiversion <string>] [--loglevel
-    trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx force:data:record:get -o <value> -s <value> [--json] [--api-version <value>] [-i <value>] [-w <value>] [-t]
 
 FLAGS
-  -b, --bulk                                                                        use the bulk 2.0 API to query data
-  -f, --soqlqueryfile=<value>                                                       A SOQL query stored in a file
-  -q, --query=<value>                                                               SOQL query to execute
-  -r, --resultformat=(human|csv|json)                                               [default: human] result format
-                                                                                    emitted to stdout; --json flag
-                                                                                    overrides this parameter
-  -t, --usetoolingapi                                                               execute query with Tooling API
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -w, --wait=<value>                                                                wait time for command to finish in
-                                                                                    minutes
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
-  --perflog                                                                         get API performance data
+  -i, --record-id=<value>   ID of the record you’re retrieving.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that you're retrieving a record
+                            from.
+  -t, --use-tooling-api     Use Tooling API so you can retrieve a record from a Tooling API object.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to display.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  execute a SOQL query
+  Retrieve and display a single record of a Salesforce or Tooling API object.
+
+  Specify the record you want to retrieve with either its ID or with a list of field-value pairs that identify the
+  record. If your list of fields identifies more than one record, the command fails; the error displays how many records
+  were found.
+
+  When specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of
+  double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.
 
-  When you execute this command in a project, it executes the query against the data in your default scratch org.
+  The command displays all the record's fields and their values, one field per terminal line. Fields with no values are
+  displayed as "null".
 
-  To get data on API performance metrics, specify both --perflog and --json.
+  This command retrieves a record from Salesforce objects by default. Use the --use-tooling-api flag to retrieve from a
+  Tooling API object.
+
+ALIASES
+  $ sfdx force:data:record:get
 
 EXAMPLES
-  $ sfdx force:data:soql:query -q "SELECT Id, Name, Account.Name FROM Contact"
+  Retrieve and display a record from Account with the specified (truncated) ID:
+
+    $ sfdx force:data:record:get --sobject Account --record-id 00180XX
+
+  Retrieve a record from Account whose name equals "Acme":
+
+    $ sfdx force:data:record:get --sobject Account --where "Name=Acme"
 
-  $ sfdx force:data:soql:query -q "SELECT Id, Name FROM Account WHERE ShippingState IN ('CA', 'NY')"
+  Retrieve a record from Account identified with two field values, one that contains a space; the command uses the org
+  with alias "my-scratch":
 
-  $ sfdx force:data:soql:query -q "SELECT Id, Name FROM Account WHERE ShippingState IN ('CA', 'NY')" --perflog --json
+    $ sfdx force:data:record:get --sobject Account --where "Name='Universal Containers' Phone='(123) 456-7890'" \
+      --target-org myscratch
 
-  $ sfdx force:data:soql:query -q "SELECT Name FROM ApexTrigger" -t
+  Retrieve a record from the Tooling API object TraceFlag with the specified (truncated) ID:
 
-  $ sfdx force:data:soql:query --soqlqueryfile query.txt
+    $ sfdx force:data:record:get --use-tooling-api --sobject TraceFlag --record-id 7tf8c
+```
+
+## `sfdx force:data:record:update`
+
+Updates a single record of a Salesforce or Tooling API object.
 
-  $ sfdx force:data:soql:query --soqlqueryfile query.txt -t
 ```
+USAGE
+  $ sfdx force:data:record:update -o <value> -s <value> -v <value> [--json] [--api-version <value>] [-i <value>] [-w <value>]
+    [-t]
+
+FLAGS
+  -i, --record-id=<value>   ID of the record you’re updating.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -s, --sobject=<value>     (required) API name of the Salesforce or Tooling API object that contains the record you're
+                            updating.
+  -t, --use-tooling-api     Use Tooling API so you can update a record in a Tooling API object.
+  -v, --values=<value>      (required) Fields that you're updating, in the format of <fieldName>=<value> pairs.
+  -w, --where=<value>       List of <fieldName>=<value> pairs that identify the record you want to update.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Updates a single record of a Salesforce or Tooling API object.
+
+  Specify the record you want to update with either its ID or with a list of field-value pairs that identify the record.
+  If your list of fields identifies more than one record, the delete fails; the error displays how many records were
+  found.
+
+  When using field-value pairs for both identifying the record and specifiyng the new field values, use the format
+  <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose
+  values that contain spaces in single quotes.
+
+  This command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API
+  object.
+
+ALIASES
+  $ sfdx force:data:record:update
+
+EXAMPLES
+  Update the Name field of an Account record with the specified (truncated) ID:
+
+    $ sfdx force:data:record:update --sobject Account --record-id 001D0 --values "Name=NewAcme"
+
+  Update the Name field of an Account record whose current name is 'Old Acme':
+
+    $ sfdx force:data:record:update --sobject Account --where "Name='Old Acme'" --values "Name='New Acme'"
 
-_See code: [src/commands/force/data/soql/query.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/soql/query.ts)_
+  Update the Name and Website fields of an Account record with the specified (truncated) ID:
 
-## `sfdx force:data:tree:export -q <string> [-p] [-x <string>] [-d <directory>] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+    $ sfdx force:data:record:update --sobject Account --record-id 001D0 --values "Name='Acme III' \
+      Website=www.example.com"
 
-export data from an org
+  Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:
+
+    $ sfdx force:data:record:update -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \
+      "ExpirationDate=2017-12-01T00:58:04.000+0000"
+```
+
+## `sfdx force:data:soql:bulk:report`
+
+View the status of a bulk query.
 
 ```
 USAGE
-  $ sfdx force:data:tree:export -q <string> [-p] [-x <string>] [-d <directory>] [-u <string>] [--apiversion <string>]
-    [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx force:data:soql:bulk:report -o <value> -i <value> [--json] [--api-version <value>] [-r human|json|csv]
 
 FLAGS
-  -d, --outputdir=<value>                                                           directory to store files'
-  -p, --plan                                                                        generate mulitple sobject tree files
-                                                                                    and a plan definition file for
-                                                                                    aggregated import
-  -q, --query=<value>                                                               (required) soql query, or filepath
-                                                                                    of file containing a soql query, to
-                                                                                    retrieve records
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  -x, --prefix=<value>                                                              prefix of generated files
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -i, --bulk-query-id=<value>           (required) Job ID of the bulk query.
+  -o, --target-org=<value>              (required) Username or alias of the target org.
+  -r, --result-format=(human|json|csv)  [default: human] Format to display the results; the --json flag overrides this
+                                        flag.
+  --api-version=<value>                 Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  export data from an org
+  View the status of a bulk query.
 
-  Exports data from an org into sObject tree format for use with the force:data:tree:import command.
+  Run this command using the job ID returned from the "sfdx data query --bulk" command.
 
-  The query for export can return a maximum of 2,000 records. For more information, see the REST API Developer Guide:
-  https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm
+ALIASES
+  $ sfdx force:data:soql:bulk:report
 
 EXAMPLES
-  $ sfdx force:data:tree:export -q "SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c"
+  View the status of a bulk query with the specified ID:
+
+    $ sfdx force:data:soql:bulk:report --bulk-query-id 7500x000005BdFzXXX
+```
+
+## `sfdx force:data:soql:query`
+
+Execute a SOQL query.
 
-  $ sfdx force:data:tree:export -q <path to file containing soql query> -x export-demo -d /tmp/sfdx-out -p
 ```
+USAGE
+  $ sfdx force:data:soql:query -o <value> [--json] [--api-version <value>] [-q <value>] [-f <value>] [-w <value> [-b | -t]]
+    [--async ] [-r human|json|csv]
+
+FLAGS
+  -b, --bulk                            Use Bulk API 2.0 to run the query.
+  -f, --file=<value>                    File that contains the SOQL query.
+  -o, --target-org=<value>              (required) Username or alias of the target org.
+  -q, --query=<value>                   SOQL query to execute.
+  -r, --result-format=(human|json|csv)  [default: human] Format to display the results; the --json flag overrides this
+                                        flag.
+  -t, --use-tooling-api                 Use Tooling API so you can run queries on Tooling API objects.
+  -w, --wait=<value>                    Time to wait for the command to finish, in minutes.
+  --api-version=<value>                 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.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Execute a SOQL query.
+
+  Specify the SOQL query at the command line with the --query flag or read the query from a file with the --file flag.
+
+  If your query returns more than 10,000 records, specify the --bulk flag. The command then runs the query using Bulk
+  API 2.0, which has higher limits than the default API used by the command.
+
+  When using --bulk, the command waits 3 minutes by default for the query to complete. Use the --wait parameter to
+  specify a different number of minutes to wait, or set --wait to 0 to immediately return control to the terminal. If
+  you set --wait to 0, or you use the --async flag, or the command simply times out, the command displays an ID. Pass
+  this ID to the the "data query resume" command using the --bulk-query-id flag to get the results; pass the ID to the
+  "data resume" command to get the job status.
 
-_See code: [src/commands/force/data/tree/export.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/tree/export.ts)_
+ALIASES
+  $ sfdx force:data:soql:query
 
-## `sfdx force:data:tree:import [-f <array> | -p <filepath>] [--confighelp] [-u <string>] [--apiversion <string>] [--json] [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]`
+EXAMPLES
+  Specify a SOQL query at the command line; the command uses your default org:
+
+    $ sfdx force:data:soql: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":
+
+    $ sfdx force:data:soql:query --file query.txt --target-org my-scratch
+
+  Use Tooling API to run a query on the ApexTrigger Tooling API object:
 
-import data into an org
+    $ sfdx force:data:soql:query --query "SELECT Name FROM ApexTrigger" --use-tooling-api
+
+  Use Bulk API 2.0 to run a query that returns many rows, and return control to the terminal immediately:
+
+    $ sfdx force:data:soql:query --query "SELECT Id FROM Contact" --bulk --wait 0
+```
+
+## `sfdx force:data:tree:export`
+
+Export data from an org into one or more JSON files.
 
 ```
 USAGE
-  $ sfdx force:data:tree:import [-f <array> | -p <filepath>] [--confighelp] [-u <string>] [--apiversion <string>] [--json]
-    [--loglevel trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL]
+  $ sfdx force:data:tree:export -o <value> -q <value> [--json] [--api-version <value>] [-p] [-x <value>] [-d <value>]
 
 FLAGS
-  -f, --sobjecttreefiles=<value>                                                    comma-delimited, ordered paths of
-                                                                                    json files containing collection of
-                                                                                    record trees to insert
-  -p, --plan=<value>                                                                path to plan to insert multiple data
-                                                                                    files that have master-detail
-                                                                                    relationships
-  -u, --targetusername=<value>                                                      username or alias for the target
-                                                                                    org; overrides default target org
-  --apiversion=<value>                                                              override the api version used for
-                                                                                    api requests made by this command
-  --confighelp                                                                      display schema information for the
-                                                                                    --plan configuration file to stdout;
-                                                                                    if you use this option, all other
-                                                                                    options except --json are ignored
-  --json                                                                            format output as json
-  --loglevel=(trace|debug|info|warn|error|fatal|TRACE|DEBUG|INFO|WARN|ERROR|FATAL)  [default: warn] logging level for
-                                                                                    this command invocation
+  -d, --output-dir=<value>  Directory in which to generate the JSON files; default is current directory.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -p, --plan                Generate multiple sObject tree files and a plan definition file for aggregated import.
+  -q, --query=<value>       (required) SOQL query, or filepath of a file that contains the query, to retrieve records.
+  -x, --prefix=<value>      Prefix of generated files.
+  --api-version=<value>     Override the api version used for api requests made by this command
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  import data into an org
+  Export data from an org into one or more JSON files.
 
-  IMPORTANT: Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained
-  certain terms to avoid any effect on customer implementations.
+  Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to
+  export. The exported data is written to JSON files in sObject tree format, which is a collection of nested,
+  parent-child records with a single root record. Use these JSON files to import data into an org with the "sfdx data
+  import tree" command.
 
-  Imports data into an org using the SObject Tree Save API.  This data can include master-detail relationships.
+  If your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify
+  the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You
+  then specify just this plan definition file when you import the data into an org.
 
-  To generate JSON files for use with force:data:tree:import, run "sfdx force:data:tree:export".
+  The SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).
 
-  The SObject Tree API supports requests that contain up to 200 records. For more information, see the REST API
-  Developer Guide:
-  https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm
+ALIASES
+  $ sfdx force:data:tree:export
 
 EXAMPLES
-  $ sfdx force:data:tree:import -f Contact.json,Account.json -u me@my.org
+  Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command
+  uses your default org:
+
+    $ sfdx force:data:tree:export --query "SELECT Id, Name, (SELECT Name, Address\_\_c FROM Properties\_\_r) FROM \
+      Broker\_\_c"
+
+  Export data using a SOQL query in the "query.txt" file and generate JSON files for each object and a plan that
+  aggregates them:
+
+    $ sfdx force:data:tree:export --query query.txt --plan
+
+  Prepend "export-demo" before each generated file and generate the files in the "export-out" directory; run the
+  command on the org with alias "my-scratch":
+
+    $ sfdx force:data:tree:export --query query.txt --plan --prefix export-demo --output-dir export-out --target-org \
+      my-scratch
+```
+
+## `sfdx force:data:tree:import`
+
+Import data from one or more JSON files into an org.
 
-  $ sfdx force:data:tree:import -p Account-Contact-plan.json -u me@my.org
 ```
+USAGE
+  $ sfdx force:data:tree:import -o <value> [--json] [--api-version <value>] [-f <value> | -p <value>] [--config-help]
+
+FLAGS
+  -f, --files=<value>...    Comma-separated and in-order JSON files that contain the records, in sObject tree format,
+                            that you want to insert.
+  -o, --target-org=<value>  (required) Username or alias of the target org.
+  -p, --plan=<value>        Plan definition file to insert multiple data files.
+  --api-version=<value>     Override the api version used for api requests made by this command
+  --config-help             Display schema information for the --plan configuration file to stdout; if you specify this
+                            flag, all other flags except --json are ignored.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Import data from one or more JSON files into an org.
+
+  The JSON files that contain the data are in sObject tree format, which is a collection of nested, parent-child records
+  with a single root record. Use the "sfdx data export tree" command to generate these JSON files.
 
-_See code: [src/commands/force/data/tree/import.ts](https://github.com/salesforcecli/plugin-data/blob/v2.1.1/src/commands/force/data/tree/import.ts)_
+  If you used the --plan flag when exporting the data to generate a plan definition file, use the --plan flag to
+  reference the file when you import. If you're not using a plan, use the --files flag to list the files. If you specify
+  multiple JSON files that depend on each other in a parent-child relationship, be sure you list them in the correct
+  order.
+
+  The sObject Tree API supports requests that contain up to 200 records. For more information, see the REST API
+  Developer Guide.
+  (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm)
+
+ALIASES
+  $ sfdx force:data:tree:import
+
+EXAMPLES
+  Import the records contained in two JSON files into the org with alias "my-scratch":
+
+    $ sfdx force:data:tree:import --files Contact.json,Account.json --target-org my-scratch
+
+  Import records using a plan definition file into your default org:
+
+    $ sfdx force:data:tree:import --plan Account-Contact-plan.json
+```
 
 <!-- commandsstop -->