Dokumentation Experience Platform Anleitung zu Quell-Connectoren

Ultimate

Verbinden von Snowflake mit Experience Platform mithilfe der Flow Service-API

Letzte Aktualisierung: 4. April 2025

Themen:

Erstellt für:

Entwickler

IMPORTANT

Die Snowflake ist im Quellkatalog für Benutzende verfügbar, die Real-Time Customer Data Platform Ultimate erworben haben.

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie Ihr Snowflake-Quellkonto mithilfe der Flow Service API) mit Adobe Experience Platform.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:

Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse entwickeln und weiterentwickeln können.

Verwenden von Experience Platform-APIs

Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.

Der folgende Abschnitt enthält zusätzliche Informationen, die Sie benötigen, um sich mithilfe der Flow Service-API erfolgreich mit Snowflake verbinden zu können.

Verbinden von Snowflake mit Experience Platform auf Azure

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihrer Snowflake mit Experience Platform auf Azure zu erhalten.

Sammeln erforderlicher Anmeldedaten

Sie müssen Werte für die folgenden Anmeldeinformationen angeben, um Ihre Snowflake zu authentifizieren.

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: `orgname-account_name`. Weitere Anleitungen finden Sie im Handbuch 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, müssen Sie ein 2048-Bit-RSA-Schlüsselpaar generieren und dann die folgenden Werte angeben, wenn Sie ein Konto für Ihre Snowflake erstellen.

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: `orgname-account_name`. 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 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 Handbuch unter Abrufen Snowflake privatenSchlüssels).
`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.
`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.

NOTE

Sie müssen das PREVENT_UNLOAD_TO_INLINE_URL-Flag auf FALSE setzen, um das Entladen von Daten aus Ihrer Snowflake in Experience Platform zu ermöglichen.

Erstellen einer Basisverbindung für Snowflake auf Experience Platform auf Azure

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Experience Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen ID der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt und geben Sie dabei Ihre Snowflake Authentifizierungsdaten als Teil des Anfragetexts an.

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Snowflake:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection",
      "description": "Snowflake base connection",
      "auth": {
          "specName": "ConnectionString",
          "params": {
              "connectionString": "jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}"
          }
      },
      "connectionSpec": {
          "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
          "version": "1.0"
      }
  }'

Eigenschaft

Beschreibung

auth.params.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}

.

connectionSpec.id

Die Spezifikations-ID der Snowflake-Verbindung: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Antwort

Eine erfolgreiche Antwort gibt die neu erstellte Verbindung zurück, einschließlich ihrer eindeutigen Verbindungskennung (id). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.

{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}

Anfrage

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection with encrypted private key",
      "description": "Snowflake base connection with encrypted private key",
      "auth": {
        "specName": "KeyPair Authentication",
        "params": {
            "account": "acme-snowflake123",
            "username": "acme-cj123",
            "database": "ACME_DB",
            "privateKey": "{BASE_64_ENCODED_PRIVATE_KEY}",
            "privateKeyPassphrase": "abcd1234",
            "warehouse": "COMPUTE_WH"
        }
    },
    "connectionSpec": {
        "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
        "version": "1.0"
    }
  }'

Eigenschaft

Beschreibung

auth.params.account

Der Name Ihres Snowflake.

auth.params.username

Der Benutzername, der Ihrem Snowflake-Konto zugeordnet ist.

auth.params.database

Die Snowflake Datenbank, aus der die Daten abgerufen werden.

auth.params.privateKey

Der Base64-verschlüsselte private Schlüssel Ihres Snowflake.

auth.params.privateKeyPassphrase

Die Passphrase, die Ihrem privaten Schlüssel entspricht.

auth.params.warehouse

Das Snowflake Warehouse, das Sie verwenden.

connectionSpec.id

Die Spezifikations-ID der Snowflake-Verbindung: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Antwort

Eine erfolgreiche Antwort gibt die neu erstellte Verbindung zurück, einschließlich ihrer eindeutigen Verbindungskennung (id). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.

{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}

Anfrage

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection with encrypted private key",
      "description": "Snowflake base connection with encrypted private key",
      "auth": {
        "specName": "KeyPair Authentication",
        "params": {
            "account": "acme-snowflake123",
            "username": "acme-cj123",
            "database": "ACME_DB",
            "privateKey": "{BASE_64_ENCODED_PRIVATE_KEY}",
            "warehouse": "COMPUTE_WH"
        }
    },
    "connectionSpec": {
        "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
        "version": "1.0"
    }
  }'

Eigenschaft

Beschreibung

auth.params.account

Der Name Ihres Snowflake.

auth.params.username

Der Benutzername, der Ihrem Snowflake-Konto zugeordnet ist.

auth.params.database

Die Snowflake Datenbank, aus der die Daten abgerufen werden.

auth.params.privateKey

Der Base64- unverschlüsselte private Schlüssel Ihres Snowflake.

auth.params.warehouse

Das Snowflake Warehouse, das Sie verwenden.

connectionSpec.id

Die Spezifikations-ID der Snowflake-Verbindung: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Antwort

Eine erfolgreiche Antwort gibt die neu erstellte Verbindung zurück, einschließlich ihrer eindeutigen Verbindungskennung (id). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.

{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}

Verbinden von Snowflake mit Experience Platform auf Amazon Web Services (AWS)

AVAILABILITY

Dieser Abschnitt gilt für Implementierungen von Experience Platform, die auf Amazon Web Services (AWS) ausgeführt werden. Experience Platform, das auf AWS ausgeführt wird, steht derzeit einer begrenzten Anzahl von Kunden zur Verfügung. Weitere Informationen zur unterstützten Experience Platform-Infrastruktur finden Sie in der Übersicht zur Experience Platform Multi-Cloud.

Lesen Sie die folgenden Schritte, um Informationen zum Verbinden Ihrer Snowflake mit Experience Platform auf AWS zu erhalten.

Erstellen einer Basisverbindung für Snowflake auf Experience Platform in AWS

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Snowflake, um das Datum in Experience Platform auf AWS aufzunehmen:

Beispiel auswählen, um es anzuzeigen

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Snowflake base connection for Experience Platform on AWS",
      "description": "Snowflake base connection for Experience Platform on AWS",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "acme.snowflakecomputing.com",
              "port": "443",
              "username": "acme-cj123",
              "password": "{PASSWORD}",
              "database": "ACME_DB",
              "warehouse": "COMPUTE_WH",
              "schema": "{SCHEMA}"
          }
      },
      "connectionSpec": {
          "id": "b2e08744-4f1a-40ce-af30-7abac3e23cf3",
          "version": "1.0"
      }
  }'

Eigenschaft

Beschreibung

auth.params.host

Die Host-URL, mit der sich Ihr Snowflake-Konto verbindet.

auth.params.port

Die Port-Nummer, die von Snowflake verwendet wird, wenn eine Verbindung zu einem Server über das Internet hergestellt wird.

auth.params.username

Der Benutzername, der Ihrem Snowflake-Konto zugeordnet ist.

auth.params.database

Die Snowflake Datenbank, aus der die Daten abgerufen werden.

auth.params.password

Das mit Ihrem Snowflake-Konto verknüpfte Kennwort.

auth.params.warehouse

Das Snowflake Warehouse, das Sie verwenden.

auth.params.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.

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id). Diese ID ist erforderlich, um Ihren -Speicher im nächsten Tutorial zu untersuchen.

Beispiel auswählen, um es anzuzeigen

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

In diesem Tutorial haben Sie eine Snowflake-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden:

recommendation-more-help