Einrichten der Datenaufnahme (Data Ingestion) für Ihre ServiceNow®-Daten¶

Archivierte Datensätze¶

The connector does not actively reflect the records archived in ServiceNow on the Snowflake side for the ingested tables. Assuming that you archive inactive records older than a certain date, the following apply:

• Any record archived before the connector ingested it (for example, before the initial load of the table) will not be present in the table on the Snowflake side at all.

• Jeder Datensatz, der archiviert wird, nachdem er bereits vom Konnektor aufgenommen wurde, verbleibt auf der Snowflake-Seite, ohne dass ein Hinweis auf eine Archivierungsaktion erfolgt.

• Jeder archivierte Datensatz, der für eine Tabelle wiederhergestellt wird, die sich bereits im Modus inkrementelle Aktualisierungen befindet, wird auf Snowflake-Seite nicht übernommen, es sei denn, dieser Datensatz wird anschließend ebenfalls geändert (wobei der Wert sys_updated_on auf die aktuelle Zeit aktualisiert wird).

• An archived record restored during the initial load of the table may be ingested on the Snowflake side depending on its ID in the sys_id column.

Wenn Sie die Tabelle mit einer aktiven Archivierungsregel auf den neuesten Stand bringen möchten, können Sie die gesamte Tabelle neu laden, aber jeder Datensatz, der nach dem Neuladen archiviert oder wiederhergestellt wird, unterliegt denselben oben genannten Prinzipien.

ServiceNow-Archivtabellen ar_[table_name] können für die Synchronisierung aktiviert werden. Die erste inkrementelle Aktualisierung, die auf das erstmalige Laden einer solchen Tabelle folgt, wird jedoch nach Datensätzen durchsucht, die nach dem Datum des erstmaligen Ladens der Archivtabelle erstellt/aktualisiert wurden. Da weder sys_updated_on noch sys_created_on geändert werden, wenn der Datensatz archiviert wird, fehlen Datensätze auf Snowflake-Seite, die nach dem erstmaligen Laden der Archivtabelle bis zu einem bestimmten Zeitpunkt archiviert wurden. Wenn Sie beispielsweise Datensätze archivieren, die älter als ein Jahr sind, wird jeder Datensatz, der ein Jahr nach dem erstmaligen Laden der Archivtabelle archiviert wurde, nicht in die Archivtabelle auf Snowflake-Seite aufgenommen. Die archivierten Datensätze, die durch eine Zerstörungsregel nach dem erstmaligen Laden einer Archivtabelle wiederhergestellt oder gelöscht wurden, werden auf Snowflake-Seite nie aus der Tabelle entfernt.

Modify data ingestion using Snowsight¶

Um die aufzunehmenden ServiceNow®-Tabellen oder den Synchronisierungszeitplan für die Tabellen zu ändern, gehen Sie wie folgt vor:

1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

2. Wählen Sie im Navigationsmenü die Option Catalog » Apps aus.

3. Suchen Sie nach der App Snowflake Connector for ServiceNow® und wählen Sie dann die Kachel für den Konnektor.

4. Wählen Sie auf der Seite für den Snowflake Connector for ServiceNow® die Option Data Sync aus.

5. Wählen Sie die Schaltfläche Edit tables aus, um in den Bearbeitungsmodus zu wechseln.

6. Ändern Sie die Tabellen, die Sie erfassen möchten:

   1. Suchen Sie nach der Tabelle, die Sie erfassen möchten.

   2. Aktivieren oder deaktivieren Sie neben der Tabelle, die Sie auswählen bzw. abwählen möchten, das Kontrollkästchen in der Spalte Status.

   3. Wählen Sie unter Sync Schedule aus, wie häufig Sie die Tabelle zwischen Snowflake und ServiceNow® synchronisieren möchten.

7. Wählen Sie Update data sync aus.

Enable or disable the table synchronization¶

Dieser Abschnitt beschreibt, wie Sie die Synchronisierung einer Tabelle in ServiceNow® aktivieren oder deaktivieren. Die Synchronisierung kann sowohl mit der Standardkonfiguration als auch mit der benutzerdefinierten Konfiguration aktiviert werden.

CALL ENABLE_TABLES(<tables_to_enable>);

CALL ENABLE_TABLES(['table1', 'table2', 'table3']);

