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 de sua implementação são exibidas na página Overview (Visão geral), no painel Endpoints.

' 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.

Obtenção de cadeias de conexão na CLI

Agarre strings de conexão a partir da 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.

Obtenção de cadeias de conexão na API

Para recuperar as sequências de conexões da API, use o terminal /users/{userid}/connections. Você deve especificar no caminho qual usuário e qual tipo de endpoint (público ou privado) deve ser usado 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 aos aplicativos que fazem conexões com PostgreSQL.

informações de conexão postgresql/URI
Nome do campo	Index	Descrição
`Type`		Tipo de conexão - para o PostgreSQL é "URI"
`Scheme`		Esquema para um URI - para o 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 mostrada 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 para se conectar
`Composed`	`0...`	Um URI que combina Esquema, Autenticação, Host e Caminho
`Certificate`	`Name`	O nome alocado para o certificado proprietário do serviço para a implementaçã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 binário para criar uma conexão; nesse 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.
`Certificate`	Base64	Um certificado proprietário de serviço usado para confirmar que um aplicativo está se conectando ao servidor apropriado. Ele é codificado em base64.
`Certificate`	Nome	O nome alocado para o certificado de propriedade 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.