指定した名前のテーブルまたはビューが存在するかどうかを確認します。 これは、一時ビューまたはテーブル/ビューのいずれかです。
構文
tableExists(tableName: str, dbName: str = None)
パラメーター
| パラメーター | タイプ | 説明 |
|---|---|---|
tableName |
str | 存在を確認するテーブルの名前。 データベースが指定されていない場合は、最初に tableName を多層名前空間識別子として扱い、必要に応じて現在のデータベースで通常のテーブル名として tableName してみてください。
dbNameが None の場合、カタログ名で修飾できます。 |
dbName |
str、省略可能 | テーブルの存在を確認するデータベースの名前。 |
返品
bool
テーブル/ビューが存在するかどうかを示します。
例示
# 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