google-cloud-datastore-v1 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c45c26b4609092449a125a9c82ea164e7a8cc8ae73dc4b221879fe2aec45d13e
-  data.tar.gz: d0949170d61b922ecde9f8ceda24e9d169afc6949b344e91c9d536d04aa50099
+  metadata.gz: 1ee86be8450c4c9fa93dde885e6123c02a1594bc3b7f6b91c54cb4c7e44ffb43
+  data.tar.gz: 625a108f4b7e8ccc7111ad56ab8a1aa373988ebf9cea13aec9f1a08226d3bd68
 SHA512:
-  metadata.gz: 7eee514105c9d4a2e2b98d5ff9948059d4c1b52f2770e2ad57843945f7dc89b8d61b383845125d7c1a070ddc2ae51c935db270237a90f7965657da0906698a94
-  data.tar.gz: ea3a3d81f08b5b8d7232405bae7e7f9ae53a01842121e6363f80e030749052bc186a3ea15fe07d076272541a392f67c753b7e3ab24fd27055e3fdbeecdcc1d67
+  metadata.gz: 7bc93332492ac570e2c652916c679d05e5d79eb0298fd29b4ea9fcb8a6f5f1afb9c6544db664aaf241c72f6093ae50e8b8afbaa3be0f13967887c2857401684f
+  data.tar.gz: 596052603a97f1bd5cda2986d7700f8e434b04173204be7b9303227f2d788b43ae5b58ffbb54cafe2f539ab142d50966f5f243ed1dfa30419497f3f0fb67196b

data/lib/google/cloud/datastore/v1/datastore/client.rb

@@ -589,7 +589,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, mutations: nil)
+            # @overload commit(project_id: nil, database_id: nil, mode: nil, transaction: nil, single_use_transaction: nil, mutations: nil)
             #   Pass arguments to `commit` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -607,6 +607,11 @@ module Google
             #     The identifier of the transaction associated with the commit. A
             #     transaction identifier is returned by a call to
             #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+            #   @param single_use_transaction [::Google::Cloud::Datastore::V1::TransactionOptions, ::Hash]
+            #     Options for beginning a new transaction for this request.
+            #     The transaction is committed when the request completes. If specified,
+            #     {::Google::Cloud::Datastore::V1::TransactionOptions TransactionOptions.mode} must be
+            #     {::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite TransactionOptions.ReadWrite}.
             #   @param mutations [::Array<::Google::Cloud::Datastore::V1::Mutation, ::Hash>]
             #     The mutations to perform.
             #

data/lib/google/cloud/datastore/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Datastore
       module V1
-        VERSION = "0.8.0"
+        VERSION = "0.10.0"
       end
     end
   end

data/lib/google/datastore/v1/datastore_pb.rb

@@ -24,6 +24,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :found, :message, 1, "google.datastore.v1.EntityResult"
       repeated :missing, :message, 2, "google.datastore.v1.EntityResult"
       repeated :deferred, :message, 3, "google.datastore.v1.Key"
+      optional :transaction, :bytes, 5
       optional :read_time, :message, 7, "google.protobuf.Timestamp"
     end
     add_message "google.datastore.v1.RunQueryRequest" do
@@ -39,6 +40,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.datastore.v1.RunQueryResponse" do
       optional :batch, :message, 1, "google.datastore.v1.QueryResultBatch"
       optional :query, :message, 2, "google.datastore.v1.Query"
+      optional :transaction, :bytes, 5
     end
     add_message "google.datastore.v1.RunAggregationQueryRequest" do
       optional :project_id, :string, 8
@@ -53,6 +55,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.datastore.v1.RunAggregationQueryResponse" do
       optional :batch, :message, 1, "google.datastore.v1.AggregationResultBatch"
       optional :query, :message, 2, "google.datastore.v1.AggregationQuery"
+      optional :transaction, :bytes, 5
     end
     add_message "google.datastore.v1.BeginTransactionRequest" do
       optional :project_id, :string, 8
