Skip to main content

Betrieb und Fehlerdiagnose

Ablage und gemeinsame Nutzung

Die Datei config im Arbeitsverzeichnis bestimmt, wo Konfigurationsdatenbank und Protokolle liegen. Mit der mitgelieferten Belegung verwenden GUI und Konsole:

  • %ProgramData%\smcTeam\AssetManagerConnector\data.db für Service-Verbindung, Transferkonfigurationen, Spaltenauswahl und letzte Ergebnisse.
  • %ProgramData%\smcTeam\AssetManagerConnector\Logs\AssetManagerConnector.log als konfigurierten Dateiprotokollpfad.

Das Datenverzeichnis lässt sich in der GUI über Location öffnen. Bei getrennten Installationsverzeichnissen von GUI und Konsole müssen deren Einstellungen auf dieselbe Datenbank zeigen, wenn dieselben Konfigurationen verwendet werden sollen.

SQL- und Proxy-Passwörter werden verschlüsselt gespeichert; der API-Key ist ein Feld der Konfigurationsdatenbank. Die Datenbank und ihre Sicherungen sind daher als Dateien mit Zugangsdaten zu behandeln.

Konfigurationen sichern

  1. Die GUI beenden und einen laufenden Konsolenprozess vollständig abschließen lassen.
  2. Das Konfigurationsverzeichnis einschließlich data.db sowie die tatsächlich verwendete Datei config sichern.
  3. Für eine Fehleranalyse zusätzlich die Protokolle des betroffenen Zeitraums sichern.

Die benutzerspezifische Datei %LocalAppData%\smcTeam\AssetManagerConnector\1\Settings.json enthält Oberflächeneinstellungen. Sie ist nicht die Ablage der Service-Verbindung oder der Transferaufträge.

Diagnosefolge

  1. Feststellen, ob der Fehler beim Start, beim Verbinden oder während eines bestimmten Objekts auftritt.
  2. Den Zeitstempel und die letzte Meldung des betroffenen Objekts prüfen.
  3. Die Logeinträge des gesamten zugehörigen Laufs lesen.
  4. Bei einem Schreibfehler vor einer erneuten Ausführung den aktuellen Zustand der Zieltabelle prüfen.

Typische Meldungen und Ursachen

Symptom oder Meldung Prüfung und Vorgehen
Die Datei config wird nicht gefunden. Arbeitsverzeichnis beziehungsweise „Starten in“ prüfen. Die Datei hat keine Endung und muss vom ausführenden Konto gelesen werden können.
SQLite-Datenbank oder Tabellen fehlen. Zuerst die GUI zur Ersteinrichtung starten. Danach prüfen, ob die Konsole dieselbe Datenbank verwendet. Eine vorhandene Datenbank aus einem inkompatiblen alten Stand wird nicht automatisch migriert.
Not Connected / Fehler bei der Service-Prüfung Service-URI, Port, API-Key, Zertifikate und Proxy prüfen. Der Versionsaufruf muss die Connector-gRPC-Schnittstelle erreichen.
Please define a valid connection to the data service first. Die globale Service-Verbindung im Verbindungsdialog korrigieren und erfolgreich mit OK prüfen.
Please define a valid database first. Bei Download die vorhandene SQL-Zieldatenbank unter Database Name eintragen.
Host '…' is not reachable, status: '…'. Die vorgeschaltete Ping-Prüfung ist fehlgeschlagen. DNS und ICMP-Erreichbarkeit prüfen. Wird ICMP bewusst blockiert, kann die Einstellung PingEnabled in der verwendeten Datei config auf false gesetzt und die GUI neu gestartet werden; anschließend prüft Connect weiterhin die SQL-Verbindung.
SQL-Anmeldung fehlgeschlagen Server, Port, Anmeldung und Rechte des tatsächlich ausführenden Kontos prüfen. Beim Wechsel auf Windows-Authentifizierung gespeicherte SQL-Zugangsdaten vorher leeren.
Objekt kann nicht angehakt werden. Nicht unterstützte Spalten beziehungsweise bei Upload die Sperrliste prüfen. Das gesamte Objekt muss die Auswahlprüfung bestehen.
The table '…' cannot be uploaded. Der Service weist den Zielnamen zurück, weil eine gleichnamige, nicht als Connector-Tabelle registrierte Tabelle oder View vorhanden ist. Einen zulässigen Zielnamen verwenden.
Fehlerhafte SELECT-Abfrage oder ungültiger Spaltenname Mindestens eine Spalte aktivieren und gespeicherte Spaltennamen mit der aktuellen Quelle vergleichen. Nach Strukturänderungen die Objektauswahl aktualisieren.
Fehler beim Löschen oder Anlegen der Download-Tabelle Vorhandensein des Zielschemas, DDL-Berechtigungen und Abhängigkeiten wie Fremdschlüssel prüfen. Die Zieldatenbank wird nicht automatisch angelegt.
Zieltabelle nach fehlgeschlagenem Download fehlt. Der Download ersetzt Tabellen durch Löschen und Neuanlegen. Der alte Bestand wird nicht automatisch wiederhergestellt. Fehlerursache anhand des Logs beheben und erneut ausführen.
Konsole meldet Erfolg, ein früherer Transfer fehlt. Alle Meldungen des Laufs prüfen. Ein späterer erfolgreicher Auftrag kann den früheren Fehler-Rückgabecode überschreiben.
GUI zeigt nach einem Konsolenlauf alte Ergebnisse. GUI nach dem vollständig abgeschlossenen Konsolenlauf neu öffnen. Bereits geladene Registerkarten werden nicht automatisch aus SQLite aktualisiert.

Große Datenbestände

Ein Objekt wird vollständig als DataTable eingelesen und als vollständige Nachricht übertragen. Es gibt im Connector keinen konfigurierbaren zeilenweisen Streaming- oder Batch-Modus. Der gRPC-Client begrenzt Sende- und Empfangsnachrichten auf jeweils 256 MiB; Service und vorgeschaltete Infrastruktur können zusätzliche Grenzen setzen.

Bei Speicher- oder Nachrichtengrößenfehlern den übertragenen Datenbestand über die Spaltenauswahl oder passend zugeschnittene Quellviews reduzieren. Ein höherer SQL-Verbindungs-Timeout ändert weder diese Nachrichtengrenze noch das feste Timeout der Download-Schreiboperationen.

Zielwerte weichen von der Quelle ab

Der Connector erzeugt eine Übertragungsstruktur und keine unveränderte Kopie aller SQL-Typen. Bei einer Abweichung zunächst Quelltyp, tatsächlichen Zieltyp und die konkrete Objektmeldung prüfen.

Ein im aktuellen Download-Code relevanter Sonderfall sind Dezimalspalten mit einer Skala von 0: Bei der Zieltabellenerstellung wird eine Skala kleiner als 1 auf DECIMAL(10,2) zurückgesetzt. Das kann bei großen Werten zu Überläufen führen. Ein anderer Sonderfall sind float und real: Sie sind in der Objektauswahl zugelassen, werden vom Transfercode jedoch über den allgemeinen NVARCHAR-Zweig beschrieben.

Angaben für eine Fehleranalyse

Benötigt werden Anwendungsversion, Übertragungsrichtung, Konfigurations- und Objektname, Zeitpunkt des Laufs, vollständige Fehlermeldung sowie die passenden Logeinträge. Bei einem Konsolenproblem ergänze Arbeitsverzeichnis und Ausführungskonto. API-Keys und Passwörter gehören nicht in die Fehlerbeschreibung.