스키마:: ACCOUNT_USAGE

COPY_HISTORY 뷰¶

이 Account Usage 뷰는 지난 365일(1년) 동안의 Snowflake 데이터 로딩 기록을 쿼리하는 데 사용할 수 있습니다. 이 뷰는 Snowpipe 를 사용한 COPY INTO <테이블> 문 및 연속 데이터 로딩 둘 다에 대한 로딩 활동을 표시합니다. 이 뷰는 LOAD_HISTORY 뷰 의 10,000행 제한을 피합니다.

Snowsight 에서 데이터 로딩 세부 정보를 볼 수도 있습니다. 복사 기록을 사용하여 데이터 로딩 활동 모니터링하기 섹션을 참조하십시오.

열¶


열 이름	데이터 타입	설명
FILE_NAME	VARCHAR	소스 파일의 이름과 파일에 대한 상대적 경로입니다.
STAGE_LOCATION	VARCHAR	소스 파일이 있는 스테이지의 이름입니다.
LAST_LOAD_TIME	TIMESTAMP_LTZ	파일 로딩을 마친 날짜 및 시간입니다.
ROW_COUNT	NUMBER	소스 파일에서 로딩된 행 수입니다.
ROW_PARSED	NUMBER	소스 파일에서 구문 분석된 행 수입니다. STATUS가 `Load in progress` 인 경우 `NULL` 입니다.
FILE_SIZE	NUMBER	소스 파일이 로드되기 전에 내부 또는 외부 스테이지에서 관찰된 크기입니다. 파일이 압축된 경우 압축된 크기가 표시됩니다. 파일이 압축되지 않은 경우 압축되지 않은 크기가 표시됩니다.
FIRST_ERROR_MESSAGE	VARCHAR	소스 파일의 첫 번째 오류입니다.
FIRST_ERROR_LINE_NUMBER	NUMBER	첫 번째 오류의 줄 번호입니다.
FIRST_ERROR_CHARACTER_POS	NUMBER	첫 번째 오류 문자의 위치입니다.
FIRST_ERROR_COLUMN_NAME	VARCHAR	첫 번째 오류의 열 이름입니다.
ERROR_COUNT	NUMBER	소스 파일의 오류 행 수입니다.
ERROR_LIMIT	NUMBER	오류 수가 이 제한에 도달하면 중단합니다.
STATUS	VARCHAR	상태: `Loaded`, `Load failed`, `Partially loaded` 또는 `Load skipped`.
TABLE_ID	NUMBER	대상 테이블의 내부/시스템 생성 식별자입니다.
TABLE_NAME	VARCHAR	대상 테이블의 이름입니다.TABLE_NAME
TABLE_SCHEMA_ID	NUMBER	테이블의 스키마에 대해 Snowflake가 생성한 내부 식별자입니다.
TABLE_SCHEMA_NAME	VARCHAR	대상 테이블이 있는 스키마의 이름입니다.
TABLE_CATALOG_ID	NUMBER	테이블의 데이터베이스에 대한 내부/시스템 생성 식별자입니다.
TABLE_CATALOG_NAME	VARCHAR	대상 테이블이 있는 데이터베이스의 이름입니다.
PIPE_CATALOG_NAME	VARCHAR	파이프가 있는 데이터베이스의 이름입니다.
PIPE_SCHEMA_NAME	VARCHAR	파이프가 있는 스키마의 이름입니다.
PIPE_NAME	VARCHAR	로딩 매개 변수를 정의하는 파이프의 이름입니다. COPY 문 로딩의 경우 `NULL` 입니다.
PIPE_RECEIVED_TIME	TIMESTAMP_LTZ	파이프를 통해 로딩된 파일에 대한 INSERT 요청이 수신된 날짜 및 시간입니다. COPY 문 로딩의 경우 `NULL` 입니다.
FIRST_COMMIT_TIME	TIMESTAMP_LTZ	파일의 첫 번째 청크가 커밋된 날짜 및 시간입니다. Snowpipe는 별도로 커밋된 여러 청크로 파일을 로딩할 수 있습니다.
BYTES_BILLED	NUMBER	Snowpipe가 청구 목적으로 사용하는 바이트 수를 나타내며, 이러한 기록 뷰 내에서 직접 Snowpipe의 비용 영향을 더 명확하게 확인할 수 있습니다.

사용법 노트¶

대부분의 경우, 뷰의 지연 시간은 최대 120분(2시간)입니다. 다음 조건이 모두 참인 경우 지정된 테이블의 복사 기록에 대한 대기 시간은 최대 2일일 수 있습니다.
- COPY_HISTORY에서 마지막으로 업데이트된 이후 주어진 테이블에 추가된 DML 문의 수는 32개 미만이었습니다.
- COPY_HISTORY에서 마지막으로 업데이트된 이후 주어진 테이블에 추가된 행의 수는 100개 미만이었습니다.

이 뷰에는 오류가 있거나 오류 없이 완료될 때까지 실행된 COPY INTO 명령만 포함됩니다.
테이블 오브젝트를 제거하거나 다시 만들면 대량 데이터 로드 중복 제거를 위한 로드 기록 메타데이터(COPY INTO <table> 문)가 테이블에서 제거됩니다.
테이블 오브젝트의 이름을 바꾸면 복사 기록에서 해당 TABLE_NAME 항목이 업데이트됩니다.
파이프 오브젝트를 제거하거나 다시 생성해도 파이프의 로딩 기록 메타데이터는 제거되지 않습니다.
뷰에는 세션의 현재 역할에 액세스 권한이 부여된 오브젝트만 표시됩니다.
복사 기록 복제 후 COPY_HISTORY Account Usage 뷰에는 대상 테이블에 대한 최신 잘라내기 작업 이후의 기록만 표시됩니다. 이는 전체 복사 기록을 표시하는 복제 제외 뷰와 다릅니다.

예¶

가장 최근에 실행된 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;