SHOW CORTEX BASE MODELS

SHOW CORTEX BASE MODELS 명령은 현재 역할이 사용할 수 있는 Cortex Base Model 목록을 생명 주기 상태(lifecycle status), 리전 내·교차 리전 가용성, 레거시 날짜, 종료(EOL) 날짜와 함께 보여주는 명령이에요.

출처: 문서

본문

Cortex Base Models는 Snowflake가 Cortex AI Functions 및 관련 기능과 함께 사용하도록 제공하는 LLM이에요. 모든 모델 객체(사용자 생성 모델 포함)를 나열하는 SHOW MODELS와 달리, 이 명령은 Cortex Base Models로 범위가 한정되며 각 모델의 생명 주기 단계와 가용성을 설명하는 추가 컬럼을 반환해요. 현재 역할에 현재 어떤 모델이 사용 가능한지 확인할 때 사용해요.

구문 (Syntax)

SHOW CORTEX BASE MODELS
  [ LIKE '<pattern>' ]
  [ IN [ SCHEMA ] SNOWFLAKE.MODELS ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> ]

파라미터 (Parameters)

LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
IN [ SCHEMA ] SNOWFLAKE.MODELS — 모든 Cortex Base Model 객체가 저장된 SNOWFLAKE.MODELS 스키마로 명령 범위를 한정해요. Snowflake는 이 절을 지정할 것을 권장해요. 이 절을 생략하면 표준 SHOW 범위 규칙을 따르는데, Cortex Base Models는 SNOWFLAKE.MODELS에만 존재하므로 다른 데이터베이스가 현재라면 현재 역할이 필요한 모델 권한을 가졌어도 커맨드가 0행을 반환해요. 세션의 현재 데이터베이스와 무관하게 Cortex Base Models를 나열하려면 IN SCHEMA SNOWFLAKE.MODELS를 지정해요.
STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 기본값: 없음.
LIMIT <rows> — 반환되는 최대 행 수를 제한해요. 기본값: 없음.

출력 (Output)

명령 출력은 다음 컬럼을 제공해요:

created_on — 모델 객체가 생성된 날짜·시간.
name — Cortex Base Model 이름.
model_type — 모델 객체 유형. Cortex Base Models의 경우 CORTEX_BASE.
database_name — 모델이 저장된 데이터베이스.
schema_name — 모델이 저장된 스키마.
owner — 모델 객체를 소유한 역할.
lifecycle_status — 모델의 현재 생명 주기 단계. 아직 단계가 할당되지 않은 모델은 NULL. 가능한 값:
- GA — 일반 공급. 모델이 완전히 지원되며 프로덕션 사용에 권장.
- PUPR — 공개 프리뷰. 모든 계정에 사용 가능하지만 제한이 있을 수 있어요.
- PRPR — 비공개 프리뷰. 특별히 활성화된 계정에서만 사용 가능.
- LEGACY — 레거시 기간에 진입. 레거시 날짜 이전에 모델을 사용했던 계정은 종료일까지 계속 사용할 수 있어요. 사용하지 않던 계정은 새로 사용을 시작할 수 없어요. 이 모델 사용은 권장되지 않으며, 종료 전에 지원되는 모델로 마이그레이션해요.
- EOL — 수명 종료. 더 이상 어떤 계정에도 사용할 수 없어요. 모델을 지정하는 쿼리·API 호출은 실패해요.
in_region_availability — 모델이 (교차 리전 추론 없이) 해당 리전에서 직접 배포·제공되는 Snowflake 리전 배열, 예: ["AWS_US_EAST_1", "AZURE_EASTUS2"]. Snowflake가 어떤 리전에서도 직접 호스팅하지 않는 모델(교차 리전 추론으로만 사용 가능)은 이 컬럼이 NULL이에요. 활성 리전 내 배포가 없는 모델(예: EOL 상태)은 빈 배열이에요.
legacy_date — 모델이 레거시 기간에 진입했거나 진입할 날짜를 자유 형식 문자열로 표시. 모델이 레거시로 표시되지 않았으면 NULL.
eol_date — 모델의 수명 종료 표시를 자유 형식 문자열로 표시. 보통 날짜(예: 2026-04-28)지만 설명 텍스트(예: No sooner than 2027/01/01)일 수도 있어요. 종료일이 설정되지 않았으면 NULL.
cross_region_availability — 모델에 도달할 수 있는 교차 리전 추론 설정 배열, 예: ["ANY_REGION", "AWS_US", "AWS_EU", "AWS_APJ"]. 이 값들은 CORTEX_ENABLED_CROSS_REGION 파라미터에 설정할 수 있는 값과 대응돼요. 목록이 비어 있지 않으면 항상 ANY_REGION을 포함해요. 교차 리전 가용성이 없는 모델이면 NULL.

