$dump-sql

Dump results of the sql query

$dump-sql operation takes the sql query and responds with the Chunked Encoded stream in CSV format or in NDJSON format. Useful to export data for analytics.

typescript
POST [base]/$dump-sql

Headers

ParameterRequired?TypeDescription
ParameterRequired?TypeDescription
content-typetrueStringContent-type of the query body

Query parameters

ParameterRequired?TypeDescription
ParameterRequired?TypeDescription
_formatfalseString

  • json/ndjson: return output as ndjosn
  • otherwise: return output as TSV

Body parameters

ParameterRequired?TypeDescription
ParameterRequired?TypeDescription
querytrueStringSql query to execute

Example

Get id and name of each patient

REST Console

yaml
POST /$dump-sql
Content-Type: text/yaml

query: select id, resource#>>'{name,0,given,0}' from patient

Curl

bash
curl -u bulk-client:secret $AIDBOX_BASE_URL/\$dump-sql \
    -H 'Content-Type: text/yaml' -d@- <<EOF
query: select id, resource#>>'{name,0,given,0}' from patient
EOF

Status

200 OK

Headers

Header Value
Content-Type text/tab-separated-values
Transfer-Encoding Chunked

Body

yaml
pt-1	Alice
pt-2	Bob
pt-3	Charles

Body as table

pt-1 Alice
pt-2 Bob