Criar um servidor PostgreSQL

A extensão PostgreSQL para Visual Studio Code permite-lhe criar novos servidores PostgreSQL sem sair do seu editor. Pode criar um contentor Docker local para desenvolvimento e testes, providenciar um servidor flexível Base de Dados do Azure para PostgreSQL totalmente gerido para cargas de trabalho de produção, ou criar um cluster Azure HorizonDB (Preview) para cenários de grande escala.

Pré-requisitos

  • Visual Studio Code com a extensão instalada.
  • Para um servidor Docker local:o Docker Desktop está instalado e o daemon Docker está a funcionar. Verifica correndo docker info num terminal.
  • Para um servidor Azure: Uma conta Azure com subscrição ativa. Se não tiveres uma, cria uma conta gratuitamente.
  • Para um cluster Azure HorizonDB (Preview): Uma conta Azure com subscrição ativa e acesso ao Azure HorizonDB (Preview).

Abra o hub Criar Novo Servidor

  1. No contentor da Barra de Atividades do PostgreSQL , localize a árvore de Conexões .

  2. Selecione o botão Criar Novo Servidor no topo da árvore de Conexões , ou execute pgsql.createNewServer a partir da Paleta de Comandos.

    Também pode clicar com o botão direito num grupo de servidores na árvore de Ligações e selecionar Criar Novo Servidor.

O hub Criar Novo PostgreSQL Server abre num novo separador de editor. Apresenta três opções:

Option Description
Criar um servidor PostgreSQL local no Docker Cria um servidor PostgreSQL num contentor Docker local. Ideal para desenvolvimento, testes e aprendizagem.
Crie uma base de dados Base de Dados do Azure para PostgreSQL Flexible Server Instance Provisiona um servidor PostgreSQL totalmente gerido no Azure. Adequado para cargas de trabalho em produção e ambientes de equipa.
Criar uma Instância Azure HorizonDB (Pré-visualização) Prevê um cluster PostgreSQL nativo da cloud e altamente escalável no Azure.

Seleciona a carta que corresponde ao teu cenário.

Crie um servidor local com o Docker

Os containers Docker dão-te uma instância PostgreSQL leve e isolada que corre na tua máquina. Use esta opção para desenvolvimento local, prototipagem ou quando precisar de um ambiente de base de dados descartável.

Passo 1: Rever a introdução

Depois de selecionar o cartão Criar um servidor PostgreSQL local no Docker, a extensão apresenta uma página inicial intitulada Servidor PostgreSQL no Docker sem complicações, diretamente no VS Code!. A página destaca as principais capacidades:

  • Criação de servidor com um clique: Crie um servidor PostgreSQL em segundos, sem configuração manual.
  • Configuração Totalmente Automatizada: A extensão puxa, configura e executa o PostgreSQL num ambiente isolado.
  • Gestão simples: Inicie, pare ou remova o seu contentor PostgreSQL a qualquer momento.

Selecione Começar para continuar.

Passo 2: Passar na verificação dos pré-requisitos

A extensão verifica se o Docker está instalado e a funcionar. O ecrã de pré-requisitos de verificação mostra o estado de cada verificação:

  • Verificar se o Docker está instalado: Verifica se a CLI do Docker está disponível no seu PATHarquivo .
  • Verificar se o Docker está a correr em segundo plano: Confirma que o daemon Docker está ativo.

Se uma verificação falhar, siga o link no ecrã para instalar ou iniciar o Docker, e depois volte a esta página. A extensão repete as verificações automaticamente.

Passo 3: Configurar a ligação

Depois de passarem os pré-requisitos, aparece o formulário Configurar a sua ligação . Preencha os seguintes campos:

Configuração Obrigatório Description
Nome da conexão No Um nome amigável para o perfil de ligação. Também serve como nome padrão do contentor (os espaços são substituídos por sublinhados).
Nome do contêiner Yes Nome do contentor Docker. Caracteres permitidos: a-zA-Z0-9_.-.
Nome de utilizador Yes Nome de superutilizador para a instância PostgreSQL. O valor padrão é postgres.
Senha Yes Palavra-passe para a conta de superutilizador.
Guardar palavra-passe No Quando selecionado, armazena a palavra-passe para não ter de a introduzir em cada ligação.
Nome da base de dados No Nome da base de dados inicial. O valor padrão é postgres.

Selecione Opções Avançadas para expandir definições adicionais:

