google-cloud-spanner 0.21.0

data/lib/google/spanner/v1/keys_pb.rb

@@ -0,0 +1,33 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/keys.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/protobuf/struct_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.KeyRange" do
+    oneof :start_key_type do
+      optional :start_closed, :message, 1, "google.protobuf.ListValue"
+      optional :start_open, :message, 2, "google.protobuf.ListValue"
+    end
+    oneof :end_key_type do
+      optional :end_closed, :message, 3, "google.protobuf.ListValue"
+      optional :end_open, :message, 4, "google.protobuf.ListValue"
+    end
+  end
+  add_message "google.spanner.v1.KeySet" do
+    repeated :keys, :message, 1, "google.protobuf.ListValue"
+    repeated :ranges, :message, 2, "google.spanner.v1.KeyRange"
+    optional :all, :bool, 3
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      KeyRange = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.KeyRange").msgclass
+      KeySet = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.KeySet").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/mutation_pb.rb

@@ -0,0 +1,38 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/mutation.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/protobuf/struct_pb'
+require 'google/spanner/v1/keys_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.Mutation" do
+    oneof :operation do
+      optional :insert, :message, 1, "google.spanner.v1.Mutation.Write"
+      optional :update, :message, 2, "google.spanner.v1.Mutation.Write"
+      optional :insert_or_update, :message, 3, "google.spanner.v1.Mutation.Write"
+      optional :replace, :message, 4, "google.spanner.v1.Mutation.Write"
+      optional :delete, :message, 5, "google.spanner.v1.Mutation.Delete"
+    end
+  end
+  add_message "google.spanner.v1.Mutation.Write" do
+    optional :table, :string, 1
+    repeated :columns, :string, 2
+    repeated :values, :message, 3, "google.protobuf.ListValue"
+  end
+  add_message "google.spanner.v1.Mutation.Delete" do
+    optional :table, :string, 1
+    optional :key_set, :message, 2, "google.spanner.v1.KeySet"
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      Mutation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Mutation").msgclass
+      Mutation::Write = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Mutation.Write").msgclass
+      Mutation::Delete = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Mutation.Delete").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/query_plan_pb.rb

@@ -0,0 +1,47 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/query_plan.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/protobuf/struct_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.PlanNode" do
+    optional :index, :int32, 1
+    optional :kind, :enum, 2, "google.spanner.v1.PlanNode.Kind"
+    optional :display_name, :string, 3
+    repeated :child_links, :message, 4, "google.spanner.v1.PlanNode.ChildLink"
+    optional :short_representation, :message, 5, "google.spanner.v1.PlanNode.ShortRepresentation"
+    optional :metadata, :message, 6, "google.protobuf.Struct"
+    optional :execution_stats, :message, 7, "google.protobuf.Struct"
+  end
+  add_message "google.spanner.v1.PlanNode.ChildLink" do
+    optional :child_index, :int32, 1
+    optional :type, :string, 2
+    optional :variable, :string, 3
+  end
+  add_message "google.spanner.v1.PlanNode.ShortRepresentation" do
+    optional :description, :string, 1
+    map :subqueries, :string, :int32, 2
+  end
+  add_enum "google.spanner.v1.PlanNode.Kind" do
+    value :KIND_UNSPECIFIED, 0
+    value :RELATIONAL, 1
+    value :SCALAR, 2
+  end
+  add_message "google.spanner.v1.QueryPlan" do
+    repeated :plan_nodes, :message, 1, "google.spanner.v1.PlanNode"
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      PlanNode = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.PlanNode").msgclass
+      PlanNode::ChildLink = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.PlanNode.ChildLink").msgclass
+      PlanNode::ShortRepresentation = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.PlanNode.ShortRepresentation").msgclass
+      PlanNode::Kind = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.PlanNode.Kind").enummodule
+      QueryPlan = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.QueryPlan").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/result_set_pb.rb

