- 스키마:
COPY_HISTORY 뷰¶
이 Account Usage 뷰는 지난 365일(1년) 동안의 Snowflake 데이터 로딩 기록을 쿼리하는 데 사용할 수 있습니다. 이 뷰는 Snowpipe 를 사용한 COPY INTO <테이블> 문 및 연속 데이터 로딩 둘 다에 대한 로딩 활동을 표시합니다. 이 뷰는 LOAD_HISTORY 뷰 의 10,000행 제한을 피합니다.
Snowsight 에서 데이터 로딩 세부 정보를 볼 수도 있습니다. 복사 기록을 사용하여 데이터 로딩 활동 모니터링하기 섹션을 참조하십시오.
열¶
열 이름 |
데이터 타입 |
설명 |
---|---|---|
FILE_NAME |
TEXT |
소스 파일의 이름과 파일에 대한 상대적 경로입니다. |
STAGE_LOCATION |
TEXT |
소스 파일이 있는 스테이지의 이름입니다. |
LAST_LOAD_TIME |
TIMESTAMP_LTZ |
파일 로딩을 마친 날짜 및 시간입니다. |
ROW_COUNT |
NUMBER |
소스 파일에서 로딩된 행 수입니다. |
ROW_PARSED |
NUMBER |
소스 파일에서 구문 분석된 행 수입니다. STATUS가 |
FILE_SIZE |
NUMBER |
로딩된 소스 파일의 크기. |
FIRST_ERROR_MESSAGE |
TEXT |
소스 파일의 첫 번째 오류입니다. |
FIRST_ERROR_LINE_NUMBER |
NUMBER |
첫 번째 오류의 줄 번호입니다. |
FIRST_ERROR_CHARACTER_POS |
NUMBER |
첫 번째 오류 문자의 위치입니다. |
FIRST_ERROR_COLUMN_NAME |
TEXT |
첫 번째 오류의 열 이름입니다. |
ERROR_COUNT |
NUMBER |
소스 파일의 오류 행 수입니다. |
ERROR_LIMIT |
NUMBER |
오류 수가 이 제한에 도달하면 중단합니다. |
STATUS |
TEXT |
상태: |
TABLE_ID |
NUMBER |
대상 테이블의 내부/시스템 생성 식별자입니다. |
TABLE_NAME |
TEXT |
대상 테이블의 이름입니다.TABLE_NAME |
TABLE_SCHEMA_ID |
NUMBER |
테이블의 스키마에 대해 Snowflake가 생성한 내부 식별자입니다. |
TABLE_SCHEMA_NAME |
TEXT |
대상 테이블이 있는 스키마의 이름입니다. |
TABLE_CATALOG_ID |
NUMBER |
테이블의 데이터베이스에 대한 내부/시스템 생성 식별자입니다. |
TABLE_CATALOG_NAME |
TEXT |
대상 테이블이 있는 데이터베이스의 이름입니다. |
PIPE_CATALOG_NAME |
TEXT |
파이프가 있는 데이터베이스의 이름입니다. |
PIPE_SCHEMA_NAME |
TEXT |
파이프가 있는 스키마의 이름입니다. |
PIPE_NAME |
TEXT |
로딩 매개 변수를 정의하는 파이프의 이름입니다. COPY 문 로딩의 경우 |
PIPE_RECEIVED_TIME |
TIMESTAMP_LTZ |
파이프를 통해 로딩된 파일에 대한 INSERT 요청이 수신된 날짜 및 시간입니다. COPY 문 로딩의 경우 |
FIRST_COMMIT_TIME |
TIMESTAMP_LTZ |
파일의 첫 번째 청크가 커밋된 날짜 및 시간입니다. Snowpipe는 별도로 커밋된 여러 청크로 파일을 로딩할 수 있습니다. |
사용법 노트¶
대부분의 경우, 뷰의 지연 시간은 최대 120분(2시간)입니다. 다음 조건이 모두 참인 경우 지정된 테이블의 복사 기록에 대한 대기 시간은 최대 2일일 수 있습니다.
COPY_HISTORY에서 마지막으로 업데이트된 이후 주어진 테이블에 추가된 DML 문의 수는 32개 미만이었습니다.
COPY_HISTORY에서 마지막으로 업데이트된 이후 주어진 테이블에 추가된 행의 수는 100개 미만이었습니다.
이 뷰에는 오류가 있거나 오류 없이 완료될 때까지 실행된 COPY INTO 명령만 포함됩니다.
테이블 오브젝트를 삭제하거나 다시 만들면 테이블로의 대량 데이터 로딩(COPY INTO <테이블> 문)의 기록 데이터가 제거됩니다.
파이프 오브젝트를 삭제하거나 다시 만들면 파이프를 사용하는 Snowpipe 데이터 로딩에 대한 기록 데이터가 제거됩니다.
뷰에는 세션의 현재 역할에 액세스 권한이 부여된 오브젝트만 표시됩니다.
예¶
가장 최근에 실행된 COPY INTO 명령 10개에 대한 레코드를 검색합니다.
select file_name, error_count, status, last_load_time from snowflake.account_usage.copy_history
order by last_load_time desc
limit 10;