CALL DISABLE_TABLES(<tables_to_disable>);

CALL DISABLE_TABLES(['table1', 'table2']);

Enable a single table by using column filtering¶

If you don’t need all columns from a ServiceNow® table in Snowflake, the connector can ignore them. For example, skip columns if a single row exceeds the maximum row size of 128 MB.

Um die Datenaufnahme von Tabellen mit bestimmten Spalten zu aktivieren, führen Sie den folgenden Befehl aus:

CALL ENABLE_TABLE('<table_to_enable>', <table_config>);

Wobei:

table_to_enable

Gibt einen ServiceNow®-Tabellennamen an.

table_config

Objekt mit include_columns- oder exclude_columns-Eigenschaften mit einer Liste von Spaltennamen. Wenn sys_id, sys_created_on und sys_updated_on vorhanden sind, sind sie immer enthalten. Sie müssen sie nicht dem included_columns-Array hinzufügen und können sie auch nicht mit excluded_columns ausschließen, da der Konnektor sie beim Datenaufnahmeprozess verwendet.

Zum Beispiel mit einer ServiceNow®-Tabelle namens u_table mit den Spalten sys_id, sys_updated_on, col_1 und col_2 und der Ausführung:

CALL ENABLE_TABLE('u_table', { 'include_columns': ['sys_id', 'sys_updated_on'] });

In diesem Fall werden nur die Spalten sys_id und sys_updated_on der angegebenen Tabelle aufgenommen. Wenn Sie aber Folgendes aufrufen:

CALL ENABLE_TABLE('u_table', { 'exclude_columns': ['col_1'] });

In diesem Fall werden sys_id, sys_updated_on und auch col_2 aufgenommen.

The connector validates the provided columns and rejects the enablement request if any of the columns are not available in ServiceNow®. ServiceNow® API supports only include mode. As a result the connector transforms provided column arrays into included columns list and sends them with each request to ServiceNow®. The URL with included columns could possibly be too long to be handled by ServiceNow®. The connector validates this limitation when the ENABLE_TABLE is invoked.

Die Konfiguration der Spalten für jede Tabelle finden Sie in der Spalte INCLUDED_COLUMNS in der Ansicht CONFIGURED_TABLES. Um die Liste der erfassten Spalten zu ändern, müssen Sie zunächst die entsprechende Tabelle deaktivieren. Wenn für eine Tabelle die Spaltenfilterung konfiguriert ist, können Sie die Tabelle nur mit der Prozedur ENABLE_TABLE aktivieren. Sie können die Funktion ENABLE_TABLES nicht verwenden, die eine Liste von Tabellen als Argument akzeptiert.

Vereinfachte Ansichten enthalten nur die Spalten, die bei Aktivierung der Tabelle angegeben wurden. Sie werden jedes Mal aktualisiert, wenn sich die Liste der enthaltenen Spalten ändert. Wenn die Spaltenfilterung nicht konfiguriert ist, enthalten die Ansichten alle verfügbaren Spalten.

Enable a single table by using row filtering¶

Sie können die Datenerfassung für ausgewählte Zeilen aus einer ServiceNow®-Tabelle ausschließen, indem Sie eine Filterbedingung angeben. Zum Beispiel, um die Zeilen mit sensiblen Daten auszuschließen, die Sie nicht in Snowflake haben möchten, oder um die Zeilen mit unnötigen Daten auszuschließen, um Kosten zu sparen.

Führen Sie den folgenden Befehl aus, um das Erfassen von Tabellen mit einem bestimmten Zeilenfilter zu aktivieren:

CALL ENABLE_TABLE('<table_to_enable>', <table_config>);

Wobei:

table_to_enable

Gibt einen ServiceNow®-Tabellennamen an.

table_config

Objekt mit der Eigenschaft row_filter mit einem Filter-Ausdruck, der eine gültige Zeichenfolge ist.

Die derzeit unterstützten Operatoren für Filter sind:

