Connecter PostgreSQL à l'échelle planétaire vers Excel, Google Sheets, l'IA et REST

Il s'agit de PlanetScale Postgres, et non de PlanetScale MySQL.

PlanetScale a passé des années sous le nom de Vitess, il est donc important d'être clair sur le produit auquel cette carte se connecte.

• Ce connecteur est destiné à PlanetScale Postgres. — le service Postgres géré sur .horizon.psdb.cloud. Il utilise le protocole Postgres et l'agent s'y connecte via Npgsql.
• Ce n'est pas compatible avec le service MySQL basé sur Vitess. Il n'existe pas de configuration prédéfinie pour cela, et une chaîne de connexion MySQL de PlanetScale ne fonctionnera pas avec cette carte.
• La connexion est enregistrée au format PostgreSQL, PlanetScale étant conservé comme logo. Il n'existe pas de type de connexion nommé PlanetScale. — ce qui signifie également qu'une simple connexion Postgres que vous avez établie précédemment avec un hôte .horizon.psdb.cloud affichera la marque dès sa réception.
• Tout ce qui suit est du Postgres ordinaire : schémas, types et public comme schéma par défaut dans une référence inter-sources.

PSBouncer est le logiciel par défaut, et c'est le port qui détermine le logiciel.

PlanetScale exécute son pool de serveurs sur le même nom d'hôte que le point de terminaison direct, sur un port différent. La carte vous connecte par défaut au serveur du pool, car c'est celui que PlanetScale utilise.

• Le port direct est le 5432. PSBouncer Le pool de transactions de PlanetScale utilise le port 6432 sur le même hôte. Rien d'autre ne change entre les deux.
• Sur la version 6432, l'agent désactive les requêtes préparées et cesse de réinitialiser la session à la fermeture. Un gestionnaire de pool de transactions peut vous fournir un backend différent entre les requêtes, et un pilote qui suppose le contraire peut rencontrer des défaillances apparemment aléatoires.
• C'est le port qui déclenche cela, pas le menu déroulant. Ce dernier permet à la carte d'éviter les incompatibilités : choix d'une connexion groupée avec un port incorrect ou connexion directe sur le port 6432. Le système vous avertit avant l'enregistrement, et non après le premier échec.
• Il n'y a pas de nom d'hôte distinct à retenir ni de deuxième paire d'identifiants. Il suffit de changer le port, et c'est tout.

Le nom d'utilisateur contient un point, et c'est important.

Deux des quatre champs sont faciles à mal renseigner subtilement, la carte vérifie donc les deux.

• Les noms d'utilisateur PlanetScale prennent la forme postgres.<identifiant-de-la-base-de-données>. Si vous en collez un sans le point, la carte vous bloque, car c'est la partie après le point qui sélectionne la base de données.
• Un mot de passe contenant des espaces en début ou en fin de mot de passe est signalé. Il s'agit d'un artefact du presse-papiers, et cela provoque une erreur d'authentification ordinaire, induisant ainsi les utilisateurs en erreur.
• Tout ce qui n'est pas une chaîne de connexion Postgres est rejeté avec un message indiquant où se trouve la bonne chaîne, plutôt que d'être partiellement analysé et placé dans les mauvais champs.
• La chaîne de caractères collée n'est jamais stockée. Elle est lue une seule fois pour remplir le formulaire, puis supprimée ; le mot de passe est donc conservé à un seul endroit.

-- Postgres ordinaire, en lecture seule, via PSBouncer ou directement 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;