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:
- 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 ”.
- 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.
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.
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.
| 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.
| 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.