2008-05-15 01:26:47 -04:00
|
|
|
<?php
|
|
|
|
|
/**
|
|
|
|
|
* Copyright 2008 The Apache Software Foundation
|
|
|
|
|
*
|
|
|
|
|
* Licensed to the Apache Software Foundation (ASF) under one
|
|
|
|
|
* or more contributor license agreements. See the NOTICE file
|
|
|
|
|
* distributed with this work for additional information
|
|
|
|
|
* regarding copyright ownership. The ASF licenses this file
|
|
|
|
|
* to you under the Apache License, Version 2.0 (the
|
|
|
|
|
* "License"); you may not use this file except in compliance
|
|
|
|
|
* with the License. You may obtain a copy of the License at
|
|
|
|
|
*
|
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
*
|
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
|
* limitations under the License.
|
|
|
|
|
*/
|
|
|
|
|
|
2008-09-11 16:12:52 -04:00
|
|
|
# Instructions:
|
|
|
|
|
# 1. Run Thrift to generate the php module HBase
|
2011-03-12 01:30:40 -05:00
|
|
|
# thrift -php ../../../src/main/resources/org/apache/hadoop/hbase/thrift/Hbase.thrift
|
2008-09-11 16:12:52 -04:00
|
|
|
# 2. Modify the import string below to point to {$THRIFT_HOME}/lib/php/src.
|
|
|
|
|
# 3. Execute {php DemoClient.php}. Note that you must use php5 or higher.
|
|
|
|
|
# 4. See {$THRIFT_HOME}/lib/php/README for additional help.
|
|
|
|
|
|
2008-05-15 01:26:47 -04:00
|
|
|
# Change this to match your thrift root
|
2008-09-11 16:12:52 -04:00
|
|
|
$GLOBALS['THRIFT_ROOT'] = '/Users/irubin/Thrift/thrift-20080411p1/lib/php/src';
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
require_once( $GLOBALS['THRIFT_ROOT'].'/Thrift.php' );
|
|
|
|
|
|
|
|
|
|
require_once( $GLOBALS['THRIFT_ROOT'].'/transport/TSocket.php' );
|
|
|
|
|
require_once( $GLOBALS['THRIFT_ROOT'].'/transport/TBufferedTransport.php' );
|
|
|
|
|
require_once( $GLOBALS['THRIFT_ROOT'].'/protocol/TBinaryProtocol.php' );
|
|
|
|
|
|
|
|
|
|
# According to the thrift documentation, compiled PHP thrift libraries should
|
2008-09-11 16:12:52 -04:00
|
|
|
# reside under the THRIFT_ROOT/packages directory. If these compiled libraries
|
|
|
|
|
# are not present in this directory, move them there from gen-php/.
|
2008-05-15 01:26:47 -04:00
|
|
|
require_once( $GLOBALS['THRIFT_ROOT'].'/packages/Hbase/Hbase.php' );
|
|
|
|
|
|
2008-09-11 16:12:52 -04:00
|
|
|
function printRow( $rowresult ) {
|
|
|
|
|
echo( "row: {$rowresult->row}, cols: \n" );
|
|
|
|
|
$values = $rowresult->columns;
|
2008-05-15 01:26:47 -04:00
|
|
|
asort( $values );
|
|
|
|
|
foreach ( $values as $k=>$v ) {
|
2008-09-11 16:12:52 -04:00
|
|
|
echo( " {$k} => {$v->value}\n" );
|
2008-05-15 01:26:47 -04:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$socket = new TSocket( 'localhost', 9090 );
|
|
|
|
|
$socket->setSendTimeout( 10000 ); // Ten seconds (too long for production, but this is just a demo ;)
|
|
|
|
|
$socket->setRecvTimeout( 20000 ); // Twenty seconds
|
|
|
|
|
$transport = new TBufferedTransport( $socket );
|
|
|
|
|
$protocol = new TBinaryProtocol( $transport );
|
|
|
|
|
$client = new HbaseClient( $protocol );
|
|
|
|
|
|
|
|
|
|
$transport->open();
|
|
|
|
|
|
|
|
|
|
$t = 'demo_table';
|
|
|
|
|
|
|
|
|
|
?><html>
|
|
|
|
|
<head>
|
|
|
|
|
<title>DemoClient</title>
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<pre>
|
|
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
|
# Scan all tables, look for the demo table and delete it.
|
|
|
|
|
#
|
|
|
|
|
echo( "scanning tables...\n" );
|
|
|
|
|
$tables = $client->getTableNames();
|
|
|
|
|
sort( $tables );
|
|
|
|
|
foreach ( $tables as $name ) {
|
|
|
|
|
echo( " found: {$name}\n" );
|
|
|
|
|
if ( $name == $t ) {
|
2008-09-11 16:12:52 -04:00
|
|
|
if ($client->isTableEnabled( $name )) {
|
|
|
|
|
echo( " disabling table: {$name}\n");
|
|
|
|
|
$client->disableTable( $name );
|
|
|
|
|
}
|
2008-05-15 01:26:47 -04:00
|
|
|
echo( " deleting table: {$name}\n" );
|
|
|
|
|
$client->deleteTable( $name );
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
|
# Create the demo table with two column families, entry: and unused:
|
|
|
|
|
#
|
|
|
|
|
$columns = array(
|
|
|
|
|
new ColumnDescriptor( array(
|
|
|
|
|
'name' => 'entry:',
|
|
|
|
|
'maxVersions' => 10
|
|
|
|
|
) ),
|
|
|
|
|
new ColumnDescriptor( array(
|
|
|
|
|
'name' => 'unused:'
|
|
|
|
|
) )
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
echo( "creating table: {$t}\n" );
|
|
|
|
|
try {
|
|
|
|
|
$client->createTable( $t, $columns );
|
|
|
|
|
} catch ( AlreadyExists $ae ) {
|
|
|
|
|
echo( "WARN: {$ae->message}\n" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
echo( "column families in {$t}:\n" );
|
|
|
|
|
$descriptors = $client->getColumnDescriptors( $t );
|
|
|
|
|
asort( $descriptors );
|
|
|
|
|
foreach ( $descriptors as $col ) {
|
|
|
|
|
echo( " column: {$col->name}, maxVer: {$col->maxVersions}\n" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
|
# Test UTF-8 handling
|
|
|
|
|
#
|
|
|
|
|
$invalid = "foo-\xfc\xa1\xa1\xa1\xa1\xa1";
|
|
|
|
|
$valid = "foo-\xE7\x94\x9F\xE3\x83\x93\xE3\x83\xBC\xE3\x83\xAB";
|
|
|
|
|
|
|
|
|
|
# non-utf8 is fine for data
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:foo',
|
|
|
|
|
'value' => $invalid
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, "foo", $mutations );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
# try empty strings
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:',
|
|
|
|
|
'value' => ""
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, "", $mutations );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
# this row name is valid utf8
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:foo',
|
|
|
|
|
'value' => $valid
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $valid, $mutations );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
# non-utf8 is not allowed in row names
|
|
|
|
|
try {
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:foo',
|
|
|
|
|
'value' => $invalid
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $invalid, $mutations );
|
2008-05-15 01:26:47 -04:00
|
|
|
throw new Exception( "shouldn't get here!" );
|
|
|
|
|
} catch ( IOError $e ) {
|
|
|
|
|
echo( "expected error: {$e->message}\n" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# Run a scanner on the rows we just created
|
|
|
|
|
echo( "Starting scanner...\n" );
|
|
|
|
|
$scanner = $client->scannerOpen( $t, "", array( "entry:" ) );
|
|
|
|
|
try {
|
2008-09-11 16:12:52 -04:00
|
|
|
while (true) printRow( $client->scannerGet( $scanner ) );
|
2008-05-15 01:26:47 -04:00
|
|
|
} catch ( NotFound $nf ) {
|
|
|
|
|
$client->scannerClose( $scanner );
|
|
|
|
|
echo( "Scanner finished\n" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#
|
|
|
|
|
# Run some operations on a bunch of rows.
|
|
|
|
|
#
|
|
|
|
|
for ($e=100; $e>=0; $e--) {
|
|
|
|
|
|
|
|
|
|
# format row keys as "00000" to "00100"
|
|
|
|
|
$row = str_pad( $e, 5, '0', STR_PAD_LEFT );
|
|
|
|
|
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'unused:',
|
|
|
|
|
'value' => "DELETE_ME"
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $row, $mutations);
|
|
|
|
|
printRow( $client->getRow( $t, $row ));
|
2008-05-15 01:26:47 -04:00
|
|
|
$client->deleteAllRow( $t, $row );
|
|
|
|
|
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:num',
|
|
|
|
|
'value' => "0"
|
|
|
|
|
) ),
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:foo',
|
|
|
|
|
'value' => "FOO"
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $row, $mutations );
|
|
|
|
|
printRow( $client->getRow( $t, $row ));
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:foo',
|
|
|
|
|
'isDelete' => 1
|
|
|
|
|
) ),
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:num',
|
|
|
|
|
'value' => '-1'
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $row, $mutations );
|
2008-09-11 16:12:52 -04:00
|
|
|
printRow( $client->getRow( $t, $row ) );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
2008-09-11 16:12:52 -04:00
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => "entry:num",
|
|
|
|
|
'value' => $e
|
|
|
|
|
) ),
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => "entry:sqr",
|
|
|
|
|
'value' => $e * $e
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRow( $t, $row, $mutations );
|
|
|
|
|
printRow( $client->getRow( $t, $row ));
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
$mutations = array(
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:num',
|
2008-09-11 16:12:52 -04:00
|
|
|
'value' => '-999'
|
2008-05-15 01:26:47 -04:00
|
|
|
) ),
|
|
|
|
|
new Mutation( array(
|
|
|
|
|
'column' => 'entry:sqr',
|
|
|
|
|
'isDelete' => 1
|
|
|
|
|
) ),
|
|
|
|
|
);
|
|
|
|
|
$client->mutateRowTs( $t, $row, $mutations, 1 ); # shouldn't override latest
|
2008-09-11 16:12:52 -04:00
|
|
|
printRow( $client->getRow( $t, $row ) );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
$versions = $client->getVer( $t, $row, "entry:num", 10 );
|
|
|
|
|
echo( "row: {$row}, values: \n" );
|
2008-09-11 16:12:52 -04:00
|
|
|
foreach ( $versions as $v ) echo( " {$v->value};\n" );
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
try {
|
|
|
|
|
$client->get( $t, $row, "entry:foo");
|
|
|
|
|
throw new Exception ( "shouldn't get here! " );
|
|
|
|
|
} catch ( NotFound $nf ) {
|
|
|
|
|
# blank
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$columns = array();
|
2008-09-11 16:12:52 -04:00
|
|
|
foreach ( $client->getColumnDescriptors($t) as $col=>$desc ) {
|
|
|
|
|
echo("column with name: {$desc->name}\n");
|
|
|
|
|
$columns[] = $desc->name.":";
|
|
|
|
|
}
|
2008-05-15 01:26:47 -04:00
|
|
|
|
|
|
|
|
echo( "Starting scanner...\n" );
|
|
|
|
|
$scanner = $client->scannerOpenWithStop( $t, "00020", "00040", $columns );
|
|
|
|
|
try {
|
2008-09-11 16:12:52 -04:00
|
|
|
while (true) printRow( $client->scannerGet( $scanner ) );
|
2008-05-15 01:26:47 -04:00
|
|
|
} catch ( NotFound $nf ) {
|
|
|
|
|
$client->scannerClose( $scanner );
|
|
|
|
|
echo( "Scanner finished\n" );
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$transport->close();
|
|
|
|
|
|
|
|
|
|
?>
|
|
|
|
|
</pre>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
|
