try_to_file Fonction

S’applique à : Databricks SQL Databricks Runtime 18 LTS et versions ultérieures

Renvoie une FILE valeur qui fait référence au fichier à path, ou NULL si le fichier n’existe pas ou est inaccessible.

Syntax

try_to_file(path)

Arguments

• path: Une STRING expression spécifiant le chemin vers un fichier, par exemple un chemin dans un volume du catalogue Unity.

Returns

Une FILE valeur qui fait référence au fichier à path, ou NULL si le fichier n’existe pas ou est inaccessible.

Cette fonction est la version tolérante à l’erreur de lato_file fonction. Pour collecter les métadonnées des fichiers, Azure Databricks effectue un appel à distance vers l'emplacement de stockage du fichier. Si le fichier n’existe pas ou est inaccessible, cette fonction se raffiche NULL au lieu de générer une erreur.

Conditions d’erreur courantes

• TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Pour plus d’informations, voir Conditions d’erreur dans Azure Databricks.

Examples

Pour créer une FILE référence à partir d’un chemin dans un volume :

SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Si le chemin n’existe pas ou est inaccessible, try_to_file retourne NULL:

SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');

NULL

Fonctions associées

• to_file fonction
• create_file fonction
• copy_file fonction
• try_copy_file fonction
• TVF list_files
• TVF read_files
• Type FILE