Dear Wiki user, You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.
The following page has been changed by sishen: http://wiki.apache.org/hadoop/Hbase/HbaseRest ------------------------------------------------------------------------------ </tables> }}} + '''POST /''' + Create a table. + Headers: + Content-type: + application/xml: The client is sending the table metadata in an XML entity. + Returns: + HTTP 200 (OK) if the table could successfully be created. '''GET /[table_name]''' Retrieve metadata about the table. This includes column family descriptors. @@ -72, +79 @@ </table> }}} + '''PUT /[table_name]''' + Update the table schema. + Headers: + Content-type: + application/xml: The client is sending the table metadata in an XML entity. + Returns: + HTTP 200 (OK) if the table could successfully be updated. + + '''DELETE /[table_name]''' + Delete this table. + Returns: + HTTP 202 (Accepted) if the table could successfully be deleted. + + '''POST /[table_name]/disable''' + Disable this table + Returns: + HTTP 202 (Accepted) if the table could successfully be disabled. + + '''POST /[table_name]/enable''' + Enable this table + Returns: + HTTP 202 (Accepted) if the table could successfully be enabled. '''GET /[table_name]/regions''' Retrieve a list of the regions for this table so that you can efficiently split up the work (a la MapReduce). @@ -226, +255 @@ {{{ cd $HBASE_HOME - bin/hbase rest + bin/hbase rest start }}} Pass '''--help''' to see REST server usage. @@ -237, +266 @@ == Examples using curl == + + Here is a POST of create table. + + {{{ + [EMAIL PROTECTED]:~/Work/Personal/java/apache/hbase-trunk$curl -v -X POST -T - http://localhost:60050/api/ + * About to connect() to localhost port 60050 (#0) + * Trying ::1... connected + * Connected to localhost (::1) port 60050 (#0) + > POST /api/ HTTP/1.1 + > User-Agent: curl/7.16.3 (powerpc-apple-darwin9.0) libcurl/7.16.3 OpenSSL/0.9.7l zlib/1.2.3 + > Host: localhost:60050 + > Accept: */* + > Transfer-Encoding: chunked + > Expect: 100-continue + > + < HTTP/1.1 100 Continue + <?xml version="1.0" encoding="UTF-8"?> + <table> + <name>tables</name> + <columnfamilies> + <columnfamily> + <name>subscription</name> + <max-versions>2</max-versions> + <compression>NONE</compression> + <in-memory>false</in-memory> + <block-cache>true</block-cache> + </columnfamily> + </columnfamilies> + </table> + ^D + < HTTP/1.1 200 OK + < Date: Wed, 13 Aug 2008 18:59:38 GMT + < Server: Jetty/5.1.4 (Mac OS X/10.5.4 i386 java/1.5.0_13 + < Content-Length: 0 + < + * Connection #0 to host localhost left intact + * Closing connection #0 + }}} + + Here is a POST of disable table. + + {{{ + [EMAIL PROTECTED]:~/Work/Personal/java/apache/hbase-trunk$curl -v -X POST http://localhost:60050/api/tables/disable + * About to connect() to localhost port 60050 (#0) + * Trying ::1... connected + * Connected to localhost (::1) port 60050 (#0) + > POST /api/tables/disable HTTP/1.1 + > User-Agent: curl/7.16.3 (powerpc-apple-darwin9.0) libcurl/7.16.3 OpenSSL/0.9.7l zlib/1.2.3 + > Host: localhost:60050 + > Accept: */* + > + < HTTP/1.1 202 Accepted + < Date: Wed, 13 Aug 2008 18:55:03 GMT + < Server: Jetty/5.1.4 (Mac OS X/10.5.4 i386 java/1.5.0_13 + < Content-Length: 0 + < + * Connection #0 to host localhost left intact + * Closing connection #0 + }}} + + Here is a POST of enable table. + + {{{ + [EMAIL PROTECTED]:~/Work/Personal/java/apache/hbase-trunk$curl -v -X POST http://localhost:60050/api/tables/enable + * About to connect() to localhost port 60050 (#0) + * Trying ::1... connected + * Connected to localhost (::1) port 60050 (#0) + > POST /api/tables/enable HTTP/1.1 + > User-Agent: curl/7.16.3 (powerpc-apple-darwin9.0) libcurl/7.16.3 OpenSSL/0.9.7l zlib/1.2.3 + > Host: localhost:60050 + > Accept: */* + > + < HTTP/1.1 202 Accepted + < Date: Wed, 13 Aug 2008 18:56:20 GMT + < Server: Jetty/5.1.4 (Mac OS X/10.5.4 i386 java/1.5.0_13 + < Content-Length: 0 + < + * Connection #0 to host localhost left intact + * Closing connection #0 + }}} + + Here is a DELETE of a table. + + {{{ + [EMAIL PROTECTED]:~/Work/Personal/java/apache/hbase-trunk$curl -v -X DELETE http://localhost:60050/api/tables + * About to connect() to localhost port 60050 (#0) + * Trying ::1... connected + * Connected to localhost (::1) port 60050 (#0) + > DELETE /api/tables HTTP/1.1 + > User-Agent: curl/7.16.3 (powerpc-apple-darwin9.0) libcurl/7.16.3 OpenSSL/0.9.7l zlib/1.2.3 + > Host: localhost:60050 + > Accept: */* + > + < HTTP/1.1 202 Accepted + < Date: Wed, 13 Aug 2008 18:57:41 GMT + < Server: Jetty/5.1.4 (Mac OS X/10.5.4 i386 java/1.5.0_13 + < Content-Length: 0 + < + * Connection #0 to host localhost left intact + * Closing connection #0 + }}} Here is a GET of a row. Notice how values are Base64'd.
