Verwalten, Aktualisieren und Deinstallieren des Snowflake Connector for ServiceNow®V2¶

Anhalten und Fortsetzen des Snowflake Connector for ServiceNow®V2¶

In den folgenden Abschnitten wird beschrieben, wie der Konnektor gestartet, angehalten und fortgesetzt wird.

CALL PAUSE_CONNECTOR();

CALL RESUME_CONNECTOR();

Ändern des vom Konnektor verwendeten Warehouses¶

Wenn Sie das vom Konnektor verwendete Warehouse ändern oder ein dediziertes Warehouse hinzufügen möchten, führen Sie folgenden Befehl aus:

CALL UPDATE_WAREHOUSE('<warehouse_name>');

Copy

Wobei:

warehouse_name

Gibt den Namen des Warehouses an, das der Konnektor verwenden soll.

Löschen von Tabellen¶

Um eine Tabelle zu löschen (die z. B. unbeabsichtigt aktiviert wurde) und sie nicht in den Ansichten zur Überwachung des Konnektors anzuzeigen, gehen Sie wie folgt vor:

CALL DELETE_TABLE('<table_name>');

Copy

Wobei:

table_name

Gibt den Namen der Tabelle an, die gelöscht werden soll. Diese Tabelle muss deaktiviert sein und darf nicht im Prozess zum Neuladen sein.

USE ROLE ACCOUNTADMIN;
GRANT OWNERSHIP ON TABLE <destination_database>.<destination_schema>.<table_name> TO ROLE <account_role> REVOKE CURRENT GRANTS;
USE ROLE <account_role>;
DROP TABLE <destination_database>.<destination_schema>.<table_name>;

Aktualisieren des vom Konnektor verwendeten Aktualisierungstokens¶

Wenn Sie den Konnektor mit OAuth-Authentifizierung einrichten, müssen Sie das Aktualisierungstoken regelmäßig aktualisieren. Andernfalls kann der Konnektor nach Ablauf des Tokens nicht mehr auf ServiceNow® zugreifen. Standardmäßig läuft das Token 90 Tage nach seiner Erstellung ab.

Wenn Sie E-Mail-Alerts für den Konnektor konfigurieren, erhalten Sie am ersten Tag eines jeden Monats eine Erinnerung zur Aktualisierung des Aktualisierungstokens. Wenn das Token abläuft, erhalten Sie eine E-Mail, sobald der Konnektor Probleme beim Zugriff auf ServiceNow® hat.

Aktualisierung des ServiceNow®-Kennworts für die Basisauthentifizierung¶

Um das Kennwort zu aktualisieren, müssen Sie ein vorhandenes Geheimnis finden und es mit dem Befehl ALTER SECRET ändern.

1. Ermitteln Sie mit Snowsight oder mit SQL den vollqualifizierten Namen des Geheimnisobjekts.

   1. Um ein Geheimnis mit Snowsight zu erhalten, gehen Sie wie folgt vor:

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

      2. Wählen Sie im linken Navigationsbereich die Option Data Products » Apps aus.

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

      4. Wählen Sie im oberen Navigationsmenü die Option Settings » Authentication aus.

         Im Abschnitt Authentication wird das Geheimnisobjekt angezeigt, zum Beispiel CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET.

   2. Um den vollqualifizierten Namen des Geheimnisobjekts mit einem SQL-Befehl zu erhalten, fragen Sie die Ansicht CONNECTOR_CONFIGURATION ab:

      SELECT value FROM connector_configuration WHERE config_key = 'secret';
      

      Copy

2. Führen Sie das Anhalten des Konnektors aus.

3. Aktualisieren Sie das Geheimnisobjekt, indem Sie den Befehl ALTER SECRET ausführen und dabei den PASSWORD-Parameter ändern.

4. Danach müssen Sie den Konnektor fortsetzen.

   Das Kennwort wird nun aktualisiert und vom Konnektor verwendet.

Aktualisieren der Verbindung zur ServiceNow®-Instanz¶

Es ist möglich, die Verbindung zur ServiceNow®-Instanz zu aktualisieren. Hier können Sie die Integration von External Access und das vom Konnektor verwendete Geheimnis ändern. Es ermöglicht auch die Korrektur des Problems, wenn das Geheimnis vom External Access UDF im Konnektor abgetrennt wurde.

