Datenquelle vom Typ „Anwenderdefiniert“ (nach Skript laden).

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Verwenden Sie ein anwenderdefiniertes Skript, um eingehende Daten in der Importsatztabelle zu speichern.

    Wenn Sie für Ihre Datenquelle den TypAnwenderdefiniert (Nach Skript laden) auswählen, wird das Feld Datenlader angezeigt. Das Feld „Datenlader“ ist ein JavaScript-Feld, in dem Sie ein Skript eingeben können, um Daten abzurufen und mithilfe des Eingabeparameters import_set_table in die Importsatztabelle einzufügen. Sie können beispielsweise ein Skript eingeben, um Daten aus einer REST API oder einem Dateianhang abzurufen.

    Das Datenlader -Skript lädt die Daten. Sie können auch paralleles Laden aktivieren, um ein Skript zu verwenden, das die Daten in kleinere Abschnitte partitioniert und parallel lädt. Durch das parallele Laden können Ihre Integrationen in kürzerer Zeit abgeschlossen werden und haben weniger Auswirkungen auf andere Aufgaben.
    Hinweis:
    Beim parallelen Laden muss ein gleichzeitiger Import ausgeführt werden, und die Partitionsmethode für den Import muss auf Anwenderdefinierte Größefestgelegt sein. Weitere Informationen finden Sie unter Datenimport planen.

    Datenlader-Skript

    Das Datenladerskript weist die folgenden Eingabeparameter auf.
    • import_set_table: Die Importsatztabelle, auf die im Datenquellen-Datensatz verwiesen wird. Die Daten werden in diese Tabelle eingefügt.
    • data_source: Die Datenquelle, auf die im Datenquellen-Datensatz verwiesen wird.
    • import_log: Das Protokoll, das Informationen zur Datenimportaktivität aufzeichnet.
    • last_success_import_time: Zeitpunkt der letzten erfolgreichen Ausführung dieser Datenquelle.
    • partition_info: Die Partitionierungsinformationen für die Daten. Wird für paralleles Laden verwendet.
    Der Parameter „import_set_table“ weist die folgenden Methoden auf:
    • addColumn(label, maxLength): Fügt der Importsatztabelle eine Spalte vom Typ „Zeichenfolge“ hinzu.
    • addJSONColumn(label, maxLength): Fügt der Importsatztabelle eine Spalte vom Typ JSON hinzu.
    • addXMLColumn(label, maxLength): Fügt der Importsatztabelle eine XML-Spalte hinzu.
    • insert(rowData): Fügt eine Zuordnung (Schlüssel = Spaltenname, Wert = Spaltenwert) in die Importsatztabelle ein.
    • getMaximumRows(): Gibt 20 zurück, wenn Sie 20 Datensätze testenauswählen. Andernfalls wird -1zurückgegeben.

    Datenlader-Beispiel

    Beispiel für das Datenlader-Skript, das Daten in die Importsatztabelle einfügt.

    Skript für paralleles Laden

    Das Skript für paralleles Laden weist die folgenden Eingabeparameter auf.
    • parallel_job_loader: Die Tabelle für parallele Aufträge [sys_parallel_job].
    • data_source: Die Datenquelle, auf die im Datenquellen-Datensatz verwiesen wird.
    • import_log: Das Protokoll, das Informationen zur Datenimportaktivität aufzeichnet.

    Der Parameter „parallel_job_loader“ verfügt über die Methode „add(partitionInfo)“, welche die Partitionsinformationen der Tabelle „Parallele Aufträge“ [sys_parallel_job] hinzufügt.

    Beispiel für paralleles Laden

    Skriptbeispiel für paralleles Laden.

    Eigenschaften und Status des parallelen Ladens

    Wenn ein Auftrag länger als 600 Minuten im Status „ Wird ausgeführt “ hängen bleibt, wird er automatisch wieder in den Status „ Ausstehend“ versetzt. Mit der Eigenschaft com.glide.system_parallel_job_inactive_time_minutes können Sie ändern, wie lange ein paralleler Auftrag ausgeführt werden darf.

    Wenn ein paralleler Auftrag nach zwei Versuchen nicht abgeschlossen werden kann, wird der Auftrag auf Fehlerfestgelegt. Mit der Eigenschaft com.glide.system_parallel_job_max_retry_count können Sie die Anzahl der Versuche ändern, bevor ein Fehlerstatus auftritt. Die Eigenschaft com.glide.system_parallel_job_auto_retry kann auf „false“ festgelegt werden, um die automatische Wiederholung zu deaktivieren.

    Sie können den Status Ihrer aktuellen parallelen Importaufgaben überprüfen, indem Sie zu navigieren Alle > System-Importsätze > Erweitert > Gleichzeitige Importsätze, wählen Sie Ihren Job aus und zeigen Sie die Registerkarte Parallel Jobs an.

    Automatische Skriptvervollständigung

    Während Sie das Skript eingeben, zeigt die automatische Skriptvervollständigung die verfügbaren Optionen an (siehe folgendes Beispiel).

    Automatische Vervollständigung für Datenlader