SYSTEM$RESTORE_PRIVATELINK_ENDPOINT

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT

Snowflake VPC 또는 VNet 안의 프라이빗 연결 엔드포인트를 복원해서, Snowflake가 프라이빗 연결로 외부 서비스에 접속할 수 있게 하는 시스템 함수예요. 엔드포인트는 호스팅 클라우드 플랫폼에 따라 서비스 엔드포인트일 수도, 리소스 엔드포인트일 수도 있어요.

출처: 공식 문서

본문

Business Critical 기능

이 기능은 Business Critical(또는 그 이상)이 필요합니다.

업그레이드 문의는 Snowflake Support에 연락하세요.

Snowflake VPC 또는 VNet에서 프라이빗 연결 엔드포인트를 복원해, Snowflake가 프라이빗 연결을 사용해 외부 서비스에 접속할 수 있게 합니다. 엔드포인트는 Snowflake 계정을 호스팅하는 클라우드 플랫폼에 따라 서비스 엔드포인트이거나 리소스 엔드포인트일 수 있습니다.

프라이빗 엔드포인트를 프로비저닝 해제한 뒤 7일 이내에 복원할 수 있습니다. 7일이 지나면 엔드포인트는 복원할 수 없으며, SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 시스템 함수로 엔드포인트를 다시 만들어야 합니다.

구문 (Syntax)

AWS:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '<provider_service_name>' )

Azure:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '<provider_resource_id>'
  [, '<subresource>' ]
  )

Google Cloud:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
   '<service_attachment_id>'
);

인자 (Arguments)

AWS

provider_service_name

복원할 외부 서비스 또는 리소스 엔드포인트를 지정합니다. 예를 들어 Amazon API Gateway용 com.amazonaws.us-west-2.execute-api나 Amazon S3용 com.amazonaws.us-west-2.s3입니다.

Azure

'provider_resource_id'

VPC 또는 VNet 안 리소스의 완전히 한정된 식별자를 지정합니다.

'subresource'

Azure 리소스의 하위 리소스(subresource) 이름을 지정합니다. 이 인자는 Azure Private Link Service와 Azure API Management Service에는 필요하지 않습니다. 지원되는 모든 값은 Sub-resource 표를 참고하세요.

Google Cloud

'target_service_id'

VPC 네트워크 또는 리전 Google API 안의 서비스 첨부(service attachment) ID를 지정합니다.

반환값 (Returns)

엔드포인트가 해당 식별자와 함께 성공적으로 복원되었다는 상태 메시지를 반환합니다.

실패하면 오류를 반환합니다. 예를 들어 제공된 인자가 유효한 기존 엔드포인트가 아닌 경우입니다. 엔드포인트 이름을 모른다면 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 시스템 함수를 사용해 Snowflake 계정의 모든 엔드포인트를 나열할 수 있습니다.

사용 참고 (Usage notes)

  • 계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 함수를 호출할 수 있습니다.
  • 지정된 인자와 연관된 프라이빗 연결 엔드포인트가 없으면 오류 메시지가 발생합니다.

예제 (Examples)

AWS:

Amazon S3에 대한 외부 접근이 있는 프라이빗 엔드포인트를 복원합니다:

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');

Azure:

Azure VNet의 Azure API Management 서비스에 Microsoft Azure의 Snowflake가 접속하도록 프라이빗 엔드포인트를 복원합니다:

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/my_rg/providers/Microsoft.Sql/servers/my_db_server',
  'sqlServer'
);

Private endpoint with id ''/subscriptions/66666666-7777-8888-9999-0000000000/resourcegroups/rg/providers/microsoft.network/privateendpoints/00000000-1111-2222-3333-4444444444'' restored successfully.

Google Cloud:

Google Cloud VPC Network의 Google API Management 서비스에 Google Cloud의 Snowflake가 접속하도록 프라이빗 엔드포인트를 복원합니다:

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  'projects/my-project/regions/us-east4/serviceAttachments/my-service-attachment'
);

Private endpoint with id ''abcd0000000000000001'' restored successfully.

더 알아보기 (Learn more)