DokumentationExperience PlatformAnvändarhandbok om Source Connectors

[Ultimate]{class="badge positive"}

Anslut Snowflake till Experience Platform med API:t Flow Service

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

Skapat för:

  • Utvecklare
IMPORTANT
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 azure

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

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

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
accordion
Begäran

Följande begäran skapar en basanslutning 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
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.
accordion
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.

code language-json 
{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Autentisering med nyckelpar med krypterad privat nyckel
accordion
Begäran
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
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.
accordion
Svar

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

code language-json 
{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Autentisering med nyckelpar med okrypterad privat nyckel
accordion
Begäran
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
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.
accordion
Svar

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

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

Anslut Snowflake till Experience Platform på Amazon Web Services (AWS) 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 aws-base

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:

accordion
Begäran
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
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.
accordion
Svar

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

code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}
Autentisering med nyckelpar med okrypterad privat nyckel
accordion
Begäran
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
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.
accordion
Svar

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

code language-json 
{
    "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
337b99bb-92fb-42ae-b6b7-c7042161d089