try_to_file funkcja

Dotyczy:sprawdź, czy zaznaczono tak, sprawdź, czy usługa SQL databricks została oznaczona jako tak Databricks Runtime 18 LTS lub nowsza

Important

Ta funkcja jest dostępna w wersji beta. Administratorzy obszaru roboczego mogą kontrolować dostęp do tej funkcji ze strony Podglądy . Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Zwraca FILE wartość odwołującą się do pliku w , pathlub NULL jeśli plik nie istnieje lub jest niedostępny.

Składnia

try_to_file(path)

Arguments

  • path: Wyrażenie określające STRING ścieżkę do pliku, na przykład ścieżki w woluminie Unity Catalog.

Zwroty

Wartość FILE odwołująca się do pliku w , pathlub NULL jeśli plik nie istnieje lub jest niedostępny.

Ta funkcja jest wersją to_file funkcji tolerującą błędy. Aby zebrać metadane pliku, Azure Databricks wykonuje zdalne połączenie do miejsca przechowywania pliku. Jeśli plik nie istnieje lub jest niedostępny, funkcja NULL ta zwraca zamiast wywoływać błąd.

Typowe warunki błędów

  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

Więcej informacji można znaleźć w artykule Condition Error conditions in Azure Databricks.

Examples

Aby utworzyć referencję FILE ze ścieżki w woluminie:

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

Jeśli ścieżka nie istnieje lub jest niedostępna, try_to_file zwraca NULL:

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

NULL
  • Last updated on