@@ -76,6 +79,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :mutations, :message, 6, "google.datastore.v1.Mutation"
       oneof :transaction_selector do
         optional :transaction, :bytes, 1
+        optional :single_use_transaction, :message, 10, "google.datastore.v1.TransactionOptions"
       end
     end
     add_enum "google.datastore.v1.CommitRequest.Mode" do
@@ -118,6 +122,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.datastore.v1.MutationResult" do
       optional :key, :message, 3, "google.datastore.v1.Key"
       optional :version, :int64, 4
+      optional :create_time, :message, 7, "google.protobuf.Timestamp"
       optional :update_time, :message, 6, "google.protobuf.Timestamp"
       optional :conflict_detected, :bool, 5
     end
@@ -125,6 +130,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       oneof :consistency_type do
         optional :read_consistency, :enum, 1, "google.datastore.v1.ReadOptions.ReadConsistency"
         optional :transaction, :bytes, 2
+        optional :new_transaction, :message, 3, "google.datastore.v1.TransactionOptions"
         optional :read_time, :message, 4, "google.protobuf.Timestamp"
       end
     end

data/lib/google/datastore/v1/query_pb.rb

@@ -13,6 +13,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.datastore.v1.EntityResult" do
       optional :entity, :message, 1, "google.datastore.v1.Entity"
       optional :version, :int64, 4
+      optional :create_time, :message, 6, "google.protobuf.Timestamp"
       optional :update_time, :message, 5, "google.protobuf.Timestamp"
       optional :cursor, :bytes, 3
     end
@@ -79,6 +80,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_enum "google.datastore.v1.CompositeFilter.Operator" do
       value :OPERATOR_UNSPECIFIED, 0
       value :AND, 1
+      value :OR, 2
     end
     add_message "google.datastore.v1.PropertyFilter" do
       optional :property, :message, 1, "google.datastore.v1.PropertyReference"

data/proto_docs/google/datastore/v1/aggregation_result.rb

@@ -30,9 +30,10 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Datastore::V1::Value}]
         #     The result of the aggregation functions, ex: `COUNT(*) AS total_entities`.
         #
-        #     The key is the {::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation#alias alias}
-        #     assigned to the aggregation function on input and the size of this map
-        #     equals the number of aggregation functions in the query.
+        #     The key is the
+        #     {::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation#alias alias} assigned to
+        #     the aggregation function on input and the size of this map equals the
+        #     number of aggregation functions in the query.
         class AggregationResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/datastore/v1/datastore.rb

@@ -58,6 +58,15 @@ module Google
         #     A list of keys that were not looked up due to resource constraints. The
         #     order of results in this field is undefined and has no relation to the
         #     order of the keys in the input.
+        # @!attribute [rw] transaction
+        #   @return [::String]
+        #     The identifier of the transaction that was started as part of this Lookup
+        #     request.
+        #
+        #     Set only when
+        #     {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
+        #     was set in
+        #     {::Google::Cloud::Datastore::V1::LookupRequest#read_options LookupRequest.read_options}.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The time at which these entities were read or found missing.
@@ -104,6 +113,15 @@ module Google
         # @!attribute [rw] query
         #   @return [::Google::Cloud::Datastore::V1::Query]
         #     The parsed form of the `GqlQuery` from the request, if it was set.
+        # @!attribute [rw] transaction
+        #   @return [::String]
+        #     The identifier of the transaction that was started as part of this
+        #     RunQuery request.
+        #
+        #     Set only when
+        #     {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
+        #     was set in
+        #     {::Google::Cloud::Datastore::V1::RunQueryRequest#read_options RunQueryRequest.read_options}.
         class RunQueryResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -148,6 +166,15 @@ module Google
         # @!attribute [rw] query
         #   @return [::Google::Cloud::Datastore::V1::AggregationQuery]
         #     The parsed form of the `GqlQuery` from the request, if it was set.
