Obtendo sequências de conexões

Obtenção de cadeias de conexão na interface do usuário

Para se conectar ao IBM Cloud® Databases for PostgreSQL, são necessários alguns usuários e sequências de conexões. As cadeias de conexão para sua implantação são exibidas na página Visão geral, no painel Pontos de conexão.

' Painel de pontos de extremidade na visão geral do painel

Uma implementação do Databases for PostgreSQL é provisionada com um usuário administrativo e, depois de configurar a senha do administrador, será possível usar suas sequências de conexões para se conectar à sua implementação.

Como obter cadeias de conexão na CLI

Obter cadeias de conexão pela CLI.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> [--endpoint-type <ENDPOINT_TYPE>]

Informações de conexão integrais são retornadas pelo comando ibmcloud cdb deployment-connections com a sinalização --all. Para recuperar todas as informações de conexão para uma implementação denominada "implementação de exemplo", use o comando a seguir.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> --all [--endpoint-type <ENDPOINT_TYPE>]

Se você não especificar um usuário, os comandos deployment-connections retornarão informações para o usuário admin por padrão. Se você não especificar um tipo de terminal, a sequência de conexões retornará o terminal público por padrã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. Será possível usar qualquer usuário em sua implementação com qualquer terminal (se ambos existirem em sua implementação).

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 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 estabelecem conexões com PostgreSQL.

Informações de conexão do PostgreSQL/URI
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.
`Certificate`	`Name`	O nome atribuído ao certificado proprietário do serviço para a implantação do banco de dados.
`Certificate`	Base64	Uma versão do certificado codificada em Base64.

0... indica uma ou mais dessas entradas em uma matriz.

A seção CLI

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

informações de conexão psql/cli
Nome do campo	Index	Descrição
`Bin`		O arquivo binário para estabelecer uma conexão; neste caso, é o `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.
`Certificate`	Base64	Um certificado proprietário de serviço utilizado para confirmar que um aplicativo está se conectando ao servidor correto. Ele é codificado em base64.
`Certificate`	Nome	O nome atribuído ao certificado proprietário do serviço.
`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.