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.

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

LakeFormation.Client.exceptions.InternalServiceException
LakeFormation.Client.exceptions.InvalidInputException
LakeFormation.Client.exceptions.OperationTimeoutException
LakeFormation.Client.exceptions.EntityNotFoundException
LakeFormation.Client.exceptions.TransactionCommittedException
LakeFormation.Client.exceptions.TransactionCanceledException
LakeFormation.Client.exceptions.TransactionCommitInProgressException
LakeFormation.Client.exceptions.ResourceNotReadyException
LakeFormation.Client.exceptions.ConcurrentModificationException