Get Query Metadata

Information about retrieving CGE query's meatada.

Sometimes it may not be desired to get all the results delivered over HTTP. Instead, it may be needed to simply submit a query whose results will be processed later. To do this, use the export query results endpoint accessed at: http://machine:3756/dataset/export-results, where machine is used as an example for the machine name.

This interface is functionally identical to the Query interface. The endpoints differ only in the format of the response. The export results endpoint return only the meta data about query results. This is similar to the default behaviour of the query command. The meta data is returned in one of three formats, where the response format to use is determined by content negotiation.

Table 1. Query Metadata
Format	Example Response	Content Types
Tab separated values (TSV)	`0 100 0 2 /tmp/results.tsv`	`text/plain` `text/tab-separated-values`
XML	`<?xml version="1.0" encoding="UTF-8"?> <cge-results> <query><![CDATA[SELECT * WHERE { } ]]></query> <count>100</count> <size>0</size> <time>2</time> <status>0</status> <location>/tmp/results.tsv</location> </cge-results>`	`application/xml`
JSON	`{ "query" : "SELECT *\nWHERE\n { }\n" , "count" : 100 , "size" : 0 , "time" : 2 , "status" : 0 , "location" : "/tmp/results.tsv" }`	`application/json`

This interface only supports SELECT queries. Any other queries will be rejected, this is because the meta data is only accurate and complete for SELECT queries.