Logotipo de PlanetScale Postgres

PostgreSQL administrado habla PostgreSQL

Conectar PlanetScale Postgres a Excel, Google Sheets, IA y REST

PlanetScale Postgres, directamente en el puerto 5432 o a través de PSBouncer en el puerto 6432. Este es el producto Postgres, no el de Vitess.

Una conexión, cada superficie

Dónde pueden ir tus datos de PlanetScale

Query Streams lee datos de PlanetScale Postgres desde Microsoft Excel, Google Sheets, Power BI y asistentes de IA a través de MCP y un punto final REST mediante una única conexión de solo lectura. Esta tarjeta está diseñada específicamente para PlanetScale Postgres (el producto más reciente en .horizon.psdb.cloud) y no para el servicio MySQL con respaldo de Vitess por el que PlanetScale es más conocido. La tarjeta se configura por defecto en PSBouncer en el puerto 6432, que es donde la mayoría de las bases de datos de PlanetScale Postgres esperan que se conecte, y el agente desactiva las sentencias preparadas para adaptarse a esta configuración.

PlanetScale Postgres es PostgreSQL en la red — el controlador estándar, por lo que todas las guías a continuación se aplican sin cambios. La única parte específica de PlanetScale es la cadena de conexión, cubierta en detalles de conexión.

  1. Para su equipo, proveedores y socios
  2. PlanetScale para Excel Microsoft Excel · Complemento de Excel

    Obtenga los resultados de PlanetScale en tiempo real directamente en una hoja de cálculo y actualícelos cuando lo necesite: Excel de escritorio, Excel Online, Microsoft 365.

    Guía de PostgreSQL
  3. PlanetScale a Google Sheets Complemento de hojas

    Ejecuta una consulta de PlanetScale guardada desde la barra lateral y arrastra las filas a la hoja de cálculo. Los colaboradores pueden actualizarla ellos mismos.

    Guía de PostgreSQL
  4. Pregúntale a Nova sobre PlanetScale. Nova AI · texto a SQL

    Haz tu pregunta en lenguaje sencillo. Nova ya conoce tus tablas de PlanetScale, escribe y ejecuta la consulta SQL, explica la respuesta y la representa gráficamente; no necesitas escribir ninguna consulta ni proporcionar credenciales.

    Cómo funciona Nova
  5. PlanetScale a Visor de datos Compartir resultados · equipo, proveedores, socios · teléfono, tableta, ordenador

    Comparta un resultado de PlanetScale en tiempo real con quien desee —un colega, un proveedor, un socio— como una cuadrícula que se puede guardar y que se actualiza automáticamente al abrirla en un teléfono, una tableta o un ordenador. Verán los resultados, nunca el código SQL ni las credenciales.

    Cómo funciona el visor de datos
  6. Para aplicaciones y sistemas
  7. API REST de PlanetScale punto final HTTP

    Publique una consulta de PlanetScale como un punto final JSON autenticado al que cualquier aplicación puede acceder, con una especificación OpenAPI 3.1 y colecciones preconfiguradas para Postman, Insomnia y Hoppscotch. No se abre ningún puerto de base de datos.

    Guía de PostgreSQL
  8. De PlanetScale a Power BI Power Query M

    Pegue la consulta Power Query M generada en el Editor avanzado de Power BI y el informe leerá los resultados de PlanetScale en tiempo real a través de HTTPS, sin necesidad de un controlador ODBC ni de abrir ningún puerto de base de datos.

    Cómo funciona Power BI
  9. PlanetScale a Airtable Plataforma de automatización

    Sincroniza las filas de PlanetScale con una base de datos de Airtable según un cronograma, o recupéralas mediante un script de automatización de Airtable.

    Guía de PostgreSQL
  10. PlanetScale a Baserow Plataforma de automatización

    Alimenta una tabla de Baserow desde PlanetScale a través del punto final REST, ya sea en servidores propios o en la nube de Baserow.

    Guía de PostgreSQL
  11. De la escala planetaria a la mesa marina Plataforma de automatización

    Mantén actualizada una base de datos SeaTable con datos de PlanetScale sin exportar ningún archivo ni exponer la base de datos.

    Guía de PostgreSQL
  12. PlanetScale a Smartsheet Plataforma de automatización

    Introduzca los resultados de PlanetScale en una cuadrícula de Smartsheet para que los planes e informes se lean desde el sistema de origen, y no desde la exportación de la semana pasada.

    Guía de PostgreSQL
  13. PlanetScale a Anvil Anvil Works · Plataforma de aplicaciones

    Realice una copia de seguridad de una aplicación Python de Anvil con PlanetScale a través del punto final REST en lugar de incrustar las credenciales de la base de datos en la aplicación.

    Guía de PostgreSQL
  14. Para herramientas de IA
  15. Servidor PlanetScale MCP Clientes de Claude, Cursor y MCP

    Otorgue a un asistente de IA acceso de solo lectura a PlanetScale con el esquema que necesita para escribir SQL correcto; no se requieren credenciales en el chat.

    Guía de PostgreSQL
  16. Entregado a las personas
  17. Alertas e informes de PlanetScale Slack · Discord · Correo electrónico · Webhook

    Programe una consulta de PlanetScale y haga que las filas se envíen a Slack, Discord, correo electrónico o un webhook firmado, o bien, retenga el mensaje hasta que un recuento de filas, un umbral o un cambio porcentual supere la línea que haya establecido.

    Cómo funcionan las alertas y los informes

