[Ultimate]{class="badge positive"}

Snowflake bron

IMPORTANT
  • De Snowflake -bron is in de broncatalogus beschikbaar voor gebruikers die Real-Time Customer Data Platform Ultimate hebben aangeschaft.
  • Standaard wordt Snowflake source null geïnterpreteerd als een lege tekenreeks. Neem contact op met uw Adobe-vertegenwoordiger om ervoor te zorgen dat de null -waarden correct worden geschreven zoals null in Adobe Experience Platform.
  • Experience Platform kan alleen gegevens invoeren als tijdzones voor alle batchbronnen op basis van tabellen zijn geconfigureerd voor UTC. Het enige tijdstempel dat wordt ondersteund voor de Snowflake -bron is TIMESTAMP_NTZ met UTC-tijd.

Adobe Experience Platform staat toe dat gegevens uit externe bronnen worden opgenomen en biedt u de mogelijkheid om inkomende gegevens te structureren, labelen en verbeteren met behulp van Experience Platform-services. U kunt gegevens invoeren uit verschillende bronnen, zoals Adobe-toepassingen, opslag in de cloud, databases en vele andere.

Experience Platform biedt ondersteuning voor het opnemen van gegevens uit een database van derden. Experience Platform kan verbinding maken met verschillende typen databases, zoals relationele databases, NoSQL-databases of gegevensopslagruimten. Ondersteuning voor databaseproviders is onder andere Snowflake .

Vereisten prerequisites

In deze sectie worden de instellingstaken beschreven die u moet uitvoeren voordat u de Snowflake -bron kunt verbinden met Experience Platform.

IP adres lijst van gewenste personen

U moet gebied-specifieke IP adressen aan uw lijst van gewenste personen toevoegen alvorens uw bronnen aan Experience Platform aan te sluiten. Voor meer informatie, lees de gids op ​ voegend op lijst van gewenste personen IP adressen om met Experience Platform ​ voor meer informatie te verbinden.

Vereiste referenties verzamelen

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

de zeer belangrijke authentificatie van de Rekening (Azure)

Geef waarden op voor de volgende gebruikersgegevens om Snowflake in Azure te verbinden met Experience Platform met behulp van accountsleutelverificatie.

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 sectie op ​ het terugwinnen van uw Snowflake rekeningsherkenningsteken ​ voor 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 (Azure)

Om zeer belangrijk-paarauthentificatie te gebruiken, produceer eerst een zeer belangrijk paar met 2048 bits RSA. Geef vervolgens waarden op voor de volgende gebruikersgegevens om in Azure verbinding te maken met Experience Platform met behulp van sleutelparverificatie.

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 sectie op ​ het terugwinnen van uw Snowflake rekeningsherkenningsteken ​ voor 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 sectie op ​ het terugwinnen van uw privé sleutel ​ voor 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.
port Het poortnummer dat door Snowflake wordt gebruikt wanneer verbinding wordt gemaakt met een server via internet.
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 ​.

Basisauthentificatie (AWS)

Geef waarden op voor de volgende aanmeldingsgegevens om via basisverificatie verbinding te maken met Experience Platform op AWS. Snowflake

note warning
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 ​.
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
host De host-URL waarmee uw Snowflake -account verbinding maakt.
port Het poortnummer dat door Snowflake wordt gebruikt wanneer verbinding wordt gemaakt met een server via internet.
username De gebruikersnaam die aan uw Snowflake -account is gekoppeld.
password Het wachtwoord dat aan uw Snowflake account is gekoppeld.
database De Snowflake -database vanwaar de gegevens worden opgehaald.
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.
warehouse Het Snowflake -pakhuis dat u gebruikt.
zeer belangrijk-paar authentificatie (AWS)

Om zeer belangrijk-paarauthentificatie te gebruiken, produceer eerst een zeer belangrijk paar met 2048 bits RSA. Geef vervolgens waarden op voor de volgende gebruikersgegevens om verbinding te maken met Experience Platform op AWS met behulp van sleutelparverificatie.

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 rekeningsherkenningsteken ​ voor extra begeleiding. Raadpleeg voor meer informatie de Snowflake documentatie.
username De gebruikersnaam van uw Snowflake -account.
privateKey De persoonlijke sleutel voor uw Snowflake -gebruiker, base64-gecodeerd als één regel zonder kopteksten of regeleinden. Als u het bestand wilt voorbereiden, kopieert u de inhoud van het PEM-bestand, verwijdert u de BEGIN/END -regels en alle regeleinden en codeert u het resultaat met base64. Lees de sectie op ​ het terugwinnen van uw privé sleutel ​ voor meer informatie. Nota: Gecodeerde privé sleutels worden momenteel niet gesteund voor een verbinding van AWS.
port Het poortnummer dat door Snowflake wordt gebruikt wanneer verbinding wordt gemaakt met een server via internet.
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 ​.

