awswrangler.catalog.get_tables

awswrangler.catalog.get_tables(catalog_id: str | None = None, database: str | None = None, transaction_id: str | None = None, name_contains: str | None = None, name_prefix: str | None = None, name_suffix: str | None = None, boto3_session: Session | None = None) Any

Get an iterator of tables.

Note

Please, do not filter using name_contains and name_prefix/name_suffix at the same time. Only name_prefix and name_suffix can be combined together.

Note

This function has arguments which can be configured globally through wr.config or environment variables:

  • catalog_id

  • database

Check out the Global Configurations Tutorial for details.

Parameters:
  • catalog_id (str, optional) – The ID of the Data Catalog from which to retrieve Databases. If none is provided, the AWS account ID is used by default.

  • database (str, optional) – Database name.

  • transaction_id (str, optional) – The ID of the transaction (i.e. used with GOVERNED tables).

  • name_contains (str, optional) – Select by a specific string on table name

  • name_prefix (str, optional) – Select by a specific prefix on table name

  • name_suffix (str, optional) – Select by a specific suffix on table name

  • boto3_session (boto3.Session(), optional) – Boto3 Session. The default boto3 session will be used if boto3_session receive None.

Returns:

Iterator of tables.

Return type:

Iterator[Dict[str, Any]]

Examples

>>> import awswrangler as wr
>>> tables = wr.catalog.get_tables()