google-cloud-bigquery 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50b7fa8024e29a309cd616906b320776e2190cd43cca0a781067fa5269ec00bb
-  data.tar.gz: 20326ef76dbe3d8804e6ffd2c7cca89ed06e18581637a19b899d6a883bdf4078
+  metadata.gz: 9066e151cc7d6515a247afdcf5b76b70fc089fb5d1b74e12830b49b4ef8ba1ce
+  data.tar.gz: e06851af9995cda27436a7378f82456709ecb6640034e23f3bc47f9fc24811b0
 SHA512:
-  metadata.gz: 728c5e863f1bd2ff9e478b3fd0e6ef715e20e4e144592d09e3d46ac4787fae121c7ced5377877572c30aa41e96e6b3d0255861bccb785a335c5737bb064a829f
-  data.tar.gz: 053f516f57d0c4335e3746ba104bd971e07aa91aec3cc8a68576d488e50a5043f826990fa5408c73a8cb45b838d9d66f3a04aadf7f9e7acab07d392317e6890a
+  metadata.gz: 355f857c958cbb2dca1c78e5a49feb39e17bd1ce254adbede3d0722374e40ff04baf3ac302885afb7de8d0f62afd38e4911a37d1f1efa4fe13f5a78f3cd6e790
+  data.tar.gz: 4f29fdfbeee060ae6bcb560223dba70c6493c50e795fb60c673fb9bc2f5da93a74c5c47590ece5b7c40e8a26754967f16d2cfb9dbfb7d40e08291e47ef5b8b76

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

@@ -270,6 +270,26 @@ module Google
           Schema.from_gapi(@gapi.configuration.load.schema).freeze
         end
 
+        ##
+        # Allows the schema of the destination table to be updated as a side
+        # effect of the load job if a schema is autodetected or supplied in the
+        # job configuration. Schema update options are supported in two cases:
+        # when write disposition is `WRITE_APPEND`; when write disposition is
+        # `WRITE_TRUNCATE` and the destination table is a partition of a table,
+        # specified by partition decorators. For normal tables, `WRITE_TRUNCATE`
+        # will always overwrite the schema. One or more of the following values
+        # are specified:
+        #
+        # * `ALLOW_FIELD_ADDITION`: allow adding a nullable field to the schema.
+        # * `ALLOW_FIELD_RELAXATION`: allow relaxing a required field in the
+        #   original schema to nullable.
+        #
+        # @return [Array<String>] An array of strings.
+        #
+        def schema_update_options
+          Array @gapi.configuration.load.schema_update_options
+        end
+
         ##
         # The number of source data files in the load job.
         #
@@ -329,6 +349,81 @@ module Google
           nil
         end
 
+        ###
+        # Checks if the destination table will be time-partitioned. See
+        # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Boolean, nil] `true` when the table will be time-partitioned,
+        #   or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning?
+          !@gapi.configuration.load.time_partitioning.nil?
+        end
+
+        ###
+        # The period for which the destination table will be partitioned, if
+        # any. See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [String, nil] The partition type. Currently the only supported
+        #   value is "DAY", or `nil` if not present.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_type
+          @gapi.configuration.load.time_partitioning.type if time_partitioning?
+        end
+
+        ###
+        # The field on which the destination table will be partitioned, if any.
+        # If not set, the destination table will be partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table will be partitioned by this field.
+        # See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [String, nil] The partition field, if a field was configured.
+        #   `nil` if not partitioned or not set (partitioned by pseudo column
+        #   '_PARTITIONTIME').
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_field
+          @gapi.configuration.load.time_partitioning.field if time_partitioning?
+        end
+
+        ###
+        # The expiration for the destination table partitions, if any, in
+        # seconds. See [Partitioned
+        # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Integer, nil] The expiration time, in seconds, for data in
+        #   partitions, or `nil` if not present.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_expiration
+          @gapi.configuration.load.time_partitioning.expiration_ms / 1_000 if
+              time_partitioning? &&
+              !@gapi.configuration.load.time_partitioning.expiration_ms.nil?
+        end
+
+        ###
+        # If set to true, queries over the destination table will require a
+        # partition filter that can be used for partition elimination to be
+        # specified. See [Partitioned
+        # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Boolean] `true` when a partition filter will be required,
+        #   or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_require_filter?
+          tp = @gapi.configuration.load.time_partitioning
+          return false if tp.nil? || tp.require_partition_filter.nil?
+          tp.require_partition_filter
+        end
+
         ##
         # Yielded to a block to accumulate changes for a patch request.
         class Updater < LoadJob
@@ -1009,6 +1104,35 @@ module Google
             @gapi.configuration.load.update! quote: val
           end
 
