DocumentatieExperience PlatformGids voor Source Connectors

[Ultimate]{class="badge positive"}

Verbinding maken met Experience Platform via de Snowflake APIFlow Service

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
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 ​: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend Experience Platform diensten.
  • ​ Sandboxen ​: Experience Platform verstrekt virtuele zandbakken die één enkele Experience Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en 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.

Verbind Snowflake met Experience Platform op Azure azure

WARNING
De basisauthentificatie (of de authentificatie van de rekeningssleutel) voor Snowflake bron zal op November 2025 worden afgekeurd. U moet naar op sleutel-paar gebaseerde authentificatie bewegen om de bron te blijven gebruiken en gegevens van uw gegevensbestand in te voeren aan Experience Platform. Voor meer informatie over de veroudering, lees de Snowflake beste praktijkgids bij het verlichten van de risico's van credentieel compromis ​.

Lees de onderstaande stappen voor informatie over hoe u uw Snowflake -bron kunt verbinden met Experience Platform on 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 in 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
ConnectionString
accordion
Verzoek

Met de volgende aanvraag wordt een basisverbinding voor Snowflake gemaakt:

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
Eigenschap Beschrijving
auth.params.connectionString De verbindingstekenreeks die wordt gebruikt om verbinding te maken met de instantie Snowflake . Het patroon van de verbindingstekenreeks voor Snowflake is jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE} .
connectionSpec.id The Snowflake connection specification ID: b2e08744-4f1a-40ce-af30-7abac3e23cf3 .
accordion
Antwoord

Een succesvolle reactie keert de pas gecreëerde verbinding, met inbegrip van zijn unieke verbindings herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

code language-json 
{
    "id": "2fce94c1-9a93-4971-8e94-c19a93097129",
    "etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
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 The 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 The 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 The 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
337b99bb-92fb-42ae-b6b7-c7042161d089