Obtendo sequências de conexões

2ª geração

Como obter cadeias de conexão na interface do usuário

Siga estas etapas para recuperar as cadeias de conexão da sua instância do IBM Cloud® Databases for PostgreSQL:

  1. Na página “Visão geral ” da sua implantação, role a tela para baixo até a seção “Pontos de extremidade do serviço ”.
  2. A seção “Pontos de conexão do serviço ” exibe abas com os métodos de conexão disponíveis:
  • PostgreSQL – Mostra a string de conexão, os nomes de host, as portas, o nome do banco de dados, a fonte de autenticação e o conjunto de réplicas da sua implantação.
  • CLI – Fornece detalhes sobre como se conectar usando a CLI do IBM.

Arquitetura
Obtendo cadeias de conexão - Guia “ PostgreSQL ” dos pontos de extremidade do serviço

Databases for PostgreSQL As implantações não incluem mais um admin user`` padrão. Em vez disso, você cria um usuário com a função “Gerente”, “Redator” ou “Leitor” usando a interface de credenciais do serviço IBM Cloud® — seja pela interface do usuário (UI) ou pela linha de comando (CLI). Isso fornece um nome de usuário (ibm_...), uma senha e uma string de conexão que podem ser usados para se conectar à sua implantação.

Como obter cadeias de conexão na CLI

Você também pode encontrar o endpoint na guia “CLI” dos endpoints do serviço.

Arquitetura
Obtenção de strings de conexão – Guia “CLI” dos pontos de extremidade do serviço

Você também pode recuperar cadeias de conexão usando o comando “Connection” do plug-in da CLI do Cloud Databases.

O comando fica assim:

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

Para obter mais informações, consulte as opções do comando “Conexões ”.

Databases for PostgreSQL A implantação não inclui mais um usuário administrador padrão. Em vez disso, os clientes criam um usuário com a função “Gerente”, “Escritor” ou “Leitor” usando a interface de credenciais do serviço IBM Cloud® — seja pela interface do usuário (UI) ou pela linha de comando (CLI). Isso fornece um nome de usuário (ibm_...), uma senha e uma string de conexão que podem ser usados para se conectar à sua implantação. Se a sua implementação tiver apenas um terminal privado, você deverá especificar --endpoint-type private ou os comandos retornarão um erro. O tipo de usuário e de terminal não é imposto. Você pode usar qualquer usuário da sua implantação com o endpoint privado, que é a opção de conexão designada.

Para usar os comandos da CLI ibmcloud cdb, deve-se instalar o plug-in do Cloud Databases.

Como obter as cadeias de conexão na API

Para recuperar as cadeias de conexão dos usuários da API do Cloud Databases, use o endpoint Connections. Para criar as cadeias de conexão, certifique-se de que o caminho inclua o usuário específico e o tipo de ponto de extremidade que devem ser utilizados. A Lei de Proteção ao Consumidor de 1995 ( user ) não é restringida nem aplicada. Você tem a flexibilidade de utilizar qualquer usuário disponível em sua implantação.

O comando da API tem o seguinte formato:

curl -X GET 'https://resource-controller.cloud.ibm.com/v2/resource_instances/{id}' -H "Authorization: Bearer <IAM token>""

Lembre-se de substituir {region}, {id}, {userid} e {endpoint_type} pelos valores adequados.

Como obter as cadeias de conexão na API

Para recuperar as sequências de conexões da API, use o terminal /users/{userid}/connections. É necessário especificar no caminho qual usuário e qual tipo de endpoint (público ou privado) devem ser utilizados nas cadeias de conexão retornadas. O tipo de usuário e de terminal não é imposto. Será possível usar qualquer usuário em sua implementação com qualquer terminal (se ambos existirem em sua implementação).

curl -X GET -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/users/{userid}/connections/{endpoint_type}'

Detalhamento da sequência de conexões

A seção PostgreSQL

A guia “ "PostgreSQL" ” contém informações adequadas para aplicativos que se conectam ao site PostgreSQL.

PostgreSQL/URI informações de conexão
Nome do campo Index Descrição
Type Tipo de conexão — para PostgreSQL,, é “URI”.
Scheme Esquema para um URI — para PostgreSQL,, é “postgresql”.
Path Caminho para um URI - para o PostgreSQL é o nome do banco de dados. O padrão é ibmclouddb.
Authentication Username O nome do usuário usado para se conectar.
Authentication Password Uma senha para o usuário — pode ser exibida como $PASSWORD.
Authentication Method Como a autenticação ocorre; a autenticação "direta" é manipulada pelo driver.
Hosts 0... Um nome do host e uma porta aos quais se conectar.
Composed 0... Um URI que combina Scheme, Autenticação, Host e Caminho.
  • 0... indica uma ou mais dessas entradas em um array.

A seção CLI

A seção "CLI" contém informações que são adequadas para a conexão com o psql.

PostgreSQL/cli informações de conexão
Nome do campo Index Descrição
Bin O arquivo binário para estabelecer uma conexão; neste caso, é psql.
Composed Um comando formatado para estabelecer uma conexão com a sua implementação. O comando combina o executável Bin, as configurações da variável Environment e usa Arguments como parâmetros da linha de comandos.
Environment Uma lista de chaves/valores configurados como variáveis de ambiente.
Arguments 0... As informações transmitidas como argumentos para o comando mostrado no campo Bin.
Type O tipo de pacote que usa essas informações de conexão; neste caso, cli.
  • 0... indica que pode haver uma ou mais dessas entradas em uma matriz.