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

SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT¶

Desprovisiona um ponto de extremidade de conectividade privada na VPC ou VNet do Snowflake 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>' )

Azure:

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

Google Cloud

 SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
   '<service_attachment_id>'
);

Argumentos¶

AWS

provider_service_name: Especifica o serviço externo ou o ponto de extremidade de recurso a ser restaurado. 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.

Azure

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

Google Cloud

'target_service_id': Especifica o ID do anexo de serviço em sua rede VPC ou API Google regional.

Retornos¶

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

Access control requirements¶

Somente administradores de conta (usuários com a função ACCOUNTADMIN) podem chamar esta função.

Notas de uso¶

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

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'
  );
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'
  );
"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'
);
"Resource Endpoint with id "/subscriptions/57faea9a-20c2-4d35-b283-9c0c1e9593d8/resourceGroups/privatelink-test/providers/Microsoft.Network/privateEndpoints/external-network-access-pe" deprovisioned successfully"

Google Cloud

Desprovisione um ponto de extremidade privado para impedir que o Snowflake no Google Cloud se conecte ao anexo de serviço na sua rede VPC do Google Cloud:
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
  'projects/my-project/regions/us-east4/serviceAttachments/my-service-attachment'
  );
Private endpoint with id "abcd0000000000000001" 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 Google Cloud se conecte a um ponto de extremidade de serviço do Google (CloudKMS) regional:
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
 'cloudkms.us-east4.rep.googleapis.com'
 );
Private endpoint with id "abcd0000000000000001" 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 se conecte a um estágio externo para o Google Cloud:
SELECT SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT(
 'storage.us-east4.rep.googleapis.com'
 );
Private endpoint with id "abcd0000000000000001" successfully marked for deletion. Before it is fully deleted in 7-8 days, it can be restored.