presto-client-legacy 0.4.17

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 61184b98b159d0449f73cc8234c9f1e47ccb6c7f
+  data.tar.gz: 21fe7f9ce3eec82b868bf1505ba46fa3787bb65e
+SHA512:
+  metadata.gz: 3bec8f3656e5d37f61669c4877e3772bd93c3f8aa32b4a9fff6a708b1ef8ffc9e013c38ed91dbe71fe7a89ee82bf0ae1f02f1e0cc771cb4da5922458e46f2ba7
+  data.tar.gz: 4d52518e9ffe81b40b7167522c7222741cb90fca558e334c8df0aa1588e3ca4f305c031b26ef7fb14956eea2b9e5a4f9391d04b4a94d98bb26ca66ef6fe06fa8

data/.gitignore

@@ -0,0 +1,4 @@
+Gemfile.lock
+tmp/*
+pkg/*
+coverage/

data/.travis.yml

@@ -0,0 +1,13 @@
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.7
+  - 2.2.3
+  - ruby-head
+
+script: "bundle exec rake spec"
+
+sudo: false
+
+notifications:
+  webhooks: http://td-beda.herokuapp.com/travisci_callback

data/ChangeLog

@@ -0,0 +1,89 @@
+2016-08-09 version 0.4.17:
+
+* Added support for :ssl option.
+
+
+2016-08-03 version 0.4.16:
+
+* Upgraded Presto model version to 0.151
+
+
+2016-08-03 version 0.4.15:
+
+* decode method of model classes validate Hash type
+
+
+2016-08-02 version 0.4.14:
+
+* Added support for resuming fetching query results by using new `Query.resume(next_uri, options)` method (@tetrakai++)
+
+
+2016-08-02 version 0.4.13:
+
+* Added support for :http_proxy option to use a HTTP proxy server
+* Added support for hashed Client response using `run_with_names` (thanks to MoovWeb for allowing me to contribute)
+* Upgraded Presto model version to 0.134
+
+2015-04-01 version 0.4.5:
+
+* Upgraded Presto model version to 0.99
+
+
+2014-11-20 version 0.4.3:
+
+* Updated gem dependency to accept faraday ~> 0.9.x as well as ~> 0.8.8
+
+
+2014-10-15 version 0.4.2:
+
+* Added support for :properties option to set session properties introduced
+since Presto 0.78
+
+
+2014-06-12 version 0.4.1:
+
+* Added EquiJoinClause model class
+* Added StageId#query_id and #id methods
+* Added TaskId#query_id, #stage_id and #id methods
+
+
+2014-06-10 version 0.4.0:
+
+* Added Query#current_results, #advance and #query_info for advanced users
+* Generate model classes from Presto source code to include complete classes
+
+
+2014-05-06 version 0.3.3:
+
+* Added :time_zone and :language options added by Presto 0.66
+
+
+2014-04-01 version 0.3.2:
+
+* Fixed a problem that client skips the last chunk if result is large
+
+
+2014-01-30 version 0.3.1:
+
+* Added http_debug option
+* Disabled HTTP debug logging by default
+
+
+2014-01-22 version 0.3.0:
+
+* Added http_timeout option
+* Added http_open_timeout option
+* Changed Query.start API to start(query, options) to http options
+
+
+2014-01-22 version 0.2.0:
+
+* Added Query#cancel
+* Added Query#close
+* Added Client#run
+* Changed required_ruby_version from 1.9.3 to 1.9.1
+
+
+2014-01-07 version 0.1.0:
+
+* First release

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org/'
+gemspec

data/README.md

@@ -0,0 +1,86 @@
+# Presto client library for Ruby which support legacy presto (before 0.151)
+
+[![Build Status](https://travis-ci.org/treasure-data/presto-client-ruby.svg?branch=master)](https://travis-ci.org/treasure-data/presto-client-ruby)
+
+Presto is a distributed SQL query engine for big data:
+https://github.com/facebook/presto
+
+This is a client library for Ruby to run queries on Presto.
+
+## Example
+
+```ruby
+require 'presto-client'
+
+# create a client object:
+client = Presto::Client.new(
+  server: "localhost:8880",   # required option
+  ssl: {verify: false},
+  catalog: "native",
+  schema: "default",
+  user: "frsyuki",
+  time_zone: "US/Pacific",
+  language: "English",
+  properties: {
+    "hive.force_local_scheduling": true,
+    "raptor.reader_stream_buffer_size": "32MB"
+  },
+  http_proxy: "proxy.example.com:8080",
+  http_debug: true,
+)
+
+# run a query and get results as an array of arrays:
+columns, rows = client.run("select * from sys.node")
+rows.each {|row|
+  p row  # row is an array
+}
+
+# run a query and get results as an array of hashes:
+results = client.run_with_names("select alpha, 1 AS beta from tablename")
+results.each {|row|
+  p row['alpha']   # access by name
+  p row['beta']
+  p row.values[0]  # access by index
+  p row.values[1]
+}
+
+# run a query and fetch results streamingly:
+client.query("select * from sys.node") do |q|
+  # get columns:
+  q.columns.each {|column|
+    puts "column: #{column.name}.#{column.type}"
+  }
+
+  # get query results. it feeds more rows until
+  # query execution finishes:
+  q.each_row {|row|
+    p row  # row is an array
+  }
+end
+```
+
+## Options
+
+* **server** sets address (and port) of a Presto coordinator server.
+* **ssl** enables https.
+  * Setting `true` enables SSL and verifies server certificate using system's built-in certificates.
+  * Setting `{verify: false}` enables SSL but doesn't verify server certificate.
+  * Setting a Hash object enables SSL and verify server certificate with options:
+    * **ca_file**: path of a CA certification file in PEM format
+    * **ca_path**: path of a CA certification directory containing certifications in PEM format
+    * **cert_store**: a `OpenSSL::X509::Store` object used for verification
+    * **client_cert**: a `OpenSSL::X509::Certificate` object as client certificate
+    * **client_key**: a `OpenSSL::PKey::RSA` or `OpenSSL::PKey::DSA` object used for client certificate
+* **catalog** sets catalog (connector) name of Presto such as `hive-cdh4`, `hive-hadoop1`, etc.
+* **schema** sets default schema name of Presto. You need to use qualified name like `FROM myschema.table1` to use non-default schemas.
+* **source** sets source name to connect to a Presto. This name is shown on Presto web interface.
+* **user** sets user name to connect to a Presto.
+* **time_zone** sets time zone of queries. Time zone affects some functions such as `format_datetime`.
+* **language** sets language of queries. Language affects some functions such as `format_datetime`.
+* **properties** set session properties. Session properties affect internal behavior such as `hive.force_local_scheduling: true`, `raptor.reader_stream_buffer_size: "32MB"`, etc.
+* **http_proxy** sets host:port of a HTTP proxy server.
+* **http_debug** enables debug message to STDOUT for each HTTP requests.
+* **http_open_timeout** sets timeout in seconds to open new HTTP connection.
+* **http_timeout** sets timeout in seconds to read data from a server.
+
+See [RDoc](http://www.rubydoc.info/gems/presto-client/) for the full documentation.

data/Rakefile

@@ -0,0 +1,26 @@
+#!/usr/bin/env rake
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+require 'rake/clean'
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.fail_on_error = false
+end
+
+task :default => [:spec, :build]
+
+GEN_MODELS_VERSION = "0.134"
+
+task :modelgen do
+  unless Dir.exists?("presto-#{GEN_MODELS_VERSION}")
+    sh "curl -L -o presto-#{GEN_MODELS_VERSION}.tar.gz https://github.com/facebook/presto/archive/#{GEN_MODELS_VERSION}.tar.gz"
+    sh "tar zxvf presto-#{GEN_MODELS_VERSION}.tar.gz"
+  end
+
+  sh "#{RbConfig.ruby} modelgen/modelgen.rb presto-#{GEN_MODELS_VERSION} modelgen/models.rb lib/presto/client/models.rb"
+  puts "Generated lib/presto/client/models.rb."
+end
+

data/lib/presto/client/client.rb

@@ -0,0 +1,74 @@
+#
+# Presto client for Ruby
+#
+#    Licensed 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.
+#
+module PrestoLegacy::Client
+
+  require 'presto/client/models'
+  require 'presto/client/query'
+
+  class Client
+    def initialize(options)
+      @options = options
+    end
+
+    def query(query, &block)
+      q = Query.start(query, @options)
+      if block
+        begin
+          yield q
+        ensure
+          q.close
+        end
+      else
+        return q
+      end
+    end
+
+    def resume_query(next_uri)
+      return Query.resume(next_uri, @options)
+    end
+
+    def run(query)
+      q = Query.start(query, @options)
+      begin
+        columns = q.columns
+        if columns.empty?
+          return [], []
+        end
+        return columns, q.rows
+      ensure
+        q.close
+      end
+    end
+
+    # Accepts the raw response from the Presto Client and returns an
+    # array of hashes where you can access the data in each row using the
+    # output name specified in the query with AS:
+    #   SELECT expression AS output_name
+    def run_with_names(query)
+      columns, rows = run(query)
+
+      column_names = columns.map(&:name)
+
+      rows.map do |row|
+        Hash[column_names.zip(row)]
+      end
+    end
+  end
+
+  def self.new(*args)
+    Client.new(*args)
+  end
+end

data/lib/presto/client/errors.rb

@@ -0,0 +1,42 @@
+#
+# Presto client for Ruby
+#
+#    Licensed 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.
+#
+module PrestoLegacy::Client
+  class PrestoError < StandardError
+  end
+
+  class PrestoHttpError < PrestoError
+    def initialize(status, message)
+      super(message)
+      @status = status
+    end
+
+    attr_reader :status
+  end
+
+  class PrestoClientError < PrestoError
+  end
+
+  class PrestoQueryError < PrestoError
+    def initialize(message, query_id, error_code, failure_info)
+      super(message)
+      @query_id = query_id
+      @error_code = error_code
+      @failure_info = failure_info
+    end
+
+    attr_reader :error_code, :failure_info
+  end
+end