LakeFormation / Client / update_table_objects

update_table_objects#

LakeFormation.Client.update_table_objects(**kwargs)#

Updates the manifest of Amazon S3 objects that make up the specified governed table.

See also: AWS API Documentation

Request Syntax

response = client.update_table_objects(
    CatalogId='string',
    DatabaseName='string',
    TableName='string',
    TransactionId='string',
    WriteOperations=[
        {
            'AddObject': {
                'Uri': 'string',
                'ETag': 'string',
                'Size': 123,
                'PartitionValues': [
                    'string',
                ]
            },
            'DeleteObject': {
                'Uri': 'string',
                'ETag': 'string',
                'PartitionValues': [
                    'string',
                ]
            }
        },
    ]
)
Parameters:

  • CatalogId (string) – The catalog containing the governed table to update. Defaults to the caller’s account ID.

  • DatabaseName (string) –

    [REQUIRED]

    The database containing the governed table to update.

  • TableName (string) –

    [REQUIRED]

    The governed table to update.

  • TransactionId (string) – The transaction at which to do the write.

  • WriteOperations (list) –

    [REQUIRED]

    A list of WriteOperation objects that define an object to add to or delete from the manifest for a governed table.

    • (dict) –

      Defines an object to add to or delete from a governed table.

      • AddObject (dict) –

        A new object to add to the governed table.

        • Uri (string) – [REQUIRED]

          The Amazon S3 location of the object.

        • ETag (string) – [REQUIRED]

          The Amazon S3 ETag of the object. Returned by GetTableObjects for validation and used to identify changes to the underlying data.

        • Size (integer) – [REQUIRED]

          The size of the Amazon S3 object in bytes.

        • PartitionValues (list) –

          A list of partition values for the object. A value must be specified for each partition key associated with the table.

          The supported data types are integer, long, date(yyyy-MM-dd), timestamp(yyyy-MM-dd HH:mm:ssXXX or yyyy-MM-dd HH:mm:ss”), string and decimal.

          • (string) –

      • DeleteObject (dict) –

        An object to delete from the governed table.

        • Uri (string) – [REQUIRED]

          The Amazon S3 location of the object to delete.

        • ETag (string) –

          The Amazon S3 ETag of the object. Returned by GetTableObjects for validation and used to identify changes to the underlying data.

        • PartitionValues (list) –

          A list of partition values for the object. A value must be specified for each partition key associated with the governed table.

          • (string) –

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions