Dokumentation Experience Platform Användarhandbok om Source Connectors

Ultimate

Anslut Snowflake till Experience Platform med API:t Flow Service

Senast uppdaterad: 26 september 2025

Ämnen:

Skapat för:

Utvecklare

VIKTIGT

Källan Snowflake är tillgänglig i källkatalogen för användare som har köpt Real-Time Customer Data Platform Ultimate.

Läs den här vägledningen när du vill veta hur du kan ansluta ditt Snowflake-källkonto till Adobe Experience Platform med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med Experience Platform-tjänster.
Sandlådor: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Experience Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.

Använda Experience Platform API:er

Information om hur du kan anropa Experience Platform API:er finns i guiden Komma igång med Experience Platform API:er.

Följande avsnitt innehåller ytterligare information som du behöver känna till för att kunna ansluta till Snowflake med API:t Flow Service.

Samla in nödvändiga inloggningsuppgifter

Läs Snowflake översikten om du vill ha information om autentisering.

Anslut Snowflake till Experience Platform på Azure

VARNING

Grundläggande autentisering (eller kontonyckelautentisering) för källan Snowflake kommer att bli inaktuell i november 2025. Du måste gå över till nyckelparsbaserad autentisering för att kunna fortsätta använda källan och hämta data från din databas till Experience Platform. Mer information om borttagningen finns i Snowflake metodguiden om bästa praxis för att minska riskerna för kreditvärdighetsförluster.

Läs stegen nedan om du vill ha information om hur du ansluter din Snowflake-källa till Experience Platform på Azure.

OBSERVERA

Du måste ange flaggan PREVENT_UNLOAD_TO_INLINE_URL till FALSE för att tillåta dataradering från din Snowflake-databas till Experience Platform.

Skapa en basanslutning för Snowflake på Experience Platform på Azure

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skapar du en POST-begäran till /connections-slutpunkten och anger dina Snowflake-autentiseringsuppgifter som en del av begärandetexten.

API-format

POST /connections

ConnectionString

Begäran

Följande begäran skapar en basanslutning 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"
      }
  }'

Egenskap

Beskrivning

auth.params.connectionString

Anslutningssträngen som används för att ansluta till din Snowflake-instans. Anslutningssträngsmönstret för Snowflake är

jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}

.

connectionSpec.id

Anslutningsspecifikations-ID Snowflake: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Svar

Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika anslutnings-ID (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

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

Autentisering med nyckelpar med krypterad privat nyckel

Begäran

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

Egenskap

Beskrivning

auth.params.account

Namnet på ditt Snowflake-konto.

auth.params.username

Användarnamnet som är associerat med ditt Snowflake-konto.

auth.params.database

Databasen Snowflake från vilken data hämtas.

auth.params.privateKey

Den Base64-kodade krypterade privata nyckeln för ditt Snowflake-konto.

auth.params.privateKeyPassphrase

Lösenfrasen som motsvarar din privata nyckel.

auth.params.warehouse

Det Snowflake-lagerställe som du använder.

connectionSpec.id

Anslutningsspecifikations-ID Snowflake: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id).

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

Autentisering med nyckelpar med okrypterad privat nyckel

Begäran

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

Egenskap

Beskrivning

auth.params.account

Namnet på ditt Snowflake-konto.

auth.params.username

Användarnamnet som är associerat med ditt Snowflake-konto.

auth.params.database

Databasen Snowflake från vilken data hämtas.

auth.params.privateKey

Den Base64-kodade okrypterade privata nyckeln för ditt Snowflake-konto.

auth.params.warehouse

Det Snowflake-lagerställe som du använder.

connectionSpec.id

Anslutningsspecifikations-ID Snowflake: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id).

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

Anslut Snowflake till Experience Platform på Amazon Web Services (AWS)

AVAILABILITY

Detta avsnitt gäller implementeringar av Experience Platform som körs på Amazon Web Services (AWS). Experience Platform som körs på AWS är för närvarande tillgängligt för ett begränsat antal kunder. Mer information om den Experience Platform-infrastruktur som stöds finns i Experience Platform översikt över flera moln.

Läs stegen nedan om du vill ha information om hur du ansluter din Snowflake-källa till Experience Platform på AWS.

Skapa en basanslutning för Snowflake på Experience Platform i AWS

API-format

POST /connections

Grundläggande autentisering

Följande begäran skapar en basanslutning för Snowflake att importera data till Experience Platform på AWS:

Begäran

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

Egenskap

Beskrivning

auth.params.host

Den värd-URL som ditt Snowflake-konto ansluter till.

auth.params.port

Portnumret som används av Snowflake vid anslutning till en server via Internet.

auth.params.username

Användarnamnet som är associerat med ditt Snowflake-konto.

auth.params.database

Databasen Snowflake från vilken data hämtas.

auth.params.password

Lösenordet som är kopplat till ditt Snowflake-konto.

auth.params.warehouse

Det Snowflake-lagerställe som du använder.

auth.params.schema

Namnet på schemat som är associerat med din Snowflake-databas. Du måste se till att användaren som du vill ge databasåtkomst till också har åtkomst till det här schemat.

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id).

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

Autentisering med nyckelpar med okrypterad privat nyckel

Begäran

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

Egenskap

Beskrivning

auth.params.account

Namnet på ditt Snowflake-konto.

auth.params.username

Användarnamnet som är associerat med ditt Snowflake-konto.

auth.params.database

Databasen Snowflake från vilken data hämtas.

auth.params.privateKey

Den Base64-kodade okrypterade privata nyckeln för ditt Snowflake-konto.

auth.params.warehouse

Det Snowflake-lagerställe som du använder.

connectionSpec.id

Anslutningsspecifikations-ID Snowflake: b2e08744-4f1a-40ce-af30-7abac3e23cf3.

Svar

Ett lyckat svar returnerar information om den nyligen skapade anslutningen, inklusive dess unika identifierare (id).

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

Genom att följa den här självstudiekursen har du skapat en Snowflake-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

recommendation-more-help