- 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>' ]
)
Argumentos¶
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 oucom.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 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.