google-cloud-bigquery 0.29.0 → 0.30.0

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

@@ -185,8 +185,8 @@ module Google
           ##
           # Add reader access to a view.
           #
-          # @param [Google::Cloud::Bigquery::View, String] view A view object or
-          #   a string identifier as specified by the [Query
+          # @param [Google::Cloud::Bigquery::Table, String] view A table object
+          #   or a string identifier as specified by the [Query
           #   Reference](https://cloud.google.com/bigquery/query-reference#from):
           #   `project_name:datasetId.tableId`.
           #
@@ -444,8 +444,8 @@ module Google
           ##
           # Remove reader access from a view.
           #
-          # @param [Google::Cloud::Bigquery::View, String] view A view object or
-          #   a string identifier as specified by the [Query
+          # @param [Google::Cloud::Bigquery::Table, String] view A table object
+          #   or a string identifier as specified by the [Query
           #   Reference](https://cloud.google.com/bigquery/query-reference#from):
           #   `project_name:datasetId.tableId`.
           #
@@ -699,8 +699,8 @@ module Google
           ##
           # Checks reader access for a view.
           #
-          # @param [Google::Cloud::Bigquery::View, String] view A view object or
-          #   a string identifier as specified by the [Query
+          # @param [Google::Cloud::Bigquery::Table, String] view A table object
+          #   or a string identifier as specified by the [Query
           #   Reference](https://cloud.google.com/bigquery/query-reference#from):
           #   `project_name:datasetId.tableId`.
           #

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

@@ -31,7 +31,7 @@ module Google
       #
       # A job instance is created when you call {Project#query_job},
       # {Dataset#query_job}, {Table#copy_job}, {Table#extract_job},
-      # {Table#load_job}, or {View#data}.
+      # {Table#load_job}.
       #
       # @see https://cloud.google.com/bigquery/docs/managing-jobs Running and
       #   Managing Jobs

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

@@ -74,19 +74,20 @@ module Google
         #   require "google/cloud/bigquery"
         #
         #   bigquery = Google::Cloud::Bigquery.new(
-        #     project: "my-project-id",
-        #     keyfile: "/path/to/keyfile.json"
+        #     project_id: "my-project",
+        #     credentials: "/path/to/keyfile.json"
         #   )
         #
-        #   bigquery.project #=> "my-project-id"
+        #   bigquery.project_id #=> "my-project"
         #
-        def project
+        def project_id
           service.project
         end
+        alias_method :project, :project_id
 
         ##
-        # @private Default project.
-        def self.default_project
+        # @private Default project_id.
+        def self.default_project_id
           ENV["BIGQUERY_PROJECT"] ||
             ENV["GOOGLE_CLOUD_PROJECT"] ||
             ENV["GCLOUD_PROJECT"] ||
@@ -580,6 +581,10 @@ module Google
         # Retrieves an existing dataset by ID.
         #
         # @param [String] dataset_id The ID of a dataset.
+        # @param [Boolean] skip_lookup Optionally create just a local reference
+        #   object without verifying that the resource exists on the BigQuery
+        #   service. Calls made on this object will raise errors if the resource
+        #   does not exist. Default is `false`. Optional.
         #
         # @return [Google::Cloud::Bigquery::Dataset, nil] Returns `nil` if the
         #   dataset does not exist.
@@ -592,8 +597,18 @@ module Google
         #   dataset = bigquery.dataset "my_dataset"
         #   puts dataset.name
         #
-        def dataset dataset_id
+        # @example Avoid retrieving the dataset resource with `skip_lookup`:
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset", skip_lookup: true
+        #
+        def dataset dataset_id, skip_lookup: nil
           ensure_service!
+          if skip_lookup
+            return Dataset.new_reference project, dataset_id, service
+          end
           gapi = service.get_dataset dataset_id
           Dataset.from_gapi gapi, service
         rescue Google::Cloud::NotFoundError

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

@@ -24,7 +24,7 @@ module Google
       #
       # A {Job} subclass representing a query operation that may be performed
       # on a {Table}. A QueryJob instance is created when you call
-      # {Project#query_job}, {Dataset#query_job}, or {View#data}.
+      # {Project#query_job}, {Dataset#query_job}.
       #
       # @see https://cloud.google.com/bigquery/querying-data Querying Data
       # @see https://cloud.google.com/bigquery/docs/reference/v2/jobs Jobs API
@@ -305,9 +305,11 @@ module Google
           ensure_schema!
 
           options = { token: token, max: max, start: start }
