Zum Hauptinhalt wechseln
Dokumentation
Dokumentation
Adaptive Planning
Zuletzt aktualisiert: 2024-09-20
Schritte: JDBC-Datenbank-Datenquellen einrichten

Schritte: JDBC-Datenbank-Datenquellen einrichten

Die Sie verwenden können
Adaptive Planning
 Integration, um Informationen aus JDBC-konformen Datenbanken zu extrahieren. Die meisten Datenbanken für Buchhaltungs- und Finanzanwendungen sind JDBC-konforme Datenbanken (Java-Datenbankkonnektivität). JDBC ist ein Standard, der die Programmiersprache Java verwendet, um Konnektivität zu einer Vielzahl von Datenbanken bereitzustellen.
Für eine JDBC-konforme Datenbank-Datenquelle ist ein Treiber erforderlich. Die folgende Tabelle enthält Informationen zu gängigen JDBC-Treibern.
Adaptive Planning-Datenagenten stellen nur eine Verbindung zu lokalen Datenbanken her. Die Verbindung zu Cloud-Datenbanken über einen Agent wird nicht unterstützt.
JDBC-Quelle
Übersicht
Provider-JAR
Treiberklasse
JDBC-/URL-Beispiel
Informationen zur JDBC-URL
Oracle
ojdbc6-11.2.0.3.jar
Sie können diese Datei von der Oracle-Website oder über das Mavi-Repository von Oracle abrufen.
oracle.jdbc.OracleDriver
jdbc:oracle:thin:@example-win-db:1521:anaCONDA
SQL Server
jtds-1.3.1.jar, verteilt im Plugins-Ordner des Datenagenten.
net.sourceforge.jtds.jdbc.Driver
jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS
SQL Server
sqljdbc41.jar, verteilt im Plugins-Ordner des Datenagenten.
com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;
MySql
com.mysql.jdbc.Driver
jdbc:mysql://localhost:3306/AGENT_TEST
h2
Suchen Sie in der Distribution von Workday Adaptive Planning Data Agent Service Manager nach h2*.jar. Für Data Agent-Versionen 7.1.44 und älter suchen Sie h2.jar in der Distribution von Adaptive Data Agent Service Manager.
org.h2.Driver
jdbc:h2:/data/test
Die JAR-Dateien befinden sich in
C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.
Verwenden Sie für Data Agent-Versionen 7.1.44 und älter
C:/Program Files/Adaptive Data Agent/Plugins
-Verzeichnis auf dem Computer, auf dem der Data Agent Service gehostet wird.
Nachdem Sie eine JAR-Datei hinzugefügt haben, müssen Sie zu den lokalen Diensten wechseln und den Data Agent Service neu starten.
Bevor Sie eine Datenquelle aus einer lokalen Datenbank einrichten können, muss ein Datenagent erstellt werden, der dies mitteilt
Adaptive Planning
 Integration zur Kommunikation mit der Datenbank. Informationen zum Erstellen von Datenagenten finden Sie unter Create Data Agents.
Führen Sie die folgenden Schritte aus, um eine JDBC-Datenbank-Datenquelle einzurichten:
  1. Öffnen Sie den Datendesigner über
    Integration > Datendesigner
    .
  2. Klicken Sie im Ordner „Datenquellen“ in der Komponentenbibliothek auf der rechten Seite des Bildschirms auf
    Neue Datenquelle erstellen
    . Das Dialogfeld „Neu erstellen“ wird angezeigt.
  3. Wählen Sie „JDBC-Datenbank“ als Art der Datenquelle aus, geben Sie den Namen der Datenbank ein und wählen Sie den Agenten aus, den Sie für diese Datenquelle verwenden möchten.
  4. Klicken Sie auf
    Erstellen
    . Im mittleren Bereich des Bildschirms werden die Einstellungen der neuen Datenquelle und andere Informationen angezeigt.
  5. Geben Sie Informationen zur Datenquelle ein:
    • Zugeordneter Agent:
       Wählen Sie den Adaptive Planning-Datenagenten aus, mit dem Sie eine Verbindung herstellen möchten. Diese Liste enthält alle Datenagenten aus
      Datenagenten
      der Komponentenbibliothek
      .
    • Treiberklasse:
       Geben Sie die Treiberklasse für die Datenbank ein. (Sie können diese Informationen beim Datenbankanbieter anfordern.)
    • URL:
       Geben Sie die URL der Datenbank ein.
    • Benutzername:
       Geben Sie den Benutzernamen für den Zugriff auf die Datenbank ein.
    • Kennwort:
       Geben Sie das dem Benutzernamen zugeordnete Kennwort ein.
    • Schemafilter:
       Geben Sie die Namen der Schemas ein, aus denen Sie Daten importieren möchten. Wenn Sie die Namen von mehr als einem Schema eingeben, trennen Sie die Schemanamen durch ein Semikolon. Verwenden Sie dieses Feld, um die Anzahl der Tabellen zu beschränken, die aktualisiert werden müssen
      Adaptive Planning
       Integration Dieses Feld ist optional.
    • Protokollebene:
       Wählen Sie eine Protokollebene aus der Dropdown-Liste, um anzugeben, welche Details für diese Datenquelle protokolliert werden. Folgende Optionen sind verfügbar:
      • Fehler:
         Protokolliert nur schwere Fehler.
      • Info
        : Protokolliert alle Basisinformationen, z. B. wann die Datenquelle aktualisiert wurde.
      • Ausführlich:
         Stellt sehr detaillierte Informationen zu allen Phasen und Aktionen bereit. (Diese Ebene wird hauptsächlich für Fehlerbehebung oder Auditing verwendet, da sie möglicherweise mehr Protokollinformationen liefert, als für die normale Verwendung praktikabel ist.)
  6. Klicken Sie im Menü „Aktionen“ auf
    Speichern
    .
