@salesforce/plugin-data 4.0.30 → 4.0.32

package/oclif.manifest.json

@@ -401,83 +401,6 @@
         "search:data"
       ]
     },
-    "data:bulk:results": {
-      "aliases": [],
-      "args": {},
-      "description": "Use this command to get the complete results after running one of the CLI commands that uses Bulk API 2.0 to ingest (import, update, upsert, or delete) large datasets to your org, such as \"data import bulk\". The previously-run bulk command must have completed; if it's still processing, run the corresponding resume command first, such as \"data import resume.\" Make note of the job ID of the previous bulk command because you use it to run this command. \n\nYou can also use this command to get results from running a bulk ingest job with a different tool, such as Data Loader, as long as you have the job ID. For information on Data Loader, see https://developer.salesforce.com/docs/atlas.en-us.dataLoader.meta/dataLoader/data_loader_intro.htm. \n\nThis command first displays the status of the previous bulk job, the operation that was executed in the org (such as insert or hard delete), and the updated Salesforce object. The command then displays how many records were processed in total, and how many were successful or failed. Finally, the output displays the names of the generated CSV-formatted files that contain the specific results for each ingested record. Depending on the success or failure of the bulk command, the results files can include the IDs of inserted records or the specific errors. When possible, if the ingest job failed or was aborted, you also get a CSV file with the unprocessed results.",
-      "examples": [
-        "Get results from a bulk ingest job; use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --job-id 7507i000fake341G --target-org my-scratch"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "job-id": {
-          "char": "i",
-          "name": "job-id",
-          "required": true,
-          "summary": "Job ID of the bulk job.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "data:bulk:results",
-      "pluginAlias": "@salesforce/plugin-data",
-      "pluginName": "@salesforce/plugin-data",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Get the results of a bulk ingest job that you previously ran.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "data",
-        "bulk",
-        "results.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "data:bulk:results",
-        "bulk:data:results",
-        "bulk:results:data",
-        "data:results:bulk",
-        "results:data:bulk",
-        "results:bulk:data"
-      ]
-    },
     "data:create:file": {
       "aliases": [],
       "args": {},
@@ -735,6 +658,83 @@
         "record:create:data"
       ]
     },
+    "data:bulk:results": {
+      "aliases": [],
+      "args": {},
+      "description": "Use this command to get the complete results after running one of the CLI commands that uses Bulk API 2.0 to ingest (import, update, upsert, or delete) large datasets to your org, such as \"data import bulk\". The previously-run bulk command must have completed; if it's still processing, run the corresponding resume command first, such as \"data import resume.\" Make note of the job ID of the previous bulk command because you use it to run this command. \n\nYou can also use this command to get results from running a bulk ingest job with a different tool, such as Data Loader, as long as you have the job ID. For information on Data Loader, see https://developer.salesforce.com/docs/atlas.en-us.dataLoader.meta/dataLoader/data_loader_intro.htm. \n\nThis command first displays the status of the previous bulk job, the operation that was executed in the org (such as insert or hard delete), and the updated Salesforce object. The command then displays how many records were processed in total, and how many were successful or failed. Finally, the output displays the names of the generated CSV-formatted files that contain the specific results for each ingested record. Depending on the success or failure of the bulk command, the results files can include the IDs of inserted records or the specific errors. When possible, if the ingest job failed or was aborted, you also get a CSV file with the unprocessed results.",
+      "examples": [
+        "Get results from a bulk ingest job; use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --job-id 7507i000fake341G --target-org my-scratch"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "job-id": {
+          "char": "i",
+          "name": "job-id",
+          "required": true,
+          "summary": "Job ID of the bulk job.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "data:bulk:results",
+      "pluginAlias": "@salesforce/plugin-data",
+      "pluginName": "@salesforce/plugin-data",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Get the results of a bulk ingest job that you previously ran.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "data",
+        "bulk",
+        "results.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "data:bulk:results",
+        "bulk:data:results",
+        "bulk:results:data",
+        "data:results:bulk",
+        "results:data:bulk",
+        "results:bulk:data"
+      ]
+    },
     "data:delete:bulk": {
       "aliases": [],
       "args": {},
@@ -1765,13 +1765,13 @@
         "record:get:data"
       ]
     },
