DocumentazioneExperience PlatformGuida ai connettori di origini

[Ultimate]{class="badge positive"}

Origine Snowflake

Last update: Fri Sep 26 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore
IMPORTANT
  • 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 null come una stringa vuota. Contatta il tuo rappresentante Adobe per assicurarti che i valori null siano scritti correttamente come null in 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.

Adobe Experience Platform consente di acquisire dati da origini esterne e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi Platform. Puoi acquisire dati da diverse origini, ad esempio applicazioni Adobe, archiviazione basata su cloud, database e molte altre.

Experience Platform fornisce supporto per l’acquisizione di dati da un database di terze parti. Experience Platform può connettersi a diversi tipi di database, ad esempio database relazionali, NoSQL o data warehouse. Il supporto per i provider di database include Snowflake.

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.

Autenticazione chiave account (Azure)

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: orgname-account_name. Leggi la sezione sul recupero dell'identificatore dell'account Snowflakeper 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}.
Autenticazione coppia di chiavi (Azure)

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: orgname-account_name. Leggi la sezione sul recupero dell'identificatore dell'account Snowflakeper 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.

Autenticazione di base (AWS)

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.
Autenticazione coppia di chiavi (AWS)

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: orgname-account_name. 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 perché verrà utilizzato l'identificatore dell'account per autenticare l'istanza di Snowflake in Experience Platform.

Per recuperare l’identificatore dell’account:

  • Accedi al tuo account nel Snowflake dashboard dell'interfaccia utente dell'applicazione.
  • Nel menu di navigazione a sinistra, seleziona Accounts, seguito da Active Accounts dall'intestazione.
  • Quindi, seleziona l’icona delle informazioni, quindi fai clic sul nome di dominio dell’URL corrente e copialo.

Dashboard dellinterfaccia utente di Snowflake con il nome di dominio selezionato.

Recupera la chiave privata retrieve-your-private-key

Se si utilizza l'autenticazione con coppia di chiavi per la connessione Snowflake, è necessario generare anche la chiave privata prima di connettersi ad Experience Platform.

Crea una chiave privata crittografata

Per generare la chiave privata Snowflake crittografata, eseguire il comando seguente sul terminale:

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

In caso di esito positivo, dovresti ricevere la tua chiave privata in formato PEM.

code language-shell 
-----BEGIN ENCRYPTED PRIVATE KEY-----
MIIE6T...
-----END ENCRYPTED PRIVATE KEY-----
Crea una chiave privata non crittografata

Per generare la chiave privata Snowflake non crittografata, eseguire il comando seguente sul terminale:

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

In caso di esito positivo, dovresti ricevere la tua chiave privata in formato PEM.

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

Quindi, prendere la chiave privata e codificarla in Base64. Assicurati di non eseguire alcuna trasformazione o conversione di formato nella chiave privata Snowflake. Inoltre, è necessario verificare che non siano presenti caratteri di nuova riga finali alla fine della chiave privata, prima di codificarla in Base64.

Verifica configurazioni

Prima di poter creare una connessione di origine per i dati di Snowflake, è necessario verificare che siano soddisfatte le seguenti configurazioni:

  • Il magazzino predefinito assegnato a un determinato utente deve essere uguale al magazzino immesso durante l'autenticazione in Experience Platform.
  • Il ruolo predefinito assegnato a un determinato utente deve avere accesso allo stesso database inserito durante l’autenticazione in Experience Platform.

Per verificare il ruolo e il magazzino:

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

Interfaccia utente di Snowflake in cui è possibile verificare il proprio ruolo e il proprio data warehouse.

Una volta codificata correttamente, è possibile utilizzare la chiave privata con codifica Base64 in Experience Platform per autenticare l'account Snowflake.

La documentazione seguente fornisce informazioni su come connettere Snowflake ad Experience Platform tramite API o tramite l'interfaccia utente:

Connetti Snowflake ad Experience Platform tramite API

Connetti Snowflake ad Experience Platform tramite l'interfaccia utente

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