- Categorias:
Funções do sistema (Informações do sistema)
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶
Retorna o status de todos os pontos de extremidade de conectividade privada que você provisiona. 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.
Sintaxe¶
SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO()
Retornos¶
Retorna um objeto JSON com os seguintes campos:
AWS:
provider_service_nameNome do serviço ou recurso.
snowflake_endpoint_nameA ID do ponto de extremidade da VPC em sua conta Snowflake. Este campo contém um nome temporário enquanto o ponto de extremidade está sendo criado. Depois que o ponto de extremidade for criado e
endpoint_statemudar paraCREATED, esse nome será alterado.endpoint_stateO estado do ponto de extremidade no Snowflake. Este campo pode conter um dos seguintes estados:
PENDING_CREATION: o ponto de extremidade ainda está sendo criado.
CREATED: indica que o Snowflake recebeu uma resposta do provedor de nuvem de que o ponto de extremidade foi criado com sucesso e está pronto para ser usado.
FAILED: o ponto de extremidade está em um estado inesperado no provedor de nuvem e não pode ser usado.
PENDING_DELETION: o ponto de extremidade está na fila de exclusão, mas pode ser restaurado.
DELETING: o ponto de extremidade está sendo excluído no provedor de nuvem e não pode ser restaurado.hostNome do host usado para se conectar ao serviço.
statusO status de provisionamento do ponto de extremidade no AWS. Este campo pode conter um dos seguintes status:
Pending: o ponto de extremidade ainda está sendo criado.
Available: o ponto de extremidade é criado e está pronto para ser usado.
Azure:
provider_resource_idID do recurso Azure ao qual o ponto de extremidade se conecta.
subresourceSub-recurso do recurso Azure ao qual o ponto de extremidade se conecta.
snowflake_resource_idID do recurso Azure do ponto de extremidade privado que se conecta ao recurso Azure.
hostNome de host usado para se conectar ao recurso.
endpoint_stateO estado do ponto de extremidade no Snowflake. Este campo pode conter um dos seguintes estados:
PENDING_CREATION: o ponto de extremidade ainda está sendo criado.
CREATED: indica que o Snowflake recebeu uma resposta do provedor de nuvem de que o ponto de extremidade foi criado com sucesso e está pronto para ser usado.
FAILED: o ponto de extremidade está em um estado inesperado no provedor de nuvem e não pode ser usado.
PENDING_DELETION: o ponto de extremidade está na fila de exclusão, mas pode ser restaurado.
DELETING: o ponto de extremidade está sendo excluído no provedor de nuvem e não pode ser restaurado.statusO status de provisionamento do ponto de extremidade no Microsoft Azure. Use esse campo para determinar se o Microsoft Azure aprovou a conexão de ponto de extremidade privado com o recurso. Este campo pode conter um dos seguintes status:
APPROVED
PENDING
DISCONNECTED
REJECTED
Google Cloud:
provider_resource_idO ID do recurso (ID do anexo de serviço) ao qual o ponto de extremidade de conectividade privada se conecta.
snowflake_resource_idO identificador do ponto de extremidade de conectividade privada.
hostO nome de host a ser usado ao acessar o recurso ou serviço do provedor que usa esse ponto de extremidade.
endpoint_stateO estado do ponto de extremidade no lado do Snowflake.
statusO status da conexão no Google Cloud. NO CONNECTION pode aparecer logo após a criação do ponto de extremidade de conectividade privada , porque o provedor de nuvem leva tempo para concluir a configuração da conexão. Este campo pode conter um dos seguintes status:
ACCEPTED
NO CONNECTION
REJECTED
Notas de uso¶
Esta função pode levar aproximadamente cinco minutos para ser executada porque depende do processo para recuperar os pontos de extremidade de conectividade privada na plataforma de nuvem que estão fora do Snowflake.
Exemplos¶
AWS:
Para listar todos os pontos de extremidade do PrivateLink com acesso externo ao Amazon S3, execute a seguinte instrução SQL:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();
[
{
"provider_service_name": "com.amazonaws.us-west-2.s3",
"snowflake_endpoint_name": "vpce-123456789012abcdea",
"endpoint_state": "CREATED",
"host": "*.s3.us-west-2.amazonaws.com",
"status": "Available"
},
...
Para sua conta Snowflake no Amazon Web Services, retorne o ponto de extremidade de conectividade privada para um identificador de recurso específico:
Azure:
Para sua conta Snowflake no Microsoft Azure, liste os pontos de extremidade de conectividade privada que você provisionou e os nomes de serviço aos quais cada ponto de extremidade está associado:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "/subscriptions/11111111-2222-3333-4444-5555555555/...", "subresource": "sqlServer", "snowflake_resource_id": "/subscriptions/fa57a1f0-b4e6-4847-9c00-95f39520f...", "host": "testdb.database.windows.net", "endpoint_state": "CREATED", "status": "Approved", } ]
Google Cloud
Para sua conta Snowflake no Google Cloud, liste os pontos de extremidade de conectividade privada que você provisionou e os nomes de serviço aos quais cada ponto de extremidade está associado:
SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();[ { "provider_resource_id": "projects/my-project/regions/us-east4/serviceAttachments/...", "snowflake_resource_id": "abcd0000000000000001", "host": "my-service.com", "endpoint_state": "CREATED", "status": "ACCEPTED", } ]