Bem-vindo ao guia de navegação no banco de dados! O HarborDB fornece ferramentas poderosas para explorar e entender seus bancos de dados PostgreSQL. Este guia mostrará como navegar efetivamente na estrutura do seu banco de dados, examinar tabelas e relacionamentos, e aproveitar ao máximo a interface visual do HarborDB.

A Interface de Navegação

Visão Geral da Barra Lateral

A barra lateral esquerda é sua principal ferramenta de navegação. Ela exibe uma visão hierárquica da estrutura do seu banco de dados:

Nome da Conexão
├── Bancos de Dados
│   ├── Banco de Dados 1
│   │   ├── Schemas
│   │   │   ├── public
│   │   │   │   ├── Tabelas
│   │   │   │   ├── Views
│   │   │   │   ├── Funções
│   │   │   │   └── Sequências
│   │   │   └── outros_schemas
│   │   └── Configurações
│   └── Banco de Dados 2
└── Objetos do Sistema

Modos de Navegação

O HarborDB oferece dois modos principais de navegação:

Visão em Árvore (Padrão): Expansão hierárquica de objetos
Visão de Pesquisa: Pesquisa rápida em todos os objetos

Explorando Bancos de Dados

Visualizando Bancos de Dados Disponíveis

Quando você se conecta pela primeira vez, verá uma lista de bancos de dados aos quais tem acesso:

Expanda sua conexão na barra lateral
Clique em "Bancos de Dados" para ver a lista
Clique duas vezes em qualquer banco de dados para explorar seu conteúdo

Informações do Banco de Dados

Clique com o botão direito em qualquer banco de dados para acesso rápido a:

Propriedades: Visualizar tamanho do banco de dados, codificação, collation
Nova Aba de Consulta: Abrir editor de consultas pré-conectado a este banco de dados
Atualizar: Atualizar a lista de bancos de dados
Criar Banco de Dados: Se você tiver permissões

Trabalhando com Schemas

Entendendo Schemas

Schemas são contêineres lógicos dentro de bancos de dados. O PostgreSQL usa por padrão o schema public, mas você pode encontrar outros.

Explorando Conteúdo do Schema

Expanda um banco de dados para ver seus schemas
Expanda um schema para ver tipos de objetos:
- Tabelas: Armazenamento de dados
- Views: Tabelas virtuais de consultas
- Funções: Procedimentos e funções armazenados
- Sequências: Geradores de números auto-incrementais

Operações de Schema

Clique com o botão direito em um schema para:

Criar Nova Tabela/View/Função
Atualizar conteúdo do schema
Definir como Padrão: Torne este seu schema preferido

Examinando Tabelas

Visualização da Estrutura da Tabela

Quando você expande a pasta "Tabelas", verá todas as tabelas no schema. Clique em qualquer tabela para ver:

Aba Colunas

Nomes de colunas e tipos de dados
Restrições (Chave Primária, Chave Estrangeira, etc.)
Valores padrão e status nullable
Informações de armazenamento

Aba Pré-visualização de Dados

Primeiras 100 linhas de dados da tabela
Colunas ordenáveis (clique nos cabeçalhos)
Dados filtráveis (clique com o botão direito nos cabeçalhos das colunas)
Opções de exportação rápida

Aba Índices

Nomes de índices e tipos
Colunas indexadas
Tamanho do índice e estatísticas

Aba Chaves Estrangeiras

Relacionamentos com outras tabelas
Tabelas e colunas referenciadas
Regras de cascata

Ações Rápidas da Tabela

Clique com o botão direito em qualquer tabela para acesso instantâneo a:

| Ação | Descrição | Atalho de Teclado | | ------------------ | ---------------------------------------------- | ----------------- | | Selecionar Top 100 | Abrir consulta com SELECT * FROM tabela LIMIT 100 | ⌘ + Clique | | Ver Estrutura | Abrir estrutura da tabela em visão detalhada | ⌥ + Clique | | Gerar SELECT | Criar consulta SELECT básica para esta tabela | | | Gerar INSERT | Criar modelo INSERT | | | Exportar Dados | Exportar tabela para CSV/JSON | ⌘ + E | | Atualizar | Atualizar informações da tabela | ⌘ + R |

Entendendo Views

View vs Tabela

Views aparecem semelhantes a tabelas, mas são objetos virtuais baseados em consultas SQL:

Views Regulares: Definições de consulta armazenadas
Views Materializadas: Resultados pré-computados (em cache)

Informações da View

Clique em qualquer view para ver:

Definição: A consulta SQL que define a view
Colunas: Estrutura do conjunto de resultados
Dependências: Tabelas e views das quais esta view depende

Trabalhando com Bancos de Dados Grandes

Filtragem e Pesquisa

Ao lidar com muitos objetos, use estes recursos:

Filtro Rápido

Clique na caixa de pesquisa no topo da barra lateral
Digite o nome do objeto para filtrar em tempo real
Use curingas: *usuarios* encontra todos os objetos com "usuarios" no nome

Pesquisa Avançada

Escopo da pesquisa: Limitar a tabelas, views ou todos os objetos
Alternar sensibilidade a maiúsculas/minúsculas: Corresponder exatamente à caixa
Suporte a regex: Usar expressões regulares para padrões complexos

Objetos Favoritos

Marque objetos acessados frequentemente para recuperação rápida:

Clique com o botão direito em qualquer objeto
Selecione "Adicionar aos Favoritos"
Acesse favoritos na seção Favoritos da barra lateral

Examinando Relacionamentos

Visualizando Relacionamentos de Tabelas

O HarborDB ajuda você a entender como as tabelas se conectam:

