SHOW GATEWAYS

SHOW GATEWAYS 명령은 접근 권한(privilege)이 있는 게이트웨이(gateway) 목록을 보여주는 명령이에요. Snowpark Container Services의 게이트웨이 객체들을 확인할 때 사용해요.

출처: 문서

본문

이 명령은 접근 권한이 있는 게이트웨이를 나열해요.

기능 상태: 일반 공급(Generally Available). Snowpark Container Services는 일부 예외를 제외하고 AWS, Microsoft Azure, Google Cloud Platform 상용 리전의 계정에서 사용할 수 있어요.

구문 (Syntax)

SHOW GATEWAYS [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>
                }
           ]
           [ STARTS WITH '<name_string>' ]
           [ LIMIT <rows> [ FROM '<name_string>' ] ]

파라미터 (Parameters)

LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
[ IN ... ] — 명령의 범위를 선택적으로 지정해요:
- ACCOUNT — 전체 계정의 레코드 반환.
- DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환.
- SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환.
- IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.
STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.
LIMIT <rows> [ FROM <name_string> ] — 최대 행 수를 제한하면서 결과의 "페이지네이션"을 가능하게 해요. FROM '<name_string>' 하위 절은 결과의 "커서" 역할을 해요.

참고: STARTS WITH와 FROM 절을 모두 지원하는 SHOW 명령에서는 두 절을 같은 문장에서 결합할 수 있어요. 다만 두 조건이 모두 충족되어야 하며, 그렇지 않으면 서로 상쇄되어 결과가 반환되지 않아요.

출력 (Output)

명령 출력은 게이트웨이 속성과 메타데이터를 다음 컬럼으로 제공해요:

created_on — 게이트웨이가 생성된 날짜·시간.
name — 게이트웨이 이름.
database_name — 게이트웨이가 생성된 데이터베이스.
schema_name — 게이트웨이가 생성된 스키마.
owner — 게이트웨이를 소유한 역할.
owner_role_type — 객체를 소유한 역할 유형(ROLE 또는 DATABASE_ROLE).
gateway_type — 게이트웨이 유형.
traffic_split — 대상 엔드포인트 간에 요청을 라우팅하는 게이트웨이.
shadow_traffic — 기본 엔드포인트로 요청을 라우팅하고 섀도 엔드포인트로 요청을 미러링하는 게이트웨이.
comment — 게이트웨이 관련 주석.

참고: 사용된 역할이 USAGE, MODIFY, 또는 OWNERSHIP 권한을 가진 게이트웨이만 표시돼요.

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

이 SQL 명령을 실행하는 역할은 최소한 다음 권한 중 하나를 가져야 해요:

권한 (Privilege)	객체 (Object)	비고
USAGE, MODIFY, OWNERSHIP 중 하나	게이트웨이	역할이 이 권한 중 하나를 가진 게이트웨이만 표시.
USAGE	데이터베이스	게이트웨이가 있는 데이터베이스에 필요.
USAGE	스키마	게이트웨이가 있는 스키마에 필요.

사용 참고 사항 (Usage notes)

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

예제 (Examples)

특정 스키마의 게이트웨이를 나열해요:

SHOW GATEWAYS IN SCHEMA db.schema;

세션의 현재 데이터베이스·스키마의 게이트웨이를 나열해요:

SHOW GATEWAYS;

이름에 "split"이 포함된 게이트웨이를 나열해요:

SHOW GATEWAYS LIKE '%split%';

게이트웨이 하나를 나열해요:

SHOW GATEWAYS LIMIT 1;

더 알아보기 (Learn more)

CREATE GATEWAY — 게이트웨이 만들기
ALTER GATEWAY — 게이트웨이 수정
DESCRIBE GATEWAY — 게이트웨이 상세 확인