SHOW CORTEX SEARCH SERVICES

SHOW CORTEX SEARCH SERVICES

SHOW CORTEX SEARCH SERVICES 명령은 접근 권한(privilege)이 있는 Cortex Search 서비스 목록을 보여주는 명령이에요. Cortex Search 서비스는 벡터 검색·하이브리드 검색 기능을 제공하는 관리형 서비스로, 이를 통해 생성된 서비스들을 확인할 수 있어요.

출처: 문서

본문

이 명령은 접근 권한이 있는 Cortex Search 서비스를 나열해요.

구문 (Syntax)

SHOW CORTEX SEARCH SERVICES
  [ LIKE PATTERN '<pattern>' ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

  • STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 기본값: 없음.

  • LIMIT <rows> [ FROM <name_string> ] — 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요. FROM '<name_string>' 하위 절은 결과의 "커서" 역할을 해요. 객체 이름이 지정 문자열과 일치하는 첫 행 다음부터 지정한 개수의 행을 가져와요.

    • 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.
    • 문자열이 반드시 전체 객체 이름을 포함할 필요는 없어요. 부분 이름도 지원돼요.
    • 기본값: 없음.

    참고: STARTS WITH와 FROM 절을 모두 지원하는 SHOW 명령에서는 두 절을 같은 문장에서 결합할 수 있어요. 다만 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름 기준 사전 순으로 반환되므로 STARTS WITH 'A' LIMIT ... FROM 'B'는 결과가 없고, STARTS WITH 'B' LIMIT ... FROM 'A'는 결과를 반환해요.

출력 (Output)

명령 출력은 Cortex Search 서비스 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • created_on (TIMESTAMP_LTZ) — Cortex Search 서비스의 생성 시간.
  • name (TEXT) — 서비스 이름.
  • schema_name (TEXT) — 서비스가 위치한 스키마.
  • database_name (TEXT) — 서비스가 위치한 데이터베이스.
  • warehouse (TEXT) — 서비스 새로고침에 사용되는 웨어하우스.
  • target_lag (TEXT) — 서비스 콘텐츠가 기본 테이블의 업데이트보다 뒤처질 수 있는 최대 시간.
  • comment (TEXT) — 서비스와 연결된 주석.
  • definition (TEXT) — 서비스를 만드는 데 사용된 SQL 쿼리.
  • search_column (TEXT) — 검색 컬럼 이름.
  • attribute_columns (TEXT) — 서비스의 속성 컬럼(쉼표로 구분된 목록).
  • columns (TEXT) — 서비스의 컬럼(쉼표로 구분된 목록).
  • primary_key_columns (TEXT) — 서비스에 정의된 기본 키 컬럼 이름(쉼표로 구분된 목록). 기본 키가 설정되지 않았으면 비어 있어요.
  • scoring_profile_count (NUMBER) — 서비스에 정의된 명명된 점수 프로필(scoring profile) 수.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

mydb 데이터베이스의 PUBLIC 스키마에서 볼 권한이 있는 Cortex Search 서비스를 나열하는 예시예요:

USE DATABASE mydb;

SHOW CORTEX SEARCH SERVICES;

더 알아보기 (Learn more)