Sie können die Verbindungsinformationen in der neuen Datenquelle testen, indem Sie im Menü
Aktionen
 auf
Verbindung testen
 klicken. Das System versucht, anhand der Informationen in den Datenquellenfeldern eine Verbindung zur Datenbank herzustellen. Wenn das System eine Verbindung zur Datenbank herstellen kann, klicken Sie auf
OK
. Wenn Verbindungsprobleme auftreten, beheben Sie die Fehler und versuchen Sie es erneut.
Wenn Sie eine Verbindung zur Datenbank herstellen können, sind Sie bereit, die Datenstruktur zu importieren. Dadurch werden die Tabellen und Spalten in der Datenbank angezeigt.
Es werden nur Spalten für unterstützte Arten angezeigt. Unterstützte Spaltenartenlistet die unterstützten Spaltenarten für die verschiedenen Arten von Datenbanken auf.
Führen Sie die folgenden Schritte aus, um die Struktur der JDBC-Datenbank zu importieren:
  1. Klicken Sie im Menü
    Aktionen
     auf
    Struktur importieren
    . Die Tabellen und Spalten werden im Menü
    Datenkomponenten
     angezeigt.
    Die Datenimportmodi wirken sich auf die Art und Weise aus, wie die Daten synchronisiert werden. Der Standardimportmodus (alle Datensätze ersetzt) für eine JDBC-Datenquelle verläuft wie folgt:
  2. Die JDBC-Daten werden importiert.
  3. Die Staging-Tabelle wird mit den Daten aus der JDBC-Quelle ausgefüllt.
  4. Wenn ein benutzerdefinierter SQL-Filter vorhanden ist, wird dieser auf die vom Datenbankserver zu importierenden Daten angewendet, um die Teilmenge der zu importierenden Daten zu bestimmen.
Sie können auch auswählen, ob Sie die importierten Daten an die bestehende Staging-Tabelle anhängen oder die importierten Daten zusammenführen möchten. Im zweiten Fall werden die vorhandenen Zeilen in den JDBC-Daten mit den Zeilen im Staging-Bereich zusammengeführt.

Tabellen zu einer JDBC-Datenquelle hinzufügen

Nachdem Sie die Struktur der Datenbank importiert haben, können Sie die Informationen angeben, die Sie aus der Datenbank importieren möchten. Im Abschnitt
Zu importierende Tabellen
 können Sie die aus der Datenbank importierten Daten konfigurieren.
Führen Sie die folgenden Schritte aus, um die Tabellen anzugeben, die aus der Datenbank importiert werden sollen:
  1. Erweitern Sie im Menü
    Datenkomponenten
     den Eintrag für die Datenquelle.
    Jede Tabelle in der Datenbank wird als separater Eintrag angezeigt.
  2. Ziehen Sie die Tabellen, die Sie importieren möchten, per Drag-and-Drop in den Abschnitt
    Zu importierende Tabellen
     in der Mitte des Bildschirms.
    Wenn Sie eine Tabelle in den Abschnitt „Zu importierende Tabellen“ ziehen, wird ein Register für die Tabelle hinzugefügt und im Abschnitt „Zu importierende Tabellen“ werden Informationen aus der Datenbank angezeigt. Daraus können Sie die Art der Informationen ersehen, die Sie hinzugefügt haben. Das Register jeder Tabelle verfügt auch über ein Dropdown-Menü, das Sie öffnen können, indem Sie auf den Pfeil neben dem Namen klicken.

