data query

Execute a SOQL query.

Specify the SOQL query at the command line with the –query flag or read the query from a file with the –file flag.

If your query returns more than 10,000 records, prefer to use the sf data export bulk command instead. It runs the query using Bulk API 2.0, which has higher limits than the default API used by the command.

force:data:soql:query

Flag Name (Long)Flag Name (Short)Description
‑‑all‑rowsN/AType: Boolean

Include deleted records. By default, deleted records are not returned.
‑‑api‑versionN/AType: Value

Override the api version used for api requests made by this command
‑‑file‑fType: Value

File that contains the SOQL query.
‑‑flags‑dirN/AType: Value

Import flag values from a directory.
‑‑jsonN/AType: Boolean

Format output as json.
‑‑output‑fileN/AType: Value

File where records are written; only CSV and JSON output formats are supported.
‑‑query‑qType: Value

SOQL query to execute.
‑‑result‑format‑rType: Value
Valid Values: human, csv, json
Default value: human

Format to display the results; the –json flag overrides this flag.
‑‑target‑org‑oType: Value
Required

Username or alias of the target org. Not required if the target-org configuration variable is already set.
‑‑use‑tooling‑api‑tType: Boolean

Use Tooling API so you can run queries on Tooling API objects.

Specify a SOQL query at the command line; the command uses your default org:

Read the SOQL query from a file called “query.txt” and write the CSV-formatted output to a file; the command uses the org with alias “my-scratch”:

Use Tooling API to run a query on the ApexTrigger Tooling API object: