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

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

#delete=

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

#insert

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

#insert=

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

#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

#update=

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