Uw account-id ophalen retrieve-your-account-identifier

U moet uw account-id ophalen van het Snowflake UI-dashboard omdat u de account-id gebruikt om uw Snowflake -instantie op Experience Platform te verifiëren.

Uw account-id ophalen:

  • Navigeer aan uw rekening op het Snowflake toepassingsUI dashboard ​.
  • Selecteer in de linkernavigatie Accounts , gevolgd door Active Accounts in de koptekst.
  • Selecteer vervolgens het informatiepictogram en selecteer en kopieer de domeinnaam van de huidige URL.

het dashboard van Snowflake UI met de geselecteerde domeinnaam.

Persoonlijke sleutel ophalen retrieve-your-private-key

Als u sleutelparverificatie gebruikt voor uw Snowflake -verbinding, moet u ook uw persoonlijke sleutel genereren voordat u verbinding maakt met Experience Platform.

creeer een gecodeerde privé sleutel

Voer de volgende opdracht op uw terminal uit om de gecodeerde Snowflake persoonlijke sleutel te genereren:

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 des3 -inform PEM -out rsa_key.p8

Als dit lukt, ontvangt u de persoonlijke sleutel in de PEM-indeling.

code language-shell
-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIE6T...
-----END ENCRYPTED PRIVATE KEY-----
creeer een niet gecodeerde privé sleutel

Als u de niet-gecodeerde Snowflake persoonlijke sleutel wilt genereren, voert u de volgende opdracht uit op uw terminal:

code language-shell
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

Als dit lukt, ontvangt u de persoonlijke sleutel in de PEM-indeling.

code language-shell
-----BEGIN PRIVATE KEY-----
MIIE6T...
-----END PRIVATE KEY-----

Neem vervolgens uw persoonlijke sleutel en codeer deze in Base64 . Zorg ervoor dat u geen transformaties of opmaakconversies uitvoert op de persoonlijke sleutel van Snowflake . Bovendien moet u ervoor zorgen dat er geen navolgende nieuwe-regeltekens aan het einde van de persoonlijke sleutel staan voordat u deze codeert in Base64 .

Configuraties verifiëren

Voordat u een bronverbinding voor uw Snowflake gegevens kunt maken, moet u ook controleren of aan de volgende configuraties is voldaan:

  • Het standaardpakhuis dat aan een bepaalde gebruiker wordt toegewezen moet het zelfde zijn als het pakhuis dat u wanneer het voor authentiek verklaren aan Experience Platform invoert.
  • De standaardrol die aan een bepaalde gebruiker wordt toegewezen moet toegang tot het zelfde gegevensbestand hebben dat u wanneer het voor authentiek verklaren aan Experience Platform invoert.

Om uw rol en pakhuis te verifiëren:

  • Selecteer Admin in de linkernavigatie en selecteer vervolgens Users & Roles .
  • Selecteer de juiste gebruiker en selecteer vervolgens de ellipsen (...) in de rechterbovenhoek.
  • Navigeer in het Edit user -venster dat wordt weergegeven naar Default Role om de rol weer te geven die aan de opgegeven gebruiker is gekoppeld.
  • Navigeer in hetzelfde venster naar Default Warehouse om het pakhuis weer te geven dat aan de opgegeven gebruiker is gekoppeld.

Snowflake UI waar u uw rol en pakhuis kunt verifiëren.

Nadat de codering is voltooid, kunt u die Base64 gecodeerde persoonlijke sleutel op Experience Platform gebruiken om uw Snowflake -account te verifiëren.

In de onderstaande documentatie vindt u informatie over het tot stand brengen van een verbinding tussen Snowflake en Experience Platform via API's of de gebruikersinterface:

Verbinding maken Snowflake met Experience Platform via API's

Verbinding maken Snowflake met Experience Platform via de gebruikersinterface

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089