카테고리:: 시스템 함수 (시스템 제어)

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

Copy

Azure:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '<provider_resource_id>'
  )

Copy

인자¶

AWS:

provider_service_name: 복원할 외부 KMS 리소스 엔드포인트를 지정합니다.

Azure:

provider_resource_id: VPC 또는 VNet 에 있는 리소스에 대한 정규화된 식별자를 지정합니다.

반환¶

엔드포인트가 해당 식별자와 함께 성공적으로 복원되었음을 나타내는 상태 메시지를 반환합니다.

성공적이지 않으면 오류를 반환합니다(예: 제공된 인자가 유효한 기존 엔드포인트가 아닌 경우). 엔드포인트 이름을 모르는 경우 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 시스템 함수를 사용하여 Snowflake 계정의 모든 엔드포인트를 목록으로 확인할 수 있습니다.

액세스 제어 요구 사항¶

계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 호출할 수 있습니다.

사용법 노트¶

지정된 인자와 비공개 연결 엔드포인트가 연결되어 있지 않으면 오류 메시지가 발생합니다.

예¶

AWS:

AWS 키 저장소에 대한 외부 액세스가 있는 비공개 엔드포인트를 복원합니다.

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  'com.amazonaws.us-west-2.s3'
  );

Copy

Azure:

Microsoft Azure의 Snowflake가 Azure VNet의 Azure key vault에 연결할 수 있도록 비공개 엔드포인트를 복원합니다.

SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT_TSS(
  '/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/providers/Microsoft.KeyVault/vaults/TriSecretVault'
  );

Copy

"Resource Endpoint with id "/subscriptions/12345678-90ab-cdef-1234-567890abcdef/resourceGroups/myvault/privatelink-test/providers/Microsoft.KeyVault/vaults/TriSecretVault/privateEndpoints/" restored successfully.