Collegare Perplexity a Snowflake

Collega un data warehouse Snowflake a Perplexity utilizzando User OAuth oppure un account di servizio, sui piani Pro, Max, Enterprise Pro ed Enterprise Max.

Questa guida accompagna gli amministratori Snowflake e Perplexity nel collegamento di un data warehouse Snowflake a Perplexity e mostra agli abbonati Pro, Max, Enterprise Pro ed Enterprise Max come accedere.

​

Panoramica

Il connettore Snowflake ti consente di eseguire query sui dati del tuo data warehouse Snowflake direttamente da Perplexity. Puoi cercare e combinare informazioni tra i tuoi database Snowflake, le altre app connesse e il web, senza scrivere SQL a mano né passare alla console Snowflake.

La connessione a Snowflake avviene per singolo utente. Nessun altro nella tua organizzazione può eseguire query sui tuoi dati, a meno che tu non li sincronizzi con un Progetto condiviso.

Il connettore Snowflake è disponibile sui piani Pro, Max, Enterprise Pro ed Enterprise Max. La generazione di una mappa dei dati richiede Enterprise Pro o Enterprise Max. Su tutti i piani, un amministratore Snowflake con il ruolo ACCOUNTADMIN crea l’integrazione di sicurezza o l’account di servizio; sui piani Enterprise, un amministratore Perplexity configura il connettore User OAuth una sola volta per l’organizzazione.

​

Privacy e sicurezza dei dati

Il connettore esegue query sul tuo account Snowflake con un ruolo Snowflake che controlli tu, quindi i privilegi Snowflake sono il confine di ciò che Perplexity può raggiungere. Concedi a quel ruolo solo l’accesso in lettura.

• Ambito di accesso — ogni persona collega il proprio account. Nessun altro nella tua organizzazione può eseguire query sui tuoi dati, a meno che tu non li sincronizzi con un Progetto condiviso.

• Dove vengono archiviati i dati — Perplexity non archivia i tuoi dati Snowflake. Le query vengono eseguite sul tuo account Snowflake e il connettore non aggiunge alcuna archiviazione propria, oltre ai dati operativi che Perplexity raccoglie per il funzionamento del prodotto.

• Conservazione — il connettore non utilizza alcuna cache, quindi non esiste una copia separata dei tuoi dati Snowflake da conservare o eliminare.

• Controllo dell’amministratore — sui piani Enterprise, l’amministratore della tua organizzazione può disattivare il connettore Snowflake per l’organizzazione; in tal caso non compare nelle tue impostazioni dei connettori.

• Applicazione della sola lettura — applica l’accesso in sola lettura tramite i privilegi Snowflake. Non concedere al ruolo utilizzato da Perplexity alcun privilegio di scrittura o di creazione di oggetti.

• Utilizzo per l’addestramento — i dati consultati tramite il connettore Snowflake non vengono mai utilizzati per addestrare i modelli di Perplexity né alcun modello di terze parti.

• Sub-responsabili del trattamento — il traffico di autenticazione e API di questo connettore passa attraverso Merge Agent Handler, gestito da Merge API, Inc., un sub-responsabile del trattamento di Perplexity. L’elenco aggiornato è pubblicato nel Trust Center di Perplexity.

• Crittografia — le credenziali del connettore e i dati connessi sono crittografati in transito con TLS e a riposo con AES-256.

• Conformità — i controlli di Perplexity sono sottoposti ad audit secondo lo standard SOC 2 Tipo II. La documentazione su sicurezza e conformità è disponibile nel Trust Center di Perplexity.

​

Come attivarlo

​

Scegliere un metodo di autenticazione

Perplexity offre due connettori Snowflake. Configura solo quello corrispondente alla modalità di autenticazione dei tuoi utenti.

Connettore	Le query vengono eseguite come	Credenziale	Audit trail	Quando utilizzarlo
Snowflake (User OAuth)	Account Snowflake di ciascun utente	OAuth	Attribuito a ogni utente nei log di audit di Snowflake	Consigliato per la maggior parte delle organizzazioni
Snowflake (Service Account)	Un unico account di servizio condiviso	Coppia di chiavi	Identità condivisa	Gli utenti eseguono query tramite un unico account

Tabella 1 — I due connettori Snowflake e quando utilizzare ciascuno di essi.

