- 카테고리:
DATA_TRANSFER_HISTORY¶
이 테이블 함수는 지정된 날짜 범위 내에서 Snowflake 테이블로부터 다른 클라우드 저장소 공급자의 네트워크(즉, AWS, Google Cloud Platform 또는 Microsoft Azure의 Snowflake에서 다른 클라우드 공급자의 네트워크로) 및/또는 지리적 리전으로 전송된 데이터의 기록을 쿼리하는 데 사용할 수 있습니다. 이 함수는 전체 Snowflake 계정에 대한 기록을 반환합니다.
참고
이 함수는 지난 14일 동안의 데이터 전송 활동을 반환합니다.
구문¶
DATA_TRANSFER_HISTORY(
[ DATE_RANGE_START => <constant_expr> ]
[, DATE_RANGE_END => <constant_expr> ] )
인자¶
모든 인자는 선택 사항입니다.
DATE_RANGE_START => constant_expr
, .DATE_RANGE_END => constant_expr
데이터 전송 기록을 검색할 지난 2주 이내의 날짜/시간 범위:
종료 날짜가 지정되지 않은 경우, CURRENT_DATE 가 범위의 끝으로 사용됩니다.
시작 날짜가 지정되지 않은 경우, 범위는
DATE_RANGE_END
시작 10분 전에 시작됩니다(즉, 기본값은 이전 10분의 데이터 전송 기록을 표시하는 것임). 예를 들어DATE_RANGE_END
가 CURRENT_DATE 인 경우, 기본DATE_RANGE_START
는 전날 오후 11시 50분입니다.
기록은 5분, 1시간 또는 24시간 단위로 표시됩니다(지정된 범위의 길이에 따라 다름).
범위가 지난 15일을 벗어나면 오류가 반환됩니다.
사용법 노트¶
ACCOUNTADMIN 역할에 대한 결과 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대한 결과만 반환합니다.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.
출력¶
이 함수는 다음 열을 반환합니다.
열 이름 |
데이터 타입 |
설명 |
---|---|---|
START_TIME |
TIMESTAMP_LTZ |
데이터 전송이 발생한 지정된 시간 범위의 시작입니다. |
END_TIME |
TIMESTAMP_LTZ |
데이터 전송이 발생한 지정된 시간 범위의 끝입니다. |
SOURCE_CLOUD |
TEXT |
데이터 전송이 시작된 클라우드 공급자의 이름: Amazon Web Services, Google Cloud Platform 또는 Microsoft Azure. |
SOURCE_REGION |
TEXT |
데이터 전송이 시작된 리전입니다. |
TARGET_CLOUD |
TEXT |
데이터가 전송된 클라우드 공급자의 이름: AWS, Google Cloud Platform 또는 Microsoft Azure. |
TARGET_REGION |
TEXT |
데이터가 전송된 리전입니다. |
BYTES_TRANSFERRED |
NUMBER |
START_TIME 및 END_TIME 기간 동안 전송된 바이트 수입니다. |
TRANSFER_TYPE |
VARCHAR |
전송을 유발한 작업의 유형입니다. COPY, EXTERNAL_ACCESS, EXTERNAL_FUNCTION, REPLICATION. |
예¶
계정에 대한 30분 범위의 데이터 전송 기록을 5분 주기로 검색합니다.
select * from table(mydb.information_schema.data_transfer_history( date_range_start=>to_timestamp_tz('2017-10-24 12:00:00.000 -0700'), date_range_end=>to_timestamp_tz('2017-10-24 12:30:00.000 -0700')));
계정에 대한 지난 12시간 동안의 데이터 전송 기록을 1시간 주기로 검색합니다.
select * from table(information_schema.data_transfer_history( date_range_start=>dateadd('hour',-12,current_timestamp())));
계정에 대한 지난 14일간의 데이터 전송 기록을 1일 주기로 검색합니다.
select * from table(information_schema.data_transfer_history( date_range_start=>dateadd('day',-14,current_date()), date_range_end=>current_date()));