Conectar Perplexity con Snowflake

Conecta un almacén de datos de Snowflake a Perplexity con User OAuth o con una cuenta de servicio, en los planes Pro, Max, Enterprise Pro y Enterprise Max.

Esta guía explica a los administradores de Snowflake y de Perplexity cómo conectar un almacén de datos de Snowflake a Perplexity, y muestra a los suscriptores de Pro, Max, Enterprise Pro y Enterprise Max cómo iniciar sesión.

​

Descripción general

El conector de Snowflake te permite consultar los datos de tu almacén de datos de Snowflake directamente desde Perplexity. Puedes buscar y combinar información de tus bases de datos de Snowflake, de tus demás aplicaciones conectadas y de la web sin escribir SQL a mano ni cambiar a la consola de Snowflake.

La conexión con Snowflake se hace por usuario. Nadie más de tu organización puede consultar tus datos a menos que los sincronices con un Proyecto compartido.

El conector de Snowflake está disponible en los planes Pro, Max, Enterprise Pro y Enterprise Max. Generar un mapa de datos requiere Enterprise Pro o Enterprise Max. En todos los planes, un administrador de Snowflake con el rol ACCOUNTADMIN crea la integración de seguridad o la cuenta de servicio; en los planes Enterprise, un administrador de Perplexity configura el conector User OAuth una sola vez para toda la organización.

​

Privacidad y seguridad de los datos

El conector consulta tu cuenta de Snowflake con un rol de Snowflake que tú controlas, por lo que los privilegios de Snowflake son el límite de lo que Perplexity puede alcanzar. Concede a ese rol acceso de solo lectura.

• Alcance del acceso: cada persona conecta su propia cuenta. Nadie más de tu organización puede consultar tus datos a menos que los sincronices con un Proyecto compartido.

• Dónde se almacenan los datos: Perplexity no almacena tus datos de Snowflake. Las consultas se ejecutan en tu propia cuenta de Snowflake, y el conector no añade almacenamiento propio más allá de los datos operativos que Perplexity recopila para hacer funcionar el producto.

• Conservación: el conector no opera ninguna caché, por lo que no existe una copia separada de tus datos de Snowflake que conservar o eliminar.

• Control del administrador: en los planes Enterprise, el administrador de tu organización puede deshabilitar el conector de Snowflake para tu organización; en ese caso, no aparece en tu configuración de conectores.

• Aplicación de solo lectura: aplica el acceso de solo lectura mediante los privilegios de Snowflake. No concedas al rol que usa Perplexity ningún privilegio de escritura o de creación de objetos.

• Uso para entrenamiento: los datos a los que se accede mediante el conector de Snowflake nunca se usan para entrenar los modelos de Perplexity ni ningún modelo de terceros.

• Subencargados: el tráfico de autenticación y de API de este conector pasa por Merge Agent Handler, operado por Merge API, Inc., un subencargado de Perplexity. La lista actual se publica en el Centro de confianza de Perplexity.

• Cifrado: las credenciales del conector y los datos conectados se cifran en tránsito con TLS y en reposo con AES-256.

• Cumplimiento: los controles de Perplexity se auditan conforme a SOC 2 Tipo II. La documentación de seguridad y cumplimiento está disponible en el Centro de confianza de Perplexity.

​

Cómo activarlo

​

Elegir un método de autenticación

Perplexity ofrece dos conectores de Snowflake. Configura solo el que coincida con la forma en que se autentican tus usuarios.

Conector	Las consultas se ejecutan como	Credencial	Pista de auditoría	Úsalo cuando
Snowflake (User OAuth)	La cuenta de Snowflake de cada usuario	OAuth	Atribuida a cada usuario en los registros de auditoría de Snowflake	Recomendado para la mayoría de las organizaciones
Snowflake (Service Account)	Una única cuenta de servicio compartida	Par de claves	Identidad compartida	Los usuarios consultan a través de una sola cuenta

Tabla 1 — Los dos conectores de Snowflake y cuándo usar cada uno.

Perplexity recomienda encarecidamente el conector User OAuth. Las consultas usan los permisos de Snowflake de cada persona y se le atribuyen en los registros de auditoría de Snowflake.

​

Antes de empezar

• Tienes el plan Pro, Max, Enterprise Pro o Enterprise Max.

• En los planes Enterprise, el administrador de tu organización no ha deshabilitado el conector de Snowflake.

• Tu administrador de Snowflake tiene acceso ACCOUNTADMIN o privilegios equivalentes.