+        # @!attribute [rw] transaction
+        #   @return [::String]
+        #     The identifier of the transaction that was started as part of this
+        #     RunAggregationQuery request.
+        #
+        #     Set only when
+        #     {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
+        #     was set in
+        #     {::Google::Cloud::Datastore::V1::RunAggregationQueryRequest#read_options RunAggregationQueryRequest.read_options}.
         class RunAggregationQueryResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -227,6 +254,12 @@ module Google
         #     The identifier of the transaction associated with the commit. A
         #     transaction identifier is returned by a call to
         #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+        # @!attribute [rw] single_use_transaction
+        #   @return [::Google::Cloud::Datastore::V1::TransactionOptions]
+        #     Options for beginning a new transaction for this request.
+        #     The transaction is committed when the request completes. If specified,
+        #     {::Google::Cloud::Datastore::V1::TransactionOptions TransactionOptions.mode} must be
+        #     {::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite TransactionOptions.ReadWrite}.
         # @!attribute [rw] mutations
         #   @return [::Array<::Google::Cloud::Datastore::V1::Mutation>]
         #     The mutations to perform.
@@ -380,6 +413,9 @@ module Google
         #     be the version of the current entity or, if no entity is present, a version
         #     that is strictly greater than the version of any previous entity and less
         #     than the version of any possible future entity.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The create time of the entity. This field will not be set after a 'delete'.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The update time of the entity on the server after processing the mutation.
@@ -404,6 +440,15 @@ module Google
         #     The identifier of the transaction in which to read. A
         #     transaction identifier is returned by a call to
         #     {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}.
+        # @!attribute [rw] new_transaction
+        #   @return [::Google::Cloud::Datastore::V1::TransactionOptions]
+        #     Options for beginning a new transaction for this request.
+        #
+        #     The new transaction identifier will be returned in the corresponding
+        #     response as either
+        #     {::Google::Cloud::Datastore::V1::LookupResponse#transaction LookupResponse.transaction}
+        #     or
+        #     {::Google::Cloud::Datastore::V1::RunQueryResponse#transaction RunQueryResponse.transaction}.
         # @!attribute [rw] read_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Reads entities as they were at the given time. This may not be older
@@ -431,7 +476,7 @@ module Google
         # Transactions can be created explicitly with calls to
         # {::Google::Cloud::Datastore::V1::Datastore::Client#begin_transaction Datastore.BeginTransaction}
         # or implicitly by setting
-        # [ReadOptions.new_transaction][google.datastore.v1.ReadOptions.new_transaction]
+        # {::Google::Cloud::Datastore::V1::ReadOptions#new_transaction ReadOptions.new_transaction}
         # in read requests.
         # @!attribute [rw] read_write
         #   @return [::Google::Cloud::Datastore::V1::TransactionOptions::ReadWrite]

data/proto_docs/google/datastore/v1/entity.rb

@@ -39,7 +39,8 @@ module Google
         #
         # Foreign partition IDs (in which the project ID does
         # not match the context project ID ) are discouraged.
-        # Reads and writes of foreign partition IDs may fail if the project is not in an active state.
+        # Reads and writes of foreign partition IDs may fail if the project is not in
+        # an active state.
         # @!attribute [rw] project_id
         #   @return [::String]
         #     The ID of the project to which the entities belong.
@@ -160,8 +161,8 @@ module Google
         # @!attribute [rw] string_value
         #   @return [::String]
         #     A UTF-8 encoded string value.
-        #     When `exclude_from_indexes` is false (it is indexed) , may have at most 1500 bytes.
-        #     Otherwise, may be set to at most 1,000,000 bytes.
+        #     When `exclude_from_indexes` is false (it is indexed) , may have at most
+        #     1500 bytes. Otherwise, may be set to at most 1,000,000 bytes.
         # @!attribute [rw] blob_value
         #   @return [::String]
         #     A blob value.