+          ##
+          # Sets the schema update options, which allow the schema of the
+          # destination table to be updated as a side effect of the load job if
+          # a schema is autodetected or supplied in the job configuration.
+          # Schema update options are supported in two cases: when write
+          # disposition is `WRITE_APPEND`; when write disposition is
+          # `WRITE_TRUNCATE` and the destination table is a partition of a
+          # table, specified by partition decorators. For normal tables,
+          # `WRITE_TRUNCATE` will always overwrite the schema. One or more of
+          # the following values are specified:
+          #
+          # * `ALLOW_FIELD_ADDITION`: allow adding a nullable field to the
+          #   schema.
+          # * `ALLOW_FIELD_RELAXATION`: allow relaxing a required field in the
+          #   original schema to nullable.
+          #
+          # @param [Array<String>] new_options The new schema update options.
+          #
+          # @!group Attributes
+          #
+          def schema_update_options= new_options
+            if new_options.nil?
+              @gapi.configuration.load.update! schema_update_options: nil
+            else
+              @gapi.configuration.load.update! \
+                schema_update_options: Array(new_options)
+            end
+          end
+
           ##
           # Sets the number of leading rows to skip in the file.
           #
@@ -1065,6 +1189,136 @@ module Google
             @gapi.configuration.update! labels: val
           end
 
+          ##
+          # Sets the partitioning for the destination table. See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # You can only set the partitioning field while creating a table.
+          # BigQuery does not allow you to change partitioning on an existing
+          # table.
+          #
+          # @param [String] type The partition type. Currently the only
+          #   supported value is "DAY".
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.time_partitioning_type = "DAY"
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_type= type
+            @gapi.configuration.load.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.load.time_partitioning.update! type: type
+          end
+
+          ##
+          # Sets the field on which to partition the destination table. If not
+          # set, the destination table is partitioned by pseudo column
+          # `_PARTITIONTIME`; if set, the table is partitioned by this field.
+          # See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # The destination table must also be partitioned. See
+          # {#time_partitioning_type=}.
+          #
+          # You can only set the partitioning field while creating a table.
+          # BigQuery does not allow you to change partitioning on an existing
+          # table.
+          #
+          # @param [String] field The partition field. The field must be a
+          #   top-level TIMESTAMP or DATE field. Its mode must be NULLABLE or
+          #   REQUIRED.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.time_partitioning_type  = "DAY"
+          #     job.time_partitioning_field = "dob"
+          #     job.schema do |schema|
+          #       schema.timestamp "dob", mode: :required
+          #     end
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_field= field
+            @gapi.configuration.load.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.load.time_partitioning.update! field: field
+          end
+
+          ##
+          # Sets the partition expiration for the destination table. See
+          # [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # The destination table must also be partitioned. See
+          # {#time_partitioning_type=}.
+          #
+          # @param [Integer] expiration An expiration time, in seconds,
+          #   for data in partitions.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.time_partitioning_type = "DAY"
+          #     job.time_partitioning_expiration = 86_400
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_expiration= expiration
+            @gapi.configuration.load.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.load.time_partitioning.update! \
+              expiration_ms: expiration * 1000
+          end
+
+          ##
+          # If set to true, queries over the destination table will require a
+          # partition filter that can be used for partition elimination to be
+          # specified. See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # @param [Boolean] val Indicates if queries over the destination table
+          #   will require a partition filter. The default value is `false`.
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_require_filter= val
+            @gapi.configuration.load.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.load.time_partitioning.update! \
+              require_partition_filter: val
+          end
+
           ##
           # @private Returns the Google API client library version of this job.
           #

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

@@ -148,13 +148,14 @@ module Google
         #   `false` otherwise.
         #
         def cache_hit?
+          return false unless @gapi.statistics.query
           @gapi.statistics.query.cache_hit
         end
 
         ##
         # The number of bytes processed by the query.
         #
-        # @return [Integer] Total bytes processed for the job.
+        # @return [Integer, nil] Total bytes processed for the job.
         #
         def bytes_processed
           Integer @gapi.statistics.query.total_bytes_processed
@@ -165,8 +166,8 @@ module Google
         ##
         # Describes the execution plan for the query.
         #
-        # @return [Array<Google::Cloud::Bigquery::QueryJob::Stage>] An array
-        #   containing the stages of the execution plan.
+        # @return [Array<Google::Cloud::Bigquery::QueryJob::Stage>, nil] An
+        #   array containing the stages of the execution plan.
         #
         # @example
         #   require "google/cloud/bigquery"
@@ -188,12 +189,70 @@ module Google
         #   end
         #
         def query_plan
-          return nil unless @gapi.statistics.query.query_plan
+          return nil unless @gapi.statistics.query &&
+                            @gapi.statistics.query.query_plan
           Array(@gapi.statistics.query.query_plan).map do |stage|
             Stage.from_gapi stage
           end
         end
 
