SHOW CLASSES
SHOW CLASSES
사용 가능한 모든 클래스(classes)를 나열하는 명령이에요.
출처: 문서
본문
구문 (Syntax)
SHOW CLASSES [ LIKE '<pattern>' ]
[ IN DATABASE [ <db_name> ] ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
파라미터
- LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 대소문자 무시 패턴 매칭을 사용하며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
- IN DATABASE db_name — 명령의 범위를 지정해요. 이 값은 현재/지정된 데이터베이스의 레코드만 나열할지, 아니면 전체 계정에 걸쳐 나열할지 결정해요. DATABASE 키워드는 필수가 아니며, 데이터베이스 이름만 지정해도 범위를 설정할 수 있어요. 마찬가지로 세션에 현재 사용 중인 데이터베이스가 있다면 데이터베이스 이름도 필요 없어요. 기본값: 세션에 현재 사용 중인 데이터베이스가 있는지에 따라 달라요. 데이터베이스가 있으면 DATABASE가 기본(해당 데이터베이스에서 볼 권한이 있는 객체 반환), 없으면 ACCOUNT가 기본(계정에서 볼 권한이 있는 객체 반환).
- STARTS WITH 'name_string' — 객체 이름 시작 부분의 문자를 기반으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요. 기본값: 없음.
- LIMIT rows [ FROM 'name_string' ] — 반환되는 최대 행 수를 선택적으로 제한하면서 결과의 "페이지네이션"을 가능하게 해요. 선택적
FROM 'name_string'하위 절은 사실상 결과의 "커서" 역할을 해요. 객체 이름이 지정된 문자열과 일치하는 첫 행 다음의 지정된 행 수를 가져올 수 있게 해줘요. 문자열은 작은따옴표로 묶고 대소문자를 구분하며, 전체 객체 이름을 포함할 필요는 없어요(부분 이름 지원). 기본값: 없음.
참고:
FROM 'name_string'과STARTS WITH 'name_string'절을 모두 지원하는 SHOW 명령에서는 같은 문에 두 절을 모두 결합할 수 있어요. 하지만 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요. 또한 객체는 이름별로 사전식 순서로 반환되므로FROM 'name_string'은STARTS WITH 'name_string'이 반환하는 행보다 사전식 값이 더 큰 행만 반환해요.
사용 메모 (Usage notes)
- owner와 owner_role_type 열은 값을 반환하지 않아요.
- 이 명령은 실행에 실행 중인 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 최소한 하나의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS접근 권한은 보유자가 계정의 모든 객체를 볼 수 있게 암시적으로 허용해요. 기본적으로 계정 관리자(ACCOUNTADMIN)와 보안 관리자(SECURITYADMIN)만 이 권한을 가져요.- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 출력 열 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해요(예:SELECT "type"). - LIMIT rows 값은 10000을 초과할 수 없어요. LIMIT rows를 생략하면 결과 집합이 1만 행보다 크면 명령이 오류를 일으켜요. 1만 개 이상의 레코드가 있는 결과를 보려면 LIMIT rows를 포함하거나 해당하는 Snowflake Information Schema 뷰를 쿼리해요.
예시 (Examples)
Snowflake 데이터베이스의 모든 클래스를 표시해요:
SHOW CLASSES IN DATABASE SNOWFLAKE;
+-------------------------------+-----------------------+---------------+-------------+---------+---------+-------+------------------+-----------------+
| created_on | name | database_name | schema_name | version | comment | owner | is_service_class | owner_role_type |
|-------------------------------+-----------------------+---------------+-------------+---------+---------+-------|------------------|-----------------+
| 2023-04-17 11:48:31.222 -0700 | ANOMALY_DETECTION | SNOWFLAKE | ML | NULL | NULL | | false | |
| 2023-05-26 10:01:24.852 -0700 | FORECAST | SNOWFLAKE | ML | NULL | NULL | | false | |
+-------------------------------+-----------------------+---------------+-------------+---------+---------+-------+------------------+-----------------+