Gestão de servidores do Azure

A extensão PostgreSQL para Visual Studio Code permite-lhe gerir recursos suportados do Base de Dados do Azure para PostgreSQL diretamente a partir do Visual Studio Code. Depois de se ligar a um servidor flexível do Base de Dados do Azure para PostgreSQL, pode abrir o painel do servidor para controlar o ciclo de vida do servidor, gerir o acesso à rede, alterar parâmetros, criar ou restaurar backups, clonar o servidor e descarregar registos capturados. As ligações Azure HorizonDB (Preview) suportam uma página de Configuração de Rede mais pequena para regras de firewall.

Abrir páginas de gestão do Azure

1. Na árvore de Conexões, liga-te ao recurso Base de Dados do Azure para PostgreSQL que queres gerir.
2. Clique com o botão direito no nó do servidor e selecione Dashboard.
3. Para ações flexíveis do ciclo de vida do servidor Base de Dados do Azure para PostgreSQL, selecione Ações>Iniciar, Parar ou Reiniciar no painel do servidor.
4. Para abrir páginas de gestão do Azure, selecione Definições do Servidor e depois escolha uma página suportada, como Configuração de Rede, Parâmetros do Servidor, Backups ou Registos do Servidor.

Iniciar, parar ou reiniciar um servidor

Podes executar ações do ciclo de vida a partir do menu Ações na barra de ferramentas do dashboard ou do menu contextual do servidor na árvore de Ligações .

Iniciar um servidor

1. Na árvore de Ligações, clique com o botão direito no servidor e selecione Iniciar servidor, ou abra o painel e selecione Iniciar Ações>.
2. Espere enquanto a extensão mostra uma notificação de progresso e consulta o Azure para obter o resultado da operação.
3. Confirme que o servidor regressa ao estado Pronto antes de se reconectar ou abrir páginas de gestão.

Parar um servidor

1. Na árvore de Conexões , clique com o botão direito no servidor e selecione Parar o servidor, ou abra o painel e selecione Ações>Parar.
2. No diálogo de confirmação, selecione Parar.
3. Espere enquanto a extensão termina a operação de paragem.
4. Religa-te depois de reiniciares o servidor.

Reiniciar um servidor

Se guardar parâmetros que exigem reinício e selecionar Sim no prompt de reinício, a extensão inicia o reinício automaticamente. Usa estes passos quando quiseres reiniciar o servidor tu mesmo.

1. Na árvore de Ligações, clique com o botão direito no servidor e selecione Reiniciar servidor, ou abra o painel e selecione Ações>Reiniciar.
2. Espera enquanto a extensão reinicia o servidor e atualiza o estado do servidor.
3. Continue a trabalhar depois de o servidor regressar ao estado Pronto .

Gerenciar o acesso à rede

Abrir Definições> do ServidorConfiguração de Rede para gerir o acesso à rede.

Para o servidor flexível Base de Dados do Azure para PostgreSQL, a página de Configuração de Rede desativa a edição do firewall até que o acesso público esteja ativado. Também mantém o Save desativado até fazeres uma alteração válida. O Azure HorizonDB (Pré-visualização) não mostra controlos de acesso públicos, mas inclui a caixa Permitir acesso público de qualquer serviço Azure dentro do Azure para este servidor.

Adicionar ou editar uma regra de firewall

1. Abra Definições do Servidor>Configuração de Rede.
2. Para o Base de Dados do Azure para PostgreSQL Flexible Server, em Public Access, ativa o acesso público se estiver atualmente desligado.
3. Na tabela de regras do firewall, use a linha vazia para introduzir o nome de uma regra do firewall, o endereço IP inicial e o endereço IP final, ou atualize uma linha existente.
4. Selecione Guardar.

Use estas regras de validação ao editar uma regra:

Permita o endereço IP do seu cliente atual

1. Abra Definições do Servidor>Configuração de Rede.
2. Na tabela de regras do firewall, selecione o link que começa com Adicionar endereço IP atual do cliente.
3. Revise a regra inserida e selecione Guardar.

Se o painel não conseguir detetar o seu endereço IP público, a ligação muda para Incapaz de determinar automaticamente o endereço IP atual. Introduza o endereço manualmente na linha vazia de regras do firewall.

Configurar definições de acesso mais amplas

