tableExists

指定された名前のテーブルまたはビューが存在するかどうかを確認します。これは一時的なビューでも、テーブル/ビューでも構いません。

構文

tableExists(tableName: str, dbName: str = None)

パラメーター

パラメーター	Type	説明
tableName	str	存在を確認するテーブルの名前。データベースが指定されていない場合は、まずtableNameマルチレイヤー名前空間識別子として扱い、必要に応じてtableName現在のデータベース内の通常のテーブル名として扱います。dbNameがNoneの場合、カタログ名で修飾できます。
dbName	文字列、オプション	テーブルの存在を確認するデータベースの名前。

戻り値

bool

テーブル／ビューが存在するかどうかを示します。

例

Python

# Check if a table is defined or not.
spark.catalog.tableExists("unexisting_table")
# False
_ = spark.sql("DROP TABLE IF EXISTS tbl1")
_ = spark.sql("CREATE TABLE tbl1 (name STRING, age INT) USING parquet")
spark.catalog.tableExists("tbl1")
# True

# Using the fully qualified names for tables.
spark.catalog.tableExists("default.tbl1")
# True
spark.catalog.tableExists("spark_catalog.default.tbl1")
# True
spark.catalog.tableExists("tbl1", "default")
# True
_ = spark.sql("DROP TABLE tbl1")

# Check if views exist.
spark.catalog.tableExists("view1")
# False
_ = spark.sql("CREATE VIEW view1 AS SELECT 1")
spark.catalog.tableExists("view1")
# True

# Check if temporary views exist.
_ = spark.sql("CREATE TEMPORARY VIEW view1 AS SELECT 1")
spark.catalog.tableExists("view1")
# True
df = spark.sql("DROP VIEW view1")
spark.catalog.tableExists("view1")
# False