{"id":6759,"date":"2026-05-09T07:17:32","date_gmt":"2026-05-09T07:17:32","guid":{"rendered":"https:\/\/help.peacedoorball.blog\/es\/?p=6759"},"modified":"2026-05-09T07:17:32","modified_gmt":"2026-05-09T07:17:32","slug":"como-instalar-cockroachdb-en-windows-11","status":"publish","type":"post","link":"https:\/\/help.peacedoorball.blog\/es\/como-instalar-cockroachdb-en-windows-11\/","title":{"rendered":"C\u00f3mo instalar CockroachDB en Windows 11"},"content":{"rendered":"<p>Empezar a trabajar con <strong>bases de datos SQL distribuidas<\/strong> en Windows 11 puede resultar un poco intimidante al principio. Quiz\u00e1s est\u00e9s probando nuevas ideas o simplemente quieras aprender c\u00f3mo las grandes empresas gestionan la escalabilidad y la alta disponibilidad. Sea cual sea tu motivo, instalar <strong>CockroachDB<\/strong> es una excelente opci\u00f3n: es moderno, compatible con la nube y muy popular entre los desarrolladores que se inician en sistemas distribuidos. El objetivo es ponerlo en marcha sin problemas para que puedas empezar a experimentar con SQL en un entorno distribuido, todo desde tu ordenador. Puede parecer complicado, pero sinceramente, siguiendo los pasos adecuados, es posible incluso para quienes no tienen experiencia.<\/p>\n<p>Esta gu\u00eda abarca todo, desde la descarga y los requisitos del sistema hasta el lanzamiento de tu primer cl\u00faster. Adem\u00e1s, aprender\u00e1s a usar el panel web, ejecutar comandos SQL y crear tu primera base de datos. Aunque no estoy seguro de por qu\u00e9, a veces Windows puede presentar problemas con las variables de entorno o los puertos de red, as\u00ed que tambi\u00e9n he incluido algunos de esos inconvenientes comunes. Al finalizar, tendr\u00e1s un cl\u00faster local de CockroachDB listo para tus necesidades de aprendizaje o pruebas.<\/p>\n<h2>C\u00f3mo instalar CockroachDB en Windows 11<\/h2>\n<h3>Descarga y prepara los archivos.<\/h3>\n<p>Para empezar, descarga el \u00faltimo archivo ZIP de CockroachDB para Windows desde el <a href=\"https:\/\/www.cockroachlabs.com\/\" rel=\"noopener noreferrer\" target=\"_blank\">sitio web oficial<\/a>. Normalmente, el sitio detecta tu sistema operativo y te muestra el enlace de descarga correcto, pero aseg\u00farate de descargar la versi\u00f3n para Windows. Una vez descargado, gu\u00e1rdalo en tu carpeta <strong>de Descargas<\/strong> (o en el Escritorio si te resulta m\u00e1s f\u00e1cil).No es necesario ejecutar el instalador: CockroachDB se distribuye como un archivo ZIP, lo cual es pr\u00e1ctico porque facilita su uso y lo hace m\u00e1s ligero.<\/p>\n<h3>Extrae el archivo ZIP<\/h3>\n<p>Haz clic derecho en el archivo ZIP, selecciona <strong>\u00abExtraer todo\u00bb<\/strong> y elige una ubicaci\u00f3n sencilla; yo suelo usar <strong>C:\\CockroachDB<\/strong>. As\u00ed ser\u00e1 m\u00e1s f\u00e1cil encontrarlo despu\u00e9s. Tras la extracci\u00f3n, explora la carpeta y localiza <code>cockroach.exe<\/code>el archivo ejecutable principal para interactuar con la base de datos. La verdad es que arrastrar y soltar desde el Explorador de Windows funciona bien, pero aseg\u00farate de que todo se descomprima correctamente antes de pasar al siguiente paso.<\/p>\n<h3>Mueva la carpeta a una ubicaci\u00f3n permanente.<\/h3>\n<p>Puede sonar extra\u00f1o, pero es mejor guardar la carpeta CockroachDB en una ubicaci\u00f3n permanente fuera de Descargas o Escritorio, como <strong>C:\\CockroachDB<\/strong>. Esto ayuda a evitar eliminaciones accidentales y desorden. Si quieres mantener todo ordenado, simplemente c\u00f3piala y p\u00e9gala en C: o Archivos de programa (pero ejec\u00fatala como administrador).Windows a veces olvida los archivos en Descargas, especialmente despu\u00e9s de actualizaciones o limpiezas.<\/p>\n<h3>Agregue CockroachDB a la variable PATH de Windows.<\/h3>\n<p>Esta es la parte m\u00e1s importante: lograr que tu sistema reconozca el comando &#8216;cockroach&#8217; desde cualquier ventana de terminal. Dir\u00edgete al <strong>men\u00fa Inicio<\/strong>, busca <strong>Variables de entorno<\/strong> y elige <strong>Editar las variables de entorno del sistema<\/strong>. Luego haz clic en <strong>Variables de entorno<\/strong>. En <strong>Variables del sistema<\/strong>, busca la que se llama <strong>Ruta<\/strong> y haz clic en <strong>Editar<\/strong>.<\/p>\n<ul>\n<li>Haz clic en <strong>Nuevo<\/strong><\/li>\n<li>Introduzca la ruta completa donde extrajo CockroachDB, por ejemplo:<code>C:\\CockroachDB\\cockroach-v25.1.0.windows-6.2-amd64<\/code><\/li>\n<\/ul>\n<p>Es como a\u00f1adir una nueva carpeta a tu sistema: simplemente haz clic en Aceptar en todos los cuadros de di\u00e1logo. De esta forma, puedes abrir el S\u00edmbolo del sistema o la Terminal de Windows en cualquier lugar y ejecutar <code>cockroach<\/code>comandos sin preocuparte por las carpetas. A veces, Windows necesita reiniciarse para reconocer completamente la nueva ruta, as\u00ed que no olvides reiniciar si los comandos no se reconocen de inmediato.<\/p>\n<h3>Verificar la instalaci\u00f3n<\/h3>\n<p>Abra <strong>la Terminal de Windows<\/strong> o el S\u00edmbolo del sistema y escriba:<\/p>\n<pre><code>cockroach version<\/code><\/pre>\n<p>Pulsa Intro y espera. Si la configuraci\u00f3n es correcta, deber\u00eda aparecer informaci\u00f3n sobre la versi\u00f3n.\u00a1Genial! Si aparece un mensaje como \u00abcockroach\u00bb no reconocido, revisa el paso de configuraci\u00f3n de la variable PATH; es posible que falte alguna carpeta o que necesites reiniciar el equipo.<\/p>\n<h3>Iniciar un nodo local de CockroachDB<\/h3>\n<p>Ahora, es hora de girar la llave y arrancar el motor. Desde la terminal, ejecuta:<\/p>\n<pre><code>cockroach start-single-node --insecure<\/code><\/pre>\n<p>Esto inicializa un cl\u00faster de un solo nodo (ideal para pruebas locales).Es posible que veas varios registros desplaz\u00e1ndose por la pantalla; es normal. Una vez que se estabilice y veas una URL como <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080<\/a>, el servidor estar\u00e1 funcionando y la interfaz web ser\u00e1 accesible. Mant\u00e9n esa ventana abierta, ya que el servidor la necesita.<\/p>\n<h3>Con\u00e9ctese a la consola SQL.<\/h3>\n<p>Abre otra ventana de terminal y ejecuta:<\/p>\n<pre><code>cockroach sql --insecure<\/code><\/pre>\n<p>Ahora est\u00e1s dentro de la consola interactiva. El indicador deber\u00eda verse as\u00ed <code>root@localhost:26257\/defaultdb&gt;<\/code>:.Prueba algunos comandos:<\/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 todo aparece correctamente, enhorabuena: ahora tienes acceso a la base de datos.<\/p>\n<h3>Acceda al panel web<\/h3>\n<p>Abre tu navegador y accede a <a href=\"http:\/\/localhost:8080\" rel=\"noopener noreferrer\" target=\"_blank\">http:\/\/localhost:8080<\/a>. All\u00ed encontrar\u00e1s estad\u00edsticas detalladas, informaci\u00f3n de los nodos y el rendimiento de las consultas, informaci\u00f3n \u00fatil si quieres comprender el funcionamiento de CockroachDB o monitorizar tu peque\u00f1o cl\u00faster. Aunque es local, este panel ofrece una visi\u00f3n general de c\u00f3mo funciona un sistema distribuido real.<\/p>\n<h3>Deteniendo el servidor<\/h3>\n<p>Cuando termines, no cierres todo sin m\u00e1s. Vuelve a la terminal del servidor y pulsa <kbd>Ctrl + C<\/kbd>. CockroachDB se apagar\u00e1 de forma segura. Espera a que finalice el proceso y luego cierra las ventanas. Esto ayuda a prevenir la corrupci\u00f3n de datos o la ejecuci\u00f3n de procesos residuales.<\/p>\n<h2>\u00bfQu\u00e9 puede salir mal (y c\u00f3mo solucionarlo)?<\/h2>\n<h3>Comando de cucaracha no encontrado<\/h3>\n<p>Si la terminal muestra un error que indica que &#8216;cockroach&#8217; no se reconoce, casi siempre se trata de un problema con la variable PATH. Verifique que la ruta de la carpeta que agreg\u00f3 anteriormente sea correcta. A veces, reiniciar el equipo lo soluciona; otras veces, es necesario revisar la configuraci\u00f3n de las variables de entorno.<\/p>\n<h3>\u00bfWindows Defender lo est\u00e1 bloqueando?<\/h3>\n<p>Esto puede ocurrir, sobre todo durante las primeras ejecuciones. Si aparecen ventanas emergentes de Seguridad de Windows, simplemente concede permisos o a\u00f1ade una excepci\u00f3n para el archivo cockroach.exe. Es molesto, pero Windows est\u00e1 siendo demasiado precavido.<\/p>\n<h3>Conflictos portuarios<\/h3>\n<p>CockroachDB usa el puerto 26257 por defecto y el 8080 para el panel de control. Si alg\u00fan otro programa est\u00e1 usando esos puertos, el servidor no se iniciar\u00e1. Compru\u00e9belo con <a href=\"https:\/\/netstat.io\/\" rel=\"noopener noreferrer\" target=\"_blank\">netstat<\/a> o el administrador de tareas y detenga la aplicaci\u00f3n que causa el conflicto o especifique puertos diferentes con indicadores como <code>--listen-addr<\/code>o <code>--http-addr<\/code>.<\/p>\n<h2>Preguntas frecuentes<\/h2>\n<h3>\u00bfEs CockroachDB gratuito para Windows 11?<\/h3>\n<p>S\u00ed. La versi\u00f3n comunitaria es gratuita, perfecta para pruebas, aprendizaje o proyectos peque\u00f1os.<\/p>\n<h3>\u00bfPuedo ejecutar CockroachDB sin conexi\u00f3n a internet?<\/h3>\n<p>Por supuesto. Una vez descargado e instalado, no se necesita internet; todo funciona localmente.<\/p>\n<h3>\u00bfEs apto para principiantes?<\/h3>\n<p>Sin duda. Si bien las bases de datos distribuidas pueden parecer complejas, la interfaz de l\u00ednea de comandos y la interfaz web de CockroachDB las hacen sorprendentemente accesibles para quienes se inician en el tema. Eso s\u00ed, prep\u00e1rate para familiarizarte con algunos conceptos nuevos sobre escalabilidad y tolerancia a fallos.<\/p>\n<h3>\u00bfSimilar a PostgreSQL?<\/h3>\n<p>S\u00ed, admite sintaxis SQL compatible con PostgreSQL, as\u00ed que si est\u00e1s acostumbrado a PostgreSQL, la transici\u00f3n deber\u00eda ser m\u00e1s sencilla.<\/p>\n<h3>\u00bfNecesitas Docker?<\/h3>\n<p>En absoluto. Puedes instalarlo directamente sin Docker; solo tienes que seguir los pasos anteriores.<\/p>\n<h3>\u00bfPuede funcionar con lenguajes de programaci\u00f3n?<\/h3>\n<p>Por supuesto. Tiene controladores y clientes para lenguajes como Python, Java, Node.js, Go, PHP, o cualquier otro que quieras probar.<\/p>\n<p>Ojal\u00e1 esto ayude a alguien a completar la configuraci\u00f3n inicial sin desesperarse. En un buen d\u00eda, todo encaja a la perfecci\u00f3n.\u00a1Ojal\u00e1 funcione!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Empezar a trabajar con bases de datos SQL distribuidas en Windows 11 puede resultar un poco intimidante al principio. Quiz\u00e1s est\u00e9s probando nuevas ideas o<\/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-6759","post","type-post","status-publish","format-standard","hentry","category-ayuda"],"_links":{"self":[{"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/posts\/6759","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/comments?post=6759"}],"version-history":[{"count":0,"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/posts\/6759\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/media?parent=6759"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/categories?post=6759"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.peacedoorball.blog\/es\/wp-json\/wp\/v2\/tags?post=6759"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}