SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS

현재 계정이 Snowflake 서비스에 대한 프라이빗 연결(privately connectivity)에 사용할 승인된 엔드포인트 목록을 반환해요.

출처: Snowflake SQL Reference - SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS

본문

명령 출력의 엔드포인트 값은 다음 함수를 사용할 때 aws_id 또는 private-endpoint-resource-id의 값으로 사용할 수 있어요.

  • SYSTEM$GET_PRIVATELINK

  • SYSTEM$AUTHORIZE_PRIVATELINK

  • SYSTEM$REVOKE_PRIVATELINK

구문

SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS()

인자

없음.

반환 값

키가 endpoint Id Type을 나타내고 값이 endpoint Id를 나타내는 키-값 쌍을 보여주는 JSON 객체 목록을 반환해요. Azure의 경우 SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS는 엔드포인트 ID와 링크 식별자(Link Identifier) 두 값을 반환해요.

AWS:

endpoint Id Type

AWS 엔드포인트의 타입을 나타내는 문자열 라벨이에요.

endpoint Id

Snowflake 엔드포인트 서비스에 연결하도록 승인된 AWS 계정 ID예요.

Azure:

endpoint Id Type

Azure 엔드포인트의 타입을 나타내는 문자열 값이에요.

endpoint Id

Snowflake privatelink 서비스에 연결하도록 승인된 Azure 리소스 ID예요.

link Identifier

Azure 리소스 ID와 연결된 엔드포인트의 링크 ID예요.

GCP:

endpoint Id Type

Google Cloud 엔드포인트의 타입을 나타내는 문자열 값이에요.

endpoint Id

Snowflake 서비스 첨부에 프라이빗 서비스 연결 엔드포인트를 만들도록 승인된 Google Cloud 프로젝트 ID예요.

사용 시 참고 사항

  • 계정 관리자(즉, ACCOUNTADMIN 역할을 가진 사용자)만 이 함수를 실행할 수 있어요.

  • 이 함수는 Amazon Web Services (AWS), Microsoft Azure (Azure) 및 Google Cloud의 Snowflake 계정에서 사용할 수 있어요.

예시

AWS:

AWS의 Snowflake 계정에 대해 AWS PrivateLink와 함께 사용할 승인된 엔드포인트를 반환해요.

use role accountadmin;
select system$get_privatelink_authorized_endpoints();

선택적으로 다음 명령을 사용해 쿼리 결과를 평면화할 수 있어요. 예를 들어:

select
 value: endpointId
from
 table(
 flatten(
 input => parse_json(system$get_privatelink_authorized_endpoints())
 )
 );

(AWS의 Snowflake 계정에 대한 엔드포인트) 반환:

+----------------------+---------------------+
| KEY:ENDPOINT ID TYPE | VALUE:ENDPOINT ID   |
+----------------------+---------------------+
| "123456789012"       | "123456789012"      |
+----------------------+---------------------+

더 알아보기