{"id":6732,"date":"2026-05-09T07:17:32","date_gmt":"2026-05-09T07:17:32","guid":{"rendered":"https:\/\/help.peacedoorball.blog\/ca\/?p=6732"},"modified":"2026-05-09T07:17:32","modified_gmt":"2026-05-09T07:17:32","slug":"comment-installer-cockroachdb-sur-windows-11","status":"publish","type":"post","link":"https:\/\/help.peacedoorball.blog\/ca\/comment-installer-cockroachdb-sur-windows-11\/","title":{"rendered":"Comment installer CockroachDB sur Windows 11"},"content":{"rendered":"<p>Se familiariser avec <strong>les bases de donn\u00e9es SQL distribu\u00e9es<\/strong> sous Windows 11 peut sembler un peu intimidant au premier abord. Peut-\u00eatre souhaitez-vous tester de nouvelles id\u00e9es ou simplement d\u00e9couvrir comment les professionnels g\u00e8rent la mise \u00e0 l&rsquo;\u00e9chelle et la haute disponibilit\u00e9. Quelle que soit votre raison, installer <strong>CockroachDB<\/strong> est un excellent choix : moderne, compatible avec le cloud et tr\u00e8s populaire aupr\u00e8s des d\u00e9veloppeurs qui s&rsquo;int\u00e9ressent aux syst\u00e8mes distribu\u00e9s, CockroachDB est la solution id\u00e9ale. L&rsquo;objectif est de la configurer et de la faire fonctionner correctement afin que vous puissiez commencer \u00e0 exp\u00e9rimenter avec SQL dans un environnement distribu\u00e9, directement sur votre machine locale. Cela peut para\u00eetre compliqu\u00e9, mais en r\u00e9alit\u00e9, avec les bonnes \u00e9tapes, c&rsquo;est tout \u00e0 fait faisable, m\u00eame pour les d\u00e9butants.<\/p>\n<p>Ce guide vous accompagne pas \u00e0 pas, du t\u00e9l\u00e9chargement \u00e0 la configuration syst\u00e8me requise, jusqu&rsquo;au lancement de votre premier cluster. En bonus : vous d\u00e9couvrirez le fonctionnement du tableau de bord web, l&rsquo;ex\u00e9cution de commandes SQL et la cr\u00e9ation de votre premi\u00e8re base de donn\u00e9es. Il arrive parfois que Windows rencontre des probl\u00e8mes avec les variables d&rsquo;environnement ou les ports r\u00e9seau ; c&rsquo;est pourquoi j&rsquo;ai \u00e9galement inclus quelques solutions \u00e0 ces difficult\u00e9s courantes.\u00c0 la fin de ce guide, vous disposerez d&rsquo;un cluster CockroachDB local, pr\u00eat \u00e0 r\u00e9pondre \u00e0 vos besoins d&rsquo;apprentissage ou de test.<\/p>\n<h2>Comment installer CockroachDB sur Windows 11<\/h2>\n<h3>T\u00e9l\u00e9chargez et pr\u00e9parez les fichiers<\/h3>\n<p>Commencez par t\u00e9l\u00e9charger le fichier ZIP de CockroachDB pour Windows depuis le <a href=\"https:\/\/www.cockroachlabs.com\/\" rel=\"noopener noreferrer\" target=\"_blank\">site officiel<\/a>. En g\u00e9n\u00e9ral, le site d\u00e9tecte votre syst\u00e8me d&rsquo;exploitation et vous propose le lien de t\u00e9l\u00e9chargement appropri\u00e9, mais v\u00e9rifiez tout de m\u00eame qu&rsquo;il s&rsquo;agit bien de la version Windows. Une fois le t\u00e9l\u00e9chargement termin\u00e9, enregistrez le fichier dans votre dossier <strong>T\u00e9l\u00e9chargements<\/strong> (ou sur votre Bureau, si vous pr\u00e9f\u00e9rez).Inutile d&rsquo;ex\u00e9cuter le programme d&rsquo;installation : CockroachDB est fourni sous forme d&rsquo;archive ZIP, ce qui est pratique car cela garantit flexibilit\u00e9 et l\u00e9g\u00e8ret\u00e9.<\/p>\n<h3>Extraire le fichier ZIP<\/h3>\n<p>Faites un clic droit sur le fichier ZIP, s\u00e9lectionnez <strong>\u00ab Extraire tout \u00bb<\/strong>, puis choisissez un emplacement simple ; j\u2019utilise g\u00e9n\u00e9ralement <strong>C:\\CockroachDB<\/strong>. Cela facilite sa recherche ult\u00e9rieure. Une fois l\u2019extraction termin\u00e9e, explorez le dossier et localisez le fichier <code>cockroach.exe<\/code>principal. Il s\u2019agit de l\u2019ex\u00e9cutable permettant d\u2019interagir avec la base de donn\u00e9es. Honn\u00eatement, le glisser-d\u00e9poser via l\u2019Explorateur Windows fonctionne parfaitement, mais assurez-vous que la d\u00e9compression se d\u00e9roule correctement avant de passer \u00e0 l\u2019\u00e9tape suivante.<\/p>\n<h3>D\u00e9placez le dossier vers un emplacement permanent.<\/h3>\n<p>C&rsquo;est un peu \u00e9trange, mais il est pr\u00e9f\u00e9rable de conserver votre dossier CockroachDB \u00e0 un emplacement permanent, en dehors du dossier T\u00e9l\u00e9chargements ou du Bureau, par exemple <strong>C:\\CockroachDB<\/strong>. Cela permet d&rsquo;\u00e9viter les suppressions accidentelles et l&rsquo;encombrement. Si vous souhaitez garder votre syst\u00e8me bien organis\u00e9, vous pouvez simplement le copier-coller dans C:\\Program Files (mais assurez-vous d&rsquo;ex\u00e9cuter la commande en tant qu&rsquo;administrateur).Windows a parfois tendance \u00e0 oublier les fichiers pr\u00e9sents dans le dossier T\u00e9l\u00e9chargements, notamment apr\u00e8s des mises \u00e0 jour ou un nettoyage.<\/p>\n<h3>Ajoutez CockroachDB au PATH Windows.<\/h3>\n<p>Voici l&rsquo;\u00e9tape la plus cruciale : configurer votre syst\u00e8me pour qu&rsquo;il reconnaisse la commande \u00ab cockroach \u00bb depuis n&rsquo;importe quelle fen\u00eatre de terminal. Acc\u00e9dez au <strong>menu D\u00e9marrer<\/strong>, recherchez <strong>\u00ab Variables d&rsquo;environnement \u00bb<\/strong>, puis s\u00e9lectionnez <strong>\u00ab Modifier les variables d&rsquo;environnement syst\u00e8me \u00bb<\/strong>. Cliquez ensuite sur \u00ab<strong> Variables d&rsquo;environnement \u00bb<\/strong>. Dans la section <strong>\u00ab Variables syst\u00e8me \u00bb<\/strong>, rep\u00e9rez la variable nomm\u00e9e <strong>\u00ab Path \u00bb<\/strong> et cliquez sur <strong>\u00ab Modifier \u00bb<\/strong>.<\/p>\n<ul>\n<li>Cliquez sur <strong>Nouveau<\/strong><\/li>\n<li>Saisissez le chemin complet vers l&#8217;emplacement o\u00f9 vous avez extrait CockroachDB, par exemple :<code>C:\\CockroachDB\\cockroach-v25.1.0.windows-6.2-amd64<\/code><\/li>\n<\/ul>\n<p>La proc\u00e9dure est la m\u00eame que pour l&rsquo;ajout d&rsquo;un nouveau dossier \u00e0 votre syst\u00e8me : cliquez sur OK dans toutes les bo\u00eetes de dialogue. Vous pourrez ainsi ouvrir l&rsquo;invite de commandes ou le Terminal Windows depuis n&rsquo;importe quel emplacement et ex\u00e9cuter <code>cockroach<\/code>des commandes sans vous soucier des dossiers. Il arrive que Windows ait besoin d&rsquo;\u00eatre red\u00e9marr\u00e9 pour que la nouvelle variable d&rsquo;environnement PATH soit correctement prise en compte ; si les commandes ne sont pas reconnues imm\u00e9diatement, n&rsquo;oubliez pas cette \u00e9tape.<\/p>\n<h3>V\u00e9rifiez l&rsquo;installation<\/h3>\n<p>Ouvrez <strong>le Terminal Windows<\/strong> ou l&rsquo;Invite de commandes et tapez :<\/p>\n<pre><code>cockroach version<\/code><\/pre>\n<p>Appuyez sur Entr\u00e9e et patientez. Si la configuration est correcte, des informations de version devraient s&rsquo;afficher. Parfait ! Si un message d&rsquo;erreur du type \u00ab cockroach \u00bb n&rsquo;est pas reconnu s&rsquo;affiche, v\u00e9rifiez \u00e0 nouveau la configuration du chemin d&rsquo;acc\u00e8s (PATH) : il se peut que vous ayez oubli\u00e9 un dossier ou que vous deviez red\u00e9marrer votre ordinateur.<\/p>\n<h3>D\u00e9marrer un n\u0153ud CockroachDB local<\/h3>\n<p>Il est temps maintenant de tourner la cl\u00e9 et de d\u00e9marrer le moteur. Dans le terminal, ex\u00e9cutez :<\/p>\n<pre><code>cockroach start-single-node --insecure<\/code><\/pre>\n<p>Cela initialise un cluster \u00e0 n\u0153ud unique (id\u00e9al pour les tests locaux).Il est normal de voir d\u00e9filer des journaux. Une fois le syst\u00e8me stabilis\u00e9 et l&rsquo;URL <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080 affich\u00e9e<\/a>, le serveur est en cours d&rsquo;ex\u00e9cution et l&rsquo;interface web est accessible. Laissez cette fen\u00eatre ouverte, car le serveur en d\u00e9pend.<\/p>\n<h3>Se connecter \u00e0 l&rsquo;interface SQL Shell<\/h3>\n<p>Ouvrez une autre fen\u00eatre de terminal et ex\u00e9cutez :<\/p>\n<pre><code>cockroach sql --insecure<\/code><\/pre>\n<p>Vous \u00eates maintenant dans l&rsquo;interpr\u00e9teur de commandes interactif. L&rsquo;invite de commande devrait ressembler \u00e0 ceci<code>root@localhost:26257\/defaultdb&gt;<\/code> : Essayez quelques commandes :<\/p>\n<ul>\n<li><code>SHOW DATABASES;<\/code><\/li>\n<li><code>CREATE DATABASE mytest;<\/code><\/li>\n<li><code>USE mytest;<\/code><\/li>\n<li><code>CREATE TABLE users (id INT PRIMARY KEY, name STRING);<\/code><\/li>\n<li><code>INSERT INTO users VALUES (1, 'Liam');<\/code><\/li>\n<li><code>SELECT * FROM users;<\/code><\/li>\n<\/ul>\n<p>Si tout semble correct, f\u00e9licitations \u2014 la base de donn\u00e9es est d\u00e9sormais \u00e0 vous.<\/p>\n<h3>Acc\u00e9der au tableau de bord Web<\/h3>\n<p>Ouvrez votre navigateur et acc\u00e9dez \u00e0 <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080<\/a>. Vous y trouverez des statistiques d\u00e9taill\u00e9es, des informations sur les n\u0153uds et les performances des requ\u00eates \u2014 utiles pour comprendre le comportement de CockroachDB ou pour surveiller votre petit cluster. Bien que local, ce tableau de bord offre un aper\u00e7u du fonctionnement d&rsquo;un v\u00e9ritable syst\u00e8me distribu\u00e9.<\/p>\n<h3>Arr\u00eat du serveur<\/h3>\n<p>Une fois termin\u00e9, ne fermez pas tout brusquement. Retournez \u00e0 votre terminal serveur et appuyez sur la touche appropri\u00e9e <kbd>Ctrl + C<\/kbd>. CockroachDB s&rsquo;arr\u00eatera correctement. Attendez la fin de l&rsquo;op\u00e9ration, puis fermez vos fen\u00eatres. Cela permet d&rsquo;\u00e9viter toute corruption de donn\u00e9es ou tout processus persistant.<\/p>\n<h2>Ce qui peut mal tourner (et comment y rem\u00e9dier)<\/h2>\n<h3>Commande Cafard introuvable<\/h3>\n<p>Si votre terminal affiche une erreur indiquant que \u00ab cockroach \u00bb n&rsquo;est pas reconnu, il s&rsquo;agit presque toujours d&rsquo;un probl\u00e8me de variable d&rsquo;environnement PATH. V\u00e9rifiez que le chemin du dossier que vous avez ajout\u00e9 pr\u00e9c\u00e9demment est correct. Un red\u00e9marrage peut parfois r\u00e9soudre le probl\u00e8me ; il peut aussi \u00eatre n\u00e9cessaire de revoir la configuration des variables d&rsquo;environnement.<\/p>\n<h3>Windows Defender le bloque-t-il ?<\/h3>\n<p>Cela peut arriver, surtout lors des premi\u00e8res ex\u00e9cutions. Si des fen\u00eatres contextuelles de S\u00e9curit\u00e9 Windows s&rsquo;affichent, accordez simplement l&rsquo;autorisation ou ajoutez une exception pour le fichier cockroach.exe. C&rsquo;est aga\u00e7ant, mais Windows fait preuve d&rsquo;une prudence excessive.<\/p>\n<h3>Conflits portuaires<\/h3>\n<p>CockroachDB utilise le port 26257 par d\u00e9faut et le port 8080 pour le tableau de bord. Si un autre programme utilise ces ports, le serveur ne d\u00e9marrera pas. V\u00e9rifiez avec <a href=\"https:\/\/netstat.io\/\" rel=\"noopener noreferrer\" target=\"_blank\">netstat<\/a> ou votre gestionnaire de t\u00e2ches, puis arr\u00eatez l&rsquo;application en conflit ou sp\u00e9cifiez d&rsquo;autres ports avec des options comme `&#8211;port` <code>--listen-addr<\/code>ou ` &#8211;port` <code>--http-addr<\/code>.<\/p>\n<h2>FAQ<\/h2>\n<h3>CockroachDB est-il gratuit pour Windows 11 ?<\/h3>\n<p>Oui. La version communautaire est gratuite, id\u00e9ale pour les tests, l&rsquo;apprentissage ou les petits projets.<\/p>\n<h3>Est-il possible d&rsquo;ex\u00e9cuter CockroachDB hors ligne ?<\/h3>\n<p>Absolument. Une fois t\u00e9l\u00e9charg\u00e9 et install\u00e9, aucune connexion internet n&rsquo;est n\u00e9cessaire ; tout fonctionne en local.<\/p>\n<h3>Est-ce adapt\u00e9 aux d\u00e9butants ?<\/h3>\n<p>Absolument. Bien que les bases de donn\u00e9es distribu\u00e9es puissent para\u00eetre complexes, l&rsquo;interface en ligne de commande et l&rsquo;interface web de CockroachDB les rendent \u00e9tonnamment accessibles aux d\u00e9butants. Pr\u00e9parez-vous simplement \u00e0 d\u00e9couvrir de nouveaux concepts li\u00e9s \u00e0 la mise \u00e0 l&rsquo;\u00e9chelle et \u00e0 la tol\u00e9rance aux pannes.<\/p>\n<h3>Similaire \u00e0 PostgreSQL ?<\/h3>\n<p>Oui, il prend en charge la syntaxe SQL compatible avec PostgreSQL, donc si vous \u00eates habitu\u00e9 \u00e0 PostgreSQL, la transition devrait se faire en douceur.<\/p>\n<h3>Docker est-il n\u00e9cessaire ?<\/h3>\n<p>Pas du tout. Vous pouvez l&rsquo;installer directement sans Docker ; il suffit de suivre les \u00e9tapes ci-dessus.<\/p>\n<h3>Est-ce compatible avec les langages de programmation ?<\/h3>\n<p>Absolument. Il propose des pilotes et des clients pour des langages comme Python, Java, Node.js, Go, PHP \u2014 tout ce que vous souhaitez essayer.<\/p>\n<p>J&rsquo;esp\u00e8re que ce guide permettra \u00e0 certains de r\u00e9ussir l&rsquo;installation initiale sans s&rsquo;arracher les cheveux. En g\u00e9n\u00e9ral, tout s&#8217;embo\u00eete parfaitement. Croisons les doigts !<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Se familiariser avec les bases de donn\u00e9es SQL distribu\u00e9es sous Windows 11 peut sembler un peu intimidant au premier abord. Peut-\u00eatre souhaitez-vous tester de nouvelles<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-6732","post","type-post","status-publish","format-standard","hentry","category-aide"],"_links":{"self":[{"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/posts\/6732","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/comments?post=6732"}],"version-history":[{"count":0,"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/posts\/6732\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/media?parent=6732"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/categories?post=6732"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/ca\/wp-json\/wp\/v2\/tags?post=6732"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}