Daten aus Snowflake-Aufgabe extrahieren

Informationen zur Aufgabe „Daten aus Snowflake extrahieren“

Snowflake ist eine Drittanbieter-Daten-Cloud-Software, die zum Speichern, Pflegen und Teilen von Daten verwendet wird. Sie können Daten aus Snowflake importieren, um sie in einem Qualtrics-Workflow zu verwenden.

Integration mit Snowflake

Um diese Aufgabe verwenden zu können, müssen Sie eine neue Integration in Snowflake erstellen und mit Qualtrics verbinden.

Einrichtung in Snowflake

1. Melden Sie sich bei Snowflake an.
2. Klicken Sie auf der Registerkarte Arbeitsblätter auf das Pluszeichen (+), und wählen Sie SQL-Arbeitsblatt aus.
3. Fügen Sie den folgenden Quelltext in das Arbeitsblatt ein:
   

   
   CREATE SECURITY 
   
   INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect'
   
    ENABLED = TRUE
   
    OAUTH_ISSUE_REFRESH_TOKENS = TRUETRUE
   
    DIEN_OEN_AUTH_REFRE000

4. Ersetzen Sie die fett markierte Zeile QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 durch einen Namen für die Integration. Verwenden Sie für den Integrationsnamen nur Buchstaben, Zahlen und Unterstriche.
   
   Tipp: Kopieren Sie Ihren Integrationsnamen, da Sie ihn später benötigen, um die Einrichtung abzuschließen. Snowflake wird jeden Buchstaben in Ihrem Integrationsnamen automatisch in Großbuchstaben schreiben. Wenn ich beispielsweise meine Integration „Qualtrics_Integration“ nenne, wird sie in Snowflake als „QUALTRICS_INTEGRATION“ gespeichert. Das ist der Name, den ich für später speichern sollte.
5. Ersetzen Sie die fett formatierte Publicapist3 durch Informationen über Ihre Marke. Diese Informationen sind unterschiedlich, je nachdem, ob Sie eine individuelle Verbindung innerhalb des Workflows selbst oder eine kontenweite Verbindung auf der Registerkarte Admin einrichten möchten.
   • Wenn Sie eine individuelle Verbindung anlegen, ersetzen Sie diese durch Ihre brandID.
     Beispiel: Wenn meine BrandID „dsx“ ist, lautet mein aktualisierter Wert „https://dsx.qualtrics.com/oauth-client-service/redirect“.
   • Wenn Sie eine kontoweite Verbindung erstellen, ersetzen Sie diese durch Ihre Rechenzentrums-ID.
     Beispiel: Wenn meine Rechenzentrums-ID „iad1“ ist, lautet mein aktualisierter Wert „https://iad1.qualtrics.com/oauth-client-service/redirect“.
6. Wählen Sie Ausführen.
7. Sie erhalten die Meldung „Integration ‘Name der Integration’ erfolgreich angelegt“.
   
   Tipp: Wenn Sie den Fehler „unzureichende Berechtigungen“ erhalten, müssen Ihre Snowflake-Berechtigungen aktualisiert werden. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie auf dieser Snowflake-Supportseite.
8. Geben Sie im selben Arbeitsblatt den folgenden Code ein:

   ​​​​SECURITY INTEGRATION NAME_OF_SECURITY_INTEGRATION BESCHREIBEN

9. Ersetzen Sie die fett markierte INTEGRATION NAME_OF_SECURITY_INTEGRATION durch Ihren Integrationsnamen in Großbuchstaben aus Schritt 4.
10. Wählen Sie Ausführen.
11. Sie erhalten verschiedene Informationen zur Integration. Kopieren Sie die Werte für die folgenden Felder:
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. Geben Sie im selben Arbeitsblatt den folgenden Code ein:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS(‘NAME_OF_SECURITY_INTEGRATION’)

13. Ersetzen Sie den fett formatierten Namen NAME_OF_SECURITY_INTEGRATION durch Ihren Integrationsnamen in Großbuchstaben aus Schritt 4.
14. Wählen Sie Ausführen.
15. Kopieren Sie einen der Werte für Geheimer Client-Schlüssel.

Einrichtung in Qualtrics

