Condividi tramite


tableExists

Controllare se la tabella o la vista con il nome specificato esiste. Può trattarsi di una vista temporanea o di una tabella/vista.

Sintassi

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

Parametri

Parametro Tipo Descrizione
tableName str Nome della tabella per verificare l'esistenza. Se non viene specificato alcun database, provare prima a trattare tableName come identificatore dello spazio dei nomi multi-layer, quindi provare tableName a usare un normale nome di tabella nel database corrente, se necessario. Può essere qualificato con il nome del catalogo quando dbName è Nessuno.
dbName str, facoltativo Nome del database in cui verificare l'esistenza della tabella.

Restituzioni

bool

Indica se la tabella/vista esiste.

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