- 카테고리:
시스템 함수 (시스템 제어)
SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶
Snowflake가 비공개 연결을 사용하여 외부 서비스에 연결하지 못하도록 Snowflake VPC 또는 VNet에서 비공개 연결 엔드포인트의 프로비저닝을 해제합니다. 엔드포인트는 Snowflake 계정을 호스팅하는 클라우드 플랫폼에 따라 서비스 엔드포인트 또는 리소스 엔드포인트가 될 수 있습니다.
이 함수를 호출하고 잘못된 비공개 연결 엔드포인트를 지정한 경우 SYSTEM$RESTORE_PRIVATELINK_ENDPOINT 시스템 함수를 호출하여 7일 기간 내에 엔드포인트를 복원합니다. 7일 후에는 엔드포인트가 삭제되며 복구할 수 없습니다. SYSTEM$PROVISION_PRIVATELINK_ENDPOINT 시스템 함수로 엔드포인트를 다시 만들어야 합니다.
구문¶
AWS:
SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '<provider_service_name>' )
Azure:
SYSTEM$DEPROVISION_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 관리 서비스에는 이 인자가 필요하지 않습니다.
지원되는 모든 값은 하위 리소스 테이블 섹션을 참조하십시오.
반환¶
식별자를 가진 엔드포인트가 성공적으로 프로비저닝 해제되었음을 나타내는 상태 메시지를 반환합니다.
사용법 노트¶
계정 관리자(ACCOUNTADMIN 역할이 있는 사용자)만 이 함수를 호출할 수 있습니다.
지정된 인자와 비공개 연결 엔드포인트가 연결되어 있지 않으면 오류 메시지가 발생합니다.
예¶
AWS:
Amazon S3에 대한 외부 액세스 권한이 있는 비공개 엔드포인트를 프로비전 해제하십시오.
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT('com.amazonaws.us-west-2.s3');
Azure:
비공개 엔드포인트의 프로비저닝을 취소하여 Microsoft Azure의 Snowflake가 Microsoft Azure VNet 의 Microsoft Azure API 관리 서비스에 연결할 수 없도록 합니다.
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api', 'Gateway' );Private endpoint with id "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/test_rg/providers/microsoft.network/privateendpoints/5ef8fd34-07db-4583-b0dd-0e2360398ed3" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.
비공개 엔드포인트의 프로비저닝을 해제하여 Microsoft Azure 의 Snowflake가 외부 네트워크 액세스를 사용하여 외부 서비스에 연결할 수 없도록 합니다.
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/leorg1/providers/Microsoft.Sql/servers/myserver/databases/testdb', 'sqlServer' );"Resource Endpoint with id "/subscriptions/f0abb333-1b05-47c6-8c31-dd36d2512fd1/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"
비공개 엔드포인트를 프로비저닝 취소하여 Microsoft Azure 의 외부 스테이지에 Snowflake가 연결되지 않도록 합니다.
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '/subscriptions/cb72345g5-d347-4sdc-r3ee-70d234551a78/resourceGroups/rg-db-dev/providers/Microsoft.Storage/storageAccounts/dbasdfffext', 'blob' );"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"