awswrangler.catalog.search_tables

awswrangler.catalog.search_tables(text: str, catalog_id: str | None = None, boto3_session: Session | None = None) → Iterator[dict[str, Any]]

Get Pandas DataFrame of tables filtered by a search string.

Parameters:

  • text (str) – Select only tables with the given string in table’s properties.

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

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

Return type:

Iterator[dict[str, Any]]

Returns:

Iterator of tables.

Examples

>>> import awswrangler as wr
>>> df_tables = wr.catalog.search_tables(text='my_property')