Voraussetzungen

Der Schritt „Voraussetzungen“ ist der erste Schritt in der Assistentenphase des Konnektors. Dieser Schritt ist komplett optional, wird aber empfohlen, wenn der Benutzer zusätzliche Einstellungen außerhalb der nativen App oder sogar des gesamten Snowflake-Kontexts vornehmen muss. Ein Beispiel hierfür wäre die Einrichtung von Authentifikatoren und Autorisierungen in dem Quellsystem, aus dem die Daten übernommen werden sollen.

Um die Voraussetzungen einzurichten, müssen diese während der Installation des Konnektors in die Tabelle STATE.PREREQUISITES eingefügt werden. Die meisten Spalten in dieser Tabelle sollten selbsterklärend sein. Die URL-Spalten sollten verwendet werden, um dem Benutzer weitere Informationen zu den erforderlichen Einstellungen zu geben. Falls Sie in den Voraussetzungen etwas noch Kundenspezifischeres angeben müssen, sollten Sie die Spalte custom_properties verwenden.

Die Voraussetzungsphase besteht aus 2 Schritten:

  1. Markieren von Voraussetzungen als erledigt

  2. Abschließen des Schritts

Anforderungen

„Voraussetzungen“ erfordert mindestens die folgenden SQL-Dateien, die während der Native App-Installation ausgeführt werden müssen:

  • core.sql

  • configuration/prerequisites.sql

Markieren von Voraussetzungen als erledigt

Dieser Schritt kann auf zwei verschiedene Arten vorgenommen werden. Die Voraussetzungen können entweder einzeln oder alle zusammen als erfüllt markiert werden. Das Endergebnis ist dasselbe: Bei jeder Voraussetzung ist der Wert is_completed auf true gesetzt. Dieser Schritt wird von folgenden Prozeduren übernommen:

  • PUBLIC.MARK_ALL_PREREQUISITES_AS_DONE()

  • PUBLIC.UPDATE_PREREQUISITE(ID VARCHAR, IS_COMPLETED BOOLEAN)

Beide Prozeduren setzen voraus, dass sich der Konnektor im Status CONFIGURING befindet und dass der Konfigurationsstatus nicht FINALIZED ist.

Abschließen des Schritts

Um den Schritt „Voraussetzungen“ abzuschließen, rufen Sie die Prozedur PUBLIC.COMPLETE_PREREQUISITES_STEP() auf. Diese Prozedur hat keine Auswirkungen, es sei denn, der Konnektor befindet sich im Status CONFIGURING mit dem Konfigurationsstatus INSTALLED.

Wenn dies der Fall ist, wird der Status auf den folgenden Wert aktualisiert:

{
    "status": "CONFIGURING",
    "configurationStatus": "PREREQUISITES_DONE"
}
Copy

Für diese Prozedur muss sich der Konnektor im Status CONFIGURING befinden und der Konfigurationsstatus darf nicht FINALIZED sein.

Sprache: Deutsch