Perplexity consiglia vivamente il connettore User OAuth. Le query utilizzano le autorizzazioni Snowflake di ciascuna persona e le vengono attribuite nei log di audit di Snowflake.

​

Prima di iniziare

• Sei sul piano Pro, Max, Enterprise Pro o Enterprise Max.

• Sui piani Enterprise, l’amministratore della tua organizzazione non ha disattivato il connettore Snowflake.

• Il tuo amministratore Snowflake dispone dell’accesso ACCOUNTADMIN o di privilegi equivalenti.

• OpenSSL è installato in locale, solo per la configurazione con account di servizio.

​

Configurare il connettore User OAuth

1. Chiedi al tuo amministratore Snowflake di creare l’integrazione di sicurezza. Per ulteriori parametri, consulta la documentazione sull’integrazione di sicurezza OAuth di Snowflake.

   USE ROLE ACCOUNTADMIN;
   CREATE SECURITY INTEGRATION PERPLEXITY_OAUTH
     TYPE = OAUTH
     ENABLED = TRUE
     OAUTH_CLIENT = CUSTOM
     OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
     OAUTH_REDIRECT_URI = 'https://ah.merge.dev/oauth/callback'
     OAUTH_ISSUE_REFRESH_TOKENS = TRUE
     OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
     OAUTH_USE_SECONDARY_ROLES = IMPLICIT
     COMMENT = 'OAuth security integration for Perplexity';
   

2. Recupera l’ID client e il segreto client.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Inserisci quelle credenziali nella finestra di configurazione OAuth in Perplexity.

Utilizza OAUTH_USE_SECONDARY_ROLES = IMPLICIT affinché gli utenti possano raggiungere i propri ruoli secondari oltre ai ruoli predefiniti. Utilizza NONE se gli utenti devono essere limitati al solo DEFAULT_ROLE in Snowflake.

​

Configurare il connettore con account di servizio

Un account di servizio è un utente Snowflake dedicato che viene eseguito con un ruolo specifico. Tutte le persone che utilizzano l’account condiviso hanno lo stesso accesso, quindi concedi a quel ruolo solo l’accesso ai dati necessario a Perplexity.

1. Genera una chiave privata e la chiave pubblica corrispondente nel tuo terminale locale.

   openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out snowflake_computer_key.p8 -nocrypt
   openssl rsa -in snowflake_computer_key.p8 -pubout -out snowflake_computer_key.pub
   

2. Crea un ruolo dedicato e un warehouse, scegliendo la dimensione del warehouse adatta al tuo volume di query. Puoi anche utilizzare un warehouse esistente invece di crearne uno.

   USE ROLE ACCOUNTADMIN;
   CREATE ROLE IF NOT EXISTS PERPLEXITY_ROLE
     COMMENT = 'Role for Perplexity service account';
   CREATE WAREHOUSE IF NOT EXISTS PERPLEXITY_WAREHOUSE
     WAREHOUSE_SIZE = 'SMALL'
     AUTO_SUSPEND = 60
     AUTO_RESUME = TRUE
     COMMENT = 'Warehouse for Perplexity queries';
   GRANT USAGE ON WAREHOUSE PERPLEXITY_WAREHOUSE
     TO ROLE PERPLEXITY_ROLE;
   

3. Crea l’utente dell’account di servizio. Sostituisci il valore di RSA_PUBLIC_KEY con il contenuto di snowflake_computer_key.pub, escludendo le righe BEGIN PUBLIC KEY ed END PUBLIC KEY.

   CREATE USER PERPLEXITY_USER
     TYPE = SERVICE
     DEFAULT_ROLE = PERPLEXITY_ROLE
     DEFAULT_WAREHOUSE = PERPLEXITY_WAREHOUSE
     COMMENT = 'Service account for Perplexity'
     RSA_PUBLIC_KEY = 'MIIBIjANBgkqhki...your_public_key_here...IDAQAB';
   GRANT ROLE PERPLEXITY_ROLE TO USER PERPLEXITY_USER;
   

