Import Sets – Schlüsselkonzepte

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer
  • Erfahren Sie mehr über Import Sets, bevor Sie Daten in Ihre Instanz importieren.

    Die Import Set-Tabelle fungiert als Bereitstellungsbereich für Datensätze, die aus einer Datenquelle importiert wurden.

    Hinweis:
    Importieren Sie Daten nicht in sehr großen Blöcken. Das Erstellen eines sehr großen Importsatzes kann zu Verzögerungen und Systemausfällen führen.

    Eine Transformationszuordnung bestimmt die Beziehungen zwischen Feldern, die in einer Import Set-Tabelle angezeigt werden, und Feldern in einer vorhandenen ServiceNow -Tabelle, z. B. der Tabelle „Incidents“ oder „Benutzer“.

    Beim Importieren von Sets werden Datensätze übersprungen, wenn die Daten in der Instanz mit den zu importierenden Daten übereinstimmen.

    Hinweis:
    Import Sets werden als Benutzersystem ausgeführt und können daher keine Daten zu verschlüsselten Feldern hinzufügen.

    Import Sets Terminologie

    Tabelle : 1. Wichtige Begriffe
    Benennung Definition
    Import Set-Tabelle

    Eine Tabelle, die als Staging-Speicherort für Datensätze fungiert, die aus einer Datenquelle importiert werden, bevor diese Datensätze transformiert werden. Felder in diesen Tabellen werden automatisch basierend auf importierten Daten generiert und sollten nicht manuell geändert werden.

    Hinweis:
    Spalten in einer Import Set-Tabelle werden automatisch generiert und sollten nicht manuell hinzugefügt werden. Das manuelle Hinzufügen von Spalten kann sich negativ auf die geplante Bereinigung der Tabelle auswirken und zu einer unvollständigen Bereinigung und verwaisten Datensätzen führen.

    Wenn Sie einer Import Set-Tabelle Spalten hinzufügen müssen, fügen Sie die Spalte zuerst den Eingabedaten hinzu, und wählen Sie dann Testladen von 20 Datensätzen oder Alle Datensätze laden aus, um die Spalten in der Import Set-Tabelle automatisch zu generieren.

    Spalten in einer Import Set-Tabelle haben möglicherweise nicht den gleichen Typ wie die Eingabedaten. Beispielsweise kann eine Währungsspalte als Zeichenfolgenspalte in einer Import Set-Tabelle dargestellt werden, bis sie einer Zieltabellenspalte vom Typ „Währung“ zugewiesen wird.

    Datenquelle Ein Datensatz, der definiert, wo die zu importierenden Daten abgerufen werden sollen. Eine Datenquelle kann auf eine Datei, eine JDBC-kompatible Datenbank oder eine LDAP-Organisationseinheit verweisen.
    Transformation Die Konvertierung von Daten aus einer Import Set-Tabelle in eine andere Tabelle gemäß den in einer Transformationszuordnung definierten Regeln.
    Transformationszuordnung Eine Reihe von Feldzuordnungen, die die Beziehungen zwischen Feldern in einem Importsatz und Feldern in einer Tabelle wie „Incident“ definieren.

    Während der Transformation werden Daten basierend auf der Transformationszuordnung aus der Importsatz-Tabelle in die Zieltabelle kopiert.

    Ein einzelnes Importsatz-Feld kann mehreren Feldern in anderen Tabellen zugeordnet werden.

    Robuster Umwandler für Import Set Extrahieren, transformieren und laden Sie Daten in eine oder mehrere Zieltabellen. Trennen Sie die Transformations- und Verarbeitungsfunktionen, um eine flexiblere Alternative zu Transformationszuordnungen zu bieten.
    Fremddatensatzeinfügung Eine fremde Datensatzeinfügung tritt auf, wenn ein Import eine Änderung an einer Tabelle vornimmt, die nicht die Zieltabelle für diesen Import ist.

    Diese Änderung erfolgt beim Aktualisieren eines Referenzfelds in einer Tabelle. Wenn Sie beispielsweise einen Wert für den Anrufer in einem Incident aktualisieren, aktualisiert der Import tatsächlich die Tabelle sys_user.

    Zusammenfügen Ermöglicht das Aktualisieren vorhandener Zieltabellendatensätze, wenn Importdaten transformiert werden.

    Sie können angeben, ob ein Zielfeld zum Zusammenfügen verwendet werden soll, wenn Import Set-Datensätze transformiert werden. Wenn die Option Zusammenfügen der Feldzuordnung ausgewählt ist und die Import Set-Zeile transformiert wird, sucht die Instanz nach einem vorhandenen Datensatz in der Zieltabelle, der im Feld Ziel denselben Wert aufweist wie das Quellfeldder Import Set-Zeile.

    Wenn ein vorhandener Datensatz mit einem übereinstimmenden Wert in der Zieltabelle gefunden wird, wird dieser Datensatz aktualisiert. Wenn kein übereinstimmender Datensatz gefunden wird, wird ein neuer Datensatz in der Zieltabelle erstellt.

    Unterstützte Importformate

    Sie können Daten aus verschiedenen Dateiformaten oder externen Datenquellen importieren.

    Tabelle : 2. Dateiformate
    Format Einschränkungen
    CSV CSV-Dateien müssen dem vorgeschlagenen CSV-Standard in RFC4180 entsprechen. Dies bedeutet insbesondere, dass keine doppelten Anführungszeichen in Feldern angezeigt werden dürfen. Die erste Datenzeile in einer importierten CSV-Datei wird zur Kopfzeile und definiert die Spalten für diesen Importsatz.
    Excel Excel-Dateien müssen die Erweiterung XLS oder XLSX aufweisen.
    XML XML-Dateien müssen einen konsistenten XPath für jede Datenzeile aufweisen.
    JSON
    • Für JSON -Arrays muss der Pfad für jede Zeile das Array-Stammelement zweimal angeben, z. B. /incidents/incidents.
    • JSON Dateien müssen RFC-4627 entsprechen. Zum Beispiel sollte ein einzelnes Komma einen Wert vom folgenden Namen trennen. Namen innerhalb eines Objekts müssen eindeutig sein.
    • Prädikate wie @element, [index]oder text()sowie Achsen wie untergeordnete Elemente, gleichgeordnete Elemente oder Vorfahren werden nicht unterstützt.
    Benutzerdefiniert (nach Skript analysieren) Sie können benutzerdefiniertes JavaScript schreiben, um Eingabezeilen in der Liste der Zuordnungen zu analysieren.

    Die Plattform ServiceNow® kann Daten aus den folgenden externen Datenquellen importieren.

    Tabelle : 3. Externe Datenquellen
    Datenquelle Einschränkungen
    JDBC JDBC-Importe erfordern eine gültige Transformationszuordnung. Einige Netzwerkkonfigurationen erfordern möglicherweise ServiceNow® MID-Server.
    LDAP LDAP-Importe erfordern eine gültige Transformationszuordnung.
    OIDC OIDC-Importe erfordern eine gültige Transformationszuordnung.
    ServiceNow® REST (IntegrationHub) REST-Importe erfordern eine gültige Transformationszuordnung.
    Benutzerdefiniert (nach Skript laden) Benutzerdefinierte Importe erfordern eine gültige Transformationszuordnung.

    Weitere Informationen zu den verschiedenen Datenquellen finden Sie unter Datenquellen.

    Transformationszuordnungen im Vergleich zu robusten Import Set-Umwandlern

    Sowohl Transformationszuordnungen als auch robuste Import Set-Transformatoren konvertieren Daten. Transformationszuordnungen konvertieren Daten aus der Staging-Tabelle in die Zieldatei. Robuste Umwandler für Import Sets konvertieren Daten aus einer Quelltabelle in einen Nachrichten-Listener. Wenn eine Datenquelle sowohl über eine Transformationszuordnung als auch über einen robusten Import Set-Umwandler verfügt, verwendet das System den robusten Import Set-Umwandler anstelle der Transformationszuordnung.

    Geplante Bereinigung des Importsatzes

    Die geplante Aufgabe Import Set Deleter bereinigt jeden Tag um Mitternacht alte Import Set-Daten.

    Standardmäßig löscht die Aufgabe alle Import Sets, die älter als 7 Tage sind, sowie die zugehörigen Tabellendatensätze für Import Set. Wenn diese regelmäßige Aufgabe in Ihrer Instanz nicht aktiv ist, aktivieren Sie sie, um die möglicherweise vorhandenen Import Set-Tabellen zu verringern, insbesondere bei Verwendung wiederkehrender Importe.
    Hinweis:
    Wenn die geplante Bereinigung auf Ihrem System derzeit nicht aktiv ist, müssen Sie sicherstellen, dass Ihre Import Set-Tabellen nicht zu groß sind (insgesamt > 5 Millionen Datensätze für alle Tabellen), bevor Sie diese Bereinigung aktivieren. Wenn die Tabellen zu groß sind, löschen Sie die Datensätze zuerst manuell, bevor Sie fortfahren. Wenden Sie sich an Kundenservice und Support, um die Löschung dieser Daten zu koordinieren.
    Abbildung : 1. Geplante Skriptausführung
    Importsatzlöscher.

    Hinweise zu Verfahren siehe Löschen Sie Import Sets.

    Import Set-Tabellenlöscher

    Sie können eine oder alle der folgenden Import Set-Tabellen manuell löschen:
    • Computer
    • Anwender
    • Benachrichtigung
    • Standort
    Sie können auch die zugehörigen Transformationszuordnungen löschen oder nur Daten löschen und die Tabellenstruktur beibehalten.
    Abbildung : 2. Zum Löschen verfügbare Tabellen
    Import Set-Tabellenlöscher.

    Hinweise zu Verfahren siehe Löschen Sie Import Set-Tabellen.