getTable

获取具有指定名称的表或视图。 此表可以是临时视图或表/视图。 这会在找不到表时引发 AnalysisException

Syntax

getTable(tableName: str)

参数

参数 类型 Description
tableName str 要获取的表的名称。 可以使用目录名称进行限定。

退货

Table

按名称找到的表。

示例

_ = spark.sql("DROP TABLE IF EXISTS tbl1")
_ = spark.sql("CREATE TABLE tbl1 (name STRING, age INT) USING parquet")
spark.catalog.getTable("tbl1")
# Table(name='tbl1', catalog='spark_catalog', namespace=['default'], ...

# Using the fully qualified name with the catalog name.
spark.catalog.getTable("default.tbl1")
# Table(name='tbl1', catalog='spark_catalog', namespace=['default'], ...
spark.catalog.getTable("spark_catalog.default.tbl1")
# Table(name='tbl1', catalog='spark_catalog', namespace=['default'], ...
_ = spark.sql("DROP TABLE tbl1")

# Throw an analysis exception when the table does not exist.
spark.catalog.getTable("tbl1")
# Traceback (most recent call last):
# ...
# AnalysisException: ...