Operator	Beschreibung	Beispiel
AND	Logischer Operator zur Verknüpfung von Bedingungen, die beide erfüllt sein müssen.	active = "true" AND impact = "2"
OR	Logischer Operator zur Verknüpfung von Bedingungen, von denen mindestens eine erfüllt sein muss. Wichtig Hat Vorrang vor dem Operator AND. Siehe die Beispiele unten.	tablename = "incident" OR tablename = "problem"
=	Gibt true zurück, wenn die Werte gleich sind.	priority = "1"
!=	Gibt true zurück, wenn die Werte nicht gleich sind.	state != "7"
LIKE	Gibt true zurück, wenn der Wert die angegebene Sequenz von Zeichen enthält. [1]	newvalue LIKE "privacy"
NOT LIKE	Gibt true zurück, wenn der Wert die angegebene Sequenz von Zeichen nicht enthält. [1]	description NOT LIKE "test"
STARTSWITH	Gibt true zurück, wenn der Wert mit der angegebenen Sequenz von Zeichen beginnt. [1]	description STARTSWITH "important"
ENDSWITH	Gibt true zurück, wenn der Wert mit der angegebenen Sequenz von Zeichen endet. [1]	description ENDSWITH "important"
IN	Gibt true zurück, wenn der Wert gleich einem der Werte der Liste ist. [2]	tablename IN ("incident", "task", "cmdb_ci")
NOT IN	Gibt true zurück, wenn der Wert nicht gleich einem der Werte der Liste ist. [2]	status NOT IN ("in progress", "on hold", "cancelled")

_[1] – Die Felder müssen vom Datentyp string sein.

_[2] – Die Auswahlfelder müssen Zeichenfolgen enthalten.

Regeln und Beschränkungen für den Filter-Ausdruck:

• zwei beliebige Filter-Ausdrücke müssen mit den Operatoren AND oder OR verbunden werden.

• Operatoren müssen durch Leerzeichen getrennt sein und in Großbuchstaben geschrieben werden.

• Wertausdrücke müssen in doppelte Anführungszeichen gesetzt werden.

• Bei Ausdrücken wird zwischen Groß- und Kleinschreibung unterschieden.

• Der Ausdruck kann nicht auf den Spalten sys_id, sys_updated_on oder sys_created_on operieren.

CALL ENABLE_TABLE('sys_audit', {
  'row_filter': 'tablename = "incident" AND fieldname = "cause" AND newvalue LIKE "privacy"'
});

CALL ENABLE_TABLE('incident', {
  'row_filter': 'active = "true" AND sys_created_by STARTSWITH "support" OR sys_created_by ENDSWITH "admin" AND category IN ("Network", "Cloud Management")'
});

CALL ENABLE_TABLE('incident', {
  'row_filter': 'incident_state IN ("1", "2", "3")', -- "New", "In Progress", "On Hold"
  'include_columns': ['incident_state', 'description']
});

Specify the synchronization schedule¶

Der Snowflake Connector for ServiceNow® synchronisiert Daten aus allen ServiceNow®-Tabellen mit Snowflake nach einem festgelegten Zeitplan. Standardmäßig werden alle Tabellen einmal pro Stunde (1 h) synchronisiert.

Um den Standard-Synchronisierungszeitplan für alle Tabellen zu ändern, rufen Sie die gespeicherte Prozedur CONFIGURE_DATA_INGESTION_SCHEDULE mit den folgenden Argumenten auf:

CALL CONFIGURE_DATA_INGESTION_SCHEDULE(<schedule>);

Wobei:

schedule

Gibt die Häufigkeit der Synchronisierung an. Sie können einen der folgenden JSON-Werte angeben:

• { 'type': 'continuous' }, was einem Zeitplan für die Datenaufnahme nahezu in Echtzeit entspricht. Eine Tabelle mit diesem Synchronisierungszeitplan verwendet einen dedizierten Worker, um Daten aufzunehmen, und wird nicht auf die maximale Anzahl von Tabellen angerechnet, die parallel synchronisiert werden können. Weitere Informationen dazu finden Sie unter Skalieren des Konnektors. Sie können bis zu 20 Tabellen mit einem kontinuierlichen Zeitplan konfigurieren.

  Warnung

  Tabellen mit kontinuierlichem Zeitplan verursachen eine erhöhte Last für die ServiceNow®-Instanz. Außerdem führt dies dazu, dass das Konnektor-Warehouse ständig genutzt wird, was den Verbrauch von Warehouse-Credits erhöht. Snowflake empfiehlt die Verwendung kontinuierlicher Zeitpläne mit Bedacht und nur für Tabellen, die Daten nahezu in Echtzeit in Snowflake erfordern. Um das Überladen einer ServiceNow®-Instanz zu verhindern, implementiert der Konnektor einen Erkennungsmechanismus, der in der Lage ist, fehlerhafte Tabellen mit kontinuierlichem Zeitplan automatisch zu deaktivieren. Weitere Informationen dazu finden Sie unter Tabelle mit kontinuierlichem Zeitplan, durch den Konnektor deaktiviert.