Use estas opções de servidor flexível do Base de Dados do Azure para PostgreSQL na página de Configuração de Rede quando regras individuais de IP não são suficientes:

Alterar parâmetros

Abra Parâmetros de Definições>do Servidor para pesquisar, filtrar, editar e redefinir os parâmetros PostgreSQL para o servidor.

Encontrar um parâmetro

1. Abra Definições do Servidor>Parâmetros do Servidor.
2. Use os botões de filtro como Tudo, Modificado, Estático, Dinâmico ou Somente Leitura para restringir a lista.
3. Use a caixa de texto para pesquisar por nome ou descrição do parâmetro.
4. Se precisar de um conjunto de trabalho maior, altere Linhas por página para 25, 50, ou 100.
5. Se quiseres agrupar definições semelhantes antes de as editares, ordena uma coluna.

Guardar alterações aos parâmetros

1. Abra Definições do Servidor>Parâmetros do Servidor.
2. Encontra o parâmetro que queres alterar.
3. Edita o valor diretamente na coluna Valor .
4. Se o parâmetro mostrar um botão de informação, passe o rato para rever os valores permitidos.
5. Selecione Guardar.

Se o parâmetro exigir um reinício, a página adiciona uma linha de Reinício Pendente abaixo do parâmetro. Quando guarda um ou mais parâmetros estáticos, a extensão pergunta se quer reiniciar o servidor imediatamente.

Redefinir um parâmetro para o valor padrão

1. Abra Definições do Servidor>Parâmetros do Servidor.
2. Encontra o parâmetro que queres reiniciar.
3. Selecione o ícone de reset ao lado do parâmetro.
4. Selecione Guardar.

Gerir cópias de segurança

Abra Definições do servidor>Backups para gerir cópias de segurança automáticas e a pedido.

Criar uma cópia de segurança a pedido

1. Abra Definições do servidor>Backups.
2. Selecione Fazer cópia de segurança agora.
3. Em Criar backup, introduza um nome de Backup.
4. Selecione Criar.

Os nomes de reserva podem conter apenas letras, números, hífens (-) e sublinhados (_).

Restaurar a partir de um backup

1. Abra Definições do servidor>Backups.
2. Encontra o backup que queres usar.
3. Selecione Restaurar a partir desta cópia de segurança.
4. Complete o fluxo de restauro para criar um novo servidor flexível da Base de Dados do Azure para PostgreSQL a partir desse backup.

Eliminar uma cópia de segurança a pedido

1. Abra Definições do servidor>Backups.
2. Localize a cópia de segurança a pedido que pretende remover.
3. Selecione Eliminar.
4. Em Eliminar backup, selecione Eliminar novamente para confirmar.

Backups automáticos continuam geridos pelo Azure e não podem ser eliminados da extensão.

Alterar a retenção de cópias de segurança

1. Abra Definições do servidor>Backups.
2. Move o controlo de retenção para o número de dias que queres.
3. Selecione Guardar.

Também pode filtrar a lista de backup com Automático ou On-demand, restringi-la com filtros de tempo como Últimas 24 horas ou Últimos 7 dias, e ordenar a tabela por Nome, Estado, Tempo de Conclusão, Retido até ou Tipo.

Faça backup de uma base de dados com pg_dump (Pré-visualização)

O comando Backup... executa uma cópia de segurança do lado pg_dump do cliente de uma única base de dados e escreve o resultado na pasta de saída que escolheres. Ao contrário dos backups geridos pelo Azure, este fluxo de trabalho funciona para qualquer ligação PostgreSQL — local, Docker ou Azure.

Esta funcionalidade é uma pré-visualização desligada por defeito. Para o ligar, defina pgsql.enablePgDumpRestoreUI para true nas definições do VS Code.

Criar uma cópia de segurança

1. Na árvore de Conexões, clique com o botão direito num nó de base de dados e selecione Backup.... Para servidores Azure (servidor flexível ou HorizonDB), também pode clicar com o botão direito no nó do servidor e selecionar Gestão do Servidor>Backup....

2. No painel Backup da Sua Base de Dados , escolha a Base de Dados para fazer backup.

3. Defina a Pasta de destino e o Nome do ficheiro para a cópia de segurança.

