Delete Objects On Cancel

lakeformation_delete_objects_on_cancel

R Documentation

For a specific governed table, provides a list of Amazon S3 objects that will be written during the current transaction and that can be automatically deleted if the transaction is canceled

Description

For a specific governed table, provides a list of Amazon S3 objects that will be written during the current transaction and that can be automatically deleted if the transaction is canceled. Without this call, no Amazon S3 objects are automatically deleted when a transaction cancels.

The Glue ETL library function write_dynamic_frame.from_catalog() includes an option to automatically call delete_objects_on_cancel before writes. For more information, see Rolling Back Amazon S3 Writes.

Usage

lakeformation_delete_objects_on_cancel(CatalogId, DatabaseName,
  TableName, TransactionId, Objects)

Arguments

CatalogId

The Glue data catalog that contains the governed table. Defaults to the current account ID.

DatabaseName

[required] The database that contains the governed table.

TableName

[required] The name of the governed table.

TransactionId

[required] ID of the transaction that the writes occur in.

Objects

[required] A list of VirtualObject structures, which indicates the Amazon S3 objects to be deleted if the transaction cancels.

Value

An empty list.

Request syntax

svc$delete_objects_on_cancel(
  CatalogId = "string",
  DatabaseName = "string",
  TableName = "string",
  TransactionId = "string",
  Objects = list(
    list(
      Uri = "string",
      ETag = "string"
    )
  )
)