-          data_gapi = service.list_tabledata destination_table_dataset_id,
-                                             destination_table_table_id, options
-          Data.from_gapi data_gapi, destination_table_gapi, service
+          data_hash = service.list_tabledata \
+            destination_table_dataset_id,
+            destination_table_table_id,
+            options
+          Data.from_gapi_json data_hash, destination_table_gapi, service
         end
         alias_method :query_results, :data
 

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

@@ -46,7 +46,6 @@ module Google
         def initialize project, credentials, retries: nil, timeout: nil
           @project = project
           @credentials = credentials
-          @credentials = credentials
           @retries = retries
           @timeout = timeout
         end
@@ -191,10 +190,13 @@ module Google
         def list_tabledata dataset_id, table_id, options = {}
           # The list operation is considered idempotent
           execute backoff: true do
-            service.list_table_data @project, dataset_id, table_id,
-                                    max_results: options.delete(:max),
-                                    page_token: options.delete(:token),
-                                    start_index: options.delete(:start)
+            json_txt = service.list_table_data \
+              @project, dataset_id, table_id,
+              max_results: options.delete(:max),
+              page_token: options.delete(:token),
+              start_index: options.delete(:start),
+              options: { skip_deserialization: true }
+            JSON.parse json_txt, symbolize_names: true
           end
         end
 

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

@@ -15,7 +15,6 @@
 
 require "google/cloud/errors"
 require "google/cloud/bigquery/service"
-require "google/cloud/bigquery/view"
 require "google/cloud/bigquery/data"
 require "google/cloud/bigquery/table/list"
 require "google/cloud/bigquery/schema"
@@ -34,6 +33,15 @@ module Google
       # records. Every table is defined by a schema that may contain nested and
       # repeated fields.
       #
+      # The Table class can also represent a
+      # [view](https://cloud.google.com/bigquery/docs/views), which is a virtual
+      # table defined by a SQL query. BigQuery's views are logical views, not
+      # materialized views, which means that the query that defines the view is
+      # re-executed every time the view is queried. Queries are billed according
+      # to the total amount of data in all table fields referenced directly or
+      # indirectly by the top-level query. (See {#view?}, {#query}, {#query=},
+      # and {Dataset#create_view}.)
+      #
       # @see https://cloud.google.com/bigquery/preparing-data-for-bigquery
       #   Preparing Data for BigQuery
       #
@@ -66,6 +74,15 @@ module Google
       #   }
       #   table.insert row
       #
+      # @example Creating a BigQuery view:
+      #   require "google/cloud/bigquery"
+      #
+      #   bigquery = Google::Cloud::Bigquery.new
+      #   dataset = bigquery.dataset "my_dataset"
+      #   view = dataset.create_view "my_view",
+      #            "SELECT name, age FROM `my_project.my_dataset.my_table`"
+      #   view.view? # true
+      #
       class Table
         ##
         # @private The Service object.
@@ -75,11 +92,16 @@ module Google
         # @private The Google API Client object.
         attr_accessor :gapi
 
+        ##
+        # @private A Google API Client Table Reference object.
+        attr_reader :reference
+
         ##
         # @private Create an empty Table object.
         def initialize
           @service = nil
-          @gapi = Google::Apis::BigqueryV2::Table.new
+          @gapi = nil
+          @reference = nil
         end
 
         ##
@@ -91,6 +113,7 @@ module Google
         # @!group Attributes
         #
         def table_id
+          return reference.table_id if reference?
           @gapi.table_reference.table_id
         end
 
@@ -103,6 +126,7 @@ module Google
         # @!group Attributes
         #
         def dataset_id
+          return reference.dataset_id if reference?
           @gapi.table_reference.dataset_id
         end
 
@@ -114,28 +138,32 @@ module Google
         # @!group Attributes
         #
         def project_id
+          return reference.project_id if reference?
           @gapi.table_reference.project_id
         end
 
         ##
         # @private The gapi fragment containing the Project ID, Dataset ID, and
-        # Table ID as a camel-cased hash.
+        # Table ID.
+        #
+        # @return [Google::Apis::BigqueryV2::TableReference]
+        #
         def table_ref
-          table_ref = @gapi.table_reference
-          table_ref = table_ref.to_hash if table_ref.respond_to? :to_hash
-          table_ref
+          reference? ? reference : @gapi.table_reference
         end
 
         ###
         # Checks if the table is time-partitioned. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [Boolean] `true` when the table is time-partitioned, `false`
