Obtención de series de conexión

Gen 2

Obtener cadenas de conexión en la interfaz de usuario

Sigue estos pasos para obtener las cadenas de conexión de tu instancia de « IBM Cloud® Databases for PostgreSQL »:

  1. En la página «Descripción general» de tu implementación, desplázate hacia abajo hasta la sección « Puntos de conexión del servicio ».
  2. La sección « Puntos de conexión del servicio » muestra pestañas con los métodos de conexión disponibles:
  • PostgreSQL – Muestra la cadena de conexión, los nombres de host, los puertos, el nombre de la base de datos, la fuente de autenticación y el conjunto de réplicas de tu implementación.
  • CLI: ofrece información detallada sobre cómo conectarse mediante la interfaz de línea de comandos ( CLI)de IBM.

Arquitectura
Obtención de cadenas de conexión: pestaña « PostgreSQL » (Puntos finales del servicio)

Databases for PostgreSQL Las implementaciones ya no incluyen un archivo « admin user » por defecto. En su lugar, se crea un usuario con el rol «Manager», «Writer» o «Reader» utilizando la interfaz de credenciales del servicio IBM Cloud®, ya sea a través de la interfaz de usuario o de la línea de comandos. Aquí se proporcionan un nombre de usuario (ibm_...), una contraseña y una cadena de conexión que se pueden utilizar para conectarse a su implementación.

Cómo obtener cadenas de conexión en la CLI

También puedes encontrar el punto final en la pestaña «CLI» de los puntos finales del servicio.

Arquitectura
Obtención de cadenas de conexión: pestaña «CLI» de los puntos de conexión del servicio

También puedes recuperar las cadenas de conexión mediante comando «Connection» del complemento CLI de Cloud Databases.

El comando es similar a este:

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

Para obtener más información, consulta Opciones comando «Conexiones».

Databases for PostgreSQL Las implementaciones ya no incluyen un usuario administrador predeterminado. En su lugar, los clientes crean un usuario con el rol «Manager», «Writer» o «Reader» utilizando la interfaz de credenciales del servicio IBM Cloud®, ya sea a través de la interfaz de usuario o de la línea de comandos. Aquí se proporcionan un nombre de usuario (ibm_...), una contraseña y una cadena de conexión que se pueden utilizar para conectarse a su implementación. Si el despliegue solo tiene un punto final privado, debe especificar --endpoint-type private, si no, los mandatos devuelven un error. El usuario y el tipo de punto final no se imponen. Puedes utilizar cualquier usuario de tu entorno con el punto de conexión privado, que es la opción de conexión designada.

Para utilizar los mandatos de CLI de ibmcloud cdb, debe instalar el plugin de Cloud Databases.

Cómo obtener las cadenas de conexión en la API

Para recuperar las cadenas de conexión de los usuarios desde la API de Cloud Databases, utiliza el punto final «Connections ». Para crear las cadenas de conexión, asegúrate de que la ruta incluya el usuario y el tipo de punto final específicos que se deben utilizar. La Ley de Protección de la Salud Mental de California ( user ) no está sujeta a restricciones ni se aplica de forma coercitiva. Tienes la flexibilidad de utilizar cualquier usuario disponible en tu entorno.

Comando de la API tiene el siguiente aspecto:

curl -X GET 'https://resource-controller.cloud.ibm.com/v2/resource_instances/{id}' -H "Authorization: Bearer <IAM token>""

Recuerda sustituir {region}, {id}, {userid} y {endpoint_type} por los valores correspondientes.

Cómo obtener las cadenas de conexión en la API

Para recuperar las series de conexión de usuario de la API, utilice el punto final /users/{userid}/connections. Debes especificar en la ruta qué usuario y qué tipo de punto final (público o privado) se va a utilizar en las cadenas de conexión devueltas. El usuario y el tipo de punto final no se imponen. Puede utilizar cualquier usuario del despliegue con cualquiera de los puntos finales (si ambos existen en el despliegue).

curl -X GET -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/users/{userid}/connections/{endpoint_type}'

Desglose de serie de conexión

La sección de PostgreSQL

La pestaña « "PostgreSQL" » contiene información adecuada para aplicaciones que se conectan a PostgreSQL.

PostgreSQL/URI información de conexión
Nombre de campo Índice Descripción
Type Tipo de conexión: en el caso de PostgreSQL,, es «URI».
Scheme Esquema de un URI: en el caso de PostgreSQL,, es «postgresql».
Path Vía de acceso para un URI: para PostgreSQL, es el nombre de la base de datos. El valor predeterminado es ibmclouddb.
Authentication Username El nombre de usuario que utiliza para conectarse.
Authentication Password Una contraseña para el usuario; podría aparecer como « $PASSWORD ».
Authentication Method Cómo se realiza la autenticación; la autenticación "directa" la maneja el controlador.
Hosts 0... Un nombre de host y un puerto al que conectar.
Composed 0... Un URI que combina el esquema, la autenticación, el host y la ruta.
  • 0... indica una o varias de estas entradas en una matriz.

La sección CLI

La sección «CLI» contiene información útil para conectarse a psql.

PostgreSQL/cli información de conexión
Nombre de campo Índice Descripción
Bin El archivo binario para establecer una conexión; en este caso es psql.
Composed Un mandato con formato para establecer una conexión con el despliegue. El mandato combina el ejecutable Bin, los valores de la variable de Environment y utiliza Arguments como parámetros de línea de mandatos.
Environment Una lista de claves/valores que ha establecido como variables de entorno.
Arguments 0... La información que se pasa como argumentos al mandato que se muestra en el campo Bin.
Type El tipo de paquete que utiliza esta información de conexión; en este caso cli.
  • 0... indica que puede haber una o varias de estas entradas en una matriz.