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 de su implantación se muestran en la página Descripción general, en el panel Puntos finales.

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.

Obtención de cadenas de conexión en la CLI

Seleccione las series de conexión de 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. Debe especificar en la ruta qué usuario y qué tipo de endpoint (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 las aplicaciones que establecen conexiones con PostgreSQL.

información de conexión postgresql/URI
Nombre de campo	Índice	Descripción
`Type`		Tipo de conexión: para PostgreSQL, es "URI"
`Scheme`		Esquema para un URI: para 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; puede mostrarse 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 a los que conectarse
`Composed`	`0...`	Un URI que combina los valores de Esquema, Autenticación, Host y Vía de acceso
`Certificate`	`Name`	El nombre asignado para el certificado propietario del servicio para el despliegue 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 adecuada para conectarse con psql.

información de conexión psql/cli
Nombre de campo	Índice	Descripción
`Bin`		El binario para crear 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	Certificado propietario de un 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 para el certificado propietario 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.