Verbindungszeichenfolgen abrufen

Gen 2

Abfrage von Verbindungszeichenfolgen in der Benutzeroberfläche

Befolgen Sie diese Schritte, um die Verbindungszeichenfolgen für Ihre „ IBM Cloud® Databases for PostgreSQL “-Instanz abzurufen:

  1. Scrollen Sie auf der Übersichtsseite Ihrer Bereitstellung nach unten zum Abschnitt „ Service-Endpunkte “.
  2. Im Abschnitt „Service-Endpunkte“ werden Registerkarten für die verfügbaren Verbindungsmethoden angezeigt:
  • PostgreSQL – Zeigt die Verbindungszeichenfolge, die Hostnamen, die Ports, den Datenbanknamen, die Authentifizierungsquelle und das Replikatset für Ihre Bereitstellung an.
  • CLI – Enthält Informationen zur Verbindung über die „ IBM CLI “.

Architektur
Abrufen von Verbindungszeichenfolgen – Registerkarte „ PostgreSQL “ unter „Service-Endpunkte“

Databases for PostgreSQL Deployments enthalten nicht mehr standardmäßig eine „ admin user “. Stattdessen erstellen Sie einen Benutzer mit der Rolle „Manager“, „Writer“ oder „Reader“ mithilfe der Schnittstelle für Dienstanmeldeinformationen unter IBM Cloud® – entweder über die Benutzeroberfläche oder die Befehlszeile. Hiermit erhalten Sie einen Benutzernamen (ibm_...), ein Passwort und eine Verbindungszeichenfolge, mit denen Sie eine Verbindung zu Ihrer Bereitstellung herstellen können.

Abrufen von Verbindungszeichenfolgen in der CLI

Den Endpunkt finden Sie auch auf der Registerkarte „CLI“ unter den Service-Endpunkten.

Architektur
Abrufen von Verbindungszeichenfolgen – Registerkarte „CLI“ unter „Service-Endpunkte“

Sie können Verbindungszeichenfolgen auch mithilfe des Befehls „Connection“ des CLI-Plug-ins „ Cloud Databases “ abrufen.

Der Befehl ähnelt dem folgenden:

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

Weitere Informationen finden Sie unter „ Befehlsoptionen für Verbindungen “.

Databases for PostgreSQL Die Bereitstellung enthält keinen Standard-Administratorbenutzer mehr. Stattdessen legen Kunden mithilfe der Schnittstelle für Dienstanmeldeinformationen unter IBM Cloud® – entweder über die Benutzeroberfläche oder die Befehlszeile – einen Benutzer mit der Rolle „Manager“, „Writer“ oder „Reader“ an. Hiermit erhalten Sie einen Benutzernamen (ibm_...), ein Passwort und eine Verbindungszeichenfolge, mit denen Sie eine Verbindung zu Ihrer Bereitstellung herstellen können. 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 in Ihrer Bereitstellung mit dem privaten Endpunkt verwenden, der als Verbindungsoption vorgesehen ist.

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

Abrufen von Verbindungszeichenfolgen in der API

Um die Verbindungszeichenfolgen der Benutzer aus der „ Cloud Databases “-API abzurufen, verwenden Sie den Endpunkt „Connections “. Stellen Sie beim Erstellen der Verbindungszeichenfolgen sicher, dass der Pfad den jeweiligen Benutzer und den Endpunkttyp enthält, die verwendet werden sollen. Das Gesetz zur Förderung der Gleichstellung von Frauen und Männern in der Wirtschaft ( user ) unterliegt keinen Einschränkungen und wird nicht durchgesetzt. Sie haben die Flexibilität, jeden in Ihrer Bereitstellung verfügbaren Benutzer zu nutzen.

Der API-Befehl sieht wie folgt aus:

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

Denken Sie daran, {region}, {id}, {userid} und {endpoint_type} durch die entsprechenden Werte zu ersetzen.

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 Verbindungsdaten
Feldname Index Beschreibung
Type Verbindungstyp – bei „ PostgreSQL, “ lautet dieser „URI“.
Scheme Schema für eine URI – für PostgreSQL, lautet es „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 – könnte beispielsweise wie folgt aussehen: $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, Authentifizierung, Host und Pfad kombiniert.
  • 0... bezeichnet einen oder mehrere dieser Einträge in einem Array.

Abschnitt "CLI"

Der Abschnitt „CLI“ enthält Informationen, die für die Verbindung mit psql geeignet sind.

PostgreSQL/cli Verbindungsdaten
Feldname Index Beschreibung
Bin Die Binärdatei 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.
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.