{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"Treasure Code","product_name":"Treasure Code","type":"markdown"},"seo":{"title":"tdx query - SQL Query Execution | Treasure Data","description":"Execute SQL queries using Trino. Run queries from CLI, files, or stdin with multiple output formats.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"query-commands","__idx":0},"children":["Query Commands"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Execute SQL queries using Trino."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"basic-usage","__idx":1},"children":["Basic Usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"tdx query [options] [sql]\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"options","__idx":2},"children":["Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-f, --file <path>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read SQL from file"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-d, --database <db>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Database to query"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["information_schema"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--in <db>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Alias for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--database"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--catalog <catalog>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trino catalog"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["td"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--limit <rows>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum rows to display"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["40"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":3},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"inline-query","__idx":4},"children":["Inline Query"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Simple query\ntdx query \"SELECT * FROM mydb.users LIMIT 10\"\n\n# With database flag\ntdx query \"SELECT * FROM users\" --in mydb\ntdx query \"SELECT * FROM users\" --database mydb\ntdx query \"SELECT * FROM users\" -d mydb\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"file-input","__idx":5},"children":["File Input"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read SQL from file:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Auto-detect .sql file (recommended)\ntdx query query.sql\n\n# Explicit file option\ntdx query --file query.sql\ntdx query -f query.sql\n\n# With options\ntdx query query.sql --database mydb --json --output results.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"stdin-input","__idx":6},"children":["Stdin Input"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read SQL from stdin using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Pipe SQL from echo\necho \"SELECT * FROM mydb.users LIMIT 10\" | tdx query -\n\n# Pipe from file\ncat query.sql | tdx query -\n\n# Pipe from another command\ngenerate-sql.sh | tdx query -\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"multi-statement-execution","__idx":7},"children":["Multi-Statement Execution"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Execute multiple SQL statements sequentially:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# From command line\ntdx query \"SELECT COUNT(*) FROM users; SELECT COUNT(*) FROM orders\"\n\n# From file\ntdx query -f setup-and-query.sql\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example multi-statement file"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["setup-and-query.sql"]},"):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"CREATE TABLE temp_users AS SELECT * FROM users WHERE active = true;\nCREATE TABLE temp_orders AS SELECT * FROM orders WHERE user_id IN (SELECT id FROM temp_users);\nSELECT COUNT(*) as order_count FROM temp_orders;\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output behavior:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each statement executes sequentially with progress indication"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Console output"]},": All results displayed as they complete"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File output"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--output"]},"): All results appended to single file"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Fail-fast"]},": Execution stops on first error"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"output-formats","__idx":8},"children":["Output Formats"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Table format (default)\ntdx query \"SELECT * FROM users LIMIT 5\"\n\n# JSON format\ntdx query \"SELECT * FROM users\" --json\n\n# JSON Lines format\ntdx query \"SELECT * FROM users\" --jsonl\n\n# TSV format\ntdx query \"SELECT * FROM users\" --tsv\n\n# Save to file\ntdx query \"SELECT * FROM users\" --output results.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"multi-statement-output-example","__idx":9},"children":["Multi-Statement Output Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"✔ Statement 1/3 - Query completed: Processed 1,000 rows in 2.3s\n┌────────────┐\n│ user_count │\n├────────────┤\n│ 1000       │\n└────────────┘\n✔ Statement 2/3 - Query completed: Processed 5,000 rows in 3.1s\n┌─────────────┐\n│ order_count │\n├─────────────┤\n│ 5000        │\n└─────────────┘\n"},"children":[]}]},"headings":[{"value":"Query Commands","id":"query-commands","depth":1},{"value":"Basic Usage","id":"basic-usage","depth":2},{"value":"Options","id":"options","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"Inline Query","id":"inline-query","depth":3},{"value":"File Input","id":"file-input","depth":3},{"value":"Stdin Input","id":"stdin-input","depth":3},{"value":"Multi-Statement Execution","id":"multi-statement-execution","depth":3},{"value":"Output Formats","id":"output-formats","depth":3},{"value":"Multi-Statement Output Example","id":"multi-statement-output-example","depth":2}],"frontmatter":{"seo":{"title":"tdx query - SQL Query Execution | Treasure Data","description":"Execute SQL queries using Trino. Run queries from CLI, files, or stdin with multiple output formats.","image":"/assets/og-image.ba836864a30434f560a4f7720f8a09019ad30ff828b20c5052ae933ba7121524.d7ef4821.png"}},"lastModified":"2026-03-08T00:14:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/treasure-code/commands/query","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}