PDB Ayuda

Cómo instalar CockroachDB en Windows 11

📅
🕑 6 minutos de lectura

Empezar a trabajar con bases de datos SQL distribuidas en Windows 11 puede resultar un poco intimidante al principio. Quizás estés probando nuevas ideas o simplemente quieras aprender cómo las grandes empresas gestionan la escalabilidad y la alta disponibilidad. Sea cual sea tu motivo, instalar CockroachDB es una excelente opción: 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.

Esta guía abarca todo, desde la descarga y los requisitos del sistema hasta el lanzamiento de tu primer clúster. Además, aprenderás a usar el panel web, ejecutar comandos SQL y crear tu primera base de datos. Aunque no estoy seguro de por qué, a veces Windows puede presentar problemas con las variables de entorno o los puertos de red, así que también he incluido algunos de esos inconvenientes comunes. Al finalizar, tendrás un clúster local de CockroachDB listo para tus necesidades de aprendizaje o pruebas.

Cómo instalar CockroachDB en Windows 11

Descarga y prepara los archivos.

Para empezar, descarga el último archivo ZIP de CockroachDB para Windows desde el sitio web oficial. Normalmente, el sitio detecta tu sistema operativo y te muestra el enlace de descarga correcto, pero asegúrate de descargar la versión para Windows. Una vez descargado, guárdalo en tu carpeta de Descargas (o en el Escritorio si te resulta más fácil).No es necesario ejecutar el instalador: CockroachDB se distribuye como un archivo ZIP, lo cual es práctico porque facilita su uso y lo hace más ligero.

Extrae el archivo ZIP

Haz clic derecho en el archivo ZIP, selecciona «Extraer todo» y elige una ubicación sencilla; yo suelo usar C:\CockroachDB. Así será más fácil encontrarlo después. Tras la extracción, explora la carpeta y localiza cockroach.exeel 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úrate de que todo se descomprima correctamente antes de pasar al siguiente paso.

Mueva la carpeta a una ubicación permanente.

Puede sonar extraño, pero es mejor guardar la carpeta CockroachDB en una ubicación permanente fuera de Descargas o Escritorio, como C:\CockroachDB. Esto ayuda a evitar eliminaciones accidentales y desorden. Si quieres mantener todo ordenado, simplemente cópiala y pégala en C: o Archivos de programa (pero ejecútala como administrador).Windows a veces olvida los archivos en Descargas, especialmente después de actualizaciones o limpiezas.

Agregue CockroachDB a la variable PATH de Windows.

Esta es la parte más importante: lograr que tu sistema reconozca el comando ‘cockroach’ desde cualquier ventana de terminal. Dirígete al menú Inicio, busca Variables de entorno y elige Editar las variables de entorno del sistema. Luego haz clic en Variables de entorno. En Variables del sistema, busca la que se llama Ruta y haz clic en Editar.

  • Haz clic en Nuevo
  • Introduzca la ruta completa donde extrajo CockroachDB, por ejemplo:C:\CockroachDB\cockroach-v25.1.0.windows-6.2-amd64

Es como añadir una nueva carpeta a tu sistema: simplemente haz clic en Aceptar en todos los cuadros de diálogo. De esta forma, puedes abrir el Símbolo del sistema o la Terminal de Windows en cualquier lugar y ejecutar cockroachcomandos sin preocuparte por las carpetas. A veces, Windows necesita reiniciarse para reconocer completamente la nueva ruta, así que no olvides reiniciar si los comandos no se reconocen de inmediato.

Verificar la instalación

Abra la Terminal de Windows o el Símbolo del sistema y escriba:

cockroach version

Pulsa Intro y espera. Si la configuración es correcta, debería aparecer información sobre la versión.¡Genial! Si aparece un mensaje como «cockroach» no reconocido, revisa el paso de configuración de la variable PATH; es posible que falte alguna carpeta o que necesites reiniciar el equipo.

Iniciar un nodo local de CockroachDB

Ahora, es hora de girar la llave y arrancar el motor. Desde la terminal, ejecuta:

cockroach start-single-node --insecure

