Obtendo sequências de conexões

Para se conectar ao IBM Cloud® Databases for MySQL, são necessários alguns usuários e sequências de conexões. As sequências de conexão para sua implementação são exibidas no Painel de Visão Geral, no painel Terminais.

Painel de endpoints na visão geral do
de endpoints na visão geral do

Uma implantação do Databases for MySQL é provisionada com um usuário administrador e, depois de definir a senha do administrador, use suas cadeias de conexão para se conectar à sua implantação.

CLI
Também é possível capturar sequências de conexões por meio da CLI.

ibmcloud cdb deployment-connections example-deployment -u <newusername> [--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 <newusername> --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.

API Para recuperar as sequências de conexões do usuário da API, use o terminal /users/{userid}/connections. Você deve especificar no caminho o terminal do usuário (público ou privado) nas sequências de conexões 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 MySQL

A seção "mysql" contém informações adequadas a aplicativos que fazem conexões com o mysql.

informações de conexão mysql/URI
Nome do campo Index Descrição
Type Tipo de conexão - para MySQL, é "URI".
Scheme Esquema para um URI - para MySQL, é "mysql".
Path Caminho para um URI - para MySQL, é 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 aos quais se conectar.
Composed 0... Um URI que combina Scheme (esquema), Authentication (autenticação), Host (host) e Path (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 que pode haver uma ou mais dessas entradas em uma matriz.

A seção CLI

A seção "CLI" contém informações adequadas para conexão com mysql.

informações de conexão mysql/cli
Nome do campo Index Descrição
Bin O binário recomendado para a criação de uma conexão; nesse caso, mysql.
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.