DESCRIBE GATEWAY¶
:doc:`게이트웨이</developer-guide/snowpark-container-services/gateway>`의 속성을 설명합니다.
DESCRIBE는 DESC로 축약할 수 있습니다.
- 참고 항목:
CREATE GATEWAY , ALTER GATEWAY, DROP GATEWAY , SHOW GATEWAYS
구문¶
DESC[RIBE] GATEWAY <name>
매개 변수¶
name설명할 게이트웨이의 식별자를 지정합니다.
식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.
출력¶
명령 출력으로 게이트웨이 속성과 메타데이터가 다음과 같은 열로 구성됩니다.
열 |
설명 |
|---|---|
|
게이트웨이 이름입니다. |
|
게이트웨이 수신 URL입니다. |
|
PrivateLink 수신 URL입니다. |
|
게이트웨이가 생성되는 데이터베이스입니다. |
|
게이트웨이가 생성되는 스키마입니다. |
|
게이트웨이를 소유한 역할입니다. |
|
오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다. |
|
게이트웨이 사양(YAML형식)입니다. 이 열은 명령을 실행하는 역할에 게이트웨이에 대한 USAGE, MODIFY, OWNERSHIP 권한이 있는 경우에만 표시됩니다. |
|
게이트웨이가 생성된 타임스탬프입니다. |
|
게이트웨이가 마지막으로 업데이트된 타임스탬프입니다. |
|
게이트웨이 관련 설명입니다. |
참고
사용된 역할에 게이트웨이에 대한 USAGE, MODIFY, OWNERSHIP 권한이 있는 경우 spec 열이 표시됩니다. 그렇지 않은 경우 다른 열은 표시되지만 spec 열은 표시되지 않습니다.
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
USAGE, MODIFY 또는 OWNERSHIP |
게이트웨이 |
이러한 권한으로 게이트웨이를 설명할 수 있습니다. 이러한 권한이 있는 역할만 사양을 확인할 수 있습니다. |
USAGE |
데이터베이스 |
게이트웨이가 포함된 데이터베이스에 필요합니다. |
USAGE |
스키마 |
게이트웨이가 포함된 스키마에 필요합니다. |
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 후처리하기 위해 파이프 연산자 (
->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.예를 들어, 파이프 연산자 또는 RESULT_SCAN 함수를 사용하여 SHOW 명령 출력에서 특정 열을 선택하거나 행을 필터링할 수 있습니다.
출력 열을 참조하는 경우 열 이름에 :ref:`큰따옴표로 묶인 식별자<label-delimited_identifier>`를 사용합니다. 예를 들어, 출력 열 ``type``을 선택하려면 ``SELECT “type”``을 지정합니다.
SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶인 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록 또는 WHERE 절의 열 이름이 스캔된 SHOW 명령 출력과 일치하도록 보장합니다.
예¶
다음 예제에서는 ``split_gateway``라는 게이트웨이에 대해 설명합니다.
DESCRIBE GATEWAY split_gateway;