+        ##
+        # The type of query statement, if valid. Possible values (new values
+        # might be added in the future):
+        #
+        # * "SELECT": `SELECT` query.
+        # * "INSERT": `INSERT` query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language
+        # * "UPDATE": `UPDATE` query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language
+        # * "DELETE": `DELETE` query; see https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language
+        # * "CREATE_TABLE": `CREATE [OR REPLACE] TABLE` without `AS SELECT`.
+        # * "CREATE_TABLE_AS_SELECT": `CREATE [OR REPLACE] TABLE ... AS SELECT`.
+        # * "DROP_TABLE": `DROP TABLE` query.
+        # * "CREATE_VIEW": `CREATE [OR REPLACE] VIEW ... AS SELECT ...`.
+        # * "DROP_VIEW": `DROP VIEW` query.
+        #
+        # @return [String, nil] The type of query statement.
+        #
+        def statement_type
+          return nil unless @gapi.statistics.query
+          @gapi.statistics.query.statement_type
+        end
+
+        ##
+        # The DDL operation performed, possibly dependent on the pre-existence
+        # of the DDL target. (See {#ddl_target_table}.) Possible values (new
+        # values might be added in the future):
+        #
+        # * "CREATE": The query created the DDL target.
+        # * "SKIP": No-op. Example cases: the query is
+        #   `CREATE TABLE IF NOT EXISTS` while the table already exists, or the
+        #   query is `DROP TABLE IF EXISTS` while the table does not exist.
+        # * "REPLACE": The query replaced the DDL target. Example case: the
+        #   query is `CREATE OR REPLACE TABLE`, and the table already exists.
+        # * "DROP": The query deleted the DDL target.
+        #
+        # @return [String, nil] The DDL operation performed.
+        #
+        def ddl_operation_performed
+          return nil unless @gapi.statistics.query
+          @gapi.statistics.query.ddl_operation_performed
+        end
+
+        ##
+        # The DDL target table, in reference state. (See {Table#reference?}.)
+        # Present only for `CREATE/DROP TABLE/VIEW` queries. (See
+        # {#statement_type}.)
+        #
+        # @return [Google::Cloud::Bigquery::Table, nil] The DDL target table, in
+        #   reference state.
+        #
+        def ddl_target_table
+          return nil unless @gapi.statistics.query
+          ensure_service!
+          table = @gapi.statistics.query.ddl_target_table
+          return nil unless table
+          Google::Cloud::Bigquery::Table.new_reference_from_gapi table, service
+        end
+
         ##
         # The table in which the query results are stored.
         #
@@ -259,6 +318,81 @@ module Google
           )
         end
 
+        ###
+        # Checks if the destination table will be time-partitioned. See
+        # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Boolean, nil] `true` when the table will be time-partitioned,
+        #   or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning?
+          !@gapi.configuration.query.time_partitioning.nil?
+        end
+
+        ###
+        # The period for which the destination table will be partitioned, if
+        # any. See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [String, nil] The partition type. Currently the only supported
+        #   value is "DAY", or `nil` if not present.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_type
+          @gapi.configuration.query.time_partitioning.type if time_partitioning?
+        end
+
+        ###
+        # The field on which the destination table will be partitioned, if any.
+        # If not set, the destination table will be partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table will be partitioned by this field.
+        # See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [String, nil] The partition field, if a field was configured.
+        #   `nil` if not partitioned or not set (partitioned by pseudo column
+        #   '_PARTITIONTIME').
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_field
+          return nil unless time_partitioning?
+          @gapi.configuration.query.time_partitioning.field
+        end
+
+        ###
+        # The expiration for the destination table partitions, if any, in
+        # seconds. See [Partitioned
+        # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Integer, nil] The expiration time, in seconds, for data in
+        #   partitions, or `nil` if not present.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_expiration
+          tp = @gapi.configuration.query.time_partitioning
+          tp.expiration_ms / 1_000 if tp && !tp.expiration_ms.nil?
+        end
+
+        ###
+        # If set to true, queries over the destination table will require a
+        # partition filter that can be used for partition elimination to be
+        # specified. See [Partitioned
+        # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        #
+        # @return [Boolean] `true` when a partition filter will be required,
+        #   or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def time_partitioning_require_filter?
+          tp = @gapi.configuration.query.time_partitioning
+          return false if tp.nil? || tp.require_partition_filter.nil?
+          tp.require_partition_filter
+        end
+
         ##
         # Refreshes the job until the job is `DONE`.
         # The delay between refreshes will incrementally increase.
@@ -678,6 +812,142 @@ module Google
             )
           end
 
