Categorias:: Funções do sistema (Controle do sistema)

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶

Desprovisiona um ponto de extremidade de conectividade privada no Snowflake VPC ou VNet para impedir que o Snowflake se conecte a um serviço externo usando conectividade privada. O ponto de extremidade pode ser um ponto de extremidade de servidor ou um ponto de extremidade de recurso, dependendo da plataforma de nuvem que hospeda sua conta Snowflake.

Se você chamar esta função e especificar o ponto de extremidade de conectividade privada errado, chame a função do sistema SYSTEM$RESTORE_PRIVATELINK_ENDPOINT para restaurar o ponto de extremidade dentro de um período de sete dias. Após sete dias, o ponto de extremidade será excluído e não poderá ser recuperado; será necessário recriar o ponto de extremidade com a função do sistema SYSTEM$PROVISION_PRIVATELINK_ENDPOINT.

Sintaxe¶

AWS:

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT( '<provider_service_name>' )

Copy

Azure:

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

Copy

Argumentos¶

provider_service_name: Especifica o ponto de extremidade do serviço ou recurso externo. Por exemplo, com.amazonaws.us-west-2.execute-api para o Amazon API Gateway ou com.amazonaws.us-west-2.s3 para o Amazon S3.

'provider_resource_id'

Especifica o identificador totalmente qualificado do recurso em sua VPC ou VNet.

'subresource'

Especifica o nome do sub-recurso do recurso do Azure.

Esse argumento não é necessário para o Azure Private Link Service e Azure API Management Service.

Para todos os valores compatíveis, consulte a Tabela sub-recursos.

Retornos¶

Retorna uma mensagem de status informando que o ponto de extremidade, com seu identificador, foi desprovisionado com sucesso.

Notas de uso¶

Somente administradores de conta (usuários com a função ACCOUNTADMIN) podem chamar esta função.
Uma mensagem de erro ocorre se um ponto de extremidade de conectividade privada não estiver associado aos argumentos especificados.

Exemplos¶

AWS:

Desprovisione um ponto de extremidade privado com acesso externo ao Amazon S3:

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

Copy

Azure:

Desprovisione um ponto de extremidade privado para impedir que o Snowflake no Microsoft Azure se conecte ao serviço Microsoft Azure API Management na sua Microsoft Azure VNet:

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

Copy

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.

Desprovisione um ponto de extremidade privado para impedir que o Snowflake no Microsoft Azure se conecte a um serviço externo usando o acesso de rede externa:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/11111111-2222-3333-4444-5555555555/resourceGroups/leorg1/providers/Microsoft.Sql/servers/myserver/databases/testdb',
  'sqlServer'
  );

Copy

"Resource Endpoint with id "/subscriptions/f0abb333-1b05-47c6-8c31-dd36d2512fd1/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"

Desprovisione um ponto de extremidade privado para impedir que o Snowflake se conecte a um estágio externo para o Microsoft Azure:

SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/cb72345g5-d347-4sdc-r3ee-70d234551a78/resourceGroups/rg-db-dev/providers/Microsoft.Storage/storageAccounts/dbasdfffext',
  'blob'
);

Copy

"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"