Connecter Perplexity à Snowflake

Connectez un entrepôt de données Snowflake à Perplexity via User OAuth ou un compte de service, avec Pro, Max, Enterprise Pro et Enterprise Max.

Ce guide explique aux administrateurs Snowflake et Perplexity comment connecter un entrepôt de données Snowflake à Perplexity, et montre aux abonnés Pro, Max, Enterprise Pro et Enterprise Max comment se connecter.

​

Vue d’ensemble

Le connecteur Snowflake vous permet d’interroger les données de votre entrepôt de données Snowflake directement depuis Perplexity. Vous pouvez rechercher et combiner des informations dans vos bases de données Snowflake, vos autres applications connectées et le web, sans écrire de SQL à la main ni passer à la console Snowflake.

La connexion à Snowflake se fait par utilisateur. Personne d’autre dans votre organisation ne peut interroger vos données, sauf si vous les synchronisez dans un Project partagé.

Le connecteur Snowflake est disponible avec les offres Pro, Max, Enterprise Pro et Enterprise Max. La génération d’une carte de données nécessite l’offre Enterprise Pro ou Enterprise Max. Avec toutes les offres, un administrateur Snowflake disposant du rôle ACCOUNTADMIN crée l’intégration de sécurité ou le compte de service ; avec les offres Enterprise, un administrateur Perplexity configure une fois le connecteur User OAuth pour l’organisation.

​

Confidentialité et sécurité des données

Le connecteur interroge votre compte Snowflake sous un rôle Snowflake que vous contrôlez : les privilèges Snowflake constituent donc la limite de ce que Perplexity peut atteindre. N’accordez à ce rôle qu’un accès en lecture.

• Périmètre d’accès — Chaque personne connecte son propre compte. Personne d’autre dans votre organisation ne peut interroger vos données, sauf si vous les synchronisez dans un Project partagé.

• Lieu de stockage des données — Perplexity ne stocke pas vos données Snowflake. Les requêtes s’exécutent sur votre propre compte Snowflake, et le connecteur n’ajoute aucun stockage propre au-delà des données opérationnelles que Perplexity collecte pour faire fonctionner le produit.

• Conservation — Le connecteur n’exploite pas de cache : il n’existe donc aucune copie distincte de vos données Snowflake à conserver ou à supprimer.

• Contrôle par l’administrateur — Avec les offres Enterprise, l’administrateur de votre organisation peut désactiver le connecteur Snowflake pour votre organisation ; dans ce cas, il n’apparaît pas dans vos paramètres de connecteurs.

• Application du mode lecture seule — Appliquez l’accès en lecture seule via les privilèges Snowflake. N’accordez au rôle utilisé par Perplexity aucun privilège d’écriture ou de création d’objets.

• Utilisation pour l’entraînement — Les données consultées via le connecteur Snowflake ne sont jamais utilisées pour entraîner les modèles de Perplexity ni aucun modèle tiers.

• Sous-traitants — Le trafic d’authentification et d’API de ce connecteur passe par Merge Agent Handler, exploité par Merge API, Inc., un sous-traitant de Perplexity. La liste à jour est publiée dans le Trust Center de Perplexity.

• Chiffrement — Les identifiants du connecteur et les données connectées sont chiffrés en transit avec TLS et au repos avec AES-256.

• Conformité — Les contrôles de Perplexity sont audités selon la norme SOC 2 Type II. La documentation relative à la sécurité et à la conformité est disponible dans le Trust Center de Perplexity.

​

Comment l’activer

​

Choisir une méthode d’authentification

Perplexity propose deux connecteurs Snowflake. Ne configurez que celui qui correspond à la façon dont vos utilisateurs s’authentifient.

Connecteur	Les requêtes s’exécutent en tant que	Identifiant	Piste d’audit	À utiliser quand
Snowflake (User OAuth)	Le compte Snowflake propre à chaque utilisateur	OAuth	Attribuée à chaque utilisateur dans les journaux d’audit de Snowflake	Recommandé pour la plupart des organisations
Snowflake (Service Account)	Un compte de service partagé unique	Paire de clés	Identité partagée	Les utilisateurs interrogent les données via un compte unique

Table 1 — Les deux connecteurs Snowflake et quand utiliser chacun d’eux.

Perplexity recommande vivement le connecteur User OAuth. Les requêtes utilisent les autorisations Snowflake propres à chaque personne et lui sont attribuées dans les journaux d’audit de Snowflake.

​

Avant de commencer

• Vous disposez de l’offre Pro, Max, Enterprise Pro ou Enterprise Max.

• Avec les offres Enterprise, l’administrateur de votre organisation n’a pas désactivé le connecteur Snowflake.

• Votre administrateur Snowflake dispose de l’accès ACCOUNTADMIN, ou de privilèges équivalents.

• OpenSSL est installé localement, uniquement pour la configuration d’un compte de service.

