Installieren und Konfigurieren des Konnektors mit Snowsight¶

Installieren des Snowflake-Konnektors für ServiceNow¶

Im Folgenden wird beschrieben, wie Sie den Konnektor installieren und eine Verbindung zu ServiceNow herstellen:

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

2. Wählen Sie im linken Navigationsbereich die Option Marketplace aus.

3. Suchen Sie nach dem Snowflake-Konnektor für ServiceNow, und wählen Sie dann die Kachel für den Konnektor aus.

4. Wählen Sie auf der Seite für Snowflake Connector for ServiceNow die Option Get aus.

   Daraufhin wird ein Dialogfeld angezeigt, mit dem Sie den ersten Teil des Installationsvorgangs beginnen können.

   Konfigurieren Sie im Dialogfeld die folgenden Einstellungen:

   1. Geben Sie im Feld Database name die Datenbank an, die für die Konnektorinstanz verwendet werden soll. Diese Datenbank wird automatisch für Sie erstellt.

   2. Wählen Sie im Feld Warehouse used for installation das Warehouse aus, das Sie für die Installation des Konnektors verwenden möchten.

      Bemerkung

      Dies ist nicht dasselbe Warehouse, das vom Konnektor zum Synchronisieren der Daten aus ServiceNow verwendet wird. In einem späteren Schritt werden Sie für diesen Zweck ein eigenes Warehouse erstellen.

   3. Fügen Sie im Feld Which roles, in addition to ACCOUNTADMIN, can access this database? die weiteren Rollen hinzu, die Zugriff auf die Datenbank erhalten sollen.

   4. Wählen Sie Get aus.

5. Wählen Sie Manage aus.

   Das Dialogfeld wird geschlossen, und auf der Seite Snowflake Connector for ServiceNow wird die UI zum Konfigurieren und Verwalten des Konnektors angezeigt.

6. Wählen Sie im Abschnitt Connections die Option Connect aus, um die Einstellungen für die Verbindung zur ServiceNow-Instanz zu konfigurieren.

   Daraufhin wird das Dialogfeld Connect to ServiceNow angezeigt.

7. Geben Sie im Feld ServiceNow Instance den Namen der ServiceNow-Instanz ein.

   Dies ist der erste Teil des Hostnamens Ihrer ServiceNow-Instanz. Angenommen, die URL zu Ihrer ServiceNow-Instanz ist:

   https://myinstance.service-now.com
   

   Copy

   Der Name Ihrer Instanz wäre dann myinstance.

8. Wählen Sie im Feld Authentication Method die Authentifizierungsmethode aus, die verwendet werden soll möchten, wenn der Konnektor eine Verbindung zur ServiceNow-Instanz herstellen möchte.

   Sie können entweder die Basisauthentifizierung (Benutzername und Kennwort) oder OAuth auswählen.

9. Wenn Sie Basic authentication ausgewählt haben, geben Sie die Anmeldeinformationen für Ihr ServiceNow-Konto in die Felder ServiceNow username und ServiceNow password ein.