-        #   otherwise.
+        # @return [Boolean, nil] `true` when the table is time-partitioned, or
+        #   `false` otherwise, if the object is a resource (see {#resource?});
+        #   `nil` if the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def time_partitioning?
+          return nil if reference?
           !@gapi.time_partitioning.nil?
         end
 
@@ -144,11 +172,13 @@ module Google
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [String, nil] The partition type. Currently the only supported
-        #   value is "DAY".
+        #   value is "DAY", or `nil` if the object is a reference (see
+        #   {#reference?}).
         #
         # @!group Attributes
         #
         def time_partitioning_type
+          return nil if reference?
           ensure_full_data!
           @gapi.time_partitioning.type if time_partitioning?
         end
@@ -161,6 +191,10 @@ module Google
         # the example below. BigQuery does not allow you to change partitioning
         # on an existing table.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @param [String] type The partition type. Currently the only
         #   supported value is "DAY".
         #
@@ -176,6 +210,7 @@ module Google
         # @!group Attributes
         #
         def time_partitioning_type= type
+          reload! unless resource_full?
           @gapi.time_partitioning ||=
               Google::Apis::BigqueryV2::TimePartitioning.new
           @gapi.time_partitioning.type = type
@@ -188,11 +223,13 @@ module Google
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [Integer, nil] The expiration time, in seconds, for data in
-        #   partitions.
+        #   partitions, or `nil` if not present or the object is a reference
+        #   (see {#reference?}).
         #
         # @!group Attributes
         #
         def time_partitioning_expiration
+          return nil if reference?
           ensure_full_data!
           @gapi.time_partitioning.expiration_ms / 1_000 if
               time_partitioning? &&
@@ -206,6 +243,10 @@ module Google
         #
         # See {Table#time_partitioning_type=}.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @param [Integer] expiration An expiration time, in seconds,
         #   for data in partitions.
         #
@@ -222,6 +263,7 @@ module Google
         # @!group Attributes
         #
         def time_partitioning_expiration= expiration
+          reload! unless resource_full?
           @gapi.time_partitioning ||=
               Google::Apis::BigqueryV2::TimePartitioning.new
           @gapi.time_partitioning.expiration_ms = expiration * 1000
@@ -235,11 +277,13 @@ module Google
         # `project_name:datasetId.tableId`. To use this value in queries see
         # {#query_id}.
         #
-        # @return [String] The combined ID.
+        # @return [String, nil] The combined ID, or `nil` if the object is a
+        #   reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def id
+          return nil if reference?
           @gapi.id
         end
 
@@ -274,7 +318,7 @@ module Google
         #
         def query_id standard_sql: nil, legacy_sql: nil
           if Convert.resolve_legacy_sql standard_sql, legacy_sql
-            "[#{id}]"
+            "[#{project_id}:#{dataset_id}.#{table_id}]"
           else
             "`#{project_id}.#{dataset_id}.#{table_id}`"
           end
@@ -283,22 +327,29 @@ module Google
         ##
         # The name of the table.
         #
-        # @return [String] The friendly name.
+        # @return [String, nil] The friendly name, or `nil` if the object is a
+        #   reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def name
+          return nil if reference?
           @gapi.friendly_name
         end
 
         ##
         # Updates the name of the table.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @param [String] new_name The new friendly name.
         #
         # @!group Attributes
         #
         def name= new_name
+          reload! unless resource_full?
           @gapi.update! friendly_name: new_name
           patch_gapi! :friendly_name
         end
@@ -306,11 +357,13 @@ module Google
         ##
         # The ETag hash of the table.
         #
-        # @return [String] The ETag hash.
+        # @return [String, nil] The ETag hash, or `nil` if the object is a
+        #   reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def etag
+          return nil if reference?
           ensure_full_data!
           @gapi.etag
         end
@@ -318,11 +371,13 @@ module Google
         ##
         # A URL that can be used to access the table using the REST API.
         #
-        # @return [String] A REST URL for the resource.
+        # @return [String, nil] A REST URL for the resource, or `nil` if the
+        #   object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def api_url
+          return nil if reference?
           ensure_full_data!
           @gapi.self_link
         end
@@ -330,11 +385,13 @@ module Google
         ##
         # A user-friendly description of the table.
         #
-        # @return [String] The description.
+        # @return [String, nil] The description, or `nil` if the object is a
+        #   reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def description
+          return nil if reference?
           ensure_full_data!
           @gapi.description
         end
@@ -342,11 +399,16 @@ module Google
         ##
         # Updates the user-friendly description of the table.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @param [String] new_description The new user-friendly description.
         #
         # @!group Attributes
         #
         def description= new_description
+          reload! unless resource_full?
           @gapi.update! description: new_description
           patch_gapi! :description
         end
@@ -354,11 +416,13 @@ module Google
         ##
         # The number of bytes in the table.
         #
-        # @return [Integer] The count of bytes in the table.
+        # @return [Integer, nil] The count of bytes in the table, or `nil` if
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Data
         #
         def bytes_count
+          return nil if reference?
           ensure_full_data!
           begin
             Integer @gapi.num_bytes
@@ -370,11 +434,13 @@ module Google
         ##
         # The number of rows in the table.
         #
-        # @return [Integer] The count of rows in the table.
+        # @return [Integer, nil] The count of rows in the table, or `nil` if the
+        #   object is a reference (see {#reference?}).
         #
         # @!group Data
         #
         def rows_count
+          return nil if reference?
           ensure_full_data!
           begin
             Integer @gapi.num_rows
@@ -386,11 +452,13 @@ module Google
         ##
         # The time when this table was created.
         #
-        # @return [Time, nil] The creation time.
+        # @return [Time, nil] The creation time, or `nil` if the object is a
+        #   reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def created_at
+          return nil if reference?
           ensure_full_data!
           begin
             ::Time.at(Integer(@gapi.creation_time) / 1000.0)
@@ -404,11 +472,13 @@ module Google
         # If not present, the table will persist indefinitely.
         # Expired tables will be deleted and their storage reclaimed.
         #
-        # @return [Time, nil] The expiration time.
+        # @return [Time, nil] The expiration time, or `nil` if not present or
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def expires_at
+          return nil if reference?
           ensure_full_data!
           begin
             ::Time.at(Integer(@gapi.expiration_time) / 1000.0)
@@ -420,11 +490,13 @@ module Google
         ##
         # The date when this table was last modified.
         #
-        # @return [Time, nil] The last modified time.
+        # @return [Time, nil] The last modified time, or `nil` if not present or
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def modified_at
+          return nil if reference?
           ensure_full_data!
           begin
             ::Time.at(Integer(@gapi.last_modified_time) / 1000.0)
@@ -436,34 +508,45 @@ module Google
         ##
         # Checks if the table's type is "TABLE".
         #
-        # @return [Boolean] `true` when the type is `TABLE`, `false` otherwise.
+        # @return [Boolean, nil] `true` when the type is `TABLE`, `false`
+        #   otherwise, if the object is a resource (see {#resource?}); `nil` if
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def table?
+          return nil if reference?
           @gapi.type == "TABLE"
         end
 
         ##
-        # Checks if the table's type is "VIEW".
+        # Checks if the table's type is "VIEW", indicating that the table
+        # represents a BigQuery view. See {Dataset#create_view}.
         #
-        # @return [Boolean] `true` when the type is `VIEW`, `false` otherwise.
+        # @return [Boolean, nil] `true` when the type is `VIEW`, `false`
+        #   otherwise, if the object is a resource (see {#resource?}); `nil` if
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def view?
+          return nil if reference?
           @gapi.type == "VIEW"
         end
 
         ##
-        # Checks if the table's type is "EXTERNAL".
+        # Checks if the table's type is "EXTERNAL", indicating that the table
+        # represents an External Data Source. See {#external?} and
+        # {External::DataSource}.
         #
-        # @return [Boolean] `true` when the type is `EXTERNAL`, `false`
-        #   otherwise.
+        # @return [Boolean, nil] `true` when the type is `EXTERNAL`, `false`
+        #   otherwise, if the object is a resource (see {#resource?}); `nil` if
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def external?
+          return nil if reference?
           @gapi.type == "EXTERNAL"
         end
 
@@ -471,11 +554,12 @@ module Google
         # The geographic location where the table should reside. Possible
         # values include `EU` and `US`. The default value is `US`.
         #
-        # @return [String] The location code.
+        # @return [String, nil] The location code.
         #
         # @!group Attributes
         #
         def location
+          return nil if reference?
           ensure_full_data!
           @gapi.location
         end
@@ -488,7 +572,7 @@ module Google
         # The returned hash is frozen and changes are not allowed. Use
         # {#labels=} to replace the entire hash.
         #
-        # @return [Hash<String, String>] A hash containing key/value pairs.
+        # @return [Hash<String, String>, nil] A hash containing key/value pairs.
         #
         # @example
         #   require "google/cloud/bigquery"
@@ -503,6 +587,7 @@ module Google
         # @!group Attributes
         #
         def labels
+          return nil if reference?
           m = @gapi.labels
           m = m.to_h if m.respond_to? :to_h
           m.dup.freeze
@@ -513,6 +598,10 @@ module Google
         # Labels are used to organize and group tables. See [Using
         # Labels](https://cloud.google.com/bigquery/docs/labels).
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @param [Hash<String, String>] labels A hash containing key/value
         #   pairs.
         #
@@ -535,14 +624,18 @@ module Google
         # @!group Attributes
         #
         def labels= labels
+          reload! unless resource_full?
           @gapi.labels = labels
           patch_gapi! :labels
         end
 
         ##
-        # Returns the table's schema. This method can also be used to set,
-        # replace, or add to the schema by passing a block. See {Schema} for
-        # available methods.
+        # Returns the table's schema. If the table is not a view (See {#view?}),
+        # this method can also be used to set, replace, or add to the schema by
+        # passing a block. See {Schema} for available methods.
+        #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved.
         #
         # @param [Boolean] replace Whether to replace the existing schema with
         #   the new schema. If `true`, the fields will replace the existing
@@ -552,7 +645,7 @@ module Google
         # @yield [schema] a block for setting the schema
         # @yieldparam [Schema] schema the object accepting the schema
         #
-        # @return [Google::Cloud::Bigquery::Schema] A frozen schema object.
+        # @return [Google::Cloud::Bigquery::Schema, nil] A frozen schema object.
         #
         # @example
         #   require "google/cloud/bigquery"
@@ -572,7 +665,8 @@ module Google
         # @!group Attributes
         #
         def schema replace: false
-          ensure_full_data!
+          return nil if reference? && !block_given?
+          reload! unless resource_full?
           schema_builder = Schema.from_gapi @gapi.schema
           if block_given?
             schema_builder = Schema.from_gapi if replace
@@ -588,7 +682,7 @@ module Google
         ##
         # The fields of the table, obtained from its schema.
         #
-        # @return [Array<Schema::Field>] An array of field objects.
+        # @return [Array<Schema::Field>, nil] An array of field objects.
         #
         # @example
         #   require "google/cloud/bigquery"
@@ -604,13 +698,14 @@ module Google
         # @!group Attributes
         #
         def fields
+          return nil if reference?
           schema.fields
         end
 
         ##
         # The names of the columns in the table, obtained from its schema.
         #
-        # @return [Array<Symbol>] An array of column names.
+        # @return [Array<Symbol>, nil] An array of column names.
         #
         # @example
         #   require "google/cloud/bigquery"
@@ -626,6 +721,7 @@ module Google
         # @!group Attributes
         #
         def headers
+          return nil if reference?
           schema.headers
         end
 
@@ -642,11 +738,13 @@ module Google
         # @see https://cloud.google.com/bigquery/external-data-sources
         #   Querying External Data Sources
         #
-        # @return [External::DataSource] The external data source.
+        # @return [External::DataSource, nil] The external data source.
         #
         #   @!group Attributes
         #
         def external
+          return nil if reference?
+          ensure_full_data!
           return nil if @gapi.external_data_configuration.nil?
           External.from_gapi(@gapi.external_data_configuration).freeze
         end
@@ -661,6 +759,10 @@ module Google
         # Use only if the table represents an External Data Source. See
         # {#external?} and {External::DataSource}.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
         # @see https://cloud.google.com/bigquery/external-data-sources
         #   Querying External Data Sources
         #
@@ -669,6 +771,7 @@ module Google
         # @!group Attributes
         #
         def external= external
+          reload! unless resource_full?
           @gapi.external_data_configuration = external.to_gapi
           patch_gapi! :external_data_configuration
         end
@@ -679,11 +782,14 @@ module Google
         # if the table is not being streamed to or if there is no data in the
         # streaming buffer.
         #
-        # @return [Integer] The estimated number of bytes in the buffer.
+        # @return [Integer, nil] The estimated number of bytes in the buffer, or
+        #   `nil` if not present or the object is a reference (see
+        #   {#reference?}).
         #
         # @!group Attributes
         #
         def buffer_bytes
+          return nil if reference?
           ensure_full_data!
           @gapi.streaming_buffer.estimated_bytes if @gapi.streaming_buffer
         end