Spalten verwalten

Wenn eine Tabelle, an der Sie arbeiten, eine große Anzahl von Spalten enthält, können Sie mit
Spalten verwalten
 schnell festlegen, welche Spalten importiert werden sollen. Im Dialogfeld
Spalten verwalten
 werden die Spalten in einer Tabelle angezeigt, sodass Sie Spalten für den Import auswählen oder deren Auswahl aufheben können.
Führen Sie die folgenden Schritte aus, um Spalten für den Import zu verwalten:
  1. Klicken Sie auf dem Register rechts neben dem Tabellennamen auf den Pfeil.
  2. Klicken Sie in dem unverankerten Menü auf
    Spalten verwalten
    .
  3. Aktivieren Sie das Kontrollkästchen neben einer Spalte, um diese zu importieren.
    Wenn Sie eine Spalte auswählen, wird die Spalte nach dem Speichern des Popup-Inhalts auch im Vorschaufenster angezeigt. Wenn Sie das Kontrollkästchen für eine Spalte deaktivieren, wird die Spalte aus dem Vorschaufenster entfernt.
Sie können den Importstatus für einzelne Spalten auch wie folgt ändern:
  • Wählen Sie Spalteneigenschaften aus und legen Sie die Eigenschaft fest.
  • Ziehen Sie die Spalten per Drag-and-Drop in den Designer.
Für vom System generierte Felder wie
isDeleted
 können Sie den Importstatus nicht ändern.

Tabellen anpassen

Sie können für jede Tabelle die Art und Weise anpassen, wie Daten importiert werden.
Führen Sie die folgenden Schritte aus, um die Tabelleneinstellungen anzupassen:
  1. Klicken Sie auf dem Register rechts neben dem Tabellennamen auf den Pfeil.
  2. Klicken Sie in dem unverankerten Menü auf
    Tabelleneinstellungen
    .
  3. Geben Sie die Tabelleneinstellungen ein:
    • Datenimportmodus:
       Wählen Sie eine der folgenden Optionen aus der Dropdown-Liste.
      • Nach Ausführung eines Datenimports werden alle Datensätze ersetzt
        : Dies ist die Standardvorgabe. Ersetzt die Daten in der Staging-Tabelle durch Daten, die aus der Quelle importiert werden.
      • Remote-Cache zum Identifizieren und Senden von geänderten Datensätzen beim Import
        : Es werden nur Datenbankdatensätze importiert, die sich geändert haben oder neu sind. Geänderte Datensätze überschreiben vorhandene Datensätze im Staging-Bereich. Neue Datensätze werden am Ende der Informationen im Staging-Bereich hinzugefügt.
      • Alle Datensätze, die in einen Periodenbereich fallen, werden übermittelt
        : Alle Datensätze im von Ihnen angegebenen Periodenbereich werden importiert. Datensätze in der Staging-Tabelle, die mit den importierten Perioden übereinstimmen, werden gelöscht, bevor die neuesten Daten aus der Quelle importiert werden.
    • Datenimportfilter:
       Verwenden Sie diese Option, um einen SQL-Ausdruck einzugeben, der importierte Informationen filtert oder formatiert. Der SQL-Filter wird angewendet, bevor Daten aus der Datenbank extrahiert werden, um die zu importierende Datenmenge zu reduzieren. Sie erhalten auf diese Weise zusätzliche Kontrolle darüber, welche Daten in den Staging-Bereich übernommen werden. Klicken Sie auf das Feld, um das Dialogfeld
      SQL-Filter bearbeiten
       anzuzeigen. (Der Filter, den Sie hier eingeben, wird auf die tatsächlichen Daten in der Datenbank und nicht auf die Vorschaudaten im Staging-Bereich angewendet.) Nicht alle Datenquellen unterstützen das gleiche Maß an SQL-Filterfunktionen.
  4. Klicken Sie auf
    Anwenden
    , um die Einstellungen zu übernehmen.
  5. Wiederholen Sie die Schritte 1 bis 3 für jede Tabelle.
    Wenn für eine Datenbanktabelle Schlüssel definiert wurden, werden diese Informationen auch in die Staging-Tabelle übernommen. Sie können diese Informationen prüfen und bei Bedarf ändern.
  6. Klicken Sie auf
    Speichern
    , um die Einstellungen in der Datenquelle zu speichern.

Spaltenoptionen festlegen

