Tutorial: Installation des Snowflake-ServiceNow®-Datenaufnahme-Konnektors¶

Einführung¶

In diesem Tutorial lernen Sie, den Snowflake Connector für ServiceNow® mithilfe des Snowsight-Assistenten zu konfigurieren und zu verstehen, einige Tabellen auszuwählen, Daten aufzunehmen und eine Beispielabfrage auszuführen.

Diese Tutorial erhebt keinen Anspruch auf Vollständigkeit. Informieren Sie sich unter Allgemeine Informationen zum Snowflake Connector for ServiceNow®V2 über den vollen Funktionsumfang und die aktuellen Einschränkungen.

ServiceNow®-Entwicklerinstanz einrichten¶

Wenn Sie diesen Konnektor nicht auf Ihrem ServiceNow®-Konto testen möchten, können Sie eine Entwicklerinstanz verwenden. In diesem Abschnitt wird beschrieben, wie Sie eine Entwicklerinstanz einrichten.

1. Rufen Sie die ServiceNow®-Entwickler-Website auf, und erstellen Sie einen Entwicklerbenutzer.

2. Melden Sie sich mit Ihrem neu erstellten Benutzer bei der Entwickler-Website an, und wählen Sie Create an Instance aus.

3. Wählen Sie einen Instanztyp aus. Sie erhalten eine E-Mail mit Ihrer Instanz-URL sowie Ihrem Benutzer und Kennwort.

Die Bereitstellung geht in der Regel recht schnell, etwa fünf Minuten. Aber während Sie warten, lassen Sie uns zum nächsten Schritt übergehen und Snowflake konfigurieren!

Snowflake-Konto erstellen und einrichten¶

Alle Voraussetzungen erfüllen¶

Starten Sie den Snowflake Connector für ServiceNow® über Data Products -> Apps -> Snowflake Connector for ServiceNow. Sie erhalten eine Liste von Aufgaben, die erledigt werden müssen, bevor der Konnektor mit der Datenaufnahme beginnen kann. Lesen Sie die folgenden Beschreibungen sorgfältig durch, und füllen Sie alles aus.

In einem der letzten Schritte werden Sie aufgefordert, eine Anwendungsregistrierung zu erstellen, falls Sie die OAuth2-Authentifizierung aktivieren möchten. Die nächsten Schritte werden sich darauf konzentrieren.

Für den nächsten Abschnitt empfehlen wir Ihnen, zwei Browser-Tabs zu öffnen, damit Sie bestimmte Daten von Snowflake in ServiceNow® kopieren können:

• Verwenden Sie in Snowflake den Konnektor, um die Weiterleitungs-URL zu erstellen, die in die Anwendungsregistrierung eingefügt wird.

• Von ServiceNow® aus müssen Sie über die Anwendungsregistrierung die Client-ID und das Geheimnis bereitstellen, die Sie dann in Snowflake einfügen.

Konnektor konfigurieren¶

1. Wählen Sie Start configuration aus. Der Konfigurieren-Bildschirm wird angezeigt. Standardmäßig werden die Felder auf die Namen der Objekte gesetzt, die bei der Konfiguration des Konnektors erstellt wurden. Sie können auch vorhandene Objekte verwenden. Das ausgewählte virtuelle Warehouse wird vom Konnektor für die Datenaufnahme im Hintergrund verwendet.

2. Lesen Sie Konfigurieren des Snowflake Connector for ServiceNow®V2 für weitere Informationen.

3. Wählen Sie Configure aus.

Beachten Sie, dass es einige Minuten dauern kann, bis der Konfigurationsprozess abgeschlossen ist.

Snowflake-zu-ServiceNow®-OAuth2-Handshake einrichten¶

1. Wählen Sie OAuth2 als Authentifizierungsmethode aus.

2. Geben Sie die Details zur ServiceNow®-Instanz ein. Dies ist der erste Teil des ServiceNow®-URL für Ihr ServiceNow®-Konto, ohne https://*-Protokoll und das nachstehende service-now.com.

3. Fügen Sie die Client id und die Client secret von ServiceNow® in den Snowflake-Assistenten ein.

4. Wählen Sie Connect aus. Ihre ServiceNow®-Konten werden angezeigt, und Sie werden aufgefordert, sich mit Snowflake zu verbinden.

5. Wählen Sie Allow aus. Die Verbindung zwischen den beiden Systemen wird hergestellt.

Um die Verbindung zu überprüfen, wählen Sie die drei Punkte […] und dann View Details aus. Oben im Popup-Fenster sehen Sie das Datum, an dem ServiceNow authentifiziert wurde.

Löschsynchronisation konfigurieren¶

Wenn Sie möchten, dass nicht nur Einfügungen und Aktualisierungen, sondern auch Löschungen mit Snowflake synchronisiert werden, müssen Sie den Namen der Journaltabelle angeben. Standardmäßig verwendet ServiceNow® die Tabelle sys_audit_delete, um Informationen zu gelöschten Datensätzen zu speichern. Sie können diesen Namen also angeben. Wenn Löschungen für Sie nicht wichtig sind, können Sie dieses Feld leer lassen.

Wählen Sie Validate aus, um zu prüfen, ob der Konnektor eine Verbindung zum Quellsystem herstellen kann und Zugriff auf alle erforderlichen Tabellen hat. Es kann einige Minuten dauern, bis der Prozess abgeschlossen ist. Wenn Sie fertig sind, wählen Sie Define data to sync aus, um Tabellen für die Datenaufnahme auszuwählen.

ServiceNow®-Tabellen auswählen¶

1. Wählen Sie im Fenster Snowflake Connector for ServiceNow in der oberen Leiste Data Sync aus.

2. Um unsere Testabfrage später ausführen zu können, müssen wir ein paar Tabellen einlesen. Geben Sie im Suchfenster incident ein, aktivieren Sie das Kontrollkästchen daneben, und wählen Sie eine Synchronisierungszeit von 30 Minuten aus.

3. Um andere Tabellen auszuwählen, leeren Sie das Suchfeld, geben Sie den Tabellennamen ein, und aktivieren Sie das Kontrollkästchen. Tun Sie dies zumindest für die Tabelle task.

Bemerkung

Tipp: Leeren Sie die Suchfelder, und wählen Sie dann den Titel Status aus, um alle von Ihnen ausgewählten Tabellen zu sortieren und anzuzeigen.

4. Wählen Sie Start Sync aus. Das Auswahlfenster wird geschlossen, und Sie erhalten die Meldung Syncing Data aus dem Hauptfenster des Konnektors. Zusätzlich zu den von Ihnen gewählten Tabellen werden auch drei Systemtabellen geladen. Diese sind notwendig, um die Ansichten auf die Rohdaten zu erstellen: sys_dictionary, sys_db_object und sys_glide_object.

Sie erhalten eine Meldung über den Erfolg. Sie erscheint, sobald mindestens eine Tabelle vollständig aufgenommen wurde.

Konnektorüberwachung¶

Öffnen Sie ein Arbeitsblatt, um den Status des Konnektors zu überprüfen. Hier sind einige Beispiele für SQL-Abfragen, die Sie ausführen können, um Überwachungsinformationen zu erhalten:

// Return general information about all ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats;
// Search for information about particular table ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats WHERE table_name = '<table_name>';
// Examine connector configuration
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_configuration;
// Calculate ingested data volume
SELECT
    table_name,
    sum(ingested_rows) AS row_count
FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats
GROUP BY table_name
ORDER BY table_name;
// General connector statistics
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_overview;

Konfigurieren des Zugriffs auf die aufgenommenen Daten¶

Der Konnektor stellt die Anwendungsrolle DATA_READER zur Verfügung. Diese Rolle hat Lesezugriff auf alle aufgenommenen Daten im Zielschema. Sie wird automatisch der Rolle zugewiesen, die während des Installationsvorgangs im Schritt Konfigurieren angegeben wurde. Auf dem Screenshot weiter oben in diesem Leitfaden wurde sie SERVICE_NOW_RESOURCES_PROVIDER genannt. Sie können bei Bedarf entweder die Anwendungsrolle oder die Kontorolle weiter zuweisen.

Abfragen auf den Daten ausführen¶

Prüfen Sie die Tabellen, die der Konnektor unter dem Zielschema der Zieldatenbank erstellt hat. Für jede Tabelle in ServiceNow®, die für die Synchronisierung konfiguriert ist, erstellt der Konnektor die folgenden Tabellen und Ansichten:

• Eine Tabelle mit demselben Namen, die die Daten in Rohform enthält, wobei jeder Datensatz in einer einzigen VARIANT-Spalte enthalten ist.

• Eine Ansicht mit dem Namen table_name__view, die die Daten in vereinfachter Form enthält, wobei die Ansicht eine Spalte für jede Spalte der Originaltabelle und eine Zeile für jeden in der Originaltabelle vorhandenen Datensatz enthält.

• Eine Ansicht namens table_name__view_with_deleted, die dieselben Daten wie table_name__view enthält sowie Zeilen für Datensätze, die in ServiceNow® gelöscht wurden.

• Eine Tabelle table_name__event_log, die den Änderungsverlauf enthält, den der Konnektor von ServiceNow® abruft.

