Running a SQL connector

Einleitung

Diese Seite enthält Anweisungen zum Ausführen eines SQL-Connectors mithilfe von Skripts.

Voraussetzungen

run.ps1 und load.ps1 müssen auf demselben Server wie die Process Mining-Installation für die Produktion ausgeführt werden. Die extraction_cdata.ps1 und transform.ps1 können auch an anderen Orten ausgeführt werden.

Es wird davon ausgegangen, dass:

die unter Einrichten einer lokalen Testumgebung beschriebenen Entwicklungstools installiert sind.
der SQL-Connector wird wie unter Einrichten eines SQL-Connectorsbeschrieben eingerichtet.

Hinweis: Das Verzeichnis scripts/ des Connectors enthält eine Reihe von Standardskripts zum Ausführen und Planen der Datenextraktion, -transformation und -laden.

Ausführen eines Connectors

Führen Sie diese Schritte aus, um einen Connector auszuführen, die Daten zu extrahieren, zu transformieren und zu laden.

Schritt	Aktion
1	Starten Sie Windows PowerShell als Administrator.
2	Wechseln Sie zum Verzeichnis `scripts/` .
3	Führen Sie `run.ps1` aus.

Nur Extraktion wird ausgeführt

Führen Sie diese Schritte aus, um nur die Extraktion auszuführen.

Schritt	Aktion
1	Starten Sie Windows PowerShell.
2	Wechseln Sie zum Verzeichnis `scripts/` .
3	Führen Sie `extraction_cdata.ps1` aus.

Hinweis: Wenn Ihr Connector CData Sync nicht für die Datenextraktion verwendet, ist der Name von extraction_ script anders.

Nur ausgeführte Transformationen

Führen Sie diese Schritte aus, um nur die Transformationsschritte auszuführen.

Schritt	Aktion
1	Starten Sie Windows PowerShell.
2	Wechseln Sie zum Verzeichnis `scripts/` .
3	Führen Sie `transform.ps1` aus.

Jeder Transformationsschritt kann auch einzeln ausgeführt werden.

Nur laufende Last

Führen Sie diese Schritte aus, um nur die Ladeschritte auszuführen.

Schritt	Aktion
1	Starten Sie Windows PowerShell als Administrator.
2	Wechseln Sie zum Verzeichnis `scripts/` .
3	Führen Sie `load.ps1` aus.

Debuggen von Fehlern

Beim Ausführen der Skripts wird eine Protokolldatei LogFile.log erstellt. Diese Protokolldatei enthält alle Phasen der Auftragsausführung und die zugehörigen Zeitstempel. Die Protokolldatei gibt auch einen minimalen Satz von Fehlercodes zurück, die weitere Hinweise geben können.

Laden

Weitere Informationen zur Cache-Generierung finden Sie unter cache_generation_output.log , das in dem Verzeichnis generiert wird, in dem sich Ihr Ladeskript befindet.

CData-Extraktionen

Weitere Informationen zu den CData Sync-Auftragsausführungen finden Sie in Ihrer CData Sync-Instanz auf der Registerkarte Protokollierung und Verlauf Ihres Auftrags. Siehe Abbildung unten.

Um weitere Details zu protokollieren, legen Sie die Ausführlichkeit der Protokolldatei auf Verbose fest und führen Sie das Extraktionsskript extraction_cdata.ps1 erneut aus.

Nachfolgend finden Sie eine Übersicht über die Rückgabecodes eines CData Sync-Auftrags.

Code	Protokollbeschreibung
0	Extraktion ERFOLGREICH für Auftrag.
–1	Extraktion FEHLGESCHLAGEN für Auftrag.
-2	Fehler beim Ausführen der Extraktion. Überprüfen Sie Ihre Einstellungen oder sehen Sie sich die Registerkarte Protokollierung und Verlauf für Ihren Auftrag an.

Transformationen

Die Protokolldatei gibt auch eine Reihe von Fehlercodes des Transformationsskripts zurück. Nachfolgend finden Sie eine Übersicht über die Fehlercodes.

Code	Protokollbeschreibung
–1	Allgemeiner `dbt run` - oder `dbt test` -Fehler. Dies bedeutet, dass ein Problem mit dem aktuellen Setup oder der Konfiguration vorliegt. Weitere Informationen finden Sie unter `LogFile.log` .
0*	Der `dbt` -Aufruf wurde ohne Fehler abgeschlossen.
1*	Der `dbt` -Aufruf wurde mit mindestens einem behandelten Fehler abgeschlossen (z. B. Modellsyntaxfehler, ungültige Berechtigungen usw.). Die Ausführung wurde abgeschlossen, aber einige Modelle wurden möglicherweise übersprungen. `LogFile.log` enthält zusätzliche Informationen, die angeben, ob der Fehler in der Phase `dbt run` oder in der Phase `dbt test` aufgetreten ist.
2*	Der `dbt` -Aufruf wurde mit einem nicht behandelten Fehler abgeschlossen (z. B. eine Netzwerkunterbrechung).

* 0, 1 und 2 sind dbt-spezifische Rückgabecodes. Weitere Informationen zu Exit-Codes finden Sie in der offiziellen dbt-Dokumentation.

Debuggen großer Dbt-Projekte

Wenn die Ausführung der Transformation lange dauert, kann response.txt im Verzeichnis scripts/ überprüft werden. Dies enthält die Echtzeitantworten von dbt. Sobald dbt test oder dbt run abgeschlossen sind, werden die Informationen an LogFile.log angehängt und die temporäre Datei wird gelöscht.