Cómo funciona

5 pasos, sin cambios en el firewall de entrada

01

Instale el Agente de red donde le convenga. Abre una conexión saliente y nunca escucha, por lo que PlanetScale ve un cliente normal y su red no necesita ninguna regla de entrada.

02

Copia la cadena de la base de datos, luego Conéctate en la consola de PlanetScale y pégala. Se leen tanto el formato postgresql:// como el formato de palabra clave host=.

03

Deja el modo en PSBouncer Pool a menos que tengas una razón para no hacerlo: puerto 6432 en el mismo host, que es a donde PlanetScale te dirige por defecto.

04

Comprueba que el nombre de usuario conserve el punto. Los nombres de usuario de PlanetScale tienen el formato postgres.<database-id>, y la parte que aparece después del punto es la que te dirige a la base de datos correcta.

05

Guardar. Microsoft Excel, Google Sheets, Power BI, MCP y REST leen a través de esa única conexión o la combinan con sus otras fuentes en una sola instrucción de solo lectura.

Análisis en profundidad de la función

Lo que PlanetScale te ofrece

Esto es PlanetScale Postgres, no PlanetScale MySQL.

PlanetScale fue durante años la empresa Vitess, por lo que conviene ser claros sobre a qué producto se conecta esta tarjeta.

  • Este conector es para PlanetScale Postgres — el servicio Postgres administrado en .horizon.psdb.cloud. Utiliza el protocolo de comunicación de Postgres y el agente se conecta a él con Npgsql.
  • No es compatible con el servicio MySQL basado en Vitess. No existe una configuración predefinida para ello, y una cadena de conexión MySQL de PlanetScale no se ajustará a esta tarjeta.
  • La conexión se guarda como PostgreSQL con PlanetScale como nombre. No existe ningún tipo de conexión llamado PlanetScale. — lo que también significa que una conexión Postgres simple que hayas hecho anteriormente a un host .horizon.psdb.cloud detectará la marca en cuanto la vea.
  • Todo lo que viene después es Postgres estándar: esquemas, tipos y público como esquema predeterminado en una referencia entre fuentes.

PSBouncer es el predeterminado, y el puerto es lo que decide

PlanetScale ejecuta su gestor de conexiones en el mismo nombre de host que el punto final directo, a un puerto de distancia. La tarjeta te conecta por defecto al servidor agrupado porque es ahí a donde PlanetScale te dirige.

  • Directo es el puerto 5432. PSBouncer — El gestor de transacciones de PlanetScale — utiliza el puerto 6432 en el mismo host. No hay ningún otro cambio entre ellos.
  • En el 6432, el agente desactiva las sentencias preparadas y deja de reiniciar la sesión al cerrarla. Un gestor de transacciones puede proporcionarle un backend diferente entre sentencias, y un controlador que asume lo contrario falla de maneras aparentemente aleatorias.
  • El puerto es lo que activa esto, no el menú desplegable. El menú desplegable existe para que la tarjeta pueda evitar que haya discrepancias entre las dos opciones: elegir la conexión compartida con el puerto incorrecto o la conexión directa al puerto 6432, y te avisa antes de guardar, en lugar de después del primer fallo inesperado.
  • No hay que recordar ningún nombre de host agrupado aparte ni un segundo conjunto de credenciales. Basta con cambiar el puerto y listo, el switch funciona perfectamente.

El nombre de usuario tiene un punto, y eso importa.

Es fácil cometer errores sutiles en dos de los cuatro campos, por lo que la tarjeta los revisa ambos.

  • Los nombres de usuario de PlanetScale tienen el formato postgres.<database-id>. Si pegas uno sin el punto, la tarjeta te detendrá, ya que la parte que sigue al punto es la que selecciona la base de datos.
  • Una contraseña con espacios en blanco al principio o al final se marca como sospechosa. Se trata de un artefacto del portapapeles y se considera un error de autenticación común, lo que lleva a los usuarios a buscar el problema equivocado.
  • Todo aquello que no sea una cadena de conexión de Postgres se rechaza con un mensaje que indica dónde se encuentra la correcta, en lugar de ser analizada parcialmente y asignada a campos incorrectos.
  • La cadena de texto pegada nunca se almacena. Se lee una sola vez para rellenar el formulario y luego se elimina, por lo que la contraseña reside en un solo lugar en lugar de dos.