1. Wenn Sie eine instanzweite Verbindung erstellen (d. h. ein Snowflake-Konto, das für alle Benutzer in Ihrer Qualtrics-Lizenz verfügbar ist), navigieren Sie zu Erweiterungen Abschnitt des Administrator und suchen Sie nach Daten aus Snowflake-Integration extrahieren.
2. Wenn Sie eine individuelle Verbindung anlegen (d.h. ein Snowflake-Konto, das nur Ihnen zur Verfügung steht), navigieren Sie zu Workflows und legen Sie einen neuen ETL-Workflow an. Wenn Sie Ihre Extraktoraufgabe auswählen, wählen Sie die Aufgabe Daten aus Snowflake extrahieren.
3. Klicken Sie auf der Registerkarte Administrator auf Konto hinzufügen oder in der Workflow-Aufgabe auf Benutzerkonto hinzufügen. Die verbleibenden Schritte sind dieselben, unabhängig davon, wo Sie Ihr Konto einrichten.
   
4. Benennen Sie Ihr Konto, damit Sie es später identifizieren können.
   
5. Wählen Sie Berechtigungscode für die Erteilungsart.
6. Geben Sie Ihre Berechtigungsdetails ein:
   • Client-ID: Die OAUTH_CLIENT_ID, die Sie in Schritt 10 von Setup in Snowflake kopiert haben.
   • Geheimer Client-Schlüssel: CLIENT_SECRET, das Sie in Schritt 14 von Setup in Snowflake kopiert haben.
   • Tokenendpunkt: Der OAUTH_TOKEN_ENDPOINT, den Sie in Schritt 10 von Setup in Snowflake kopiert haben.
   • Berechtigungsendpunkt: OAUTH_AUTHORIZATION_ENDPOINT, den Sie in Schritt 10 von Setup in Snowflake kopiert haben.
   • Umfänge (optional): Sie können Umfänge verwenden, um die Zugriffsebene einzuschränken. Für die meisten Anwendungsfälle können Sie dieses Feld leer lassen.
7. Klicken Sie auf Konto verbinden.
8. Es öffnet sich ein Fenster, in dem Sie sich bei Snowflake anmelden können. Geben Sie Ihren Snowflake-Benutzernamen und Ihr Kennwort ein.
9. Klicken Sie auf Anmelden.

Einrichten einer Aufgabe zum Extrahieren von Daten aus Snowflake

1. Folgen Sie den verknüpften Anweisungen, um einen neuen ETL-Workflow anzulegen.
2. Wählen Sie für Ihre Workflow-Aufgabe die Aufgabe Daten aus Snowflake extrahieren.
3. Wählen Sie das Snowflake-Konto aus, das Sie zuvor verbunden haben.
   
4. Klicken Sie auf Weiter.
5. Geben Sie die folgenden Informationen zu den Daten ein, die Sie aus Snowflake importieren möchten:
   
   • Dateinamensmuster: Eine Textzeichenfolge zur Identifizierung der zu importierenden Dateien.
     Tipp: Wir empfehlen, „Qualtrics“ am Anfang aller Dateien einzufügen, die Sie importieren möchten. Sie können dann „Qualtrics“ für dieses Feld eingeben, um alle relevanten Dateien zu importieren.
   • Abholverzeichnis: Das Snowflake-Verzeichnis, das die Dateien enthält.
     Tipp: Wenn sich die Datei in der Basisphase befindet, können Sie dieses Feld leer lassen.
   • Kontoidentifikator: Die Snowflake-Konto-ID der Datenbank, die die zu importierenden Dateien enthält.
   • Datenbank-ID: Die Snowflake-Datenbank-ID der Datenbank, die die zu importierenden Dateien enthält.
   • Schema-ID: Die Snowflake-Schema-ID des Schemas, das die zu importierende Datei enthält.
   • Stufenname: Der Name der Snowflake-Stufe, die die zu importierenden Dateien enthält.
6. Aktivieren Sie bei Bedarf Fehlerhafte Dateien überspringen. Wenn diese Option aktiviert ist, werden beschädigte Dateien und Dateien, die nicht mit Ihren Headern übereinstimmen, ignoriert.
7. Sie müssen eine Beispieldatei hochladen, die das allgemeine Format der Daten enthält, die Sie in Qualtrics importieren möchten. Klicken Sie auf Datei auswählen, und wählen Sie die Datei auf Ihrem Computer aus.
   Tipp: Bei Bedarf können Sie eine der im Aufgabenfenster aufgeführten Beispieldateien herunterladen.
8. Klicken Sie auf Hochladen.
9. Überprüfen Sie Ihre Beispieldatei, um sicherzustellen, dass alles korrekt aussieht.
   Tipp: Wenn Sie Ihre Datei ändern müssen, klicken Sie oben links auf Zurück.
10. Klicken Sie auf Speichern.
11. Wählen Sie Ihre Loader-Aufgabe, die bestimmt, wo die Daten gesichert werden. Weitere Informationen zu den Optionen, die Ihnen zur Verfügung stehen, finden Sie unter Verfügbare Loader-Aufgaben.