Problembehandlung des Konnektors¶

Fehler bei der Authentifizierung¶

Es können Probleme auftreten, wenn eine Verbindung zu ServiceNow im Installationsassistenten herstellt oder die Prozedur SET_CONNECTION_CONFIGURATION manuell ausführt. Wenn bei diesem Schritt Fehler auftreten, stellen Sie bitte sicher, dass der Benutzer, der den Konnektor installiert hat, Zugriff auf die Tabelle sys_db_object hat.

Die Fehler-Statuscodes, die mit ACL in Zusammenhang stehen könnten, sind in dem von der Prozedur SET_CONNECTION_CONFIGURATION zurückgegebenen JSON-Objekt die folgenden:

• REQUEST_FAILED

Sie können die folgende Abfrage ähnlich der des Konnektors durchführen, um den Zugriff zu überprüfen. Solange die Anfrage nicht das erwartete Ergebnis liefert, ist es nicht möglich, den Konnektor zu installieren. So verwenden Sie zum Beispiel curl zum Senden der HTTP-Anfrage:

# checking access to the sys_db_object table
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_limit=1"

Wobei:

servicenow_instance

Gibt den Namen Ihrer ServiceNow®-Instanz an.

username und password

Geben Sie die Anmeldeinformationen für Ihre ServiceNow®-Instanz an.

Beispielhafte Antworten:

• Zumindest einige der Felder werden zurückgegeben – der Benutzer hat die erforderlichen Berechtigungen für den Zugriff auf die Tabelle.

• Die Antwort ist leer – der Benutzer hat die Berechtigung zum Zugriff auf die Tabelle, aber nicht auf den verarbeiteten Datensatz. Das könnte zu einem späteren Zeitpunkt Probleme verursachen.

• Die Antwort enthält einen Fehler – der Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Tabelle.

Fehler im Quellschritt validieren¶

Es können Probleme auftreten, wenn die Quelle im Installationsassistenten validiert oder die Prozedur FINALIZE_CONNECTOR_CONFIGURATION manuell ausführt. Wenn bei diesem Schritt Fehler auftreten, vergewissern Sie sich bitte, dass der Benutzer, der den Konnektor installiert hat, über die erforderlichen Berechtigungen für den Zugriff auf die Metadaten-Tabellen verfügt.

Die Fehler-Statuscodes, die mit ACL in Zusammenhang stehen könnten, sind in dem von der Prozedur FINALIZE_CONNECTOR_CONFIGURATION zurückgegebenen JSON-Objekt die folgenden:

• METADATA_TABLE_ACCESS_VALIDATION_ERROR

• JOURNAL_TABLE_ACCESS_VALIDATION_ERROR

Sie können die folgenden Abfragen ähnlich denen des Konnektors durchführen, um den Zugriff zu überprüfen. Solange die Anfragen nicht die erwarteten Ergebnisse liefern, ist es nicht möglich, den Konnektor zu installieren. So verwenden Sie zum Beispiel curl zum Senden der HTTP-Anfrage:

# checking access to the sys_db_object table
# expected fields in the result object: sys_id, super_class, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_fields=sys_id,super_class,name&sysparm_limit=1&sysparm_query=name=sys_db_object"

# checking access to the sys_dictionary table
# expected fields in the result object: sys_id, name, element, internal_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_fields=sys_id,name,element,internal_type&sysparm_limit=1&sysparm_query=name=sys_dictionary"

# checking access to the sys_glide_object table
# expected fields in the result object: sys_id, name, scalar_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_glide_object?sysparm_fields=sys_id,name,scalar_type&sysparm_limit=1&sysparm_query=name=datetime"

# checking access to the sys_table_rotation table
# expected fields in the result object: sys_id, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_table_rotation?sysparm_fields=sys_id,name&sysparm_limit=1&sysparm_query=name=syslog"

# (optional) - check only if deletions auditing is going to be used
# checking access to the journal table
# if known, "&sysparm_query=tablename=<table_name>" or "&sysparm_query=documentkey=<sys_id>" can be appended to the request
# expected fields in the result object: sys_id, sys_created_on, documentkey, tablename
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/<journal_table>?sysparm_fields=sys_id,sys_created_on,documentkey,tablename&sysparm_limit=1"

Wobei:

servicenow_instance

Gibt den Namen Ihrer ServiceNow®-Instanz an.

username und password

