/usr/share/doc/stilts/sun256/tapquery.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>tapquery: Queries a Table Access Protocol server</title>
</head>
<body>
<hr>
<a href="tapquery-usage.html">Next</a> <a href="secB.20.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tapquery-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.20.2.html">Examples</a><br>
<hr>
<hr>
<h2><a name="tapquery">B.21 <code>tapquery</code>: Queries a Table Access Protocol server</a></h2>
<p><code>tapquery</code> can query remote databases using the
Table Access Protocol (TAP) services by submitting
Astronomical Data Query Language queries to them and retrieving
the results.
<a href="http://www.ivoa.net/Documents/TAP/">TAP</a> and
<a href="http://www.ivoa.net/Documents/latest/ADQL.html">ADQL</a>
are Virtual Observatory protocols.
</p>
<p>Queries can be submitted in either synchronous or asynchronous mode,
as determined by the <code>sync</code> parameter.
In asynchronous mode, if the query has not been deleted by the time the
command exits (see the <code>delete</code> parameter),
the result can be picked up at a later stage using the
<a href="tapresume.html"><code>tapresume</code></a> command.
Table uploads are supported, so it is possible (if the service supports
this functionality), to upload a local table to the remote database,
perform a query involving it, such as a join with a remote table of some sort,
and receive the result. This powerful facility gives you crossmatches
between local and remote tables.
</p>
<p>This command does not provide any facility for querying the service
for either table or capability metadata, so you will need to know about
the service capabilities and database structure from some other source
(possibly TOPCAT).
</p>
<p><strong>Note:</strong> this command has been introduced at STILTS version
2.3, at which time most available TAP services are quite new and may not
fully conform to the standards, and usage patterns are still settling down.
For this reason you may find that some TAP services do not behave
quite as expected; it is also possible that in future versions the
command behaviour or parameters will change in line with changing
service profiles or in the light of user experience.
</p>
<ul>
<li><a href="tapquery-usage.html">B.21.1 Usage</a></li>
<li><a href="secB.21.2.html">B.21.2 Examples</a></li>
</ul>
<hr><a href="tapquery-usage.html">Next</a> <a href="secB.20.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tapquery-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.20.2.html">Examples</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|