[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.

Snowflake is een gegevensopslagplatform in de cloud dat is ontworpen om organisaties in staat te stellen grote hoeveelheden gegevens efficiënt op te slaan, te verwerken en te analyseren. Snowflake is ontworpen om de schaalbaarheid en flexibiliteit van de cloud te benutten en ondersteunt gegevensintegratie, geavanceerde analyses en naadloze uitwisseling tussen teams. Als volledig beheerde dienst, Snowflake elimineert onderhoudsingewikkeldheid gemeenschappelijk voor traditionele gegevensbestanden, toelatend u om zich op het afleiden van inzichten en waarde van uw gegevens te concentreren.

U kunt de bron van Snowflake gebruiken om verbinding te maken en uw gegevens van Snowflake naar Adobe Experience Platform te brengen. Lees de onderstaande documentatie voor meer informatie over het instellen van de Snowflake -bron en het maken van verbinding met Experience Platform.

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: myorg-myaccount.snowflakecomputing.com . 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: myorg-myaccount.snowflakecomputing.com . 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: http://myorg-myaccount.snowflakecomputing.com/ . 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, aangezien u dit gebruikt om uw Snowflake -instantie op Experience Platform te verifiëren.

Uw account-id ophalen:

  • Gebruik het Snowflake dashboard van toepassingsUI ​ om tot uw rekening toegang te hebben.
  • Selecteer in de linkernavigatie Accounts en selecteer vervolgens 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.

RSA-sleutelpaar genereren

Gebruik OpenSSL in de interface van de bevellijn om een zeer belangrijk paar met 2048 bits RSA in formaat te produceren PKCS#8. Het is aan te raden een gecodeerde persoonlijke sleutel voor beveiliging te maken. Voor deze sleutel is een wachtwoordzin vereist.

produceer een gecodeerde privé sleutel

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

code language-bash
openssl genrsa 2048 | openssl pkcs8 -topk8 -v2 des3 -inform PEM -out rsa_key.p8# You will be prompted to enter a passphrase. Store this securely!
produceer 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-bash
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

Een openbare sleutel genereren op basis van uw persoonlijke sleutel

Voer vervolgens de volgende opdracht in uw opdrachtregelinterface uit om een openbare sleutel te maken op basis van uw persoonlijke sleutel.

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub# You will be prompted to enter the passphrase if the private key is encrypted.

De openbare sleutel toewijzen aan de gebruiker van Snowflake

U moet een Snowflake beheerderrol (als SECURITYADMIN) gebruiken om de geproduceerde openbare sleutel met de Snowflake de dienstgebruiker te associëren die Experience Platform zal gebruiken. Als u de inhoud van de openbare sleutel wilt ophalen, opent u het rsa_key.pub -bestand en kopieert u de volledige inhoud, met uitzondering van de -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- -regels. Voer vervolgens de volgende SQL uit in Snowflake :

ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';

De persoonlijke sleutel coderen in Base64

Experience Platform vereist dat de persoonlijke sleutel Base64-gecodeerd is en als een tekenreeks wordt opgegeven tijdens het instellen van de verbinding. Gebruik een geschikt gereedschap of script om de inhoud van het rsa_key.p8 -bestand te coderen in één Base64 -tekenreeks.

TIP
Zorg ervoor dat er voor of na het coderingsproces geen extra spaties of regeleinden zijn, inclusief de kop- of voettekstregels (-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----) , omdat dit verificatiefouten kan veroorzaken.

Configuraties verifiëren

Voordat u de Snowflake -bronverbinding maakt in Experience Platform, moet u ervoor zorgen dat de waarden Default Role en Default Warehouse van de gebruiker overeenkomen met die van uw provider in Experience Platform. U kunt deze instellingen verifiëren in de gebruikersinterface van Snowflake met de SQL-opdracht van DESCRIBE USER {USERNAME} .

U kunt ook de onderstaande stappen volgen om uw instellingen te controleren:

  • 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.

Volgende stappen

Nadat de installatie is voltooid, kunt u nu doorgaan om uw Snowflake -account aan te sluiten op Experience Platform. Raadpleeg de volgende documentatie voor meer informatie:

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