Class: Google::Datastore::V1::CommitRequest

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/datastore/v1/doc/google/datastore/v1/datastore.rb

Overview

The request for Datastore::Commit.

Defined Under Namespace

Modules: Mode

Instance Attribute Summary collapse

Instance Attribute Details

#mode ⇒ Google::Datastore::V1::CommitRequest::Mode

Returns The type of commit to perform. Defaults to +TRANSACTIONAL+.

Returns:



145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/google/cloud/datastore/v1/doc/google/datastore/v1/datastore.rb', line 145

class CommitRequest
  # The modes available for commits.
  module Mode
    # Unspecified. This value must not be used.
    MODE_UNSPECIFIED = 0

    # Transactional: The mutations are either all applied, or none are applied.
    # Learn about transactions [here](https://cloud.google.com/datastore/docs/concepts/transactions).
    TRANSACTIONAL = 1

    # Non-transactional: The mutations may not apply as all or none.
    NON_TRANSACTIONAL = 2
  end
end

#mutations ⇒ Array<Google::Datastore::V1::Mutation>

Returns The mutations to perform.

When mode is +TRANSACTIONAL+, mutations affecting a single entity are applied in order. The following sequences of mutations affecting a single entity are not permitted in a single +Commit+ request:

  • +insert+ followed by +insert+
  • +update+ followed by +insert+
  • +upsert+ followed by +insert+
  • +delete+ followed by +update+

When mode is +NON_TRANSACTIONAL+, no two mutations may affect a single entity.

Returns:

  • (Array<Google::Datastore::V1::Mutation>) —

    The mutations to perform.

    When mode is +TRANSACTIONAL+, mutations affecting a single entity are applied in order. The following sequences of mutations affecting a single entity are not permitted in a single +Commit+ request:

    • +insert+ followed by +insert+
    • +update+ followed by +insert+
    • +upsert+ followed by +insert+
    • +delete+ followed by +update+

    When mode is +NON_TRANSACTIONAL+, no two mutations may affect a single entity.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/google/cloud/datastore/v1/doc/google/datastore/v1/datastore.rb', line 145

class CommitRequest
  # The modes available for commits.
  module Mode
    # Unspecified. This value must not be used.
    MODE_UNSPECIFIED = 0

    # Transactional: The mutations are either all applied, or none are applied.
    # Learn about transactions [here](https://cloud.google.com/datastore/docs/concepts/transactions).
    TRANSACTIONAL = 1

    # Non-transactional: The mutations may not apply as all or none.
    NON_TRANSACTIONAL = 2
  end
end

#project_id ⇒ String

Returns The ID of the project against which to make the request.

Returns:

  • (String) —

    The ID of the project against which to make the request.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/google/cloud/datastore/v1/doc/google/datastore/v1/datastore.rb', line 145

class CommitRequest
  # The modes available for commits.
  module Mode
    # Unspecified. This value must not be used.
    MODE_UNSPECIFIED = 0

    # Transactional: The mutations are either all applied, or none are applied.
    # Learn about transactions [here](https://cloud.google.com/datastore/docs/concepts/transactions).
    TRANSACTIONAL = 1

    # Non-transactional: The mutations may not apply as all or none.
    NON_TRANSACTIONAL = 2
  end
end

#transaction ⇒ String

Returns The identifier of the transaction associated with the commit. A transaction identifier is returned by a call to Datastore::BeginTransaction.

Returns:

  • (String) —

    The identifier of the transaction associated with the commit. A transaction identifier is returned by a call to Datastore::BeginTransaction.



145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'lib/google/cloud/datastore/v1/doc/google/datastore/v1/datastore.rb', line 145

class CommitRequest
  # The modes available for commits.
  module Mode
    # Unspecified. This value must not be used.
    MODE_UNSPECIFIED = 0

    # Transactional: The mutations are either all applied, or none are applied.
    # Learn about transactions [here](https://cloud.google.com/datastore/docs/concepts/transactions).
    TRANSACTIONAL = 1

    # Non-transactional: The mutations may not apply as all or none.
    NON_TRANSACTIONAL = 2
  end
end