SYSTEM$PROVISION_PRIVATELINK_ENDPOINT¶

Sintaxe¶

SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '<provider_resource_id>' ,
  '<host_name>' ,
  '<subresource>'
  )

Argumentos¶

provider_resource_id

Especifica o identificador totalmente qualificado para o recurso ou serviço em seu VPC ou VNet.

'subresource'

Especifica o nome do sub-recurso no argumento host_name; o valor host_name é usado ao provisionar o ponto de extremidade privado.

Se você quiser usar conectividade privada de saída com os seguintes serviços, especifique estes valores:

• Acesso à rede externa em Microsoft Azure: Se o valor do nome do host for externalaccessdemo.database.windows.net, o valor subresource será sqlServer.

• Estágios externos em Microsoft Azure: Se o valor do nome do host for storagedemo.blob.core.windows.net, o valor de subresource será blob.

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

'host_name'

Especifica o nome do host totalmente qualificado para acessar o recurso em sua VPC ou VNet.

Este valor não contém nenhum número de porta e deve corresponder ao que você especificou no objeto Snowflake que permite que você se conecte ao serviço externo. Por exemplo:

• Gerenciamento da API Microsoft Azure: o valor deve corresponder à propriedade API_ALLOWED_PREFIXES da integração da API. Não inclua https://.

  Para obter exemplos, consulte o procedimento de configuração para funções externas que usam conectividade privada para o Portal do Azure e o modelo de Azure ARM.

Retornos¶

Retorna uma mensagem de status informando que o ponto de extremidade foi provisionado com sucesso ou detalhes e instruções sobre o motivo pelo qual o ponto de extremidade não foi provisionado com sucesso.

Notas de uso¶

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

• Não é possível modificar um ponto de extremidade de conectividade privada existente. Para desprovisionar o ponto de extremidade, chame a função do sistema SYSTEM$DEPROVISION_PRIVATELINK_ENDPOINT.

• Esta função pode levar aproximadamente 5 minutos para ser executada porque depende do processo de provisionamento do ponto de extremidade de conectividade privada na plataforma de nuvem (fora do Snowflake).

• Para obter detalhes sobre os limites de pontos de extremidade privados, consulte Considerações de escala.

Exemplos¶

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

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api',
  'aztest1-external-function-api.azure.net',
  'Gateway'
  );

Private endpoint with ID "/subscriptions/e48379a7-2fc4-473e-b071-f94858cc83f5/resourcegroups/test_rg/providers/microsoft.network/privateendpoints/32bd3122-bfbd-417d-8620-1a02fd68fcf8" to resource "/subscriptions/f4b00c5f-f6bf-41d6-806b-e1cac4f1f36f/resourceGroups/aztest1-external-function-rg/providers/Microsoft.ApiManagement/service/aztest1-external-function-api" has been provisioned successfully. Please note down the endpoint ID and approve the connection from it on the Azure portal.

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

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

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

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

SELECT SYSTEM$PROVISION_PRIVATELINK_ENDPOINT(
  '/subscriptions/cc2909f2-ed22-4c89-8e5d-bdc40e5eac26/resourceGroups/mystorage/providers/Microsoft.Storage/storageAccounts/storagedemo',
  'storagedemo.blob.core.windows.net',
  'blob'
);

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