Im Abschnitt
Zu importierende Tabellen
 können Sie eine Vorschau der Daten anzeigen, wie sie in der Datenquelle enthalten sind oder wie sie nach dem Import im Staging-Bereich vorhanden sind. Sie können die Optionen für jede Spalte ändern, indem Sie den Cursor über die Überschrift bewegen und dann auf das Dropdown-Menü neben dem Namen klicken. Folgende Optionen sind verfügbar:
  • Aufsteigend sortieren
    : Sortiert die gesamte Tabelle basierend auf dieser Spalte in aufsteigender Reihenfolge.
  • Absteigend sortieren
    : Sortiert die gesamte Tabelle basierend auf dieser Spalte in absteigender Reihenfolge.
  • Spalteneinstellungen
    : In diesem Dialogfeld können Sie die Eigenschaften der Spalte in der Staging-Tabelle ändern.
    • Name
      : Der Name der Spalte, der im Header angezeigt wird.
    • Spaltenart
      : Die Art der in der Spalte verwendeten Daten.
    • Spaltenart konvertieren
      : Wählen Sie die neue Art aus diesem Dropdown-Menü aus.
  • Spalte von Import ausschließen
    : Klicken Sie auf diese Option, um diese Spalte aus den zu importierenden Daten zu entfernen.
  • Spalte löschen
    : Klicken Sie auf diese Option, um die Spalte zu löschen. (Nur für benutzerdefinierte Spalten verfügbar.)

Daten aus einer Staging-Tabelle herunterladen

Sie können Daten aus einer einzelnen Staging-Tabelle herunterladen.
Führen Sie die folgenden Schritte aus, um Daten aus einer einzelnen Staging-Tabelle herunterzuladen:
  1. Klicken Sie im Abschnitt „Zu importierende Tabellen“ in einer Tabellenüberschrift auf den Pfeil nach unten.
  2. Klicken Sie auf
    Daten herunterladen
    .
  3. Wenn die Meldung
    Durch diesen Vorgang wird eine E-Mail mit einer URL zum Herunterladen der Daten gesendet
     angezeigt wird, klicken Sie auf
    Senden
    .
    Adaptive Planning
     Integration sendet eine E-Mail mit einer URL an das E-Mail-Konto, das dem Datendesigner zugeordnet ist.
  4. Öffnen Sie die E-Mail und klicken Sie auf die URL.
    Die Daten werden im CSV-Format heruntergeladen.

Erweiterten Filter verwenden

Unterhalb des Dropdown-Menüs
Quelle
 können Sie auf
Erweiterter Filter
 klicken, um Optionen für das Filtern der Daten im Vorschaubereich
Zu importierende Tabellen
 anzuzeigen. Der
erweiterte Filter
 bietet Tools zum Anzeigen und Durchsuchen einer Teilmenge der Daten in einer Staging-Tabelle oder direkt aus der Remote-Quelle (wenn Sie im Dropdown-Menü „Quelle“ die Option „JDBC-Datenbank“ auswählen). Durch Ändern der Filtereigenschaften können Sie die Ansicht der im Vorschaufenster angezeigten Daten ändern, ohne die Daten im Staging-Bereich zu ändern.
Der Vorschaubereich dient speziell der Vorschau eines kleinen Teils der Daten im Staging-Bereich (oder in der JDBC-Datenbank). Sie können die in der JDBC-Datenquelle verfügbaren Daten prüfen und anhand des Staging-Bereichs verifizieren, dass die erwarteten Daten abgerufen werden. Sie können damit auch den Datenimportfilter verfeinern, den Sie verwenden möchten. (Filter, die in der Vorschaufunktion festgelegt werden, haben keine Auswirkungen auf die tatsächlichen Daten im Staging-Bereich.)
Der
erweiterte Filter
 umfasst folgende Optionen:
  • Distinkte Zeilen
    : Aktivieren Sie dieses Kontrollkästchen, um doppelte Zeilen auszublenden.
  • Maximale Zeilenanzahl
    : Begrenzen Sie die Anzahl der Zeilen, die im Vorschaubereich angezeigt werden, indem Sie eine Zahl in das Textfeld eingeben.
  • Spalten
    : Aktivieren oder deaktivieren Sie die Kontrollkästchen der Spalten in diesem Dropdown-Menü, um die angezeigten Spalten ein- oder auszublenden.
    Wenn Sie eine Spalte in dieser Liste entfernen, wird die Spalte nicht aus der Importliste entfernt.
  • SQL-Filter
    : Klicken Sie in das große Textfeld, um das Dialogfeld
    SQL-Filter bearbeiten
     anzuzeigen. Hier können Sie einen SQL-Filter eingeben, um die Zeilen einzuschränken, die in der Vorschau angezeigt werden. Klicken Sie auf
    Anwenden
    , um die SQL-Syntax des Filters automatisch zu prüfen. (Falls Fehler auftreten, werden diese im Ausdruck angegeben.) Der von Ihnen eingegebene Ausdruck wird im Feld
    Erweiterter Filter
     angezeigt. Um detaillierte Hilfe zur SQL-Syntax zu erhalten, klicken Sie auf „Online-Hilfe“ im Abschnitt
    Hinweise
     .
