CockroachDB
Connectez QoreDB à CockroachDB. Protocole filaire compatible Postgres, port 26257, avec quelques ajustements de navigation dans le schéma spécifiques à CockroachDB.
CockroachDB parle le protocole filaire de PostgreSQL, QoreDB s'y connecte donc via la même pile client que PostgreSQL. Le pilote dédié à CockroachDB est une couche fine superposée : même format DSN, même histoire SSL, mais avec quelques détails de navigation dans les schémas ajustés pour correspondre aux catalogues de CockroachDB et un port par défaut 26257.
Connexion rapide
Collez un DSN de type Postgres et choisissez le moteur CockroachDB. Le port par défaut est 26257 et non 5432.
postgresql://UTILISATEUR:MOTDEPASSE@HOTE:26257/BASEDEDONNEES
postgresql://UTILISATEUR:MOTDEPASSE@HOTE:26257/BASEDEDONNEES?sslmode=verify-full
Si vous ne spécifiez pas de base de données, QoreDB utilise par défaut defaultdb, qui est ce avec quoi CockroachDB est livré.
Champs de connexion
| Champ | Requis | Remarques |
|---|---|---|
| Hôte (Host) | Oui | Nom d'hôte ou IP. URL du cluster pour les services gérés. |
| Port | Oui | Par défaut 26257. |
| Utilisateur | Oui | Utilisateur de la base de données. |
| Mot de passe | Optionnel | Stocké chiffré dans le coffre-fort. |
| Base de données | Optionnel | Par défaut defaultdb si omis. |
| Mode SSL | Optionnel | L'un de disable, prefer, require, verify-ca, verify-full. |
SSL / TLS
Mêmes modes que PostgreSQL :
| Mode | Chiffré ? | Certificat serveur vérifié ? | Nom d'hôte serveur vérifié ? |
|---|---|---|---|
disable | Non | Non | Non |
prefer | Si offert | Non | Non |
require | Oui | Non | Non |
verify-ca | Oui | Oui | Non |
verify-full | Oui | Oui | Oui |
CockroachDB Cloud (Serverless et Dedicated) nécessite verify-full et est fourni avec un certificat CA public. Les clusters auto-gérés configurent généralement leur propre CA ; vous devrez pointer le client vers elle (hors du champ d'application de QoreDB ; assurez-vous que le certificat est approuvé par votre OS ou que le fichier CA est sur votre système).
CockroachDB Cloud
Récupérez la chaîne de connexion dans le panneau "Connect" du cluster :
postgresql://USER:PASSWORD@CLUSTER-NAME-XXXX.cloud.cockroachlabs.cloud:26257/defaultdb?sslmode=verify-full
Collez-la dans le champ URL et cliquez sur Analyser (Parse). Le SSL est requis par défaut pour les clusters Cloud.
Différences avec PostgreSQL
CockroachDB est compatible avec le protocole filaire de Postgres, mais le moteur sous-jacent est différent. Quelques points pratiques apparaissent dans le navigateur de schémas de QoreDB :
- Les catalogues système sont filtrés : les espaces de noms
crdb_internaletpg_extensionsont masqués de l'arborescence des schémas car ils constituent du bruit pour le travail applicatif. - Tables et vues uniquement : CockroachDB n'a pas de vues matérialisées, donc l'arborescence des schémas affiche des tables et des vues régulières, pas de nœud de vue matérialisée.
- La maintenance est limitée : là où Postgres expose
VACUUM,ANALYZE,REINDEXet consorts, CockroachDB n'expose queANALYZE(il gère le reste lui-même avec des tâches intégrées). Les menus de maintenance reflètent cela.
Au quotidien, vos requêtes sont identiques à celles de PostgreSQL. Les différences pratiques les plus importantes se situent au niveau de la couche applicative (le modèle de transaction de CockroachDB réessaie les conflits de sérialisation plus agressivement, pas de déclencheurs au niveau des lignes, gestion des TIMESTAMP légèrement différente), et non dans QoreDB lui-même.
Problèmes courants
Où aller ensuite
- Tunneling SSH pour les clusters derrière un bastion
- PostgreSQL pour l'écosystème PG plus large
- Interrogation : éditeur et autocomplétion pour l'éditeur SQL
Restez informé des nouveautés
Rejoignez notre newsletter pour recevoir les mises à jour majeures, les nouveaux drivers et nos coulisses techniques.