SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO¶

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 para CREATED, 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:

SQLReturned value

SELECT SYSTEM$GET_PRIVATELINK_ENDPOINTS_INFO();

Copy