​

Configurer le connecteur User OAuth

1. Demandez à votre administrateur Snowflake de créer l’intégration de sécurité. Consultez la documentation Snowflake sur l’intégration de sécurité OAuth pour connaître les paramètres supplémentaires.

   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. Récupérez l’ID client et le secret client.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Saisissez ces identifiants dans la fenêtre de configuration OAuth de Perplexity.

Utilisez OAUTH_USE_SECONDARY_ROLES = IMPLICIT afin que les utilisateurs puissent accéder à leurs rôles secondaires en plus de leurs rôles par défaut. Utilisez NONE si les utilisateurs doivent être limités à leur seul DEFAULT_ROLE dans Snowflake.

​

Configurer le connecteur de compte de service

Un compte de service est un utilisateur Snowflake dédié qui s’exécute sous un rôle spécifique. Toutes les personnes utilisant le compte partagé disposent du même accès : n’accordez donc à ce rôle que l’accès aux données dont Perplexity a besoin.

1. Générez une clé privée et la clé publique correspondante dans votre terminal local.

   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. Créez un rôle dédié et un warehouse, en choisissant la taille de warehouse adaptée à votre volume de requêtes. Vous pouvez aussi utiliser un warehouse existant au lieu d’en créer un.

   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. Créez l’utilisateur du compte de service. Remplacez la valeur RSA_PUBLIC_KEY par le contenu de snowflake_computer_key.pub, sans les lignes BEGIN PUBLIC KEY et 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. Accordez l’accès aux données que vous souhaitez faire interroger par Perplexity. Remplacez MY_DATABASE par votre propre base de données. Ces autorisations donnent un accès en lecture à ses schémas, tables et vues actuels et futurs. Pour un accès plus restreint, accordez plutôt les privilèges sur des schémas ou des objets spécifiques. Consultez la documentation Snowflake sur GRANT.

   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. Si vous choisissez de générer une carte de données lors du parcours de configuration du connecteur, accordez l’accès aux deux vues d’utilisation du compte qu’elle lit. La génération d’une carte de données nécessite l’offre Enterprise Pro ou Enterprise Max. Cette autorisation donne un accès plus large aux métadonnées du compte Snowflake, et pas seulement à ces deux vues : examinez-la donc avant de l’exécuter.

   Vue	Disponibilité
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Toutes les éditions
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition ou supérieure. Sur Standard Edition, Perplexity utilise QUERY_HISTORY à la place

   Table 2 — Les vues d’utilisation du compte qu’une carte de données lit.

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

6. Ouvrez Plugins dans la barre latérale (ou Customize → Connectors si vous ne voyez pas encore Plugins), trouvez Snowflake (Service Account) dans Découvrir ou via la recherche, puis ouvrez sa page.

7. Sélectionnez Connecter.

8. Saisissez l’identifiant de votre compte Snowflake, le nom d’utilisateur PERPLEXITY_USER et la clé privée snowflake_computer_key.p8.

9. Sélectionnez Allow pour terminer la configuration.

Gardez snowflake_computer_key.p8 confidentiel. Vous le saisissez dans Perplexity lors de la connexion, et toute autre personne qui le détient peut interroger votre warehouse en tant que PERPLEXITY_USER. Appliquez l’accès en lecture seule via les autorisations Snowflake : n’accordez pas à PERPLEXITY_ROLE de privilèges d’écriture ou de création d’objets.

​

Connecter votre compte Snowflake

Une fois la configuration par l’administrateur terminée, chaque utilisateur connecte son propre compte.

1. Ouvrez Plugins dans la barre latérale (ou Customize → Connectors si vous ne voyez pas encore Plugins), trouvez Snowflake (User OAuth) dans Découvrir ou via la recherche, puis ouvrez sa page.

2. Sélectionnez Connecter.

3. Connectez-vous à Snowflake lorsque vous y êtes invité.

4. Sélectionnez Allow pour terminer la connexion.

Ce connecteur peut aussi apparaître dans un plugin. Le connecter à un endroit le connecte partout pour votre compte. Votre connexion et les paramètres de connecteurs de votre organisation s’appliquent dans chaque plugin. Que sont les plugins ?

​

Comment vérifier que cela a fonctionné

Ouvrez une nouvelle session, mentionnez @Snowflake et demandez un élément simple issu d’une table que vous pouvez déjà lire dans Snowflake, par exemple un nombre de lignes. Si la réponse revient sans vos données Snowflake, vérifiez d’abord votre rôle Snowflake : il a besoin du privilège SELECT sur l’objet que vous avez nommé.

​

Essayer le connecteur

Une fois Snowflake connecté, mentionnez-le dans une nouvelle session :

• @Snowflake Combien de lignes contient la table orders ?

• @Snowflake Quelles colonnes contient la table customers ?

• @Snowflake Liste les schémas que je peux interroger dans MY_DATABASE

