try_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, oder NULL wenn die Datei nicht existiert oder nicht zugänglich ist.

Syntax

try_to_file(path)

Arguments

  • path: Ein Ausdruck, der STRING den Pfad zu einer Datei angibt, zum Beispiel einen Pfad in einem Unity-Catalog-Volume.

Rückkehr

Ein FILE Wert, der auf die Datei bei pathverweist, oder NULL wenn die Datei nicht existiert oder nicht zugänglich ist.

Diese Funktion ist die fehlertolerante Version der to_file Funktion. 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, gibt diese Funktion statt eines Fehlers zurück.NULL

Häufige Fehlerbedingungen

  • 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 try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');

Wenn der Pfad nicht existiert oder nicht zugänglich ist, try_to_file ergibt NULL:

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

NULL
  • Last updated on