- 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_name
Nome do serviço ou recurso.
snowflake_endpoint_name
A 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_state
mudar paraCREATED
, esse nome será alterado.endpoint_state
O 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.host
Nome do host usado para se conectar ao serviço.
status
O 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_id
ID do recurso Azure ao qual o ponto de extremidade se conecta.
subresource
Sub-recurso do recurso Azure ao qual o ponto de extremidade se conecta.
snowflake_resource_id
ID do recurso Azure do ponto de extremidade privado que se conecta ao recurso Azure.
host
Nome de host usado para se conectar ao recurso.
endpoint_state
O 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.status
O 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
Notas de uso¶
Esta função pode levar aproximadamente cinco minutos para ser executada porque depende do processo para recuperar a conectividade privada
Pontos de extremidade na plataforma de nuvem (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"
},
...
]
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", } ]