NAME

Thrift::API::HiveClient2 - Perl to HiveServer2 Thrift API wrapper

VERSION

version 0.004

METHODS

new

Initialize the client object with the Hive server parameters

    my $client = Thrift::API::HiveClient2->new(
        <host name or IP, defaults to localhost>,
        <port, defaults to 10000>,
    );

connect

Open the connection on the server declared in the object's constructor.

     $client->connect() or die "Failed to connect";

execute

Run an HiveQl statement on an open connection.

    my $rh = $client->execute( <HiveQL statement> );

fetch

Returns an array(ref) of arrayrefs, like DBI's fetchall_arrayref, and a boolean indicator telling wether or not a subsequent call to fetch() will return more rows.

    my ($rv, $has_more_rows) = $client->fetch( $rh, <maximum records to retrieve> );

WARNING

Thrift in Perl currently doesn't support SASL, so authentication needs to be disabled for now on HiveServer2 by setting this property in your /etc/hive/conf/hive-site.xml. Although the property is documented, this *value* -which disables the SASL server transport- is not, AFAICT.

  <property>
    <name>hive.server2.authentication</name>
    <value>NOSASL</value>
  </property>

AUTHOR

David Morel <david.morel@amakuru.net>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by David Morel & Booking.com. Portions are (c) R.Scaffidi, Thrift files are (c) Apache Software Foundation..

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004