DESCRIBE GATEWAY

:doc:`게이트웨이</developer-guide/snowpark-container-services/gateway>`의 속성을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

CREATE GATEWAY , ALTER GATEWAY, DROP GATEWAY , SHOW GATEWAYS

구문

DESC[RIBE] GATEWAY <name>
Copy

매개 변수

name

설명할 게이트웨이의 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력

명령 출력으로 게이트웨이 속성과 메타데이터가 다음과 같은 열로 구성됩니다.

설명

name

게이트웨이 이름입니다.

ingress_url

게이트웨이 수신 URL입니다.

privatelink_ingress_url

PrivateLink 수신 URL입니다.

database_name

게이트웨이가 생성되는 데이터베이스입니다.

schema_name

게이트웨이가 생성되는 스키마입니다.

owner

게이트웨이를 소유한 역할입니다.

owner_role_type

오브젝트를 소유하는 역할의 유형(ROLE 또는 DATABASE_ROLE)입니다.

spec

게이트웨이 사양(YAML형식)입니다. 이 열은 명령을 실행하는 역할에 게이트웨이에 대한 USAGE, MODIFY, OWNERSHIP 권한이 있는 경우에만 표시됩니다.

created_on

게이트웨이가 생성된 타임스탬프입니다.

updated_on

게이트웨이가 마지막으로 업데이트된 타임스탬프입니다.

comment

게이트웨이 관련 설명입니다.

참고

사용된 역할에 게이트웨이에 대한 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;
Copy