EXTERNAL_TABLE_FILES
EXTERNAL_TABLE_FILES
EXTERNAL_TABLE_FILES() 테이블 함수는 지정한 외부 테이블(external table)의 메타데이터에 포함된 스테이징된 데이터 파일에 대한 정보를 조회할 때 사용해요.
본문
문법
EXTERNAL_TABLE_FILES(
TABLE_NAME => '<string>' )
인자
필수:
TABLE_NAME => 'string'
외부 테이블 이름을 지정하는 문자열이에요.
사용 지침
-
외부 테이블 소유자(즉, 해당 외부 테이블에 대한 OWNERSHIP 권한이 있는 역할), 상위 역할, 또는 외부 테이블을 포함하는 데이터베이스와 스키마에 대한 USAGE 권한과 외부 테이블에 대한 모든 권한이 있는 역할에 대해 결과를 반환해요.
-
외부 테이블이 파일들을 메타데이터에 포함하도록 새로 고쳐지지(즉, 동기화되지) 않으면 테이블 함수는 스테이징된 데이터 파일에 대한 메타데이터를 검색할 수 없어요.
-
Information Schema 테이블 함수를 호출할 때는 세션이 INFORMATION_SCHEMA 스키마를 사용 중이어야 하거나 함수 이름이 완전한 자격(fully-qualified)을 갖춰야 해요. 자세한 내용은 Snowflake Information Schema를 참고하세요.
출력
이 함수는 다음 열을 반환해요.
| 열 이름 | 데이터 타입 | 설명 |
|---|---|---|
| FILE_NAME | TEXT | 소스 파일 이름 및 스테이징된 파일에 대한 상대 경로 |
| REGISTERED_ON | TIMESTAMP_LTZ | 파일 메타데이터가 외부 테이블에 추가된 타임스탬프(즉, 외부 테이블 메타데이터가 파일 세부 정보로 새로 고쳐진 시점) |
| FILE_SIZE | NUMBER | 파일 크기(바이트) |
| LAST_MODIFIED | TIMESTAMP_LTZ | 파일이 스테이지에서 마지막으로 업데이트된 타임스탬프 |
| ETAG | HEX | 파일의 ETag 헤더 |
| MD5 | HEX | 파일의 MD5 체크섬 |
예제
mytable 외부 테이블이 참조하는 모든 데이터 파일에 대해 저장된 메타데이터 검색:
select *
from table(information_schema.external_table_files(TABLE_NAME=>'MYTABLE'));