try_to_file Fonction

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

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

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
  • Last updated on