You are viewing a plain text version of this content. The canonical link for it is here.
Posted to common-commits@hadoop.apache.org by Apache Wiki <wi...@apache.org> on 2010/06/06 09:11:06 UTC

[Hadoop Wiki] Update of "Hbase/Stargate" by AndrewPurtell

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.

The "Hbase/Stargate" page has been changed by AndrewPurtell.
http://wiki.apache.org/hadoop/Hbase/Stargate?action=diff&rev1=3&rev2=4

--------------------------------------------------

   1. [[#5|Operations]]
   1. [[#6|XML Schema]]
   1. [[#7|Protobufs Schema]]
-  1. [[#8|Roadmap]]
  
  <<Anchor(1)>>
  == Status ==
@@ -429, +428 @@

  Content-Length: 121
  
  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
- <TableList><table name="content"/><table name="urls"/></TableList>
+ <TableList><Table name="content"/><Table name="urls"/></TableList>
  
  % curl -H "Accept: application/json" http://localhost:8000/
  
@@ -438, +437 @@

  Content-Type: application/json
  Transfer-Encoding: chunked
  
- {"table":[{"name":"content"},{"name":"urls"}]}
+ {"Table":[{"name":"content"},{"name":"urls"}]}
  
  % curl -H "Accept: application/x-protobuf" http://localhost:8000/
  
@@ -632, +631 @@

  
  === Cell Query (Single Value) ===
  
- {{{GET /<table>/<row>/
+ {{{GET /<table>/<row>/ }}}<<BR>>
-     <column> ( : <qualifier> )?
+ {{{    <column> ( : <qualifier> )? }}}<<BR>>
-   ( / <timestamp> )? }}}
+ {{{  ( / <timestamp> )? }}}<<BR>>
  
  Retrieves one cell, with optional specification of timestamp. Set Accept header to text/xml for XML reply. Set Accept header to application/x-protobuf for protobufs. Set Accept header to application/octet-stream for binary. If not successful, returns appropriate HTTP error status code. 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 timestamp in X headers: X-Row, X-Column, and X-Timestamp, respectively. Depending on the precision of the resource specification, some of the X-headers may be elided as redundant. 
  
@@ -697, +696 @@

  
  === Cell or Row Query (Multiple Values) ===
  
- {{{GET /<table>/<row>
+ {{{GET /<table>/<row> }}}<<BR>>
-   ( / ( <column> ( : <qualifier> )?
+ {{{  ( / ( <column> ( : <qualifier> )? }}}<<BR>>
-       ( , <column> ( : <qualifier> )? )+ )?
+ {{{      ( , <column> ( : <qualifier> )? )+ )? }}}<<BR>>
-     ( / ( <start-timestamp> ',' )? <end-timestamp> )? )?
+ {{{    ( / ( <start-timestamp> ',' )? <end-timestamp> )? )? }}}<<BR>>
-   ( ?v= <num-versions> )? }}}
+ {{{  ( ?v= <num-versions> )? }}}<<BR>>
  
  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 on the maximum number of versions to return. Set Accept header to text/xml for XML reply. Set Accept header to application/json for JSON reply. Set Accept header to application/x-protobuf for protobufs. Set Accept header to application/octet-stream for binary. If not successful, returns appropriate HTTP error status code. If successful, returns row results in the requested encoding. 
  
@@ -711, +710 @@

  
  Multiple value queries of a row can optionally append a suffix glob on the row key. This is a restricted form of scanner which will return all values in all rows that have keys which contain the supplied key on their left hand side, for example: 
  
+     {{{org.someorg.* }}}<<BR>>
-     {{{
-     org.someorg.*
-         -> org.someorg.blog
+     {{{ -> org.someorg.blog }}}<<BR>>
-         -> org.someorg.home
+     {{{ -> org.someorg.home }}}<<BR>>
-         -> org.someorg.www }}}
+     {{{ -> org.someorg.www }}}<<BR>>
  
  Examples: 
  
@@ -837, +835 @@

  
  === Row, Column, or Cell Delete ===
  
- {{{DELETE /<table>/<row>
+ {{{DELETE /<table>/<row> }}}<<BR>>
-   ( / ( <column> ( : <qualifier> )? 
+ {{{  ( / ( <column> ( : <qualifier> )? }}}<<BR>>
-     ( / <timestamp> )? )? }}}
+ {{{    ( / <timestamp> )? )? }}}<<BR>>
  
  Deletes an entire row, a entire column family, or specific cell(s), depending on how specific the data address. If not successful, returns appropriate HTTP error status code. If successful, returns HTTP 200 status. 
  
@@ -957, +955 @@

  <schema targetNamespace="StargateSchema" elementFormDefault="qualified" 
  xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="StargateSchema">
  
-     <element name="CellSet" type="tns:CellSet"></element>
-     
-     <complexType name="CellSet">
-       <sequence>
-         <element name="row" type="tns:Row" maxOccurs="unbounded" minOccurs="1"></element>
-       </sequence>
-     </complexType>
- 
-     <complexType name="Row">
-       <sequence>
-         <element name="key" type="base64Binary"></element>
-         <element name="cell" type="tns:Cell" maxOccurs="unbounded" minOccurs="1"></element>
-       </sequence>
-     </complexType>
- 
-     <complexType name="Cell">
-       <sequence>
-         <element name="value" maxOccurs="1" minOccurs="1"><simpleType><restriction base="base64Binary"></restriction></simpleType></element>
-       </sequence>
-       <attribute name="column" type="base64Binary" />
-       <attribute name="timestamp" type="int" />
-     </complexType>
- 
      <element name="Version" type="tns:Version"></element>
      
      <complexType name="Version">
-       <attribute name="Stargate" type="string"></attribute>
+       <attribute name="REST" type="string"></attribute>
        <attribute name="JVM" type="string"></attribute>
        <attribute name="OS" type="string"></attribute>
        <attribute name="Server" type="string"></attribute>
        <attribute name="Jersey" type="string"></attribute>
      </complexType>
  
- 
      <element name="TableList" type="tns:TableList"></element>
      
      <complexType name="TableList">
-       <sequence>
+         <sequence>
-         <element name="table" type="tns:Table" maxOccurs="unbounded" minOccurs="1"></element>
+             <element name="table" type="tns:Table" maxOccurs="unbounded" minOccurs="1"></element>
-       </sequence>
+         </sequence>
      </complexType>
  
      <complexType name="Table">
-       <sequence>
+         <sequence>
-         <element name="name" type="string"></element>
+             <element name="name" type="string"></element>
-       </sequence>
+         </sequence>
      </complexType>
  
      <element name="TableInfo" type="tns:TableInfo"></element>
      
      <complexType name="TableInfo">
-       <sequence>
+         <sequence>
-         <element name="region" type="tns:TableRegion" maxOccurs="unbounded" minOccurs="1"></element>
+             <element name="region" type="tns:TableRegion" maxOccurs="unbounded" minOccurs="1"></element>
-       </sequence>
+         </sequence>
-       <attribute name="name" type="string"></attribute>
+         <attribute name="name" type="string"></attribute>
      </complexType>
  
      <complexType name="TableRegion">
-       <attribute name="name" type="string"></attribute>
+         <attribute name="name" type="string"></attribute>
-       <attribute name="id" type="int"></attribute>
+         <attribute name="id" type="int"></attribute>
-       <attribute name="startKey" type="base64Binary"></attribute>
+         <attribute name="startKey" type="base64Binary"></attribute>
-       <attribute name="endKey" type="base64Binary"></attribute>
+         <attribute name="endKey" type="base64Binary"></attribute>
-       <attribute name="location" type="string"></attribute>
+         <attribute name="location" type="string"></attribute>
      </complexType>
  
      <element name="TableSchema" type="tns:TableSchema"></element>
      
      <complexType name="TableSchema">
-       <sequence>
+         <sequence>
-         <element name="column" type="tns:ColumnSchema" maxOccurs="unbounded" minOccurs="1"></element>
+             <element name="column" type="tns:ColumnSchema" maxOccurs="unbounded" minOccurs="1"></element>
-       </sequence>
+         </sequence>
-       <attribute name="name" type="string"></attribute>
+         <attribute name="name" type="string"></attribute>
-       <anyAttribute></anyAttribute>
+         <anyAttribute></anyAttribute>
      </complexType>
  
      <complexType name="ColumnSchema">
-       <attribute name="name" type="string"></attribute>
+         <attribute name="name" type="string"></attribute>
-       <anyAttribute></anyAttribute>
+         <anyAttribute></anyAttribute>
+     </complexType>
+ 
+     <element name="CellSet" type="tns:CellSet"></element>
+ 
+     <complexType name="CellSet">
+         <sequence>
+             <element name="row" type="tns:Row" maxOccurs="unbounded" minOccurs="1"></element>
+         </sequence>
+     </complexType>
+ 
+     <element name="Row" type="tns:Row"></element>
+ 
+     <complexType name="Row">
+         <sequence>
+             <element name="key" type="base64Binary"></element>
+             <element name="cell" type="tns:Cell" maxOccurs="unbounded" minOccurs="1"></element>
+         </sequence>
+     </complexType>
+  
+     <element name="Cell" type="tns:Cell"></element>
+ 
+     <complexType name="Cell">
+         <sequence>
+             <element name="value" maxOccurs="1" minOccurs="1">
+                 <simpleType><restriction base="base64Binary">
+                 </simpleType>
+             </element>
+         </sequence>
+         <attribute name="column" type="base64Binary" />
+         <attribute name="timestamp" type="int" />
      </complexType>
  
      <element name="Scanner" type="tns:Scanner"></element>
      
      <complexType name="Scanner">
+         <sequence>
+             <element name="column" type="base64Binary" minOccurs="0" maxOccurs="unbounded"></element>
+         </sequence>
+         <sequence>
+             <element name="filter" type="string" minOccurs="0" maxOccurs="1"></element>
+         </sequence>
-       <attribute name="startRow" type="base64Binary"></attribute>
+         <attribute name="startRow" type="base64Binary"></attribute>
-       <attribute name="endRow" type="base64Binary"></attribute>
+         <attribute name="endRow" type="base64Binary"></attribute>
-       <attribute name="columns" type="base64Binary"></attribute>
-       <attribute name="batch" type="int"></attribute>
+         <attribute name="batch" type="int"></attribute>
-       <attribute name="startTime" type="int"></attribute>
+         <attribute name="startTime" type="int"></attribute>
-       <attribute name="endTime" type="int"></attribute>
+         <attribute name="endTime" type="int"></attribute>
      </complexType>
  
+     <element name="StorageClusterVersion" type="tns:StorageClusterVersion" />
+ 
-     <element name="StorageClusterVersion"
-       type="tns:StorageClusterVersion">
-     </element>
-     
      <complexType name="StorageClusterVersion">
-       <attribute name="version" type="string"></attribute>
+         <attribute name="version" type="string"></attribute>
      </complexType>
  
      <element name="StorageClusterStatus"
-       type="tns:StorageClusterStatus">
+         type="tns:StorageClusterStatus">
      </element>
      
      <complexType name="StorageClusterStatus">
-       <sequence>
+         <sequence>
-         <element name="liveNode" type="tns:Node"
+             <element name="liveNode" type="tns:Node"
-           maxOccurs="unbounded" minOccurs="0">
+                 maxOccurs="unbounded" minOccurs="0">
-         </element>
+             </element>
-         <element name="deadNode" type="string" maxOccurs="unbounded"
+             <element name="deadNode" type="string" maxOccurs="unbounded"
-           minOccurs="0">
+                 minOccurs="0">
-         </element>
+             </element>
-       </sequence>
+         </sequence>
-       <attribute name="regions" type="int"></attribute>
+         <attribute name="regions" type="int"></attribute>
-       <attribute name="requests" type="int"></attribute>
+         <attribute name="requests" type="int"></attribute>
-       <attribute name="averageLoad" type="float"></attribute>
+         <attribute name="averageLoad" type="float"></attribute>
      </complexType>
  
      <complexType name="Node">
-       <sequence>
+         <sequence>
-         <element name="region" type="tns:Region" maxOccurs="unbounded" minOccurs="0"></element>
+             <element name="region" type="tns:Region"
+                 maxOccurs="unbounded" minOccurs="0">
+             </element>
-       </sequence>
+         </sequence>
-       <attribute name="name" type="string"></attribute>
+         <attribute name="name" type="string"></attribute>
-       <attribute name="startCode" type="int"></attribute>
+         <attribute name="startCode" type="int"></attribute>
-       <attribute name="requests" type="int"></attribute>
+         <attribute name="requests" type="int"></attribute>
-       <attribute name="heapSizeMB" type="int"></attribute>
+         <attribute name="heapSizeMB" type="int"></attribute>
-       <attribute name="maxHeapSizeMB" type="int"></attribute>
+         <attribute name="maxHeapSizeMB" type="int"></attribute>
      </complexType>
  
      <complexType name="Region">
-       <attribute name="name" type="base64Binary"></attribute>
+         <attribute name="name" type="base64Binary"></attribute>
-       <attribute name="stores" type="int"></attribute>
+         <attribute name="stores" type="int"></attribute>
-       <attribute name="storefiles" type="int"></attribute>
+         <attribute name="storefiles" type="int"></attribute>
-       <attribute name="storefileSizeMB" type="int"></attribute>
+         <attribute name="storefileSizeMB" type="int"></attribute>
-       <attribute name="memstoreSizeMB" type="int"></attribute>
+         <attribute name="memstoreSizeMB" type="int"></attribute>
-       <attribute name="storefileIndexSizeMB" type="int"></attribute>
+         <attribute name="storefileIndexSizeMB" type="int"></attribute>
      </complexType>
+ 
  </schema>
  }}}
  
@@ -1201, +1211 @@

  }
  }}}
  
- <<Anchor(8)>>
- == Roadmap ==
- 
- === HBase 0.21 ===
- 
-  1. Profiling and performance tuning and optimization. [[https://issues.apache.org/jira/browse/HBASE-1741|HBASE-1741]]
-  1. Support specification of filters for scanners [[https://issues.apache.org/jira/browse/HBASE-1696|HBASE-1696]]
-