Obtención de series de conexión

Obtención de cadenas de conexión en la interfaz de usuario

Para conectarse a IBM Cloud® Databases for PostgreSQL, necesita algunos usuarios y algunas series de conexión. Las cadenas de conexión para su implementación se muestran en la página Descripción general, en el panel Puntos de conexión.

Panel "Endpoints" en la vista general del panel — Panel Endpoints"

Un despliegue de Databases for PostgreSQL se suministra con un usuario administrador y, tras establecer la contraseña de administrador, puede utilizar sus series de conexión para conectarse al despliegue.

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

Obtener cadenas de conexión desde la CLI.

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

El mandato ibmcloud cdb deployment-connections devuelve información de conexión completa si se utiliza el distintivo --all. Para recuperar toda la información de conexión de un despliegue denominado "example-deployment", utilice el mandato siguiente.

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

Si no especifica un usuario, los mandatos deployment-connections devuelven información para el usuario admin de forma predeterminada. Si no especifica un tipo de punto final, la serie de conexión devuelve el punto final público de forma predeterminada. 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. Puede utilizar cualquier usuario del despliegue con cualquiera de los puntos finales (si ambos existen en el despliegue).

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

Obtención de 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.

Información sobre la conexión entre PostgreSQL y URI
Nombre de campo	Índice	Descripción
`Type`		Tipo de conexión: para 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 del usuario; puede 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.
`Certificate`	`Name`	El nombre asignado al certificado propio del servicio para la implementación de la base de datos.
`Certificate`	Base64	Una versión codificada en base64 del certificado.

0... indica una o más de estas entradas en una matriz.

La sección CLI

La sección CLI contiene información útil para conectarse con psql.

información de conexión psql/cli
Nombre de campo	Índice	Descripción
`Bin`		El 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.
`Certificate`	Base64	Un certificado propio del servicio que se utiliza para confirmar que una aplicación se está conectando al servidor adecuado. Está codificado en base64.
`Certificate`	Nombre	El nombre asignado al certificado propio del servicio.
`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.