Documentatie Experience Platform Gids voor Source Connectors

[Ultimate]{class="badge positive"}

Verbinding maken met Experience Platform via de Flow Service APISnowflake

Last update: Thu Jun 12 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.

Verbind Snowflake met Experience Platform op Azure azure

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

Vereiste referenties verzamelen

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.

U moet waarden opgeven voor de volgende referentie-eigenschappen om de Snowflake -bron te verifiëren.

de belangrijkste authentificatie van de Rekening

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
Credentials	Beschrijving
`account`	Een accountnaam vormt een unieke identificatie van een account binnen uw organisatie. In dit geval moet u een account op unieke wijze identificeren voor verschillende Snowflake -organisaties. Hiervoor moet u de naam van uw organisatie aan de accountnaam toevoegen. Bijvoorbeeld: `orgname-account_name` . Lees de gids bij het terugwinnen van uw Snowflake rekeningsherkenningstekenvoor extra begeleiding. Raadpleeg voor meer informatie de Snowflake documentatie.
`warehouse`	Het Snowflake pakhuis beheert het proces van de vraaguitvoering voor de toepassing. Elk Snowflake -pakhuis is onafhankelijk van elkaar en moet afzonderlijk worden benaderd wanneer u gegevens naar Experience Platform overbrengt.
`database`	De database Snowflake bevat de gegevens die u aan de Experience Platform wilt toevoegen.
`username`	De gebruikersnaam voor de Snowflake -account.
`password`	Het wachtwoord voor de Snowflake -gebruikersaccount.
`role`	De standaardtoegangsbeheerrol die in de Snowflake -sessie moet worden gebruikt. De rol zou een bestaande moeten zijn die reeds aan de gespecificeerde gebruiker is toegewezen. De standaardrol is `PUBLIC` .
`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}`

zeer belangrijk-paar authentificatie

Als u sleutelparverificatie wilt gebruiken, moet u een 2048-bits RSA-sleutelpaar genereren en de volgende waarden opgeven wanneer u een account voor uw Snowflake -bron maakt.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Credentials	Beschrijving
`account`	Een accountnaam vormt een unieke identificatie van een account binnen uw organisatie. In dit geval moet u een account op unieke wijze identificeren voor verschillende Snowflake -organisaties. Hiervoor moet u de naam van uw organisatie aan de accountnaam toevoegen. Bijvoorbeeld: `orgname-account_name` . Lees de gids bij het terugwinnen van uw Snowflake rekeningsherkenningstekenvoor extra begeleiding. Raadpleeg voor meer informatie de Snowflake documentatie.
`username`	De gebruikersnaam van uw Snowflake -account.
`privateKey`	De Base64- gecodeerde privé sleutel van uw Snowflake rekening. U kunt gecodeerde of niet-gecodeerde persoonlijke sleutels genereren. Als u een gecodeerde persoonlijke sleutel gebruikt, moet u ook een persoonlijke-sleutelwachtwoord opgeven bij verificatie met behulp van Experience Platform. Lees de gids op het terugwinnen van uw Snowflake privé sleutelvoor meer informatie.
`privateKeyPassphrase`	Persoonlijke sleutel passphrase is een extra laag van veiligheid die u moet gebruiken wanneer het voor authentiek verklaren met een gecodeerde privé sleutel. U hoeft de wachtwoordzin niet op te geven als u een niet-gecodeerde persoonlijke sleutel gebruikt.
`database`	De Snowflake -database die de gegevens bevat die u aan Experience Platform wilt toevoegen.
`warehouse`	Het Snowflake pakhuis beheert het proces van de vraaguitvoering voor de toepassing. Elk Snowflake -pakhuis is onafhankelijk van elkaar en moet afzonderlijk worden benaderd wanneer u gegevens naar Experience Platform overbrengt.

Voor meer informatie over deze waarden, verwijs de Snowflake sleutel-paar authentificatiegids.

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

Response

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

Response

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

Response

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

Verzoek

Met de volgende aanvraag wordt een basisverbinding gemaakt voor Snowflake om datum in te voeren naar Experience Platform op AWS:

Selecteren om voorbeeld weer te geven

code language-shell

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

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.

Reactie

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug. Deze id is vereist om uw opslag te verkennen in de volgende zelfstudie.

Selecteren om voorbeeld weer te geven

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