• { 'type': 'interval', 'value': '<interval_value>' }, wobei interval_value einer der folgenden Zeichenfolgenwerte ist:

  • '30m'

  • '1h'

  • '3h'

  • '6h'

  • '12h'

  • '1d'

• { 'type': 'custom', 'value': { 'hour': <hour>, 'day_of_week': '<day_of_week>' } }, wobei hour die Stunde in der UTC-Zeitzone angibt, zu der die Datenaufnahme beginnen soll. day_of_week gibt den Wochentag an, an dem die Datenaufnahme ausgeführt werden soll. Es ist möglich, spezielle Ausdrücke für den Wochentag zu verwenden:

  • '*', um die Datenaufnahme täglich auszuführen.

  • '1-3', um die Datenaufnahme von Montag bis Mittwoch auszuführen.

  • '0,5,6', um die Datenaufnahme am Freitag, Samstag und Sonntag auszuführen.

  Folgende Werte können in dem Ausdruck für die day_of_week-Konfiguration verwendet werden:

  • '0' – Sonntag

  • '1' –Montag

  • '2' – Dienstag

  • '3' – Mittwoch

  • '4' – Donnerstag

  • '5' – Freitag

  • '6' – Samstag

  Andere nicht-zifferige Werte wie '5L', der den letzten Freitag eines Monats angibt, oder 'FRI-SUN', der den Bereich von Freitag bis Sonntag angibt, werden nicht unterstützt.

Es ist möglich, den Datenaufnahme-Zeitplan für eine bestimmten Tabelle zu konfigurieren, während diese aktiviert wird. Um eine einzelne Tabelle zu aktivieren und ihren Zeitplan für die Datenaufnahme festzulegen, rufen Sie die gespeicherte Prozedur ENABLE_TABLE mit den folgenden Argumenten auf:

CALL ENABLE_TABLE('<table_name>', <table_config>);

Wobei:

table_name

Gibt einen ServiceNow®-Tabellennamen an, der aktiviert werden soll.

table_config

Objekt mit der Eigenschaft schedule, die die Konfiguration der Tabellensynchronisierung angibt. Weitere Informationen dazu finden Sie unter schedule der gespeicherten Prozedur CONFIGURE_DATA_INGESTION_SCHEDULE.

Um zum Beispiel die Datenaufnahme der Tabelle table_1 zu aktivieren und die Daten alle 3 Stunden zu synchronisieren, rufen Sie die folgende gespeicherte Prozedur auf:

CALL ENABLE_TABLE('table_1', { 'schedule': { 'type': 'interval', 'value': '3h' } });

Der Konnektor ermöglicht es Ihnen auch, für jede Tabelle, die für die Synchronisierung aktiviert ist, einen anderen Zeitplan anzugeben. Um den Synchronisierungszeitplan für eine ausgewählte Gruppe von Tabellen zu ändern, rufen Sie die gespeicherte Prozedur CONFIGURE_TABLES_SCHEDULE mit den folgenden Argumenten auf:

CALL CONFIGURE_TABLES_SCHEDULE(<table_names>, <schedule>);

Wobei:

table_names

Gibt ein Array mit den Namen der Tabellen an, für die Sie den Synchronisierungszeitplan konfigurieren möchten.

schedule

Gibt die Häufigkeit der Synchronisierung an. Weitere Informationen dazu finden Sie unter schedule der gespeicherten Prozedur CONFIGURE_DATA_INGESTION_SCHEDULE.

Um beispielsweise die Tabellen table_1 und table_2 jeden Samstag und Sonntag um 23:00 Uhr PM aufzunehmen, rufen Sie die folgende gespeicherte Prozedur auf:

CALL CONFIGURE_TABLES_SCHEDULE(['table_1', 'table_2'], { 'type': 'custom', 'value': { 'hour': 23, 'day_of_week': '0,6' } });