접근 제어 요구 사항 (Access control requirements)

출력은 사용자의 모델 RBAC 부여(grants)에 따라 필터링돼요. 현재 역할에 접근 권한이 부여된 모델만 결과에 나타나요. 명령이 SNOWFLAKE가 아닌 다른 데이터베이스로 범위가 한정되면, 해당 부여가 있어도 결과가 비어 있을 수 있어요. Cortex Base Models에 대한 접근 부여에 대한 자세한 내용은 모델 접근 및 권한을 참고해요.

참고: SNOWFLAKE.MODELS 스키마는 Cortex Base Model 객체로 자동 채워지며 Snowflake 관리 태스크 SNOWFLAKE.MODELS.CORTEX_BASE_MODELS_REFRESH_TASK가 매일 새로고침해요. TASK_HISTORY에 해당 태스크의 간헐적 FAILED 실행이 보여도 조치가 필요 없어요. 다음 날짜 실행이 보통 성공해요. 새 모델을 다음 일일 새로고침까지 기다리지 않고 바로 보려면 ACCOUNTADMIN이 새로고침 저장 프로시저를 요청 시 실행할 수 있어요:

CALL SNOWFLAKE.MODELS.CORTEX_BASE_MODELS_REFRESH();

자세한 내용은 모델 객체·앱 역할 새로고침을 참고해요.

사용 참고 사항 (Usage notes)

Cortex Base Models는 SNOWFLAKE.MODELS에만 존재해요. SHOW CORTEX BASE MODELS IN SCHEMA SNOWFLAKE.MODELS를 사용해 세션의 현재 데이터베이스로 범위가 한정되지 않게 해요. IN SCHEMA SNOWFLAKE.MODELS를 생략하면 현재 역할이 올바른 CORTEX-MODEL-ROLE-* 부여를 가졌어도 0행을 반환할 수 있어요.
이 명령은 Cortex Base Models만 반환해요. 계정의 모든 모델 객체(사용자 모델 포함)를 나열하려면 SHOW MODELS를 사용해요.
결과에 어떤 리전의 모델이 나타나도, 계정이 다른 리전에 있고 교차 리전 추론이 활성화되지 않았다면 해당 모델을 호출하지 못할 수 있어요. in_region_availability와 cross_region_availability 컬럼을 사용해 어떤 교차 리전 설정이 모델에 도달할 수 있는지 확인해요.
실행에 실행 중인 웨어하우스를 요구하지 않아요.
현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

예제 (Examples)

현재 역할이 접근할 수 있는 모든 Cortex Base Models를 나열해요. 세션의 현재 데이터베이스로 목록이 한정되지 않도록 IN SCHEMA SNOWFLAKE.MODELS를 지정해요:

SHOW CORTEX BASE MODELS IN SCHEMA SNOWFLAKE.MODELS;

이름에 claude가 포함된 Cortex Base Models를 나열해요:

SHOW CORTEX BASE MODELS LIKE '%claude%' IN SCHEMA SNOWFLAKE.MODELS;

더 알아보기 (Learn more)

SHOW MODELS — 모든 모델 객체 나열
모델 접근 및 권한 — 모델 접근 부여