[Ultimate]{class="badge positive"}
Origine Snowflake
- L'origine Snowflake è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-Time Customer Data Platform Ultimate.
- Per impostazione predefinita, l'origine Snowflake interpreta
nullcome una stringa vuota. Contatta il tuo rappresentante Adobe per assicurarti che i valorinullsiano scritti correttamente comenullin Adobe Experience Platform. - Affinché Experience Platform possa acquisire i dati, i fusi orari per tutte le origini batch basate su tabelle devono essere configurati in formato UTC. L'unico indicatore orario supportato per l'origine Snowflake è TIMESTAMP_NTZ con ora UTC.
Snowflake è una piattaforma di data warehouse basata su cloud progettata per consentire alle organizzazioni di archiviare, elaborare e analizzare grandi volumi di dati in modo efficiente. Progettato per sfruttare la scalabilità e la flessibilità del cloud, Snowflake supporta l'integrazione dei dati, l'analisi avanzata e la condivisione senza soluzione di continuità tra i team. In qualità di servizio completamente gestito, Snowflake elimina le complessità di manutenzione comuni ai database tradizionali, consentendo di concentrarsi su informazioni approfondite e valore dai dati.
È possibile utilizzare l'origine Snowflake per connettersi e trasferire i dati da Snowflake a Adobe Experience Platform. Leggi la documentazione seguente per scoprire come configurare l'origine Snowflake e connettersi ad Experience Platform.
Prerequisiti prerequisites
Questa sezione descrive le attività di installazione che è necessario completare prima di poter connettere l'origine Snowflake ad Experience Platform.
Indirizzo IP inserisco nell'elenco Consentiti
Prima di collegare le origini a Experience Platform, è necessario aggiungere al elenco Consentiti di indirizzi IP specifici per l’area geografica. Per ulteriori informazioni, leggere la guida in inserire nell'elenco Consentiti degli indirizzi IP per la connessione ad Experience Platform.
Raccogli le credenziali richieste
Per autenticare l'origine Snowflake, è necessario fornire i valori per le seguenti proprietà delle credenziali.
Specificare i valori per le credenziali seguenti per connettere Snowflake ad Experience Platform in Azure utilizzando l'autenticazione della chiave dell'account.
| 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 | |
|---|---|
| Credenziali | Descrizione |
account |
Un nome di account identifica in modo univoco un account all’interno dell’organizzazione. In questo caso, è necessario identificare in modo univoco un account tra diverse Snowflake organizzazioni. A questo scopo, devi anteporre il nome della tua organizzazione al nome dell’account. Esempio: myorg-myaccount.snowflakecomputing.com. Leggi la sezione sul recupero dell'identificatore dell'account Snowflake per ulteriori informazioni. Per ulteriori informazioni, consulta la Snowflake documentazione. |
warehouse |
Il data warehouse Snowflake gestisce il processo di esecuzione delle query per l'applicazione. Ogni data warehouse Snowflake è indipendente l'uno dall'altro e deve essere accessibile singolarmente quando si trasferiscono i dati ad Experience Platform. |
database |
Il database Snowflake contiene i dati che si desidera inserire nell'Experience Platform. |
username |
Nome utente per l'account Snowflake. |
password |
Password per l'account utente Snowflake. |
role |
Ruolo di controllo di accesso predefinito da utilizzare nella sessione Snowflake. Il ruolo deve essere esistente e già assegnato all'utente specificato. Il ruolo predefinito è PUBLIC. |
connectionString |
Stringa di connessione utilizzata per connettersi all'istanza Snowflake. Il modello di stringa di connessione per Snowflake è jdbc:snowflake://{ACCOUNT_NAME}.snowflakecomputing.com/?user={USERNAME}&password={PASSWORD}&db={DATABASE}&warehouse={WAREHOUSE}. |
Per utilizzare l'autenticazione con coppia di chiavi, generare innanzitutto una coppia di chiavi RSA a 2048 bit. Quindi, fornisci i valori per le seguenti credenziali per connettersi ad Experience Platform su Azure utilizzando l’autenticazione con coppia di chiavi.
| 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 | |
|---|---|
| Credenziali | Descrizione |
account |
Un nome di account identifica in modo univoco un account all’interno dell’organizzazione. In questo caso, è necessario identificare in modo univoco un account tra diverse Snowflake organizzazioni. A questo scopo, devi anteporre il nome della tua organizzazione al nome dell’account. Esempio: myorg-myaccount.snowflakecomputing.com. Leggi la sezione sul recupero dell'identificatore dell'account Snowflake per ulteriori informazioni. Per ulteriori informazioni, consulta la Snowflake documentazione. |
username |
Il nome utente dell'account Snowflake. |
privateKey |
La chiave privata con codifica Base64- del tuo account Snowflake. Puoi generare chiavi private crittografate o non crittografate. Se utilizzi una chiave privata crittografata, devi fornire anche una passphrase di chiave privata durante l’autenticazione in Experience Platform. Leggi la sezione sul recupero della chiave privata per ulteriori informazioni. |
privateKeyPassphrase |
La passphrase per chiave privata è un ulteriore livello di sicurezza da utilizzare per l'autenticazione con una chiave privata crittografata. Se si utilizza una chiave privata non crittografata, non è necessario fornire la passphrase. |
port |
Numero di porta utilizzato da Snowflake per la connessione a un server tramite Internet. |
database |
Il database Snowflake che contiene i dati da acquisire in Experience Platform. |
warehouse |
Il data warehouse Snowflake gestisce il processo di esecuzione delle query per l'applicazione. Ogni data warehouse Snowflake è indipendente l'uno dall'altro e deve essere accessibile singolarmente quando si trasferiscono i dati ad Experience Platform. |
Per ulteriori informazioni su questi valori, fare riferimento alla Snowflake guida all'autenticazione con coppia di chiavi.
Specificare i valori per le credenziali seguenti per connettere Snowflake ad Experience Platform su AWS utilizzando l'autenticazione di base.
| note warning |
|---|
| WARNING |
| L'autenticazione di base (o l'autenticazione della chiave dell'account) per l'origine Snowflake diventerà obsoleta a novembre 2025. Devi passare all’autenticazione basata su coppia di chiavi per continuare a utilizzare l’origine e ad acquisire i dati dal database ad Experience Platform. Per ulteriori informazioni sulla deprecazione, leggere la Snowflake guida alle best practice per ridurre i rischi di compromissione delle credenziali. |
| 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 | |
|---|---|
| Credenziali | Descrizione |
host |
L'URL host al quale il tuo account Snowflake si connette. |
port |
Numero di porta utilizzato da Snowflake per la connessione a un server tramite Internet. |
username |
Il nome utente associato al tuo account Snowflake. |
password |
La password associata al tuo account Snowflake. |
database |
Il database Snowflake da cui verranno estratti i dati. |
schema |
Il nome dello schema associato al database Snowflake. È necessario assicurarsi che anche l'utente a cui si desidera concedere l'accesso al database abbia accesso a questo schema. |
warehouse |
Il data warehouse Snowflake in uso. |
Per utilizzare l'autenticazione con coppia di chiavi, generare innanzitutto una coppia di chiavi RSA a 2048 bit. Quindi, fornisci i valori per le seguenti credenziali per connettersi ad Experience Platform su AWS utilizzando l’autenticazione con coppia di chiavi.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
|---|---|
| Credenziali | Descrizione |
account |
Un nome di account identifica in modo univoco un account all’interno dell’organizzazione. In questo caso, è necessario identificare in modo univoco un account tra diverse Snowflake organizzazioni. A questo scopo, devi anteporre il nome della tua organizzazione al nome dell’account. Esempio: http://myorg-myaccount.snowflakecomputing.com/. Per ulteriori informazioni, consulta la guida in recupero dell'identificatore dell'account Snowflake . Per ulteriori informazioni, consulta la Snowflake documentazione. |
username |
Il nome utente dell'account Snowflake. |
privateKey |
Chiave privata per l'utente Snowflake, con codifica base64 come una singola riga senza intestazioni o interruzioni di riga. Per prepararlo, copiare il contenuto del file PEM, rimuovere le righe BEGIN/END e tutte le interruzioni di riga, quindi codificare il risultato in base64. Leggi la sezione sul recupero della chiave privata per ulteriori informazioni. Nota: le chiavi private crittografate non sono attualmente supportate per una connessione AWS. |
port |
Numero di porta utilizzato da Snowflake per la connessione a un server tramite Internet. |
database |
Il database Snowflake che contiene i dati da acquisire in Experience Platform. |
warehouse |
Il data warehouse Snowflake gestisce il processo di esecuzione delle query per l'applicazione. Ogni data warehouse Snowflake è indipendente l'uno dall'altro e deve essere accessibile singolarmente quando si trasferiscono i dati ad Experience Platform. |
Per ulteriori informazioni su questi valori, fare riferimento alla Snowflake guida all'autenticazione con coppia di chiavi.
Recupera l’identificatore dell’account retrieve-your-account-identifier
È necessario recuperare l'identificatore dell'account dal dashboard dell'interfaccia utente di Snowflake, poiché verrà utilizzato per autenticare l'istanza di Snowflake in Experience Platform.
Per recuperare l’identificatore dell’account:
- Utilizza il Snowflake dashboard dell'interfaccia utente dell'applicazione per accedere al tuo account.
- Nel menu di navigazione a sinistra, seleziona Accounts, quindi seleziona Active Accounts dall'intestazione.
- Quindi, seleziona l’icona delle informazioni, quindi fai clic sul nome di dominio dell’URL corrente e copialo.
Generare la coppia di chiavi RSA
Utilizza OpenSSL nell’interfaccia della riga di comando per generare una coppia di chiavi RSA a 2048 bit in formato PKCS#8. È consigliabile creare una chiave privata crittografata per la sicurezza, che richiederà una passphrase.
Per generare la chiave privata Snowflake crittografata, eseguire il comando seguente sul terminale:
| code language-bash |
|---|
|
Per generare la chiave privata Snowflake non crittografata, eseguire il comando seguente sul terminale:
| code language-bash |
|---|
|
Generare una chiave pubblica dalla chiave privata
Quindi, esegui il comando seguente nell’interfaccia della riga di comando per creare una chiave pubblica basata sulla chiave privata.
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.
Assegna la chiave pubblica all'utente Snowflake
È necessario utilizzare un ruolo di amministratore Snowflake (come SECURITYADMIN) per associare la chiave pubblica generata all'utente del servizio Snowflake che Experience Platform utilizzerà. Per recuperare il contenuto della chiave pubblica, aprire il file rsa_key.pub e copiare l'intero contenuto, escluse le righe -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY-----. Eseguire quindi le istruzioni SQL seguenti in Snowflake:
ALTER USER {YOUR_SNOWFLAKE_USERNAME}>SET RSA_PUBLIC_KEY='{PUBLIC_KEY_CONTENT}';
Codifica la chiave privata in Base64
Experience Platform richiede che la chiave privata sia codificata con Base64 e fornita come stringa durante la configurazione della connessione. Utilizzare uno strumento o uno script appropriato per codificare il contenuto del file rsa_key.p8 in una singola stringa Base64.
(-----BEGIN ENCRYPTED PRIVATE KEY----- and -----END ENCRYPTED PRIVATE KEY-----), prima o dopo il processo di codifica, in quanto ciò potrebbe causare errori di autenticazione.Verifica configurazioni
Prima di creare la connessione di origine Snowflake in Experience Platform, è necessario assicurarsi che Default Role e Default Warehouse dell'utente corrispondano ai valori forniti in Experience Platform. È possibile verificare queste impostazioni nell'interfaccia utente di Snowflake utilizzando il comando SQL DESCRIBE USER {USERNAME}.
In alternativa, puoi seguire i passaggi riportati di seguito per verificare le impostazioni:
- Selezionare Admin nel menu di navigazione a sinistra, quindi selezionare Users & Roles.
- Selezionare l'utente appropriato, quindi selezionare i puntini di sospensione (
...) nell'angolo superiore destro. - Nella finestra Edit user visualizzata, passa a Default Role per visualizzare il ruolo associato all'utente specificato.
- Nella stessa finestra passare a Default Warehouse per visualizzare il magazzino associato all'utente specificato.
Passaggi successivi
Al termine dell'installazione, è possibile procedere con la connessione dell'account Snowflake ad Experience Platform. Per ulteriori informazioni, consulta la documentazione seguente: