to_file-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 18 LTS and above

Important

Dieses Feature befindet sich in der Betaversion. Arbeitsbereichsadministratoren können den Zugriff auf dieses Feature über die Vorschauseite steuern. Siehe Manage Azure Databricks Previews.

Gibt einen FILE Wert zurück, der auf die Datei bei pathverweist.

Syntax

to_file(path)

Arguments

  • path: Ein Ausdruck, der STRING den Pfad zu einer Datei angibt. Zum Beispiel ein Pfad in einem Unity-Katalog-Volume.

Rückkehr

Ein FILE Wert, der auf die Datei bei pathverweist.

Um Dateimetadaten zu sammeln, führt Azure Databricks einen Fernaufruf zum Speicherort der Datei vor. Wenn die Datei nicht existiert oder nicht zugänglich ist, löst Azure Databricks einen Fehler aus. Um zurückzukehren NULL , verwenden try_to_file Sie stattdessen Funktion.

Häufige Fehlerbedingungen

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Weitere Informationen finden Sie unter Fehlerbedingungen in Azure Databricks.

Examples

Um eine FILE Referenz aus einem Pfad in einem Volume zu erstellen:

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

Wenn der Pfad nicht existiert oder dem Benutzer die Leseberechtigung fehlt, to_file wird ein Fehler ausgelöst:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on