DocumentatieExperience PlatformHandleiding Source-connectors

[Ultimate]{class="badge positive"}

Verbinding maken met Experience Platform via de Flow Service APISnowflake

Laatst bijgewerkt: 24 mei 2026

Gemaakt voor:

  • Developer
IMPORTANT
De Snowflake -bron is in de broncatalogus beschikbaar voor gebruikers die Real-Time Customer Data Platform Ultimate hebben aangeschaft.

Lees deze gids om te leren hoe u uw Snowflake bronrekening met Adobe Experience Platform kunt verbinden gebruikend Flow Service API ​.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • ​ Bronnen ​: Met Experience Platform kunt u gegevens uit verschillende bronnen invoegen en binnenkomende gegevens structureren, labelen en verbeteren met Experience Platform -services.
  • ​ Sandboxes ​: Experience Platform biedt virtuele sandboxen die één Experience Platform -instantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.

Experience Platform API’s gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op ​ begonnen wordt met Experience Platform APIs ​.

In de volgende sectie vindt u aanvullende informatie die u moet weten als u verbinding wilt maken met Snowflake via de Flow Service API.

Vereiste referenties verzamelen

Lees het Snowflake overzicht ​ voor informatie over authentificatie.

Verbinden Snowflake met Experience Platform op Azure azure

Lees de onderstaande stappen voor informatie over hoe u uw Snowflake -bron kunt verbinden met Experience Platform op Azure.

NOTE
U moet de markering PREVENT_UNLOAD_TO_INLINE_URL instellen op FALSE om gegevens uit uw Snowflake -database te kunnen verwijderen naar Experience Platform.

Een basisverbinding maken voor Snowflake op Experience Platform op Azure azure-base

Een basisverbinding behoudt informatie tussen uw bron en Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST-aanvraag naar het /connections -eindpunt en geeft u de Snowflake -verificatiegegevens op als onderdeel van de aanvraagprocedure.

API formaat

POST /connections
zeer belangrijk-paar authentificatie met gecodeerde privé sleutel
accordion
Verzoek
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
Eigenschap Beschrijving
auth.params.account De naam van uw Snowflake account.
auth.params.username De gebruikersnaam die aan uw Snowflake -account is gekoppeld.
auth.params.database De Snowflake -database vanwaar de gegevens worden opgehaald.
auth.params.privateKey De Base64- gecodeerde gecodeerde gecodeerde privé sleutel van uw Snowflake rekening.
auth.params.privateKeyPassphrase De passphrase die met uw privé sleutel beantwoordt.
auth.params.warehouse Het Snowflake -pakhuis dat u gebruikt.
connectionSpec.id De Snowflake connection specification-id: b2e08744-4f1a-40ce-af30-7abac3e23cf3 .
accordion
Antwoord

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

code language-json 
{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
zeer belangrijk-paar authentificatie met niet gecodeerde privé sleutel
accordion
Verzoek
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
Eigenschap Beschrijving
auth.params.account De naam van uw Snowflake account.
auth.params.username De gebruikersnaam die aan uw Snowflake -account is gekoppeld.
auth.params.database De Snowflake -database vanwaar de gegevens worden opgehaald.
auth.params.privateKey De Base64- gecodeerde niet gecodeerde privé sleutel van uw Snowflake rekening.
auth.params.warehouse Het Snowflake -pakhuis dat u gebruikt.
connectionSpec.id De Snowflake connection specification-id: b2e08744-4f1a-40ce-af30-7abac3e23cf3 .
accordion
Antwoord

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

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

Verbinding maken Snowflake met Experience Platform op Amazon Web Services (AWS) aws

AVAILABILITY
Deze sectie is van toepassing op implementaties van Experience Platform die op Amazon Web Services (AWS) worden uitgevoerd. Experience Platform die op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van Experience Platform leren, zie het ​ multi-wolkenoverzicht van Experience Platform ​.

Lees de onderstaande stappen voor informatie over hoe u uw Snowflake -bron kunt verbinden met Experience Platform op AWS.

Een basisverbinding maken voor Snowflake op Experience Platform in AWS aws-base

API formaat

POST /connections
Basisauthentificatie

Met de volgende aanvraag wordt een basisverbinding voor Snowflake gemaakt voor het invoeren van gegevens naar Experience Platform op AWS:

accordion
Verzoek
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
Eigenschap Beschrijving
auth.params.host De host-URL waarmee uw Snowflake -account verbinding maakt.
auth.params.port Het poortnummer dat door Snowflake wordt gebruikt wanneer verbinding wordt gemaakt met een server via internet.
auth.params.username De gebruikersnaam die aan uw Snowflake -account is gekoppeld.
auth.params.database De Snowflake -database vanwaar de gegevens worden opgehaald.
auth.params.password Het wachtwoord dat aan uw Snowflake account is gekoppeld.
auth.params.warehouse Het Snowflake -pakhuis dat u gebruikt.
auth.params.schema De naam van het schema dat aan uw Snowflake database is gekoppeld. U moet ervoor zorgen dat de gebruiker u gegevensbestandtoegang tot wilt geven, ook toegang tot dit schema heeft.
accordion
Antwoord

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}
zeer belangrijk-paar authentificatie met niet gecodeerde privé sleutel
accordion
Verzoek
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
Eigenschap Beschrijving
auth.params.account De naam van uw Snowflake account.
auth.params.username De gebruikersnaam die aan uw Snowflake -account is gekoppeld.
auth.params.database De Snowflake -database vanwaar de gegevens worden opgehaald.
auth.params.privateKey De Base64- gecodeerde niet gecodeerde privé sleutel van uw Snowflake rekening.
auth.params.warehouse Het Snowflake -pakhuis dat u gebruikt.
connectionSpec.id De Snowflake connection specification-id: b2e08744-4f1a-40ce-af30-7abac3e23cf3 .
accordion
Antwoord

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

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

Aan de hand van deze zelfstudie hebt u een Snowflake basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help
experience-platform-help-sources