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:

'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의 리소스에 액세스하기 위해 정규화된 새 호스트 이름을 지정합니다.

외부 함수를 위한 아웃바운드 비공개 연결의 호스트 이름 예제는 다음 항목을 참조하세요.

• Azure Portal

• Azure ARM 템플릿.

'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'
  );

Copy

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'
  );

Copy

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'
  );

Copy

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``