- 카테고리:
시스템 함수 (시스템 제어)
SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME¶
기존 비공개 연결 엔드포인트 의 호스트 이름만 수정합니다.
참고
Snowflake 계정이 Azure 정부 리전에 있는 경우 공급자 리소스 ID 는 정부 구독에 있는 리소스의 ID 여야 합니다. Snowflake 고객을 위한 정부 리전에 대한 자세한 내용은 미국 SnowGov 리전 섹션을 참조하십시오.
구문¶
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:
'provider_service_name'
연결할 외부 서비스 또는 리소스를 지정합니다. 예: Amazon API 게이트웨이의 경우
com.amazonaws.us-west-2.execute-api
, Amazon S3의 경우com.amazonaws.us-west-2.s3
.AWS 에서 이 값을 검색하는 방법에 대한 자세한 내용은 비공개 연결 엔드포인트 프로비저닝 섹션을 참조하십시오.
'host_name'
VPC 또는 VNet의 리소스에 액세스하는 데 사용해야 하는 새 정규화된 호스트 이름을 지정합니다.
이 값에는 포트 번호가 포함되지 않으며 외부 서비스에 연결하기 위해 사용하는 Snowflake 오브젝트에서 지정한 것과 일치해야 합니다.
예제에는
bedrock-runtime.us-west-2.amazonaws.com
및*.s3.us-west-2.amazonaws.com
이 포함됩니다.외부 스테이지 및 외부 볼륨에 비공개 연결을 사용하는 경우,
host_name
은 AWS S3 버킷을 지정하는 대신 와일드카드를 사용해야 합니다.AWS 에서 이 값을 검색하는 방법에 대한 자세한 내용은 비공개 연결 엔드포인트 프로비저닝 섹션을 참조하십시오.
Azure:
'provider_resource_id'
VPC 또는 VNet에 있는 리소스에 대한 정규화된 식별자를 지정합니다.
'host_name'
VPC 또는 VNet의 리소스에 액세스하기 위해 정규화된 새 호스트 이름을 지정합니다.
외부 함수를 위한 아웃바운드 비공개 연결의 호스트 이름 예제는 다음 항목을 참조하세요.
'subresource'
Azure 리소스의 하위 리소스 이름을 지정합니다.
Azure Private Link Service 및 Azure API 관리 서비스에는 이 인자가 필요하지 않습니다.
지원되는 모든 값은 하위 리소스 테이블 섹션을 참조하십시오.
Google Cloud:
'target_service_id'
서비스 연결 대상 ID(사용자 지정 서비스에 대한) 또는 연결할 리전 Google API 엔드포인트를 지정합니다.
'host_name'
리소스에 액세스하기 위한 새 정규화된 호스트 이름을 지정합니다.
반환¶
비공개 연결 엔드포인트의 호스트 이름이 성공적으로 업데이트되었다는 상태 메시지를 반환합니다.
사용법 노트¶
ACCOUNTADMIN 역할이 있는 사용자만 이 함수를 호출할 수 있습니다.
기존 비공개 연결 엔드포인트의 호스트 이름만 수정할 수 있습니다.
예¶
- AWS:
|aws|의 Snowflake가 |aws| 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:
|azure|의 Snowflake가 |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:
|gcp|의 Snowflake가 |gcp| 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.net