try_to_file-Funktion

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

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

Verwandte Funktionen

• to_file Funktion
• create_file Funktion
• copy_file Funktion
• try_copy_file Funktion
• list_filesTabellenwertfunktion
• read_filesTabellenwertfunktion
• FILE Typ