S3Tables / Client / update_table_metadata_location

update_table_metadata_location#

S3Tables.Client.update_table_metadata_location(**kwargs)#

Updates the metadata location for a table. The metadata location of a table must be an S3 URI that begins with the table’s warehouse location. The metadata location for an Apache Iceberg table must end with .metadata.json, or if the metadata file is Gzip-compressed, .metadata.json.gz.

Permissions

You must have the s3tables:UpdateTableMetadataLocation permission to use this operation.

See also: AWS API Documentation

Request Syntax

response = client.update_table_metadata_location(
    tableBucketARN='string',
    namespace='string',
    name='string',
    versionToken='string',
    metadataLocation='string'
)
Parameters:

  • tableBucketARN (string) –

    [REQUIRED]

    The Amazon Resource Name (ARN) of the table bucket.

  • namespace (string) –

    [REQUIRED]

    The namespace of the table.

  • name (string) –

    [REQUIRED]

    The name of the table.

  • versionToken (string) –

    [REQUIRED]

    The version token of the table.

  • metadataLocation (string) –

    [REQUIRED]

    The new metadata location for the table.

Return type:

dict

Returns:

Response Syntax

{
    'name': 'string',
    'tableARN': 'string',
    'namespace': [
        'string',
    ],
    'versionToken': 'string',
    'metadataLocation': 'string'
}

Response Structure

  • (dict) –

    • name (string) –

      The name of the table.

    • tableARN (string) –

      The Amazon Resource Name (ARN) of the table.

    • namespace (list) –

      The namespace the table is associated with.

      • (string) –

    • versionToken (string) –

      The version token of the table.

    • metadataLocation (string) –

      The metadata location of the table.

Exceptions