@@ -0,0 +1,43 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/result_set.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/protobuf/struct_pb'
+require 'google/spanner/v1/query_plan_pb'
+require 'google/spanner/v1/transaction_pb'
+require 'google/spanner/v1/type_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.ResultSet" do
+    optional :metadata, :message, 1, "google.spanner.v1.ResultSetMetadata"
+    repeated :rows, :message, 2, "google.protobuf.ListValue"
+    optional :stats, :message, 3, "google.spanner.v1.ResultSetStats"
+  end
+  add_message "google.spanner.v1.PartialResultSet" do
+    optional :metadata, :message, 1, "google.spanner.v1.ResultSetMetadata"
+    repeated :values, :message, 2, "google.protobuf.Value"
+    optional :chunked_value, :bool, 3
+    optional :resume_token, :bytes, 4
+    optional :stats, :message, 5, "google.spanner.v1.ResultSetStats"
+  end
+  add_message "google.spanner.v1.ResultSetMetadata" do
+    optional :row_type, :message, 1, "google.spanner.v1.StructType"
+    optional :transaction, :message, 2, "google.spanner.v1.Transaction"
+  end
+  add_message "google.spanner.v1.ResultSetStats" do
+    optional :query_plan, :message, 1, "google.spanner.v1.QueryPlan"
+    optional :query_stats, :message, 2, "google.protobuf.Struct"
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      ResultSet = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ResultSet").msgclass
+      PartialResultSet = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.PartialResultSet").msgclass
+      ResultSetMetadata = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ResultSetMetadata").msgclass
+      ResultSetStats = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ResultSetStats").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/spanner_pb.rb

@@ -0,0 +1,90 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/spanner.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/auth_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/struct_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/spanner/v1/keys_pb'
+require 'google/spanner/v1/mutation_pb'
+require 'google/spanner/v1/result_set_pb'
+require 'google/spanner/v1/transaction_pb'
+require 'google/spanner/v1/type_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.CreateSessionRequest" do
+    optional :database, :string, 1
+  end
+  add_message "google.spanner.v1.Session" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.v1.GetSessionRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.v1.DeleteSessionRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.spanner.v1.ExecuteSqlRequest" do
+    optional :session, :string, 1
+    optional :transaction, :message, 2, "google.spanner.v1.TransactionSelector"
+    optional :sql, :string, 3
+    optional :params, :message, 4, "google.protobuf.Struct"
+    map :param_types, :string, :message, 5, "google.spanner.v1.Type"
+    optional :resume_token, :bytes, 6
+    optional :query_mode, :enum, 7, "google.spanner.v1.ExecuteSqlRequest.QueryMode"
+  end
+  add_enum "google.spanner.v1.ExecuteSqlRequest.QueryMode" do
+    value :NORMAL, 0
+    value :PLAN, 1
+    value :PROFILE, 2
+  end
+  add_message "google.spanner.v1.ReadRequest" do
+    optional :session, :string, 1
+    optional :transaction, :message, 2, "google.spanner.v1.TransactionSelector"
+    optional :table, :string, 3
+    optional :index, :string, 4
+    repeated :columns, :string, 5
+    optional :key_set, :message, 6, "google.spanner.v1.KeySet"
+    optional :limit, :int64, 8
+    optional :resume_token, :bytes, 9
+  end
+  add_message "google.spanner.v1.BeginTransactionRequest" do
+    optional :session, :string, 1
+    optional :options, :message, 2, "google.spanner.v1.TransactionOptions"
+  end
+  add_message "google.spanner.v1.CommitRequest" do
+    optional :session, :string, 1
+    repeated :mutations, :message, 4, "google.spanner.v1.Mutation"
+    oneof :transaction do
+      optional :transaction_id, :bytes, 2
+      optional :single_use_transaction, :message, 3, "google.spanner.v1.TransactionOptions"
+    end
+  end
+  add_message "google.spanner.v1.CommitResponse" do
+    optional :commit_timestamp, :message, 1, "google.protobuf.Timestamp"
+  end
+  add_message "google.spanner.v1.RollbackRequest" do
+    optional :session, :string, 1
+    optional :transaction_id, :bytes, 2
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      CreateSessionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CreateSessionRequest").msgclass
+      Session = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Session").msgclass
+      GetSessionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.GetSessionRequest").msgclass
+      DeleteSessionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.DeleteSessionRequest").msgclass
+      ExecuteSqlRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ExecuteSqlRequest").msgclass
+      ExecuteSqlRequest::QueryMode = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ExecuteSqlRequest.QueryMode").enummodule
+      ReadRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.ReadRequest").msgclass
+      BeginTransactionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.BeginTransactionRequest").msgclass
+      CommitRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CommitRequest").msgclass
+      CommitResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.CommitResponse").msgclass
+      RollbackRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.RollbackRequest").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/spanner_services_pb.rb