• OpenSSL está instalado localmente, solo para la configuración con cuenta de servicio.

​

Configurar el conector User OAuth

1. Pide a tu administrador de Snowflake que cree la integración de seguridad. Consulta la documentación de la integración de seguridad OAuth de Snowflake para ver parámetros adicionales.

   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 el client ID y el client secret.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Introduce esas credenciales en la ventana de configuración de OAuth en Perplexity.

Usa OAUTH_USE_SECONDARY_ROLES = IMPLICIT para que los usuarios puedan acceder a sus roles secundarios además de sus roles predeterminados. Usa NONE si los usuarios deben limitarse únicamente a su DEFAULT_ROLE en Snowflake.

​

Configurar el conector de cuenta de servicio

Una cuenta de servicio es un usuario de Snowflake dedicado que se ejecuta con un rol específico. Todas las personas que usen la cuenta compartida tienen el mismo acceso, así que concede a ese rol solo el acceso a datos que Perplexity necesita.

1. Genera una clave privada y su clave pública correspondiente en tu 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. Crea un rol dedicado y un warehouse, eligiendo el tamaño de warehouse que se ajuste a tu volumen de consultas. También puedes usar un warehouse existente en lugar de crear 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 el usuario de la cuenta de servicio. Sustituye el valor de RSA_PUBLIC_KEY por el contenido de snowflake_computer_key.pub, sin las líneas BEGIN PUBLIC KEY ni 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. Concede acceso a los datos que quieres que Perplexity consulte. Sustituye MY_DATABASE por tu propia base de datos. Estas concesiones dan acceso de lectura a sus esquemas, tablas y vistas actuales y futuros. Para un acceso más restringido, concede permisos sobre esquemas u objetos concretos. Consulta la documentación de GRANT de 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. Si decides generar un mapa de datos durante el flujo de configuración del conector, concede acceso a las dos vistas de uso de la cuenta que lee. Generar un mapa de datos requiere Enterprise Pro o Enterprise Max. Esta concesión otorga un acceso más amplio a los metadatos de la cuenta de Snowflake, no solo a estas dos vistas, así que revísala antes de ejecutarla.

   Vista	Disponibilidad
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Todas las ediciones
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition o superior. En Standard Edition, Perplexity usa QUERY_HISTORY en su lugar

   Tabla 2 — Las vistas de uso de la cuenta que lee un mapa de datos.

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

6. Abre Plugins en la barra lateral (o Customize → Connectors si todavía no ves Plugins), busca Snowflake (Service Account) en Descubrir o mediante la búsqueda y abre su página.

7. Selecciona Conectar.

8. Introduce el identificador de tu cuenta de Snowflake, el nombre de usuario PERPLEXITY_USER y la clave privada snowflake_computer_key.p8.

9. Selecciona Permitir para completar la configuración.

Mantén snowflake_computer_key.p8 en privado. Lo introduces en Perplexity al conectar, y cualquier otra persona que lo tenga puede consultar tu warehouse como PERPLEXITY_USER. Aplica el acceso de solo lectura mediante los permisos de Snowflake: no concedas a PERPLEXITY_ROLE privilegios de escritura ni de creación de objetos.

​

Conectar tu cuenta de Snowflake

Una vez completada la configuración del administrador, cada usuario conecta su propia cuenta.

1. Abre Plugins en la barra lateral (o Customize → Connectors si todavía no ves Plugins), busca Snowflake (User OAuth) en Descubrir o mediante la búsqueda y abre su página.

2. Selecciona Conectar.

3. Inicia sesión en Snowflake cuando se te solicite.

4. Selecciona Permitir para completar la conexión.

Este conector también puede aparecer dentro de un plugin. Al conectarlo en cualquier lugar, queda conectado para tu cuenta en todas partes. Tu conexión y los ajustes de conectores de tu organización se aplican dentro de cada plugin. ¿Qué son los plugins?

​

Cómo verificar que ha funcionado

Abre una sesión nueva, menciona @Snowflake y pide algo pequeño de una tabla que ya puedas leer en Snowflake, como un recuento de filas. Si la respuesta llega sin tus datos de Snowflake, lo primero que debes comprobar es tu rol de Snowflake: necesita SELECT sobre el objeto que has indicado.

​

Probarlo

Una vez conectado Snowflake, menciónalo en una sesión nueva:

• @Snowflake ¿Cuántas filas tiene la tabla de pedidos?

• @Snowflake ¿Qué columnas hay en la tabla de clientes?

• @Snowflake Enumera los esquemas que puedo consultar en MY_DATABASE

