SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS

SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS

Snowflake 서비스로의 연결을 라우팅할 수 있는 등록된 프라이빗 엔드포인트를 반환하는 시스템 함수예요. AWS/Azure의 PrivateLink 연결을 관리할 때 씁니다.

출처: Snowflake SQL Reference

본문

Business Critical 기능: 이 기능은 Business Critical 이상 에디션을 필요로 해요. 업그레이드 문의는 Snowflake Support로 연락하세요.

SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS()

인자는 없어요.

등록된 프라이빗 연결 엔드포인트를 각각 지정하는 JSON 객체 목록을 반환해요. 계정에 등록된 프라이빗 연결 엔드포인트가 없으면 빈 JSON 배열("[]")이 담긴 문자열을 반환해요.

각 필드는 다음과 같아요.

  • consumerEndpointId — 등록된 VPC 엔드포인트를 포함한 AWS 계정 ID 또는 등록된 프라이빗 엔드포인트를 포함한 Azure 리소스 그룹 식별자.
  • consumerEndpointType — 등록된 프라이빗 연결 엔드포인트의 유형.
  • pinnedConsumerEndpointId — Snowflake에 등록된 프라이빗 연결 엔드포인트 식별자.
  • providerServiceEndpoint — Snowflake VPC의 프라이빗 연결 서비스 엔드포인트 식별자.

사용 메모: 계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 호출할 수 있어요.

예시 (AWS):

use role accountadmin;

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINT_REGISTRATIONS();
[
  {
    "consumerEndpointId": "148896251...",
    "consumerEndpointType": "Aws Id",
    "pinnedConsumerEndpointId": "vpce-0be92fc5953c0...",
    "providerServiceEndpoint": "vpce-svc-0dcda6d2e9d14..."
  }
]

더 알아보기 (Learn more)