tableExists

Verifique se existe a tabela ou vista com o nome especificado. Isto pode ser uma vista temporária ou uma tabela/vista.

Sintaxe

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

Parâmetros

Parâmetro Tipo Descrição
tableName str Nome da tabela para verificar a existência. Se não for especificada nenhuma base de dados, tente primeiro tratar tableName como um identificador de namespace multi-camada, depois tente tableName como um nome de tabela normal na base de dados atual, se necessário. Pode ser qualificado com o nome do catálogo quando dbName é Nenhum.
dbName STR, opcional Nome da base de dados para verificar a existência da tabela em.

Devoluções

bool

Indica se a tabela/vista existe.

Exemplos

# 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