@salesforce/plugin-data 3.13.2 → 3.13.4

package/oclif.manifest.json

@@ -775,13 +775,14 @@
         "record:create:data"
       ]
     },
-    "data:delete:bulk": {
+    "data:export:bulk": {
       "aliases": [],
       "args": {},
-      "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
+      "description": "You can use this command to export millions of records from an org, either to migrate data or to back it up.\n\nUse a SOQL query to specify the fields of a standard or custom object that you want to export. Specify the SOQL query either at the command line with the --query flag or read it from a file with the --query-file flag; you can't specify both flags. The --output-file flag is required, which means you can only write the records to a file, in either CSV or JSON format. \n\nBulk exports can take a while, depending on how many records are returned by the SOQL query. 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 export resume\" and pass the job ID to the --job-id flag.\n\nIMPORTANT: This command uses Bulk API 2.0, which limits the type of SOQL queries you can run. For example, you can't use aggregate functions such as count(). For the complete list of limitations, see the \"SOQL Considerations\" section in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm).",
       "examples": [
-        "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
-        "Bulk delete records from 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/delete.csv --wait 5 --target-org my-scratch"
+        "Export the Id, Name, and Account.Name fields of the Contact object into a CSV-formatted file; if the export doesn't complete in 10 minutes, the command ends and displays a job ID. Use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.csv --wait 10 --target-org my-scratch",
+        "Similar to previous example, but use the default org, export the records into a JSON-formatted file, and include records that have been soft deleted:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.json --result-format json --wait 10 --all-rows",
+        "Export asynchronously; the command immediately returns a job ID that you then pass to the \"sf data export resume\" command:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.json --result-format json --async"
       ],
       "flags": {
         "json": {
@@ -800,12 +801,7 @@
           "type": "option"
         },
         "target-org": {
-          "aliases": [
-            "targetusername",
-            "u"
-          ],
           "char": "o",
-          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
@@ -815,144 +811,163 @@
           "type": "option"
         },
         "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"
         },
-        "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",
+          "summary": "Time to wait for the command to finish, in minutes.",
           "hasDynamicHelp": true,
+          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
         },
         "async": {
-          "char": "a",
           "exclusive": [
             "wait"
           ],
           "name": "async",
-          "summary": "Run the command asynchronously.",
+          "summary": "Don't wait for the job to complete.",
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
-          "deprecated": {
-            "message": "The --verbose flag is deprecated and will be removed after March 2025, use \"sf data bulk results\" to get job results instead."
-          },
-          "name": "verbose",
-          "summary": "Print verbose output of failed records if result is available.",
+        "query": {
+          "char": "q",
+          "exclusive": [
+            "query-file"
+          ],
+          "name": "query",
+          "summary": "SOQL query to execute.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "query-file": {
+          "exclusive": [
+            "query"
+          ],
+          "name": "query-file",
+          "summary": "File that contains the SOQL query.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "all-rows": {
+          "name": "all-rows",
+          "summary": "Include records that have been soft-deleted due to a merge or delete. By default, deleted records are not returned.",
           "allowNo": false,
           "type": "boolean"
         },
-        "line-ending": {
-          "dependsOn": [
-            "file"
+        "output-file": {
+          "name": "output-file",
+          "required": true,
+          "summary": "File where records are written.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "result-format": {
+          "char": "r",
+          "name": "result-format",
+          "required": true,
+          "summary": "Format to write the results.",
+          "default": "csv",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "csv",
+            "json"
           ],
-          "name": "line-ending",
-          "summary": "Line ending used in the CSV file. Default value on Windows is `CRLF`; on macOS and Linux it's `LF`.",
+          "type": "option"
+        },
+        "column-delimiter": {
+          "name": "column-delimiter",
+          "relationships": [
+            {
+              "type": "some",
+              "flags": [
+                {
+                  "name": "result-format"
+                }
+              ]
+            }
+          ],
+          "summary": "Column delimiter to be used when writing CSV output. Default is COMMA.",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "CRLF",
-            "LF"
+            "BACKQUOTE",
+            "CARET",
+            "COMMA",
+            "PIPE",
+            "SEMICOLON",
+            "TAB"
           ],
           "type": "option"
         },
-        "hard-delete": {
-          "description": "You must have the \"Bulk API Hard Delete\" system permission to use this flag. The permission is disabled by default and can be enabled only by a system administrator.",
-          "name": "hard-delete",
-          "summary": "Mark the records as immediately eligible for deletion by your org. If you don't specify this flag, the deleted records go into the Recycle Bin.",
-          "allowNo": false,
-          "type": "boolean"
+        "line-ending": {
+          "name": "line-ending",
+          "relationships": [
+            {
+              "type": "some",
+              "flags": [
+                {
+                  "name": "result-format"
+                }
+              ]
+            }
+          ],
+          "summary": "Line ending to be used when writing CSV output. Default value on Windows is is `CRLF`; on macOS and Linux it's `LR`.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "LF",
+            "CRLF"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:delete:bulk",
+      "id": "data:export:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.",
+      "summary": "Bulk export records from an org into a file using a SOQL query. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "delete",
+        "export",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:delete:bulk",
-        "delete:data:bulk",
-        "delete:bulk:data",
-        "data:bulk:delete",
-        "bulk:data:delete",
-        "bulk:delete:data"
+        "data:export:bulk",
+        "export:data:bulk",
+        "export:bulk:data",
+        "data:bulk:export",
+        "bulk:data:export",
+        "bulk:export:data"
       ]
     },
-    "data:delete:record": {
-      "aliases": [
-        "force:data:record:delete"
-      ],
+    "data:export:resume": {
+      "aliases": [],
       "args": {},
-      "deprecateAliases": true,
-      "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
+      "description": "When the original \"data export 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 export, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk export job.",
       "examples": [
-        "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
-        "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
-        "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
-        "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
+        "Resume a bulk export job run on your default org by specifying a job ID:\nsf <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently-run bulk export job for an org with alias my-scratch:\nsf data export resume --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -970,158 +985,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,
+        "job-id": {
+          "char": "i",
+          "name": "job-id",
+          "summary": "Job ID of the bulk export.",
+          "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
+        "use-most-recent": {
+          "name": "use-most-recent",
+          "summary": "Use the job ID of the bulk export 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",
           "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 you're deleting a record from.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "record-id": {
-          "aliases": [
-            "sobjectid"
-          ],
-          "char": "i",
-          "deprecateAliases": true,
-          "name": "record-id",
-          "summary": "ID of the record you’re deleting.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "where": {
-          "char": "w",
-          "name": "where",
-          "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
-          "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 delete a record from a Tooling API object.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "perflog": {
-          "deprecated": {
-            "version": "57"
-          },
-          "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
-          "hidden": true,
-          "name": "perflog",
-          "summary": "Get API performance data.",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
-      "hasDynamicHelp": true,
+      "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "data:delete:record",
+      "id": "data:export:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Deletes a single record from a Salesforce or Tooling API object.",
+      "summary": "Resume a bulk export job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "delete",
-        "record.js"
-      ],
-      "aliasPermutations": [
-        "force:data:record:delete",
-        "data:force:record:delete",
-        "data:record:force:delete",
-        "data:record:delete:force",
-        "force:record:data:delete",
-        "record:force:data:delete",
-        "record:data:force:delete",
-        "record:data:delete:force",
-        "force:record:delete:data",
-        "record:force:delete:data",
-        "record:delete:force:data",
-        "record:delete:data:force",
-        "force:data:delete:record",
-        "data:force:delete:record",
-        "data:delete:force:record",
-        "data:delete:record:force",
-        "force:delete:data:record",
-        "delete:force:data:record",
-        "delete:data:force:record",
-        "delete:data:record:force",
-        "force:delete:record:data",
-        "delete:force:record:data",
-        "delete:record:force:data",
-        "delete:record:data:force"
+        "export",
+        "resume.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:delete:record",
-        "delete:data:record",
-        "delete:record:data",
-        "data:record:delete",
-        "record:data:delete",
-        "record:delete:data"
+        "data:export:resume",
+        "export:data:resume",
+        "export:resume:data",
+        "data:resume:export",
+        "resume:data:export",
+        "resume:export:data"
       ]
     },
-    "data:delete:resume": {
-      "aliases": [],
+    "data:export:tree": {
+      "aliases": [
+        "force:data:tree:export",
+        "data:export:beta:tree"
+      ],
       "args": {},
       "deprecateAliases": true,
-      "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
+      "description": "Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to export. The exported data is written to JSON files in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use these JSON files to import data into an org with the \"<%= config.bin %> data import tree\" command.\n\nIf your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You then specify just this plan definition file when you import the data into an org.\n\nThe SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).",
       "examples": [
-        "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
+        "Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command uses your default org:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c\"",
+        "Export data using a SOQL query in the \"query.txt\" file and generate JSON files for each object and a plan that aggregates them:\n<%= config.bin %> <%= command.id %> --query query.txt --plan",
+        "Prepend \"export-demo\" before each generated file and generate the files in the \"export-out\" directory; run the command on the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query query.txt --plan --prefix export-demo --output-dir export-out --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -1148,41 +1072,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,
@@ -1198,43 +1098,127 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "query": {
+          "char": "q",
+          "name": "query",
+          "required": true,
+          "summary": "SOQL query, or filepath of a file that contains the query, to retrieve records.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "plan": {
+          "char": "p",
+          "name": "plan",
+          "summary": "Generate multiple sObject tree files and a plan definition file for aggregated import.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "prefix": {
+          "char": "x",
+          "name": "prefix",
+          "summary": "Prefix of generated files.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "aliases": [
+            "outputdir"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "name": "output-dir",
+          "summary": "Directory in which to generate the JSON files; default is current directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:delete:resume",
+      "id": "data:export:tree",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Export data from an org into one or more JSON files.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "delete",
-        "resume.js"
+        "export",
+        "tree.js"
+      ],
+      "aliasPermutations": [
+        "force:data:tree:export",
+        "data:force:tree:export",
+        "data:tree:force:export",
+        "data:tree:export:force",
+        "force:tree:data:export",
+        "tree:force:data:export",
+        "tree:data:force:export",
+        "tree:data:export:force",
+        "force:tree:export:data",
+        "tree:force:export:data",
+        "tree:export:force:data",
+        "tree:export:data:force",
+        "force:data:export:tree",
+        "data:force:export:tree",
+        "data:export:force:tree",
+        "data:export:tree:force",
+        "force:export:data:tree",
+        "export:force:data:tree",
+        "export:data:force:tree",
+        "export:data:tree:force",
+        "force:export:tree:data",
+        "export:force:tree:data",
+        "export:tree:force:data",
+        "export:tree:data:force",
+        "data:export:beta:tree",
+        "export:data:beta:tree",
+        "export:beta:data:tree",
+        "export:beta:tree:data",
+        "data:beta:export:tree",
+        "beta:data:export:tree",
+        "beta:export:data:tree",
+        "beta:export:tree:data",
+        "data:beta:tree:export",
+        "beta:data:tree:export",
+        "beta:tree:data:export",
+        "beta:tree:export:data",
+        "data:export:tree:beta",
+        "export:data:tree:beta",
+        "export:tree:data:beta",
+        "export:tree:beta:data",
+        "data:tree:export:beta",
+        "tree:data:export:beta",
+        "tree:export:data:beta",
+        "tree:export:beta:data",
+        "data:tree:beta:export",
+        "tree:data:beta:export",
+        "tree:beta:data:export",
+        "tree:beta:export:data"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:delete:resume",
-        "delete:data:resume",
-        "delete:resume:data",
-        "data:resume:delete",
-        "resume:data:delete",
-        "resume:delete:data"
+        "data:export:tree",
+        "export:data:tree",
+        "export:tree:data",
+        "data:tree:export",
+        "tree:data:export",
+        "tree:export:data"
       ]
     },
-    "data:export:bulk": {
+    "data:delete:bulk": {
       "aliases": [],
       "args": {},
-      "description": "You can use this command to export millions of records from an org, either to migrate data or to back it up.\n\nUse a SOQL query to specify the fields of a standard or custom object that you want to export. Specify the SOQL query either at the command line with the --query flag or read it from a file with the --query-file flag; you can't specify both flags. The --output-file flag is required, which means you can only write the records to a file, in either CSV or JSON format. \n\nBulk exports can take a while, depending on how many records are returned by the SOQL query. 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 export resume\" and pass the job ID to the --job-id flag.\n\nIMPORTANT: This command uses Bulk API 2.0, which limits the type of SOQL queries you can run. For example, you can't use aggregate functions such as count(). For the complete list of limitations, see the \"SOQL Considerations\" section in the \"Bulk API 2.0 and Bulk API Developer Guide\" (https://developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/queries.htm).",
+      "description": "The CSV file must have only one column (\"Id\") and then the list of record IDs you want to delete, one ID per line.\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 ID to check the status of the job with the \"<%= config.bin %> data delete resume\" command.",
       "examples": [
-        "Export the Id, Name, and Account.Name fields of the Contact object into a CSV-formatted file; if the export doesn't complete in 10 minutes, the command ends and displays a job ID. Use the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.csv --wait 10 --target-org my-scratch",
-        "Similar to previous example, but use the default org, export the records into a JSON-formatted file, and include records that have been soft deleted:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.json --result-format json --wait 10 --all-rows",
-        "Export asynchronously; the command immediately returns a job ID that you then pass to the \"sf data export resume\" command:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, Account.Name FROM Contact\" --output-file export-accounts.json --result-format json --async"
+        "Bulk delete Account records from your default org using the list of IDs in the \"files/delete.csv\" file:\n<%= config.bin %> <%= command.id %> --sobject Account --file files/delete.csv",
+        "Bulk delete records from 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/delete.csv --wait 5 --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -1253,7 +1237,12 @@
           "type": "option"
         },
         "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
           "char": "o",
+          "deprecateAliases": true,
           "name": "target-org",
           "noCacheDefault": true,
           "required": true,
@@ -1263,163 +1252,144 @@
           "type": "option"
         },
         "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"
         },
+        "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": "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": "0 minutes",
           "hasDynamicHelp": true,
-          "helpValue": "<minutes>",
           "multiple": false,
           "type": "option"
         },
         "async": {
+          "char": "a",
           "exclusive": [
             "wait"
           ],
           "name": "async",
-          "summary": "Don't wait for the job to complete.",
+          "summary": "Run the command asynchronously.",
           "allowNo": false,
           "type": "boolean"
         },
-        "query": {
-          "char": "q",
-          "exclusive": [
-            "query-file"
-          ],
-          "name": "query",
-          "summary": "SOQL query to execute.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "query-file": {
-          "exclusive": [
-            "query"
-          ],
-          "name": "query-file",
-          "summary": "File that contains the SOQL query.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all-rows": {
-          "name": "all-rows",
-          "summary": "Include records that have been soft-deleted due to a merge or delete. By default, deleted records are not returned.",
+        "verbose": {
+          "deprecated": {
+            "message": "The --verbose flag is deprecated and will be removed after March 2025, use \"sf data bulk results\" to get job results instead."
+          },
+          "name": "verbose",
+          "summary": "Print verbose output of failed records if result is available.",
           "allowNo": false,
           "type": "boolean"
         },
-        "output-file": {
-          "name": "output-file",
-          "required": true,
-          "summary": "File where records are written.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "result-format": {
-          "char": "r",
-          "name": "result-format",
-          "required": true,
-          "summary": "Format to write the results.",
-          "default": "csv",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "csv",
-            "json"
-          ],
-          "type": "option"
-        },
-        "column-delimiter": {
-          "name": "column-delimiter",
-          "relationships": [
-            {
-              "type": "some",
-              "flags": [
-                {
-                  "name": "result-format"
-                }
-              ]
-            }
-          ],
-          "summary": "Column delimiter to be used when writing CSV output. Default is COMMA.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "BACKQUOTE",
-            "CARET",
-            "COMMA",
-            "PIPE",
-            "SEMICOLON",
-            "TAB"
-          ],
-          "type": "option"
-        },
         "line-ending": {
-          "name": "line-ending",
-          "relationships": [
-            {
-              "type": "some",
-              "flags": [
-                {
-                  "name": "result-format"
-                }
-              ]
-            }
+          "dependsOn": [
+            "file"
           ],
-          "summary": "Line ending to be used when writing CSV output. Default value on Windows is is `CRLF`; on macOS and Linux it's `LR`.",
+          "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": [
-            "LF",
-            "CRLF"
+            "CRLF",
+            "LF"
           ],
           "type": "option"
+        },
+        "hard-delete": {
+          "description": "You must have the \"Bulk API Hard Delete\" system permission to use this flag. The permission is disabled by default and can be enabled only by a system administrator.",
+          "name": "hard-delete",
+          "summary": "Mark the records as immediately eligible for deletion by your org. If you don't specify this flag, the deleted records go into the Recycle Bin.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:export:bulk",
+      "id": "data:delete:bulk",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Bulk export records from an org into a file using a SOQL query. Uses Bulk API 2.0.",
+      "summary": "Bulk delete records from an org using a CSV file. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "export",
+        "delete",
         "bulk.js"
       ],
       "aliasPermutations": [],
       "permutations": [
-        "data:export:bulk",
-        "export:data:bulk",
-        "export:bulk:data",
-        "data:bulk:export",
-        "bulk:data:export",
-        "bulk:export:data"
+        "data:delete:bulk",
+        "delete:data:bulk",
+        "delete:bulk:data",
+        "data:bulk:delete",
+        "bulk:data:delete",
+        "bulk:delete:data"
       ]
     },
-    "data:export:resume": {
-      "aliases": [],
+    "data:delete:record": {
+      "aliases": [
+        "force:data:record:delete"
+      ],
       "args": {},
-      "description": "When the original \"data export 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 export, run this command by either passing it the job ID or using the --use-most-recent flag to specify the most recent bulk export job.",
+      "deprecateAliases": true,
+      "description": "Specify the record you want to delete with either its ID or with a list of field-value pairs that identify the record. If your list of fields identifies more than one record, the delete fails; the error displays how many records were found.\n\nWhen specifying field-value pairs, use the format <fieldName>=<value>. Enclose all field-value pairs in one set of double quotation marks, delimited by spaces. Enclose values that contain spaces in single quotes.\n\nThis command deletes a record from Salesforce objects by default. Use the --use-tooling-api flag to delete from a Tooling API object.",
       "examples": [
-        "Resume a bulk export job run on your default org by specifying a job ID:\nsf <%= command.id %> --job-id 750xx000000005sAAA",
-        "Resume the most recently-run bulk export job for an org with alias my-scratch:\nsf data export resume --use-most-recent --target-org my-scratch"
+        "Delete a record from Account with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --sobject Account --record-id 00180XX",
+        "Delete a record from Account whose name equals \"Acme\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name=Acme\"",
+        "Delete a record from Account identified with two field values, one that contains a space; the command uses the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --sobject Account --where \"Name='Universal Containers' Phone='(123) 456-7890'\" --target-org myscratch",
+        "Delete a record from the Tooling API object TraceFlag with the specified (truncated) ID:\n<%= config.bin %> <%= command.id %> --use-tooling-api --sobject TraceFlag --record-id 7tf8c"
       ],
       "flags": {
         "json": {
@@ -1437,67 +1407,158 @@
           "multiple": false,
           "type": "option"
         },
-        "job-id": {
+        "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"
+          ],
+          "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"
+        },
+        "sobject": {
+          "aliases": [
+            "sobjecttype"
+          ],
+          "char": "s",
+          "deprecateAliases": true,
+          "name": "sobject",
+          "required": true,
+          "summary": "API name of the Salesforce or Tooling API object that you're deleting a record from.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "record-id": {
+          "aliases": [
+            "sobjectid"
+          ],
           "char": "i",
-          "name": "job-id",
-          "summary": "Job ID of the bulk export.",
+          "deprecateAliases": true,
+          "name": "record-id",
+          "summary": "ID of the record you’re deleting.",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "use-most-recent": {
-          "name": "use-most-recent",
-          "summary": "Use the job ID of the bulk export job that was most recently run.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "api-version": {
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
+        "where": {
+          "char": "w",
+          "name": "where",
+          "summary": "List of <fieldName>=<value> pairs that identify the record you want to delete.",
           "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 delete a record from a Tooling API object.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "perflog": {
+          "deprecated": {
+            "version": "57"
+          },
+          "description": "Gets data on API performance metrics from the server. The data is stored in $HOME/.sfdx/apiPerformanceLog.json.",
+          "hidden": true,
+          "name": "perflog",
+          "summary": "Get API performance data.",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
-      "hasDynamicHelp": false,
+      "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:export:resume",
+      "id": "data:delete:record",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Resume a bulk export job that you previously started. Uses Bulk API 2.0.",
+      "summary": "Deletes a single record from a Salesforce or Tooling API object.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "export",
-        "resume.js"
+        "delete",
+        "record.js"
+      ],
+      "aliasPermutations": [
+        "force:data:record:delete",
+        "data:force:record:delete",
+        "data:record:force:delete",
+        "data:record:delete:force",
+        "force:record:data:delete",
+        "record:force:data:delete",
+        "record:data:force:delete",
+        "record:data:delete:force",
+        "force:record:delete:data",
+        "record:force:delete:data",
+        "record:delete:force:data",
+        "record:delete:data:force",
+        "force:data:delete:record",
+        "data:force:delete:record",
+        "data:delete:force:record",
+        "data:delete:record:force",
+        "force:delete:data:record",
+        "delete:force:data:record",
+        "delete:data:force:record",
+        "delete:data:record:force",
+        "force:delete:record:data",
+        "delete:force:record:data",
+        "delete:record:force:data",
+        "delete:record:data:force"
       ],
-      "aliasPermutations": [],
       "permutations": [
-        "data:export:resume",
-        "export:data:resume",
-        "export:resume:data",
-        "data:resume:export",
-        "resume:data:export",
-        "resume:export:data"
+        "data:delete:record",
+        "delete:data:record",
+        "delete:record:data",
+        "data:record:delete",
+        "record:data:delete",
+        "record:delete:data"
       ]
     },
-    "data:export:tree": {
-      "aliases": [
-        "force:data:tree:export",
-        "data:export:beta:tree"
-      ],
+    "data:delete:resume": {
+      "aliases": [],
       "args": {},
       "deprecateAliases": true,
-      "description": "Specify a SOQL query, either directly at the command line or read from a file, to retrieve the data you want to export. The exported data is written to JSON files in sObject tree format, which is a collection of nested, parent-child records with a single root record. Use these JSON files to import data into an org with the \"<%= config.bin %> data import tree\" command.\n\nIf your SOQL query references multiple objects, the command generates a single JSON file by default. You can specify the --plan flag to generate separate JSON files for each object and a plan definition file that aggregates them. You then specify just this plan definition file when you import the data into an org.\n\nThe SOQL query can return a maximum of 2,000 records. For more information, see the REST API Developer Guide. (https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobject_tree.htm).",
+      "description": "The command uses the job ID returned by the \"<%= config.bin %> data delete bulk\" command or the most recently-run bulk delete job.",
       "examples": [
-        "Export records retrieved with the specified SOQL query into a single JSON file in the current directory; the command uses your default org:\n<%= config.bin %> <%= command.id %> --query \"SELECT Id, Name, (SELECT Name, Address__c FROM Properties__r) FROM Broker__c\"",
-        "Export data using a SOQL query in the \"query.txt\" file and generate JSON files for each object and a plan that aggregates them:\n<%= config.bin %> <%= command.id %> --query query.txt --plan",
-        "Prepend \"export-demo\" before each generated file and generate the files in the \"export-out\" directory; run the command on the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --query query.txt --plan --prefix export-demo --output-dir export-out --target-org my-scratch"
+        "Resume a bulk delete job from your default org using an ID:\n<%= config.bin %> <%= command.id %> --job-id 750xx000000005sAAA",
+        "Resume the most recently run bulk delete job for an org with alias my-scratch:\n<%= config.bin %> <%= command.id %> --use-most-recent --target-org my-scratch"
       ],
       "flags": {
         "json": {
@@ -1524,17 +1585,41 @@
           "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.",
+          "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": {
+        "job-id": {
           "aliases": [
-            "apiversion"
+            "jobid"
           ],
+          "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,
@@ -1550,118 +1635,33 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "query": {
-          "char": "q",
-          "name": "query",
-          "required": true,
-          "summary": "SOQL query, or filepath of a file that contains the query, to retrieve records.",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "plan": {
-          "char": "p",
-          "name": "plan",
-          "summary": "Generate multiple sObject tree files and a plan definition file for aggregated import.",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "prefix": {
-          "char": "x",
-          "name": "prefix",
-          "summary": "Prefix of generated files.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-dir": {
-          "aliases": [
-            "outputdir"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "name": "output-dir",
-          "summary": "Directory in which to generate the JSON files; default is current directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": true,
       "hiddenAliases": [],
-      "id": "data:export:tree",
+      "id": "data:delete:resume",
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
       "strict": true,
-      "summary": "Export data from an org into one or more JSON files.",
+      "summary": "Resume a bulk delete job that you previously started. Uses Bulk API 2.0.",
       "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "lib",
         "commands",
         "data",
-        "export",
-        "tree.js"
-      ],
-      "aliasPermutations": [
-        "force:data:tree:export",
-        "data:force:tree:export",
-        "data:tree:force:export",
-        "data:tree:export:force",
-        "force:tree:data:export",
-        "tree:force:data:export",
-        "tree:data:force:export",
-        "tree:data:export:force",
-        "force:tree:export:data",
-        "tree:force:export:data",
-        "tree:export:force:data",
-        "tree:export:data:force",
-        "force:data:export:tree",
-        "data:force:export:tree",
-        "data:export:force:tree",
-        "data:export:tree:force",
-        "force:export:data:tree",
-        "export:force:data:tree",
-        "export:data:force:tree",
-        "export:data:tree:force",
-        "force:export:tree:data",
-        "export:force:tree:data",
-        "export:tree:force:data",
-        "export:tree:data:force",
-        "data:export:beta:tree",
-        "export:data:beta:tree",
-        "export:beta:data:tree",
-        "export:beta:tree:data",
-        "data:beta:export:tree",
-        "beta:data:export:tree",
-        "beta:export:data:tree",
-        "beta:export:tree:data",
-        "data:beta:tree:export",
-        "beta:data:tree:export",
-        "beta:tree:data:export",
-        "beta:tree:export:data",
-        "data:export:tree:beta",
-        "export:data:tree:beta",
-        "export:tree:data:beta",
-        "export:tree:beta:data",
-        "data:tree:export:beta",
-        "tree:data:export:beta",
-        "tree:export:data:beta",
-        "tree:export:beta:data",
-        "data:tree:beta:export",
-        "tree:data:beta:export",
-        "tree:beta:data:export",
-        "tree:beta:export:data"
+        "delete",
+        "resume.js"
       ],
+      "aliasPermutations": [],
       "permutations": [
-        "data:export:tree",
-        "export:data:tree",
-        "export:tree:data",
-        "data:tree:export",
-        "tree:data:export",
-        "tree:export:data"
+        "data:delete:resume",
+        "delete:data:resume",
+        "delete:resume:data",
+        "data:resume:delete",
+        "resume:data:delete",
+        "resume:delete:data"
       ]
     },
     "data:get:record": {
@@ -2218,6 +2218,9 @@
       ],
       "args": {},
       "deprecateAliases": true,
+      "deprecationOptions": {
+        "message": "Bulk mode for \"data query\" is deprecated, this command will be removed after April 2025.\nUse \"data export bulk | data export resume\" for bulk queries instead.\n"
+      },
       "description": "Run this command using the job ID returned from the \"<%= config.bin %> data query --bulk\" command.",
       "examples": [
         "View the status of a bulk query with the specified ID:\n<%= config.bin %> <%= command.id %> --bulk-query-id 7500x000005BdFzXXX"
@@ -2316,6 +2319,7 @@
       "pluginAlias": "@salesforce/plugin-data",
       "pluginName": "@salesforce/plugin-data",
       "pluginType": "core",
+      "state": "deprecated",
       "strict": true,
       "summary": "View the status of a bulk query.",
       "enableJsonFlag": true,
@@ -3897,5 +3901,5 @@
       ]
     }
   },
-  "version": "3.13.2"
+  "version": "3.13.4"
 }