CORTEX_SEARCH_REFRESH_HISTORY

CORTEX_SEARCH_REFRESH_HISTORY

Cortex Search 서비스의 각 새로고침(완료 및 실행 중)에 대한 정보를 반환하는 Information Schema 테이블 함수예요.

출처: 공식 문서

본문

이 테이블 함수는 Cortex Search 서비스의 각 새로고침(완료 및 실행 중)에 대한 정보를 반환합니다.

이 테이블 함수는 진행 중인 모든 새로고침과 현재 시간 기준 7일 이내의 DATA_TIMESTAMP를 가진 모든 새로고침을 반환합니다.

구문 (Syntax)

CORTEX_SEARCH_REFRESH_HISTORY(
  [ NAME => '<string>' ]
  [ , DATA_TIMESTAMP_START => <constant_expr> ]
  [ , DATA_TIMESTAMP_END => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
)

인자 (Arguments)

모든 인자는 선택 사항입니다. 인자가 제공되지 않으면 계정의 모든 Cortex Search 서비스에서 100개의 새로고침이 반환됩니다.

Cortex Search 서비스의 이름입니다.

이름은 작은따옴표로 묶어야 하며 대소문자를 구분하지 않습니다.

한정되지 않은 이름(service_name), 부분적으로 한정된 이름(schema_name.service_name), 완전히 한정된 이름(database_name.schema_name.service_name)을 지정할 수 있습니다.

객체 이름 해석에 대한 자세한 내용은 Object name resolution을 참고하세요.

이 함수는 이 서비스의 새로고침을 반환합니다.

새로고침이 발생한 시간 범위 (TIMESTAMP_LTZ 형식).

• 시작 시간과 종료 시간을 모두 지정하지 않으면 기본 범위는 지난 하루입니다.

• 종료 시간을 지정하지 않으면 범위의 끝으로 CURRENT_TIMESTAMP가 사용됩니다.

• 시작 시간을 지정하지 않으면 범위는 DATA_TIMESTAMP_END의 시작 시점보다 1일 전에 시작됩니다.

함수가 반환하는 최대 행 수를 지정하는 숫자입니다. 일치하는 행 수가 이 한도보다 크면 가장 최근에 완료된 새로고침(및 아직 실행 중인 새로고침)이 지정된 한도까지 반환됩니다.

결과에 필터를 적용하려면 필터가 모든 Cortex Search 서비스에 적용될 만큼 충분히 큰 RESULT_LIMIT 한도 값을 지정하세요.

범위: 1 ~ 10000

기본값: 100.

출력 (Output)

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

사용 참고 사항 (Usage notes)

• Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이어야 하거나 함수 이름이 완전히 한정되어야(fully-qualified) 합니다. 자세한 내용은 Snowflake Information Schema를 참고하세요.

예제 (Examples)

지난 주 동안 실패한 Cortex Search 서비스 새로고침을 찾습니다:

SELECT
  data_timestamp,
  database_name,
  schema_name,
  name,
  state,
  error,
  refresh_trigger
FROM
  TABLE (
    INFORMATION_SCHEMA.CORTEX_SEARCH_REFRESH_HISTORY (
      DATA_TIMESTAMP_START => DATEADD(WEEK, -1, CURRENT_TIMESTAMP())
    )
  )
ORDER BY
  data_timestamp DESC
LIMIT 10;

특정 Cortex Search 서비스의 최근 수동 새로고침을 찾습니다:

SELECT
  data_timestamp,
  refresh_start_time,
  refresh_end_time,
  refresh_action,
  state
FROM
  TABLE (
    INFORMATION_SCHEMA.CORTEX_SEARCH_REFRESH_HISTORY (
      NAME => 'MYSVC',
      DATA_TIMESTAMP_START => DATEADD(DAY, -7, CURRENT_TIMESTAMP()),
      RESULT_LIMIT => 20
    )
  )
WHERE
  refresh_trigger = 'MANUAL'
ORDER BY
  data_timestamp DESC;

Cortex Search 서비스의 새로고침 성능을 분석합니다:

SELECT
  name,
  data_timestamp,
  index_preprocessing_duration,
  indexing_duration,
  TIMEDIFF(SECOND, refresh_start_time, refresh_end_time) AS total_refresh_duration_sec,
  index_preprocessing_statistics:numInsertedRows AS rows_processed
FROM
  TABLE (
    INFORMATION_SCHEMA.CORTEX_SEARCH_REFRESH_HISTORY (
      NAME => 'MYSVC',
      DATA_TIMESTAMP_START => DATEADD(DAY, -30, CURRENT_TIMESTAMP())
    )
  )
WHERE
  state = 'SUCCEEDED'
ORDER BY
  data_timestamp DESC;

더 알아보기 (Learn more)

• Snowflake Information Schema