tableExists

Vérifiez si la table ou la vue portant le nom spécifié existe. Il peut s’agir d’une vue temporaire ou d’une table/vue.

Syntaxe

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

parameter

parameter	Type	Description
tableName	str	Nom de la table à vérifier l'existence. Si aucune base de données n'est spécifiée, essayez d'abord de traiter tableName comme un identifiant d'espace de noms multicouche, puis essayez tableName comme un nom de table normal dans la base de données actuelle si nécessaire. Peut être qualifié avec le nom du catalogue lorsque dbName est Aucun.
dbName	str, facultatif	Nom de la base de données dans laquelle vérifier l'existence de la table.

parameter	Type	Description
tableName	str	Nom de la table à vérifier l'existence. Si aucune base de données n'est spécifiée, essayez d'abord de traiter tableName comme un identifiant d'espace de noms multicouche, puis essayez tableName comme un nom de table normal dans la base de données actuelle si nécessaire. Peut être qualifié avec le nom du catalogue lorsque dbName est Aucun.
dbName	str, facultatif	Nom de la base de données dans laquelle vérifier l'existence de la table.

Renvoie

bool

Indique si la table/vue existe.

Exemples

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