​

Permisos y alcances

El conector solo necesita privilegios de lectura. Concédelos a un rol dedicado en lugar de a un rol de analista existente.

Privilegio	Concedido sobre	Por qué lo necesita el conector
USAGE	Warehouse	Ejecutar las consultas que responden a una pregunta
USAGE	Base de datos y esquemas	Acceder a los objetos que tiene permitido consultar
SELECT	Tablas y vistas	Leer filas. No se solicita ningún privilegio de escritura
IMPORTED PRIVILEGES	Base de datos SNOWFLAKE	Leer las dos vistas de uso de la cuenta que necesita un mapa de datos. Opcional
Token de actualización	Integración de seguridad	Mantener conectado a un usuario sin volver a autenticarse, durante el periodo de validez que definas

Tabla 3 — Privilegios de Snowflake que solicita el conector y por qué.

Los privilegios de Snowflake son el límite de aplicación. Independientemente de lo que se le pida al conector, este se ejecuta con el rol que le has concedido, por lo que un rol sin privilegios de escritura no puede escribir.

​

Solución de problemas

Síntoma que ves	Causa más probable	Cómo solucionarlo
Snowflake no está habilitado para tu organización o no aparece en tu lista de conectores	En los planes Enterprise, un administrador de la organización lo ha deshabilitado. Si no, puede que tu plan no lo incluya	En los planes Enterprise, ponte en contacto con el administrador de tu organización. Si no, confirma tu plan en Configuración
El inicio de sesión o las consultas fallan y tu cuenta de Snowflake restringe las conexiones entrantes por IP	Las direcciones del tenant de Merge no están en la lista de permitidos de tu política de red de Snowflake	Pide a tu administrador de Snowflake que añada a la lista de permitidos las direcciones del tenant de EE. UU. de la página de direcciones IP del tenant de Merge
Un usuario accede a menos datos de los que se le han concedido en Snowflake	La sesión OAuth solo activó su DEFAULT_ROLE	Confirma que la integración de seguridad establece OAUTH_USE_SECONDARY_ROLES = IMPLICIT
ACCESS_HISTORY no está disponible al generar un mapa de datos	Tu cuenta de Snowflake tiene Standard Edition	ACCESS_HISTORY necesita Enterprise Edition o superior. En Standard Edition, Perplexity usa QUERY_HISTORY en su lugar

Tabla 4 — Síntoma, causa y solución de los problemas más habituales del conector de Snowflake.

Para una cuenta de servicio, este ejemplo crea una política de red a nivel de usuario con las direcciones de EE. UU. publicadas actualmente. Consulta la página de direcciones IP del tenant de Merge para ver la lista actual antes de aplicar una política.

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;

​

Preguntas frecuentes

​

¿A qué datos accede este conector?

A las bases de datos, esquemas, tablas y vistas que el rol de Snowflake que has concedido tiene permitido leer. No puede acceder a nada que ese rol no pueda alcanzar.

​

¿Se usarán mis datos de Snowflake para entrenar modelos de IA?

No. Los datos a los que se accede mediante el conector de Snowflake nunca se usan para entrenar los modelos de Perplexity ni ningún modelo de terceros.

​

¿Puede mi administrador restringir quién habilita este conector?

Sí, en los planes Enterprise. Un administrador de la organización puede deshabilitar el conector de Snowflake para toda la organización; en ese caso, no aparece en tu configuración de conectores.

​

¿Puede Perplexity escribir en mis datos de Snowflake?

No, siempre que lo apliques en Snowflake. Concede al rol que usa Perplexity solo USAGE y SELECT, y Snowflake rechazará cualquier escritura independientemente de lo que se le pida a Perplexity.

​

¿Está disponible este conector en mi plan?

Sí, en los planes Pro, Max, Enterprise Pro y Enterprise Max. Generar un mapa de datos requiere Enterprise Pro o Enterprise Max.

​

Artículos relacionados

• Entender el mapa de datos

• Conectar Perplexity con Databricks

• Guía de resolución de problemas del conector Enterprise

• Conservación de datos y privacidad en Enterprise

• Roles y permisos de Enterprise

​

¿Necesitas más ayuda?

Cuando nos escribas, incluye el nombre del conector, el mensaje de error exacto, la hora en que ocurrió y los pasos de este artículo que no lo resolvieron.

Ponte en contacto con tu equipo de cuenta o escríbenos por Help > Contactar con soporte. Visita el Centro de confianza para consultar la documentación de seguridad y cumplimiento.