Configuração Description
Porto de destino Porta host mapeada para a porta PostgreSQL do contentor (porta 5432container). Se deixada em branco, a extensão atribui automaticamente uma porta livre no intervalo 54500-55000. Alcance válido: 1-65535.
Versão da imagem Etiqueta de imagem Docker para puxar. O valor padrão é latest.
Registo de imagens URL do registo de contentores (por exemplo, myregistry.azurecr.io). Predefinido para Docker Hub.
Nome da imagem Nome da imagem Docker. O valor padrão é postgres.
Plataforma de Imagens Plataforma de destino para ambientes de multiarquitetura (por exemplo, linux/amd64).

Passo 4: Criar e ligar

Selecione Criar para iniciar o provisionamento. A extensão:

  1. Obtém a imagem Docker postgres (caso ainda não esteja em cache).
  2. Cria e inicia o contentor com as definições especificadas.
  3. Espera que o PostgreSQL fique pronto (usando pg_isready).
  4. Cria um perfil de ligação e liga-se automaticamente.

Um indicador de progresso intitulado Criar um Servidor Docker Local... aparece enquanto o contentor se inicializa. Quando o contentor está pronto, o servidor aparece na árvore de Ligações e podes começar a consultar imediatamente.

Gorjeta

O contentor Docker persiste ao longo dos reinícios do Visual Studio Code. Para parar, iniciar, remover ou inspecionar o contentor fora da extensão, use a CLI Docker ou o Docker Desktop.

Criar um Banco de Dados do Azure para servidor flexível PostgreSQL

O servidor flexível Base de Dados do Azure para PostgreSQL é um serviço de base de dados totalmente gerido que oferece alta disponibilidade, backups automatizados e afinação inteligente de desempenho. A extensão guia-o através de um assistente em vários passos para provisionar um novo servidor diretamente a partir do Visual Studio Code.

Passo 1: Rever a introdução

Depois de selecionar o cartão Criar uma instância do Base de Dados do Azure para PostgreSQL Flexible Server, uma página inicial descreve as capacidades do serviço:

  • Integração Seamless com Azure: Fornece servidores diretamente no Visual Studio Code com suporte para autenticação Entra ID.
  • Computação e Armazenamento Flexíveis: Escolha entre níveis de computação pré-configurados e opções de armazenamento.
  • Gestão simplificada de servidores: Gerir o ciclo de vida, desempenho e configuração sem sair do editor.
  • Construído para Desenvolvedores: Foca-te na tua aplicação enquanto o Azure trata da infraestrutura.

Selecione Começar para continuar. Opcionalmente, seleciona Não mostrar isto novamente para saltar esta página no futuro.

Passo 2: Iniciar sessão no Azure

A extensão abre uma página de login com a mensagem: "Inicie sessão na sua conta Azure com o Entra ID para criar uma instância de servidor flexível Base de Dados do Azure para PostgreSQL."

  • Se já tiver uma conta Azure iniciada no Visual Studio Code, a extensão usa essas credenciais automaticamente.
  • Se tiver várias contas ou inquilinos Azure, use o trocador de contas e o seletor de inquilinos para escolher a identidade correta.

Passo 3: Configurar as definições do servidor

Após a autenticação, a extensão apresenta um formulário de configuração organizado em secções. Um painel de estimativa de custos à direita atualiza-se à medida que faz seleções.

Detalhes do projeto

Configuração Description
Subscription Selecione a subscrição do Azure que gere a faturação e o acesso. Todas as subscrições da sua conta iniciada e do inquilino estão listadas.
Grupo de Recursos Selecione um grupo de recursos existente ou selecione Criar um novo para criar um. O novo grupo de recursos é implementado na mesma região do servidor.

Basics

Configuração Description
Nome do Servidor Um nome globalmente único para o servidor. A extensão verifica a disponibilidade de forma assíncrona e apresenta um erro se o nome for adotado. O nome do servidor passa a fazer parte do nome de host da sua ligação (<server-name>.postgres.database.azure.com).
Região A região do Azure onde o servidor está implantado. A extensão valida que a sua subscrição pode ser provisionada na região selecionada.
Computação + armazenamento Selecione uma camada pré-configurada de computação e armazenamento. Os pacotes disponíveis são:
Bundle vCores Armazenamento SKU
Dev/Test (por defeito) 2 128 GB Standard_D2ds_v4
Standard 4 256 GB Standard_D4ds_v4
Desempenho 8 512 GB Standard_D8ds_v4

Gorjeta

Pode personalizar ainda mais computação e armazenamento usando o botão Criar no portal do Azure no final do formulário, que abre toda a experiência de criação do Azure portal.

