gcloud 0.2.0 → 0.3.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MmIyMDI3NTljZjg4NGM3YzA2ODY0YmMwMmE5ZDUwOGJmM2I5MmZlMA==
+    ZDhjZWRiZTI5NTJjY2FhMmNlNGUzNmRjNTYwYWY0MzhiYmFjOWU2ZA==
   data.tar.gz: !binary |-
-    ZmY3ZTI0NmQ4MWIzMmYyZmZjY2ViYThkZDRlN2MxZjZiODUzNjhiNg==
+    MGE5MDc4NzkzOTQ2ZWE3NWE0ZDZhMWI5ZDc2M2M0NGNiOTFkMGFjYg==
 SHA512:
   metadata.gz: !binary |-
-    ODE0ZTZjNzI4M2I2MDhlMWYyNTNjYjVhMTIwNzc5NTI2ZmE4MmVlY2NiOGEw
-    YjZjMjlkODNjOWNmMWEwZDdlNmMyYWVkNTEzOTgyYzM2NDJiM2YyZWUyOGUy
-    NmFmYzEzMzQwYWUzNjc5N2Q0MWRhOWY0ZDIyNjEyYzRkMTU0ODg=
+    ODkwZjlhNTcxNTU5ZmQ0OWUzODUxNmY4MDQ1NzIyZTEyOWRiZGI0ZDNkMzc2
+    MDZjNTk0YTM2YzE5M2MzYjI3YTUzYjQ0YzI4YjM3YzUwMDQxYzg4NzdhNWI5
+    NDFkNzE1MDk1YmNkMmEyZTc4ZmNjNzM4NDQzNmVmYTY2ZjA2YzY=
   data.tar.gz: !binary |-
-    YzFmZGEzYTExZTI4Y2FjN2E4MmRlMjdmNjI5ZGE3Y2Q2Mjk2ZDUwYzcxOWNj
-    MDVmZDc1NTI5OWEwN2Y2M2RiYmJmYzJiZTQyNjU5MmY0NDFjZWJlNzM4MGZh
-    ZWMzZDkzMDhlMTkzYmU5ZGNkYzUwYmVkY2RlMTEwMWZlYmQ5NzA=
+    Y2FmNTFjMjhjMWJlNWI4NGQ4YmI4ZjQzYmJiYTU0ZGRhNzNmMTZiYjI3YTFk
+    NDI3YjdiNDZlOTE4M2FkOTlhMDViYWM4NmRkOGMzYmJhM2RjMTE0MjA2NjMz
+    NDA3NWM5N2ViMjk3NmE2ZGY1YzdkZDA0YzcwMjIwOGQxMTQ2ZDk=

data/AUTHENTICATION.md

@@ -45,14 +45,14 @@ The **Project ID** and **Credentials JSON** can be placed in environment variabl
 Here are the environment variables that Datastore checks for project ID:
 
 1. DATASTORE_PROJECT
-2. GOOGLE_CLOUD_PROJECT
+2. GCLOUD_PROJECT
 
 Here are the environment variables that Datastore checks for credentials:
 
 1. DATASTORE_KEYFILE - Path to JSON file
-2. GOOGLE_CLOUD_KEYFILE - Path to JSON file
+2. GCLOUD_KEYFILE - Path to JSON file
 3. DATASTORE_KEYFILE_JSON - JSON contents
-4. GOOGLE_CLOUD_KEYFILE_JSON - JSON contents
+4. GCLOUD_KEYFILE_JSON - JSON contents
 
 ### Cloud SDK
 

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 0.3.0 / 2015-08-21
+
+#### Major changes
+
+Add BigQuery service
+
+#### Minor changes
+
+* Improve error messaging when uploading files to Storage
+* Add `GCLOUD_PROJECT` and `GCLOUD_KEYFILE` environment variables
+* Specify OAuth 2.0 scopes when connecting to services
+
 ### 0.2.0 / 2015-07-22
 
 #### Major changes

data/OVERVIEW.md

@@ -8,6 +8,36 @@ $ gem install gcloud
 
 Gcloud aims to make authentication as simple as possible. Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. You can learn more about various options for connection on the [Authentication Guide](AUTHENTICATION.md).
 