data/proto_docs/google/datastore/v1/query.rb

@@ -30,17 +30,23 @@ module Google
         #     The version of the entity, a strictly positive number that monotonically
         #     increases with changes to the entity.
         #
-        #     This field is set for {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity
-        #     results.
+        #     This field is set for
+        #     {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity results.
         #
-        #     For {::Google::Cloud::Datastore::V1::LookupResponse#missing missing} entities in `LookupResponse`, this
-        #     is the version of the snapshot that was used to look up the entity, and it
-        #     is always set except for eventually consistent reads.
+        #     For {::Google::Cloud::Datastore::V1::LookupResponse#missing missing} entities in
+        #     `LookupResponse`, this is the version of the snapshot that was used to look
+        #     up the entity, and it is always set except for eventually consistent reads.
+        # @!attribute [rw] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time at which the entity was created.
+        #     This field is set for
+        #     {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity results.
+        #     If this entity is missing, this field will not be set.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The time at which the entity was last changed.
-        #     This field is set for {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity
-        #     results.
+        #     This field is set for
+        #     {::Google::Cloud::Datastore::V1::EntityResult::ResultType::FULL `FULL`} entity results.
         #     If this entity is missing, this field will not be set.
         # @!attribute [rw] cursor
         #   @return [::String]
@@ -116,13 +122,15 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Datastore query for running an aggregation over a {::Google::Cloud::Datastore::V1::Query Query}.
+        # Datastore query for running an aggregation over a
+        # {::Google::Cloud::Datastore::V1::Query Query}.
         # @!attribute [rw] nested_query
         #   @return [::Google::Cloud::Datastore::V1::Query]
         #     Nested query for aggregation
         # @!attribute [rw] aggregations
         #   @return [::Array<::Google::Cloud::Datastore::V1::AggregationQuery::Aggregation>]
-        #     Optional. Series of aggregations to apply over the results of the `nested_query`.
+        #     Optional. Series of aggregations to apply over the results of the
+        #     `nested_query`.
         #
         #     Requires:
         #
@@ -137,7 +145,8 @@ module Google
           #     Count aggregator.
           # @!attribute [rw] alias
           #   @return [::String]
-          #     Optional. Optional name of the property to store the result of the aggregation.
+          #     Optional. Optional name of the property to store the result of the
+          #     aggregation.
           #
           #     If not provided, Datastore will pick a default name following the format
           #     `property_<incremental_id++>`. For example:
@@ -169,7 +178,8 @@ module Google
           #     Requires:
           #
           #     * Must be unique across all aggregation aliases.
-          #     * Conform to {::Google::Cloud::Datastore::V1::Entity#properties entity property name} limitations.
+          #     * Conform to [entity property
+          #     name][google.datastore.v1.Entity.properties] limitations.
           class Aggregation
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -180,7 +190,8 @@ module Google
             # so it does not require a field reference.
             # @!attribute [rw] up_to
             #   @return [::Google::Protobuf::Int64Value]
-            #     Optional. Optional constraint on the maximum number of entities to count.
+            #     Optional. Optional constraint on the maximum number of entities to
+            #     count.
             #
             #     This provides a way to set an upper bound on the number of entities
             #     to scan, limiting latency and cost.
@@ -292,6 +303,9 @@ module Google
 
             # The results are required to satisfy each of the combined filters.
             AND = 1
+
+            # Documents are required to satisfy at least one of the combined filters.
+            OR = 2
           end
         end
 
@@ -366,6 +380,7 @@ module Google
             # Requires:
             #
             # * That `value` is an entity key.
+            # * No other `HAS_ANCESTOR` is in the same query.
             HAS_ANCESTOR = 11
 
             # The value of the `property` is not in the given array.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-datastore-v1
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-16 00:00:00.000000000 Z
+date: 2023-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 0.17.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -50,14 +50,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.26.1
+        version: 1.26.3
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement