table of contents
git-svn-id: https://svn.apache.org/repos/asf/hadoop/hbase/trunk@797864 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
64e7770cb7
commit
9bba58d217
|
@ -26,7 +26,55 @@
|
||||||
This package provides "Stargate" -- a RESTful Web service front end for HBase.
|
This package provides "Stargate" -- a RESTful Web service front end for HBase.
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
<!-- TABLE OF CONTENTS -->
|
<h2>Table Of Contents</h2>
|
||||||
|
<ol>
|
||||||
|
<li><a href="#deployment">Deployment</a></li>
|
||||||
|
<ol type="a">
|
||||||
|
<li><a href="#deployment_daemon">Daemon</a></li>
|
||||||
|
<li><a href="#deployment_servlet">Servlet</a></li>
|
||||||
|
</ol>
|
||||||
|
<li><a href="#rest">Representational State Transfer</a></li>
|
||||||
|
<li><a href="#identifiers">Resource Identifiers</a></li>
|
||||||
|
<li><a href="#operations">Operations</a></li>
|
||||||
|
<ol type="a">
|
||||||
|
<li><a href="#operation_version">Query Software Version</a></li>
|
||||||
|
<li><a href="#operation_storage_cluster_version">Query Storage Cluster Version</a></li>
|
||||||
|
<li><a href="#operation_storage_cluster_status">Query Storage Cluster Status</a></li>
|
||||||
|
<li><a href="#operation_query_tables">Query Table List</a></li>
|
||||||
|
<li><a href="#operation_query_schema">Query Table Schema</a></li>
|
||||||
|
<li><a href="#operation_create_schema">Create Table Or Update Table Schema</a></li>
|
||||||
|
<li><a href="#operation_table_metadata">Query Table Metadata</a></li>
|
||||||
|
<li><a href="#operation_delete_table">Delete Table</a></li>
|
||||||
|
<li><a href="#operation_cell_query_single">Cell Query (Single Value)</a></li>
|
||||||
|
<li><a href="#operation_cell_query_multiple">Cell or Row Query (Multiple Values)</a></li>
|
||||||
|
<li><a href="#operation_cell_store_single">Cell Store (Single)</a></li>
|
||||||
|
<li><a href="#operation_cell_store_multiple">Cell Store (Multiple)</a></li>
|
||||||
|
<li><a href="#operation_delete">Row, Column, or Cell Delete</a></li>
|
||||||
|
<li><a href="#operation_scanner_create">Scanner Creation</a></li>
|
||||||
|
<li><a href="#operation_scanner_next">Scanner Get Next</a></li>
|
||||||
|
<li><a href="#operation_scanner_delete">Scanner Deletion</a></li>
|
||||||
|
</ol>
|
||||||
|
<li><a href="#xmlschema">XML Schema</a></li>
|
||||||
|
<li><a href="#pbufschema">Protobufs Schema</a></li>
|
||||||
|
</ol>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a name="deployment">
|
||||||
|
<h2>Deployment</h2>
|
||||||
|
</a>
|
||||||
|
<p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a name="deployment_daemon">
|
||||||
|
<h3>Daemon</h3>
|
||||||
|
</a>
|
||||||
|
<p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a name=deployment_servlet">
|
||||||
|
<h3>Servlet</h3>
|
||||||
|
</a>
|
||||||
|
<p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
<a name="rest">
|
<a name="rest">
|
||||||
|
@ -153,10 +201,14 @@ Address with table, row, column (and optional qualifier), and optional timestamp
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
|
<a name="operations">
|
||||||
<h2>Operations</h2>
|
<h2>Operations</h2>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_version">
|
||||||
<h3>Query Software Version</h3>
|
<h3>Query Software Version</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /version
|
GET /version
|
||||||
|
@ -192,6 +244,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 212<br>
|
Content-Length: 212<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<Version Stargate="0.0.1" OS="Linux 2.6.18-128.1.6.el5.centos.plusxen amd64"<br>
|
<Version Stargate="0.0.1" OS="Linux 2.6.18-128.1.6.el5.centos.plusxen amd64"<br>
|
||||||
JVM="Sun Microsystems Inc. 1.6.0_13-11.3-b02" Jetty="6.1.14" Jersey="1.1.0-e<br>
|
JVM="Sun Microsystems Inc. 1.6.0_13-11.3-b02" Jetty="6.1.14" Jersey="1.1.0-e<br>
|
||||||
a"/><br>
|
a"/><br>
|
||||||
|
@ -226,7 +279,54 @@ Content-Type: application/x-protobuf<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_storage_cluster_version">
|
||||||
<h3>Query Storage Cluster Version</h3>
|
<h3>Query Storage Cluster Version</h3>
|
||||||
|
</a>
|
||||||
|
<p>
|
||||||
|
<pre>
|
||||||
|
GET /version/cluster
|
||||||
|
</pre>
|
||||||
|
<p>
|
||||||
|
Returns version information regarding the HBase cluster backing the Stargate instance.
|
||||||
|
<p>
|
||||||
|
Examples:
|
||||||
|
<p>
|
||||||
|
<blockquote>
|
||||||
|
<tt>
|
||||||
|
% curl http://localhost:8000/version/cluster<br>
|
||||||
|
<br>
|
||||||
|
HTTP/1.1 200 OK<br>
|
||||||
|
Content-Length: 6<br>
|
||||||
|
Cache-Control: no-cache<br>
|
||||||
|
Content-Type: text/plain<br>
|
||||||
|
<br>
|
||||||
|
0.20.0<br>
|
||||||
|
<br>
|
||||||
|
% curl -H "Accept: text/xml" http://localhost:8000/version/cluster<br>
|
||||||
|
<br>
|
||||||
|
HTTP/1.1 200 OK<br>
|
||||||
|
Cache-Control: no-cache<br>
|
||||||
|
Content-Type: text/xml<br>
|
||||||
|
Content-Length: 94<br>
|
||||||
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
|
<ClusterVersion>0.20.0</ClusterVersion><br>
|
||||||
|
<br>
|
||||||
|
% curl -H "Accept: application/json" http://localhost:8000/version/cluster<br>
|
||||||
|
<br>
|
||||||
|
HTTP/1.1 200 OK<br>
|
||||||
|
Cache-Control: no-cache<br>
|
||||||
|
Content-Type: application/json<br>
|
||||||
|
Transfer-Encoding: chunked<br>
|
||||||
|
<br>
|
||||||
|
"0.20.0"<br>
|
||||||
|
</tt>
|
||||||
|
</blockquote>
|
||||||
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_storage_cluster_status">
|
||||||
|
<h3>Query Storage Cluster Status</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /status/cluster
|
GET /status/cluster
|
||||||
|
@ -275,6 +375,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 1301<br>
|
Content-Length: 1301<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<ClusterStatus requests="1" regions="13" averageLoad="13.0"><DeadNodes/><LiveN<br>
|
<ClusterStatus requests="1" regions="13" averageLoad="13.0"><DeadNodes/><LiveN<br>
|
||||||
odes><Node startCode="1244960965781" requests="1" name="test:37154"><Region na<br>
|
odes><Node startCode="1244960965781" requests="1" name="test:37154"><Region na<br>
|
||||||
me="dXJscyxodHRwfHd3dy5sZWdhY3kuY29tfDgwfHNpdGU9TGVnYWN5fGFhbXN6PTMwMHgyNTB8YX<br>
|
me="dXJscyxodHRwfHd3dy5sZWdhY3kuY29tfDgwfHNpdGU9TGVnYWN5fGFhbXN6PTMwMHgyNTB8YX<br>
|
||||||
|
@ -319,8 +420,9 @@ TE4Nw=="}]}}}<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_query_tables">
|
||||||
<h3>Query Table List</h3>
|
<h3>Query Table List</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /
|
GET /
|
||||||
|
@ -355,6 +457,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 121<br>
|
Content-Length: 121<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<TableList><table name="content"/><table name="urls"/></TableList><br>
|
<TableList><table name="content"/><table name="urls"/></TableList><br>
|
||||||
<br>
|
<br>
|
||||||
% curl -H "Accept: application/json" http://localhost:8000/<br>
|
% curl -H "Accept: application/json" http://localhost:8000/<br>
|
||||||
|
@ -378,7 +481,9 @@ Content-Type: application/x-protobuf<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_query_schema">
|
||||||
<h3>Query Table Schema</h3>
|
<h3>Query Table Schema</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /<table>/schema
|
GET /<table>/schema
|
||||||
|
@ -420,6 +525,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 618<br>
|
Content-Length: 618<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<TableSchema name="content" IS_META="false" IS_ROOT="false"><ColumnSchema nam<br>
|
<TableSchema name="content" IS_META="false" IS_ROOT="false"><ColumnSchema nam<br>
|
||||||
e="content" BLOCKSIZE="65536" BLOOMFILTER="false" BLOCKCACHE="false" COMPRESS<br>
|
e="content" BLOCKSIZE="65536" BLOOMFILTER="false" BLOCKCACHE="false" COMPRESS<br>
|
||||||
ION="GZ" LENGTH="2147483647" VERSIONS="1" TTL="-1" IN_MEMORY="false"/><Column<br>
|
ION="GZ" LENGTH="2147483647" VERSIONS="1" TTL="-1" IN_MEMORY="false"/><Column<br>
|
||||||
|
@ -462,10 +568,13 @@ Content-Type: application/x-protobuf<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_create_schema">
|
||||||
<h3>Create Table Or Update Table Schema</h3>
|
<h3>Create Table Or Update Table Schema</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
PUT /<table>/schema
|
PUT /<table>/schema
|
||||||
|
|
||||||
POST /<table>/schema
|
POST /<table>/schema
|
||||||
</pre>
|
</pre>
|
||||||
<p>
|
<p>
|
||||||
|
@ -478,13 +587,15 @@ in the desired encoding.
|
||||||
Set Content-Type header to <tt>text/xml</tt> if the desired encoding is XML.
|
Set Content-Type header to <tt>text/xml</tt> if the desired encoding is XML.
|
||||||
Set Content-Type header to <tt>application/json</tt> if the desired encoding
|
Set Content-Type header to <tt>application/json</tt> if the desired encoding
|
||||||
is JSON.
|
is JSON.
|
||||||
Set Content-Type header to <tt>application/x-protobuf</tt>tt> if the desired
|
Set Content-Type header to <tt>application/x-protobuf</tt> if the desired
|
||||||
encoding is protobufs.
|
encoding is protobufs.
|
||||||
If not successful, returns appropriate HTTP error status code.
|
If not successful, returns appropriate HTTP error status code.
|
||||||
If successful, returns HTTP 200 status.
|
If successful, returns HTTP 200 status.
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_table_metadata">
|
||||||
<h3>Query Table Metadata</h3>
|
<h3>Query Table Metadata</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /<table>/regions
|
GET /<table>/regions
|
||||||
|
@ -509,6 +620,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 1555<br>
|
Content-Length: 1555<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<TableInfo name="content"><Region location="test:51025" endKey="M2VmMTZkNzc2Nj<br>
|
<TableInfo name="content"><Region location="test:51025" endKey="M2VmMTZkNzc2Nj<br>
|
||||||
AzYmY5YjllNzc1YzljZWI2NDg2MGY=" startKey="" id="1244851999187" name="content,,<br>
|
AzYmY5YjllNzc1YzljZWI2NDg2MGY=" startKey="" id="1244851999187" name="content,,<br>
|
||||||
1244851999187"/><Region location="test:51025" endKey="NjAxMjkyYTgzOWI5NWU1MDIw<br>
|
1244851999187"/><Region location="test:51025" endKey="NjAxMjkyYTgzOWI5NWU1MDIw<br>
|
||||||
|
@ -574,7 +686,9 @@ Content-Type: application/x-protobuf<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_delete_table">
|
||||||
<h3>Delete Table</h3>
|
<h3>Delete Table</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
DELETE /<table>/schema
|
DELETE /<table>/schema
|
||||||
|
@ -599,7 +713,9 @@ Content-Length: 0<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_cell_query_single">
|
||||||
<h3>Cell Query (Single Value)</h3>
|
<h3>Cell Query (Single Value)</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /<table>/<row>/
|
GET /<table>/<row>/
|
||||||
|
@ -615,7 +731,8 @@ If not successful, returns appropriate HTTP error status code.
|
||||||
If successful, returns HTTP 200 status and cell data in the response body in
|
If successful, returns HTTP 200 status and cell data in the response body in
|
||||||
the requested encoding. If the encoding is binary, returns row, column, and
|
the requested encoding. If the encoding is binary, returns row, column, and
|
||||||
timestamp in X headers: <tt>X-Row</tt>, <tt>X-Column</tt>, and
|
timestamp in X headers: <tt>X-Row</tt>, <tt>X-Column</tt>, and
|
||||||
<tt>X-Timestamp</tt>, respectively.
|
<tt>X-Timestamp</tt>, respectively. Depending on the precision of the resource
|
||||||
|
specification, some of the X-headers may be elided as redundant.
|
||||||
<p>
|
<p>
|
||||||
Examples:
|
Examples:
|
||||||
<p>
|
<p>
|
||||||
|
@ -628,6 +745,7 @@ Cache-Control: max-age=14400<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 521<br>
|
Content-Length: 521<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<CellSet><Row key="MDAwMTI2MTRmN2Q0M2RmNjQxODUyMzQ0NWE2Nzg3ZDY="><Cell timesta<br>
|
<CellSet><Row key="MDAwMTI2MTRmN2Q0M2RmNjQxODUyMzQ0NWE2Nzg3ZDY="><Cell timesta<br>
|
||||||
mp="1244880122250" column="Y29udGVudDpyYXc=">PCFET0NUWVBFIEhUTUwgUFVCTElDICItL<br>
|
mp="1244880122250" column="Y29udGVudDpyYXc=">PCFET0NUWVBFIEhUTUwgUFVCTElDICItL<br>
|
||||||
y9JRVRGLy9EVEQgSFRNTCAyLjAvL0VOIj4KPGh0bWw+PGhlYWQ+Cjx0aXRsZT4zMDEgTW92ZWQgUGV<br>
|
y9JRVRGLy9EVEQgSFRNTCAyLjAvL0VOIj4KPGh0bWw+PGhlYWQ+Cjx0aXRsZT4zMDEgTW92ZWQgUGV<br>
|
||||||
|
@ -676,7 +794,9 @@ Content-Type: application/octet-stream<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_cell_query_multiple">
|
||||||
<h3>Cell or Row Query (Multiple Values)</h3>
|
<h3>Cell or Row Query (Multiple Values)</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /<table>/<row>
|
GET /<table>/<row>
|
||||||
|
@ -689,12 +809,20 @@ GET /<table>/<row>
|
||||||
Retrieves one or more cells from a full row, or one or more specified columns
|
Retrieves one or more cells from a full row, or one or more specified columns
|
||||||
in the row, with optional filtering via timestamp, and an optional restriction
|
in the row, with optional filtering via timestamp, and an optional restriction
|
||||||
on the maximum number of versions to return.
|
on the maximum number of versions to return.
|
||||||
Set Accept header to <tt>text/xml for XML</tt> reply.
|
Set Accept header to <tt>text/xml</tt> for XML reply.
|
||||||
Set Accept header to <tt>application/json</tt> for JSON reply.
|
Set Accept header to <tt>application/json</tt> for JSON reply.
|
||||||
Set Accept header to <tt>application/x-protobuf</tt> for protobufs.
|
Set Accept header to <tt>application/x-protobuf</tt> for protobufs.
|
||||||
|
Set Accept header to <tt>application/octet-stream</tt> for binary.
|
||||||
If not successful, returns appropriate HTTP error status code.
|
If not successful, returns appropriate HTTP error status code.
|
||||||
If successful, returns row results in the requested encoding.
|
If successful, returns row results in the requested encoding.
|
||||||
<p>
|
<p>
|
||||||
|
NOTE: If binary encoding is requested, only one cell can be returned, the
|
||||||
|
first to match the resource specification. The row, column, and timestamp
|
||||||
|
associated with the cell will be transmitted in X headers: <tt>X-Row</tt>,
|
||||||
|
<tt>X-Column</tt>, and <tt>X-Timestamp</tt>, respectively. Depending on the
|
||||||
|
precision of the resource specification, some of the X-headers may be elided
|
||||||
|
as redundant.
|
||||||
|
<p>
|
||||||
<b>Suffix Globbing</b>
|
<b>Suffix Globbing</b>
|
||||||
<p>
|
<p>
|
||||||
Multiple value queries of a row can optionally append a suffix glob on the row
|
Multiple value queries of a row can optionally append a suffix glob on the row
|
||||||
|
@ -720,6 +848,7 @@ Cache-Control: max-age=14400<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Transfer-Encoding: chunked<br>
|
Transfer-Encoding: chunked<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<CellSet><Row key="aHR0cHx3d3cudGVsZWdyYXBoLmNvLnVrfDgwfG5ld3N8d29ybGRuZXdzfG5<br>
|
<CellSet><Row key="aHR0cHx3d3cudGVsZWdyYXBoLmNvLnVrfDgwfG5ld3N8d29ybGRuZXdzfG5<br>
|
||||||
vcnRoYW1lcmljYXx1c2F8NTQ5MTI4NHxBcm5vbGQtU2Nod2FyemVuZWdnZXItdW52ZWlscy1wYXBlc<br>
|
vcnRoYW1lcmljYXx1c2F8NTQ5MTI4NHxBcm5vbGQtU2Nod2FyemVuZWdnZXItdW52ZWlscy1wYXBlc<br>
|
||||||
mxlc3MtY2xhc3Nyb29tcy1wbGFuLmh0bWw="><Cell timestamp="1244701257843" column="a<br>
|
mxlc3MtY2xhc3Nyb29tcy1wbGFuLmh0bWw="><Cell timestamp="1244701257843" column="a<br>
|
||||||
|
@ -797,7 +926,9 @@ Content-Type: application/x-protobuf<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
<h3>Cell Store (Single Value)</h3>
|
<a name="operation_cell_store_single">
|
||||||
|
<h3>Cell Store (Single)</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
PUT /<table>/<row>/<column>( : <qualifier> )? ( / <timestamp> )?
|
PUT /<table>/<row>/<column>( : <qualifier> )? ( / <timestamp> )?
|
||||||
|
@ -814,6 +945,11 @@ Set Content-Type header to <tt>application/octet-stream</tt> for binary encoding
|
||||||
When using binary encoding, optionally, set X-Timestamp header to the desired
|
When using binary encoding, optionally, set X-Timestamp header to the desired
|
||||||
timestamp.
|
timestamp.
|
||||||
<p>
|
<p>
|
||||||
|
PUT and POST operations are equivalent here: Specified addresses without
|
||||||
|
existing data will create new values. Specified addresses with existing data
|
||||||
|
will create new versions, overwriting an existing version if all of { row,
|
||||||
|
column:qualifer, timestamp } match that of the existing value.
|
||||||
|
<p>
|
||||||
See "Cell Query (Single Value)" section for encoding examples.
|
See "Cell Query (Single Value)" section for encoding examples.
|
||||||
<p>
|
<p>
|
||||||
Examples:
|
Examples:
|
||||||
|
@ -828,7 +964,9 @@ Content-Length: 0<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
<h3>Cell Store (Batched)</h3>
|
<a name="operation_cell_store_multiple">
|
||||||
|
<h3>Cell Store (Multiple)</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
PUT /<table>/<false-row-key>
|
PUT /<table>/<false-row-key>
|
||||||
|
@ -842,11 +980,19 @@ multiple values to a table in batch. If not successful, returns appropriate
|
||||||
HTTP error status code. If successful, returns HTTP 200 status.
|
HTTP error status code. If successful, returns HTTP 200 status.
|
||||||
Set Content-Type to <tt>text/xml</tt> for XML encoding.
|
Set Content-Type to <tt>text/xml</tt> for XML encoding.
|
||||||
Set Content-Type header to <tt>application/x-protobuf</tt> for protobufs encoding.
|
Set Content-Type header to <tt>application/x-protobuf</tt> for protobufs encoding.
|
||||||
Supply commit data in the PUT or POST body. See "Cell or Row Query (Multiple
|
Supply commit data in the PUT or POST body.
|
||||||
Values)" for encoding examples.
|
<p>
|
||||||
|
PUT and POST operations are equivalent here: Specified addresses without
|
||||||
|
existing data will create new values. Specified addresses with existing data
|
||||||
|
will create new versions, overwriting an existing version if all of { row,
|
||||||
|
column:qualifer, timestamp } match that of the existing value.
|
||||||
|
<p>
|
||||||
|
See "Cell or Row Query (Multiple Values)" for encoding examples.
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_delete">
|
||||||
<h3>Row, Column, or Cell Delete</h3>
|
<h3>Row, Column, or Cell Delete</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
DELETE /<table>/<row>
|
DELETE /<table>/<row>
|
||||||
|
@ -862,16 +1008,17 @@ NOTE: <tt>DELETE /<table></tt> will not work.
|
||||||
Use <tt>DELETE /<table>/schema</tt> instead.
|
Use <tt>DELETE /<table>/schema</tt> instead.
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_scanner_create">
|
||||||
<h3>Scanner Creation</h3>
|
<h3>Scanner Creation</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
PUT /<table>>scanner
|
PUT /<table>/scanner
|
||||||
|
|
||||||
POST /<table>>scanner
|
POST /<table>/scanner
|
||||||
</pre>
|
</pre>
|
||||||
<p>
|
<p>
|
||||||
Allocates a new table scanner.
|
Allocates a new table scanner.
|
||||||
Use a Cache-Control header directive of "no-cache".
|
|
||||||
If not successful, returns appropriate HTTP error status code.
|
If not successful, returns appropriate HTTP error status code.
|
||||||
If successful, returns HTTP 201 status (created) and the URI which should be
|
If successful, returns HTTP 201 status (created) and the URI which should be
|
||||||
used to address the scanner, e.g.
|
used to address the scanner, e.g.
|
||||||
|
@ -895,7 +1042,9 @@ Content-Length: 0<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_scanner_next">
|
||||||
<h3>Scanner Get Next</h3>
|
<h3>Scanner Get Next</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
GET /<table>/scanner/<scanner-id>
|
GET /<table>/scanner/<scanner-id>
|
||||||
|
@ -911,7 +1060,9 @@ Otherwise, returns HTTP 200 status and row and cell data in the response body.
|
||||||
See examples from the "Cell or Row Query (Multiple Values)" section.
|
See examples from the "Cell or Row Query (Multiple Values)" section.
|
||||||
<p>
|
<p>
|
||||||
NOTE: The binary encoding option returns only one cell regardless of the
|
NOTE: The binary encoding option returns only one cell regardless of the
|
||||||
batching parameter supplied during scanner creation.
|
batching parameter supplied during scanner creation. The row, column, and
|
||||||
|
timestamp associated with the cell are transmitted as X-headers:
|
||||||
|
<tt>X-Row</tt>, <tt>X-Column</tt>, and <tt>X-Timestamp</tt> respectively.
|
||||||
<p>
|
<p>
|
||||||
Examples:
|
Examples:
|
||||||
<p>
|
<p>
|
||||||
|
@ -924,6 +1075,7 @@ Cache-Control: no-cache<br>
|
||||||
Content-Type: text/xml<br>
|
Content-Type: text/xml<br>
|
||||||
Content-Length: 589<br>
|
Content-Length: 589<br>
|
||||||
<br>
|
<br>
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><br>
|
||||||
<CellSet><Row key="MDAyMDFjMTAwNjk4ZGNkYjU5MDQxNTVkZGQ3OGRlZTk="><Cell timesta<br>
|
<CellSet><Row key="MDAyMDFjMTAwNjk4ZGNkYjU5MDQxNTVkZGQ3OGRlZTk="><Cell timesta<br>
|
||||||
mp="1244701281234" column="Y29udGVudDpyYXc=">PCFET0NUWVBFIEhUTUwgUFVCTElDICItL<br>
|
mp="1244701281234" column="Y29udGVudDpyYXc=">PCFET0NUWVBFIEhUTUwgUFVCTElDICItL<br>
|
||||||
y9JRVRGLy9EVEQgSFRNTCAyLjAvL0VOIj4KPGh0bWw+PGhlYWQ+Cjx0aXRsZT40MDQgTm90IEZvdW5<br>
|
y9JRVRGLy9EVEQgSFRNTCAyLjAvL0VOIj4KPGh0bWw+PGhlYWQ+Cjx0aXRsZT40MDQgTm90IEZvdW5<br>
|
||||||
|
@ -974,7 +1126,9 @@ Content-Type: application/octet-stream<br>
|
||||||
</blockquote>
|
</blockquote>
|
||||||
<p>
|
<p>
|
||||||
|
|
||||||
|
<a name="operation_scanner_delete">
|
||||||
<h3>Scanner Deletion</h3>
|
<h3>Scanner Deletion</h3>
|
||||||
|
</a>
|
||||||
<p>
|
<p>
|
||||||
<pre>
|
<pre>
|
||||||
DELETE /<table>/scanner/<scanner-id>
|
DELETE /<table>/scanner/<scanner-id>
|
||||||
|
|
Loading…
Reference in New Issue