+          ##
+          # Sets the partitioning for the destination table. See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # You can only set the partitioning field while creating a table.
+          # BigQuery does not allow you to change partitioning on an existing
+          # table.
+          #
+          # @param [String] type The partition type. Currently the only
+          #   supported value is "DAY".
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   job = dataset.query_job "SELECT * FROM UNNEST(" \
+          #                           "GENERATE_TIMESTAMP_ARRAY(" \
+          #                           "'2018-10-01 00:00:00', " \
+          #                           "'2018-10-10 00:00:00', " \
+          #                           "INTERVAL 1 DAY)) AS dob" do |job|
+          #     job.time_partitioning_type = "DAY"
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_type= type
+            @gapi.configuration.query.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.query.time_partitioning.update! type: type
+          end
+
+          ##
+          # Sets the field on which to partition the destination table. If not
+          # set, the destination table is partitioned by pseudo column
+          # `_PARTITIONTIME`; if set, the table is partitioned by this field.
+          # See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # The destination table must also be partitioned. See
+          # {#time_partitioning_type=}.
+          #
+          # You can only set the partitioning field while creating a table.
+          # BigQuery does not allow you to change partitioning on an existing
+          # table.
+          #
+          # @param [String] field The partition field. The field must be a
+          #   top-level TIMESTAMP or DATE field. Its mode must be NULLABLE or
+          #   REQUIRED.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   job = dataset.query_job "SELECT * FROM UNNEST(" \
+          #                           "GENERATE_TIMESTAMP_ARRAY(" \
+          #                           "'2018-10-01 00:00:00', " \
+          #                           "'2018-10-10 00:00:00', " \
+          #                           "INTERVAL 1 DAY)) AS dob" do |job|
+          #     job.time_partitioning_type  = "DAY"
+          #     job.time_partitioning_field = "dob"
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_field= field
+            @gapi.configuration.query.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.query.time_partitioning.update! field: field
+          end
+
+          ##
+          # Sets the partition expiration for the destination table. See
+          # [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # The destination table must also be partitioned. See
+          # {#time_partitioning_type=}.
+          #
+          # @param [Integer] expiration An expiration time, in seconds,
+          #   for data in partitions.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   job = dataset.query_job "SELECT * FROM UNNEST(" \
+          #                           "GENERATE_TIMESTAMP_ARRAY(" \
+          #                           "'2018-10-01 00:00:00', " \
+          #                           "'2018-10-10 00:00:00', " \
+          #                           "INTERVAL 1 DAY)) AS dob" do |job|
+          #     job.time_partitioning_type = "DAY"
+          #     job.time_partitioning_expiration = 86_400
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_expiration= expiration
+            @gapi.configuration.query.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.query.time_partitioning.update! \
+              expiration_ms: expiration * 1000
+          end
+
+          ##
+          # If set to true, queries over the destination table will require a
+          # partition filter that can be used for partition elimination to be
+          # specified. See [Partitioned
+          # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+          #
+          # @param [Boolean] val Indicates if queries over the destination table
+          #   will require a partition filter. The default value is `false`.
+          #
+          # @!group Attributes
+          #
+          def time_partitioning_require_filter= val
+            @gapi.configuration.query.time_partitioning ||= \
+              Google::Apis::BigqueryV2::TimePartitioning.new
+            @gapi.configuration.query.time_partitioning.update! \
+              require_partition_filter: val
+          end
+
           ##
           # @private Returns the Google API client library version of this job.
           #

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

@@ -219,7 +219,9 @@ module Google
         end
 
         ###
-        # The field on which the table is partitioned, if any. See
+        # The field on which the table is partitioned, if any. If not
+        # set, the destination table is partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table is partitioned by this field. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [String, nil] The partition field, if a field was configured.
@@ -235,8 +237,10 @@ module Google
         end
 
         ##
-        # Sets the field on which to partition the table. See [Partitioned
-        # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
+        # Sets the field on which to partition the table. If not
+        # set, the destination table is partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table is partitioned by this field. See
+        # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         # The table must also be partitioned.
         #
         # See {Table#time_partitioning_type=}.
@@ -2168,10 +2172,10 @@ module Google
 
         ##
         # @private New Table from a Google API Client object.
-        def self.from_gapi gapi, conn
+        def self.from_gapi gapi, service
           new.tap do |f|
             f.gapi = gapi
-            f.service = conn
+            f.service = service
           end
         end
 
@@ -2190,6 +2194,15 @@ module Google
           end
         end
 
+        ##
+        # @private New lazy Table object from a Google API Client object.
+        def self.new_reference_from_gapi gapi, service
+          new.tap do |b|
+            b.service = service
+            b.instance_variable_set :@reference, gapi
+          end
+        end
+
         protected
 
         ##

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.6.0".freeze
+      VERSION = "1.7.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.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-22 00:00:00.000000000 Z
+date: 2018-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core