Esto inicializa un clúster de un solo nodo (ideal para pruebas locales).Es posible que veas varios registros desplazándose por la pantalla; es normal. Una vez que se estabilice y veas una URL como http://localhost:8080, el servidor estará funcionando y la interfaz web será accesible. Mantén esa ventana abierta, ya que el servidor la necesita.

Conéctese a la consola SQL.

Abre otra ventana de terminal y ejecuta:

cockroach sql --insecure

Ahora estás dentro de la consola interactiva. El indicador debería verse así root@localhost:26257/defaultdb>:.Prueba algunos comandos:

  • SHOW DATABASES;
  • CREATE DATABASE mytest;
  • USE mytest;
  • CREATE TABLE users (id INT PRIMARY KEY, name STRING);
  • INSERT INTO users VALUES (1, 'Liam');
  • SELECT * FROM users;

Si todo aparece correctamente, enhorabuena: ahora tienes acceso a la base de datos.

Acceda al panel web

Abre tu navegador y accede a http://localhost:8080. Allí encontrarás estadísticas detalladas, información de los nodos y el rendimiento de las consultas, información útil si quieres comprender el funcionamiento de CockroachDB o monitorizar tu pequeño clúster. Aunque es local, este panel ofrece una visión general de cómo funciona un sistema distribuido real.

Deteniendo el servidor

Cuando termines, no cierres todo sin más. Vuelve a la terminal del servidor y pulsa Ctrl + C. CockroachDB se apagará de forma segura. Espera a que finalice el proceso y luego cierra las ventanas. Esto ayuda a prevenir la corrupción de datos o la ejecución de procesos residuales.

¿Qué puede salir mal (y cómo solucionarlo)?

Comando de cucaracha no encontrado

Si la terminal muestra un error que indica que ‘cockroach’ no se reconoce, casi siempre se trata de un problema con la variable PATH. Verifique que la ruta de la carpeta que agregó anteriormente sea correcta. A veces, reiniciar el equipo lo soluciona; otras veces, es necesario revisar la configuración de las variables de entorno.

¿Windows Defender lo está bloqueando?

Esto puede ocurrir, sobre todo durante las primeras ejecuciones. Si aparecen ventanas emergentes de Seguridad de Windows, simplemente concede permisos o añade una excepción para el archivo cockroach.exe. Es molesto, pero Windows está siendo demasiado precavido.

Conflictos portuarios

CockroachDB usa el puerto 26257 por defecto y el 8080 para el panel de control. Si algún otro programa está usando esos puertos, el servidor no se iniciará. Compruébelo con netstat o el administrador de tareas y detenga la aplicación que causa el conflicto o especifique puertos diferentes con indicadores como --listen-addro --http-addr.

Preguntas frecuentes

¿Es CockroachDB gratuito para Windows 11?

Sí. La versión comunitaria es gratuita, perfecta para pruebas, aprendizaje o proyectos pequeños.

¿Puedo ejecutar CockroachDB sin conexión a internet?

Por supuesto. Una vez descargado e instalado, no se necesita internet; todo funciona localmente.

¿Es apto para principiantes?

Sin duda. Si bien las bases de datos distribuidas pueden parecer complejas, la interfaz de línea de comandos y la interfaz web de CockroachDB las hacen sorprendentemente accesibles para quienes se inician en el tema. Eso sí, prepárate para familiarizarte con algunos conceptos nuevos sobre escalabilidad y tolerancia a fallos.

¿Similar a PostgreSQL?

Sí, admite sintaxis SQL compatible con PostgreSQL, así que si estás acostumbrado a PostgreSQL, la transición debería ser más sencilla.

¿Necesitas Docker?

En absoluto. Puedes instalarlo directamente sin Docker; solo tienes que seguir los pasos anteriores.

¿Puede funcionar con lenguajes de programación?

Por supuesto. Tiene controladores y clientes para lenguajes como Python, Java, Node.js, Go, PHP, o cualquier otro que quieras probar.

Ojalá esto ayude a alguien a completar la configuración inicial sin desesperarse. En un buen día, todo encaja a la perfección.¡Ojalá funcione!