SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME

SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME

Business Critical 기능

이 기능에는 Business Critical(또는 그 이상) 에디션이 필요해요.

업그레이드에 대해 문의하려면 Snowflake 지원팀에 문의해요.

하나의 엔드포인트에서 두 개 이상의 호스트 이름을 지원하는 서비스(예: Microsoft Fabric 워크스페이스)에 연결하는 기존 프라이빗 연결 엔드포인트에 추가 호스트 이름을 추가해요. Snowflake가 같은 엔드포인트를 통해 두 개 이상의 호스트 이름에 도달해야 할 때 이 함수를 사용해요. 예를 들어 같은 Fabric 워크스페이스의 Iceberg REST 카탈로그 호스트 이름과 OneLake 스토리지 호스트 이름이 그런 경우예요.

참고

이 함수를 호출하기 전에 프라이빗 엔드포인트 연결이 대상 리소스에서 승인됨(Approved) 상태여야 해요. 연결이 아직 승인되지 않았다면 함수는 현재 연결 상태를 포함하는 오류를 반환해요.

출처: Snowflake SQL Reference - SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME

본문

구문

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

인자

'provider_resource_id'

  • 엔드포인트가 이미 연결하고 있는 VNet 내 리소스의 정규화된 식별자를 지정해요. SYSTEM$PROVISION_PRIVATELINK_ENDPOINT로 엔드포인트를 프로비저닝할 때 지정한 것과 같은 식별자예요.

'host_name'

  • 엔드포인트에 추가할 추가 정규화된 호스트 이름을 지정해요. Snowflake는 이 호스트 이름을 엔드포인트의 기존 호스트 이름과 함께 사용하며, 기존 것을 대체하지 않아요. 이 값은 포트 번호를 포함하지 않아요.

'subresource'

  • Azure 리소스의 하위 리소스 이름을 지정해요. 엔드포인트를 프로비저닝할 때 하위 리소스를 지정한 경우에만 이 값을 지정해요. 지원되는 모든 값은 하위 리소스 표(Sub-resource table)를 참고해요.

반환

호스트 이름이 프라이빗 연결 엔드포인트에 성공적으로 추가되었다는 상태 메시지, 또는 호스트 이름이 성공적으로 추가되지 않은 이유에 대한 세부 정보와 지침을 반환해요.

접근 제어 요구 사항

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

사용법 참고 사항

  • 이 함수는 Microsoft Azure에 호스팅된 Snowflake 계정에서만 지원돼요.
  • 단일 엔드포인트에서 여러 호스트 이름을 지원하는 리소스(예: Microsoft Fabric 워크스페이스 또는 고객 관리 Azure Private Link 서비스)에 연결하는 엔드포인트에만 호스트 이름을 추가할 수 있어요. 단일 고정 호스트 이름만 지원하는 리소스(예: Azure Storage 계정, Azure Key Vault, Azure Database for PostgreSQL 유연한 서버)에 연결하는 엔드포인트에는 호스트 이름을 추가할 수 없어요.
  • 추가하는 호스트 이름은 엔드포인트의 기본 호스트 이름이나 같은 엔드포인트에 이미 등록된 다른 추가 호스트 이름과 충돌할 수 없어요.
  • 이 함수로 추가한 호스트 이름을 제거하려면 SYSTEM$REMOVE_PRIVATELINK_ENDPOINT_HOSTNAME을 사용해요.
  • SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT로 엔드포인트를 프로비저닝 해제하면 엔드포인트의 모든 추가 호스트 이름이 제거돼요.

예제

Microsoft Fabric 워크스페이스에 연결하는 기존 엔드포인트에 OneLake 스토리지 호스트 이름을 추가해, Snowflake가 Iceberg REST 카탈로그 호스트 이름과 OneLake 스토리지 호스트 이름 모두에 같은 엔드포인트로 도달할 수 있게 해요.

SELECT SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME(
  '/subscriptions/e29b4130-0198-4a5d-9f2c-7db3c8a1e6f4/resourceGroups/fabric-sandbox-rg/providers/Microsoft.Fabric/privateLinkServicesForFabric/fabric-workspace-capacity',
  '00112233445566778899aabbccddeeff.z01.dfs.fabric.microsoft.com',
  'workspace'
  );

Successfully added the host name 00112233445566778899aabbccddeeff.z01.dfs.fabric.microsoft.com to the privatelink endpoint /subscriptions/e29b4130-0198-4a5d-9f2c-7db3c8a1e6f4/resourceGroups/fabric-sandbox-rg/providers/Microsoft.Fabric/privateLinkServicesForFabric/fabric-workspace-capacity

더 알아보기