ONLINE_FEATURE_TABLE_REFRESH_HISTORY¶

이 테이블 함수는 :doc:`온라인 기능 테이블</sql-reference/sql/create-online-feature-table>`의 각 새로 고침(완료 및 실행 중)에 대한 정보를 반환합니다.

이 테이블 함수는 진행 중인 모든 새로 고침은 물론이고, 현재 시간으로부터 7일 이내의 REFRESH_START_TIME가 있는 모든 새로 고침도 반환합니다.

참고 항목:: CREATE ONLINE FEATURE TABLE , ALTER ONLINE FEATURE TABLE, DESCRIBE ONLINE FEATURE TABLE , DROP ONLINE FEATURE TABLE , SHOW ONLINE FEATURE TABLES

구문¶

ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  [ REFRESH_START_TIMESTAMP => <constant_expr> ]
  [ , REFRESH_END_TIMESTAMP => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

Copy

인자¶

모든 인자는 선택 사항입니다. 아무런 인자도 제공되지 않으면 계정의 모든 온라인 기능 테이블에서 100회의 새로 고침이 반환됩니다.

REFRESH_START_TIMESTAMP => constant_expr , REFRESH_END_TIMESTAMP => constant_expr

새로 고침이 시작한 시간 범위(TIMESTAMP_LTZ 형식)입니다. 종료 버전이 지정되지 않은 경우, CURRENT_TIMESTAMP 가 범위의 끝으로 사용됩니다.

RESULT_LIMIT => integer

함수가 반환하는 최대 행 수를 지정하는 숫자입니다. 일치하는 행의 수가 이 제한보다 큰 경우, 지정된 제한까지는 가장 최근에 종료된 새로 고침(그리고 여전히 실행 중인 새로 고침)이 반환됩니다.

범위: 1~10,000

기본값: 100.

NAME => 'string'

온라인 기능 테이블의 이름입니다.

정규화되지 않은 이름(online_feature_table_name), 부분적으로 정규화된 이름(schema_name.online_feature_table_name) 또는 정규화된 이름(database_name.schema_name.online_feature_table_name)을 지정할 수 있습니다.

오브젝트 이름 확인에 대한 자세한 내용은 오브젝트 이름 확인 섹션을 참조하세요.

이 함수는 이 테이블에 대한 새로 고침을 반환합니다.

NAME_PREFIX => 'string'

온라인 기능 테이블의 접두사입니다.

이 함수는 이 접두사로 시작하는 이름을 가진 테이블에 대한 새로 고침을 반환합니다.

이 인자를 사용하여 특정 데이터베이스 또는 스키마의 온라인 기능 테이블에 대한 새로 고침을 반환할 수 있습니다.

ERROR_ONLY => { TRUE | FALSE }

TRUE로 설정 시, 이 함수는 실패하거나 취소된 새로 고침만 반환합니다.

기본값: FALSE

출력¶

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

열	데이터 타입	설명
`NAME`	TEXT	온라인 기능 테이블의 이름입니다.
`SCHEMA_NAME`	TEXT	온라인 기능 테이블이 포함된 스키마의 이름입니다.
`DATABASE_NAME`	TEXT	온라인 기능 테이블이 포함된 데이터베이스의 이름입니다.
`QUALIFIED_NAME`	TEXT	온라인 기능 테이블의 정규화된 이름입니다.
`STATE`	TEXT	온라인 기능 테이블의 새로 고침 상태입니다. 다음 중 한 가지 상태일 수 있습니다. `EXECUTING`: 새로 고침이 진행 중입니다. `SUCCEEDED`: 새로 고침이 성공적으로 완료되었습니다. `FAILED`: 새로 고침이 실행 중에 실패했습니다. `CANCELLED`: 새로 고침이 완료 전에 취소되었습니다.
`REFRESH_START_TIME`	TIMESTAMP_LTZ	새로 고침 작업이 시작된 시간입니다.
`REFRESH_END_TIME`	TIMESTAMP_LTZ	새로 고침이 완료된 시간입니다.
`REFRESH_TRIGGER`	TEXT	다음 중 하나: `SCHEDULED`: 목표 지연을 충족하기 위한 일반적인 백그라운드 새로 고침입니다. `MANUAL`: 사용자/작업이 `ALTER ONLINE FEATURE TABLE <name> REFRESH` 명령을 실행했습니다. `CREATION` - 온라인 기능 테이블의 생성으로 트리거되는 DDL 문 생성 중에 새로 고침이 수행됩니다.
`REFRESH_ACTION`	TEXT	다음 중 하나: `NO_DATA` - 기본 테이블에 새 데이터가 없습니다. 기본 테이블에 데이터가 있는지 여부에 관계없이 새로 생성된 기능 테이블의 초기 새로 고침에는 적용되지 않습니다. `REINITIALIZE`: 기본 테이블이 변경되었습니다. `FULL`: 온라인 기능 테이블의 새로 고침 모드가 FULL로 설정되어 있으므로 전체 새로 고침을 수행합니다. `INCREMENTAL` - 일반적인 증분 새로 고침입니다.
`QUERY_ID`	TEXT	온라인 기능 테이블의 결과를 생성한 SQL 문의 ID입니다.
`STATE_CODE`	TEXT	새로 고침의 현재 상태를 나타내는 코드입니다.
`STATE_MESSAGE`	TEXT	새로 고침의 현재 상태에 대한 설명입니다.

액세스 제어 요구 사항¶

권한	오브젝트	참고
MONITOR	온라인 기능 테이블	온라인 기능 테이블에 대한 MONITOR 권한이 있는 역할입니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

이 함수는 INFORMATION_SCHEMA에서 사용할 수 있습니다.
이 함수가 반환하는 정보는 최신 정보입니다. ACCOUNT_USAGE.ONLINE_FEATURE_TABLE_REFRESH_HISTORY 뷰의 온라인 기능 테이블 새로 고침 기록은 최대 3시간까지 지연될 수 있습니다.

예¶

다음 예에서는 계정의 모든 온라인 기능 테이블에 대한 새로 고침 기록을 반환합니다.

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY());

Copy

다음 예에서는 ``my_feature_table``이라는 특정 온라인 기능 테이블에 대한 새로 고침 기록을 반환합니다.

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME => 'my_feature_table'
));

Copy

다음 예에서는 지난 24시간 동안 실패한 새로 고침만 반환합니다.

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  REFRESH_START_TIMESTAMP => CURRENT_TIMESTAMP - INTERVAL '1 DAY',
  ERROR_ONLY => TRUE
));

Copy

다음 예에서는 이름이 ``feature_``로 시작하는 온라인 기능 테이블에 대한 새로 고침을 반환하고 결과를 50개 행으로 제한합니다.

SELECT *
FROM TABLE(INFORMATION_SCHEMA.ONLINE_FEATURE_TABLE_REFRESH_HISTORY(
  NAME_PREFIX => 'feature_',
  RESULT_LIMIT => 50
));

Copy