Um die Rohdaten abzufragen, lesen Sie Zugriff auf die Rohdaten. Um die Ansichten abzufragen (empfohlen), lesen Sie Zugriff auf die vereinfachten Daten.

USE ROLE SERVICE_NOW_RESOURCES_PROVIDER;
USE DATABASE SERVICENOW_DEST_DB;
USE SCHEMA DEST_SCHEMA;
WITH T1 AS (
    SELECT
    DISTINCT
        T.NUMBER AS TICKET_NUMBER,
        T.SHORT_DESCRIPTION,
        T.DESCRIPTION,
        T.PRIORITY,
        T.SYS_CREATED_ON AS CREATED_ON,
        T.SYS_UPDATED_ON AS UPDATED_ON,
        T.CLOSED_AT
    FROM TASK__VIEW T
    LEFT JOIN INCIDENT__VIEW I
        ON I.SYS_ID = T.SYS_ID -- ADDITIONAL INCIDENT DETAIL
   WHERE I.SYS_ID IS NOT NULL -- THIS CONDITION HELPS KEEP JUST THE INCIDENT TICKETS
)
SELECT
 YEAR(CREATED_ON) AS YEAR_CREATED,
 MONTH(CREATED_ON) AS MONTH_CREATED,
 PRIORITY,
 COUNT(DISTINCT TICKET_NUMBER) AS NUM_INCIDENTS
FROM T1
GROUP BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
ORDER BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
;

Gewähren von Zugriff auf den Konnektor¶

Der Konnektor stellt zwei Anwendungsrollen zur Verfügung, die über die für den Zugriff auf die Daten in der Zieldatenbank verwendete Rolle hinausgehen:

• Die Rolle VIEWER hat Nur-Lese-Zugriff auf die Konfiguration und den Status des Konnektors.

• Die Rolle ADMIN, die die Konnektorkonfiguration ändern und die Datenaufnahme aktivieren/deaktivieren kann

Um Fehler zu überwachen, Statistiken auszuführen, Konnektor-Statistiken zu prüfen und aktivierte Tabellen zu untersuchen, können Sie eine ServiceNow®-Überwachungsrolle einrichten, die Zugriff auf die Ansichten und schreibgeschützten Prozeduren in der Konnektor-Datenbank erlaubt.

Führen Sie zum Beispiel Folgendes in einem Arbeitsblatt aus (und verwenden Sie dann die Rolle):

USE ROLE accountadmin;
CREATE ROLE IF NOT EXISTS servicenow_monitor_role;
GRANT APPLICATION ROLE SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.viewer TO ROLE servicenow_monitor_role;
GRANT USAGE ON WAREHOUSE SERVICENOW_WAREHOUSE TO ROLE servicenow_monitor_role;

Datenaufnahme stoppen¶

Da wir in diesem Tutorial nur die Daten aufnehmen, ist es sinnvoll, die Datenaufnahme nach dem erstmaligen Laden zu beenden. In einer Produktionsumgebung würden Sie den Konnektor jedoch nicht anhalten.

1. Wählen Sie in Snowsight die Kachel Snowflake Connector for ServiceNow aus.

2. Wählen Sie im Snowflake Connector for ServiceNow-Fenster die Option Pause Connector aus.

Konnektor deinstallieren (aber nicht die Daten)¶

Wenn Sie das Tutorial abgeschlossen haben oder den Konnektor aus irgendeinem Grund nicht mehr benötigen, können Sie ihn einfach über den Snowflake Marketplace deinstallieren.

1. Wählen Sie Datenprodukte und dann Apps aus.

2. Wählen Sie bei dem Element auf der Liste, das die Konnektor-App darstellt, das Drei-Punkte-Symbol aus.

3. Wählen Sie Deinstallieren aus.

4. Entscheiden Sie, ob Sie die Objekte, die in Eigentümerschaft der Anwendung sind (Tabellen und Ansichten mit aufgenommenen Daten im Zielschema), löschen oder die Eigentümerschaft an eine andere Rolle übertragen möchten.

5. Wählen Sie Deinstallieren aus.

Fazit und Ressourcen¶

Herzlichen Glückwunsch! Sie haben den Snowflake Connector für ServiceNow® erfolgreich installiert und konfiguriert, Daten aufgenommen und eine Abfrage ausgeführt, um Erkenntnisse über Vorfälle und Prioritäten zu gewinnen.

Zusammenfassung

• Einrichten des Snowflake Connector für ServiceNow®

• Aufnehmen von ServiceNow®-Daten in Snowflake

• Anhalten des Konnektors, um unnötige Kosten in einer Entwicklungsumgebung zu vermeiden