Cloud Spanner V1 API - Class Google::Cloud::Spanner::V1::Mutation (v0.20.1)

Version 0.20.1

• 1.2.0 (latest)
• 1.1.0
• 1.0.2
• 0.27.0
• 0.26.0
• 0.25.0
• 0.24.0
• 0.23.0
• 0.22.2
• 0.21.0
• 0.20.1
• 0.19.0
• 0.18.0
• 0.17.0
• 0.16.0
• 0.15.1
• 0.14.1
• 0.13.0
• 0.12.0
• 0.11.0
• 0.10.0
• 0.9.0
• 0.8.1
• 0.7.4

Reference documentation and code samples for the Cloud Spanner V1 API class Google::Cloud::Spanner::V1::Mutation.

A modification to one or more Cloud Spanner rows. Mutations can be applied to a Cloud Spanner database by sending them in a Commit call.

Inherits

• Object

Extended By

• Google::Protobuf::MessageExts::ClassMethods

Includes

• Google::Protobuf::MessageExts

Methods

#delete

def delete() -> ::Google::Cloud::Spanner::V1::Mutation::Delete

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Delete) — Delete rows from a table. Succeeds whether or not the named rows were present.

#delete=

def delete=(value) -> ::Google::Cloud::Spanner::V1::Mutation::Delete

Parameter

• value (::Google::Cloud::Spanner::V1::Mutation::Delete) — Delete rows from a table. Succeeds whether or not the named rows were present.

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Delete) — Delete rows from a table. Succeeds whether or not the named rows were present.

#insert

def insert() -> ::Google::Cloud::Spanner::V1::Mutation::Write

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Insert new rows in a table. If any of the rows already exist, the write or transaction fails with error ALREADY_EXISTS.

#insert=

def insert=(value) -> ::Google::Cloud::Spanner::V1::Mutation::Write

Parameter

• value (::Google::Cloud::Spanner::V1::Mutation::Write) — Insert new rows in a table. If any of the rows already exist, the write or transaction fails with error ALREADY_EXISTS.

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Insert new rows in a table. If any of the rows already exist, the write or transaction fails with error ALREADY_EXISTS.

#insert_or_update

def insert_or_update() -> ::Google::Cloud::Spanner::V1::Mutation::Write

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, then its column values are overwritten with the ones provided. Any column values not explicitly written are preserved.

  When using insert_or_update, just as when using insert, all NOT NULL columns in the table must be given a value. This holds true even when the row already exists and will therefore actually be updated.

#insert_or_update=

def insert_or_update=(value) -> ::Google::Cloud::Spanner::V1::Mutation::Write

Parameter

• value (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, then its column values are overwritten with the ones provided. Any column values not explicitly written are preserved.

  When using insert_or_update, just as when using insert, all NOT NULL columns in the table must be given a value. This holds true even when the row already exists and will therefore actually be updated.

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, then its column values are overwritten with the ones provided. Any column values not explicitly written are preserved.

  When using insert_or_update, just as when using insert, all NOT NULL columns in the table must be given a value. This holds true even when the row already exists and will therefore actually be updated.

#replace

def replace() -> ::Google::Cloud::Spanner::V1::Mutation::Write

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, it is deleted, and the column values provided are inserted instead. Unlike insert_or_update, this means any values not explicitly written become NULL.

  In an interleaved table, if you create the child table with the ON DELETE CASCADE annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child rows before you replace the parent row.

#replace=

def replace=(value) -> ::Google::Cloud::Spanner::V1::Mutation::Write

Parameter

• value (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, it is deleted, and the column values provided are inserted instead. Unlike insert_or_update, this means any values not explicitly written become NULL.

  In an interleaved table, if you create the child table with the ON DELETE CASCADE annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child rows before you replace the parent row.

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Like insert, except that if the row already exists, it is deleted, and the column values provided are inserted instead. Unlike insert_or_update, this means any values not explicitly written become NULL.

  In an interleaved table, if you create the child table with the ON DELETE CASCADE annotation, then replacing a parent row also deletes the child rows. Otherwise, you must delete the child rows before you replace the parent row.

#update

def update() -> ::Google::Cloud::Spanner::V1::Mutation::Write

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Update existing rows in a table. If any of the rows does not already exist, the transaction fails with error NOT_FOUND.

#update=

def update=(value) -> ::Google::Cloud::Spanner::V1::Mutation::Write

Parameter

• value (::Google::Cloud::Spanner::V1::Mutation::Write) — Update existing rows in a table. If any of the rows does not already exist, the transaction fails with error NOT_FOUND.

Returns

• (::Google::Cloud::Spanner::V1::Mutation::Write) — Update existing rows in a table. If any of the rows does not already exist, the transaction fails with error NOT_FOUND.