@@ -694,11 +800,14 @@ module Google
         # if the table is not being streamed to or if there is no data in the
         # streaming buffer.
         #
-        # @return [Integer] The estimated number of rows in the buffer.
+        # @return [Integer, nil] The estimated number of rows in the buffer, or
+        #   `nil` if not present or the object is a reference (see
+        #   {#reference?}).
         #
         # @!group Attributes
         #
         def buffer_rows
+          return nil if reference?
           ensure_full_data!
           @gapi.streaming_buffer.estimated_rows if @gapi.streaming_buffer
         end
@@ -708,11 +817,13 @@ module Google
         # buffer, if one is present. This field will be absent if the table is
         # not being streamed to or if there is no data in the streaming buffer.
         #
-        # @return [Time, nil] The oldest entry time.
+        # @return [Time, nil] The oldest entry time, or `nil` if not present or
+        #   the object is a reference (see {#reference?}).
         #
         # @!group Attributes
         #
         def buffer_oldest_at
+          return nil if reference?
           ensure_full_data!
           return nil unless @gapi.streaming_buffer
           oldest_entry_time = @gapi.streaming_buffer.oldest_entry_time
@@ -723,9 +834,142 @@ module Google
           end
         end
 
+        ##
+        # The query that executes each time the view is loaded.
+        #
+        # @return [String] The query that defines the view.
+        #
+        # @!group Attributes
+        #
+        def query
+          @gapi.view.query if @gapi.view
+        end
+
+        ##
+        # Updates the query that executes each time the view is loaded.
+        #
+        # This sets the query using standard SQL. To specify legacy SQL or to
+        # use user-defined function resources use (#set_query) instead.
+        #
+        # @see https://cloud.google.com/bigquery/query-reference BigQuery Query
+        #   Reference
+        #
+        # @param [String] new_query The query that defines the view.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   view = dataset.table "my_view"
+        #
+        #   view.query = "SELECT first_name FROM " \
+        #                  "`my_project.my_dataset.my_table`"
+        #
+        # @!group Lifecycle
+        #
+        def query= new_query
+          set_query new_query
+        end
+
+        ##
+        # Updates the query that executes each time the view is loaded. Allows
+        # setting of standard vs. legacy SQL and user-defined function
+        # resources.
+        #
+        # @see https://cloud.google.com/bigquery/query-reference BigQuery Query
+        #   Reference
+        #
+        # @param [String] query The query that defines the view.
+        # @param [Boolean] standard_sql Specifies whether to use BigQuery's
+        #   [standard
+        #   SQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/)
+        #   dialect. Optional. The default value is true.
+        # @param [Boolean] legacy_sql Specifies whether to use BigQuery's
+        #   [legacy
+        #   SQL](https://cloud.google.com/bigquery/docs/reference/legacy-sql)
+        #   dialect. Optional. The default value is false.
+        # @param [Array<String>, String] udfs User-defined function resources
+        #   used in the query. May be either a code resource to load from a
+        #   Google Cloud Storage URI (`gs://bucket/path`), or an inline resource
+        #   that contains code for a user-defined function (UDF). Providing an
+        #   inline code resource is equivalent to providing a URI for a file
+        #   containing the same code. See [User-Defined
+        #   Functions](https://cloud.google.com/bigquery/docs/reference/standard-sql/user-defined-functions).
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   view = dataset.table "my_view"
+        #
+        #   view.set_query "SELECT first_name FROM " \
+        #                    "`my_project.my_dataset.my_table`",
+        #                  standard_sql: true
+        #
+        # @!group Lifecycle
+        #
+        def set_query query, standard_sql: nil, legacy_sql: nil, udfs: nil
+          @gapi.view = Google::Apis::BigqueryV2::ViewDefinition.new \
+            query: query,
+            use_legacy_sql: Convert.resolve_legacy_sql(standard_sql,
+                                                       legacy_sql),
+            user_defined_function_resources: udfs_gapi(udfs)
+          patch_gapi! :view
+        end
+
+        ##
+        # Checks if the view's query is using legacy sql.
+        #
+        # @return [Boolean] `true` when legacy sql is used, `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def query_legacy_sql?
+          val = @gapi.view.use_legacy_sql
+          return true if val.nil?
+          val
+        end
+
+        ##
+        # Checks if the view's query is using standard sql.
+        #
+        # @return [Boolean] `true` when standard sql is used, `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def query_standard_sql?
+          !query_legacy_sql?
+        end
+
+        ##
+        # The user-defined function resources used in the view's query. May be
+        # either a code resource to load from a Google Cloud Storage URI
+        # (`gs://bucket/path`), or an inline resource that contains code for a
+        # user-defined function (UDF). Providing an inline code resource is
+        # equivalent to providing a URI for a file containing the same code. See
+        # [User-Defined
+        # Functions](https://cloud.google.com/bigquery/docs/reference/standard-sql/user-defined-functions).
+        #
+        # @return [Array<String>] An array containing Google Cloud Storage URIs
+        #   and/or inline source code.
+        #
+        # @!group Attributes
+        #
+        def query_udfs
+          udfs_gapi = @gapi.view.user_defined_function_resources
+          return [] if udfs_gapi.nil?
+          Array(udfs_gapi).map { |udf| udf.inline_code || udf.resource_uri }
+        end
+
         ##
         # Retrieves data from the table.
         #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the data retrieval.
