For a list of all services and tables belonging to this service's resource, see Information on resource '__system__/tap'
This service speaks TAP, a protocol designed to allow the exchange of queries and data between clients (that's normally something running on your computer) and servers (e.g., us).
You will want to use some sort of client to query TAP services; examples for those include:
You can, in a pinch, use our service in an XML-enabled browser, too. Under Overview, look for the bullet point on tap and follow the link to "this service". Then, click on "New job..." in the job list, enter your query, click "Set query", then "Execute query". Reload the page you are redirected to now and then to see when your job is finished, then retrieve the result.
The queries this service executes are written an a dialect of SQL called ADQL. You need to learn it to use this service. See our ADQL tutorial. Also do not miss the local examples.
By the way, for quick ad-hoc queries from within a browser, our ADQL form service may be more convenient than TAP.
Also see the table metadata of the tables exposed here.
Local information: This service may put a much lower limit on uploads in sync queries than advertised in the table metadata. Unfortunately, current TOPCAT versions don't give terribly helpful error messages when the server rejects a query because the attached upload is too large (something like “Error writing request body to server“). If that happens to you, just switch to asynchronous querying (in TOPCAT, that's in the “Mode” combo box just above the query editor).
For information on our ADQL implementation, see the ADQL service info.
If multiple output columns in a query would end up having the same name, in the output VOTable they are disambiguated by appending underscores. This is in violation of the specification, but since fixing it would require rather intrusive changes into our software and it is not clear why one should want to use names when they are not unique to begin with, this will probably not be fixed.
You can access this service using:
ivo://org.gavo.dc/tap
, or access it by entering its base URL https://dc.zah.uni-heidelberg.de/__system__/tap/run
directly. Using an XSL-enabled web browser you can, in a pinch, also operate the service asynchronously without a specialized client.This service is published as follows:
local means it is listed on our front page, ivo_managed means it has a record in the VO registry.
The following fields are available to provide input to the service (with some renderers, some of these fields may be unavailable):
Name | Table Head | Description | Unit | UCD |
---|---|---|---|---|
format | Format | Deprecated alias of RESPONSEFORMAT | N/A | N/A |
lang | Lang | A name of a language that QUERY should be parsed as. See capabilities for what you can pass in here. | N/A | N/A |
maxrec | Match limit | Maximum number of records returned. Pass 0 to retrieve service parameters. | N/A | N/A |
maxrec | Match limit | Maximum number of records returned. Pass 0 to retrieve service parameters. | N/A | N/A |
query | Query | The query to be executed. | N/A | N/A |
request | Request | Type of operation requested; this can be doQuery or getCapabilities. Preferably, don't pass it at all. | N/A | N/A |
responseformat | Output Format | File format requested for output. | N/A | meta.code.mime |
responseformat | Output Format | File format requested for output. | N/A | meta.code.mime |
upload | Upload | A TAP-compliant upload; roughly: (tablename,source-uri), where source-uri can also have a param: scheme. | N/A | N/A |
verb | Verbosity | Exhaustiveness of column selection. VERB=1 only returns the most important columns, VERB=2 selects the columns deemed useful to the average user, VERB=3 returns a table with all available columns. | N/A | N/A |
verb | Verbosity | Exhaustiveness of column selection. VERB=1 only returns the most important columns, VERB=2 selects the columns deemed useful to the average user, VERB=3 returns a table with all available columns. | N/A | N/A |
version | Version | Don't use this parameter. You'll only break stuff. | N/A | N/A |
VOResource XML (that's something exclusively for VO nerds)