Standardmäßig versucht der Konnektor, die Datenaufnahme in einem Zeitfenster von 3 Stunden ab der geplanten Startzeit zu beginnen. Wenn es nicht möglich ist, die Datenaufnahme innerhalb dieses Zeitfensters zu starten, weil der Konnektor z. B. gerade andere Tabellen erfasst, wird der aktuell geplante Lauf nicht ausgeführt. Der Konnektor versucht, die Datenerfassung im nächsten geplanten Zeitfenster auszuführen. Sie können die Dauer des Zeitrahmens ändern, indem Sie die gespeicherte Prozedur CONFIGURE_CUSTOM_SCHEDULE_START_INGESTION_WINDOW aufrufen:

CALL CONFIGURE_CUSTOM_SCHEDULE_START_INGESTION_WINDOW(<window_length>);

wobei window_length die Fensterlänge im Format ISO 8601 für die Zeitdauer angibt. Die Dauer muss auf die nächste ganze Stunde aufgerundet werden und mindestens 1 Stunde betragen. Der Wert 'PT12H' gibt zum Beispiel ein Zeitfenster an, das 12 Stunden dauert, und 'P2D' gibt ein Zeitfenster an, das 2 Tage dauert.

Wenn Sie nur Tabellen mit kundenspezifischen Zeitplänen aktivieren, wirkt sich diese Konfiguration nur auf die Zeit aus, die für das Erstellen und Aktualisieren von vereinfachten (flatten) Ansichten der konfigurierten Tabellen benötigt wird. Die vereinfachten Ansichten werden im ersten Erfassungszyklus erstellt, wenn die folgenden Bedingungen erfüllt sind:

• Die Erfassung der Metadaten-Tabellen ist abgeschlossen.

• Die Datenaufnahme der konfigurierten Tabelle hat begonnen.

Wenn E-Mail-Alerts aktiviert sind, empfiehlt Snowflake, bei Verwendung der kundenspezifischen Zeitplanung die Häufigkeit der Alerts auf Once per day zu ändern.

Specify whether deletions should be synchronized¶

Sie können angeben, ob der Konnektor Löschungen von ServiceNow® mit Snowflake synchronisieren soll. Standardmäßig synchronisiert der Konnektor Löschungen, wenn eine Journaltabelle konfiguriert ist. Es kann jedoch sein, dass Sie die Löschsynchronisierung einer bestimmten Tabelle deaktivieren und die globale Konfiguration nicht ändern möchten.

Um die Erfassung von Tabellen mit der angegebenen Einstellung für die Löschsynchronisierung zu aktivieren, führen Sie den folgenden Befehl aus:

CALL ENABLE_TABLE('<table_to_enable>', <table_config>);

Wobei:

table_to_enable

Gibt einen ServiceNow®-Tabellennamen an.

table_config

Objekt mit der booleschen Eigenschaft sync_deletions. Wenn der Wert auf true gesetzt ist, synchronisiert der Konnektor Löschungen für die Tabelle; wenn der Wert auf false gesetzt ist, synchronisiert er keine Löschungen für die Tabelle.

Um zum Beispiel die Erfassung der Tabelle incident zu aktivieren, aber die Löschungen nicht zu synchronisieren, führen Sie den folgenden Befehl aus:

CALL ENABLE_TABLE('incident', { 'sync_deletions': false });

Specify whether display values should be fetched¶

Der Konnektor kann Anzeigewerte für alle unterstützten Arten von Feldern in ServiceNow® abrufen. Anzeigewerte sind lesbare Werte, die den tatsächlich in der Datenbank gespeicherten Werten entsprechen. Ein Feld mit einem Wert von 1 könnte beispielsweise den Anzeigewert High haben. Weitere Informationen zu den Anzeigewerten siehe die ServiceNow®-Dokumentation.

Der aufgelöste Wert wird in einer vereinfachten Ansicht in einer separaten Spalte mit dem Suffix __DISPLAY_VALUE angezeigt. Der Konnektor erstellt Text- und boolesche Spalten mit den Snowflake-Typen, aber für andere Typen, z. B. verschiedene mögliche Formate von Zahlen- oder Datumswerten, werden die Anzeigewerte als Varianten gespeichert.

CALL ENABLE_TABLE('<table_to_enable>', <table_config>);

CALL ENABLE_TABLE('incident', { 'fetch_display_values': true });

