list_files 테이블 값 함수

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

Important

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

경로에 있는 파일 목록을 반환하며, 각 파일에 대한 참조를 포함 FILE 합니다.

Syntax

list_files(path [, connection => connection ] [, recursive => recursive ])

Arguments

  • path: STRING 목록으로 가는 길. 볼륨 경로, 외부 위치 경로, 또는 SFTP, SharePoint, Google Drive 같은 다른 파일 저장 시스템의 경로일 수 있습니다.
  • connection: SFTP, SharePoint, Google Drive 등과 같은 시스템과의 인증을 위해 사용되는 선택적 Unity 카탈로그 연결.
  • recursive: 함수가 하위 디렉터리로 내려가는지 여부를 제어하는 선택적 BOOLEAN 함수입니다. 허용되는 값은 다음과 같습니다.
    • true: 경로와 그 모든 하위 디렉터리에 있는 파일을 나열하며, 디렉터리는 반환하지 않습니다. 기본값입니다.
    • false: 경로의 즉각적인 항목만 나열하며, 참조와 a size0를 nullfile 가진 디렉터리를 반환합니다.

connection 그리고 recursive 인자는 문법(예: connection => my_conn)을 사용하여 => 이름으로 전달되어야 합니다.

Returns

파일당 한 행씩 있는 표로, 다음 열로 구성됩니다:

Column Type Description
path STRING 파일의 경로입니다.
size BIGINT 파일 크기(바이트)입니다.
modification_time TIMESTAMP 파일의 마지막 수정 시간은 UTC입니다.
file FILE 파일에 대한 참조.

일반적인 오류 조건

  • LIST_FILES_AUTHORIZATION_ERROR.ON_PATH
  • LIST_FILES_AUTHORIZATION_ERROR.ON_CONNECTION
  • LIST_FILES_ERROR.PATH_NOT_EXISTS
  • LIST_FILES_ERROR.CONNECTION_NOT_EXISTS

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

예시

볼륨 디렉터리에 파일을 나열하려면:

SELECT * FROM list_files('/Volumes/my_catalog/my_schema/my_volume/');

함수는 파일당 한 행을 반환합니다:

path                                                 size   modification_time         file
/Volumes/my_catalog/my_schema/my_volume/file1.json   1234   2026-04-11 00:00:00.000   <file>

Unity 카탈로그 연결을 통해 외부 시스템에서 파일을 나열하려면:

SELECT path, size FROM list_files('https://drive.google.com/drive/folders/my-folder-id', connection => my_gdrive_connection);

디렉터리의 즉각적인 항목만 나열하려면 다음을 설정 recursivefalse하세요:

SELECT * FROM list_files('/Volumes/my_catalog/my_schema/my_volume/', recursive => false);

디렉토리는 결과에 참조와 a size0가 nullfile 다음과 같이 나타납니다:

path                                                 size   modification_time         file
/Volumes/my_catalog/my_schema/my_volume/file1.json   1234   2026-04-11 00:00:00.000   <file>
/Volumes/my_catalog/my_schema/my_volume/subdir/      0      2026-04-11 00:00:00.000   NULL

디렉터리 내 모든 파일의 총 크기를 계산하려면 열을 size 합산합니다. 기본값이 이기 true때문 recursive 에, 이는 하위 디렉터리 내 파일들을 포함합니다:

SELECT sum(size) AS total_bytes FROM list_files('/Volumes/my_catalog/my_schema/my_volume/');

쿼리는 결합된 크기를 바이트 단위로 반환합니다:

total_bytes
1234
  • Last updated on