Dokumentation Experience Platform Anleitung zu Quell-Connectoren

[Ultimate]{class="badge positive"}

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

Last update: Fri Sep 26 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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 Snowflake-API erfolgreich mit Flow Service verbinden zu können.

Sammeln erforderlicher Anmeldedaten

Informationen zur Authentifizierung Snowflake Sie inÜbersicht“.

Verbinden von Snowflake mit Experience Platform auf Azure azure

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.

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

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 azure-base

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

connectionString

accordion

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Snowflake:

code language-shell

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"
      }
  }'

table 0-row-2 1-row-2 2-row-2
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`.

accordion

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.

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

Schlüsselpaar-Authentifizierung mit verschlüsseltem privaten Schlüssel

accordion

Anfrage

code language-shell

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"
    }
  }'

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
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`.

accordion

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

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

Schlüsselpaar-Authentifizierung mit unverschlüsseltem privaten Schlüssel

accordion

Anfrage

code language-shell

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 unencrypted private key",
      "description": "Snowflake base connection with unencrypted 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"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
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`.

accordion

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

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

Verbinden von Snowflake mit Experience Platform auf Amazon Web Services (AWS) 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 aws-base

API-Format

POST /connections

Einfache Authentifizierung

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

accordion

Anfrage

code language-shell

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"
      }
  }'

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

accordion

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

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

Schlüsselpaar-Authentifizierung mit unverschlüsseltem privaten Schlüssel

accordion

Anfrage

code language-shell

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 unencrypted private key",
      "description": "Snowflake base connection with unencrypted 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"
    }
  }'

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
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`.

accordion

Antwort

Eine erfolgreiche Antwort gibt Details der neu erstellten Verbindung zurück, einschließlich ihrer eindeutigen Kennung (id).

code language-json
`{ "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

337b99bb-92fb-42ae-b6b7-c7042161d089