Verbindungszeichenfolgen abrufen

Abrufen von Verbindungsstrings in der Benutzeroberfläche

Um eine Verbindung zu IBM Cloud® Databases for PostgreSQL herzustellen, benötigen Sie einige Benutzer und Verbindungszeichenfolgen. Die Verbindungszeichenfolgen für Ihre Bereitstellung werden auf der Übersichtsseite im Bereich Endpunkte angezeigt.

Endpunkte-Panel auf dem Dashboard Übersicht

Eine Databases for PostgreSQL-Bereitstellung wird mit einem Benutzer mit Administratorberechtigung eingerichtet. Nach dem Festlegen des Administratorkennworts können Sie die zugehörigen Verbindungszeichenfolgen verwenden, um eine Verbindung zu Ihrer Bereitstellung herzustellen.

Abrufen von Verbindungszeichenfolgen in der CLI

Verbindungszeichenfolgen über die CLI abrufen.

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

Die vollständigen Verbindungsinformationen werden mithilfe des Befehls ibmcloud cdb deployment-connections und des Flags --all zurückgegeben. Um alle Verbindungsinformationen für eine Bereitstellung mit dem Namen 'example-deployment' abzurufen, verwenden Sie den folgenden Befehl.

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

Wenn Sie keinen Benutzer angeben, geben die Befehle deployment-connections standardmäßig die Informationen für den Benutzer mit Administratorberechtigung zurück. Wenn Sie keinen Endpunkttyp angeben, wird von der Verbindungszeichenfolge standardmäßig der öffentliche Endpunkt zurückgegeben. Wenn Ihre Bereitstellung nur einen privaten Endpunkt hat, müssen Sie --endpoint-type private angeben. Andernfalls geben die Befehle einen Fehler zurück. Es werden keine bestimmten Benutzer und Endpunkttypen erzwungen. Sie können jeden beliebigen Benutzer für Ihre Bereitstellung mit einem der beiden Endpunkte verwenden (sofern diese für Ihre Bereitstellung vorhanden sind).

Für die Verwendung der CLI-Befehle ibmcloud cdb müssen Sie das Cloud Databases-Plug-in installieren.

Abrufen von Verbindungszeichenfolgen in der API

Verwenden Sie zum Abrufen der Verbindungszeichenfolgen des Benutzers über die API den Endpunkt /users/{userid}/connections. Sie müssen im Pfad angeben, welcher Benutzer und welcher Endpunkttyp (öffentlich oder privat) in den zurückgegebenen Verbindungszeichenfolgen verwendet werden soll. Es werden keine bestimmten Benutzer und Endpunkttypen erzwungen. Sie können jeden beliebigen Benutzer für Ihre Bereitstellung mit einem der beiden Endpunkte verwenden (sofern diese für Ihre Bereitstellung vorhanden sind).

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

Aufgliederung der Verbindungszeichenfolge

Abschnitt 'PostgreSQL'

Die Registerkarte "PostgreSQL" enthält Informationen, die für Anwendungen geeignet sind, die Verbindungen zu PostgreSQL herstellen.

Informationen zur PostgreSQL-/URI-Verbindung
Feldname	Index	Beschreibung
`Type`		Verbindungstyp – bei PostgreSQL, ist dies URI.
`Scheme`		Schema für eine URI – für PostgreSQL, lautet diese postgresql.
`Path`		Pfad für einen URI: Für PostgreSQL ist dieser der Datenbankname. Der Standardwert ist `ibmclouddb`.
`Authentication`	`Username`	Der Benutzername, den Sie zum Herstellen einer Verbindung verwenden
`Authentication`	`Password`	Ein Passwort für den Benutzer – wird möglicherweise als angezeigt `$PASSWORD`.
`Authentication`	`Method`	Gibt an, wie die Authentifizierung erfolgt; die 'direkte' Authentifizierung wird vom Treiber abgewickelt
`Hosts`	`0...`	Hostname und Port, zu denen die Verbindung hergestellt werden soll.
`Composed`	`0...`	Eine URI, die Scheme, Authentication, Host und Path kombiniert.
`Certificate`	`Name`	Der zugewiesene Name für das proprietäre Zertifikat des Dienstes zur Datenbankbereitstellung.
`Certificate`	Base64	Eine Version des Zertifikats in Base64-Codierung

0... gibt mindestens einen dieser Einträge in einem Array an.

Abschnitt "CLI"

Der Abschnitt CLI enthält Informationen, die für die Anbindung an … geeignet sind psql.

psql/cli-Verbindungsinformationen
Feldname	Index	Beschreibung
`Bin`		Die ausführbare Datei zum Herstellen einer Verbindung; in diesem Fall ist es `psql`.
`Composed`		Ein formatierter Befehl zum Aufbauen einer Verbindung zu Ihrer Bereitstellung. Der Befehl verbindet die ausführbare `Bin`-Datei, Einstellungen der Variablen `Environment` und verwendet `Arguments` als Befehlszeilenparameter.
`Environment`		Eine Liste von Schlüsseln/Werten, die Sie als Umgebungsvariablen festlegen.
`Arguments`	0...	Die Informationen, die als Argumente an den im Feld 'Bin' angezeigten Befehl übergeben werden.
`Certificate`	Base64	Ein dienstspezifisches Zertifikat, das dazu dient, zu bestätigen, dass eine Anwendung eine Verbindung zum richtigen Server herstellt. Das Zertifikat liegt in Base64-Codierung vor.
`Certificate`	Name	Der zugewiesene Name für das proprietäre Zertifikat des Dienstes.
`Type`		Der Typ des Pakets, das diese Verbindungsinformationen verwendet; in diesem Fall `cli`.

0... Gibt an, dass es möglicherweise weitere derartige Einträge in einem Array gibt.