10. Wenn Sie OAuth ausgewählt haben, erstellen Sie in ServiceNow eine Anwendungsregistrierung, die Sie dann zur Konfiguration des Konnektors verwenden.

    Um eine Anwendungsregistrierung zu erstellen, gehen Sie wie folgt vor:

    1. Melden Sie sich bei Ihrer ServiceNow-Instanz an, und wählen Sie dann Homepage aus.

    2. Suchen Sie nach OAuth, und wählen Sie dann Application Registry aus.

    3. Wählen Sie New, und dann Create an OAuth API endpoint for external clients aus.

       Daraufhin wird eine Konfigurationsseite für die Anwendungsregistrierung angezeigt, wie in der folgenden Abbildung dargestellt:

       

    4. Geben Sie in ServiceNow im Feld Name einen Namen für die OAuth-Anwendungsregistrierung ein.

    5. Kopieren Sie auf der Konnektor-UI die im Feld Redirect URL angezeigte URL.

       Dieser Wert wurde vom Konnektor generiert.

    6. Fügen Sie den Wert in ServiceNow in das Feld Redirect URL ein.

    7. Aktualisieren Sie, falls erforderlich, in ServiceNow die Werte in den Feldern Refresh Token Lifespan und Access Token Lifespan.

       • Snowflake empfiehlt, die Lebensdauer des Zugriffstokens auf mindestens 600 Sekunden festzulegen.

       • Für die Lebensdauer des Aktualisierungstokens geben Sie einen Wert von 7.776.000 (90 Tage) an.

    8. Wählen Sie in ServiceNow die Option Submit aus.

       Die OAuth-Anwendungsregistrierung wird in der Liste der Anwendungsregistrierungen angezeigt.

    9. Wählen Sie in ServiceNow die soeben erstellte Anwendungsregistrierung aus.

       Beachten Sie, dass die Werte in den Feldern Client ID und Client Secret von ServiceNow generiert wurden.

    10. Kopieren Sie in ServiceNow den Wert für Client ID.

    11. Fügen Sie diesen Wert in das Feld Client ID der Konnektor-UI ein.

    12. Kopieren Sie in ServiceNow den Wert für Client Secret.

    13. Fügen Sie diesen Wert in das Feld Client Secret der Konnektor-UI ein.

        Der Konnektor verwendet ein Geheimnis (secret) (eine Art Objekt auf Schemaebene), um die Zugriffstoken zu speichern, die zur Authentifizierung bei der ServiceNow-Instanz verwendet werden. Der Konnektor verwendet dieses Geheimnisobjekt mit einer Sicherheitsintegration und einer API-Integration, um sich mit der ServiceNow-Instanz zu verbinden.

        Geheimnis, Sicherheitsintegration und API-Integration werden automatisch erstellt, wenn Sie den Konnektor installieren.

    14. Um festzulegen, wie Geheimnisobjekt, Sicherheitsintegration und API-Integration konfiguriert werden, wählen Sie Advanced Settings aus, und füllen Sie dann die folgenden Felder aus:

        Feld	Beschreibung
        Secret Name	Der Name des Geheimnisses. Dieser Wert wird vom Konnektor generiert. Er kann nicht geändert werden.
        Authorization URL	Die URL für die Authentifizierung bei der ServiceNow-Instanz. Diese URL muss das folgende Format haben: https://<instance_name>.service-now.com/oauth_token.do Copy Dabei ist instance_name der Name Ihrer ServiceNow-Instanz.
        Token URL	Die URL zum Anfordern eines Aktualisierungstokens für die ServiceNow-Instanz. Diese URL muss das folgende Format haben: https://<instance_name>.service-now.com/oauth_token.do Copy Dabei ist instance_name der Name Ihrer ServiceNow-Instanz.
        Allowed Prefix	Die URL zu Ihrer ServiceNow-Instanz. Dadurch wird die Verwendung dieser Verbindungseinstellungen eingeschränkt. Die Einstellungen können nur für Verbindungen zu URLs mit den angegebenen Präfixen verwendet werden.

11. Wählen Sie auf der Konnektor-UI die Option Connect aus.

    Es wird ein Dialogfeld angezeigt, in dem Sie bestätigen müssen, dass Sie dem Konnektor erlauben möchten, sich mit Ihrem ServiceNow-Konto zu verbinden.

    Bemerkung

    Stellen Sie sicher, dass Sie bei ServiceNow als derselbe Benutzer angemeldet sind, den Sie für den Konnektor verwenden möchten. Sie können den aktuell angemeldeten Benutzer in der oberen rechten Ecke des Dialogs überprüfen.

12. Wählen Sie Allow aus.

    Die neue ServiceNow-Verbindung wird im Bereich Connection angezeigt.

Konfigurieren des Snowflake-Konnektors für ServiceNow¶

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

2. Wählen Sie im linken Navigationsbereich die Option Marketplace aus.

3. Suchen Sie nach dem Snowflake-Konnektor für ServiceNow, und wählen Sie ihn aus.

