@salesforce/plugin-data 4.0.49 → 4.0.51

package/oclif.manifest.json

@@ -401,6 +401,83 @@
         "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": {},
@@ -1102,83 +1179,6 @@
         "resume:delete: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:export:bulk": {
       "aliases": [],
       "args": {},
@@ -1765,13 +1765,13 @@
         "record:get: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": {
@@ -1792,19 +1792,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"
@@ -1813,7 +1818,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"
@@ -1825,17 +1830,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",
@@ -1878,38 +1872,43 @@
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:import:bulk",
+      "id": "data:update: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.",
+      "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",
+        "update",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:import:bulk",
-        "import:data:bulk",
-        "import:bulk:data",
-        "data:bulk:import",
-        "bulk:data:import",
-        "bulk:import:data"
+        "data:update:bulk",
+        "update:data:bulk",
+        "update:bulk:data",
+        "data:bulk:update",
+        "bulk:data:update",
+        "bulk:update:data"
       ]
     },
-    "data:import:resume": {
-      "aliases": [],
+    "data:update:record": {
+      "aliases": [
+        "force:data:record:update"
+      ],
       "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.",
+      "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.",
       "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"
+        "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": {
@@ -1927,202 +1926,165 @@
           "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"
+        "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 import.",
+        "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,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hiddenAliases": [],
-      "id": "data:import:resume",
-      "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.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "data",
-        "import",
-        "resume.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "data:import:resume",
-        "import:data:resume",
-        "import:resume:data",
-        "data:resume:import",
-        "resume:data:import",
-        "resume:import:data"
-      ]
-    },
-    "data:import:tree": {
-      "aliases": [
-        "force:data:tree:import"
-      ],
-      "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.",
-      "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"
-      ],
-      "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.",
+        "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"
         },