Configuração Description
PostgreSQL Version A principal versão do PostgreSQL para implementar. Versões disponíveis: 18, 17, 16, 15 e 14. O valor predefinido é 18. As versões disponíveis podem variar consoante a região.

Authentication

O formulário mostra uma secção ACESSO AO ADMINISTRADOR . Deve ativar pelo menos um método de autenticação.

Configuração Description
Utilizar o meu Entra ID: <email> Caixa de verificação que configura a sua identidade do Entra ID autenticada como administrador do servidor. O email é preenchido automaticamente a partir do seu login no Azure.
Criar utilizador e palavra-passe PostgreSQL Caixa de seleção que permite a autenticação tradicional do PostgreSQL. Quando selecionado, aparecem três campos adicionais.

Ao selecionar Criar utilizador PostgreSQL e palavra-passe, forneça o seguinte:

Configuração Description
Nome de utilizador do administrador Nome de login para a conta de administrador do PostgreSQL (por exemplo, pgadmin). Deve começar com uma letra e conter apenas letras, números e sublinhas. Não pode usar nomes reservados como admin, root, guest, ou nomes que começam por pg_.
Palavra-passe de administrador Palavra-passe para a conta de administrador. Devem ter entre 8 a 128 caracteres e incluir pelo menos três de: letras maiúsculas, minúsculas, números e símbolos.
Confirmar a palavra-passe do administrador Reintroduza a palavra-passe do administrador.

Note

Pode ativar ambos os métodos de autenticação simultaneamente. Por exemplo, Entra ID para membros da equipa e autenticação PostgreSQL para cadeias de ligação à aplicação.

Estimativa de custos

O painel de Custos Estimados no lado direito do formulário detalha os preços mensais:

  • Computação: Com base no SKU selecionado e no número de vCores.
  • Armazenamento: Baseado no nível de armazenamento selecionado.
  • Backup: Custo de backup incluído.
  • Largura de banda: A transferência de dados de saída entre regiões acarreta custos adicionais; A transferência de entrada é gratuita.

O painel mostra um total estimado e liga à Calculadora de Preços do Azure para preços detalhados.

Passo 4: Aceitar os termos e deslocar-se

No final do formulário:

  1. Selecione a caixa de seleção 'Reconheco' que criar este servidor pode resultar em cobranças .
  2. Consulte os Termos de Utilização e a Política de Privacidade ligados.
  3. Selecione Criar para começar a provisionar.

A extensão navega até uma página de progresso que acompanha cada etapa da implementação:

Stage Valores de estado
Provisionamento de servidores Pendente, Em progresso, Concluído, Falhado
Atribuição de regras de firewall Pendente, Em progresso, Concluído, Saltado
Atribuição de administrador do Entra Pendente, Em progresso, Concluído, Saltado

Um resumo de implementação mostra o nome do Servidor, Subscrição, Grupo de Recursos, Região e Configuração que selecionou.

Durante a implementação, pode continuar a trabalhar no Visual Studio Code. A implementação também corre em segundo plano se fechares a página de progresso.

Quando todas as etapas terminam, o cabeçalho atualiza-se para Server criado com sucesso! e exibe a mensagem: "O seu Servidor Flexível PostgreSQL está pronto." A extensão cria automaticamente um perfil de ligação para o novo servidor. Selecione Feito para fechar a página de progresso.

Note

Se uma fase terminar com avisos, o estado mostra Concluído com avisos. Revê os detalhes antes de te ligares.

Controlar implementações do Azure

A vista Azure Deployments na barra de atividades do PostgreSQL mostra todas as implementações de servidores Azure em curso e concluídas. Cada entrada mostra o nome do servidor, o estado da implementação e o carimbo temporal.

Clique com o botão direito numa implementação para aceder a estas ações:

Ação Description
Open in portal do Azure Abre a página de recursos do servidor no portal Azure.
Remover implementação Remove a entrada de implantação do rastreador. Esta ação não apaga o recurso do Azure.

Use o botão Remover Concluído na barra de ferramentas de visualização para apagar todas as implementações concluídas da lista.

Gorjeta

Se uma implementação do Azure falhar, selecione Tentar novamente na página de progresso para reiniciar o provisionamento, ou selecione Voltar ao Formulário para ajustar as suas definições.

Criar um cluster Azure HorizonDB (Preview)

Azure HorizonDB (Preview) é um cluster PostgreSQL nativo da cloud e altamente escalável no Azure. A extensão guia-o através de um assistente de vários passos para provisionar um novo cluster.

Note

A disponibilidade do Azure HorizonDB (Preview) depende da sua subscrição e região do Azure.

Passo 1: Rever a introdução

