¡Bienvenido a la guía de navegación de base de datos! HarborDB proporciona herramientas poderosas para explorar y comprender sus bases de datos PostgreSQL. Esta guía le mostrará cómo navegar efectivamente por la estructura de su base de datos, examinar tablas y relaciones, y aprovechar al máximo la interfaz visual de HarborDB.

La Interfaz de Navegación

Vista General de la Barra Lateral

La barra lateral izquierda es su herramienta principal de navegación. Muestra una vista jerárquica de la estructura de su base de datos:

Nombre de Conexión
├── Bases de Datos
│   ├── Base de Datos 1
│   │   ├── Esquemas
│   │   │   ├── public
│   │   │   │   ├── Tablas
│   │   │   │   ├── Vistas
│   │   │   │   ├── Funciones
│   │   │   │   └── Secuencias
│   │   │   └── otros_esquemas
│   │   └── Configuraciones
│   └── Base de Datos 2
└── Objetos del Sistema

Modos de Navegación

HarborDB ofrece dos modos principales de navegación:

Vista de Árbol (Predeterminada): Expansión jerárquica de objetos
Vista de Búsqueda: Búsqueda rápida en todos los objetos

Explorando Bases de Datos

Viendo Bases de Datos Disponibles

Cuando se conecte por primera vez, verá una lista de bases de datos a las que tiene acceso:

Expanda su conexión en la barra lateral
Haga clic en "Bases de Datos" para ver la lista
Haga doble clic en cualquier base de datos para explorar su contenido

Información de Base de Datos

Haga clic derecho en cualquier base de datos para acceso rápido a:

Propiedades: Ver tamaño de base de datos, codificación, intercalación
Nueva Pestaña de Consulta: Abrir editor de consultas pre-conectado a esta base de datos
Actualizar: Actualizar la lista de bases de datos
Crear Base de Datos: Si tiene permisos

Trabajando con Esquemas

Comprend

iendo los Esquemas

Los esquemas son contenedores lógicos dentro de las bases de datos. PostgreSQL utiliza por defecto el esquema public, pero puede encontrar otros.

Explorando Contenido de Esquemas

Expanda una base de datos para ver sus esquemas
Expanda un esquema para ver tipos de objetos:
- Tablas: Almacenamiento de datos
- Vistas: Tablas virtuales a partir de consultas
- Funciones: Procedimientos y funciones almacenados
- Secuencias: Generadores de números autoincrementales

Operaciones con Esquemas

Haga clic derecho en un esquema para:

Crear Nueva Tabla/Vista/Función
Actualizar contenido del esquema
Establecer como Predeterminado: Hacer de este su esquema preferido

Examinando Tablas

Vista de Estructura de Tabla

Cuando expanda la carpeta "Tablas", verá todas las tablas en el esquema. Haga clic en cualquier tabla para ver:

Pestaña Columnas

Nombres de columnas y tipos de datos
Restricciones (Clave Primaria, Clave Externa, etc.)
Valores predeterminados y estado nullable
Información de almacenamiento

Pestaña Vista Previa de Datos

Primeras 100 filas de datos de la tabla
Columnas ordenables (haga clic en los encabezados)
Datos filtrables (haga clic derecho en encabezados de columna)
Opciones de exportación rápida

Pestaña Índices

Nombres de índices y tipos
Columnas indexadas
Tamaño de índice y estadísticas

Pestaña Claves Externas

Relaciones con otras tablas
Tablas y columnas referenciadas
Reglas de cascada

Acciones Rápidas de Tabla

Haga clic derecho en cualquier tabla para acceso instantáneo a:

| Acción | Descripción | Atajo de Teclado | | ------------------- | ----------------------------------------------- | ---------------- | | Seleccionar Top 100 | Abrir consulta con SELECT * FROM tabla LIMIT 100 | ⌘ + Clic | | Ver Estructura | Abrir estructura de tabla en vista detallada | ⌥ + Clic | | Generar SELECT | Crear consulta SELECT básica para esta tabla | | | Generar INSERT | Crear plantilla INSERT | | | Exportar Datos | Exportar tabla a CSV/JSON | ⌘ + E | | Actualizar | Actualizar información de tabla | ⌘ + R |

Comprendiendo las Vistas

Vista vs Tabla

Las vistas aparecen similares a las tablas pero son objetos virtuales basados en consultas SQL:

Vistas Regulares: Definiciones de consultas almacenadas
Vistas Materializadas: Resultados precalculados (en caché)

Información de Vista

Haga clic en cualquier vista para ver:

Definición: La consulta SQL que define la vista
Columnas: Estructura del conjunto de resultados
Dependencias: Tablas y vistas de las que depende esta vista

Trabajando con Bases de Datos Grandes

Filtrado y Búsqueda

Al trabajar con muchos objetos, utilice estas características:

Filtro Rápido

Haga clic en el cuadro de búsqueda en la parte superior de la barra lateral
Escriba el nombre del objeto para filtrar en tiempo real
Use comodines: *usuarios* encuentra todos los objetos con "usuarios" en el nombre

Búsqueda Avanzada

Ámbito de búsqueda: Limitar a tablas, vistas o todos los objetos
Alternar sensible a mayúsculas: Coincidir mayúsculas exactas
Soporte de expresiones regulares: Usar expresiones regulares para patrones complejos

Objetos Favoritos

Marque objetos de acceso frecuente para recuperación rápida:

Haga clic derecho en cualquier objeto
Seleccione "Agregar a Favoritos"
Acceda a favoritos desde la sección de Favoritos en la barra lateral

Examinando Relaciones

Visualización de Relaciones de Tabla

HarborDB le ayuda a comprender cómo se conectan las tablas:

Visualización de Claves Externas

Haga clic derecho en cualquier tabla con claves externas
Seleccione "Mostrar Relaciones"
Vea representación gráfica de conexiones

Análisis de Dependencias

Vea qué depende de esta tabla
Identifique referencias circulares
Comprenda el impacto de cambios en el esquema

Navegador de Relaciones

Para bases de datos complejas, use el Navegador de Relaciones:

Abra el menú Herramientas → Navegador de Relaciones
Seleccione tabla de inicio
Explore conexiones visualmente
Exporte diagrama de relaciones para documentación

Ejemplos Prácticos de Navegación

Ejemplo 1: Explorando una Nueva Base de Datos

Al conectarse a una base de datos desconocida:

Verifique el tamaño de la base de datos (clic derecho en base de datos → Propiedades)
Enumere todos los esquemas e identifique los principales
Revise recuentos de tablas en cada esquema
Examine las tablas más grandes (ordenar por recuento de filas o tamaño)
Busque tablas de documentación (a menudo nombradas: docs, documentation, readme)

Ejemplo 2: Encontrando Datos Específicos

Cuando necesite localizar información de clientes:

Busque tablas que contengan "customer", "user" o "client"
Examine tablas probables para columnas relevantes
Verifique claves externas para encontrar datos relacionados
Use Vista Previa de Datos para muestrear datos reales

Ejemplo 3: Comprendiendo la Estructura de la Aplicación

Para comprender cómo una aplicación organiza datos:

Agrupe tablas por prefijo (ej., app_, auth_, report_)
Examine convenciones de nomenclatura
Busque patrones de claves externas
Identifique tablas de búsqueda/referencia

Atajos de Teclado para Navegación

Domine estos atajos para una navegación eficiente:

| Atajo | Acción | | ----------- | ------------------------------- | | ⌘ + B | Alternar visibilidad de barra lateral | | ⌘ + F | Enfocar búsqueda en barra lateral | | ⌘ + G | Encontrar siguiente en resultados de búsqueda | | ⌥ + Clic | Abrir objeto en nueva pestaña | | ⌘ + Clic | Abrir consulta SELECT para tabla | | ⌘ + R | Actualizar vista actual | | ⌘ + . | Limpiar búsqueda/filtro | | ⌘ + 1-9 | Cambiar entre secciones de barra lateral |

Mejores Prácticas de Navegación

Consejos de Organización

Use nombres de conexión significativos: Incluya entorno (Dev, Prod) y propósito
Agrupe conexiones relacionadas: Desarrollo local, staging, producción
Codifique por colores según entorno: Verde para dev, amarillo para staging, rojo para prod
Cree plantillas de conexión: Para configuraciones de base de datos similares

Consideraciones de Rendimiento

Limite auto-expansión: No expanda todo a la vez
Use búsqueda en lugar de navegación para bases de datos grandes
Cierre conexiones no utilizadas para liberar recursos
Limpie caché periódicamente para esquemas muy grandes

Prácticas de Seguridad

Use credenciales específicas de conexión cuando sea posible
Limite visibilidad de esquemas con permisos apropiados
Evite guardar contraseñas de producción en entornos menos seguros
Audite regularmente el uso de conexiones

Solución de Problemas de Navegación

Errores "Objeto No Encontrado"

Si no puede ver objetos esperados:

Actualice la conexión (clic derecho → Actualizar)
Verifique sus permisos en la base de datos
Confirme que está en el esquema correcto
Verifique que el objeto no haya sido renombrado o eliminado

Rendimiento Lento de Navegación

Para respuesta lenta:

Reduzca profundidad de auto-expansión en Preferencias
Deshabilite vistas previas en miniatura para tablas grandes
Aumente tiempo de espera de consulta para conexiones remotas
Use búsqueda en lugar de expansión de árbol

Relaciones Faltantes

Si las claves externas no se muestran:

Verifique si las claves externas están definidas correctamente en PostgreSQL
Confirme que tiene permisos para ver información de restricciones
Actualice metadatos de tabla
Verifique verificación de restricciones diferida

Características Avanzadas de Navegación

Consultas Personalizadas para Exploración

Cree consultas guardadas para exploración compleja:

-- Encontrar todas las tablas con columna específica
SELECT
    table_schema,
    table_name,
    column_name,
    data_type
FROM information_schema.columns
WHERE column_name ILIKE '%email%'
ORDER BY table_schema, table_name;

-- Listar tablas más grandes
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as size
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

Marcado de Rutas Comunes

Guarde rutas de navegación de acceso frecuente:

Navegue a su objeto objetivo
Haga clic en el botón de Marcador en la barra de herramientas
Nombre el marcador (ej., "Tablas de Análisis de Clientes")
Acceda a marcadores desde el menú Marcadores

Exportando Estructura de Base de Datos

Documente la estructura de su base de datos:

Seleccione objetos en la barra lateral
Clic derecho → Exportar Estructura
Elija formato: SQL, Markdown o HTML
Incluya opciones: Con datos, restricciones, índices

Próximos Pasos

Ahora que puede navegar bases de datos efectivamente:

Conceptos Básicos de Consultas - Aprenda a escribir y ejecutar consultas SQL
Exportando Datos - Guarde resultados en CSV o JSON
Optimización de Rendimiento - Optimice su flujo de trabajo de base de datos

Obteniendo Ayuda

Si encuentra problemas de navegación:

Consulte nuestra Guía de Soporte para solución de problemas
Visite el FAQ para preguntas comunes
Contacte Soporte para asistencia personalizada

Navegación de Base de Datos en HarborDB