to_file 함수

적용 대상:yes Databricks SQL 확인 표시 예 Databricks Runtime 18 LTS 이상으로 표시

Important

이 기능은 베타 버전으로 제공됩니다. 작업 영역 관리자는 미리 보기 페이지에서 이 기능에 대한 액세스를 제어할 수 있습니다. Azure Databricks 미리 보기 관리를 참조하세요.

파일은 에서 참조path하는 값을 반환 FILE 합니다.

Syntax

to_file(path)

Arguments

  • path: STRING 파일의 경로를 지정하는 식입니다. 예를 들어, Unity 카탈로그 볼륨 내의 경로 같은 경우입니다.

Returns

파일을 path참조하는 값입니다FILE.

파일 메타데이터를 수집하기 위해 Azure Databricks는 파일의 저장 위치에 원격 호출을 합니다. 파일이 존재하지 않거나 접근할 수 없으면 Azure Databricks가 오류를 발생시킵니다. 대신 반환 NULL 하려면 함수를 사용try_to_file하세요.

일반적인 오류 조건

  • TO_FILE_ERROR.FILE_NOT_EXISTS
  • TO_FILE_AUTHORIZATION_ERROR.READ_UNAUTHORIZED
  • TO_FILE_ILLEGAL_USAGE.NO_PATH_PROVIDED

자세한 내용은 Azure Databricks의 Error conditions 문서를 참조하세요.

예시

볼륨 내 경로에서 참조를 FILE 생성하려면:

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

경로가 존재하지 않거나 사용자가 읽기 권한이 to_file 없으면 다음과 같은 오류가 발생합니다:

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

Error: TO_FILE_ERROR.FILE_NOT_EXISTS
  • Last updated on