Setting up a SQL connector

Einleitung

Diese Seite enthält die Anweisungen zum Erstellen eines neuen SQL-Connectors und zum Verbinden mit Ihren Quellsystemen.

Voraussetzungen

Es wird davon ausgegangen, dass die unter Einrichten einer lokalen Testumgebung beschriebenen Entwicklungstools installiert sind.

Erstellen eines neuen SQL-Connectors

Wenn Sie einen neuen SQL-Connector erstellen möchten, können Sie den Vorlagen-Connector herunterladen, der die grundlegende Einrichtung für einen SQL-Connector enthält.

Repository starten

Es wird empfohlen, Ihren Connector in einem Versionskontrollsystem zu speichern, z. B. GitHub.

Schritt	Aktion
1	Erstellen Sie ein neues Repository, das das vollständige Connector-Verzeichnis enthält. Dieses Verzeichnis muss dieselbe Struktur wie der heruntergeladene Connector (Vorlage) haben.

Extraktion konfigurieren

Zuerst müssen die Extraktionseinstellungen so festgelegt werden, dass sie auf das gewünschte Quellsystem und die Staging-Datenbank verweisen. Diese Konfigurationsschritte müssen einmal für jede Entwicklerumgebung und für die Produktionsumgebung durchgeführt werden.

Schritt 1: Extraktionsmethode auswählen

Jeder Connector verfügt über eine Reihe spezifischer Extraktionsmethoden. Eine der Extraktionsmethoden muss konfiguriert werden, um Quelldaten zu extrahieren.

Extraktionsmethode	Beschreibung
Laden aus Datei	# Einrichten eines CData -Auftrags für den Extraktor Laden von Datei . Siehe Extraktoren: Laden aus Datei. • Verwenden Sie eine benutzerdefinierte Abfrage speziell für diesen Connector, die in `extractors/load-from-file/instructions.md` bereitgestellt wird.
Aus Quelle laden	Um Eingabedaten aus einem Quellsystem zu laden, verwenden Sie die spezifischen Anweisungen in `extractors/load-from-source/instructions.md` . Der Load-from-Source-Extraktor ist nur in Connectors verfügbar, die für bestimmte Quellsysteme erstellt wurden, z. B. ein Purchase-to-Pay für SAP-Connector.

Schritt 2: Quelldaten begrenzen

Stellen Sie sicher, dass Sie die entsprechenden Filter für Ihren Extraktor festlegen, um nur die Daten zu laden, die für Ihre Analyse erforderlich sind. Beschränken Sie die Daten beispielsweise auf die letzten 6 Monate oder nur auf eine bestimmte Abteilung, die von Interesse ist.

Spezifische Anweisungen zum Filtern von Eingabedaten finden Sie in instructions.md des Extraktors.

Schritt 3: Konfigurieren des Extraktionsskripts

Wenn der Connector CData Sync für die Datenextraktion verwendet, muss das extract_cdata.ps1 -Skript auf den richtigen Auftrag verweisen. Führen Sie diese Schritte aus, um das Extraktionsskript zu konfigurieren.

Schritt	Aktion
1	Benennen Sie im Verzeichnis `scripts/` `config_template.json` in `config.json` um. `config.json` von Git ignoriert, sodass Entwicklungs- und Produktionsumgebungen unterschiedliche Extraktionskonfigurationen verwenden können.
2	Ändern Sie in `config.json` den Text `JOB_NAME_CREATED_IN_CDATA` in den soeben erstellten CData-Auftrag.

Wenn der Connector CData Sync nicht zum Extrahieren von Daten verwendet, verwenden Sie die spezifischen Anweisungen in instructions.md .

Transformation konfigurieren

Um die Transformation für die richtige Stagingdatenbank durchzuführen, muss profiles.yml einen Verweis auf Ihre Stagingdatenbank für diesen Connector haben. Diese Konfigurationsschritte müssen einmal für jede Entwicklerumgebung und für die Produktionsumgebung durchgeführt werden. Führen Sie diese Schritte aus, um die Umwandlung zu konfigurieren.

Schritt	Aktion
1	Kopieren Sie den Inhalt von `transformations/profiles.yml` Ihres Connectors.
2	Fügen Sie den Inhalt in Ihr persönliches `profiles.yml` ein, um diese hinzuzufügen. Die persönliche `profiles.yml` sollte sich außerhalb des Connector-Verzeichnisses befinden.
3	Ändern Sie den Inhalt so, dass er auf Ihre Staging-Datenbank verweist.

Laden konfigurieren

Um die Cache-Generierung mithilfe des Skripts „load.ps1“ durchzuführen, muss es auf die Process Mining -Umgebung verweisen, in der die entsprechende App-Version aktiv ist. Führen Sie diese Schritte aus, um das Extraktionsskript zu konfigurieren.

Schritt 1 kann ausgelassen werden, wenn er bereits während der Konfiguration der Extraktion ausgeführt wurde.

Schritt	Aktion
1	Benennen Sie im Verzeichnis `scripts/` `config_template.json` in `config.json` um. `config.json` von Git ignoriert, sodass Entwicklungs- und Produktionsumgebungen unterschiedliche Extraktionskonfigurationen verwenden können.
2	Ändern Sie in `config.json` den Text `PROCESS_MINING_ENVIRONMENT` in die Umgebung, in der die Version aktiv ist.