google-cloud-bigquery 1.7.1 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32f691494c8aaa565e04ee53308469e74c98267914ccca0576668a30cdceb76d
-  data.tar.gz: d48d4a8c916a5415fe0cc7f66b510ff7805a34931f15439be08ea4b81a9af90b
+  metadata.gz: 6ecc40c252508d7433540e93257afe130072806aa75ec6c5feb02499d0a10913
+  data.tar.gz: 3e2caa63acd11cbcddf71bf4992c80535fd13e7bfd355a4e38e829684128f095
 SHA512:
-  metadata.gz: ca6a72158aba473a1c088eec6939aae9361bda601aa1866996930e73ec68061ae1afc5ca4d7f22c6f4fc19ac6f6d511b0286e8e0d2eaa5b91dd0e15e86f16c8b
-  data.tar.gz: a69869fd41465d6b1c2e88a3e288e5a73b6ad71485d2e77ec1946547852193f0199d2a012fc65c8a8bc724d7a19d8f42debfa710e743fbcdaa5df41f3009be50
+  metadata.gz: 256c2c11f97bd389faf49423bbab4b03a3f46e97be055ad47ed7bd9cd1b430966b9f3c5d6651f75ea2af80f16a89e22d6caf796cef61bcee97a9ad9a0ac9633e
+  data.tar.gz: c1f2ad9a2d8b2f977330d37ceed965df8e2e0e0681072abd0e2fb700dc7f5f9333518a6899793c209b804c5d069d33e77f1e24669a966bf0d35234cfb3c7047b

data/.yardopts

@@ -2,7 +2,15 @@
 --title=Google Cloud BigQuery
 --markup markdown
 --markup-provider redcarpet
+--main OVERVIEW.md
 
 ./lib/**/*.rb
 -
-README.md
+OVERVIEW.md
+AUTHENTICATION.md
+LOGGING.md
+CONTRIBUTING.md
+TROUBLESHOOTING.md
+CHANGELOG.md
+CODE_OF_CONDUCT.md
+LICENSE

data/README.md

@@ -2,7 +2,7 @@
 
 [Google 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.
 
-- [google-cloud-bigquery API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-bigquery/latest)
+- [google-cloud-bigquery API documentation](http://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest)
 - [google-cloud-bigquery on RubyGems](https://rubygems.org/gems/google-cloud-bigquery)
 - [Google BigQuery documentation](https://cloud.google.com/bigquery/docs)
 
@@ -16,7 +16,7 @@ $ gem install google-cloud-bigquery
 
 This library uses Service Account credentials to connect to Google Cloud services. When running on Compute Engine the credentials will be discovered automatically. When running on other environments the Service Account credentials can be specified by providing the path to the JSON file, or the JSON itself, in environment variables.
 
-Instructions and configuration options are covered in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-bigquery/guides/authentication).
+Instructions and configuration options are covered in the [Authentication Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest/file.AUTHENTICATION).
 
 ## Example
 
@@ -49,7 +49,7 @@ end
 
 ## Enabling Logging
 
-To enable logging for this library, set the logger for the underlying [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.4.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/).
+To enable logging for this library, set the logger for the underlying [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging) library. The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.4.0/libdoc/logger/rdoc/Logger.html) as shown below, or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-logging/latest/Google/Cloud/Logging/Logger) that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/).
 
 If you do not set the logger explicitly and your application is running in a Rails environment, it will default to `Rails.logger`. Otherwise, if you do not set the logger and you are not using Rails, logging is disabled by default.
 
@@ -70,9 +70,9 @@ Google::Apis.logger = my_logger
 This library is supported on Ruby 2.3+.
 
 Google provides official support for Ruby versions that are actively supported
-by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.3
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
+by Ruby Core—that is, Ruby versions that are either in normal maintenance or in
+security maintenance, and not end of life. Currently, this means Ruby 2.3 and
+later. Older versions of Ruby _may_ still work, but are unsupported and not
 recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
 about the Ruby support schedule.
 