-- Postgres ordinario, solo lectura, a través de PSBouncer o directo SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;

Compartido por todos los conectores de bases de datos

Esto es cierto para todos los conectores de bases de datos.

  • Solo salida — El agente abre una conexión cifrada hacia Query Streams. No hay ningún puerto de entrada que reenviar, ni VPN, ni lista de direcciones IP permitidas, nada de su base de datos queda expuesto a Internet.
  • Las credenciales permanecen en su lugar. — El nombre de usuario y la contraseña de la base de datos se encuentran en la máquina donde instaló el agente. Query Streams nunca los recibe y no puede acceder a su base de datos por sí solo.
  • Solo lectura, obligatorio — Una instrucción a la vez, solo SELECT y similares. La escritura se rechaza en tu máquina antes de enviarse al servidor, en lugar de depender de un permiso que alguien haya configurado.
  • Despliega tantos agentes como quieras. — uno por sitio, región o nube. Todas las fuentes de datos que pueden ver llegan en un único menú desplegable, por lo que nadie tiene que saber qué agente aloja qué.

Lo que obtienes una vez que se guarda una consulta

  • Comparte la capacidad, no el SQL. — Un colega o un socio externo puede ejecutar su consulta y cambiar sus filtros sin ver nunca la instrucción que la respalda.
  • Filtros desde cualquier dirección — declárelas usted mismo como @variables, o deje que el conector detecte los valores literales que ya se encuentran en su cláusula WHERE y los ofrezca como menús desplegables.
  • Léelo desde cualquier lugar — Microsoft Excel, Google Sheets, Power BI, la API REST, los asistentes de IA a través de MCP, el Generador de consultas y Nova leen la misma consulta guardada.
  • Ejecutar varios a la vez — cinco consultas guardadas en cinco pestañas de hojas de cálculo, procesadas simultáneamente, independientemente del tamaño de los resultados.
  • Conéctalo a cualquier otra cosa que tengas conectada. — otra base de datos, una API empresarial o una carpeta de archivos, en una sola instrucción de solo lectura.

SQL entre fuentes

Une PlanetScale al resto de tus datos.

Una sola instrucción puede abarcar PlanetScale y tus otras conexiones simultáneamente. Cada fuente ejecuta solo la parte que puede, transmite el resultado y la unión se realiza de forma centralizada; las fuentes nunca se comunican entre sí y no se copia nada en ningún lugar.

3 conexiones · 3 agentes

PlanetScale Postgres PostgreSQL administrado
Microsoft SQL Server Motor relacional
Raya Pagos y facturación

Una declaración

-- nada copiado, nada fusionado, nada programado
SELECCIONE   c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
DESDE     aplicación psÓrdenes públicas1    f
ÚNASE A     erp_sql.dbo.clientes2   c ON c.id = f.customer_id
ÚNASE A     facturación.stripe.facturas3 i ON i.cliente = c.stripe_id
GRUPO POR región c
ORDENAR POR facturado DESC;

Las tres partes son conexión, esquema y tabla; el nombre de la conexión es el que le hayas dado. Las columnas son solo ilustrativas; tus tablas serán tus tablas. Se aplica el modo de solo lectura a cada elemento: solo SELECT, WITH y EXPLAIN, con un límite en la cantidad de datos que una sola fuente puede proporcionar para una sola consulta. Cómo funcionan las consultas federadas

Detalles de conexión

Lo que necesita PlanetScale

Anfitrión
<nombre>.<región>.horizonte.psdb.cloud
Puerto
6432 para PSBouncer, 5432 directamente. El host es el mismo en ambos casos; la tarjeta usa por defecto el puerto 6432.
Conductor
Npgsql, incluido por el agente; no hay nada que instalar en PlanetScale.
Nombre de usuario
Con puntos, como postgres.<database-id>. La tarjeta comprueba que el punto esté ahí.
TLS
Obligatorio y forzado por el agente para cada host .horizon.psdb.cloud. Cifrado; la cadena de certificados no está verificada.
Agrupación
En el puerto 6432, el agente desactiva las sentencias preparadas y omite el reinicio de la sesión, que es lo que necesita un gestor de agrupación de transacciones.
Guardado como
PostgreSQL, con PlanetScale como distintivo: no existe ningún tipo de conexión llamado PlanetScale.
Esta tarjeta no
Servicio MySQL de PlanetScale con respaldo de Vitess. Este preajuste es solo para el producto Postgres.
Esquema predeterminado
público, que es lo que conlleva una referencia federada

