NAME
Thrift::API::HiveClient - A Hadoop Hive client using the Thrift API
VERSION
version 0.001
DESCRIPTION
THIS CODE IS ALPHA-QUALITY, EXPERIMENTAL, AND LIKELY FLAMMABLE
That said, I decided it would be nice to make it easy to connect to a Hadoop Hive server via its Thrift interface and that's what this module provides. It tries to keep the gory details from you and make things as simple as possible. The majority of the code in this dist was generated by the thrift compiler, but is hidden behind the friendly facade of the module whose documentation you are reading now. Enjoy, and please feel free to send bug reports and/or patches!
ATTRIBUTES
host
The host on which the hiveserver process is running. Should be a valid hostname or IP address. required, immutable
port
The TCP port on which the hiveserver process is listening. Should be a valid port number. required, immutable
METHODS
new( ... )
Standard object constructor. Arguments are the attributes described above. For example:
my $cli = Thrift::API::HiveClient->new( host => 'localhost', port => 10000 );connect( )
Connect to the configured hiveserver.
THRIFT API METHODS
These are the methods exposed by the Thrift API. The HiveClient object simply acts as a proxy for all the methods available on the (underlying) ThriftHiveClient object.
However, for your convenience, all these methods are documented here, as well as I can.
execute( $hql )
The given HQL statement is sent to the hiveserver and executed. The results can be retrieved by using the fetch* methods.
$cli->execute('select * from foo');fetchAll( )
All results from a previous call to execute() are returned as an array
my $res = $cli->fetchAll();getClusterStatus( )
Returns an object (blessed hash) showing some of the status of the Hadoop cluster.
get_fields( $db_name, $tbl_name );
Returns an array of FieldSchema objects with info about the fields in the given table in the given database.
my $tbl_schema = $cli->get_fields( 'default', 'foo' );EXTENDS
SUPPORT
Bugs / Feature Requests
Please report any bugs or feature requests by email to bug-thrift-api-hiveclient at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Thrift-API-HiveClient. You will be automatically notified of any progress on the request by the system.
Source Code
The code is open to the world, and available for you to hack on. Please feel free to browse it and play with it, or whatever. If you want to contribute patches, please send me a diff or prod me to pull from your repository :)
https://github.com/Hercynium/Thrift-API-HiveClient
git clone git://github.com/Hercynium/Thrift-API-HiveClient.gitAUTHOR
Stephen R. Scaffidi <sscaffidi@cpan.org>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2012 by Stephen R. Scaffidi.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004