Verbindungszeichenfolgen abrufen

Um eine Verbindung zu IBM Cloud® Databases for MySQL herzustellen, benötigen Sie einige Benutzer und Verbindungszeichenfolgen. Verbindungszeichenfolgen für Ihre Bereitstellung werden in der Dashboardübersicht in der Anzeige Endpunkte angezeigt.

Endpunkte-Panel in der Übersicht des — in der Übersicht des

Eine Databases for MySQL-Bereitstellung wird mit einem Admin-Benutzer eingerichtet, und nachdem Sie das Admin-Passwort festgelegt haben, können Sie dessen Verbindungszeichenfolgen verwenden, um eine Verbindung zu Ihrer Bereitstellung herzustellen.

CLI
Sie können Verbindungszeichenfolgen auch über die Befehlszeilenschnittstelle abrufen.

ibmcloud cdb deployment-connections example-deployment -u <newusername> [--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 <newusername> --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.

API Um die Verbindungszeichenfolgen des Benutzers von der API abzurufen, verwenden Sie den Endpunkt /users/{userid}/connections. Sie müssen im Pfad den Benutzerendpunkt (öffentlich oder privat) in den zurückgegebenen Verbindungszeichenfolgen angeben. 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 MySQL

Der Abschnitt "mysql" enthält Informationen, die für Anwendungen geeignet sind, die Verbindungen zu mysql herstellen.

mysql/URI-Verbindungsinformationen
Feldname	Index	Beschreibung
`Type`		Art der Verbindung - für MySQL, ist es "URI".
`Scheme`		Schema für einen URI - für MySQL, ist es "mysql".
`Path`		Pfad für einen URI - bei MySQL ist dies 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 als `$PASSWORD` angezeigt werden.
`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...`	Ein URI, der Schema, Authentifizierung, Host und Pfad kombiniert.
`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 an, dass es möglicherweise weitere derartige Einträge in einem Array gibt.

Abschnitt "CLI"

Der Abschnitt "CLI" enthält Informationen, die für die Verbindung mit mysql geeignet sind.

mysql/cli-Verbindungsinformationen
Feldname	Index	Beschreibung
`Bin`		Die empfohlene Binärdatei zum Erstellen einer Verbindung. In diesem Fall ist dies `mysql`.
`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.