Geben Sie die Anmeldeinformationen für Ihre ServiceNow®-Instanz an.

journal_table

Gibt den Namen Ihrer ServiceNow®-Tabelle an, die für die Löschungsprüfung verwendet wird. Normalerweise hat dies den Wert sys_audit_delete.

Beispielhafte Antworten:

• Alle erwarteten Felder sind in der Antwort vorhanden – der Benutzer hat die erforderlichen Berechtigungen.

• Einige der erwarteten Felder fehlen – der Benutzer verfügt nicht über die erforderlichen Berechtigungen für alle Spalten.

• Die Antwort ist leer – der Benutzer verfügt nicht über die erforderlichen Berechtigungen für alle Zeilen.

• Die Antwort enthält einen Fehler – der Benutzer verfügt nicht über die erforderlichen Berechtigungen für die Tabelle.

Abrufen von Daten zur Problembehandlung¶

Um Daten zur Problembehandlung zu erhalten, rufen Sie die gespeicherte Prozedur GET_TROUBLESHOOTING_DATA auf:

CALL GET_TROUBLESHOOTING_DATA(<from_timestamp>, <to_timestamp>);

Wobei:

from_timestamp

Gibt den Beginn des Datumsbereichs (in der Zeitzone UTC) an, für den Daten abgerufen werden sollen.

to_timestamp

Gibt das Ende des Datumsbereichs (in der Zeitzone UTC) an, für den Daten abgerufen werden sollen.

Diese gespeicherte Prozedur gibt die folgenden Daten im Tabellenformat zurück:

• Informationen zur Konfiguration

• Fehler, die vom Konnektor erkannt werden

• Erfassungsverlauf

Das folgende Beispiel zeigt, wie Sie diese gespeicherte Prozedur aufrufen:

CALL GET_TROUBLESHOOTING_DATA('2024-02-05 10:00:00', '2024-02-10 22:30:00');

Sie können die zurückgegebenen Daten im CSV-Format speichern und an den Snowflake-Support senden.

Wiederherstellen des Konnektor-Warehouses¶

Wenn der Konnektor den Zugriff auf sein Warehouse verliert, konfigurieren Sie ein neues, indem Sie die gespeicherte Prozedur UPDATE_WAREHOUSE aufrufen.

Wiederherstellen von Datenbank und Schema für die ServiceNow®-Daten¶

Wenn die Datenbank oder das Schema der ServiceNow®-Daten gelöscht wird, kann das Wiederherstellen nur durch Ausführen des Befehls UNDROP erfolgen. Wenn dieser Befehl nicht verfügbar ist, müssen Sie den Konnektor neu installieren und die ServiceNow®-Daten erneut aufnehmen.

Wenn eine Ansicht, die ServiceNow®-Daten enthält, gelöscht wird, sollte sie automatisch neu erstellt werden, wenn die für ihre Erstellung zuständige Hintergrundaufgabe das nächste Mal ausgeführt wird.

Wenn eine der Tabellen, die die ServiceNow®-Daten enthalten (entweder die Ereignisprotokolltabelle oder die Rohdatentabelle), gelöscht wird, und Sie diese nicht mit dem Befehl UNDROP TABLE wiederherstellen können, können Sie Folgendes tun, um die Datenaufnahme der ServiceNow®-Tabelle erneut zu starten:

• Stellen Sie sicher, dass sowohl die Ereignisprotokoll- als auch die Rohdatentabelle für diese ServiceNow®-Tabelle gelöscht wurden.

• Deaktivieren Sie die ServiceNow®-Tabelle.

• Rufen Sie die DELETE_TABLE-Prozedur auf.

• Aktivieren Sie die ServiceNow®-Tabelle.

Wiederherstellen der Benachrichtigungsintegration für den Konnektor¶

Wenn der Konnektor den Zugriff auf das Benachrichtigungsintegrationsobjekt verliert, führen Sie die Verfahren zur Konfiguration von Alerts erneut durch und erstellen Sie das Benachrichtigungsintegrationsobjekt gegebenenfalls neu.

Wenn E-Mail-Benachrichtigungen über Snowsight konfiguriert sind, können Sie diese einfach deaktivieren und wieder aktivieren, um die erforderlichen externen Objekte wiederherzustellen.

Prüfen, ob Spaltenmetadaten in Snowflake vorhanden sind¶

