Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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)
Paramètres
| Paramètre | Type | Description |
|---|---|---|
tableName |
str | Nom de la table pour vérifier l’existence. Si aucune base de données n’est spécifiée, essayez d’abord de traiter tableName comme un identificateur d’espace de noms multicouche, puis essayez tableName comme un nom de table normal dans la base de données active si nécessaire. Peut être qualifié avec le nom du catalogue lorsqu’il dbName s’agit de None. |
dbName |
str, facultatif | Nom de la base de données dans laquelle vérifier l’existence de la table. |
Retours
bool
Indiquant si la table/vue existe.
Exemples
# 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