Klicken Sie auf
Filter entfernen
 (neben dem Dropdown-Menü „Quelle“), um alle Einstellungen des erweiterten Filters zu löschen.
Im Rahmen der Tabellenanpassung können Sie auch Join-Tabellen und benutzerdefinierte Spalten mit SQL-Ausdrücken erstellen.

Daten aus einer JDBC-Datenbank importieren

Wenn Sie Ihre JDBC-Datenquelle eingerichtet und gespeichert haben, können Sie Daten importieren.
Führen Sie folgende Schritte aus, um Daten aus einer JDBC-Datenbank zu importieren:
  1. Klicken Sie im Menü
    Aktionen
     auf
    Daten importieren
    .
    Die ausgewählten Daten werden nach den SQL-Ausdrücken gefiltert und in den Staging-Bereich geladen. Sie können eine Vorschau der Daten im Staging-Bereich anzeigen.
Informationen verbleiben im Staging-Bereich, bis Sie sie manuell löschen oder bis sie durch ein nachfolgendes Laden von Daten entsprechend dem Importmodus gelöscht werden.
Führen Sie folgende Schritte aus, um Daten aus dem Staging-Bereich zu löschen:
  1. Klicken Sie im Menü
    Aktionen
     auf
    Staging-Tabellen löschen
    . Der Staging-Bereich wird für alle Tabellen in der Datenquelle gelöscht.
So entfernen Sie bestimmte Zeichen aus Eingabetextströmen in JDBC-Datenquellen:

Ordnen Sie eine JDBC-Datenquelle einem anderen Adaptive Planning-Datenagenten zu

Sie können ändern, welchen Adaptive Planning-Datenagenten Sie Ihrer JDBC-Datenquelle zuordnen.
  1. Vergewissern Sie sich, dass der Datenagent, mit dem Sie eine Verbindung herstellen möchten, unter
    Datenagenten
    der Komponentenbibliothek
    aufgeführt ist.
  2. Navigieren Sie unter „Integrationsdesign“ zur JDBC-Datenquelle.
  3. Wählen Sie den Datenagenten im Feld
    Zugeordneter Agent
     im Abschnitt
    Einstellungen
     aus.

Für JDBC-Datenquellen ausgeschlossene Schemas

JDBC-Datenquellen, die eine Verbindung zu Oracle oder MS SQL Server herstellen, schließen explizit einige Schemas aus, die sich nicht auf Finanzdaten beziehen.

Für Oracle JDBC-Datenquellen ausgeschlossene Schemas

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Für MS SQL Server-JDBC-Datenquellen ausgeschlossene Schemas

INFORMATION_SCHEMA, SYS

Tipps zur Fehlerbehebung

Es können Probleme mit Datenquellen auftreten, für die es Lösungen gibt, die nicht sofort ersichtlich sind.
Wenn Sie die Struktur für eine Datenbank importieren und die Datenbank mehr als 1000 Tabellen umfasst, werden Sie in einer Fehlermeldung aufgefordert, die Tabellenliste zu filtern. Sie können diesen Fehler umgehen, indem Sie eine der folgenden Aktionen ausführen:
  • Bearbeiten der JDBC-Datenquelle und Eingeben eines Schemafilters.
  • Ändern der Berechtigungen für die Anmeldedaten, die Sie für den Zugriff auf den Server verwenden, sodass weniger Tabellen über diese Anmeldedaten zugänglich sind.
Wenn Sie die Struktur einer Oracle-Datenbank importieren, werden die folgenden Schemas nicht als Teil der Struktur importiert:
CTXSYS, MDSYS, SYSTEM, SYS,
und
XDB
. Dies sind Oracle-Systemschemas, die für Datenintegrationszwecke nicht erforderlich sind.
Wenn Sie die Struktur einer MS SQL-Datenbank importieren, werden die folgenden Schemas nicht als Teil der Struktur importiert: INFORMATION_SCHEMA und sys. Dies sind MS SQL-Systemschemas, die für Datenintegrationszwecke nicht erforderlich sind.