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

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT¶

Restaura um ponto de extremidade de conectividade privada no Snowflake VPC ou VNet para permitir 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.

É possível restaurar um ponto de extremidade privado em até 7 dias após o desprovisionamento. Após 7 dias, o ponto de extremidade não poderá ser restaurado e você precisará recriar o ponto de extremidade com a função do sistema SYSTEM$PROVISION_PRIVATELINK_ENDPOINT.

Sintaxe¶

AWS:

SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  '<provider_service_name>' )

Azure:

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

Google Cloud:

SYSTEM$RESTORE_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 restaurado com sucesso.

Se não for bem-sucedido, retorna um erro. Por exemplo, se o argumento fornecido não for um ponto de extremidade existente válido. Se você não souber o nome do ponto de extremidade, poderá usar a função do sistema SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO para listar todos os pontos de extremidade em sua conta Snowflake.

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:

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

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

Azure:

Restaure um ponto de extremidade privado para permitir que o Snowflake no Microsoft Azure se conecte ao serviço Azure API Management na sua Azure VNet:
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.

Google Cloud:

Restaure um ponto de extremidade privado para permitir que o Snowflake no Google Cloud se conecte ao serviço de gerenciamento da API do Google na sua rede VPC do Google Cloud:
SELECT SYSTEM$RESTORE_PRIVATELINK_ENDPOINT(
  'projects/my-project/regions/us-east4/serviceAttachments/my-service-attachment'
);
Private endpoint with id ''abcd0000000000000001'' restored successfully.