Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O pesquisador de objetos na extensão PostgreSQL para Visual Studio Code fornece uma exibição de árvore dos servidores, bancos de dados, esquemas e objetos de banco de dados individuais do PostgreSQL. Você pode procurar tabelas, exibições, funções e outros objetos, pesquisar em esquemas e gerar scripts SQL, tudo sem sair do editor.
Dica
Use o pesquisador de objetos para navegação de objetos, pesquisa e geração de script. Se você quiser um diagrama visual de relações de tabela, abra o visualizador de esquema.
Explorador de Objetos Abertos
Selecione o ícone PostgreSQL na Barra de Atividades para abrir o modo de exibição PostgreSQL . Você também pode pressionar Ctrl+Alt+D (Windows/Linux) ou Cmd+Alt+D (macOS).
A exibição contém a seção Conexões , que exibe seus servidores em uma árvore recolhível. Os servidores conectados mostram um ícone verde; Os servidores desconectados mostram um ícone vermelho. Se não houver conexões, um nó Adicionar conexão será exibido para ajudar você a começar.
Hierarquia de árvores
O Pesquisador de Objetos organiza objetos de banco de dados em uma hierarquia consistente:
Servidor → Banco de dados → Esquema → Coleções de objetos
Por padrão, os objetos são agrupados por esquema. Em cada esquema, você encontra pastas de coleção como:
- Tabelas: expanda uma tabela para ver suas colunas, chaves, índices, restrições e gatilhos
- Modos de Exibição
- Procedimentos armazenados
- Funções: inclui funções escalares, funções com valor de tabela e funções de agregação em pastas separadas
- Sequências
- Tipos: tipos definidos pelo usuário e tipos de tabela definidos pelo usuário
O conjunto exato de pastas de coleção depende dos objetos presentes no banco de dados e é preenchido pelo serviço de ferramentas de back-end.
Expanda qualquer pasta de coleção para ver objetos individuais. Para tabelas, você pode analisar mais detalhadamente colunas, chaves (primárias, estrangeiras, exclusivas), índices, restrições e gatilhos.
Note
A configuração pgsql.objectExplorer.expandTimeout controla quanto tempo a extensão espera quando expande um nó. O padrão é 45 segundos. Aumente esse valor se você trabalhar com esquemas grandes que levam mais tempo para serem carregados.
Agrupar por esquema
Quando a configuração pgsql.objectExplorer.groupBySchema está habilitada (padrão), os objetos do banco de dados aparecem sob o nó do esquema correspondente. Para ativar ou desativar esse comportamento:
- Abra a paleta de comandos (Ctrl+Shift+P / Cmd+Shift+P).
- Execute Habilitar Grupo por Esquema ou Desabilitar Grupo por Esquema.
Ao desativar o agrupamento por esquema, as pastas de coleção de objetos aparecem diretamente no nó do banco de dados, em vez de aparecerem em esquemas individuais.
Conectar e gerenciar servidores
Você gerencia conexões de servidor diretamente da árvore Conexões . A barra de ferramentas na parte superior da seção Conexões e os menus de contexto com o botão direito do mouse fornecem as ações a seguir.
Ações da barra de ferramentas
| Botão | Command | Descrição |
|---|---|---|
| + | Adicionar nova conexão | Abre a caixa de diálogo de conexão para adicionar um servidor PostgreSQL existente. |
| Ícone do servidor | Criar novo servidor | Abre um hub de criação em que você pode implantar um novo servidor Banco de Dados do Azure para PostgreSQL flexível ou criar um servidor baseado em Docker. |
| Ícone de pasta | Criar grupo de servidores | Cria um novo grupo de servidores para organizar suas conexões. |
| Ícone de filtro | Mostrar somente servidores conectados / Mostrar servidores conectados e desconectados | Alterna a visibilidade de servidores desconectados na árvore. |
| Ícone de pesquisa | Objetos de pesquisa | Abre o painel de pesquisa. |
Menu de contexto do servidor
Clique com o botão direito do mouse em um nó do servidor para acessar estes comandos:
- Pesquisar objetos: abre o painel de pesquisa restrito a este servidor.
- Editar Conexão: reabre a caixa de diálogo de conexão com as configurações salvas para este servidor.
- Desconectar: fecha a conexão ativa. O servidor permanece na árvore com um ícone vermelho para que você possa se reconectar mais tarde.
- Remova: exclui totalmente a entrada do servidor da árvore Conexões .
- Atualizar: recarrega os nós filhos do servidor. Use isso após alterações de esquema feitas fora do VS Code.
Note
A desconexão aparece somente em servidores conectados. A remoção está disponível em servidores conectados e desconectados.
Menu de contexto do banco de dados
Clique com o botão direito do mouse em um nó de banco de dados para acessar:
- Nova Consulta: abre um editor de consultas já conectado a esse banco de dados.
-
Conecte-se ao PSQL: abre uma sessão de terminal integrada conectada a esse banco de dados com
psql. Consulte Usar psql no terminal para obter detalhes. - Visualizar Esquema: abre o visualizador de esquema para este banco de dados.
- Objetos de Pesquisa: abre o painel de pesquisa com escopo para este banco de dados.
Clique com o botão direito do mouse em um nó de esquema para acessar Visualizar esquema (limitado a esse esquema) e Pesquisar objetos.
Grupos de servidores
Os grupos de servidores permitem organizar conexões em pastas nomeadas. Isso é útil quando você trabalha com muitos servidores em diferentes ambientes ou equipes.
- Selecione o ícone de pasta (Criar Grupo de Servidores) na barra de ferramentas Conexões ou abra a Paleta de Comandos e execute PGSQL: Criar Grupo de Servidores.
- Insira um nome, uma descrição opcional e uma cor para o grupo.
- Selecione OK.
O grupo aparece como uma pasta na árvore Conexões . Você pode arrastar nós de servidor para o grupo para reorganizá-los. Para modificar um grupo, clique com o botão direito do mouse nele e selecione Editar Grupo de Servidores. Para excluir um grupo, clique com o botão direito do mouse e selecione Remover.
Clique com o botão direito do mouse em um grupo de servidores para adicionar conexões diretamente a esse grupo com Adicionar Nova Conexão ou Criar Novo Servidor.
Pesquisar objetos
Quando você precisar localizar um objeto específico em um banco de dados grande, use a pesquisa interna em vez de expandir manualmente os nós de árvore.
Abra o painel de pesquisa selecionando o ícone de pesquisa na barra de ferramentas Conexões. Você também pode clicar com o botão direito do mouse em um nó de servidor, banco de dados ou esquema e selecionar Objetos de Pesquisa para preencher previamente o escopo.
O painel de pesquisa fornece os seguintes controles:
| Controle | Descrição |
|---|---|
| Selecionar conexão | Escolha em qual conexão de servidor fazer a pesquisa. A lista suspensa mostra o status da conexão (Conectado / Desconectado) e detalhes como host, porta e usuário. |
| Selecionar banco de dados | Escolha em qual banco de dados pesquisar. |
| Todos os esquemas | Restringir resultados a um esquema específico ou deixar definido como Todos os esquemas a serem pesquisados em todos os lugares. |
| Todos os tipos | Filtrar por tipo de objeto. Escolha qualquer combinação de tipos como Tabela, Exibição, Função, Procedimento Armazenado e Sequência. |
| Pesquisar objetos... | Insira uma subcadeia de caracteres para corresponder a nomes de objeto. A pesquisa diferencia maiúsculas de minúsculas. |
Selecione Pesquisar para executar a consulta. Os resultados são exibidos em uma grade com colunas Nome do Objeto, Tipo e Caminho do Objeto . Selecione uma linha de resultado para navegar diretamente para esse objeto na árvore. A árvore Conexões expande os nós necessários automaticamente.
Objetos de banco de dados de script
Você pode gerar scripts SQL para objetos de banco de dados diretamente da árvore Conexões . Clique com o botão direito do mouse em um objeto scriptável para acessar os comandos de script.
| Command | Disponível em | SQL gerado |
|---|---|---|
| Selecione Top 1000 | Tabela, Visualização |
SELECT consulta que retorna as primeiras 1.000 linhas. |
| Script como Create | Tabela, exibição, esquema, procedimento armazenado, funções, gatilhos, índices, chaves, funções, tipos | Instrução DDL completa CREATE. |
| Script como Drop | Igual a Script como Criar |
DROP declaração para o objeto. |
| Script como Alter | Exibição, funções, procedimento armazenado |
ALTER instrução para o objeto. |
| Executar script como | Procedimento armazenado |
CALL ou SELECT instrução para executar a rotina. |
Cada script gerado é aberto em uma nova guia do editor de consultas conectada ao mesmo banco de dados que o objeto de origem. Você pode examinar, editar e executar o script imediatamente.
Dica
Selecione Top 1000 é a maneira mais rápida de visualizar dados da tabela. Clique com o botão direito do mouse na tabela e selecione Selecionar Top 1000 para abrir e executar a consulta em uma etapa.
Copiar nome
Clique com o botão direito do mouse em qualquer objeto que não seja pasta na árvore Conexões e selecione Copiar Nome para copiar seu nome qualificado para a área de transferência. Você também pode selecionar o nó e pressionar Ctrl+C (Windows/Linux) ou Cmd+C (macOS).
O nome copiado usa o [database].schema.[object] formato de notação de colchete, pronto para colar em suas consultas SQL.
Nova consulta do Pesquisador de Objetos
Clique com o botão direito do mouse em um nó de banco de dados e selecione Nova Consulta para abrir um editor de consultas que já está conectado a esse banco de dados. O editor herda a conexão do servidor e direciona o banco de dados selecionado, para que você possa começar a escrever consultas imediatamente.
Filtrar nós de árvore
Algumas pastas de coleção dão suporte à filtragem para restringir os objetos exibidos. Quando um nó puder ser filtrado, clique nele com o botão direito do mouse e selecione Filtrar para abrir o painel de filtragem. Você pode definir condições como Contains, Starts With ou Equals nas propriedades do objeto e selecionar OK para aplicar.
Os nós filtrados mostram (filtered) após seu rótulo. Para remover um filtro, clique com o botão direito do mouse no nó e selecione Limpar no painel de filtro.
Arrastar e soltar
Você pode arrastar nós de servidor entre grupos de servidores para reorganizar suas conexões. Você também pode arrastar objetos de banco de dados (tabelas, exibições, funções, procedimentos armazenados) da árvore Conexões para um editor de consultas para inserir seu nome qualificado por esquema como texto.