+# BigQuery
+
+[Google Cloud BigQuery](https://cloud.google.com/bigquery/) ([docs](https://cloud.google.com/bigquery/docs)) enables super-fast, SQL-like queries against append-only tables, using the processing power of Google's infrastructure. Simply move your data into BigQuery and let it handle the hard work. You can control access to both the project and your data based on your business needs, such as giving others the ability to view or query your data.
+
+See the [gcloud-ruby BigQuery API documentation](rdoc-ref:Gcloud::Bigquery) to learn how to connect to Cloud BigQuery using this library.
+
+```ruby
+require "gcloud"
+
+gcloud = Gcloud.new
+bigquery = gcloud.bigquery
+
+# Create a new table to archive todos
+dataset = bigquery.dataset "my-todo-archive"
+table = dataset.create_table "todos",
+          name: "Todos Archive",
+          description: "Archive for completed TODO records"
+
+# Load data into the table
+file = File.open "/archive/todos/completed-todos.csv"
+load_job = table.load file
+
+# Run a query for the number of completed todos by owner
+count_sql = "SELECT owner, COUNT(*) AS complete_count FROM todos GROUP BY owner"
+data = bigquery.query count_sql
+data.each do |row|
+  puts row["name"]
+end
+```
+
 # Datastore
 
 [Google Cloud Datastore](https://cloud.google.com/datastore/) ([docs](https://cloud.google.com/datastore/docs)) is a fully managed, schemaless database for storing non-relational data. Cloud Datastore automatically scales with your users and supports ACID transactions, high availability of reads and writes, strong consistency for reads and ancestor queries, and eventual consistency for all other queries.

data/lib/gcloud.rb

@@ -70,11 +70,26 @@ module Gcloud
   # Creates a new object for connecting to the Datastore service.
   # Each call creates a new connection.
   #
+  # === Parameters
+  #
+  # +options+::
+  #   An optional Hash for controlling additional behavior. (+Hash+)
+  # <code>options[:scope]</code>::
+  #   The OAuth 2.0 scopes controlling the set of resources and operations that
+  #   the connection can access. See {Using OAuth 2.0 to Access Google
+  #   APIs}[https://developers.google.com/identity/protocols/OAuth2]. (+String+
+  #   or +Array+)
+  #
+  #   The default scopes are:
+  #
+  #   * +https://www.googleapis.com/auth/datastore+
+  #   * +https://www.googleapis.com/auth/userinfo.email+
+  #
   # === Returns
   #
   # Gcloud::Datastore::Dataset
   #
-  # === Example
+  # === Examples
   #
   #   require "gcloud"
   #
@@ -88,20 +103,43 @@ module Gcloud
   #
   #   dataset.save entity
   #
-  def datastore
+  # You shouldn't need to override the default scope, but it is possible to do
+  # so with the +scope+ option:
+  #
+  #   require "gcloud"
+  #
+  #   gcloud  = Gcloud.new
+  #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
+  #   dataset = gcloud.datastore scope: platform_scope
+  #
+  def datastore options = {}
     require "gcloud/datastore"
-    Gcloud.datastore @project, @keyfile
+    Gcloud.datastore @project, @keyfile, options
   end
 
   ##
   # Creates a new object for connecting to the Storage service.
   # Each call creates a new connection.
   #
+  # === Parameters
+  #
+  # +options+::
+  #   An optional Hash for controlling additional behavior. (+Hash+)
+  # <code>options[:scope]</code>::
+  #   The OAuth 2.0 scopes controlling the set of resources and operations that
+  #   the connection can access. See {Using OAuth 2.0 to Access Google
+  #   APIs}[https://developers.google.com/identity/protocols/OAuth2]. (+String+
+  #   or +Array+)
+  #
+  #   The default scope is:
+  #
+  #   * +https://www.googleapis.com/auth/devstorage.full_control+
+  #
   # === Returns
   #
   # Gcloud::Storage::Project
   #
-  # === Example
+  # === Examples
   #
   #   require "gcloud"
   #
@@ -110,20 +148,44 @@ module Gcloud
   #   bucket = storage.bucket "my-bucket"
   #   file = bucket.file "path/to/my-file.ext"
   #
-  def storage
+  # The default scope can be overridden with the +scope+ option. For more
+  # information see {Storage OAuth 2.0
+  # Authentication}[https://cloud.google.com/storage/docs/authentication#oauth].
+  #
+  #   require "gcloud"
+  #
+  #   gcloud  = Gcloud.new
+  #   readonly_scope = "https://www.googleapis.com/auth/devstorage.read_only"
+  #   readonly_storage = gcloud.storage scope: readonly_scope
+  #
+  def storage options = {}
     require "gcloud/storage"
-    Gcloud.storage @project, @keyfile
+    Gcloud.storage @project, @keyfile, options
   end
 
   ##
   # Creates a new object for connecting to the Pub/Sub service.
   # Each call creates a new connection.
   #
+  # === Parameters
+  #
+  # +options+::
+  #   An optional Hash for controlling additional behavior. (+Hash+)
+  # <code>options[:scope]</code>::
+  #   The OAuth 2.0 scopes controlling the set of resources and operations that
+  #   the connection can access. See {Using OAuth 2.0 to Access Google
+  #   APIs}[https://developers.google.com/identity/protocols/OAuth2]. (+String+
+  #   or +Array+)
+  #
+  #   The default scope is:
+  #
+  #   * +https://www.googleapis.com/auth/pubsub+
+  #
   # === Returns
   #
   # Gcloud::Pubsub::Project
   #
-  # === Example
+  # === Examples
   #
   #   require "gcloud"
   #
@@ -132,9 +194,64 @@ module Gcloud
   #   topic = pubsub.topic "my-topic"
   #   topic.publish "task completed"
   #
-  def pubsub
+  # The default scope can be overridden with the +scope+ option:
+  #
+  #   require "gcloud"
+  #
+  #   gcloud  = Gcloud.new
+  #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
+  #   pubsub = gcloud.pubsub scope: platform_scope
+  #
+  def pubsub options = {}
     require "gcloud/pubsub"
-    Gcloud.pubsub @project, @keyfile
+    Gcloud.pubsub @project, @keyfile, options
+  end
+
+  ##
+  # Creates a new object for connecting to the BigQuery service.
+  # Each call creates a new connection.
+  #
+  # === Parameters
+  #
+  # +options+::
+  #   An optional Hash for controlling additional behavior. (+Hash+)
+  # <code>options[:scope]</code>::
+  #   The OAuth 2.0 scopes controlling the set of resources and operations that
+  #   the connection can access. See {Using OAuth 2.0 to Access Google
+  #   APIs}[https://developers.google.com/identity/protocols/OAuth2]. (+String+
+  #   or +Array+)
+  #
+  #   The default scope is:
+  #
+  #   * +https://www.googleapis.com/auth/bigquery+
+  #
+  # === Returns
+  #
+  # Gcloud::Bigquery::Project
+  #
+  # === Examples
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.dataset "my-dataset"
+  #   table = dataset.table "my-table"
+  #   table.data.each do |row|
+  #     puts row
+  #   end
+  #
+  # The default scope can be overridden with the +scope+ option:
+  #
+  #   require "gcloud"
+  #
+  #   gcloud  = Gcloud.new
+  #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
+  #   bigquery = gcloud.bigquery scope: platform_scope
+  #
+  def bigquery options = {}
+    require "gcloud/bigquery"
+    Gcloud.bigquery @project, @keyfile, options
   end
 
   ##

data/lib/gcloud/bigquery.rb

@@ -0,0 +1,399 @@
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# 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.
+
+require "gcloud"
+require "gcloud/bigquery/project"
+
+#--
+# Google Cloud BigQuery
+module Gcloud
+  ##
+  # Creates a new +Project+ instance connected to the BigQuery service.
+  # Each call creates a new connection.
+  #
+  # === Parameters
+  #
+  # +project+::
+  #   Identifier for a BigQuery project. If not present, the default project for
+  #   the credentials is used. (+String+)
+  # +keyfile+::
+  #   Keyfile downloaded from Google Cloud. If file path the file must be
+  #   readable. (+String+ or +Hash+)
+  # +options+::
+  #   An optional Hash for controlling additional behavior. (+Hash+)
+  # <code>options[:scope]</code>::
+  #   The OAuth 2.0 scopes controlling the set of resources and operations that
+  #   the connection can access. See {Using OAuth 2.0 to Access Google
+  #   APIs}[https://developers.google.com/identity/protocols/OAuth2]. (+String+
+  #   or +Array+)
+  #
+  #   The default scope is:
+  #
+  #   * +https://www.googleapis.com/auth/bigquery+
+  #
+  # === Returns
+  #
+  # Gcloud::Bigquery::Project
+  #
+  # === Example
+  #
+  #   require "gcloud/bigquery"
+  #
+  #   bigquery = Gcloud.bigquery
+  #   dataset = bigquery.dataset "my_dataset"
+  #   table = dataset.table "my_table"
+  #
+  def self.bigquery project = nil, keyfile = nil, options = {}
+    project ||= Gcloud::Bigquery::Project.default_project
+    if keyfile.nil?
+      credentials = Gcloud::Bigquery::Credentials.default options
+    else
+      credentials = Gcloud::Bigquery::Credentials.new keyfile, options
+    end
+    Gcloud::Bigquery::Project.new project, credentials
+  end
+
+  ##
+  # = Google Cloud BigQuery
+  #
+  # Google Cloud BigQuery enables super-fast, SQL-like queries against massive
+  # datasets, using the processing power of Google's infrastructure. To learn
+  # more, read {What is
+  # BigQuery?}[https://cloud.google.com/bigquery/what-is-bigquery].
+  #
+  # Gcloud's goal is to provide an API that is familiar and comfortable to
+  # Rubyists. Authentication is handled by Gcloud#bigquery. You can provide
+  # the project and credential information to connect to the BigQuery service,
+  # or if you are running on Google Compute Engine this configuration is taken
+  # care of for you. You can read more about the options for connecting in the
+  # {Authentication Guide}[link:AUTHENTICATION.md].
+  #
+  # To help you get started quickly, the first few examples below use a public
+  # dataset provided by Google. As soon as you have {signed
+  # up}[https://cloud.google.com/bigquery/sign-up] to use BigQuery, and provided
+  # that you stay in the free tier for queries, you should be able to run these
+  # first examples without the need to set up billing or to load data (although
+  # we'll show you how to do that too.)
+  #
+  # == Listing Datasets and Tables
+  #
+  # A BigQuery project holds datasets, which in turn hold tables. Assuming that
+  # you have not yet created datasets or tables in your own project, let's
+  # connect to Google's +publicdata+ project, and see what you find.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new "publicdata"
+  #   bigquery = gcloud.bigquery
+  #
+  #   bigquery.datasets.count #=> 1
+  #   bigquery.datasets.first.dataset_id #=> "samples"
+  #
+  #   dataset = bigquery.datasets.first
+  #   tables = dataset.tables
+  #
+  #   tables.count #=> 7
+  #   tables.map &:table_id #=> [..., "shakespeare", "trigrams", "wikipedia"]
+  #
+  # In addition listing all datasets and tables in the project, you can also
+  # retrieve individual datasets and tables by ID. Let's look at the structure
+  # of the +shakespeare+ table, which contains an entry for every word in every
+  # play written by Shakespeare.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new "publicdata"
+  #   bigquery = gcloud.bigquery
+  #
+  #   dataset = bigquery.dataset "samples"
+  #   table = dataset.table "shakespeare"
+  #
+  #   table.headers #=> ["word", "word_count", "corpus", "corpus_date"]
+  #   table.rows_count #=> 164656
+  #
+  # Now that you know the column names for the Shakespeare table, you can write
+  # and run a query.
+  #
+  # == Running queries
+  #
+  # BigQuery offers both synchronous and asynchronous methods, as explained in
+  # {Querying Data}[https://cloud.google.com/bigquery/querying-data].
+  #
+  # === Synchronous queries
+  #
+  # Let's start with the simpler synchronous approach. Notice that this time you
+  # are connecting using your own default project. This is necessary for running
+  # a query, since queries need to be able to create tables to hold results.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #
+  #   sql = "SELECT TOP(word, 50) as word, COUNT(*) as count " +
+  #         "FROM publicdata:samples.shakespeare"
+  #   data = bigquery.query sql
+  #
+  #   data.count #=> 50
+  #   data.next? #=> false
+  #   data.first #=> {"word"=>"you", "count"=>42}
+  #
+  # The +TOP+ function shown above is just one of a variety of functions
+  # offered by BigQuery. See the {Query
+  # Reference}[https://cloud.google.com/bigquery/query-reference] for a full
+  # listing.
+  #
+  # === Asynchronous queries
+  #
+  # Because you probably should not block for most BigQuery operations,
+  # including querying as well as importing, exporting, and copying data, the
+  # BigQuery API enables you to manage longer-running jobs. In the asynchronous
+  # approach to running a query, an instance of Gcloud::Bigquery::QueryJob is
+  # returned, rather than an instance of Gcloud::Bigquery::QueryData.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #
+  #   sql = "SELECT TOP(word, 50) as word, COUNT(*) as count " +
+  #         "FROM publicdata:samples.shakespeare"
+  #   job = bigquery.query_job sql
+  #
+  #   loop do
+  #     break if job.done?
+  #     sleep 1
+  #     job.refresh!
+  #   end
+  #   if !job.failed?
+  #     job.query_results.each do |row|
+  #       puts row["word"]
+  #     end
+  #   end
+  #
+  # Once you have determined that the job is done and has not failed, you can
+  # obtain an instance of Gcloud::Bigquery::QueryData by calling
+  # Gcloud::Bigquery::QueryJob#query_results. The query results for both of
+  # the above examples are stored in temporary tables with a lifetime of about
+  # 24 hours. See the final example below for a demonstration of how to store
+  # query results in a permanent table.
+  #
+  # == Creating Datasets and Tables
+  #
+  # The first thing you need to do in a new BigQuery project is to create a
+  # Gcloud::Bigquery::Dataset. Datasets hold tables and control access to them.
+  #
+  #   require "gcloud/bigquery"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.create_dataset "my_dataset"
+  #
+  # Now that you have a dataset, you can use it to create a table. Every table
+  # is defined by a schema that may contain nested and repeated fields. The
+  # example below shows a schema with a repeated record field named
+  # +cities_lived+. (For more information about nested and repeated fields, see
+  # {Preparing Data for
+  # BigQuery}[https://cloud.google.com/bigquery/preparing-data-for-bigquery].)
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.dataset "my_dataset"
+  #
+  #   schema = {
+  #     "fields" => [
+  #       {
+  #         "name" => "first_name",
+  #         "type" => "STRING",
+  #         "mode" => "REQUIRED"
+  #       },
+  #       {
+  #         "name" => "cities_lived",
+  #         "type" => "RECORD",
+  #         "mode" => "REPEATED",
+  #         "fields" => [
+  #           {
+  #             "name" => "place",
+  #             "type" => "STRING",
+  #             "mode" => "REQUIRED"
+  #           },
+  #           {
+  #             "name" => "number_of_years",
+  #             "type" => "INTEGER",
+  #             "mode" => "REQUIRED"
+  #           }
+  #         ]
+  #       }
+  #     ]
+  #   }
+  #   table = dataset.create_table "people", schema: schema
+  #
+  # Because of the repeated field in this schema, we cannot use the CSV format
+  # to load data into the table.
+  #
+  # == Loading records
+  #
+  # In addition to CSV, data can be imported from files that are formatted as
+  # {Newline-delimited JSON}[http://jsonlines.org/] or
+  # {Avro}[http://avro.apache.org/], or from a Google Cloud Datastore backup. It
+  # can also be "streamed" into BigQuery.
+  #
+  # To follow along with these examples, you will need to set up billing on the
+  # {Google Developers Console}[https://console.developers.google.com].
+  #
+  # === Streaming records
+  #
+  # For situations in which you want new data to be available for querying as
+  # soon as possible, inserting individual records directly from your Ruby
+  # application is a great approach.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.dataset "my_dataset"
+  #   table = dataset.table "people"
+  #
+  #   rows = [
+  #       {
+  #           "first_name" => "Anna",
+  #           "cities_lived" => [
+  #               {
+  #                   "place" => "Stockholm",
+  #                   "number_of_years" => 2
+  #               }
+  #           ]
+  #       },
+  #       {
+  #           "first_name" => "Bob",
+  #           "cities_lived" => [
+  #               {
+  #                   "place" => "Seattle",
+  #                   "number_of_years" => 5
+  #               },
+  #               {
+  #                   "place" => "Austin",
+  #                   "number_of_years" => 6
+  #               }
+  #           ]
+  #       }
+  #   ]
+  #   table.insert rows
+  #
+  # There are some trade-offs involved with streaming, so be sure to read the
+  # discussion of data consistency in {Streaming Data Into
+  # BigQuery}[https://cloud.google.com/bigquery/streaming-data-into-bigquery].
+  #
+  # === Uploading a file
+  #
+  # To follow along with this example, please download the
+  # {names.zip}[http://www.ssa.gov/OACT/babynames/names.zip] archive from the
+  # U.S. Social Security Administration. Inside the archive you will find over
+  # 100 files containing baby name records since the year 1880. A PDF file also
+  # contained in the archive specifies the schema used below.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.dataset "my_dataset"
+  #   schema = {
+  #     "fields" => [
+  #       {
+  #         "name" => "name",
+  #         "type" => "STRING",
+  #         "mode" => "REQUIRED"
+  #       },
+  #       {
+  #         "name" => "sex",
+  #         "type" => "STRING",
+  #         "mode" => "REQUIRED"
+  #       },
+  #       {
+  #         "name" => "number",
+  #         "type" => "INTEGER",
+  #         "mode" => "REQUIRED"
+  #       }
+  #     ]
+  #   }
+  #   table = dataset.create_table "baby_names", schema: schema
+  #
+  #   file = File.open "names/yob2014.txt"
+  #   load_job = table.load file, format: "csv"
+  #
+  # Because the names data, although formatted as CSV, is distributed in files
+  # with a +.txt+ extension, this example explicitly passes the +format+ option
+  # in order to demonstrate how to handle such situations. Because CSV is the
+  # default format for load operations, the option is not actually necessary.
+  # For JSON saved with a +.txt+ extension, however, it would be.
+  #
+  # == Exporting query results to Google Cloud Storage
+  #
+  # The example below shows how to pass the +table+ option with a query in order
+  # to store results in a permanent table. It also shows how to export the
+  # result data to a Google Cloud Storage file. In order to follow along, you
+  # will need to enable the Google Cloud Storage API in addition to setting up
+  # billing.
+  #
+  #   require "gcloud"
+  #
+  #   gcloud = Gcloud.new
+  #   bigquery = gcloud.bigquery
+  #   dataset = bigquery.dataset "my_dataset"
+  #   source_table = dataset.table "baby_names"
+  #   result_table = dataset.create_table "baby_names_results"
+  #
+  #   sql = "SELECT name, number as count " +
+  #         "FROM baby_names " +
+  #         "WHERE name CONTAINS 'Sam' " +
+  #         "ORDER BY count DESC"
+  #   query_job = dataset.query_job sql, table: result_table
+  #
+  #   loop do
+  #     break if query_job.done?
+  #     sleep 1
+  #     query_job.refresh!
+  #   end
+  #
+  #   if !query_job.failed?
+  #
+  #     storage = gcloud.storage
+  #     bucket_id = "bigquery-exports-#{SecureRandom.uuid}"
+  #     bucket = storage.create_bucket bucket_id
+  #     extract_url = "gs://#{bucket.id}/baby-names-sam.csv"
+  #
+  #     extract_job = result_table.extract extract_url
+  #
+  #     loop do
+  #       break if extract_job.done?
+  #       sleep 1
+  #       extract_job.refresh!
+  #     end
+  #
+  #     # Download to local filesystem
+  #     bucket.files.first.download "baby-names-sam.csv"
+  #
+  #   end
+  #
+  # If a table you wish to export contains a large amount of data, you can pass
+  # a wildcard URI to export to multiple files (for sharding), or an array of
+  # URIs (for partitioning), or both. See {Exporting Data From
+  # BigQuery}[https://cloud.google.com/bigquery/exporting-data-from-bigquery]
+  # for details.
+  #
+  module Bigquery
+  end
+end