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