Share via


Obter pontos de extremidade de conexão & criar as cadeias de conexão para seu servidor PostgreSQL habilitado para Azure Arc

Este artigo explica como você pode recuperar os pontos de extremidade de conexão para seu grupo de servidores e como você pode formar as cadeias de conexão, que podem ser usadas com seus aplicativos e/ou ferramentas.

Nota

Como funcionalidade de pré-visualização, a tecnologia apresentada neste artigo está sujeita aos Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.

As atualizações mais recentes estão disponíveis nas notas de versão.

Obter pontos finais de conexão:

Execute o seguinte comando:

az postgres server-arc endpoint list -n <server name> --k8s-namespace <namespace> --use-k8s

Por exemplo:

az postgres server-arc endpoint list -n postgres01 --k8s-namespace arc --use-k8s

Ele retorna a lista de pontos de extremidade: o ponto de extremidade PostgreSQL, o painel de pesquisa de log (Kibana) e o painel de métricas (Grafana). Por exemplo:

{
  "instances": [
    {
      "endpoints": [
        {
          "description": "PostgreSQL Instance",
          "endpoint": "postgresql://postgres:<replace with password>@12.345.567.89:5432"
        },
        {
          "description": "Log Search Dashboard",
          "endpoint": "https://23.456.78.99:5601/app/kibana#/discover?_a=(query:(language:kuery,query:'custom_resource_name:postgres01'))"
        },
        {
          "description": "Metrics Dashboard",
          "endpoint": "https://34.567.890.12:3000/d/postgres-metrics?var-Namespace=arc&var-Name=postgres01"
        }
      ],
      "engine": "PostgreSql",
      "name": "postgres01"
    }
  ],
  "namespace": "arc"
}

Use estes pontos finais para:

  • Forme suas cadeias de conexão e conecte-se com suas ferramentas ou aplicativos de cliente
  • Aceder aos dashboards do Grafana e Kibana a partir do browser

Por exemplo, você pode usar o ponto de extremidade chamado Instância PostgreSQL para se conectar com psql ao seu grupo de servidores:

psql postgresql://postgres:MyPassworkd@12.345.567.89:5432
psql (10.14 (Ubuntu 10.14-0ubuntu0.18.04.1), server 12.4 (Ubuntu 12.4-1.pgdg16.04+1))
WARNING: psql major version 10, server major version 12.
         Some psql features might not work.
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

postgres=#

Nota

  • A senha do usuário postgres indicada no ponto final chamado "Instância PostgreSQL" é a senha que você escolheu ao implantar o grupo de servidores.

Da CLI com kubectl

kubectl get postgresqls/<server name> -n <namespace name>

Por exemplo:

kubectl get postgresqls/postgres01 -n arc

Esses comandos produzirão uma saída como a abaixo. Você pode usar essas informações para formar suas cadeias de conexão:

NAME         STATE   READY-PODS   PRIMARY-ENDPOINT     AGE
postgres01   Ready   3/3          12.345.567.89:5432   9d

Cadeias de conexão de formulário

Use os exemplos de cadeia de conexão abaixo para seu grupo de servidores. Copie, cole e personalize-os conforme necessário:

Importante

SSL é necessário para conexões de cliente. Na cadeia de conexão, o parâmetro de modo SSL não deve ser desabilitado. Para obter mais informações, consulte https://www.postgresql.org/docs/14/runtime-config-connection.html.

ADO.NET

Server=192.168.1.121;Database=postgres;Port=24276;User Id=postgres;Password={your_password_here};Ssl Mode=Require;`

C++ (libpq)

host=192.168.1.121 port=24276 dbname=postgres user=postgres password={your_password_here} sslmode=require

JDBC

jdbc:postgresql://192.168.1.121:24276/postgres?user=postgres&password={your_password_here}&sslmode=require

Node.js

host=192.168.1.121 port=24276 dbname=postgres user=postgres password={your_password_here} sslmode=require

PHP

host=192.168.1.121 port=24276 dbname=postgres user=postgres password={your_password_here} sslmode=require

psql

psql "host=192.168.1.121 port=24276 dbname=postgres user=postgres password={your_password_here} sslmode=require"

Python

dbname='postgres' user='postgres' host='192.168.1.121' password='{your_password_here}' port='24276' sslmode='true'

Ruby

host=192.168.1.121; dbname=postgres user=postgres password={your_password_here} port=24276 sslmode=require