SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME

Business Critical 기능. 이 기능은 Business Critical(또는 그 이상)이 필요해요. 업그레이드에 대해 문의하려면 Snowflake Support에 문의해요.

기존 프라이빗 연결 엔드포인트의 호스트 이름만 수정해요.

참고: Snowflake 계정이 Azure 정부 지역에 있으면 프로바이더 리소스 ID가 정부 구독의 리소스 ID여야 해요. Snowflake 고객을 위한 정부 지역에 대한 자세한 내용은 U.S. SnowGov Regions을 참고해요.

출처: Snowflake SQL Reference - SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME

본문

구문

AWS:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<provider_service_name>' , '<host_name>' )

Azure:

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

Google Cloud:

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME( '<target_service_id>' , '<host_name>' )

인자

AWS:

연결할 외부 서비스 또는 리소스를 지정해요. 예: Amazon API Gateway의 경우 com.amazonaws.us-west-2.execute-api, Amazon S3의 경우 com.amazonaws.us-west-2.s3. AWS에서 이 값을 검색하는 방법은 Provision private connectivity endpoints를 참고해요.
VPC 또는 VNet의 리소스에 접근하는 데 사용해야 하는 새 완전 정규화 호스트 이름을 지정해요. 이 값은 포트 번호를 포함하지 않으며, 외부 서비스에 연결하는 데 사용하는 Snowflake 객체에 지정한 값과 일치해야 해요. 예로는 bedrock-runtime.us-west-2.amazonaws.com과 *.s3.us-west-2.amazonaws.com이 있어요. 외부 스테이지 및 외부 볼륨에 프라이빗 연결을 사용할 때 host_name은 AWS S3 버킷을 지정하는 대신 와일드카드를 사용해야 해요. AWS에서 이 값을 검색하는 방법은 Provision private connectivity endpoints를 참고해요.

Azure:

VPC 또는 VNet의 리소스에 대한 완전 정규화 식별자를 지정해요.
VPC 또는 VNet의 리소스에 접근할 새 완전 정규화 호스트 이름을 지정해요. 외부 함수에 대한 아웃바운드 프라이빗 연결의 호스트 이름 예시는 다음 주제를 참고해요.
- Azure Portal
- Azure ARM template
Azure 리소스의 하위 리소스 이름을 지정해요. 이 인자는 Azure Private Link Service와 Azure API Management Service에는 필요하지 않아요. 지원되는 모든 값은 Sub-resource 테이블을 참고해요.

Google Cloud:

연결할 서비스 연결 ID(사용자 지정 서비스에 대한) 또는 지역 Google API 엔드포인트를 지정해요.
리소스에 접근할 새 완전 정규화 호스트 이름을 지정해요.

반환 값

프라이빗 연결 엔드포인트의 호스트 이름이 성공적으로 업데이트되었다는 상태 메시지를 반환해요.

접근 제어 요구 사항

계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 함수를 호출할 수 있어요.

사용상 주의사항

기존 프라이빗 연결 엔드포인트의 호스트 이름만 수정할 수 있어요.
Microsoft Azure에서 이 함수는 SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME을 사용해 같은 엔드포인트에 이미 등록된 추가 호스트 이름과 충돌하는 새 호스트 이름을 거부해요.

예시

AWS:

Snowflake on Amazon Web Services가 Amazon Web Services VPC의 VPCE 서비스에 연결할 수 있도록 프라이빗 엔드포인트의 호스트 이름을 업데이트해요.

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef',
  'my-new-service-name.com'
  );

Successfully set the host name of the privatelink endpoint ``com.amazonaws.vpce.us-west-2.vpce-svc-01234567890abcdef`` to ``my-new-service-name.com``

Azure:

Snowflake on Microsoft Azure가 Microsoft Azure VNet의 Microsoft Azure API Management 서비스에 연결할 수 있도록 프라이빗 엔드포인트의 호스트 이름을 업데이트해요.

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'my-new-custom-api-endpoint.net',
  'Gateway'
  );

Successfully set the host name of the privatelink endpoint ``/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api`` to ``my-new-custom-api-endpoint.net``

Google Cloud:

Snowflake on Google Cloud Platform이 Google Cloud Platform VPC 네트워크의 서비스 연결에 연결할 수 있도록 프라이빗 엔드포인트의 호스트 이름을 업데이트해요.

SELECT SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME(
  'projects/my-project/regions/us-west2/serviceAttachments/my-http-server',
  'my-new-custom-api-endpoint.com'
  );

Successfully set the host name of the privatelink endpoint ``projects/my-project/regions/us-west2/serviceAttachments/my-http-server`` to ``my-new-custom-api-endpoint.com``

SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME