¡Bienvenido al mundo de las consultas SQL en HarborDB! Esta guía le enseñará los fundamentos de escribir, ejecutar y gestionar consultas SQL utilizando el potente editor de consultas de HarborDB.

Introducción a SQL en HarborDB

El editor de consultas de HarborDB está diseñado para hacer que escribir y ejecutar consultas SQL sea intuitivo y eficiente. Ya sea que esté recuperando datos, actualizando registros o creando objetos de base de datos, HarborDB proporciona un flujo de trabajo optimizado con características como resaltado de sintaxis, autocompletado y resultados en tiempo real.

Características Clave del Editor de Consultas

Resaltado de Sintaxis: Palabras clave SQL, funciones y literales están codificados por colores para legibilidad
Autocompletado: Nombres de tablas, nombres de columnas y palabras clave SQL se sugieren mientras escribe
Múltiples Pestañas: Trabaje con varias consultas simultáneamente en pestañas separadas
Panel de Resultados: Vea resultados de consultas inmediatamente debajo de su editor
Opciones de Exportación: Exporte resultados a CSV o JSON con un clic
Historial de Consultas: Acceda a consultas ejecutadas recientemente
Marcadores: Guarde consultas de uso frecuente para acceso rápido

Escribiendo Su Primera Consulta

Declaración SELECT Básica

La consulta SQL más fundamental recupera datos de una tabla:

SELECT * FROM usuarios;

Esta consulta:

SELECT *: Devuelve todas las columnas de la tabla
FROM usuarios: Especifica la tabla a consultar
;: Termina la declaración (opcional en HarborDB)

Seleccionando Columnas Específicas

Para recuperar solo columnas específicas:

SELECT nombre, apellido, email FROM usuarios;

Limitar Resultados

Al trabajar con tablas grandes, es una buena práctica limitar resultados:

SELECT * FROM pedidos LIMIT 10;

La Interfaz del Editor de Consultas

Componentes Principales

Área del Editor: Escriba sus consultas SQL aquí
Barra de Herramientas: Controles para ejecutar, cancelar, formatear y exportar
Panel de Resultados: Muestra resultados de consultas e información de ejecución
Barra de Estado: Muestra información de conexión, conteo de filas y tiempo de ejecución

Atajos de Teclado

| Atajo | Acción | | ------------- | ------------------------- | | ⌘ + R | Ejecutar consulta | | ⌘ + . | Cancelar consulta | | ⌘ + T | Nueva pestaña de consulta | | ⌘ + W | Cerrar pestaña actual | | ⌘ + S | Guardar consulta | | ⌘ + F | Buscar en consulta | | ⌘ + / | Alternar comentario | | Tab | Indentar selección | | Shift + Tab | Desindentar selección |

Ejecutando Consultas

Ejecución Paso a Paso

Escriba su consulta en el editor
Haga clic en el botón Ejecutar (▶) o presione ⌘ + R
Vea resultados en el panel de resultados
Verifique información de ejecución en la barra de estado

Ejecución Parcial de Consultas

Puede ejecutar solo parte de una consulta:

Seleccione el texto que desea ejecutar
Haga clic derecho y elija "Ejecutar Selección"
O use el atajo de teclado ⌘ + Shift + R

Resultados de Ejecución

Después de ejecutar una consulta, verá:

Cuadrícula de Resultados: Datos mostrados en una tabla ordenable y filtrable
Conteo de Filas: Número total de filas devueltas
Tiempo de Ejecución: Cuánto tiempo tomó ejecutar la consulta
Mensajes: Cualquier mensaje de PostgreSQL (especialmente para consultas DML)

Filtrando Datos con WHERE

Cláusula WHERE Básica

SELECT * FROM productos WHERE precio > 100;

Múltiples Condiciones

SELECT * FROM pedidos
WHERE estado = 'enviado'
  AND fecha_pedido >= '2024-01-01';

Coincidencia de Patrones con LIKE

SELECT * FROM clientes
WHERE email LIKE '%@gmail.com';

SELECT * FROM productos
WHERE nombre LIKE 'Pro%';

Valores NULL

-- Encontrar filas donde email es NULL
SELECT * FROM usuarios WHERE email IS NULL;

-- Encontrar filas donde email NO es NULL
SELECT * FROM usuarios WHERE email IS NOT NULL;

Ordenando Resultados con ORDER BY

Orden Ascendente (Predeterminado)

SELECT * FROM productos ORDER BY precio;

Orden Descendente

SELECT * FROM productos ORDER BY precio DESC;

Múltiples Columnas de Orden

SELECT * FROM empleados
ORDER BY departamento, apellido, nombre;

Trabajando con Resultados

Viendo Resultados

Desplazar: Navegue por resultados con mouse o teclado
Ordenar: Haga clic en encabezados de columna para ordenar ascendente/descendente
Filtrar: Haga clic derecho en encabezados de columna para filtrar valores
Redimensionar: Arrastre bordes de columnas para ajustar ancho
Reordenar: Arrastre encabezados de columna para reorganizar columnas

Operaciones de Celda

Copiar Celda: Haga doble clic en una celda o presione ⌘ + C
Editar Celda: Haga doble clic y edite (solo para cambios locales)
Ver Contenido Completo: Pase el cursor sobre celdas truncadas para ver información emergente