​

Autorisations et portées

Le connecteur n’a besoin que de privilèges de lecture. Accordez-les à un rôle dédié plutôt qu’à un rôle d’analyste existant.

Privilège	Accordé sur	Pourquoi le connecteur en a besoin
USAGE	Warehouse	Exécuter les requêtes qui répondent à une question
USAGE	Base de données et schémas	Atteindre les objets qu’il est autorisé à interroger
SELECT	Tables et vues	Lire les lignes. Aucun privilège d’écriture n’est demandé
IMPORTED PRIVILEGES	Base de données SNOWFLAKE	Lire les deux vues d’utilisation du compte dont une carte de données a besoin. Facultatif
Jeton d’actualisation	Intégration de sécurité	Maintenir un utilisateur connecté sans nouvelle authentification, pendant la période de validité que vous définissez

Table 3 — Les privilèges Snowflake demandés par le connecteur, et pourquoi.

Les privilèges Snowflake constituent la limite d’application. Quoi qu’on demande au connecteur, il s’exécute sous le rôle que vous avez accordé : un rôle sans privilèges d’écriture ne peut donc pas écrire.

​

Dépannage

Symptôme observé	Cause la plus probable	Comment y remédier
Snowflake n’est pas activé pour votre organisation, ou n’apparaît pas dans votre liste de connecteurs	Avec les offres Enterprise, un administrateur de l’organisation l’a désactivé. Sinon, votre offre ne l’inclut peut-être pas	Avec les offres Enterprise, contactez l’administrateur de votre organisation. Sinon, vérifiez votre offre dans Settings
La connexion ou les requêtes échouent, et votre compte Snowflake restreint les connexions entrantes par adresse IP	Les adresses du locataire Merge ne figurent pas dans la liste d’autorisation de votre politique réseau Snowflake	Demandez à votre administrateur Snowflake d’autoriser les adresses du locataire américain indiquées sur la page des adresses IP des locataires Merge
Un utilisateur accède à moins de données que celles qui lui ont été accordées dans Snowflake	La session OAuth n’a activé que son DEFAULT_ROLE	Vérifiez que l’intégration de sécurité définit OAUTH_USE_SECONDARY_ROLES = IMPLICIT
ACCESS_HISTORY est indisponible lors de la génération d’une carte de données	Votre compte Snowflake est en Standard Edition	ACCESS_HISTORY nécessite Enterprise Edition ou supérieure. Sur Standard Edition, Perplexity utilise QUERY_HISTORY à la place

Table 4 — Symptôme, cause et solution pour les problèmes les plus courants du connecteur Snowflake.

Pour un compte de service, cet exemple crée une politique réseau au niveau de l’utilisateur à partir des adresses américaines actuellement publiées. Vérifiez la page des adresses IP des locataires Merge pour connaître la liste à jour avant d’appliquer une politique.

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;

​

Foire aux questions

​

À quelles données ce connecteur accède-t-il ?

Aux bases de données, schémas, tables et vues que le rôle Snowflake que vous avez accordé est autorisé à lire. Il ne peut atteindre rien de ce que ce rôle ne peut pas atteindre.

​

Mes données Snowflake seront-elles utilisées pour entraîner des modèles d’IA ?

Non. Les données consultées via le connecteur Snowflake ne sont jamais utilisées pour entraîner les modèles de Perplexity ni aucun modèle tiers.

​

Mon administrateur peut-il restreindre qui active ce connecteur ?

Oui, avec les offres Enterprise. Un administrateur de l’organisation peut désactiver le connecteur Snowflake pour l’ensemble de l’organisation ; dans ce cas, il n’apparaît pas dans vos paramètres de connecteurs.

​

Perplexity peut-il écrire dans mes données Snowflake ?

Non, à condition que vous l’appliquiez dans Snowflake. N’accordez au rôle utilisé par Perplexity que les privilèges USAGE et SELECT, et Snowflake rejettera toute écriture, quoi qu’on demande à Perplexity.

​

Ce connecteur est-il disponible avec mon offre ?

Oui, avec les offres Pro, Max, Enterprise Pro et Enterprise Max. La génération d’une carte de données nécessite l’offre Enterprise Pro ou Enterprise Max.

​

Articles connexes

• Comprendre la carte des données

• Connexion de Perplexity avec Databricks

• Guide de dépannage du connecteur Enterprise

• Conservation des données et confidentialité pour Enterprise

• Rôles et autorisations Enterprise

​

Besoin d’aide supplémentaire ?

Lorsque vous nous écrivez, indiquez le nom du connecteur, le message d’erreur exact, l’heure à laquelle il s’est produit et les étapes de cet article qui n’ont pas résolu le problème.

Contactez votre équipe de compte ou contactez-nous via Help > Contacter le support. Consultez le Trust Center pour la documentation sur la sécurité et la conformité.