SYSTEM$REMOVE_PRIVATELINK_ENDPOINT_HOSTNAME

SYSTEM$REMOVE_PRIVATELINK_ENDPOINT_HOSTNAME

기존 private connectivity 엔드포인트에서 추가 호스트 이름을 제거하는 시스템 함수예요. 이전에 SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME으로 추가한 호스트 이름을 지울 때 씁니다.

출처: Snowflake SQL Reference

본문

Business Critical 기능: 이 기능은 Business Critical 이상 에디션을 필요로 해요.

이 함수는 엔드포인트의 기본 호스트 이름(프로비저닝 시 또는 SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME으로 설정한 호스트 이름)에는 영향을 주지 않아요.

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

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

host_name — 엔드포인트에서 제거할 추가 호스트 이름. 이전에 SYSTEM$ADD_PRIVATELINK_ENDPOINT_HOSTNAME으로 추가한 호스트 이름이어야 하고, 엔드포인트의 기본 호스트 이름은 안 돼요.

subresource — Azure 리소스의 하위 리소스 이름. 엔드포인트를 프로비저닝할 때 하위 리소스를 지정한 경우에만 지정해요.

호스트 이름이 private connectivity 엔드포인트에서 성공적으로 제거되었다는 상태 메시지, 또는 왜 제거되지 못했는지에 대한 세부 정보와 안내를 반환해요.

접근 제어 요구사항: 계정 관리자(ACCOUNTADMIN 역할)만 호출할 수 있어요.

사용 메모

• Microsoft Azure에 호스팅된 Snowflake 계정에서만 지원돼요.
• 이 함수로 엔드포인트의 기본 호스트 이름은 제거할 수 없어요. 기본 호스트 이름을 바꾸려면 SYSTEM$SET_PRIVATELINK_ENDPOINT_HOSTNAME을 쓰세요.
• 엔드포인트를 프로비저닝 해제하기 전에 추가 호스트 이름을 제거할 필요는 없어요. SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT로 프로비저닝을 해제하면 모든 추가 호스트 이름이 자동으로 제거돼요.

예시 — Microsoft Fabric 워크스페이스에 연결하는 엔드포인트에서 이전에 추가한 OneLake 스토리지 호스트 이름 제거:

SELECT SYSTEM$REMOVE_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'
  );

더 알아보기 (Learn more)

• System functions (시스템 함수)