4. Wählen Sie unter dem Status des Konnektors die Option Configure aus.

   Daraufhin wird das Dialogfeld Configure Connector angezeigt.

   Bemerkung

   Standardmäßig werden die Felder auf die Namen der Objekte gesetzt, die bei der Konfiguration des Konnektors erstellt werden. Snowflake empfiehlt die Verwendung neuer Objekte für diese Felder. Sie können jedoch bei Bedarf die Namen vorhandener Objekte angeben (z. B. wenn Sie den Konnektor neu installieren).

   Füllen Sie in diesem Dialogfeld die folgenden Felder aus:

   Feld	Beschreibung
   Warehouse	Bezeichner für ein neues, dediziertes virtuelles Warehouse für den Konnektor. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Warehouses muss ein gültiger Objektbezeichner sein. Bemerkung Geben Sie nicht das gleiche Warehouse an, das Sie zu Beginn der Installation des Konnektors ausgewählt haben. Der Konfigurationsprozess erstellt ein neues Warehouse der Größe Large mit dem angegebenen Namen.
   Destination Database	Bezeichner für eine neue Datenbank, die das Schema mit den Tabellen für die ServiceNow-Daten in Snowflake enthält. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Datenbank muss ein gültiger Objektbezeichner sein. Der Konfigurationsprozess erstellt eine neue Datenbank mit dem angegebenen Namen.
   Destination Schema	Bezeichner für ein neues Schema, das die ServiceNow-Daten in Snowflake enthalten wird. Der Snowflake-Konnektor für ServiceNow erfasst ServiceNow-Daten in Tabellen dieses Schemas. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Schemas muss ein gültiger Objektbezeichner sein. Der Konfigurationsprozess erstellt ein neues Schema mit dem angegebenen Namen.
   Role	Bezeichner für eine neue kundenspezifische Rolle für den Konnektor. Mit dieser Rolle wird dem Konnektor Folgendes ermöglicht: Erstellen und Verwalten von Aufgaben zum Erfassen der Daten Verwenden des dedizierten Warehouses Zugriff auf Geheimnis und API-Integration für die Verbindung zur ServiceNow-Instanz Die Rolle ist auch Eigentümer der Tabellen und Ansichten, die die vom Konnektor erfassten ServiceNow-Daten enthalten. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Rolle muss ein gültiger Objektbezeichner sein. Der Konfigurationsprozess erstellt eine neue Rolle mit dem angegebenen Namen.
   Journal table	(Optional) Um die Weitergabe gelöschter Datensätze zu aktivieren, setzen Sie diesen Parameter auf die Tabelle, die als Quelle für Informationen zu gelöschten Datensätzen dient. Sie können entweder die Tabelle sys_audit_delete oder eine kundenspezifische Erfassungstabelle als Quelle für Informationen zu gelöschten Datensätzen verwenden. Wenn Sie keine gelöschten Datensätze aus ServiceNow in Snowflake erfassen möchten, lassen Sie dieses Feld leer. Bemerkung Stellen Sie sicher, dass der ServiceNow-Benutzer für den Konnektor Zugriff auf die angegebene Erfassungstabelle hat.

5. Wählen Sie Configure aus.

Das Dialogfeld wird geschlossen, und der Status des Konnektors ändert sich in Provisioning. Es kann einige Minuten dauern, bis der Konfigurationsprozess abgeschlossen ist.

Im Abschnitt Connector Objects werden die Objekte angezeigt, die während der Installation und Konfiguration automatisch erstellt wurden. Der Konnektor verwendet diese Objekte, um Daten aus der ServiceNow-Instanz zu erfassen. Wählen Sie ein Objekt aus, um die Details zu diesem Objekt anzuzeigen.

Wenn der Konfigurationsprozess erfolgreich abgeschlossen wurde, ändert sich der angezeigte Status in Inactive.

Problembehandlung bei Konfiguration¶

Tritt während des Konfigurationsprozesses ein Fehler auf, ändert sich der Status des Konnektors in Incomplete. So identifizieren und behandeln Sie Fehler:

1. Wählen Sie Retry Setup aus, um das Konfigurationsdialogfeld erneut anzuzeigen.

2. Prüfen Sie, ob in einem der Felder Fehlermeldungen angezeigt werden.

3. Lösen Sie die Probleme in den Feldern, und wählen Sie Configure aus, um den Konfigurationsprozess erneut zu starten.

Einrichten der Datenerfassung¶

Führen Sie nach Installation und Konfiguration des Konnektors die unter Einrichten der Datenerfassung (Data Ingestion) für Ihre ServiceNow-Daten beschriebenen Schritte aus.