檢查是否存在指定名稱的表格或視圖。 這可以是暫時視圖或表格/視圖。
語法
tableExists(tableName: str, dbName: str = None)
參數
| 參數 | 類型 | 說明 |
|---|---|---|
tableName |
str | 表格名稱用來檢查存在性。 若未指定資料庫,先嘗試將多層命名空間識別碼視為 tableName ,必要時再嘗試 tableName 作為當前資料庫中的一般資料表名稱。 當 dbName 為 None 時,可以用目錄名稱來篩選。 |
dbName |
力量,選用 | 用來檢查資料表存在的資料庫名稱。 |
退貨
bool
用來表示該表格/視圖是否存在。
Examples
# 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