[Ultimate]{class="badge positive"}
Snowflake
- Die Snowflake ist im Quellkatalog für Benutzende verfügbar, die Real-Time Customer Data Platform Ultimate erworben haben.
- Standardmäßig interpretiert die Snowflake-Quelle
nullals leere Zeichenfolge. Wenden Sie sich an den Adobe-Support-Mitarbeiter, um sicherzustellen, dass Ihrenullwienullin Adobe Experience Platform geschrieben sind. - Damit Experience Platform Daten aufnehmen kann, müssen die Zeitzonen für alle tabellenbasierten Batch-Quellen als UTC konfiguriert werden. Der einzige Zeitstempel, der für die Snowflake-Quelle unterstützt wird, ist TIMESTAMP_NTZ mit UTC-Zeit.
Snowflake ist eine Cloud-basierte Data Warehouse-Plattform, mit der Unternehmen große Datenmengen effizient speichern, verarbeiten und analysieren können. Entwickelt für die Nutzung der Skalierbarkeit und Flexibilität der Cloud, unterstützt Snowflake die Datenintegration, erweiterte Analysen und die nahtlose gemeinsame Nutzung durch Teams. Als vollständig verwalteter Service eliminiert Snowflake komplexe Wartungsaufgaben, die mit herkömmlichen Datenbanken verbunden sind, und ermöglicht es Ihnen, sich auf die Ermittlung von Insights und Nutzen aus Ihren Daten zu konzentrieren.
Sie können die Snowflake verwenden, um eine Verbindung herzustellen und Ihre Daten von Snowflake in Adobe Experience Platform einzubringen. Lesen Sie die folgende Dokumentation, um zu erfahren, wie Sie Ihre Snowflake einrichten und eine Verbindung zu Experience Platform herstellen.
Voraussetzungen prerequisites
In diesem Abschnitt werden die Einrichtungsaufgaben beschrieben, die Sie ausführen müssen, bevor Sie Ihre Snowflake mit Experience Platform verbinden können.
Zulassungsliste von IP-Adressen
Sie müssen Ihrer Zulassungsliste regionsspezifische IP-Adressen hinzufügen, bevor Sie Ihre Quellen mit Experience Platform verbinden. Weitere Informationen finden Sie im Handbuch unter Zulassungsauflistung von IP-Adressen für die Verbindung mit Experience Platform .
Sammeln erforderlicher Anmeldedaten
Sie müssen Werte für die folgenden Anmeldeinformationen angeben, um Ihre Snowflake zu authentifizieren.
Geben Sie Werte für die folgenden Anmeldeinformationen an, um Snowflake mithilfe der Kontoschlüsselauthentifizierung mit Experience Platform auf Azure zu verbinden.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Anmeldedaten | Beschreibung |
account |
Ein Kontoname identifiziert ein Konto innerhalb Ihrer Organisation eindeutig. In diesem Fall müssen Sie ein Konto über verschiedene Snowflake hinweg eindeutig identifizieren. Dazu müssen Sie dem Kontonamen den Namen Ihres Unternehmens voranstellen. Beispiel: myorg-myaccount.snowflakecomputing.com. Weitere Anleitungen finden Sie im Abschnitt Abrufen Snowflake Kontokennung . Weiterführende Informationen dazu finden Sie im Snowflake entsprechenden Handbuch. |
warehouse |
Das Snowflake Warehouse verwaltet den Abfrageausführungsprozess für das Programm. Jedes Snowflake Warehouse ist unabhängig voneinander und muss beim Übermitteln von Daten an Experience Platform einzeln aufgerufen werden. |
database |
Die Snowflake-Datenbank enthält die Daten, die Sie mit der Experience Platform verknüpfen möchten. |
username |
Der Benutzername für das Snowflake. |
password |
Das Kennwort für das Snowflake Benutzerkonto. |
role |
Die in der Snowflake-Sitzung zu verwendende standardmäßige Zugriffssteuerungsrolle. Die Rolle sollte eine vorhandene sein, die dem angegebenen Benutzer bereits zugewiesen wurde. Die Standardrolle ist PUBLIC. |
connectionString |
Die Verbindungszeichenfolge, die für die Verbindung mit Ihrer Snowflake-Instanz verwendet wird. Das Verbindungszeichenfolgenmuster für Snowflake ist jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}. |
Um die Schlüsselpaar-Authentifizierung zu verwenden, generieren Sie zunächst ein 2048-Bit-RSA-Schlüsselpaar. Geben Sie als Nächstes Werte für die folgenden Anmeldeinformationen an, um mithilfe der Schlüsselpaar-Authentifizierung eine Verbindung zu Experience Platform auf Azure herzustellen.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Anmeldedaten | Beschreibung |
account |
Ein Kontoname identifiziert ein Konto innerhalb Ihrer Organisation eindeutig. In diesem Fall müssen Sie ein Konto über verschiedene Snowflake hinweg eindeutig identifizieren. Dazu müssen Sie dem Kontonamen den Namen Ihres Unternehmens voranstellen. Beispiel: myorg-myaccount.snowflakecomputing.com. Weitere Anleitungen finden Sie im Abschnitt Abrufen Snowflake Kontokennung . Weiterführende Informationen dazu finden Sie im Snowflake entsprechenden Handbuch. |
username |
Der Benutzername Ihres Snowflake. |
privateKey |
Der Base64-kodierte private Schlüssel Ihres Snowflake. Sie können entweder verschlüsselte oder unverschlüsselte private Schlüssel generieren. Wenn Sie einen verschlüsselten privaten Schlüssel verwenden, müssen Sie auch eine Passphrase für den privaten Schlüssel angeben, wenn Sie sich bei Experience Platform authentifizieren. Weitere Informationen finden Sie im Abschnitt Abrufen Ihres privaten ". |
privateKeyPassphrase |
Die Passphrase für den privaten Schlüssel ist eine zusätzliche Sicherheitsebene, die Sie bei der Authentifizierung mit einem verschlüsselten privaten Schlüssel verwenden müssen. Sie müssen die Passphrase nicht angeben, wenn Sie einen unverschlüsselten privaten Schlüssel verwenden. |
port |
Die Port-Nummer, die von Snowflake verwendet wird, wenn eine Verbindung zu einem Server über das Internet hergestellt wird. |
database |
Die Snowflake, die die Daten enthält, die in Experience Platform aufgenommen werden sollen. |
warehouse |
Das Snowflake Warehouse verwaltet den Abfrageausführungsprozess für das Programm. Jedes Snowflake Warehouse ist unabhängig voneinander und muss beim Übermitteln von Daten an Experience Platform einzeln aufgerufen werden. |
Weitere Informationen zu diesen Werten finden Sie im Snowflake Handbuch zur Schlüsselpaar-Authentifizierung.
Geben Sie Werte für die folgenden Anmeldeinformationen an, um Snowflake unter Verwendung der Standardauthentifizierung mit Experience Platform auf AWS zu verbinden.
| note warning |
|---|
| WARNING |
| Die Standardauthentifizierung (oder Kontoschlüsselauthentifizierung) für die Snowflake wird ab November 2025 eingestellt. Sie müssen zur schlüsselpaarbasierten Authentifizierung wechseln, um weiterhin die -Quelle verwenden und Daten aus Ihrer -Datenbank in Experience Platform aufnehmen zu können. Weitere Informationen zur Einstellung finden Sie im Snowflake Handbuch mit Best Practices zum Minimieren der Risiken durch das Kompromittieren von Anmeldeinformationen. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 | |
|---|---|
| Anmeldedaten | Beschreibung |
host |
Die Host-URL, mit der sich Ihr Snowflake-Konto verbindet. |
port |
Die Port-Nummer, die von Snowflake verwendet wird, wenn eine Verbindung zu einem Server über das Internet hergestellt wird. |
username |
Der Benutzername, der Ihrem Snowflake-Konto zugeordnet ist. |
password |
Das mit Ihrem Snowflake-Konto verknüpfte Kennwort. |
database |
Die Snowflake Datenbank, aus der die Daten abgerufen werden. |
schema |
Der Name des Schemas, das Ihrer Snowflake-Datenbank zugeordnet ist. Sie müssen sicherstellen, dass der Benutzer, dem Sie Datenbankzugriff gewähren möchten, auch Zugriff auf dieses Schema hat. |
warehouse |
Das Snowflake Warehouse, das Sie verwenden. |
Um die Schlüsselpaar-Authentifizierung zu verwenden, generieren Sie zunächst ein 2048-Bit-RSA-Schlüsselpaar. Geben Sie als Nächstes Werte für die folgenden Anmeldeinformationen an, um mithilfe der Schlüsselpaar-Authentifizierung eine Verbindung zu Experience Platform auf AWS herzustellen.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Anmeldedaten | Beschreibung |
account |
Ein Kontoname identifiziert ein Konto innerhalb Ihrer Organisation eindeutig. In diesem Fall müssen Sie ein Konto über verschiedene Snowflake hinweg eindeutig identifizieren. Dazu müssen Sie dem Kontonamen den Namen Ihres Unternehmens voranstellen. Beispiel: http://myorg-myaccount.snowflakecomputing.com/. Weitere Anleitungen finden Sie im Handbuch Abrufen Snowflake Kontokennung . Weiterführende Informationen dazu finden Sie im Snowflake entsprechenden Handbuch. |
username |
Der Benutzername Ihres Snowflake. |
privateKey |
Der private Schlüssel für Ihren Snowflake-Benutzer, base64-kodiert als einzelne Zeile ohne Kopfzeilen oder Zeilenumbrüche. Zur Vorbereitung kopieren Sie den Inhalt Ihrer PEM-Datei, entfernen Sie die BEGIN/END Zeilen und alle Zeilenumbrüche, und kodieren Sie dann das Ergebnis mit base64. Weitere Informationen finden Sie im Abschnitt Abrufen Ihres privaten ". Hinweis: Verschlüsselte private Schlüssel werden derzeit für eine AWS-Verbindung nicht unterstützt. |
port |
Die Port-Nummer, die von Snowflake verwendet wird, wenn eine Verbindung zu einem Server über das Internet hergestellt wird. |
database |
Die Snowflake, die die Daten enthält, die in Experience Platform aufgenommen werden sollen. |
warehouse |
Das Snowflake Warehouse verwaltet den Abfrageausführungsprozess für das Programm. Jedes Snowflake Warehouse ist unabhängig voneinander und muss beim Übermitteln von Daten an Experience Platform einzeln aufgerufen werden. |
Weitere Informationen zu diesen Werten finden Sie im Snowflake Handbuch zur Schlüsselpaar-Authentifizierung.
Kontokennung abrufen retrieve-your-account-identifier
Sie müssen Ihre Kontokennung vom Dashboard der Snowflake-Benutzeroberfläche abrufen, da Sie sie zur Authentifizierung Ihrer Snowflake auf Experience Platform verwenden werden.
So rufen Sie Ihre Kontokennung ab:
- Verwenden Sie das Snowflake Anwendungs-UI-Dashboard, um auf Ihr Konto zuzugreifen.
- Wählen Sie in der linken Navigation Accounts und anschließend Active Accounts aus der Kopfzeile aus.
- Klicken Sie anschließend auf das Informationssymbol und wählen Sie den Domain-Namen der aktuellen URL aus und kopieren Sie ihn.
Erzeugen des RSA-Schlüsselpaars
Verwenden Sie OpenSSL in der Befehlszeilenschnittstelle, um ein 2048-Bit-RSA-Schlüsselpaar im PKCS#8-Format zu generieren. Es empfiehlt sich, einen verschlüsselten privaten Schlüssel für die Sicherheit zu erstellen, wofür eine Passphrase erforderlich ist.
Um Ihren verschlüsselten Snowflake privaten Schlüssel zu generieren, führen Sie den folgenden Befehl auf Ihrem Terminal aus:
| code language-bash |
|---|
|
Um Ihren unverschlüsselten Snowflake privaten Schlüssel zu generieren, führen Sie den folgenden Befehl auf Ihrem Terminal aus:
| code language-bash |
|---|
|
Generieren eines öffentlichen Schlüssels aus Ihrem privaten Schlüssel
Führen Sie als Nächstes den folgenden Befehl in Ihrer Befehlszeilenschnittstelle aus, um einen öffentlichen Schlüssel basierend auf Ihrem privaten Schlüssel zu erstellen.
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub# You will be prompted to enter the passphrase if the private key is encrypted.
Weisen Sie den öffentlichen Schlüssel dem Snowflake Benutzer zu
Sie müssen eine Snowflake Administratorrolle verwenden (z. B SECURITYADMIN), um den generierten öffentlichen Schlüssel mit dem Snowflake Service-Benutzer zu verknüpfen, den Experience Platform verwenden wird. Um den Inhalt des öffentlichen Schlüssels abzurufen, öffnen Sie die rsa_key.pub und kopieren Sie den gesamten Inhalt mit Ausnahme der -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY-----. Führen Sie als Nächstes die folgende SQL in Snowflake aus:
ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';
Codieren des privaten Schlüssels in Base64
Experience Platform erfordert, dass der private Schlüssel Base64 codiert ist und bei der Einrichtung der Verbindung als Zeichenfolge bereitgestellt wird. Verwenden Sie ein geeignetes Tool oder Skript, um den Inhalt der rsa_key.p8-Datei in eine einzelne Base64-Zeichenfolge zu kodieren.
(-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----) Kopf-/Fußzeilen, da dies zu Authentifizierungsfehlern führen kann.Überprüfen von Konfigurationen
Bevor Sie die Snowflake-Quellverbindung in Experience Platform erstellen, müssen Sie sicherstellen, dass die Default Role und Default Warehouse der Benutzenden mit den Werten übereinstimmen, die Sie in Experience Platform angeben. Sie können diese Einstellungen in der Snowflake-Benutzeroberfläche mit dem DESCRIBE USER {USERNAME} SQL-Befehl überprüfen.
Alternativ können Sie die folgenden Schritte ausführen, um Ihre Einstellungen zu überprüfen:
- Wählen Sie in der linken Navigationsleiste Admin und dann Users & Roles aus.
- Wählen Sie den entsprechenden Benutzer aus und klicken Sie dann oben rechts auf die Auslassungspunkte (
...). - Navigieren Sie im sich öffnenden Edit user zu Default Role, um die Rolle anzuzeigen, die dem jeweiligen Benutzer zugeordnet ist.
- Navigieren Sie im selben Fenster zu Default Warehouse , um das mit dem jeweiligen Benutzer verknüpfte Warehouse anzuzeigen.
Nächste Schritte
Nachdem Sie die Einrichtung abgeschlossen haben, können Sie nun mit dem Verbinden Ihres Snowflake-Kontos mit Experience Platform fortfahren. Weitere Informationen finden Sie in der folgenden Dokumentation: