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

Składnia

to_file(path)

Arguments

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

Zwroty

Wartość FILE odwołująca się do pliku w .path

Aby zebrać metadane pliku, Azure Databricks wykonuje zdalne połączenie do miejsca przechowywania pliku. Jeśli plik nie istnieje lub jest niedostępny, Azure Databricks zgłasza błąd. Aby zwrócić zamiast tego NULL , użyj try_to_file funkcji.

Typowe warunki błędów

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

Jeśli ścieżka nie istnieje lub użytkownik nie ma uprawnień do odczytu, to_file pojawia się błąd:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on