awswrangler.catalog.does_table_exist

awswrangler.catalog.does_table_exist(database: str, table: str, boto3_session: Optional[Session] = None, catalog_id: Optional[str] = None, transaction_id: Optional[str] = None) Any

Check if the table exists.

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
  • database (str) – Database name.

  • table (str) – Table name.

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

  • 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.

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

Returns

True if exists, otherwise False.

Return type

bool

Examples

>>> import awswrangler as wr
>>> wr.catalog.does_table_exist(database='default', table='my_table')