Visualizador de esquema

O visualizador de esquema na extensão PostgreSQL abre uma webview que mapeia tabelas e relações de chave estrangeira para a base de dados que já usa na extensão. Usa-o para perceber um esquema desconhecido, confirma como as tabelas se relacionam antes de as alterar, ou foca-te num esquema antes de escreveres SQL. O visualizador funciona da mesma forma no Visual Studio Code e Cursor.

Quando usar o visualizador de esquemas

Use o visualizador de esquemas quando precisar:

  • obter um mapa de relações para uma base de dados com muitas tabelas,
  • focar-se num único esquema sem esconder permanentemente o resto da base de dados, ou
  • passar da árvore de Ligações, do painel do servidor ou de um fluxo de trabalho de ferramentas no modo Agente para uma vista visual do esquema.

Gorjeta

Usa o visualizador de esquemas para estrutura e relações. Quando precisares de definições de objetos, pesquisa direta ou geração de scripts, usa o Object Explorer.

Pré-requisitos

Antes de abrir o visualizador de esquemas, certifique-se de que tem:

  • uma ligação ativa à base de dados PostgreSQL alvo, e
  • um assistente de IA disponível no teu editor apenas se quiseres abrir o visualizador do modo Agente.

Abra o visualizador de esquema

Abra o mapa completo da base de dados

  1. Na árvore Conexões , clique com o botão direito num nó da base de dados.
  2. Selecione Visualizar Esquema.
  3. Aguarde que o separador Visualização do Esquema se abra no editor.

O visualizador abre um novo separador do editor e carrega as tabelas, colunas e relações de chave estrangeira para essa base de dados.

Captura de ecrã do visualizador de esquemas mostrando um diagrama entidade-relação da base de dados.

Se já trabalhas a partir do painel do servidor, seleciona Visualizar esquema na barra de ferramentas e depois escolhe a base de dados que queres abrir.

Foca-te num esquema

  1. Na árvore de Conexões, expanda a base de dados que contém o esquema que pretende inspecionar.
  2. Clique com o botão direito no nó do esquema.
  3. Selecione Visualizar Esquema.

O visualizador começa com esse esquema visível primeiro e os outros esquemas ocultos. Use este caminho quando o diagrama completo da base de dados for demasiado denso para ler na primeira carga.

Abrir a partir do modo Agente

Se já trabalhas em modo Agente, pede ao assistente de IA para visualizar o esquema da base de dados ligada. A extensão expõe a pgsql_visualize_schema ferramenta para esse fluxo de trabalho, para que a IA possa abrir o mesmo visualizador de esquema sem te enviar de volta para a árvore de Conexões primeiro.

Leia o diagrama

Cada tabela aparece como um nó na tela. O cabeçalho do nó mostra o nome do esquema e da tabela, e o corpo lista as colunas da tabela com os seus tipos de dados. As colunas-chave primárias incluem um indicador-chave para que possa identificá-las rapidamente.

As linhas de relação ligam colunas de chave estrangeira às colunas referenciadas em tabelas relacionadas. Siga essas linhas quando precisar de entender caminhos de junção, relações pai-filho ou dependências entre esquemas.

Captura de ecrã do mapa de relacionamento do visualizador do esquema com ligações de tabelas.

Note

O visualizador de esquemas foca-se nas relações de tabelas. Mostra apenas tabelas e restrições de chave estrangeira. Para vistas, funções, sequências e definições de objetos, use o Object explorer.

Filtrar e comparar esquemas

Quando uma base de dados inclui múltiplos esquemas, a legenda lista cada esquema com o seu próprio controlo de cor e visibilidade. Use a legenda para reduzir a desordem e compare apenas as partes da base de dados que são relevantes para a tarefa atual.

  1. Na lenda, encontra o esquema que queres esconder ou restaurar.
  2. Utilize o botão de visibilidade para esse esquema.
  3. Veja o diagrama atualizado.

Quando esconde um esquema, as tabelas restantes ainda podem mostrar indicadores coloridos para relações ocultas entre esquemas. Isso ajuda-te a manter as dependências importantes em vista mesmo quando o esquema relacionado está temporariamente oculto.

Trabalho com esquemas grandes

O visualizador de esquemas inclui controlos de navegação e layout para que possas reformular o diagrama à medida que as tabelas visíveis mudam.

  • Pan: Selecione e arraste uma área vazia da tela para se mover pelo diagrama.
  • Zoom: Utilize a roda do rato, o gesto de pinça no trackpad ou os botões + e - na sobreposição dos controlos para ampliar e reduzir.
  • Ajuste para visualização: Selecione o botão de ajuste para visualização na sobreposição de controlos para ampliar e centralizar automaticamente o diagrama para que todas as tabelas visíveis caibam na janela de visualização.
  • Minimapa: Para esquemas grandes, use o minimapa no canto da tela para ver a sua posição atual na janela de visualização em relação ao diagrama completo.
  • Layout Automático: Selecione Layout Automático para recalcular o layout das tabelas visíveis.

Atualização após alterações no esquema

O visualizador de esquemas não atualiza automaticamente depois de mudares a base de dados. Se adicionar ou eliminar tabelas, colunas ou chaves estrangeiras, selecione Atualizar para recarregar o modelo de esquema atual e redesenhar o mapa de relações.

Conteúdo relacionado

  • Last updated on