-        "target-org": {
+        "sobject": {
           "aliases": [
-            "targetusername",
-            "u"
+            "sobjecttype"
           ],
-          "char": "o",
+          "char": "s",
           "deprecateAliases": true,
-          "name": "target-org",
-          "noCacheDefault": true,
+          "name": "sobject",
           "required": true,
-          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
-          "hasDynamicHelp": true,
+          "summary": "API name of the Salesforce or Tooling API object that contains the record you're updating.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "api-version": {
+        "record-id": {
           "aliases": [
-            "apiversion"
+            "sobjectid"
           ],
+          "char": "i",
           "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+          "name": "record-id",
+          "summary": "ID of the record you’re updating.",
           "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",
+        "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"
         },
-        "files": {
+        "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": [
-            "sobjecttreefiles"
+            "usetoolingapi"
           ],
-          "char": "f",
+          "char": "t",
           "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"
+          "name": "use-tooling-api",
+          "summary": "Use Tooling API so you can update a record in a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "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"
+        "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:bulk": {
+    "data:update:resume": {
       "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": "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.\n\nUsing either `--job-id` or `--use-most-recent` will properly resolve to the correct org where the bulk job was started based on the cached data by \"data update bulk\".",
       "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"
+        "Resume a bulk update job using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk update job:\n<%= config.bin %> <%= command.id %> --use-most-recent"
       ],
       "flags": {
         "json": {
@@ -2140,95 +2102,38 @@
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "name": "async",
-          "summary": "Don't wait for the command to complete.",
+        "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"
         },
-        "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.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
-          "char": "s",
-          "name": "sobject",
-          "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, which you are updating.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "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 update.",
           "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.",
+        "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"
-        },
-        "line-ending": {
-          "dependsOn": [
-            "file"
-          ],
-          "name": "line-ending",
-          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
-          "hasDynamicHelp": false,
-          "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:update:bulk",
+      "id": "data:update:resume",
       "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": "Resume a bulk update job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
@@ -2236,30 +2141,25 @@
         "commands",
         "data",
         "update",
-        "bulk.js"
+        "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:bulk",
-        "update:data:bulk",
-        "update:bulk:data",
-        "data:bulk:update",
-        "bulk:data:update",
-        "bulk:update:data"
+        "data:update:resume",
+        "update:data:resume",
+        "update:resume:data",
+        "data:resume:update",
+        "resume:data:update",
+        "resume:update:data"
       ]
     },
-    "data:update:record": {
-      "aliases": [
-        "force:data:record:update"
-      ],
+    "data:upsert:bulk": {
+      "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": "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.\n\nWhen you execute this command, it starts a job, displays the ID, 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 \"<%= config.bin %> data upsert resume\" command.\n\nSee \"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_prepare_csv.htm)",
       "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\""
+        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
+        "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2296,146 +2196,149 @@
           "aliases": [
             "apiversion"
           ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "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"
+        },
+        "file": {
+          "aliases": [
+            "csvfile"
+          ],
+          "char": "f",
+          "deprecateAliases": true,
+          "name": "file",
+          "required": true,
+          "summary": "CSV file that contains the IDs of the records to update or delete.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sobject": {
+          "aliases": [
+            "sobjecttype"
+          ],
+          "char": "s",
+          "deprecateAliases": true,
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "wait": {
+          "char": "w",
+          "exclusive": [
+            "async"
+          ],
+          "name": "wait",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
+          "default": "0 minutes",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "exclusive": [
+            "wait"
+          ],
+          "name": "async",
+          "summary": "Run the command asynchronously.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "line-ending": {
+          "dependsOn": [
+            "file"
+          ],
+          "name": "line-ending",
+          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "CRLF",
+            "LF"
+          ],
           "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",
+        "column-delimiter": {
+          "name": "column-delimiter",
+          "summary": "Column delimiter used in the CSV file.",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "sobject": {
-          "aliases": [
-            "sobjecttype"
+          "options": [
+            "BACKQUOTE",
+            "CARET",
+            "COMMA",
+            "PIPE",
+            "SEMICOLON",
+            "TAB"
           ],
-          "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": {
+        "external-id": {
           "aliases": [
-            "sobjectid"
+            "externalid"
           ],
           "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",
+          "name": "external-id",
           "required": true,
-          "summary": "Fields that you're updating, in the format of <fieldName>=<value> pairs.",
+          "summary": "Name of the external ID field, or the Id field.",
           "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:update:record",
+      "id": "data:upsert:bulk",
       "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": "Bulk upsert records to an org from a CSV file. 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"
+        "upsert",
+        "bulk.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:update:record",
-        "update:data:record",
-        "update:record:data",
-        "data:record:update",
-        "record:data:update",
-        "record:update:data"
+        "data:upsert:bulk",
+        "upsert:data:bulk",
+        "upsert:bulk:data",
+        "data:bulk:upsert",
+        "bulk:data:upsert",
+        "bulk:upsert:data"
       ]
     },
-    "data:update:resume": {
+    "data:upsert: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.\n\nUsing either `--job-id` or `--use-most-recent` will properly resolve to the correct org where the bulk job was started based on the cached data by \"data update bulk\".",
+      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert job.",
       "examples": [
-        "Resume a bulk update job using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk update job:\n<%= config.bin %> <%= command.id %> --use-most-recent"
+        "Resume a bulk upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk upsert job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -2453,64 +2356,101 @@
           "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,
+          "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": {
+          "aliases": [
+            "jobid"
+          ],
           "char": "i",
+          "deprecateAliases": true,
           "name": "job-id",
-          "summary": "Job ID of the bulk update.",
+          "summary": "ID of the job you want to resume.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "use-most-recent": {
+          "exclusive": [
+            "job-id"
+          ],
+          "name": "use-most-recent",
+          "summary": "Use the ID of the most recently-run bulk job.",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "wait": {
-          "char": "w",
           "name": "wait",
-          "summary": "Time to wait for the command to finish, in minutes.",
+          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
           "default": "5 minutes",
           "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"
+        },
+        "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"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:update:resume",
+      "id": "data:upsert: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.",
+      "summary": "Resume a bulk upsert job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "update",
+        "upsert",
         "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:update:resume",
-        "update:data:resume",
-        "update:resume:data",
-        "data:resume:update",
-        "resume:data:update",
-        "resume:update:data"
+        "data:upsert:resume",
+        "upsert:data:resume",
+        "upsert:resume:data",
+        "data:resume:upsert",
+        "resume:data:upsert",
+        "resume:upsert:data"
       ]
     },
-    "data:upsert:bulk": {
+    "data:import:bulk": {
       "aliases": [],
       "args": {},
-      "description": "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.\n\nWhen you execute this command, it starts a job, displays the ID, 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 \"<%= config.bin %> data upsert resume\" command.\n\nSee \"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_prepare_csv.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": [
-        "Bulk upsert records to the Contact object in your default org:\n<%= config.bin %> <%= command.id %> --sobject Contact --file files/contacts.csv --external-id Id",
-        "Bulk upsert records to a custom object in an org with alias my-scratch and wait 5 minutes for the command to complete:\n<%= config.bin %> <%= command.id %> --sobject MyObject__c --file files/file.csv --external-id MyField__c --wait 5 --target-org my-scratch"
+        "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": {
@@ -2528,64 +2468,38 @@
           "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"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
+        "async": {
+          "char": "a",
+          "deprecated": true,
+          "exclusive": [
+            "wait"
           ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "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"
+          "name": "async",
+          "summary": "Don't wait for the command to complete.",
+          "allowNo": false,
+          "type": "boolean"
         },
         "file": {
-          "aliases": [
-            "csvfile"
-          ],
           "char": "f",
-          "deprecateAliases": true,
           "name": "file",
           "required": true,
-          "summary": "CSV file that contains the IDs of the records to update or delete.",
+          "summary": "CSV file that contains the Salesforce object records you want to import.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "sobject": {
-          "aliases": [
-            "sobjecttype"
-          ],
           "char": "s",
-          "deprecateAliases": true,
           "name": "sobject",
           "required": true,
-          "summary": "API name of the Salesforce object, either standard or custom, that you want to update or delete records from.",
+          "summary": "API name of the Salesforce object, either standard or custom, into which you're importing records.",
+          "hasDynamicHelp": false,
+          "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"
@@ -2596,22 +2510,20 @@
             "async"
           ],
           "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
-          "default": "0 minutes",
+          "summary": "Time to wait for the command to finish, in minutes.",
           "hasDynamicHelp": true,
           "multiple": false,
           "type": "option"
         },
-        "async": {
-          "char": "a",
-          "deprecated": true,
-          "exclusive": [
-            "wait"
-          ],
-          "name": "async",
-          "summary": "Run the command asynchronously.",
-          "allowNo": false,
-          "type": "boolean"
+        "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"
         },
         "line-ending": {
           "dependsOn": [
@@ -2641,55 +2553,120 @@
             "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"
         },
-        "external-id": {
-          "aliases": [
-            "externalid"
-          ],
+        "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",
-          "deprecateAliases": true,
-          "name": "external-id",
-          "required": true,
-          "summary": "Name of the external ID field, or the Id field.",
+          "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,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:upsert:bulk",
+      "id": "data:import:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk upsert records to an org from a CSV file. Uses Bulk API 2.0.",
+      "summary": "Resume a bulk import job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "upsert",
-        "bulk.js"
+        "import",
+        "resume.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:upsert:bulk",
-        "upsert:data:bulk",
-        "upsert:bulk:data",
-        "data:bulk:upsert",
-        "bulk:data:upsert",
-        "bulk:upsert:data"
+        "data:import:resume",
+        "import:data:resume",
+        "import:resume:data",
+        "data:resume:import",
+        "resume:data:import",
+        "resume:import:data"
       ]
     },
-    "data:upsert:resume": {
-      "aliases": [],
+    "data:import:tree": {
+      "aliases": [
+        "force:data:tree:import"
+      ],
       "args": {},
-      "description": "The command uses the job ID returned from the \"<%= config.bin %> data upsert bulk\" command or the most recently-run bulk upsert 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 upsert job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk upsert 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": {
@@ -2716,41 +2693,17 @@
           "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
-          "summary": "Username or alias of the target org. Not required if the \"target-org\" configuration variable is already set.",
+          "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": {
+        "api-version": {
           "aliases": [
-            "jobid"
+            "apiversion"
           ],
-          "char": "i",
           "deprecateAliases": true,
-          "name": "job-id",
-          "summary": "ID of the job you want to resume.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "use-most-recent": {
-          "exclusive": [
-            "job-id"
-          ],
-          "name": "use-most-recent",
-          "summary": "Use the ID of the most recently-run bulk job.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wait": {
-          "name": "wait",
-          "summary": "Number of minutes to wait for the command to complete before displaying the results.",
-          "default": "5 minutes",
-          "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,
@@ -2766,33 +2719,80 @@
           "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:upsert:resume",
+      "id": "data:import:tree",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk upsert 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",
-        "upsert",
-        "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:upsert:resume",
-        "upsert:data:resume",
-        "upsert:resume:data",
-        "data:resume:upsert",
-        "resume:data:upsert",
-        "resume:upsert:data"
+        "data:import:tree",
+        "import:data:tree",
+        "import:tree:data",
+        "data:tree:import",
+        "tree:data:import",
+        "tree:import:data"
       ]
     },
     "force:data:bulk:delete": {
@@ -3232,5 +3232,5 @@
       ]
     }
   },
-  "version": "4.0.49"
+  "version": "4.0.51"
 }