Class BaseBatch (2.17.0)

BaseBatch(client)

Accumulate write operations to be sent in a batch.

This has the same set of methods for write operations that xref_DocumentReference does, e.g. xref_create.

Parameter
Name	Description
`client`	`Client` The client that created this batch.

Methods

commit

commit()

Sends all accumulated write operations to the server. The details of this write depend on the implementing class.

create

create(
    reference: google.cloud.firestore_v1.base_document.BaseDocumentReference,
    document_data: dict,
) -> None

Add a "change" to this batch to create a document.

If the document given by reference already exists, then this batch will fail when commit-ed.

Parameters
Name	Description
`reference`	`DocumentReference` A document reference to be created in this batch.
`document_data`	`dict` Property names and values to use for creating a document.

delete

delete(
    reference: google.cloud.firestore_v1.base_document.BaseDocumentReference,
    option: typing.Optional[google.cloud.firestore_v1._helpers.WriteOption] = None,
) -> None

Add a "change" to delete a document.

See xref_delete for more information on how option determines how the change is applied.

Parameters
Name	Description
`reference`	`DocumentReference` A document reference that will be deleted in this batch.
`option`	`Optional[WriteOption]` A write option to make assertions / preconditions on the server state of the document before applying changes.

set

set(
    reference: google.cloud.firestore_v1.base_document.BaseDocumentReference,
    document_data: dict,
    merge: typing.Union[bool, list] = False,
) -> None

Add a "change" to replace a document.

See xref_set for more information on how option determines how the change is applied.

Parameters
Name	Description
`reference`	`DocumentReference` A document reference that will have values set in this batch.
`document_data`	`dict` Property names and values to use for replacing a document.
`merge`	`Optional[bool] or Optional[List` If True, apply merging instead of overwriting the state of the document.

update

update(
    reference: google.cloud.firestore_v1.base_document.BaseDocumentReference,
    field_updates: dict,
    option: typing.Optional[google.cloud.firestore_v1._helpers.WriteOption] = None,
) -> None

Add a "change" to update a document.

See xref_update for more information on field_updates and option.

Parameters
Name	Description
`reference`	`DocumentReference` A document reference that will be updated in this batch.
`field_updates`	`dict` Field names or paths to update and values to update with.
`option`	`Optional[WriteOption]` A write option to make assertions / preconditions on the server state of the document before applying changes.