Documentatie Experience Platform Gids voor Source Connectors

Ultimate

Verbinding maken met Experience Platform via de Flow Service APISnowflake

Laatst bijgewerkt: 6 maart 2025

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 Platform diensten.
Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met 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

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

Vereiste referenties verzamelen

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

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 Platform overbrengt.
`database`	De Snowflake -database bevat de gegevens die u voor het platform wilt gebruiken.
`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}`

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.

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

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat 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

verzoek

Met de volgende aanvraag wordt een basisverbinding voor Snowflake gemaakt:

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

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 .

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.

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

zeer belangrijk-paar authentificatie met gecodeerde privé sleutel

verzoek

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

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 .

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.

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

zeer belangrijk-paar authentificatie met niet gecodeerde privé sleutel

verzoek

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

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 .

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.

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

Verbinding maken Snowflake met Experience Platform op Amazon Web Services (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

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

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

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

{
    "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