- 카테고리:
시스템 함수 (시스템 제어)
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶
Snowflake VPC 또는 VNet에서 비공개 연결 엔드포인트를 복원하여 Snowflake가 비공개 연결을 사용하여 외부 서비스에 연결할 수 있도록 합니다. 엔드포인트는 Snowflake 계정을 호스팅하는 클라우드 플랫폼에 따라 서비스 엔드포인트 또는 리소스 엔드포인트가 될 수 있습니다.
프로비저닝을 해제한 후 7일 이내에 프라이빗 엔드포인트를 복원할 수 있습니다. 7일 후에는 엔드포인트를 복구할 수 없으며 SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 시스템 함수를 사용하여 엔드포인트를 다시 만들어야 합니다.
구문¶
AWS:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '<provider_service_name>' )
Azure:
SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
'<provider_resource_id>'
[, '<subresource>' ]
)
인자¶
provider_service_name
복원할 외부 서비스 또는 리소스 엔드포인트를 지정합니다. 예: Amazon API 게이트웨이의 경우
com.amazonaws.us-west-2.execute-api
, Amazon S3의 경우com.amazonaws.us-west-2.s3
.
'provider_resource_id'
VPC 또는 VNet 에 있는 리소스에 대한 정규화된 식별자를 지정합니다.
'subresource'
Azure 리소스의 하위 리소스 이름을 지정합니다.
Azure Private Link Service 및 Azure API 관리 서비스에는 이 인자가 필요하지 않습니다.
지원되는 모든 값은 하위 리소스 테이블 섹션을 참조하십시오.
반환¶
엔드포인트가 해당 식별자와 함께 성공적으로 복원되었음을 나타내는 상태 메시지를 반환합니다.
실패하면 오류를 반환합니다. 예를 들어, 제공된 인자가 유효한 기존 엔드포인트가 아닌 경우입니다. 엔드포인트 이름을 모르는 경우 SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO 시스템 함수를 사용하여 Snowflake 계정의 모든 엔드포인트를 목록으로 확인할 수 있습니다.
사용법 노트¶
계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 호출할 수 있습니다.
지정된 인자와 비공개 연결 엔드포인트가 연결되어 있지 않으면 오류 메시지가 발생합니다.
예¶
AWS:
Amazon S3에 대한 외부 액세스가 있는 비공개 엔드포인트를 복원합니다.
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');
Azure:
Microsoft Azure의 Snowflake가 Azure VNet의 Azure API Management 서비스에 연결할 수 있도록 비공개 엔드포인트를 복원합니다.
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT( '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/my_rg/providers/Microsoft.Sql/servers/my_db_server', 'sqlServer' );Private endpoint with id ''/subscriptions/66666666-7777-8888-9999-0000000000/resourcegroups/rg/providers/microsoft.network/privateendpoints/00000000-1111-2222-3333-4444444444'' restored successfully.