적용 대상:
Databricks SQL Databricks Runtime 18 LTS 이상으로 표시
Important
이 기능은 베타 버전으로 제공됩니다. 작업 영역 관리자는 미리 보기 페이지에서 이 기능에 대한 액세스를 제어할 수 있습니다. Azure Databricks 미리 보기 관리를 참조하세요.
파일을 참조path하는 값을 반환 FILE 하거나, NULL 파일이 존재하지 않거나 접근할 수 없을 경우를 나타냅니다.
Syntax
try_to_file(path)
Arguments
-
path:STRING파일 경로, 예를 들어 Unity 카탈로그 볼륨의 경로를 지정하는 표현식입니다.
Returns
FILE 파일이 존재하지 않거나 접근할 수 없을 때 해당 파일을 pathNULL 참조하는 값입니다.
이 함수는 오류 허용 함수 버전to_file입니다. 파일 메타데이터를 수집하기 위해 Azure Databricks는 파일의 저장 위치에 원격 호출을 합니다. 파일이 존재하지 않거나 접근할 수 없을 경우, 이 함수는 오류를 발생시키지 않고 반환 NULL 됩니다.
일반적인 오류 조건
TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED
자세한 내용은 Azure Databricks의 Error conditions 문서를 참조하세요.
예시
볼륨 내 경로에서 참조를 FILE 생성하려면:
SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/report.pdf');
경로가 존재하지 않거나 접근할 try_to_fileNULL수 없으면 :
SELECT try_to_file('/Volumes/my_catalog/my_schema/my_volume/ghost.csv');
NULL