Eigenschaften für Importsätze

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Mehrere Eigenschaften steuern das Verhalten von Importsätzen.

    Eigenschaften für Importsätze

    glide.import_set.preserve.leading.spaces
    Gibt an, ob der Importprozess führende Leerzeichen in Excel-Datenzellen beibehält. Bei „false“ entfernt der Importprozess bruchsichere führende Leerzeichen aus Excel-Datenzellen. Bei „wahr“ behält der Importprozess bruchsichere führende Leerzeichen bei.
    Hinweis:
    Der Importvorgang entfernt immer nachfolgende Leerzeichen aus Excel-Datenzellen.
    glide.import_set_row.dynamically_add_fields
    Gibt an, ob ein Importsatz der Staging-Tabelle neue Spalten hinzufügen kann (true) oder nicht (false). Instanzen, die eine große Anzahl von Importsätzen enthalten, reagieren manchmal nicht mehr, wenn ein Import eine Spalte hinzufügt, da die Instanz jede Zeile in der Staging-Tabelle ändern muss. In einigen Fällen führt die Datenbankaktion „Tabelle ändern“ zu einem Ausfall. Wenn diese Eigenschaft auf „false“ gesetzt wird, wird verhindert, dass ein Import Set der Staging-Tabelle Spalten hinzufügt, und eine Protokollnachricht erstellt. Als Workaround können Administratoren der Staging-Tabelle manuell eine Spalte hinzufügen, indem sie einen neuen Dictionary-Eintrag erstellen und anschließend das Import Set erneut importieren.
    com.glide.loader.verify_target_field_size
    Aktiviert die dynamische Größenänderung von Importsatzfeldern. Mit der Standardeinstellung „ false“werden bis zu 20 Datensätze der Quelldaten erfasst, um die Länge des Importsatzfelds zu bestimmen. Wenn das Feld in allen als Stichproben erfassten Datensätzen leer ist, wird die Standardlänge 40 verwendet. Alle geladenen Daten, die die Feldlänge der Importsatztabelle überschreiten, werden abgeschnitten. Legen Sie diese Eigenschaft auf „wahr“ fest, damit in jedem Importsatzfeld die Spaltengröße um 100 erhöht werden kann, um sie an die Länge der Daten anzupassen. Wenn die eingehenden Quelldaten beispielsweise eine Länge von 60 haben, legt das System die Länge der Spalte auf 160 fest. Dies ist nur für die Datenquelle relevant.
    glide.ds.file.http.variable_replacement
    Aktiviert die Erweiterung der Systemeigenschaft für Datenquellen vom Typ „Datei“, die über HTTP oder HTTPS abgerufen werden.
    glide.schedule_import.stop_on_error
    Auf „true“ festlegen, um den Importvorgang zu stoppen, wenn der übergeordnete geplante Import einen Fehler generiert. Dieses Verhalten kann nützlich sein, wenn ein Importsatz von den Ergebnissen eines anderen Importsatzes abhängt.
    glide.impex.transformer.empty_value_nil
    Steuert, wie leere Zeichenfolgenwerte während der Transformation aus einer Importsatz-Bereitstellungstabelle behandelt werden. Legen Sie diese Eigenschaft auf „wahr“ fest, um leere Zeichenfolgen beizubehalten. Legen Sie diese Eigenschaft auf „false“ fest, um leere Zeichenfolgen in die Zeichenfolge NULLzu konvertieren.
    Hinweis:
    Eine leere Zeichenfolge wird unabhängig von diesem Eigenschaftswert immer als Nullwert in der Datenbank gespeichert.
    Sie können diese Eigenschaft verwenden, wenn Sie während der Transformation ein onBefore-Skript ausführen. Wenn Sie diese Eigenschaft auf „true“ setzen, können Sie mit den Funktionen hasValue() oder nil() nach Null-Werten suchen.
    com.glide.loader.max_scan_rows
    Steuert, wie viele Zeilen von Quelldaten abgetastet werden, um beim Importieren von Daten automatisch Bereitstellungstabellenfelder zu generieren. Diese Eigenschaft gilt für JDBC-, XLS-, CSV- und XML-Importe, jedoch nicht für JSON- und XSLX-Importe.

    Eigenschaften für gleichzeitige Importsätze

    glide.scheduled_import.max.concurrent.import_sets
    Maximale Anzahl von Importsätzen für einen gleichzeitigen Import.
    com.glide.concurrent_import_set_insert_mutex_spin_wait
    Wartezeit, die der Mutex ausgibt, wenn die Sperre erworben wird (in Millisekunden).
    com.glide.concurrent_import_set_insert_mutex_expiration
    Mutex-Ablaufzeit (in Millisekunden).
    com.glide.concurrent_import_set_mutex_fast_lock
    Gibt an, ob eine schnelle Sperre (wahr) oder eine SQL-basierte langsame Sperre (falsch) verwendet werden soll.

    Eigenschaften für Webdienst-Importsätze

    com.glide.ws_import_set.column_resize
    Bei „wahr“ wird die dynamische Größenänderung von Spalten in Importbereitstellungstabellen für Webdienst-Importsätze aktiviert.
    com.glide.ws_import_set.column_resize.max_row_count
    Die maximale Anzahl von Zeilen, die eine Importbereitstellungstabelle für die dynamische Größenänderung von Spalten mit Webdienst-Importsätzen haben kann.

    Importbereitstellungstabellen mit mehr als dieser Zeilenanzahl verwenden keine dynamische Größenänderung mit Webdienst-Importsätzen, auch wenn com.glide.ws_import_set.column_resize auf „wahr“ festgelegt ist.

    Diese Eigenschaft hat einen maximalen Wert von 500.000.

    CSV-Eigenschaften

    com.glide.csv.loader.ignore_non_parseable_lines
    Ermöglicht einer Instanz, eine oder mehrere Zeilen (Zeilen) zu ignorieren, die ungültige Daten in einem CSV-Import enthalten, z. B. eine Zeile, in der eine Datenspalte fehlt. Standardmäßig können Importe ungültige Daten in CSV-Dateien nicht ignorieren und schlagen beim ersten Fehler fehl.
    com.glide.csv.loader.max_errors_allowed
    Gibt die maximale Anzahl von Zeilen (Zeilen) an, die ein Import ignorieren kann, bevor er fehlschlägt. Wenn der Import erfolgreich ist, listet der Import die Anzahl der Zeilen auf, die der Import aufgrund von Fehlern ignoriert hat.
    glide.import.csv.zeichensatz
    Der Zeichensatz der zu importierenden CSV-Datei. Gültige Werte sind UTF-8 und WINDOWS-1252. Unter Umständen müssen Sie beim Importieren von Sonderzeichen die UTF-8-Formatierung verwenden.

    Excel-Importeigenschaften

    glide.excel.multiplier
    Die maximale Menge an Instanzarbeitsspeicher, die einem Excel-Import zugeteilt werden soll. Diese Eigenschaft gilt nur für den Import von XLS-Dateien.

    Der Wert dieser Eigenschaft wird mit der Dateigröße der Excel-Datei multipliziert, um die Gesamtspeicherzuteilung zu bestimmen. Der verwendete Arbeitsspeicher darf den durch die Eigenschaft glide.excel.max_memory_percent angegebenen Grenzwert nicht überschreiten.

    Mit dem Standardwert 8 und einer Excel-Datei mit 10 MB verwendet die Instanz beispielsweise bis zu 80 MB Arbeitsspeicher für den Import.

    glide.xlsx.multiplier
    Die maximale Menge an Instanzarbeitsspeicher, die einem Excel-Import zugeteilt werden soll. Diese Eigenschaft gilt nur für den Import von XLSX-Dateien.

    Der Wert dieser Eigenschaft wird mit der Dateigröße der Excel-Datei multipliziert, um die Gesamtspeicherzuteilung zu bestimmen. Der verwendete Arbeitsspeicher darf den durch die Eigenschaft glide.excel.max_memory_percent angegebenen Grenzwert nicht überschreiten.

    Mit dem Standardwert 10 und einer Excel-Datei mit 10 MB verwendet die Instanz beispielsweise bis zu 100 MB Arbeitsspeicher für den Import.

    Hinweis:
    Ändern Sie den Wert dieser Eigenschaft nicht. Der Standardwert wurde für optimale Leistung ausgewählt.
    glide.excel.max_memory_percent
    Die maximal zulässige Menge an Arbeitsspeicher für Excel-Importe als Prozentsatz des gesamten Instanzspeichers.
    glide.excel.use_disk_backed_strings_table
    Steuert, ob die Instanz Datenträgerspeicher verwendet, um große Dateidaten während des XLSX-Imports zu verwalten. Legen Sie diese Eigenschaft auf „falsch“ fest, um XLSX-Dateidaten nur im Arbeitsspeicher zu speichern. Wenn Sie diese Eigenschaft auf „false“ festlegen, wird der während des XLSX-Imports verwendete Arbeitsspeicher erhöht.
    glide.excel.in_memory_strings_table_size_mb
    Die maximale Menge an Arbeitsspeicher in Megabyte, die zum Speichern von XLSX-Dateidaten verfügbar ist, bevor auf den Datenträger geschrieben wird, wenn „glide.excel.use_disk_backed_strings_table“ auf „wahr“ festgelegt ist. Wenn Sie einen niedrigeren Wert für diese Eigenschaft festlegen, wird während des XLSX-Imports weniger Arbeitsspeicher benötigt, dies kann jedoch zu langsameren Importen führen.
    glide.xlsx.import.debug
    Aktiviert die Debug-Protokollierung für XLSX-Importe.
    glide.import.excel.enhanced_number_conversions
    Bei „wahr“ werden numerische Werte über 10 Millionen in Importbereitstellungstabellen beibehalten. Bei „false“ werden importierte Werte von mehr als 10 Millionen in eine wissenschaftliche Notation konvertiert, die möglicherweise nicht mit dem ursprünglichen importierten Wert übereinstimmt. Diese Eigenschaft sollte für den Import der meisten Arten von Daten auf „wahr“ festgelegt werden.
    glide.transform.boolean.casesensitive
    Bei „wahr“ werden die booleschen Werte in Großbuchstaben (WAHR/FALSCH) immer in „falsch“ umgewandelt. Bei „falsch“ werden boolesche Werte in Großbuchstaben (WAHR/FALSCH) korrekt umgewandelt.

    JDBC-Verbindungseigenschaften

    glide.jdbcprobeloader.retry
    Die Anzahl der Versuche eines JDBC-Probenladeprogramms, Daten zu verarbeiten, die von einer JDBC-Datenquelle zurückgegeben werden. Versetzt den in glide.jdbcprobeloader.retry_millis definierten Wert zwischen Wiederholungsversuchen in den Ruhezustand.
    glide.jdbcprobeloader.retry_millis
    Wie viele Millisekunden ein JDBC-Probenladeprogramm zwischen Wiederholungsversuchen für die Verarbeitung von Daten aus einer JDBC-Datenquelle wartet.

    Protokollierungs- und Debug-Eigenschaften

    com.glide.import_set.importlog_level
    Gibt an, wie viele Informationen Importsätze dem Protokoll hinzufügen. Mögliche Werte sind „INFO“, „WARNUNG“ und „FEHLER“. Sie können dies in der Entwicklungsumgebung auf INFO festlegen und in der Produktion in WARNUNG oder FEHLER ändern, um den Anteil des Protokollierungsrauschens an der Datenbank zu reduzieren.
    Hinweis:
    Diese Eigenschaft hat keine Auswirkungen auf die Protokollierung im Zusammenhang mit der Bereinigung von Bereitstellungstabellen.
    glide.import.debug
    Aktiviert die Debug-Protokollierung für alle Importprozesse.
    glide.importlog.log_to_table
    Gibt an, ob Protokollnachrichten auf Informationsebene in die Tabelle „import_log“ geschrieben werden sollen. Bei „wahr“ werden die Protokollnachrichten auf Informationsebene geschrieben.
    Hinweis:
    Die Protokolle auf Informationsebene für IntegrationHub ETL werden unabhängig von dieser Eigenschaftseinstellung in die Tabelle „importlog.log“ geschrieben. Um zusätzliche Ausnahmen hinzuzufügen, wenden Sie sich an Now Support.
    glide.import.sftp.debug
    Aktiviert zusätzliche Debug-Protokollierung für SFTP-Importe. Durch Aktivieren dieser Eigenschaft protokolliert die Instanz alle ausgehenden und eingehenden Nachrichten während der SSH-Sitzung.
    glide.import.scp.debug
    Aktiviert eine zusätzliche Debug-Protokollierung für SCP-Importe. Durch Aktivieren dieser Eigenschaft protokolliert die Instanz alle ausgehenden und eingehenden Nachrichten während der SSH-Sitzung.