Die Konfiguration der Verbindung kann mit der folgenden Prozedur aktualisiert werden:

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': '<servicenow_base_url>',
  'secret': '<secret_name>',
  'external_access_integration': '<external_access_integration_name>'
});

Wobei:

servicenow_base_url

Gibt die URL der ServiceNow®-Instanz an, die der Konnektor verwenden soll. Die URL muss auf denselben Wert wie bei der Installation des Konnektors eingestellt werden und sollte das folgende Format haben:

https://<servicenow_instance_name>.service-now.com

Copy

Die Änderung der ServiceNow®-Instanz URL wird nicht unterstützt.

secret_name

Gibt den vollständig qualifizierten Namen des Geheimobjekts an, das die Anmeldeinformationen für die Authentifizierung bei ServiceNow® enthält.

Sie müssen den vollqualifizierten Namen des Geheimnisobjekts in folgendem Format angeben:

<database_name>.<schema_name>.<secret_name>

Copy

Die Namen von Datenbank, Schema und Geheimnis müssen gültige Objektbezeichner sein.

external_access_integration_name

Gibt den Namen der Integration für den externen Zugriff auf ServiceNow® an.

Der Name der Integration muss ein gültiger Objektbezeichner sein.

Zum Beispiel, um die Verbindung zu einer ServiceNow®-Instanz zu aktualisieren, die:

• Die URL ist https://myinstance.service-now.com.

• Es wird das in secretsdb.apiauth.servicenow_creds_oauth_code gespeicherte Geheimnis verwendet.

• Verwendet die Integration für den externen Zugriff namens servicenow_external_access_integration.

Führen Sie den folgenden Befehl aus:

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': 'https://myinstance.service-now.com',
  'secret': 'SECRETSDB.APIAUTH.SERVICENOW_CREDS_OAUTH_CODE',
  'external_access_integration': 'SERVICENOW_API_INTEGRATION'
});

Die Aktualisierung der Konfiguration kann nur von einem Benutzer mit einer Berechtigung für die Anwendungsrolle ADMIN durchgeführt werden. Um die Prozedur auszuführen, muss sich der Konnektor außerdem im Zustand paused befinden. Siehe Pausieren des Konnektors.

Exportieren des Konnektorstatus¶

Es ist möglich, einen Snapshot des aktuellen Status und der aktuellen Konfiguration des Konnektors zu exportieren. Der Snapshot mit dem exportierten Konnektorstatus ist nützlich, wenn Sie den Konnektor neu installieren, um bereits aktivierte Tabellen und den Datenaufnahmestatus beizubehalten, oder wenn die Replikation des Zielschemas in die Failover-Region konfiguriert wird, um die Notfallwiederherstellung zu unterstützen.

Der Status kann mit der folgenden Prozedur exportiert werden:

CALL EXPORT_CONNECTOR_STATE();

Copy

Die Prozedur erstellt im Zielschema eine neue Tabelle __CONNECTOR_STATE_EXPORT mit einem exportierten Status. Zum Ausführen des Exports müssen die folgenden Bedingungen erfüllt sein:

• Der Export kann nur von einem Benutzer ausgeführt werden, dem die Anwendungsrolle ADMIN zugewiesen ist.

• Es gibt keine ständiges Nachladen der Tabelle.

Die Konfiguration wird außerdem jedes Mal automatisch exportiert, wenn der Konnektor den Datenaufnahmeprozess gemäß dem konfigurierten Zeitplan auslöst, sofern die folgenden Bedingungen erfüllt sind:

• Mindestens eine Tabelle ist für die Datenaufnahme aktiviert.

• Es findet kein ständiges Nachladen der Tabelle statt.

Deinstallieren der Anwendung¶

In diesem Abschnitt wird erklärt, wie Sie die Anwendung mit Snowsight und mit Arbeitsblättern deinstallieren und wie Sie die vom Konnektor erstellten Objekte entfernen, die aber vom Benutzer bewusst entfernt werden müssen.

Aktualisieren des Konnektors¶

Der Konnektor wird automatisch aktualisiert, sodass der Benutzer nichts tun muss, um eine aktuelle Anwendung zu erhalten.

Skalieren des Konnektors¶

