QUERY_HISTORY 뷰(Account Usage): 열의 변경 사항과 새 열(보류 중)¶

주의

이 동작 변경 사항은 2024_02 번들에 있습니다.

번들의 현재 상태는 번들 기록 섹션을 참조하십시오.

QUERY_HISTORY 뷰 에는 다음과 같은 새 열 과 열 변경 사항 이 포함됩니다.

QUERY_HISTORY 뷰의 새 열¶

이 동작 변경 번들이 활성화되면 Account Usage QUERY_HISTORY 뷰에 다음과 같은 새 열이 포함됩니다.

열 이름	데이터 타입	설명
SECONDARY_ROLE_STATS	VARCHAR	쿼리에서 평가된 보조 역할에 관한 3개의 필드(세션에 따른 보조 역할 목록 또는 `ALL`, 보조 역할의 수, 각 보조 역할에 대한 내부/시스템 생성 ID0)가 포함된 JSON 형식의 문자열입니다. ID의 개수는 최대 50개입니다.
ROWS_WRITTEN_TO_RESULT	NUMBER	결과 오브젝트에 작성된 행 수입니다. CREATE TABLE AS SELECT(CTAS) 및 모든 DML 작업의 경우 이 결과는 `1` 입니다. ROWS_INSERTED, ROWS_UPDATED 및 ROWS_DELETED 열의 값은 실제로 삽입, 업데이트 또는 삭제된 행 수를 반영합니다. 자세한 내용은 더 이상 사용되지 않는 ROWS_PRODUCED 열 섹션을 참조하십시오.
ROWS_INSERTED	NUMBER	쿼리가 삽입한 행 수입니다.
QUERY_RETRY_TIME	NUMBER	실행 가능한 오류로 인해 발생한 쿼리 재시도의 총 실행 시간(밀리초)입니다. 자세한 내용은 쿼리 재시도 열 을 참조하십시오.
QUERY_RETRY_CAUSE	VARIANT	실행 가능한 오류에 대한 오류 메시지 배열입니다. 배열에는 각 쿼리 재시도에 대한 하나의 오류 메시지가 포함됩니다. 쿼리 재시도가 없으면 배열은 비어 있습니다. 자세한 내용은 쿼리 재시도 열 을 참조하십시오.
FAULT_HANDLING_TIME	NUMBER	실행 가능하지 않은 오류로 인해 발생한 쿼리 재시도의 총 실행 시간(밀리초)입니다. 자세한 내용은 쿼리 재시도 열 섹션을 참조하십시오.

이러한 열은 뷰의 마지막(가장 오른쪽) 열로 추가됩니다.

자세한 내용은 Information Schema: QUERY_HISTORY, QUERY_HISTORY_BY_* 함수 출력의 새 열(보류 중) 섹션도 참조하십시오.

쿼리 재시도 열¶

성공적으로 완료하려면 쿼리를 한 번 이상 다시 시도해야 할 수도 있습니다. 쿼리 재시도가 발생하는 원인은 여러 가지 있을 수 있습니다. 이러한 원인 중 일부는 실행 가능 합니다. 즉, 사용자가 특정 쿼리에 대한 쿼리 재시도를 줄이거나 없애기 위해 변경할 수 있습니다. 예를 들어 메모리 부족 오류로 인해 쿼리를 다시 시도하는 경우 웨어하우스 설정을 수정하면 문제가 해결될 수 있습니다.

일부 쿼리 재시도는 실행 불가능한 내결함성으로 인해 발생합니다. 즉, 쿼리 재시도를 방지하기 위해 사용자가 변경할 수 있는 것이 없습니다. 예를 들어 네트워크 중단으로 인해 쿼리가 다시 시도될 수 있습니다. 이 경우 쿼리 재시도를 방해할 수 있는 쿼리 또는 쿼리를 실행하는 웨어하우스에는 변경 사항이 없습니다.

QUERY_RETRY_TIME, QUERY_RETRY_CAUSE 및 FAULT_HANDLING_TIME 열은 재시도되는 쿼리를 최적화하고 쿼리 성능의 변동을 더 잘 이해하는 데 도움이 될 수 있습니다.

더 이상 사용되지 않는 ROWS_PRODUCED 열¶

ROWS_PRODUCED 열은 향후 릴리스에서 더 이상 사용되지 않습니다. ROWS_PRODUCED 열의 값이 항상 쿼리의 영향을 받는 논리적 행 수를 반영하는 것은 아닙니다. 예를 들어, ROWS_PRODUCED 열의 값에는 마이크로 파티션 재작성으로 인해 삭제된 행이 포함될 수 있으며 영향을 받는 실제 행 수보다 클 수 있습니다. ROWS_INSERTED, ROWS_UPDATED, ROWS_WRITTEN_TO RESULTS 또는 ROWS_DELETED 열을 사용하는 것이 좋습니다.

QUERY_HISTORY 뷰의 열 변경 사항¶

Account Usage QUERY_HISTORY 뷰 에는 다음 열이 포함됩니다.

BYTES_WRITTEN_TO_RESULT
ROWS_INSERTED

특정 유형의 쿼리에 대한 이러한 열의 값은 다음과 같습니다.

변경 전:

BYTES_WRITTEN_TO_RESULT	작은 쿼리의 경우 `0` 입니다.
ROWS_INSERTED:	CREATE TABLE AS SELECT(CTAS) 쿼리의 경우 `0` 입니다.

변경 후:

BYTES_WRITTEN_TO_RESULT	작은 쿼리의 경우 결과 오브젝트에 작성된 바이트 수입니다.
ROWS_INSERTED:	CREATE TABLE AS SELECT(CTAS) 쿼리에 대해 삽입된 행의 개수입니다.

자세한 내용은 Information Schema: QUERY_HISTORY, QUERY_HISTORY_BY_* 함수 출력의 새 열(보류 중) 섹션도 참조하십시오.

참조: 1431, 1524, 1540