4. Escolha um formato:

   Formato	Description
   Personalizada (.backup)	Formato binário que suporta compressão e restauro paralelo. Recomendado para a maioria dos backups.
   SQL simples (.sql)	Script SQL legível por humanos. Sem compressão.
   Directory	Um ficheiro por tabela. Suporta backup e restauro paralelos.
   Tar (.tar)	Arquivo de ficheiros SQL. Sem compressão.

5. Para o formato Personalizado ou Diretório , defina um nível de Compressão . Recomenda-se o nível 6.

6. Em Conteúdos, escolha Esquema + dados, Apenas Esquema ou Apenas Dados.

7. Para rever o comando gerado antes de o executar, consulte a Pré-visualização do Comando. Selecione o comando Copiar para o copiar.

8. Selecione Iniciar Backup.

O painel apresenta a saída pg_dump enquanto a cópia de segurança é executada. Quando terminar, selecione Abrir Backup para abrir a pasta de saída, ou Fazer Outro Backup para começar novamente. Se o backup falhar, selecione Ver registos completos para mais detalhes, ou Depurar com o Copilot para resolução de problemas assistida por IA.

Afinar o backup

Selecione Opções Avançadas para abrir uma gaveta com definições adicionais:

• Âmbito: limitar o backup a esquemas ou tabelas específicas.
• Conteúdo: inclua ou exclua as secções Pré-Dados, Dados e Pós-Dados , e escolha se inclui objetos grandes.
• Desempenho e registos: definir Tarefas paralelas (apenas formato de diretório) e ativar Registo detalhado.
• Comportamento do restauro: escolha se pretende incluir a propriedade e os privilégios (GRANTs) e se pretende desativar os gatilhos enquanto os dados são carregados num restauro posterior.
• Opções de Formato SQL: para o formato Plain SQL, adicione instruções clean, create-database ou instruções baseadas em INSERT.
• Segurança: altere Ativar segurança ao nível da linha para controlar o tratamento da segurança ao nível da linha no dump.

Clonar um servidor

Utilize Clone Server quando quiser criar um novo Base de Dados do Azure para PostgreSQL – servidor flexível com base no servidor atual.

1. Abra o dashboard.
2. Selecione Definições do Servidor>Clonar Servidor.
3. Complete o fluxo de trabalho do clone para criar o novo servidor.

Capturar e descarregar registos do servidor

Abra Definições do Servidor>Registos do Servidor para capturar registos de diagnóstico e descarregá-los para resolver problemas.

Ativar ou desligar a captura de registos

1. Abra Definições do servidor>Registos do servidor.
2. Ative ou desative os registos de captura para download .
3. Se a captura de log estiver ativada, define o período de retenção de logs.
4. Selecione Guardar.

Filtrar e descarregar ficheiros de registo

1. Abra Definições do servidor>Registos do servidor.
2. Use Todos os tipos, registo do servidor ou registo de atualização para restringir a lista.
3. Use o filtro de tempo ou a caixa de pesquisa de nomes de ficheiro para encontrar os ficheiros de que precisa.
4. Selecione um ou mais ficheiros de registo, ou use o botão de download numa única linha.
5. Selecione Download.

A tabela de registos suporta ordenação por Nome, Último Modificado, Tamanho (KB) e Tipo. Quando mais de 100 ficheiros correspondem aos filtros atuais, a página mostra os controlos de paginação.

Ver atividade

Abra Definições do Servidor>Registo de Atividade para rever a atividade do plano de controlo do Azure para o servidor, incluindo alterações operacionais, eventos de estado de funcionamento e ações de gestão iniciadas pelo utilizador, como arranque, paragem e operações de configuração. Esta página está disponível tanto para ligações ao Base de Dados do Azure para PostgreSQL com servidor flexível como ao Azure HorizonDB (Preview).

1. Abra Definições do Servidor>Registo de Atividades.
2. Use os filtros de Intervalo de Tempo, Severidade e Estado para restringir a lista, ou pesquise por operação, iniciador ou estado. Selecione Reiniciar filtros para os limpar.
3. Selecione um evento para expandir os seus detalhes, como o nome da operação, estado, hora do evento e iniciador.
4. Para guardar uma cópia para análise, selecione Download como CSV.

Conteúdo relacionado

• Painel do servidor
• Criar um servidor PostgreSQL
• Ligações e identidade