4. Concedi l’accesso ai dati su cui vuoi che Perplexity esegua query. Sostituisci MY_DATABASE con il tuo database. Queste concessioni forniscono l’accesso in lettura ai suoi schemi, tabelle e viste presenti e futuri. Per un accesso più ristretto, concedi invece le autorizzazioni su schemi o oggetti specifici. Consulta la documentazione GRANT di Snowflake.

   GRANT USAGE ON DATABASE MY_DATABASE TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON ALL SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON FUTURE SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   

5. Se scegli di generare una mappa dei dati nel flusso di configurazione del connettore, concedi l’accesso alle due viste di utilizzo dell’account che legge. La generazione di una mappa dei dati richiede Enterprise Pro o Enterprise Max. Questa concessione fornisce un accesso più ampio ai metadati dell’account Snowflake, non solo a queste due viste, quindi verificala prima di eseguirla.

   Vista	Disponibilità
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Tutte le edizioni
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition o superiore. Sulla Standard Edition, Perplexity utilizza invece QUERY_HISTORY

   Tabella 2 — Le viste di utilizzo dell’account lette da una mappa dei dati.

   USE ROLE ACCOUNTADMIN;
   GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE
     TO ROLE PERPLEXITY_ROLE;
   

6. Apri Plugin nella barra laterale (oppure Customize → Connectors se non vedi ancora Plugins), trova Snowflake (Service Account) in Scopri o tramite la ricerca e apri la sua pagina.

7. Seleziona Connetti.

8. Inserisci l’identificatore del tuo account Snowflake, il nome utente PERPLEXITY_USER e la chiave privata snowflake_computer_key.p8.

9. Seleziona Permettere per completare la configurazione.

Mantieni privato il file snowflake_computer_key.p8. Lo inserisci in Perplexity durante la connessione e chiunque altro ne disponga può eseguire query sul tuo warehouse come PERPLEXITY_USER. Applica l’accesso in sola lettura tramite le autorizzazioni Snowflake: non concedere a PERPLEXITY_ROLE privilegi di scrittura o di creazione di oggetti.

​

Collegare il tuo account Snowflake

Una volta completata la configurazione dell’amministratore, ogni utente collega il proprio account.

1. Apri Plugin nella barra laterale (oppure Customize → Connectors se non vedi ancora Plugins), trova Snowflake (User OAuth) in Scopri o tramite la ricerca e apri la sua pagina.

2. Seleziona Connetti.

3. Accedi a Snowflake quando richiesto.

4. Seleziona Permettere per completare la connessione.

Questo connettore può comparire anche all’interno di un plugin. Collegandolo in un punto, lo colleghi ovunque per il tuo account. La connessione e le impostazioni dei connettori della tua organizzazione si applicano in ogni plugin. Che cosa sono i plugin?

​

Come verificare che funzioni

Apri una nuova sessione, menziona @Snowflake e richiedi qualcosa di semplice da una tabella che riesci già a leggere in Snowflake, ad esempio un conteggio di righe. Se la risposta arriva senza i tuoi dati Snowflake, la prima cosa da controllare è il tuo ruolo Snowflake: ha bisogno di SELECT sull’oggetto che hai indicato.

​

Prova subito

Una volta collegato Snowflake, menzionalo in una nuova sessione:

• @Snowflake Quante righe ci sono nella tabella degli ordini?

• @Snowflake Quali colonne sono presenti nella tabella dei clienti?

• @Snowflake Elenca gli schemi su cui posso eseguire query in MY_DATABASE

​

Autorizzazioni e ambiti

Il connettore necessita solo dei privilegi di lettura. Concedili a un ruolo dedicato anziché a un ruolo di analista esistente.

Privilegio	Concesso su	Perché il connettore ne ha bisogno
USAGE	Warehouse	Eseguire le query che rispondono a una domanda
USAGE	Database e schemi	Raggiungere gli oggetti su cui è autorizzato a eseguire query
SELECT	Tabelle e viste	Leggere le righe. Non viene richiesto alcun privilegio di scrittura
IMPORTED PRIVILEGES	Database SNOWFLAKE	Leggere le due viste di utilizzo dell’account necessarie a una mappa dei dati. Facoltativo
Token di aggiornamento	Integrazione di sicurezza	Mantenere un utente connesso senza autenticarsi di nuovo, per il periodo di validità impostato

Tabella 3 — I privilegi Snowflake richiesti dal connettore e le relative motivazioni.

