snowflake.snowpark.catalog.Catalog.get_table

Catalog.get_table(table_name: str, *, database: Optional[Union[str, DatabaseModel]] = None, schema: Optional[Union[str, SchemaModel]] = None) → Union[Table, View][source]

Get the table or permanent view by name in the given database and schema.

If database or schema are not provided, resolve the name in the current database and schema. Matches pyspark.sql.Catalog.getTable(), which returns metadata for base tables and for views.

When context._is_snowpark_connect_compatible_mode is False (legacy REST path), only base tables are returned; use get_view() for views.

Parameters:
  • table_name – name of the table or view.

  • database – database name or Database object. Defaults to None.

  • schema – schema name or Schema object. Defaults to None.