Verbindungseinstellungen zum Data Service
Die Service-Verbindung gilt gemeinsam für alle Upload- und Download-Konfigurationen. Sie wird in der lokalen Konfigurationsdatenbank gespeichert und auch von der Konsole verwendet.
Dialog öffnen
In der Symbolleiste auf den Verbindungsstatus klicken, beispielsweise Not Connected oder Successfully Connected. Beim Start mit einer ungültigen Verbindung öffnet sich der Dialog automatisch.
Service
| Feld | Bedeutung |
|---|---|
| URI | Adresse des Asset Manager Service mit Protokoll, zum Beispiel https://assetmanager.example.org. Bei einer üblichen Bereitstellung direkt unter dem Host wird der Port ausschließlich im separaten Portfeld eingetragen. |
| Port | Port des Service-Endpunkts. Vorbelegt ist 443; maßgeblich ist die tatsächliche Service-Konfiguration. |
| API Key | API-Key für den Zugriff auf die Connector-Schnittstelle. Er wird bei den Service-Aufrufen als X-API-KEY übertragen. |
Erforderlich ist die Adresse des Connector-Service-Endpunkts. Eine erreichbare Webseite unter derselben Adresse genügt nicht: Der Endpunkt muss die gRPC-Aufrufe des Connectors verarbeiten können.
Proxy Server
Enabled aktivieren, wenn für die Service-Verbindung ein expliziter Proxy benötigt wird.
| Feld | Bedeutung |
|---|---|
| Name | Hostname beziehungsweise Adresse des Proxyservers. |
| Port | Port des Proxys; vorbelegt ist 443. |
| Username / Password | Optionale explizite Zugangsdaten. Die Anwendung setzt diese Proxy-Anmeldedaten, wenn ein Benutzername angegeben ist. |
Diese Proxy-Einstellungen betreffen den HTTP-/gRPC-Zugriff auf den Data Service. Sie konfigurieren keinen Proxy für die direkte SQL-Verbindung.
Prüfen und speichern
- Die Verbindungsdaten eintragen.
- Mit OK bestätigen.
- Der Connector ruft
GetVersionmit den angegebenen Daten auf. - Bei erfolgreicher Prüfung schließt sich der Dialog und die Verbindung wird gespeichert.
Bei einem Fehler erscheint die Fehlermeldung, der Dialog bleibt geöffnet und die bisherigen Service-Einstellungen werden wiederhergestellt. Die Eingaben korrigieren oder den Dialog mit Cancel schließen.
Status verstehen
- Successfully Connected: Die zuletzt vorgenommene Verbindungsprüfung war erfolgreich. Neue Konfigurationen können angelegt werden.
- Not Connected: Die Prüfung war nicht erfolgreich. New ist deaktiviert.
Die Statusanzeige ist keine kontinuierliche Überwachung. Eine erfolgreiche Versionsabfrage bestätigt außerdem noch nicht die SQL-Berechtigungen für die später ausgewählten Datenobjekte.
Verbindung schlägt fehl
URI und Port, den Connector-API-Key, die Zertifikatsvertrauenskette sowie gegebenenfalls Proxy und Weiterleitung von gRPC/HTTP/2 prüfen. Bei einem Download benötigt zusätzlich der Service selbst Zugriff auf die ausgewählten SQL-Quellen. Weitere Hinweise stehen unter Betrieb und Fehlerdiagnose.