> ## Documentation Index > Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/). # 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. > [!NOTE] > > 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](https://trust.perplexity.ai/). * **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](https://trust.perplexity.ai/). ## 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.* > [!NOTE] > > 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](https://docs.snowflake.com/en/sql-reference/sql/create-security-integration-oauth-snowflake). ```sql theme={null} 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. ```sql theme={null} SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH'); ``` 3. Inserisci quelle credenziali nella finestra di configurazione OAuth in Perplexity. > [!NOTE] > > 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. ```bash theme={null} 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. ```sql theme={null} 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. ```sql theme={null} 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](https://docs.snowflake.com/en/sql-reference/sql/grant-privilege). ```sql theme={null} 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.* ```sql theme={null} 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. > [!WARNING] > > 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?](https://www.perplexity.ai/help-center/help-center/it/articles/2026100701-che-cosa-sono-i-plugin.md) ### 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](https://help.ah.merge.dev/articles/8124222873-merge-tenant-ip-addresses) | | 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. ```sql theme={null} 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](https://www.perplexity.ai/help-center/help-center/it/articles/14017067-comprendere-la-mappa-dei-dati.md) * [Connessione di Perplexity con Databricks](https://www.perplexity.ai/help-center/help-center/it/articles/14810342-collegare-perplexity-a-databricks.md) * [Guida alla risoluzione dei problemi di Enterprise Connector](https://www.perplexity.ai/help-center/help-center/it/articles/10673201-guida-alla-risoluzione-dei-problemi-di-enterprise-connector.md) * [Conservazione dei dati e privacy per Enterprise](https://www.perplexity.ai/help-center/help-center/it/articles/11187708-conservazione-dei-dati-e-privacy-per-organizzazioni-e-utenti-aziendali.md) * [Ruoli e autorizzazioni Enterprise](https://www.perplexity.ai/help-center/help-center/it/articles/11187754-ruoli-e-autorizzazioni-aziendali.md) ## 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. > [!NOTE] > > Rivolgiti al tuo team dedicato oppure [contattaci tramite **Help > Contatta > l’assistenza**](https://www.perplexity.ai/?support=true#settings/account). > Visita il [Trust Center](https://trust.perplexity.ai/) per la documentazione su > sicurezza e conformità. ## Related topics - [Collegare Perplexity a Salesforce](https://www.perplexity.ai/help-center/help-center/it/articles/2026101201-collegare-perplexity-a-salesforce.md) - [Connettori e integrazioni](https://www.perplexity.ai/help-center/help-center/it/collections/18799295-connettori-e-integrazioni.md) - [Comprendere la mappa dei dati](https://www.perplexity.ai/help-center/help-center/it/articles/14017067-comprendere-la-mappa-dei-dati.md) - [Collegare Perplexity a Guidepoint](https://www.perplexity.ai/help-center/help-center/it/articles/14818160-collegare-perplexity-a-guidepoint.md)