@@ -80,21 +80,33 @@ about the Ruby support schedule.
 
 This library follows [Semantic Versioning](http://semver.org/).
 
-It is currently in major version zero (0.y.z), which means that anything may change at any time and the public API should not be considered stable.
+It is currently in major version zero (0.y.z), which means that anything may
+change at any time and the public API should not be considered stable.
 
 ## Contributing
 
 Contributions to this library are always welcome and highly encouraged.
 
-See the [Contributing Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/contributing) for more information on how to get started.
+See the [Contributing
+Guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest/file.CONTRIBUTING)
+for more information on how to get started.
 
-Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct](../CODE_OF_CONDUCT.md) for more information.
+Please note that this project is released with a Contributor Code of Conduct. By
+participating in this project you agree to abide by its terms. See [Code of
+Conduct](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest/file.CODE_OF_CONDUCT)
+for more information.
 
 ## License
 
-This library is licensed under Apache 2.0. Full license text is available in [LICENSE](LICENSE).
+This library is licensed under Apache 2.0. Full license text is available in
+[LICENSE](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest/file.LICENSE).
 
 ## Support
 
-Please [report bugs at the project on Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues).
-Don't hesitate to [ask questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby) about the client or APIs on [StackOverflow](http://stackoverflow.com).
+Please [report bugs at the project on
+Github](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues). Don't
+hesitate to [ask
+questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
+about the client or APIs on [StackOverflow](http://stackoverflow.com). For more
+see the [Troubleshooting
+guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/google-cloud-bigquery/latest/file.TROUBLESHOOTING)

data/lib/google-cloud-bigquery.rb

@@ -29,8 +29,8 @@ module Google
     # Creates a new object for connecting to the BigQuery service.
     # Each call creates a new connection.
     #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling the
     #   set of resources and operations that the connection can access. See
@@ -74,8 +74,8 @@ module Google
     # Creates a new `Project` instance connected to the BigQuery service.
     # Each call creates a new connection.
     #
-    # For more information on connecting to Google Cloud see the [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+    # For more information on connecting to Google Cloud see the
+    # {file:AUTHENTICATION.md Authentication Guide}.
     #
     # @param [String] project_id Identifier for a BigQuery project. If not
     #   present, the default project for the credentials is used.

data/lib/google/cloud/bigquery.rb

@@ -24,503 +24,16 @@ module Google
     # # Google Cloud BigQuery
     #
     # Google 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).
+    # datasets, using the processing power of Google's infrastructure.
     #
-    # The goal of google-cloud is to provide an API that is comfortable to
-    # Rubyists. Your authentication credentials are detected automatically in
-    # Google Cloud Platform environments such as Google Compute Engine, Google
-    # App Engine and Google Kubernetes Engine. In other environments you can
-    # configure authentication easily, either directly in your code or via
-    # environment variables. Read more about the options for connecting in the
-    # [Authentication
-    # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
-    #
-    # 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.)
-    #
-    # ## Enabling Logging
-    #
-    # To enable logging for this library, set the logger for the underlying
-    # [Google API Client](https://github.com/google/google-api-ruby-client/blob/master/README.md#logging)
-    # library. The logger that you set may be a Ruby stdlib
-    # [`Logger`](https://ruby-doc.org/stdlib-2.4.0/libdoc/logger/rdoc/Logger.html)
-    # as shown below, or a
-    # [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
-    # that will write logs to [Stackdriver
-    # Logging](https://cloud.google.com/logging/).
-    #
-    # If you do not set the logger explicitly and your application is running in
-    # a Rails environment, it will default to `Rails.logger`. Otherwise, if you
-    # do not set the logger and you are not using Rails, logging is disabled by
-    # default.
-    #
-    # Configuring a Ruby stdlib logger:
-    #
-    # ```ruby
-    # require "logger"
-    #
-    # my_logger = Logger.new $stderr
-    # my_logger.level = Logger::WARN
-    #
-    # # Set the Google API Client logger
-    # Google::Apis.logger = my_logger
-    # ```
-    #
-    # ## Listing Datasets and Tables
-    #
-    # A BigQuery project contains datasets, which in turn contain tables.
-    # Assuming that you have not yet created datasets or tables in your own
-    # project, let's connect to Google's `bigquery-public-data` project, and see
-    # what we find.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new project: "bigquery-public-data"
-    #
-    # 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 to 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.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new project: "bigquery-public-data"
-    #
-    # 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, let's
-    # write and run a few queries against it.
-    #
-    # ## Running queries
-    #
-    # BigQuery supports two SQL dialects: [standard
-    # SQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/)
-    # and the older [legacy SQl (BigQuery
-    # SQL)](https://cloud.google.com/bigquery/docs/reference/legacy-sql),
-    # as discussed in the guide [Migrating from legacy
-    # SQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/migrating-from-legacy-sql).
-    #
-    # ### Standard SQL
-    #
-    # Standard SQL is the preferred SQL dialect for querying data stored in
-    # BigQuery. It is compliant with the SQL 2011 standard, and has extensions
-    # that support querying nested and repeated data. This is the default
-    # syntax. It has several advantages over legacy SQL, including:
-    #
-    # * Composability using `WITH` clauses and SQL functions
-    # * Subqueries in the `SELECT` list and `WHERE` clause
-    # * Correlated subqueries
-    # * `ARRAY` and `STRUCT` data types
-    # * Inserts, updates, and deletes
-    # * `COUNT(DISTINCT <expr>)` is exact and scalable, providing the accuracy
-    #   of `EXACT_COUNT_DISTINCT` without its limitations
-    # * Automatic predicate push-down through `JOIN`s
-    # * Complex `JOIN` predicates, including arbitrary expressions
-    #
-    # For examples that demonstrate some of these features, see [Standard SQL
-    # highlights](https://cloud.google.com/bigquery/docs/reference/standard-sql/migrating-from-legacy-sql#standard_sql_highlights).
-    #
-    # As shown in this example, standard SQL is the library default:
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # sql = "SELECT word, SUM(word_count) AS word_count " \
-    #       "FROM `bigquery-public-data.samples.shakespeare`" \
-    #       "WHERE word IN ('me', 'I', 'you') GROUP BY word"
-    # data = bigquery.query sql
-    # ```
-    #
-    # Notice that in standard SQL, a fully-qualified table name uses the
-    # following format: <code>`my-dashed-project.dataset1.tableName`</code>.
-    #
-    # ### Legacy SQL (formerly BigQuery SQL)
-    #
-    # Before version 2.0, BigQuery executed queries using a non-standard SQL
-    # dialect known as BigQuery SQL. This variant is optional, and can be
-    # enabled by passing the flag `legacy_sql: true` with your query. (If you
-    # get an SQL syntax error with a query that may be written in legacy SQL,
-    # be sure that you are passing this option.)
-    #
-    # To use legacy SQL, pass the option `legacy_sql: true` with your query:
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # sql = "SELECT TOP(word, 50) as word, COUNT(*) as count " \
-    #       "FROM [bigquery-public-data:samples.shakespeare]"
-    # data = bigquery.query sql, legacy_sql: true
-    # ```
-    #
-    # Notice that in legacy SQL, a fully-qualified table name uses brackets
-    # instead of back-ticks, and a colon instead of a dot to separate the
-    # project and the dataset: `[my-dashed-project:dataset1.tableName]`.
-    #
-    # #### Query parameters
-    #
-    # With standard SQL, you can use positional or named query parameters. This
-    # example shows the use of named parameters:
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # sql = "SELECT word, SUM(word_count) AS word_count " \
-    #       "FROM `bigquery-public-data.samples.shakespeare`" \
-    #       "WHERE word IN UNNEST(@words) GROUP BY word"
-    # data = bigquery.query sql, params: { words: ['me', 'I', 'you'] }
-    # ```
-    #
-    # As demonstrated above, passing the `params` option will automatically set
-    # `standard_sql` to `true`.
-    #
-    # #### Data types
-    #
-    # BigQuery standard SQL supports simple data types such as integers, as well
-    # as more complex types such as `ARRAY` and `STRUCT`.
-    #
-    # The BigQuery data types are converted to and from Ruby types as follows:
-    #
-    # | BigQuery    | Ruby           | Notes  |
-    # |-------------|----------------|---|
-    # | `BOOL`      | `true`/`false` | |
-    # | `INT64`     | `Integer`      | |
-    # | `FLOAT64`   | `Float`        | |
-    # | `NUMERIC`   | `BigDecimal`   | Will be rounded to 9 decimal places |
-    # | `STRING`    | `String`       | |
-    # | `DATETIME`  | `DateTime`     | `DATETIME` does not support time zone. |
-    # | `DATE`      | `Date`         | |
-    # | `TIMESTAMP` | `Time`         | |
-    # | `TIME`      | `Google::Cloud::BigQuery::Time` | |
-    # | `BYTES`     | `File`, `IO`, `StringIO`, or similar | |
-    # | `ARRAY`  | `Array` | Nested arrays and `nil` values are not supported. |
-    # | `STRUCT`    | `Hash`         | Hash keys may be strings or symbols. |
-    #
-    # See [Data Types](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types)
-    # for an overview of each BigQuery data type, including allowed values.
-    #
-    # ### Running Queries
-    #
-    # Let's start with the simplest way to run a query. Notice that this time
-    # you are connecting using your own default project. It is necessary to have
-    # write access to the project for running a query, since queries need to
-    # create tables to hold results.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # sql = "SELECT APPROX_TOP_COUNT(corpus, 10) as title, " \
-    #       "COUNT(*) as unique_words " \
-    #       "FROM `bigquery-public-data.samples.shakespeare`"
-    # data = bigquery.query sql
-    #
-    # data.next? #=> false
-    # data.first #=> {:title=>[{:value=>"hamlet", :count=>5318}, ...}
-    # ```
-    #
-    # The `APPROX_TOP_COUNT` function shown above is just one of a variety of
-    # functions offered by BigQuery. See the [Query Reference (standard
-    # SQL)](https://cloud.google.com/bigquery/docs/reference/standard-sql/functions-and-operators)
-    # for a full listing.
-    #
-    # ### Query Jobs
-    #
-    # It is usually best not to block for most BigQuery operations, including
-    # querying as well as importing, exporting, and copying data. Therefore, the
-    # BigQuery API provides facilities for managing longer-running jobs. With
-    # this approach, an instance of {Google::Cloud::Bigquery::QueryJob} is
-    # returned, rather than an instance of {Google::Cloud::Bigquery::Data}.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # sql = "SELECT APPROX_TOP_COUNT(corpus, 10) as title, " \
-    #       "COUNT(*) as unique_words " \
-    #       "FROM `bigquery-public-data.samples.shakespeare`"
-    # job = bigquery.query_job sql
-    #
-    # job.wait_until_done!
-    # if !job.failed?
-    #   job.data.first
-    #   #=> {:title=>[{:value=>"hamlet", :count=>5318}, ...}
-    # end
-    # ```
-    #
-    # Once you have determined that the job is done and has not failed, you can
-    # obtain an instance of {Google::Cloud::Bigquery::Data} by calling `data` on
-    # the job instance. 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
-    # {Google::Cloud::Bigquery::Dataset}. Datasets hold tables and control
-    # access to them.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    #
-    # 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
-    # Loading](https://cloud.google.com/bigquery/preparing-data-for-loading).)
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    # dataset = bigquery.dataset "my_dataset"
-    #
-    # table = dataset.create_table "people" do |schema|
-    #   schema.string "first_name", mode: :required
-    #   schema.record "cities_lived", mode: :repeated do |nested_schema|
-    #     nested_schema.string "place", mode: :required
-    #     nested_schema.integer "number_of_years", mode: :required
-    #   end
-    # end
-    # ```
-    #
-    # Because of the repeated field in this schema, we cannot use the CSV format
-    # to load data into the table.
-    #
-    # ## Loading records
-    #
-    # To follow along with these examples, you will need to set up billing on
-    # the [Google Developers Console](https://console.developers.google.com).
-    #
-    # In addition to CSV, data can be imported from files that are formatted as
-    # [Newline-delimited JSON](http://jsonlines.org/),
-    # [Avro](http://avro.apache.org/), [Parquet](https://parquet.apache.org/)
-    # or from a Google Cloud Datastore backup.
-    # It can also be "streamed" into BigQuery.
-    #
-    # ### 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.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    # 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
-    # ```
-    #
-    # To avoid making RPCs (network requests) to retrieve the dataset and table
-    # resources when streaming records, pass the `skip_lookup` option. This
-    # creates local objects without verifying that the resources exist on the
-    # BigQuery service.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    # dataset = bigquery.dataset "my_dataset", skip_lookup: true
-    # table = dataset.table "people", skip_lookup: true
-    #
-    # 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.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    # dataset = bigquery.dataset "my_dataset"
-    # table = dataset.create_table "baby_names" do |schema|
-    #   schema.string "name", mode: :required
-    #   schema.string "gender", mode: :required
-    #   schema.integer "count", mode: :required
-    # end
-    #
-    # file = File.open "names/yob2014.txt"
-    # 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.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new
-    # dataset = bigquery.dataset "my_dataset"
-    # source_table = dataset.table "baby_names"
-    # result_table = dataset.create_table "baby_names_results"
-    #
-    # sql = "SELECT name, count " \
-    #       "FROM baby_names " \
-    #       "WHERE gender = 'M' " \
-    #       "ORDER BY count ASC LIMIT 5"
-    # query_job = dataset.query_job sql, table: result_table
-    #
-    # query_job.wait_until_done!
-    #
-    # if !query_job.failed?
-    #   require "google/cloud/storage"
-    #
-    #   storage = Google::Cloud::Storage.new
-    #   bucket_id = "bigquery-exports-#{SecureRandom.uuid}"
-    #   bucket = storage.create_bucket bucket_id
-    #   extract_url = "gs://#{bucket.id}/baby-names.csv"
-    #
-    #   result_table.extract extract_url
-    #
-    #   # Download to local filesystem
-    #   bucket.files.first.download "baby-names.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](https://cloud.google.com/bigquery/docs/exporting-data)
-    # for details.
-    #
-    # ## Configuring retries and timeout
-    #
-    # You can configure how many times API requests may be automatically
-    # retried. When an API request fails, the response will be inspected to see
-    # if the request meets criteria indicating that it may succeed on retry,
-    # such as `500` and `503` status codes or a specific internal error code
-    # such as `rateLimitExceeded`. If it meets the criteria, the request will be
-    # retried after a delay. If another error occurs, the delay will be
-    # increased before a subsequent attempt, until the `retries` limit is
-    # reached.
-    #
-    # You can also set the request `timeout` value in seconds.
-    #
-    # ```ruby
-    # require "google/cloud/bigquery"
-    #
-    # bigquery = Google::Cloud::Bigquery.new retries: 10, timeout: 120
-    # ```
-    #
-    # See the [BigQuery error
-    # table](https://cloud.google.com/bigquery/troubleshooting-errors#errortable)
-    # for a list of error conditions.
+    # See {file:OVERVIEW.md BigQuery Overview}.
     #
     module Bigquery
       # Creates a new `Project` instance connected to the BigQuery service.
       # Each call creates a new connection.
       #
       # For more information on connecting to Google Cloud see the
-      # [Authentication
-      # Guide](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/guides/authentication).
+      # {file:AUTHENTICATION.md Authentication Guide}.
       #
       # @param [String] project_id Identifier for a BigQuery project. If not
       #   present, the default project for the credentials is used.

data/lib/google/cloud/bigquery/convert.rb

@@ -323,6 +323,7 @@ module Google
             "json" => "NEWLINE_DELIMITED_JSON",
             "newline_delimited_json" => "NEWLINE_DELIMITED_JSON",
             "avro" => "AVRO",
+            "orc" => "ORC",
             "parquet" => "PARQUET",
             "datastore" => "DATASTORE_BACKUP",
             "backup" => "DATASTORE_BACKUP",
@@ -354,6 +355,7 @@ module Google
           return "CSV" if path.end_with? ".csv"
           return "NEWLINE_DELIMITED_JSON" if path.end_with? ".json"
           return "AVRO" if path.end_with? ".avro"
+          return "ORC" if path.end_with? ".orc"
           return "PARQUET" if path.end_with? ".parquet"
           return "DATASTORE_BACKUP" if path.end_with? ".backup_info"
           nil

data/lib/google/cloud/bigquery/dataset.rb

@@ -1184,6 +1184,7 @@ module Google
         #   * `csv` - CSV
         #   * `json` - [Newline-delimited JSON](http://jsonlines.org/)
         #   * `avro` - [Avro](http://avro.apache.org/)
+        #   * `orc` - [ORC](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-orc)
         #   * `parquet` - [Parquet](https://parquet.apache.org/)
         #   * `datastore_backup` - Cloud Datastore backup
         # @param [String] create Specifies whether the job is allowed to create
@@ -1444,6 +1445,7 @@ module Google
         #   * `csv` - CSV
         #   * `json` - [Newline-delimited JSON](http://jsonlines.org/)
         #   * `avro` - [Avro](http://avro.apache.org/)
+        #   * `orc` - [ORC](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-orc)
         #   * `parquet` - [Parquet](https://parquet.apache.org/)
         #   * `datastore_backup` - Cloud Datastore backup
         # @param [String] create Specifies whether the job is allowed to create

data/lib/google/cloud/bigquery/encryption_configuration.rb

@@ -21,8 +21,7 @@ module Google
       # # Encryption Configuration
       #
       # A builder for BigQuery table encryption configurations, passed to block
-      # arguments to {Dataset#create_table} and
-      # {Table#encryption_configuration}.
+      # arguments to {Dataset#create_table} and {Table#encryption}.
       #
       # @see https://cloud.google.com/bigquery/docs/customer-managed-encryption
       #   Protecting Data with Cloud KMS Keys

data/lib/google/cloud/bigquery/job.rb

@@ -275,7 +275,9 @@ module Google
         # provided when the job is created, and used to organize and group jobs.
         #
         # The returned hash is frozen and changes are not allowed. Use
-        # {#labels=} to replace the entire hash.
+        # {CopyJob::Updater#labels=} or {ExtractJob::Updater#labels=} or
+        # {LoadJob::Updater#labels=} or {QueryJob::Updater#labels=} to replace
+        # the entire hash.
         #
         # @return [Hash] The job labels.
         #

data/lib/google/cloud/bigquery/load_job.rb

@@ -855,6 +855,7 @@ module Google
           # * `csv` - CSV
           # * `json` - [Newline-delimited JSON](http://jsonlines.org/)
           # * `avro` - [Avro](http://avro.apache.org/)
+          # * `orc` - [ORC](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-orc)
           # * `parquet` - [Parquet](https://parquet.apache.org/)
           # * `datastore_backup` - Cloud Datastore backup
           #

data/lib/google/cloud/bigquery/table.rb

@@ -1505,6 +1505,7 @@ module Google
         #   * `csv` - CSV
         #   * `json` - [Newline-delimited JSON](http://jsonlines.org/)
         #   * `avro` - [Avro](http://avro.apache.org/)
+        #   * `orc` - [ORC](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-orc)
         #   * `parquet` - [Parquet](https://parquet.apache.org/)
         #   * `datastore_backup` - Cloud Datastore backup
         # @param [String] create Specifies whether the job is allowed to create
@@ -1714,6 +1715,7 @@ module Google
         #   * `csv` - CSV
         #   * `json` - [Newline-delimited JSON](http://jsonlines.org/)
         #   * `avro` - [Avro](http://avro.apache.org/)
+        #   * `orc` - [ORC](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-orc)
         #   * `parquet` - [Parquet](https://parquet.apache.org/)
         #   * `datastore_backup` - Cloud Datastore backup
         # @param [String] create Specifies whether the job is allowed to create

data/lib/google/cloud/bigquery/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.7.1".freeze
+      VERSION = "1.8.0".freeze
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery
 version: !ruby/object:Gem::Version
-  version: 1.7.1
+  version: 1.8.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-08-21 00:00:00.000000000 Z
+date: 2018-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core
@@ -197,16 +197,16 @@ dependencies:
   name: yard-doctest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.8
+        version: 0.1.13
 description: google-cloud-bigquery is the official library for Google BigQuery.
 email:
 - mike@blowmage.com