Wenn es viele ServiceNow®-Tabellen gibt, die aufgenommen werden sollen, und Sie die Anzahl der gleichzeitig aufgenommenen Tabellen erhöhen möchten, können Sie den Parameter wie folgt ändern:

CALL CONFIGURE_CONCURRENCY(<number>);

Copy

Wobei:

number

Gibt die maximale Anzahl von Workern an, die gleichzeitig Tabellen aufnehmen können. Standardmäßig ist dieser Wert auf 10 eingestellt.

Eine Erhöhung der Parallelität sollte zusammen mit einer Änderung der Größe des für die Datenaufnahme verwendeten Warehouses in Betracht gezogen werden. Wenn Sie eine Verlangsamung feststellen, versuchen Sie, die Größe des Warehouses anzupassen. Weitere Informationen dazu finden Sie unter Verwenden von Warehouses.

Neuinstallieren des Konnektors mit derselben Datenbank und demselben Schema für ServiceNow®-Daten¶

Um den Konnektor erneut zu installieren, gehen Sie wie folgt vor:

1. Fragen Sie die Ansicht TABLES_STATE ab, und stellen Sie sicher, dass sich derzeit keine der Tabellen im Status RELOADING befindet:

   SELECT TABLE_NAME FROM TABLES_STATE WHERE STATUS = 'RELOADING';
   

   Copy

2. Wenn Tabellen gerade neu geladen werden, warten Sie, bis die Ladevorgänge abgeschlossen sind oder brechen Sie sie ab.

3. Halten Sie den Konnektor an, indem Sie die folgende gespeicherte Prozedur aufrufen:

   CALL PAUSE_CONNECTOR();
   

   Copy

4. Exportieren Sie den Status und die Konfiguration des Konnektors. Informationen dazu finden Sie in diesem Abschnitt.

   Wichtig

   Es wird empfohlen, den Status und die Konfiguration eines Konnektors zu exportieren, bevor Sie die Konnektoranwendung löschen. Auf diese Weise bleiben alle benutzerdefinierten Optionen (z. B. Tabellen, die für die Synchronisierung aktiviert sind, und deren Zeitpläne) und der Status mit ihren jüngsten Änderungen in der neuen Installation erhalten.

   Wenn Sie den Konnektor bereits entfernt haben, aber die Datenbank und das Schema mit den aufgenommenen Daten intakt gelassen haben, können Sie den Konnektor dennoch neu installieren und sich dabei auf den automatisch exportierten Zustand stützen, wobei aber der neu installierte Konnektor möglicherweise die Datenaufnahme einiger Datensätze wiederholt.

5. Entfernen Sie den Konnektor und übertragen Sie die Eigentümerschaft von Tabellen und Ansichten im Zielschema.

6. Für die erneute Installation des Konnektors haben Sie folgende Optionen:

   • Neuinstallieren des Konnektors mit Snowsight (bevorzugt).

   • Neuinstallieren des Konnektors mit SQL.

Während des Installationsprozesses:

• Geben Sie die zuvor verwendete Datenbank und das Schema an.

  Nach der Installation erkennt der Konnektor, dass die Datenbank und das Schema aufgenommene Daten enthalten und setzt die Datenaufnahme an der Stelle fort, an der sie vor der Neuinstallation abgebrochen wurde. Wenn Sie den Status des Konnektors exportiert haben und dieser während der Installation erfolgreich importiert wird, werden die zuvor aufgenommenen Tabellen automatisch mit denselben Zeitplänen und derselben Konfiguration aktiviert. Andernfalls müssen Sie alle Tabellen manuell aktivieren und z. B. deren Zeitpläne konfigurieren, um die Datenaufnahme wiederherzustellen.

  Denken Sie bei einer Neuinstallation mit den SQL-Befehlen daran, die Eigentümerschaft von Ansichten und Tabellen im Zielschema auf den Konnektor zu übertragen, wie in der SQL-Installationsanleitung beschrieben. Andernfalls hat der Konnektor keinen Zugriff auf diese Tabellen und Ansichten, sodass er die Datenaufnahme nicht fortsetzen kann.

• Geben Sie denselben ServiceNow®-Instanznamen an.

• Für die anderen Argumente können Sie die Objekte wiederverwenden, die Sie beim Installieren des Konnektors erstellt haben, oder Sie können neue Objekte verwenden.