Visualizador de esquema

O visualizador de esquema na extensão PostgreSQL abre uma visão da Web que mapeia tabelas e relações de chave estrangeira para o banco de dados que você já usa na extensão. Use-o para entender um esquema desconhecido, confirme como as tabelas se relacionam antes de alterá-las ou concentre-se em um esquema antes de escrever o SQL. O visualizador é executado da mesma maneira em Visual Studio Code e Cursor.

Quando usar o visualizador de esquema

Use o visualizador de esquema quando precisar:

  • obter um mapa de relacionamento para um banco de dados com muitas tabelas,
  • foco em um esquema sem ocultar permanentemente o restante do banco de dados ou
  • mova-se da árvore Conexões , do painel do servidor ou de um fluxo de trabalho da ferramenta de modo agente para uma exibição de esquema visual.

Dica

Use o visualizador de esquema para estrutura e relações. Quando você precisar de definições de objeto, pesquisa direta ou geração de script, use o Pesquisador de Objetos.

Pré-requisitos

Antes de abrir o visualizador de esquema, verifique se você tem:

  • uma conexão ativa com o banco de dados PostgreSQL de destino e
  • um assistente de IA disponível no seu editor apenas se quiser abrir o visualizador no modo Agente.

Abrir o visualizador de esquema

Abrir o mapa completo do banco de dados

  1. Na árvore Conexões , clique com o botão direito do mouse em um nó de banco de dados.
  2. Selecione Visualizar Esquema.
  3. Aguarde até que a guia Visualizar Esquema seja aberta no editor.

O visualizador abre uma nova aba do editor e carrega as tabelas, colunas e relacionamentos de chave estrangeira desse banco de dados.

Captura de tela do visualizador de esquema mostrando um diagrama de relação de entidade de banco de dados.

Se você já trabalha no painel do servidor, selecione Visualizar esquema na barra de ferramentas e escolha o banco de dados que deseja abrir.

Foco em um esquema

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

O visualizador é aberto com esse esquema visível primeiro e os outros esquemas ocultos. Use esse caminho quando o diagrama de banco de dados completo for muito denso para ler na primeira carga.

Abrir a partir do modo de agente

Se você já trabalha no modo agente, peça ao assistente de IA para visualizar o esquema de banco de dados conectado. 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 enviá-lo de volta para a árvore Conexões primeiro.

Ler o diagrama

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

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

Captura de tela do mapa de relação do visualizador de esquema com conexões de tabela.

Note

O visualizador de esquema se concentra nas relações de tabela. Ele mostra apenas tabelas e restrições de chave estrangeira. Para exibições, funções, sequências e definições de objeto, use o Pesquisador de Objetos.

Filtrar e comparar esquemas

Quando um banco de dados inclui vários esquemas, a legenda lista cada esquema com sua própria cor e controle de visibilidade. Use a legenda para reduzir a desordem e comparar apenas as partes do banco de dados importantes com a tarefa atual.

  1. Na legenda, localize o esquema que você deseja ocultar ou restaurar.
  2. Use o botão de visibilidade para esse esquema.
  3. Examine o diagrama atualizado.

Quando você oculta um esquema, as tabelas restantes ainda podem mostrar indicadores coloridos para relações entre esquemas ocultos. Isso ajuda você a manter dependências importantes em exibição mesmo quando o esquema relacionado está temporariamente oculto.

Trabalhar com esquemas grandes

O visualizador de esquema inclui controles de navegação e layout para que você possa reenquadrar o diagrama conforme as tabelas visíveis são alteradas.

  • Painel: selecione e arraste uma área vazia da tela para percorrer o diagrama.
  • Zoom: Use a roda do mouse, o gesto de pinça no trackpad ou os botões + e - na sobreposição dos controles para aproximar e afastar.
  • Ajuste à exibição: selecione o botão ajuste à exibição na sobreposição de controles para ampliar e centralizar automaticamente o diagrama para que todas as tabelas visíveis se ajustem ao visor.
  • Minimapa: para esquemas grandes, use o minimapa no canto da tela para ver a posição atual do visor em relação ao diagrama completo.
  • Layout Automático: selecione Layout Automático para recalcular o layout das tabelas visíveis.

Atualizar após alterações de esquema

O visualizador de esquema não é atualizado automaticamente depois que você altera o banco de dados. Se você adicionar ou soltar tabelas, colunas ou chaves estrangeiras, selecione Atualizar para recarregar o modelo de esquema atual e redesenhar o mapa da relação.

Conteúdo relacionado

  • Last updated on