@@ -0,0 +1,131 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/spanner/v1/spanner.proto for package 'google.spanner.v1'
+# Original file comments:
+# Copyright 2017 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'grpc'
+require 'google/spanner/v1/spanner_pb'
+
+module Google
+  module Spanner
+    module V1
+      module Spanner
+        # Cloud Spanner API
+        #
+        # The Cloud Spanner API can be used to manage sessions and execute
+        # transactions on data stored in Cloud Spanner databases.
+        class Service
+
+          include GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'google.spanner.v1.Spanner'
+
+          # Creates a new session. A session can be used to perform
+          # transactions that read and/or modify data in a Cloud Spanner database.
+          # Sessions are meant to be reused for many consecutive
+          # transactions.
+          #
+          # Sessions can only execute one transaction at a time. To execute
+          # multiple concurrent read-write/write-only transactions, create
+          # multiple sessions. Note that standalone reads and queries use a
+          # transaction internally, and count toward the one transaction
+          # limit.
+          #
+          # Cloud Spanner limits the number of sessions that can exist at any given
+          # time; thus, it is a good idea to delete idle and/or unneeded sessions.
+          # Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+          # operations are sent for more than an hour. If a session is deleted,
+          # requests to it return `NOT_FOUND`.
+          #
+          # Idle sessions can be kept alive by sending a trivial SQL query
+          # periodically, e.g., `"SELECT 1"`.
+          rpc :CreateSession, CreateSessionRequest, Session
+          # Gets a session. Returns `NOT_FOUND` if the session does not exist.
+          # This is mainly useful for determining whether a session is still
+          # alive.
+          rpc :GetSession, GetSessionRequest, Session
+          # Ends a session, releasing server resources associated with it.
+          rpc :DeleteSession, DeleteSessionRequest, Google::Protobuf::Empty
+          # Executes an SQL query, returning all rows in a single reply. This
+          # method cannot be used to return a result set larger than 10 MiB;
+          # if the query yields more data than that, the query fails with
+          # a `FAILED_PRECONDITION` error.
+          #
+          # Queries inside read-write transactions might return `ABORTED`. If
+          # this occurs, the application should restart the transaction from
+          # the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
+          #
+          # Larger result sets can be fetched in streaming fashion by calling
+          # [ExecuteStreamingSql][google.spanner.v1.Spanner.ExecuteStreamingSql] instead.
+          rpc :ExecuteSql, ExecuteSqlRequest, ResultSet
+          # Like [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], except returns the result
+          # set as a stream. Unlike [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql], there
+          # is no limit on the size of the returned result set. However, no
+          # individual row in the result set can exceed 100 MiB, and no
+          # column value can exceed 10 MiB.
+          rpc :ExecuteStreamingSql, ExecuteSqlRequest, stream(PartialResultSet)
+          # Reads rows from the database using key lookups and scans, as a
+          # simple key/value style alternative to
+          # [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql].  This method cannot be used to
+          # return a result set larger than 10 MiB; if the read matches more
+          # data than that, the read fails with a `FAILED_PRECONDITION`
+          # error.
+          #
+          # Reads inside read-write transactions might return `ABORTED`. If
+          # this occurs, the application should restart the transaction from
+          # the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
+          #
+          # Larger result sets can be yielded in streaming fashion by calling
+          # [StreamingRead][google.spanner.v1.Spanner.StreamingRead] instead.
+          rpc :Read, ReadRequest, ResultSet
+          # Like [Read][google.spanner.v1.Spanner.Read], except returns the result set as a
+          # stream. Unlike [Read][google.spanner.v1.Spanner.Read], there is no limit on the
+          # size of the returned result set. However, no individual row in
+          # the result set can exceed 100 MiB, and no column value can exceed
+          # 10 MiB.
+          rpc :StreamingRead, ReadRequest, stream(PartialResultSet)
+          # Begins a new transaction. This step can often be skipped:
+          # [Read][google.spanner.v1.Spanner.Read], [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] and
+          # [Commit][google.spanner.v1.Spanner.Commit] can begin a new transaction as a
+          # side-effect.
+          rpc :BeginTransaction, BeginTransactionRequest, Transaction
+          # Commits a transaction. The request includes the mutations to be
+          # applied to rows in the database.
+          #
+          # `Commit` might return an `ABORTED` error. This can occur at any time;
+          # commonly, the cause is conflicts with concurrent
+          # transactions. However, it can also happen for a variety of other
+          # reasons. If `Commit` returns `ABORTED`, the caller should re-attempt
+          # the transaction from the beginning, re-using the same session.
+          rpc :Commit, CommitRequest, CommitResponse
+          # Rolls back a transaction, releasing any locks it holds. It is a good
+          # idea to call this for any transaction that includes one or more
+          # [Read][google.spanner.v1.Spanner.Read] or [ExecuteSql][google.spanner.v1.Spanner.ExecuteSql] requests and
+          # ultimately decides not to commit.
+          #
+          # `Rollback` returns `OK` if it successfully aborts the transaction, the
+          # transaction was already aborted, or the transaction is not
+          # found. `Rollback` never returns `ABORTED`.
+          rpc :Rollback, RollbackRequest, Google::Protobuf::Empty
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

