카테고리:

Information Schema , 테이블 함수

DYNAMIC_TABLE_GRAPH_HISTORY

Snowflake logo in black (no text) 미리 보기 기능 — 공개

계정에서 사용 가능합니다.

이 테이블 함수는 현재 계정의 모든 동적 테이블 에 대한 정보를 반환합니다. 이 정보에는 동적 테이블과 기본 테이블 간의 종속성이 포함됩니다. 일반적인 용도는 파이프라인에 속한 모든 동적 테이블을 식별하는 것입니다.

이 함수의 출력에서 각 행은 동적 테이블을 나타냅니다. VALID_FROM 및 VALID_TO 열에는 동적 테이블의 설명이 유효한(즉, 동적 테이블을 정확하게 설명한) 시간 범위가 지정됩니다.

TARGET_LAG 변경과 같은 동적 테이블을 변경하면 새 항목이 생성됩니다.

이 테이블 함수는 현재 시간을 기준으로 1일 이내의 VALID_TO 값을 포함한 설명만 제공합니다.

구문

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)
Copy

인자

모든 인자는 선택 사항입니다. 아무런 인자도 제공되지 않으면 현재 존재하는 동적 테이블에 대한 가장 최근의 설명만 반환됩니다.

AS_OF => constant_expr

그래프의 상태를 반환하는 시간(TIMESTAMP_LTZ 형식)입니다. DYNAMIC_TABLE_REFRESH_HISTORY 함수의 출력에서 REFRESH_VERSION 열에 있는 값에 해당하는 시간을 지정할 수 있습니다.

HISTORY_START => constant_expr , . HISTORY_END => constant_expr

동적 테이블 새로 고침 기록의 날짜/시간 범위입니다. HISTORY_START는 데이터를 반환할 가장 이른 날짜/시간을 지정합니다. HISTORY_END는 데이터 반환의 종료 날짜/시간을 지정하며, HISTORY_START와 함께 지정해야 합니다.

출력

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

NAME

TEXT

동적 테이블의 이름입니다.

SCHEMA_NAME

TEXT

동적 테이블을 포함하는 스키마의 이름입니다.

DATABASE_NAME

TEXT

동적 테이블을 포함하는 데이터베이스의 이름입니다.

QUALIFIED_NAME

TEXT

동적 테이블의 그래프에 표시되는 동적 테이블의 정규화된 이름입니다. 이를 사용하여 출력을 다음의 DYNAMIC_TABLE_REFRESH_HISTORY 함수의 출력과 결합할 수 있습니다.

INPUTS

OBJECTs로 구성된 ARRAY

각 OBJECT는 이 동적 테이블에 대한 입력 역할을 하는 테이블, 뷰 또는 동적 테이블을 나타내며 다음으로 구성됩니다.

  • name (TEXT): 정규화된 이름입니다.

  • kind (TEXT): 입력 유형(TABLE, VIEW 또는 DYNAMIC TABLE).

TARGET_LAG_TYPE

TEXT

다음 중 하나:

  • USER_DEFINED - 동적 테이블에 지정된 TARGET_LAG 매개 변수로 결정됩니다.

  • DOWNSTREAM - DOWNSTREAM TARGET_LAG로 동적 테이블을 나타냅니다. 자세한 내용은 동적 테이블 새로 고침 이해하기 섹션을 참조하십시오.

TARGET_LAG_SEC

NUMBER

이 동적 테이블의 목표 지연 시간(초)입니다. 동적 테이블의 TARGET_LAG 매개 변수에서 지정된 값입니다.

QUERY_TEXT

TEXT

이 동적 테이블에 대한 SELECT 문입니다.

VALID_FROM

TIMESTAMP_LTZ

동적 테이블에 대한 설명은 이 시간 이후부터 유효합니다.

VALID_TO

TIMESTAMP_LTZ

존재하는 경우 동적 테이블에 대한 설명은 현재까지 유효합니다. null인 경우 설명은 여전히 정확합니다.

SCHEDULING_STATE

OBJECT

다음으로 구성된 OBJECT:

  • state (TEXT): 예약 상태(RUNNING 또는 SUSPENDED).

  • reason_code (TEXT): 상태가 RUNNING이 아닌 경우의 이유에 대한 선택적 코드.

  • reason_message (TEXT): 동적 테이블이 실행되지 않는 이유에 대한 텍스트 설명. 상태가 실행 중이 아닌 경우에만 적용됩니다.

  • suspended_on (TIMESTAMP_LTZ): 동적 테이블이 일시 중단된 시점의 타임스탬프(선택 사항).

  • resumed_on (TIMESTAMP_LTZ): 동적 테이블이 RUNNING인 경우 마지막으로 재개된 시점의 타임스탬프(선택 사항).

사용법 노트

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

언어: 한국어