+        #
         # @param [String] token Page token, returned by a previous call,
         #   identifying the result set.
         #
@@ -765,9 +1009,11 @@ module Google
         #
         def data token: nil, max: nil, start: nil
           ensure_service!
+          reload! unless resource_full?
           options = { token: token, max: max, start: start }
-          data_gapi = service.list_tabledata dataset_id, table_id, options
-          Data.from_gapi data_gapi, gapi, service
+          data_json = service.list_tabledata \
+            dataset_id, table_id, options
+          Data.from_gapi_json data_json, gapi, service
         end
 
         ##
@@ -1438,6 +1684,19 @@ module Google
         #   ]
         #   table.insert rows
         #
+        # @example Avoid retrieving the dataset and table with `skip_lookup`:
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset", skip_lookup: true
+        #   table = dataset.table "my_table", skip_lookup: true
+        #
+        #   rows = [
+        #     { "first_name" => "Alice", "age" => 21 },
+        #     { "first_name" => "Bob", "age" => 22 }
+        #   ]
+        #   table.insert rows
+        #
         # @!group Data
         #
         def insert rows, skip_invalid: nil, ignore_unknown: nil
@@ -1451,7 +1710,7 @@ module Google
         end
 
         ##
-        # Create an asynchonous inserter object used to insert rows in batches.
+        # Create an asynchronous inserter object used to insert rows in batches.
         #
         # @param [Boolean] skip_invalid Insert all valid rows of a request, even
         #   if invalid rows exist. The default value is `false`, which causes
@@ -1469,8 +1728,8 @@ module Google
         # @attr_reader [Numeric] threads The number of threads used to insert
         #   batches of rows. Default is 4.
         # @yield [response] the callback for when a batch of rows is inserted
-        # @yieldparam [InsertResponse] response the result of the asynchonous
-        #   insert
+        # @yieldparam [Table::AsyncInserter::Result] result the result of the
+        #   asynchronous insert
         #
         # @return [Table::AsyncInserter] Returns inserter object.
         #
@@ -1480,9 +1739,13 @@ module Google
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
         #   table = dataset.table "my_table"
-        #   inserter = table.insert_async do |response|
-        #     log_insert "inserted #{response.insert_count} rows " \
-        #       "with #{response.error_count} errors"
+        #   inserter = table.insert_async do |result|
+        #     if result.error?
+        #       log_error result.error
+        #     else
+        #       log_insert "inserted #{result.insert_count} rows " \
+        #         "with #{result.error_count} errors"
+        #     end
         #   end
         #
         #   rows = [
@@ -1529,6 +1792,19 @@ module Google
         ##
         # Reloads the table with current data from the BigQuery service.
         #
+        # @return [Google::Cloud::Bigquery::Table] Returns the reloaded
+        #   table.
+        #
+        # @example Skip retrieving the table from the service, then load it:
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table", skip_lookup: true
+        #
+        #   table.reload!
+        #
         # @!group Lifecycle
         #
         def reload!
@@ -1538,16 +1814,152 @@ module Google
         end
         alias_method :refresh!, :reload!
 