Visualização de Chaves Estrangeiras

Clique com o botão direito em qualquer tabela com chaves estrangeiras
Selecione "Mostrar Relacionamentos"
Veja representação gráfica das conexões

Análise de Dependências

Veja o que depende desta tabela
Identifique referências circulares
Entenda o impacto de alterações de schema

Navegador de Relacionamentos

Para bancos de dados complexos, use o Navegador de Relacionamentos:

Abra menu Ferramentas → Navegador de Relacionamentos
Selecione tabela inicial
Explore conexões visualmente
Exporte diagrama de relacionamento para documentação

Exemplos Práticos de Navegação

Exemplo 1: Explorando um Novo Banco de Dados

Ao conectar-se a um banco de dados desconhecido:

Verifique tamanho do banco de dados (clique com botão direito → Propriedades)
Liste todos os schemas e identifique os principais
Revise contagens de tabelas em cada schema
Examine as maiores tabelas (ordene por contagem de linhas ou tamanho)
Procure tabelas de documentação (frequentemente nomeadas: docs, documentation, readme)

Exemplo 2: Encontrando Dados Específicos

Quando você precisa localizar informações de cliente:

Pesquise tabelas contendo "customer", "user" ou "client"
Examine tabelas prováveis para colunas relevantes
Verifique chaves estrangeiras para encontrar dados relacionados
Use Pré-visualização de Dados para amostrar dados reais

Exemplo 3: Entendendo a Estrutura do Aplicativo

Para entender como um aplicativo organiza dados:

Agrupe tabelas por prefixo (ex: app_, auth_, report_)
Examine convenções de nomenclatura
Procure padrões de chaves estrangeiras
Identifique tabelas de pesquisa/referência

Atalhos de Teclado para Navegação

Domine estes atalhos para navegação eficiente:

| Atalho | Ação | | ---------- | ----------------------------- | | ⌘ + B | Alternar visibilidade da barra lateral | | ⌘ + F | Focar pesquisa na barra lateral | | ⌘ + G | Encontrar próximo nos resultados da pesquisa | | ⌥ + Clique | Abrir objeto em nova aba | | ⌘ + Clique | Abrir consulta SELECT para tabela | | ⌘ + R | Atualizar visualização atual | | ⌘ + . | Limpar pesquisa/filtro | | ⌘ + 1-9 | Alternar entre seções da barra lateral |

Melhores Práticas de Navegação

Dicas de Organização

Use nomes de conexão significativos: Inclua ambiente (Dev, Prod) e propósito
Agrupe conexões relacionadas: Dev local, staging, produção
Codifique por cores por ambiente: Verde para dev, amarelo para staging, vermelho para prod
Crie modelos de conexão: Para configurações de banco de dados semelhantes

Considerações de Desempenho

Limite auto-expansão: Não expanda tudo de uma vez
Use pesquisa em vez de navegação para bancos de dados grandes
Feche conexões não utilizadas para liberar recursos
Limpe cache periodicamente para schemas muito grandes

Práticas de Segurança

Use credenciais específicas por conexão quando possível
Limite visibilidade do schema com permissões apropriadas
Evite salvar senhas de produção em ambientes menos seguros
Audite regularmente uso da conexão

Solução de Problemas de Navegação

Erros "Objeto Não Encontrado"

Se você não consegue ver objetos esperados:

Atualize a conexão (clique com botão direito → Atualizar)
Verifique suas permissões no banco de dados
Confirme que está no schema correto
Verifique se o objeto não foi renomeado ou removido

Desempenho Lento de Navegação

Para resposta lenta:

Reduza profundidade de auto-expansão nas Preferências
Desative pré-visualizações em miniatura para tabelas grandes
Aumente timeout de consulta para conexões remotas
Use pesquisa em vez de expansão de árvore

Relacionamentos Ausentes

Se chaves estrangeiras não estão aparecendo:

Verifique se as chaves estrangeiras estão definidas corretamente no PostgreSQL
Confirme que você tem permissões para visualizar informações de restrição
Atualize metadados da tabela
Verifique verificação de restrição diferida

Recursos Avançados de Navegação

Consultas Personalizadas para Exploração

Crie consultas salvas para exploração complexa:

-- Encontrar todas as tabelas com coluna 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 maiores tabelas
SELECT
    schemaname,
    tablename,
    pg_size_pretty(pg_total_relation_size(schemaname || '.' || tablename)) as tamanho
FROM pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY pg_total_relation_size(schemaname || '.' || tablename) DESC
LIMIT 20;

Marcando Caminhos Comuns

Salve caminhos de navegação acessados frequentemente:

Navegue até seu objeto alvo
Clique no botão Marcador na barra de ferramentas
Nomeie o marcador (ex: "Tabelas de Análise de Clientes")
Acesse marcadores do menu Marcadores

Exportando Estrutura do Banco de Dados

Documente a estrutura do seu banco de dados:

Selecione objetos na barra lateral
Clique com botão direito → Exportar Estrutura
Escolha formato: SQL, Markdown ou HTML
Inclua opções: Com dados, restrições, índices

Próximos Passos

Agora que você pode navegar em bancos de dados efetivamente:

Noções Básicas de Consultas - Aprenda a escrever e executar consultas SQL
Exportando Dados - Salve resultados em CSV ou JSON
Otimização de Desempenho - Otimize seu fluxo de trabalho de banco de dados

Obtendo Ajuda

Se encontrar problemas de navegação:

Verifique nosso Guia de Suporte para solução de problemas
Visite o FAQ para perguntas comuns
Entre em Contato com o Suporte para assistência personalizada

Navegação no Banco de Dados no HarborDB