Skip to content

GetTablesRequest

Source code in docs_src/capo_glue/types/get_tables_request.py
class GetTablesRequest(TypedDict, closed=True):
    catalog_id: NotRequired["capo_glue.types.catalog_id_string.CatalogIdString"]
    """<p>The ID of the Data Catalog where the tables reside. If none is provided, the Amazon Web Services account ID is used by default.</p>"""
    database_name: "capo_glue.types.name_string.NameString"
    """<p>The database in the catalog whose tables to list. For Hive compatibility, this name is entirely lowercase.</p>"""
    expression: NotRequired["capo_glue.types.filter_string.FilterString"]
    """<p>A regular expression pattern. If present, only those tables whose names match the pattern are returned.</p>"""
    next_token: NotRequired["capo_glue.types.token.Token"]
    """<p>A continuation token, included if this is a continuation call.</p>"""
    max_results: NotRequired[
        "capo_glue.types.catalog_getter_page_size.CatalogGetterPageSize"
    ]
    """<p>The maximum number of tables to return in a single response.</p>"""
    transaction_id: NotRequired[
        "capo_glue.types.transaction_id_string.TransactionIdString"
    ]
    """<p>The transaction ID at which to read the table contents.</p>"""
    query_as_of_time: NotRequired["capo_glue.types.timestamp.Timestamp"]
    """<p>The time as of when to read the table contents. If not set, the most recent transaction commit time will be used. Cannot be specified along with <code>TransactionId</code>.</p>"""
    audit_context: NotRequired["capo_glue.types.audit_context.AuditContext"]
    """<p>A structure containing the Lake Formation <a href="https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html">audit context</a>.</p>"""
    resource_share_type: NotRequired[
        "capo_glue.types.table_resource_share_type.TableResourceShareType"
    ]
    """<p>Specifies which tables the <code>GetTables</code> call returns. The allowable values are <code>FEDERATED</code> or <code>ALL</code>. </p> <ul> <li> <p>If set to <code>FEDERATED</code>, returns only federated tables, which reference an entity outside the Glue Data Catalog.</p> </li> <li> <p>If set to <code>ALL</code>, returns all tables in the database, both federated and non-federated. </p> </li> </ul>"""
    include_status_details: NotRequired[
        "capo_glue.types.boolean_nullable.BooleanNullable"
    ]
    """<p>Specifies whether to include status details related to a request to create or update an Glue Data Catalog view.</p>"""
    attributes_to_get: NotRequired[
        "capo_glue.types.table_attributes_list.TableAttributesList"
    ]
    """<p> Specifies the table fields returned by the <code>GetTables</code> call. This parameter doesn’t accept an empty list. The request must include <code>NAME</code>.</p> <p>The following are the valid combinations of values:</p> <ul> <li> <p> <code>NAME</code> - Names of all tables in the database.</p> </li> <li> <p> <code>NAME</code>, <code>TABLE_TYPE</code> - Names of all tables and the table types.</p> </li> </ul>"""

attributes_to_get instance-attribute

attributes_to_get: NotRequired[TableAttributesList]

Specifies the table fields returned by the GetTables call. This parameter doesn’t accept an empty list. The request must include NAME.

The following are the valid combinations of values:

  • NAME - Names of all tables in the database.

  • NAME, TABLE_TYPE - Names of all tables and the table types.

audit_context instance-attribute

audit_context: NotRequired[AuditContext]

A structure containing the Lake Formation audit context.

catalog_id instance-attribute

catalog_id: NotRequired[CatalogIdString]

The ID of the Data Catalog where the tables reside. If none is provided, the Amazon Web Services account ID is used by default.

database_name instance-attribute

database_name: NameString

The database in the catalog whose tables to list. For Hive compatibility, this name is entirely lowercase.

expression instance-attribute

expression: NotRequired[FilterString]

A regular expression pattern. If present, only those tables whose names match the pattern are returned.

include_status_details instance-attribute

include_status_details: NotRequired[BooleanNullable]

Specifies whether to include status details related to a request to create or update an Glue Data Catalog view.

max_results instance-attribute

max_results: NotRequired[CatalogGetterPageSize]

The maximum number of tables to return in a single response.

next_token instance-attribute

next_token: NotRequired[Token]

A continuation token, included if this is a continuation call.

query_as_of_time instance-attribute

query_as_of_time: NotRequired[Timestamp]

The time as of when to read the table contents. If not set, the most recent transaction commit time will be used. Cannot be specified along with TransactionId.

resource_share_type instance-attribute

resource_share_type: NotRequired[TableResourceShareType]

Specifies which tables the GetTables call returns. The allowable values are FEDERATED or ALL.

  • If set to FEDERATED, returns only federated tables, which reference an entity outside the Glue Data Catalog.

  • If set to ALL, returns all tables in the database, both federated and non-federated.

transaction_id instance-attribute

transaction_id: NotRequired[TransactionIdString]

The transaction ID at which to read the table contents.