-    "data:update:bulk": {
+    "data:import:bulk": {
       "aliases": [],
       "args": {},
-      "description": "You can use this command to update millions of Salesforce object records based on a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using \"sf data upsert bulk\" if you also want to insert new records.\n\nBulk updates can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data update resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
+      "description": "You can use this command to import millions of records into the object from a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag.\n\nBulk imports can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data import resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
       "examples": [
-        "Update Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the update doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
-        "Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data update resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
+        "Import Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the import doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
+        "Import asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data import resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
       ],
       "flags": {
         "json": {
@@ -1792,24 +1792,19 @@
         "async": {
           "char": "a",
           "deprecated": true,
+          "exclusive": [
+            "wait"
+          ],
           "name": "async",
           "summary": "Don't wait for the command to complete.",
           "allowNo": false,
           "type": "boolean"
         },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
         "file": {
           "char": "f",
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the Salesforce object records you want to update.",
+          "summary": "CSV file that contains the Salesforce object records you want to import.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1818,7 +1813,7 @@
           "char": "s",
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
+          "summary": "API name of the Salesforce object, either standard or custom, into which you're importing records.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1830,6 +1825,17 @@
           "multiple": false,
           "type": "option"
         },
+        "wait": {
+          "char": "w",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
         "target-org": {
           "char": "o",
           "name": "target-org",
@@ -1872,43 +1878,38 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:bulk",
+      "id": "data:import:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Bulk import records into a Salesforce object from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
+        "import",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:bulk",
-        "update:data:bulk",
-        "update:bulk:data",
-        "data:bulk:update",
-        "bulk:data:update",
-        "bulk:update:data"
+        "data:import:bulk",
+        "import:data:bulk",
+        "import:bulk:data",
+        "data:bulk:import",
+        "bulk:data:import",
+        "bulk:import:data"
       ]
     },
-    "data:update:record": {
-      "aliases": [
-        "force:data:record:update"
-      ],
+    "data:import:resume": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "description": "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 update fails; the error displays how many records were found.\n\nWhen 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.\n\nThis command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
+      "description": "When the original \"sf data import bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk import, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk import job.",
       "examples": [
-        "Update the Name field of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name=NewAcme\"",
-        "Update the Name field of an Account record whose current name is 'Old Acme':\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Old Acme'\" --values \"Name='New Acme'\"",
-        "Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
-        "Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
+        "Resume a bulk import job to your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk import job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -1926,165 +1927,67 @@
           "multiple": false,
           "type": "option"
         },
-        "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
-          "char": "o",
-          "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
+        "use-most-recent": {
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the bulk import job that was most recently run.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "job-id": {
+          "char": "i",
+          "name": "job-id",
+          "summary": "Job ID of the bulk import.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
-          "aliases": [
-            "sobjecttype"
-          ],
-          "char": "s",
-          "deprecateAliases": true,
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "record-id": {
-          "aliases": [
-            "sobjectid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "record-id",
-          "summary": "ID of the record you’re updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "where": {
+        "wait": {
           "char": "w",
-          "name": "where",
-          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "values": {
-          "char": "v",
-          "name": "values",
-          "required": true,
-          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
-          "hasDynamicHelp": false,
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "default": "5 minutes",
+          "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
-        },
-        "use-tooling-api": {
-          "aliases": [
-            "usetoolingapi"
-          ],
-          "char": "t",
-          "deprecateAliases": true,
-          "name": "use-tooling-api",
-          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "perflog": {
-          "deprecated": {
-            "version": "57"
-          },
-          "hidden": true,
-          "name": "perflog",
-          "summary": "Get API performance data.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:record",
+      "id": "data:import:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Updates a single record of a Salesforce or Tooling API object.",
+      "summary": "Resume a bulk import job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
-        "record.js"
-      ],
-      "aliasPermutations": [
-        "force:data:record:update",
-        "data:force:record:update",
-        "data:record:force:update",
-        "data:record:update:force",
-        "force:record:data:update",
-        "record:force:data:update",
-        "record:data:force:update",
-        "record:data:update:force",
-        "force:record:update:data",
-        "record:force:update:data",
-        "record:update:force:data",
-        "record:update:data:force",
-        "force:data:update:record",
-        "data:force:update:record",
-        "data:update:force:record",
-        "data:update:record:force",
-        "force:update:data:record",
-        "update:force:data:record",
-        "update:data:force:record",
-        "update:data:record:force",
-        "force:update:record:data",
-        "update:force:record:data",
-        "update:record:force:data",
-        "update:record:data:force"
+        "import",
+        "resume.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:update:record",
-        "update:data:record",
-        "update:record:data",
-        "data:record:update",
-        "record:data:update",
-        "record:update:data"
+        "data:import:resume",
+        "import:data:resume",
+        "import:resume:data",
+        "data:resume:import",
+        "resume:data:import",
+        "resume:import:data"
       ]
     },
-    "data:update:resume": {
-      "aliases": [],
+    "data:import:tree": {
+      "aliases": [
+        "force:data:tree:import"
+      ],
       "args": {},
-      "description": "When the original \"sf data update bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.",
+      "deprecateAliases": true,
+      "description": "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 \"<%= config.bin %> data export tree\" command to generate these JSON files.\n\nIf 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.",
       "examples": [
-        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk update job for an org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+        "Import the records contained in two JSON files into the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --files Contact.json,Account.json --target-org my-scratch",
+        "Import records using a plan definition file into your default org:\n<%= config.bin %> <%= command.id %> --plan Account-Contact-plan.json"
       ],
       "flags": {
         "json": {
@@ -2102,64 +2005,124 @@
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the bulk update job that was most recently run.",
-          "allowNo": false,
-          "type": "boolean"
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
         },
-        "job-id": {
-          "char": "i",
-          "name": "job-id",
-          "summary": "Job ID of the bulk update.",
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
-          "default": "5 minutes",
-          "hasDynamicHelp": true,
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "files": {
+          "aliases": [
+            "sobjecttreefiles"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "name": "files",
+          "summary": "Comma-separated and in-order JSON files that contain the records, in sObject tree format, that you want to insert.",
+          "delimiter": ",",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "plan": {
+          "char": "p",
+          "description": "Unlike when you use the `--files` flag, the files listed in the plan definition file **can** contain more then 200 records. When the CLI executes the import, it automatically batches the records to comply with the 200 record limit set by the API.\n\nThe order in which you list the files in the plan definition file matters. Specifically, records with lookups to records in another file should be listed AFTER that file. For example, let's say you're loading Account and Contact records, and the contacts have references to those accounts. Be sure you list the Accounts file before the Contacts file.\n\nThe plan definition file has the following schema:\n\n- items(object) - SObject Type: Definition of records to be insert per SObject Type\n  - sobject(string) - Name of SObject: Child file references must have SObject roots of this type\n  - files(array) - Files: An array of files paths to load",
+          "name": "plan",
+          "summary": "Plan definition file to insert multiple data files.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:resume",
+      "id": "data:import:tree",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Import data from one or more JSON files into an org.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
-        "resume.js"
+        "import",
+        "tree.js"
+      ],
+      "aliasPermutations": [
+        "force:data:tree:import",
+        "data:force:tree:import",
+        "data:tree:force:import",
+        "data:tree:import:force",
+        "force:tree:data:import",
+        "tree:force:data:import",
+        "tree:data:force:import",
+        "tree:data:import:force",
+        "force:tree:import:data",
+        "tree:force:import:data",
+        "tree:import:force:data",
+        "tree:import:data:force",
+        "force:data:import:tree",
+        "data:force:import:tree",
+        "data:import:force:tree",
+        "data:import:tree:force",
+        "force:import:data:tree",
+        "import:force:data:tree",
+        "import:data:force:tree",
+        "import:data:tree:force",
+        "force:import:tree:data",
+        "import:force:tree:data",
+        "import:tree:force:data",
+        "import:tree:data:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:update:resume",
-        "update:data:resume",
-        "update:resume:data",
-        "data:resume:update",
-        "resume:data:update",
-        "resume:update:data"
+        "data:import:tree",
+        "import:data:tree",
+        "import:tree:data",
+        "data:tree:import",
+        "tree:data:import",
+        "tree:import:data"
       ]
     },
-    "data:import:bulk": {
+    "data:update:bulk": {
       "aliases": [],
       "args": {},
-      "description": "You can use this command to import millions of records into the object from a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag.\n\nBulk imports can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data import resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
+      "description": "You can use this command to update millions of Salesforce object records based on a file in comma-separated values (CSV) format.\n\nAll the records in the CSV file must be for the same Salesforce object. Specify the object with the `--sobject` flag. The first column of every line in the CSV file must be an ID of the record you want to update. The CSV file can contain only existing records; if a record in the file doesn't currently exist in the Salesforce object, the command fails. Consider using \"sf data upsert bulk\" if you also want to insert new records.\n\nBulk updates can take a while, depending on how many records are in the CSV file. If the command times out, or you specified the --async flag, the command displays the job ID. To see the status and get the results of the job, run \"sf data update resume\" and pass the job ID to the --job-id flag.\n\nFor information and examples about how to prepare your CSV files, see \"Prepare Data to Ingest\" in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/datafiles_prepare_data.htm).",
       "examples": [
-        "Import Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the import doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
-        "Import asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data import resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
+        "Update Account records from a CSV-formatted file into an org with alias \"my-scratch\"; if the update doesn't complete in 10 minutes, the command ends and displays a job ID:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --wait 10 --target-org my-scratch",
+        "Update asynchronously and use the default org; the command immediately returns a job ID that you then pass to the \"sf data update resume\" command:\n<%= config.bin %> <%= command.id %> --file accounts.csv --sobject Account --async"
       ],
       "flags": {
         "json": {
@@ -2180,19 +2143,24 @@
         "async": {
           "char": "a",
           "deprecated": true,
-          "exclusive": [
-            "wait"
-          ],
           "name": "async",
           "summary": "Don't wait for the command to complete.",
           "allowNo": false,
           "type": "boolean"
         },
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
         "file": {
           "char": "f",
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the Salesforce object records you want to import.",
+          "summary": "CSV file that contains the Salesforce object records you want to update.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2201,7 +2169,7 @@
           "char": "s",
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, into which you're importing records.",
+          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2213,17 +2181,6 @@
           "multiple": false,
           "type": "option"
         },
-        "wait": {
-          "char": "w",
-          "exclusive": [
-            "async"
-          ],
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
         "target-org": {
           "char": "o",
           "name": "target-org",
@@ -2244,138 +2201,65 @@
           "multiple": false,
           "options": [
             "CRLF",
-            "LF"
-          ],
-          "type": "option"
-        },
-        "column-delimiter": {
-          "name": "column-delimiter",
-          "summary": "Column delimiter used in the CSV file.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "BACKQUOTE",
-            "CARET",
-            "COMMA",
-            "PIPE",
-            "SEMICOLON",
-            "TAB"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "data:import:bulk",
-      "pluginAlias": "@salesforce/plugin-data",
-      "pluginName": "@salesforce/plugin-data",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Bulk import records into a Salesforce object from a CSV file. Uses Bulk API 2.0.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "data",
-        "import",
-        "bulk.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "data:import:bulk",
-        "import:data:bulk",
-        "import:bulk:data",
-        "data:bulk:import",
-        "bulk:data:import",
-        "bulk:import:data"
-      ]
-    },
-    "data:import:resume": {
-      "aliases": [],
-      "args": {},
-      "description": "When the original \"sf data import bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk import, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk import job.",
-      "examples": [
-        "Resume a bulk import job to your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk import job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "use-most-recent": {
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the bulk import job that was most recently run.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "job-id": {
-          "char": "i",
-          "name": "job-id",
-          "summary": "Job ID of the bulk import.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "wait": {
-          "char": "w",
-          "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
-          "default": "5 minutes",
-          "hasDynamicHelp": true,
+            "LF"
+          ],
+          "type": "option"
+        },
+        "column-delimiter": {
+          "name": "column-delimiter",
+          "summary": "Column delimiter used in the CSV file.",
+          "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "BACKQUOTE",
+            "CARET",
+            "COMMA",
+            "PIPE",
+            "SEMICOLON",
+            "TAB"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:import:resume",
+      "id": "data:update:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk import job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Bulk update records to an org from a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "import",
-        "resume.js"
+        "update",
+        "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:import:resume",
-        "import:data:resume",
-        "import:resume:data",
-        "data:resume:import",
-        "resume:data:import",
-        "resume:import:data"
+        "data:update:bulk",
+        "update:data:bulk",
+        "update:bulk:data",
+        "data:bulk:update",
+        "bulk:data:update",
+        "bulk:update:data"
       ]
     },
-    "data:import:tree": {
+    "data:update:record": {
       "aliases": [
-        "force:data:tree:import"
+        "force:data:record:update"
       ],
       "args": {},
       "deprecateAliases": true,
-      "description": "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 \"<%= config.bin %> data export tree\" command to generate these JSON files.\n\nIf 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.",
+      "description": "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 update fails; the error displays how many records were found.\n\nWhen 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.\n\nThis command updates a record in Salesforce objects by default. Use the --use-tooling-api flag to update a Tooling API object.",
       "examples": [
-        "Import the records contained in two JSON files into the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --files Contact.json,Account.json --target-org my-scratch",
-        "Import records using a plan definition file into your default org:\n<%= config.bin %> <%= command.id %> --plan Account-Contact-plan.json"
+        "Update the Name field of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name=NewAcme\"",
+        "Update the Name field of an Account record whose current name is 'Old Acme':\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Old Acme'\" --values \"Name='New Acme'\"",
+        "Update the Name and Website fields of an Account record with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 001D0 --values \"Name='Acme III' Website=www.example.com\"",
+        "Update the ExpirationDate field of a record of the Tooling API object TraceFlag using the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> -t --sobject TraceFlag --record-id 7tf170000009cUBAAY --values \"ExpirationDate=2017-12-01T00:58:04.000+0000\""
       ],
       "flags": {
         "json": {
@@ -2429,79 +2313,195 @@
           "multiple": false,
           "type": "option"
         },
-        "files": {
+        "sobject": {
           "aliases": [
-            "sobjecttreefiles"
+            "sobjecttype"
           ],
-          "char": "f",
+          "char": "s",
           "deprecateAliases": true,
-          "name": "files",
-          "summary": "Comma-separated and in-order JSON files that contain the records, in sObject tree format, that you want to insert.",
-          "delimiter": ",",
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
           "hasDynamicHelp": false,
-          "multiple": true,
+          "multiple": false,
           "type": "option"
         },
-        "plan": {
-          "char": "p",
-          "description": "Unlike when you use the `--files` flag, the files listed in the plan definition file **can** contain more then 200 records. When the CLI executes the import, it automatically batches the records to comply with the 200 record limit set by the API.\n\nThe order in which you list the files in the plan definition file matters. Specifically, records with lookups to records in another file should be listed AFTER that file. For example, let's say you're loading Account and Contact records, and the contacts have references to those accounts. Be sure you list the Accounts file before the Contacts file.\n\nThe plan definition file has the following schema:\n\n- items(object) - SObject Type: Definition of records to be insert per SObject Type\n  - sobject(string) - Name of SObject: Child file references must have SObject roots of this type\n  - files(array) - Files: An array of files paths to load",
-          "name": "plan",
-          "summary": "Plan definition file to insert multiple data files.",
+        "record-id": {
+          "aliases": [
+            "sobjectid"
+          ],
+          "char": "i",
+          "deprecateAliases": true,
+          "name": "record-id",
+          "summary": "ID of the record you’re updating.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "where": {
+          "char": "w",
+          "name": "where",
+          "summary": "List of <fieldName>=<value> pairs that identify the record you want to update.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "values": {
+          "char": "v",
+          "name": "values",
+          "required": true,
+          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "use-tooling-api": {
+          "aliases": [
+            "usetoolingapi"
+          ],
+          "char": "t",
+          "deprecateAliases": true,
+          "name": "use-tooling-api",
+          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "perflog": {
+          "deprecated": {
+            "version": "57"
+          },
+          "hidden": true,
+          "name": "perflog",
+          "summary": "Get API performance data.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:import:tree",
+      "id": "data:update:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Import data from one or more JSON files into an org.",
+      "summary": "Updates a single record of a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "import",
-        "tree.js"
+        "update",
+        "record.js"
       ],
       "aliasPermutations": [
-        "force:data:tree:import",
-        "data:force:tree:import",
-        "data:tree:force:import",
-        "data:tree:import:force",
-        "force:tree:data:import",
-        "tree:force:data:import",
-        "tree:data:force:import",
-        "tree:data:import:force",
-        "force:tree:import:data",
-        "tree:force:import:data",
-        "tree:import:force:data",
-        "tree:import:data:force",
-        "force:data:import:tree",
-        "data:force:import:tree",
-        "data:import:force:tree",
-        "data:import:tree:force",
-        "force:import:data:tree",
-        "import:force:data:tree",
-        "import:data:force:tree",
-        "import:data:tree:force",
-        "force:import:tree:data",
-        "import:force:tree:data",
-        "import:tree:force:data",
-        "import:tree:data:force"
+        "force:data:record:update",
+        "data:force:record:update",
+        "data:record:force:update",
+        "data:record:update:force",
+        "force:record:data:update",
+        "record:force:data:update",
+        "record:data:force:update",
+        "record:data:update:force",
+        "force:record:update:data",
+        "record:force:update:data",
+        "record:update:force:data",
+        "record:update:data:force",
+        "force:data:update:record",
+        "data:force:update:record",
+        "data:update:force:record",
+        "data:update:record:force",
+        "force:update:data:record",
+        "update:force:data:record",
+        "update:data:force:record",
+        "update:data:record:force",
+        "force:update:record:data",
+        "update:force:record:data",
+        "update:record:force:data",
+        "update:record:data:force"
       ],
       "permutations": [
-        "data:import:tree",
-        "import:data:tree",
-        "import:tree:data",
-        "data:tree:import",
-        "tree:data:import",
-        "tree:import:data"
+        "data:update:record",
+        "update:data:record",
+        "update:record:data",
+        "data:record:update",
+        "record:data:update",
+        "record:update:data"
+      ]
+    },
+    "data:update:resume": {
+      "aliases": [],
+      "args": {},
+      "description": "When the original \"sf data update bulk\" command either times out or is run with the --async flag, it displays a job ID. To see the status and get the results of the bulk update, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk update job.",
+      "examples": [
+        "Resume a bulk update job of your default org using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk update job for an org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "use-most-recent": {
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the bulk update job that was most recently run.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "job-id": {
+          "char": "i",
+          "name": "job-id",
+          "summary": "Job ID of the bulk update.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "name": "wait",
+          "summary": "Time to wait for the command to finish, in minutes.",
+          "default": "5 minutes",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "data:update:resume",
+      "pluginAlias": "@salesforce/plugin-data",
+      "pluginName": "@salesforce/plugin-data",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "data",
+        "update",
+        "resume.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "data:update:resume",
+        "update:data:resume",
+        "update:resume:data",
+        "data:resume:update",
+        "resume:data:update",
+        "resume:update:data"
       ]
     },
     "data:upsert:bulk": {
@@ -3232,5 +3232,5 @@
       ]
     }
   },
-  "version": "4.0.30"
+  "version": "4.0.32"
 }