data/lib/google/spanner/v1/transaction_pb.rb

@@ -0,0 +1,51 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/transaction.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.TransactionOptions" do
+    oneof :mode do
+      optional :read_write, :message, 1, "google.spanner.v1.TransactionOptions.ReadWrite"
+      optional :read_only, :message, 2, "google.spanner.v1.TransactionOptions.ReadOnly"
+    end
+  end
+  add_message "google.spanner.v1.TransactionOptions.ReadWrite" do
+  end
+  add_message "google.spanner.v1.TransactionOptions.ReadOnly" do
+    optional :return_read_timestamp, :bool, 6
+    oneof :timestamp_bound do
+      optional :strong, :bool, 1
+      optional :min_read_timestamp, :message, 2, "google.protobuf.Timestamp"
+      optional :max_staleness, :message, 3, "google.protobuf.Duration"
+      optional :read_timestamp, :message, 4, "google.protobuf.Timestamp"
+      optional :exact_staleness, :message, 5, "google.protobuf.Duration"
+    end
+  end
+  add_message "google.spanner.v1.Transaction" do
+    optional :id, :bytes, 1
+    optional :read_timestamp, :message, 2, "google.protobuf.Timestamp"
+  end
+  add_message "google.spanner.v1.TransactionSelector" do
+    oneof :selector do
+      optional :single_use, :message, 1, "google.spanner.v1.TransactionOptions"
+      optional :id, :bytes, 2
+      optional :begin, :message, 3, "google.spanner.v1.TransactionOptions"
+    end
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      TransactionOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions").msgclass
+      TransactionOptions::ReadWrite = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.ReadWrite").msgclass
+      TransactionOptions::ReadOnly = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionOptions.ReadOnly").msgclass
+      Transaction = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Transaction").msgclass
+      TransactionSelector = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TransactionSelector").msgclass
+    end
+  end
+end

data/lib/google/spanner/v1/type_pb.rb

@@ -0,0 +1,43 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/spanner/v1/type.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_message "google.spanner.v1.Type" do
+    optional :code, :enum, 1, "google.spanner.v1.TypeCode"
+    optional :array_element_type, :message, 2, "google.spanner.v1.Type"
+    optional :struct_type, :message, 3, "google.spanner.v1.StructType"
+  end
+  add_message "google.spanner.v1.StructType" do
+    repeated :fields, :message, 1, "google.spanner.v1.StructType.Field"
+  end
+  add_message "google.spanner.v1.StructType.Field" do
+    optional :name, :string, 1
+    optional :type, :message, 2, "google.spanner.v1.Type"
+  end
+  add_enum "google.spanner.v1.TypeCode" do
+    value :TYPE_CODE_UNSPECIFIED, 0
+    value :BOOL, 1
+    value :INT64, 2
+    value :FLOAT64, 3
+    value :TIMESTAMP, 4
+    value :DATE, 5
+    value :STRING, 6
+    value :BYTES, 7
+    value :ARRAY, 8
+    value :STRUCT, 9
+  end
+end
+
+module Google
+  module Spanner
+    module V1
+      Type = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.Type").msgclass
+      StructType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType").msgclass
+      StructType::Field = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.StructType.Field").msgclass
+      TypeCode = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.spanner.v1.TypeCode").enummodule
+    end
+  end
+end