Gettable

指定した名前のテーブルまたはビューを取得します。 このテーブルには、一時ビューまたはテーブル/ビューを指定できます。 これにより、テーブルが見つからないときに AnalysisException がスローされます。

構文

getTable(tableName: str)

パラメーター

パラメーター タイプ 説明
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: ...