스키마:

ACCOUNT_USAGE

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가 Load in progress 인 경우 NULL 입니다.

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

상태: Loaded, Load failed, Partially loaded 또는 Load skipped.

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 문 로딩의 경우 NULL 입니다.

PIPE_RECEIVED_TIME

TIMESTAMP_LTZ

파이프를 통해 로딩된 파일에 대한 INSERT 요청이 수신된 날짜 및 시간입니다. COPY 문 로딩의 경우 NULL 입니다.

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;
Copy