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.

Retourne une FILE valeur qui fait référence au fichier en path.

Syntax

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 en path.

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, Azure Databricks génère une erreur. Pour revenir NULL à la place, utilisez try_to_file fonction.

Conditions d’erreur courantes

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • 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 to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Si le chemin n’existe pas ou si l’utilisateur n’a pas la permission de lecture, to_file cela génère une erreur :

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on