Depois de selecionar o cartão Criar uma Instância do Azure HorizonDB, uma página de destino descreve as capacidades do serviço:

  • Cloud-Native Architecture: Um cluster PostgreSQL nativo da cloud, otimizado para alto rendimento.
  • Escalabilidade elástica: Dimensione a capacidade de computação de 2 a 128 vCores.
  • Gestão Integrada: Gerir o ciclo de vida e a configuração a partir do Visual Studio Code.
  • Pronto para Desenvolvedores: Concentre-se na sua aplicação enquanto o Azure trata da infraestrutura.

Selecione Começar para continuar. Opcionalmente, seleciona Não mostrar isto novamente para saltar esta página no futuro.

Passo 2: Iniciar sessão no Azure

A extensão abre uma página de login. Se já tiver uma conta Azure iniciada no Visual Studio Code, a extensão usa essas credenciais automaticamente. Se tiver várias contas ou inquilinos Azure, use o trocador de contas e o seletor de inquilinos para escolher a identidade correta.

Passo 3: Configurar as definições do cluster

Após a autenticação, a extensão apresenta um formulário de configuração organizado em secções.

Detalhes do projeto

Configuração Description
Subscription Selecione a subscrição do Azure que gere a faturação e o acesso.
Grupo de Recursos Selecione um grupo de recursos existente ou selecione Criar um novo para criar um.

Detalhes do cluster

Configuração Description
Nome do Cluster Um nome globalmente único para o cluster. A extensão verifica a disponibilidade e apresenta um erro se o nome for adotado.
Região A região do Azure onde o cluster é implantado.
PostgreSQL Version A principal versão do PostgreSQL para implementar.

Configuração de computação

Use o controle deslizante vCores para escolher a capacidade de computação do seu cluster. As opções disponíveis variam entre 2 e 128 vCores. A memória escala automaticamente a 8 GiB por vCore.

Authentication

Configuração Description
Nome de utilizador do administrador Nome de login para a conta de administrador do PostgreSQL.
Palavra-passe de administrador Palavra-passe para a conta de administrador.
Confirmar a palavra-passe do administrador Reintroduza a palavra-passe do administrador.

Capacidades de IA

A secção de capacidades de IA permite-lhe ativar funcionalidades integradas de gestão de modelos de IA. Seleciona a opção Ativar funcionalidades de IA para te candidatares. Quando as funcionalidades de IA estão ativadas, o cluster fornece suporte à gestão de modelos, pgvector, e pg_diskann extensões.

Note

A secção de capacidades de IA é uma experiência de pré-visualização e pode não aparecer para todos os ambientes ou configurações de cluster. Se a secção não estiver visível, continue com as definições padrão do cluster Azure HorizonDB (Preview) e os passos de implementação.

Passo 4: Aceitar os termos e deslocar-se

No final do formulário:

  1. Selecione a caixa de seleção dos termos suplementares do cluster.
  2. Se ativaste funcionalidades de IA e a caixa de seleção de termos suplementares de IA estiver visível, seleciona-a.
  3. Consulte os Termos de Utilização e a Política de Privacidade ligados.
  4. Selecione Criar para começar a provisionar. Se o formulário estiver incompleto, passe o rato sobre o botão Criar desativado para ver quais os campos que ainda precisam de valores.

A extensão navega até uma página de progresso que acompanha cada etapa da implementação. Um resumo de implementação mostra o nome do Cluster, Subscrição, Grupo de Recursos e Configuração (vCores e memória) que selecionou.

Quando todas as etapas estão concluídas, a extensão cria um perfil de ligação para o novo cluster. Selecione Feito para fechar a página de progresso.

Note

Se ativaste funcionalidades de IA e a etapa de gestão do modelo de IA falhar, o cluster continua a ser criado e um perfil de ligação é adicionado. A página de progresso mostra um aviso e um link para abrir o cluster no portal do Azure, para que possas ativar manualmente a gestão de modelos de IA.

Gorjeta

Selecione Configurar no portal do Azure no final do formulário se precisar de opções além das que o assistente de extensões fornece.

Verificar o servidor

Depois de o servidor ser criado (Docker ou Azure):

  1. Expanda o nó do servidor na árvore Conexões.
  2. Confirma que as bases de dados padrão (postgres e, no caso do Docker, qualquer base de dados que especificaste) estão listadas.
  3. Clique com o botão direito numa base de dados e selecione Nova Consulta para abrir o editor de consultas.
  4. Execute uma consulta de teste, por exemplo SELECT version(); , para verificar a conectividade.

Conteúdo relacionado

  • Last updated on