Exportando Resultados

Haga clic en el botón Exportar en la barra de herramientas
Elija formato: CSV o JSON
Seleccione destino: Guardar en archivo o copiar al portapapeles
Configure opciones: Delimitadores, codificación, encabezados

Guardando y Organizando Consultas

Guardando Consultas

Haga clic en Guardar (⌘ + S) o el icono de guardar
Elija ubicación: Archivo local o biblioteca de HarborDB
Agregue metadatos: Nombre, descripción, etiquetas

Biblioteca de Consultas

Organice consultas guardadas en carpetas:

Favoritas: Marque consultas de uso frecuente
Recientes: Rastree automáticamente consultas usadas recientemente
Etiquetas: Categorice consultas con etiquetas personalizadas

Plantillas de Consultas

Cree plantillas reutilizables para consultas comunes:

-- Plantilla: Encontrar usuarios inactivos
SELECT usuario_id, email, ultimo_acceso
FROM usuarios
WHERE ultimo_acceso < CURRENT_DATE - INTERVAL '90 days'
  AND activo = true;

Patrones Comunes de Consultas

Contando Registros

SELECT COUNT(*) FROM usuarios;
SELECT COUNT(DISTINCT pais) FROM clientes;

Agregando Datos

SELECT
  categoria,
  COUNT(*) as conteo_productos,
  AVG(precio) as precio_promedio,
  MIN(precio) as precio_minimo,
  MAX(precio) as precio_maximo
FROM productos
GROUP BY categoria;

Consultas de Fecha/Hora

-- Pedidos de hoy
SELECT * FROM pedidos WHERE fecha_pedido = CURRENT_DATE;

-- Últimos 7 días
SELECT * FROM registros
WHERE fecha_registro >= CURRENT_DATE - INTERVAL '7 days';

-- Por mes
SELECT
  EXTRACT(MONTH FROM fecha_pedido) as mes,
  COUNT(*) as conteo_pedidos
FROM pedidos
GROUP BY EXTRACT(MONTH FROM fecha_pedido)
ORDER BY mes;

Uniendo Tablas

SELECT
  p.id_pedido,
  p.fecha_pedido,
  c.nombre,
  c.apellido,
  c.email
FROM pedidos p
JOIN clientes c ON p.id_cliente = c.id_cliente
WHERE p.estado = 'completado';

Mejores Prácticas

1. Comience con SELECT *

Al explorar una nueva tabla, use SELECT * para ver todas las columnas, luego refine a columnas específicas.

2. Use LIMIT

Siempre use LIMIT al consultar tablas desconocidas para evitar resultados abrumadores.

3. Formatee Sus Consultas

Use formato consistente para legibilidad:

Palabras clave en mayúsculas
Indentación para consultas complejas
Saltos de línea para cláusulas largas

4. Comente Su Código

Agregue comentarios para consultas complejas:

-- Calcular ingresos mensuales por categoría de producto
-- Excluyendo pedidos reembolsados y cuentas de prueba
SELECT
  DATE_TRUNC('month', fecha_pedido) as mes,
  categoria,
  SUM(monto) as ingresos_totales
FROM pedidos
WHERE estado != 'reembolsado'
  AND id_cliente NOT IN (SELECT id_cliente FROM cuentas_prueba)
GROUP BY DATE_TRUNC('month', fecha_pedido), categoria
ORDER BY mes DESC, ingresos_totales DESC;

5. Pruebe con WHERE 1=0

Para ver estructura de columnas sin obtener datos:

SELECT * FROM tabla_grande WHERE 1=0;

Solución de Problemas Comunes

"La relación no existe"

Verifique ortografía del nombre de tabla y sensibilidad a mayúsculas
Confirme que está conectado a la base de datos correcta
Asegúrese de tener permisos apropiados

"La columna no existe"

Verifique nombres de columnas en la cláusula SELECT
Revise errores tipográficos
Use SELECT * para ver todas las columnas disponibles primero

"Consultas Lentas"

Agregue LIMIT para probar rendimiento
Verifique índices faltantes
Use EXPLAIN para analizar plan de consulta
Considere factores de rendimiento del servidor

"Errores de Conexión"

Verifique que la conexión esté activa
Revise conectividad de red
Confirme que el servidor PostgreSQL esté en ejecución

Próximos Pasos

Ahora que comprende conceptos básicos de consultas:

Practique con sus propias tablas de base de datos
Explore la guía Técnicas Avanzadas de Consultas
Aprenda sobre Exportando Datos
Pruebe técnicas de Optimización de Rendimiento

Referencia Rápida

Cláusulas SQL Esenciales

SELECT - Elegir columnas a devolver
FROM - Especificar tabla a consultar
WHERE - Filtrar filas
ORDER BY - Ordenar resultados
LIMIT - Restringir número de filas
GROUP BY - Agregar datos
HAVING - Filtrar datos agregados

Funciones Comunes

COUNT() - Contar filas
SUM() - Sumar valores
AVG() - Promediar valores
MIN()/MAX() - Encontrar extremos
COALESCE() - Manejar valores NULL
CONCAT() - Combinar cadenas
EXTRACT() - Obtener partes de fecha

Conceptos Básicos de Consultas