- 카테고리:
EXTERNAL_TABLE_FILES¶
이 테이블 함수는 지정된 외부 테이블 의 메타데이터에 포함된 스테이징된 데이터 파일에 대한 정보를 쿼리하는 데 사용할 수 있습니다.
구문¶
EXTERNAL_TABLE_FILES(
TABLE_NAME => '<string>' )
인자¶
필수:
TABLE_NAME => 'string'
외부 테이블 이름을 지정하는 문자열입니다.
사용법 노트¶
외부 테이블 소유자(즉, 외부 테이블에 대한 OWNERSHIP 권한이 있는 역할), 또는 상위 역할, 또는 외부 테이블을 포함하는 데이터베이스 및 스키마에 대한 USAGE 권한과 외부 테이블에 대한 모든 권한이 있는 역할에 대한 결과를 반환합니다.
테이블 함수는 외부 테이블이 해당 메타데이터에 데이터 파일을 포함하도록 새로 고침(즉, 동기화) 될 때까지, 스테이징된 데이터 파일에 대한 메타데이터를 검색할 수 없습니다.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 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'));