+        ##
+        # Determines whether the table exists in the BigQuery service. The
+        # result is cached locally.
+        #
+        # @return [Boolean] `true` when the table exists in the BigQuery
+        #   service, `false` otherwise.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table", skip_lookup: true
+        #   table.exists? # true
+        #
+        def exists?
+          # Always true if we have a gapi object
+          return true unless reference?
+          # If we have a value, return it
+          return @exists unless @exists.nil?
+          ensure_gapi!
+          @exists = true
+        rescue Google::Cloud::NotFoundError
+          @exists = false
+        end
+
+        ##
+        # Whether the table was created without retrieving the resource
+        # representation from the BigQuery service.
+        #
+        # @return [Boolean] `true` when the table is just a local reference
+        #   object, `false` otherwise.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table", skip_lookup: true
+        #
+        #   table.reference? # true
+        #   table.reload!
+        #   table.reference? # false
+        #
+        def reference?
+          @gapi.nil?
+        end
+
+        ##
+        # Whether the table was created with a resource representation from
+        # the BigQuery service.
+        #
+        # @return [Boolean] `true` when the table was created with a resource
+        #   representation, `false` otherwise.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table", skip_lookup: true
+        #
+        #   table.resource? # false
+        #   table.reload!
+        #   table.resource? # true
+        #
+        def resource?
+          !@gapi.nil?
+        end
+
+        ##
+        # Whether the table was created with a partial resource representation
+        # from the BigQuery service by retrieval through {Dataset#tables}.
+        # See [Tables: list
+        # response](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables/list#response)
+        # for the contents of the partial representation. Accessing any
+        # attribute outside of the partial representation will result in loading
+        # the full representation.
+        #
+        # @return [Boolean] `true` when the table was created with a partial
+        #   resource representation, `false` otherwise.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.tables.first
+        #
+        #   table.resource_partial? # true
+        #   table.description # Loads the full resource.
+        #   table.resource_partial? # false
+        #
+        def resource_partial?
+          @gapi.is_a? Google::Apis::BigqueryV2::TableList::Table
+        end
+
+        ##
+        # Whether the table was created with a full resource representation
+        # from the BigQuery service.
+        #
+        # @return [Boolean] `true` when the table was created with a full
+        #   resource representation, `false` otherwise.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table"
+        #
+        #   table.resource_full? # true
+        #
+        def resource_full?
+          @gapi.is_a? Google::Apis::BigqueryV2::Table
+        end
+
         ##
         # @private New Table from a Google API Client object.
         def self.from_gapi gapi, conn
-          klass = class_for gapi
-          klass.new.tap do |f|
+          new.tap do |f|
             f.gapi = gapi
             f.service = conn
           end
         end
 
+        ##
+        # @private New lazy Table object without making an HTTP request.
+        def self.new_reference project_id, dataset_id, table_id, service
+          # TODO: raise if dataset_id or table_id is nil?
+          new.tap do |b|
+            reference_gapi = Google::Apis::BigqueryV2::TableReference.new(
+              project_id: project_id,
+              dataset_id: dataset_id,
+              table_id: table_id
+            )
+            b.service = service
+            b.instance_variable_set :@reference, reference_gapi
+          end
+        end
+
         protected
 
         ##
@@ -1556,6 +1968,15 @@ module Google
           fail "Must have active connection" unless service
         end
 
+        ##
+        # Ensures the Google::Apis::BigqueryV2::Table object has been loaded
+        # from the service.
+        def ensure_gapi!
+          ensure_service!
+          return unless reference?
+          reload!
+        end
+
         def patch_gapi! *attributes
           return if attributes.empty?
           ensure_service!
@@ -1571,11 +1992,6 @@ module Google
           reload!
         end
 
-        def self.class_for gapi
-          return View if gapi.type == "VIEW"
-          self
-        end
-
         def load_storage url, options = {}
           # Convert to storage URL
           url = url.to_gs_url if url.respond_to? :to_gs_url
@@ -1608,19 +2024,28 @@ module Google
         # Load the complete representation of the table if it has been
         # only partially loaded by a request to the API list method.
         def ensure_full_data!
-          reload_gapi! unless data_complete?
-        end
-
-        def reload_gapi!
-          ensure_service!
-          gapi = service.get_table dataset_id, table_id
-          @gapi = gapi
+          reload! unless data_complete?
         end
 
         def data_complete?
           @gapi.is_a? Google::Apis::BigqueryV2::Table
         end
 
+        ##
+        # Supports views.
+        def udfs_gapi array_or_str
+          return [] if array_or_str.nil?
+          Array(array_or_str).map do |uri_or_code|
+            resource = Google::Apis::BigqueryV2::UserDefinedFunctionResource.new
+            if uri_or_code.start_with?("gs://")
+              resource.resource_uri = uri_or_code
+            else
+              resource.inline_code = uri_or_code
+            end
+            resource
+          end
+        end
+
         private
 
         def get_table_ref table