CALL CONFIGURE_DISPLAY_VALUE_FETCHING(<fetch_display_values>);

CALL CONFIGURE_DISPLAY_VALUE_FETCHING(true);

Specify the data range start time¶

Standardmäßig synchronisiert der Snowflake Connector for ServiceNow® alle Datensätze in den entsprechenden ServiceNow®-Tabellen. Bei Tabellen, die über eine Spalte sys_updated_on oder sys_created_on (im Folgenden Zeitspalten genannt) verfügen, kann der Bereich der synchronisierten Daten eingeschränkt werden, indem eine Startzeit des Datenbereichs festgelegt wird, d. h. es wird eine untere Grenze für den entsprechenden Wert der Zeitspalte der Datensätze festgelegt.

With such a configuration, records with the corresponding time column value older than the data range start timestamp are not ingested. The corresponding time column used by this procedure is determined in the same way as for the incremental updates .

Um den Wert für die Startzeit des Datenbereichs zu ändern, rufen Sie die gespeicherte Prozedur CONFIGURE_TABLES_RANGE_START mit den folgenden Argumenten auf:

CALL CONFIGURE_TABLES_RANGE_START(<table_names>, <range_start>);

Copy

Wobei:

table_names

Gibt ein Array mit den Namen der Tabellen an, für die Sie die Startzeit des Datenbereichs konfigurieren möchten.

range_start

Zeitstempel mit Angabe der Startzeit des Datenbereichs im Format TIMESTAMP_TZ oder mit NULL, um den aktuellen Wert zu löschen.

• Wenn die Datenaufnahme der Tabelle noch nicht begonnen wurde, wird der Wert für die Startzeit des Datenbereichs bei der erstmaligen Datenaufnahme berücksichtigt.

• Wenn die Datenaufnahme der Tabelle bereits begonnen hat (z. B. wenn ein Neuladen im Gange ist), wird die Startzeit des Datenbereichs ignoriert. Dann ist ein (weiteres) Neuladen der Tabelle(n) erforderlich, um die Datensätze, deren entsprechende Zeitspaltenwerte zu alt sind, herauszufiltern.

Es wird daher empfohlen, die Startzeit des Datenbereichs vor der erstmaligen Datenaufnahme einer Tabelle (also auch vor der Aktivierung) festzulegen.

Wenn zum Beispiel die Tabellen table1 und table2 die erforderlichen Zeitspalten haben, führen Sie den folgenden Befehl aus, um die Startzeit des Datenbereichs für diese beiden Tabellen auf „2022-11-23 07:00:00 UTC“ festzulegen:

CALL CONFIGURE_TABLES_RANGE_START(['table1', 'table2'], TO_TIMESTAMP_TZ('2022-11-23 07:00:00 +00:00'));

Copy

Dann gilt Folgendes:

• for table table1, for example, if its ingestion has not started yet, all records with a corresponding time column value before 2022-11-23 07:00:00 are not ingested.

• for table table2, for example, if its ingestion has already started, the data range time start value is ignored in all data synchronizations until reloading this table. During the reload, all records with a corresponding time column value before 2022-11-23 07:00:00 are not ingested.

Es ist auch möglich, die Startzeit des Datenbereichs zu deaktivieren. Um beispielsweise die Startzeit für Tabelle table1 zu deaktivieren, führen Sie den folgenden Befehl aus:

CALL CONFIGURE_TABLES_RANGE_START(['table1'], NULL);

Copy

Wenn also bereits eine Datenaufnahme der Tabelle table1 begonnen wurde, ist ein Neuladen dieser Tabelle erforderlich, um die Datenaufnahme aller Datensätze aus ServiceNow® zurückzunehmen.

Full reload¶

Um Daten erneut in eine bestimmte Tabelle zu laden, rufen Sie die gespeicherte Prozedur RELOAD_TABLE auf:

CALL RELOAD_TABLE('<table_name>');

Wobei:

table_name

Gibt den Namen der Tabelle an, in die die Daten erneut geladen werde sollen.

Wenn Sie die gespeicherte Prozedur RELOAD_TABLE aufrufen, führt der Konnektor Folgendes aus:

1. Der Konnektor hält die ursprüngliche Tabelle vorübergehend für die Erfassung an.

   Bemerkung

   Während die Tabelle neu geladen wird, können Sie die Tabelle nicht wieder für die Erfassung aktivieren.