I privilegi Snowflake sono il confine di applicazione. Qualunque cosa venga chiesta al connettore, esso viene eseguito con il ruolo che hai concesso, quindi un ruolo senza privilegi di scrittura non può scrivere.

​

Risoluzione dei problemi

Sintomo osservato	Causa più probabile	Come risolverlo
Snowflake non è attivato per la tua organizzazione oppure non compare nel tuo elenco dei connettori	Sui piani Enterprise, un amministratore dell’organizzazione lo ha disattivato. Altrimenti il tuo piano potrebbe non includerlo	Sui piani Enterprise, contatta l’amministratore della tua organizzazione. Altrimenti verifica il tuo piano in Settings
L’accesso o le query non riescono e il tuo account Snowflake limita le connessioni in entrata in base all’IP	Gli indirizzi del tenant Merge non sono nella lista consentita della tua policy di rete Snowflake	Chiedi al tuo amministratore Snowflake di inserire nella lista consentita gli indirizzi del tenant statunitense indicati nella pagina degli indirizzi IP del tenant Merge
Un utente raggiunge meno dati di quelli concessi in Snowflake	La sessione OAuth ha attivato solo il suo DEFAULT_ROLE	Verifica che l’integrazione di sicurezza imposti OAUTH_USE_SECONDARY_ROLES = IMPLICIT
ACCESS_HISTORY non è disponibile durante la generazione di una mappa dei dati	Il tuo account Snowflake è sulla Standard Edition	ACCESS_HISTORY richiede la Enterprise Edition o superiore. Sulla Standard Edition, Perplexity utilizza invece QUERY_HISTORY

Tabella 4 — Sintomo, causa e soluzione dei problemi più comuni del connettore Snowflake.

Per un account di servizio, questo esempio crea una policy di rete a livello di utente utilizzando gli indirizzi statunitensi attualmente pubblicati. Consulta la pagina degli indirizzi IP del tenant Merge per l’elenco aggiornato prima di applicare una policy.

USE ROLE ACCOUNTADMIN;
CREATE NETWORK POLICY PERPLEXITY_COMPUTER_POLICY
  ALLOWED_IP_LIST = ('3.216.101.38', '52.20.242.81');
ALTER USER PERPLEXITY_USER
  SET NETWORK_POLICY = PERPLEXITY_COMPUTER_POLICY;

​

Domande frequenti

​

A quali dati accede questo connettore?

Ai database, agli schemi, alle tabelle e alle viste che il ruolo Snowflake da te concesso è autorizzato a leggere. Non può raggiungere nulla che quel ruolo non possa raggiungere.

​

I miei dati Snowflake verranno utilizzati per addestrare i modelli di IA?

No. I dati consultati tramite il connettore Snowflake non vengono mai utilizzati per addestrare i modelli di Perplexity né alcun modello di terze parti.

​

Il mio amministratore può limitare chi attiva questo connettore?

Sì, sui piani Enterprise. Un amministratore dell’organizzazione può disattivare il connettore Snowflake per l’intera organizzazione; in tal caso non compare nelle tue impostazioni dei connettori.

​

Perplexity può scrivere nei miei dati Snowflake?

No, a condizione che tu lo imponga in Snowflake. Concedi al ruolo utilizzato da Perplexity solo USAGE e SELECT e Snowflake rifiuterà qualsiasi scrittura, indipendentemente da ciò che viene chiesto a Perplexity.

​

Questo connettore è disponibile sul mio piano?

Sì, sui piani Pro, Max, Enterprise Pro ed Enterprise Max. La generazione di una mappa dei dati richiede Enterprise Pro o Enterprise Max.

​

Articoli correlati

• Comprendere la mappa dei dati

• Connessione di Perplexity con Databricks

• Guida alla risoluzione dei problemi di Enterprise Connector

• Conservazione dei dati e privacy per Enterprise

• Ruoli e autorizzazioni Enterprise

​

Hai bisogno di ulteriore assistenza?

Quando ci scrivi, indica il nome del connettore, il messaggio di errore esatto, l’ora in cui si è verificato e i passaggi di questo articolo che non hanno risolto il problema.

Rivolgiti al tuo team dedicato oppure contattaci tramite Help > Contatta l’assistenza. Visita il Trust Center per la documentazione su sicurezza e conformità.