Um zu überprüfen, ob Spaltenmetadaten in der Tabelle sys_dictionary auf Snowflake vorhanden sind, führen Sie die folgende Abfrage aus:

SELECT * FROM <dest_db>.<dest_schema>.sys_dictionary__view WHERE name = '<table_name>' AND element = '<column_name>';

Wenn die Tabelle, die Sie untersuchen, übergeordnete Tabellen hat (geerbt von einer anderen Tabelle in ServiceNow®) und die Spalte, die Sie suchen, der übergeordneten Tabelle hinzugefügt wurde, sollten Sie stattdessen den Namen der übergeordneten Tabelle verwenden.

Um alle Tabellen aufzulisten, von denen die Tabelle, die Sie interessiert, erbt, verwenden Sie die folgende Abfrage:

SELECT
    sys_id,
    name,
    PARSE_JSON(super_class):value::string AS super_class_sys_id
FROM <dest_db>.<dest_schema>.sys_db_object__view
START WITH name = '<table_name>'
CONNECT BY sys_id = PRIOR super_class_sys_id;

Wenn Zeilen zurückgegeben werden, wurden die Metadaten für die Spalte korrekt in Snowflake aufgenommen, aber die Ansicht wurde noch nicht aktualisiert. Prüfen Sie den Status, und prüfen Sie außerdem Folgendes:

• Wenn die Ansicht kürzlich aktualisiert wurde, aber die Spalte immer noch nicht vorhanden ist, wenden Sie sich bitte an den Support.

• Wenn die Ansicht noch nicht aktualisiert wurde, warten Sie auf den nächsten Datenaufnahme-Zeitplan.

Wenn ein leeres Ergebnis zurückgegeben wird, bedeutet dies, dass der Konnektor noch keine Metadaten für diese Spalte aufgenommen hat. Sie müssen auf der Seite ServiceNow® überprüfen, ob der Datensatz für den Konnektor sichtbar ist und den richtigen Zeitstempel hat.

Aktualisierungsstatus anzeigen¶

Um zu überprüfen, wann die Ansichten für eine bestimmte Tabelle zuletzt aktualisiert wurden und ob der Vorgang erfolgreich war, führen Sie die folgende Abfrage aus:

SELECT flattened_views_status, flattened_views_last_updated FROM tables_state WHERE table_name = '<table_name>';

Wenn die letzte Aktualisierung fehlgeschlagen ist, können Sie die Ereignistabelle abfragen und nach Fehlern suchen, die vom Konnektor gemeldet wurden.

ServiceNow®-Verfügbarkeit von Spaltenmetadaten anzeigen¶

Es ist möglich, dass der Grund für die fehlenden Spalten in der vereinfachten Ansicht darin liegt, dass die Spaltenmetadaten nicht vom Konnektor aufgenommen werden können. Dies kann dadurch verursacht werden, dass ACLs verhindern, dass die Zeile in der Tabelle sys_dictionary von der Tabellen-API zurückgegeben wird. Ein anderer möglicher Grund ist ein vergangener Zeitstempelwert in der Spalte sys_updated_on. Es kann auch der Fall sein, dass die Spalten-/Tabellendefinition aus einer anderen ServiceNow®-Instanz importiert wurde. Um festzustellen, ob der Konnektor auf die Spaltenmetadaten zugreifen kann, führen Sie eine GET-Anfrage auf dem folgenden Endpunkt aus:

https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_query=name=<table_name>^element=<column_name>

Wenn ein leeres Ergebnis zurückgegeben wird, kann der Konnektor nicht auf die Spalte zugreifen. Die Spalte kann durch eine ACL geschützt oder nicht vorhanden sein.

Wenn eine Spaltendefinition zurückgegeben wurde, prüfen Sie den Wert im Feld sys_updated_on. Prüfen Sie, ob das Datum mit dem erwarteten Zeitpunkt übereinstimmt, an dem die Spalte der Tabelle hinzugefügt wurde. Wenn die Spalte aus einer anderen Instanz importiert wurde, wird möglicherweise der Zeitpunkt ihrer Erstellung angezeigt. Der CDC-Mechanismus (inkrementelle Aktualisierungen) im Konnektor bemerkt möglicherweise nicht, dass der Datensatz mit einem Datum hinzugefügt wurde, das in der Vergangenheit liegt. Lösen Sie in diesem Fall ein Neuladen der Tabelle sys_dictionary aus.