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 Seite Übersicht 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 Verbindungsstrings in der CLI

Rufen Sie Verbindungszeichenfolgen über die Befehlszeilenschnittstelle ab.

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 welche Art von Endpunkt (ö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.

postgresql/URI-Verbindungsinformationen
Feldname	Index	Beschreibung
`Type`		Verbindungstyp: Für PostgreSQL ist dieser "URI".
`Scheme`		Schema für einen URI: Für PostgreSQL ist dieser "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 Kennwort für den Benutzer; die Anzeige erfolgt gegebenenfalls in Form von `$PASSWORD`
`Authentication`	`Method`	Gibt an, wie die Authentifizierung erfolgt; die 'direkte' Authentifizierung wird vom Treiber abgewickelt
`Hosts`	`0...`	Ein Hostname und ein Port zur Herstellung einer Verbindung
`Composed`	`0...`	Eine URI aus einer Kombination von Schema, Authentifizierung, Host und Pfad
`Certificate`	`Name`	Der zugewiesene Name für das diensteigene Zertifikat für die 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 Verbindung mit psql geeignet sind.

psql/cli-Verbindungsinformationen
Feldname	Index	Beschreibung
`Bin`		Das Binärprogramm zum Erstellen 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 diensteigenes Zertifikat, das verwendet wird, um zu bestätigen, dass eine Anwendung eine Verbindung zum entsprechenden Server herstellt. Das Zertifikat liegt in Base64-Codierung vor.
`Certificate`	Name	Der zugewiesene Name für das diensteigene Zertifikat.
`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.