El detalle del pooler es el que justifica su importancia. PlanetScale pone PSBouncer en modo transaccional, lo que significa que la conexión que mantienes no está fijada a un único backend; puedes cambiar de servidor entre dos sentencias. Un controlador de Postgres con su configuración predeterminada asume lo contrario: prepara las sentencias una vez y espera que sigan ahí la próxima vez, y reinicia la sesión al cerrarla. Con un pooler transaccional, ambas suposiciones fallan, y fallan de forma intermitente, lo cual es la peor forma de que algo falle. El agente desactiva ambas cuando detecta el puerto 6432, por lo que no necesitas saber nada de esto.

Especificar el límite del producto tampoco es una cuestión de pedantería. PlanetScale es conocido por Vitess, así que alguien que llegue aquí con una cadena de conexión de PlanetScale bien podría tener una de MySQL. Decir claramente que esta tarjeta es el servicio de PostgreSQL —y que el producto Vitess no tiene una configuración predefinida— solo cuesta una frase y evita una conversación con el soporte técnico.

Para una consulta entre fuentes, PlanetScale funciona como un PostgreSQL estándar. Una conexión que usted denominó ps_app se escribe como ps_app.public.orders y se une a una carpeta de archivos CSV, un sistema de registro local o una API de facturación en una sola instrucción de solo lectura, sin copiar ni programar nada.

Documentación del proveedor: planetscale.com

Preguntas frecuentes

Preguntas sobre PlanetScale Postgres

¿Qué herramientas pueden leer datos de PlanetScale Postgres a través de Query Streams?

Todas ellas, desde una única conexión: Excel, Google Sheets, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, alertas e informes programados. Conecte la base de datos una sola vez y todas las superficies leerán la misma conexión de solo lectura; no se requiere configuración por herramienta ni una segunda copia de los datos.

¿Tengo que abrir un puerto del firewall para mi base de datos Postgres de PlanetScale?

No. El agente de red de Query Streams se ejecuta dentro de su red y abre una única conexión cifrada saliente. No se monitoriza el tráfico entrante, no se requiere VPN y la base de datos conserva sus reglas de firewall existentes.

¿Pueden las consultas de flujo modificar los datos en PlanetScale Postgres?

No. El agente aplica el modo de solo lectura en el punto de ejecución: una instrucción a la vez, solo SELECT y similares. Las credenciales permanecen en el agente y nunca se envían a Query Streams.

¿Qué necesita Query Streams para conectarse a PlanetScale Postgres?

Un host accesible, un rol y su contraseña: el agente lleva el controlador, por lo que no se instala nada en la base de datos. Host: <nombre>.<región>.horizon.psdb.cloud. Puerto: 6432 para PSBouncer, 5432 directo. El mismo host en ambos casos: la tarjeta usa por defecto el puerto 6432. Controlador: Npgsql, llevado por el agente; no hay que instalar nada en el extremo de PlanetScale. Nombre de usuario: con puntos, como postgres.<database-id>. La tarjeta comprueba que el punto esté presente.

¿Puedo unir PlanetScale Postgres con otra base de datos en la misma consulta?

Sí, se trata de una consulta federada. Una sola instrucción puede hacer referencia a PlanetScale Postgres y a sus otras conexiones simultáneamente, escritas como conexión.esquema.tabla. Cada origen ejecuta solo la parte que puede y transmite el resultado; la unión se realiza de forma centralizada, por lo que los orígenes nunca se conectan entre sí y no se copia ni se programa nada. El modo de solo lectura se aplica a cada parte (solo SELECT, WITH y EXPLAIN) y existe un límite en la cantidad de datos que un origen puede transferir para una sola consulta. Las consultas federadas son una característica del plan; la página de consultas federadas muestra los límites actuales de origen y tamaño.

¿Es diferente conectar PlanetScale Postgres a conectar PostgreSQL?

Solo la cadena de conexión. PlanetScale Postgres utiliza el protocolo de red de PostgreSQL, por lo que los filtros, la programación, el uso compartido, los complementos de Excel y Google Sheets, y el servidor MCP funcionan de forma idéntica. La tarjeta PlanetScale rellena automáticamente la configuración de host, puerto y SSL que espera el proveedor.

¿Existe alguna guía para convertir PlanetScale a Excel?

Sí, se trata de la guía de PostgreSQL, y es correcta para PlanetScale Postgres tal como está escrita. PlanetScale utiliza el protocolo de comunicación de PostgreSQL, por lo que la conexión de PlanetScale a Excel, a Google Sheets y a cualquier otro destino sigue los mismos pasos. La única parte específica de PlanetScale es la cadena de conexión, y la tarjeta de PlanetScale la completa automáticamente.

Coloca PlanetScale donde se realiza el trabajo.

Instale el agente, indíquele la ubicación de su base de datos y elija un destino.

Solo lectura Solo salida Las credenciales permanecen en el agente.