SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS
Business Critical 기능
이 기능에는 Business Critical(또는 그 이상)이 필요해요.
업그레이드 문의는 Snowflake 지원에 연락하세요.
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS() 함수는 Snowflake VPC 또는 VNet의 프라이빗 연결 엔드포인트를 복원해, 프라이빗 연결을 사용해 Snowflake가 외부 키 관리 서비스(KMS) 리소스에 연결할 수 있게 해요. 엔드포인트는 Snowflake 계정을 호스팅하는 클라우드 플랫폼에 따라 서비스 엔드포인트 또는 리소스 엔드포인트일 수 있어요.
프라이빗 엔드포인트는 프로비저닝 해제 후 7일 이내에 복원할 수 있어요. 7일이 지나면 엔드포인트를 복원할 수 없으며, SYSTEM$PROVISION_PRIVATELINK_ENDPOINT_TSS 시스템 함수로 엔드포인트를 다시 만들어야 해요.
본문
문법
AWS:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'<provider_service_name>'
)
Azure:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'<provider_resource_id>'
)
Google Cloud:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'<target_service_id>'
)
인자
AWS: provider_service_name — 공급자 서비스 이름이에요.
Azure: provider_resource_id — 공급자 리소스 ID예요.
Google Cloud: target_service_id — 대상 서비스 ID예요.
반환
엔드포인트(식별자 포함)가 성공적으로 복원되었다는 상태 메시지를 반환해요.
실패하면 오류를 반환해요 — 예를 들어 제공된 인자가 유효한 기존 엔드포인트가 아닌 경우예요. 엔드포인트 이름을 모르면 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 시스템 함수를 사용해 Snowflake 계정의 모든 엔드포인트를 나열할 수 있어요.
접근 제어 요구 사항
계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)만 이 함수를 호출할 수 있어요.
사용 메모
프라이빗 연결 엔드포인트가 지정된 인자와 연결되어 있지 않으면 오류 메시지가 발생해요.
예제
AWS:
AWS 키 스토어에 대한 외부 접근이 있는 프라이빗 엔드포인트를 복원해요.
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'com.amazonaws.us-west-2.s3'
);
Azure:
Microsoft Azure의 Snowflake가 Azure VNet의 Azure 키 자격 증명 모음에 연결하도록 프라이빗 엔드포인트를 복원해요.
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault'
);
"Resource Endpoint with id "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/privatelink-test/providers/Microsoft.KeyVault/vaults/TriSecretVault/privateEndpoints/" restored successfully.
Google Cloud:
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
'cloudkms.us-west2.rep.googleapis.com'
);
Private endpoint with id 'abcd0000000000001234' restored successfully.