2. Der Konnektor erstellt eine separate temporäre Tabelle für die Erfassung.

3. Der Konnektor nimmt die Daten in diese neue temporäre Tabelle auf. Diese Tabelle wird in der Ansicht CONNECTOR_STATS als eine Tabelle mit dem Suffix __tmp angezeigt.

4. Nach dem Erfassen der Daten ersetzt der Konnektor die Daten in der Originaltabelle durch die Daten in der temporären Tabelle.

5. Der Konnektor löscht die temporäre Tabelle.

6. Der Konnektor aktiviert die ursprüngliche Tabelle wieder für die Erfassung.

Während dieses Prozesses können Sie weiterhin die vorhandenen Daten in der Originaltabelle abfragen. Änderungen an den Daten in der ServiceNow®-Tabelle werden jedoch erst dann in der Snowflake-Tabelle berücksichtigt, wenn der Datenaufnahmeprozess abgeschlossen ist.

Gefiltertes Neuladen¶

Um nur einen Teil der Daten in einer bestimmten Tabelle neu zu laden, rufen Sie die gespeicherte Prozedur RELOAD_TABLE mit einem Konfigurationsobjektparameter auf:

CALL RELOAD_TABLE('<table_name>', <config>);

Wobei:

table_name

Gibt den Namen der Tabelle an, in die die Daten erneut geladen werde sollen.

config

Gibt die Konfiguration für das Neuladen an. Das Konfigurationsobjekt kann die folgenden Eigenschaften enthalten:

• sys_ids: Ein Array von ServiceNow®-Datensatzbezeichnern (sys_id), die neu geladen werden sollen.

• data_reload_range_start_time und data_reload_range_end_time: Zeitstempelwerte, die den Datenbereich im Format TIMESTAMP_TZ angeben Abhängig vom angegebenen Tabellenaufnahmetyp werden nur Datensätze mit sys_updated_on oder sys_created_on innerhalb des angegebenen Zeitrahmens neu geladen.

• conditions: Ein Zeichenfolgenausdruck, der die Bedingungen für die Felder in einer ServiceNow®-Tabelle angibt. Nur die Datensätze, die die Bedingungen erfüllen, werden neu geladen.

  Die Syntax des Ausdrucks ist identisch mit der für die Zeilenfilterung. Wenn das Filtern von Zeilen in der regulären Tabelle konfiguriert ist, wird es auch auf die Bedingungen angewendet.

Im Gegensatz zum vollständigen Neuladen werden beim gefilterten Neuladen nicht die Daten in der ursprünglichen Tabelle ersetzt, sondern nur die ausgewählten Datensätze geändert.

Um beispielsweise nur Datensätze mit den sys_id-Werten 1, 2 und 3 in der Tabelle incident neu zu laden, führen Sie den folgenden Befehl aus:

CALL RELOAD_TABLE('incident', { 'sys_ids': ['1', '2', '3'] });

Um nur Datensätze mit sys_updated_on-Werten zwischen 2022-11-23 07:00:00 und 2022-11-23 08:00:00 UTC zu laden, die noch in der Tabelle incident aktiv sind, führen Sie den folgenden Befehl aus:

CALL RELOAD_TABLE('incident', {
  'data_reload_range_start_time': TO_TIMESTAMP_TZ('2022-11-23 07:00:00 +00:00'),
  'data_reload_range_end_time': TO_TIMESTAMP_TZ('2022-11-23 08:00:00 +00:00'),
  'conditions': 'active = "true"'
});

Cancel table reload¶

Um den Prozess des Neuladens der Daten in eine Tabelle abzubrechen, verwenden Sie die gespeicherte Prozedur CANCEL_RELOAD_TABLE, wie im folgenden Beispiel gezeigt:

CALL CANCEL_RELOAD_TABLE('<table_name>');

Wobei:

table_name

Gibt den Namen der Tabelle an, deren Neuladen Sie abbrechen möchten.

Wenn Sie das Neuladen abbrechen, löscht der Konnektor alle temporären Objekte, die während des Neuladens bisher erstellt wurden. Die Tabelle steht dann im Rahmen des normalen Synchronisierungzeitplans für die Erfassung zur Verfügung.