clickhouse-server 모드에서는 경로가 user_files_path 디렉터리 내에 있어야 합니다. user_files_path 내부에 있으면서 외부를 가리키는 심볼릭 링크는 따라가지만, (심볼릭 링크를 통해) 경로가 user_files_path로 시작하는 항목만 반환됩니다.
clickhouse-local 모드에서는 경로에 제한이 없습니다.
구문
인수
| 매개변수 | 설명 |
|---|---|
path | 나열할 디렉터리입니다. 절대 경로일 수도 있고(server 모드에서는 반드시 user_files_path 내부여야 함), user_files_path 기준의 상대 경로일 수도 있습니다. 비어 있거나 생략하면 기본값으로 user_files_path가 사용됩니다. |
반환되는 컬럼
| Column | Type | Description |
|---|---|---|
path | String | 항목이 들어 있는 디렉터리(파일/디렉터리 이름 자체는 제외). |
name | String | 파일 또는 디렉터리 이름(경로의 마지막 구성 요소). |
file | String (ALIAS of name) | name 컬럼의 별칭입니다. |
type | Enum8 | 파일 유형: 'none', 'not_found', 'regular', 'directory', 'symlink', 'block', 'character', 'fifo', 'socket', 'unknown'. |
size | Nullable(UInt64) | 파일 크기(바이트 단위, 일반 파일에만 해당). 일반 파일이 아닌 경우(디렉터리, 심볼릭 링크 등)와 오류 발생 시에는 NULL입니다. |
depth | UInt16 | 재귀 깊이입니다. 쿼리한 디렉터리 자체와 그 직속 하위 항목은 0, 한 단계 더 깊은 항목은 1이며, 이후도 같은 방식입니다. |
modification_time | Nullable(DateTime64(6)) | 마이크로초 정밀도의 마지막 수정 시간입니다. 오류 발생 시 NULL입니다. |
is_symlink | Bool | 해당 항목이 심볼릭 링크인지 여부입니다. |
content | Nullable(String) | 파일 내용(일반 파일에만 해당). 일반 파일이 아닌 경우(디렉터리, 심볼릭 링크 등)는 NULL입니다. 읽기 오류가 발생하면 예외가 발생합니다. 이 컬럼을 읽으면 실제 파일 I/O가 발생하므로 필요하지 않으면 제외하십시오. |
owner_read | Bool | 소유자에게 읽기 권한이 있습니다. |
owner_write | Bool | 소유자에게 쓰기 권한이 있습니다. |
owner_exec | Bool | 소유자에게 실행 권한이 있습니다. |
group_read | Bool | 그룹에 읽기 권한이 있습니다. |
group_write | Bool | 그룹에 쓰기 권한이 있습니다. |
group_exec | Bool | 그룹에 실행 권한이 있습니다. |
others_read | Bool | 기타 사용자에게 읽기 권한이 있습니다. |
others_write | Bool | 기타 사용자에게 쓰기 권한이 있습니다. |
others_exec | Bool | 기타 사용자에게 실행 권한이 있습니다. |
set_gid | Bool | Set-GID 비트입니다. |
set_uid | Bool | Set-UID 비트입니다. |
sticky_bit | Bool | 스티키 비트입니다. |
content를 생략하는 경우 특히) 효율적입니다.