ServBay

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย
한국어

Appearance

Guia de Gerenciamento e Migração de Arquivos de Banco de Dados no ServBay ​

O ServBay é um ambiente robusto de desenvolvimento web local, integrado a diversos sistemas de gerenciamento de bancos de dados populares, e organiza os arquivos de dados de banco de dados de forma padronizada. Entender a estrutura dos arquivos de banco de dados padrão do ServBay é essencial para quem precisa realizar rotinas de backup, restauração ou migração de dados.

Este guia explica detalhadamente a estrutura padrão de armazenamento de arquivos de bancos de dados no ServBay e orienta como realizar o gerenciamento e migração desses arquivos usando ferramentas de linha de comando padrão.

TIP

O ServBay oferece funções nativas de backup e restauração, permitindo salvar seus bancos de dados MySQL, MariaDB e PostgreSQL de forma automática ou manual. Consulte a seção Backup e Restauração para mais detalhes.

Estrutura Padrão de Armazenamento de Arquivos do ServBay ​

Para facilitar o gerenciamento e isolar os dados de diferentes versões, o ServBay armazena todos os arquivos de dados de banco de dados debaixo do diretório /Applications/ServBay/db. Dentro dele, os arquivos são divididos por tipo de banco de dados e, posteriormente, pela versão principal (major version).

Veja abaixo um exemplo típico da estrutura do diretório /Applications/ServBay/db:

/Applications/ServBay/db
├── mysql
│   ├── 8.0
│   └── 8.1
├── mariadb
│   ├── 10.10
│   ├── 10.11
│   ├── 10.5
│   ├── 10.6
│   ├── 10.7
│   ├── 10.8
│   ├── 10.9
│   ├── 11.0
│   ├── 11.1
│   ├── 11.2
│   └── 11.3
├── postgresql
│   ├── 10
│   ├── 11
│   ├── 12
│   ├── 13
│   ├── 14
│   ├── 15
│   └── 16
└── redis

Explicação da Estrutura ​

  • /Applications/ServBay/db: Diretório principal para todos os arquivos de banco de dados no ServBay.
  • mysql: Armazena arquivos de dados do MySQL, divididos por versão principal como 8.0, 8.1, etc.
  • mariadb: Armazena dados do MariaDB em subdiretórios por versão (10.11, 11.3...).
  • postgresql: Onde ficam os dados do PostgreSQL, também organizados por versão principal (15, 16, etc).
  • redis: Guarda os arquivos de persistência do Redis, normalmente o arquivo dump.rdb.

Com essa estrutura, é possível instalar e executar múltiplas versões do mesmo banco de dados no ServBay, mantendo os arquivos isolados e evitando conflitos.

Gerenciamento de Arquivos de Banco de Dados ​

Durante o desenvolvimento local, é comum realizar backups, restaurações e migrações de bancos de dados. Veja abaixo como executar essas tarefas usando as ferramentas oficiais de linha de comando. Lembre-se de utilizar o terminal fornecido pelo ServBay ou garantir que as variáveis de ambiente estejam corretamente configuradas para acessar os clientes de banco de dados.

Backup de Bancos de Dados ​

O backup regular é essencial para garantir a segurança dos dados. Confira exemplos para cada tipo de banco de dados:

Backup do MySQL ​

O método padrão de backup do MySQL é o uso do mysqldump.

bash
# Acesse o terminal do ServBay ou certifique-se que o PATH inclui o diretório bin do ServBay
# Por exemplo: export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u seu_usuario -p seu_banco > /Applications/ServBay/backup/seu_banco.sql
  • seu_usuario: Substitua pelo nome do usuário do banco de dados.
  • seu_banco: Nome do banco de dados que deseja fazer o backup.
  • /Applications/ServBay/backup/seu_banco.sql: Caminho e nome do arquivo de backup. Sugere-se salvar fora da pasta do ServBay, como no seu diretório pessoal.

Backup do MariaDB ​

O processo é idêntico ao do MySQL:

bash
# Acesse o terminal do ServBay ou certifique-se que o PATH inclui o diretório bin do ServBay

mysqldump -u seu_usuario -p seu_banco > /Applications/ServBay/backup/seu_banco.sql
  • Os parâmetros têm a mesma função descrita acima.

Backup do PostgreSQL ​

Utilize o pg_dump para o backup do PostgreSQL. No ambiente ServBay, o PostgreSQL geralmente usa o Unix Domain Socket localizado em /Applications/ServBay/tmp. Por isso, especifique -h /Applications/ServBay/tmp na linha de comando.

bash
# Acesse o terminal do ServBay ou garanta o PATH correto

pg_dump -h /Applications/ServBay/tmp -U seu_usuario -d seu_banco -F c -b -v -f /Applications/ServBay/backup/seu_banco.dump
  • Parâmetros de conexão:
    • macOS: -h /Applications/ServBay/tmp (caminho do socket)
    • Windows: -h localhost -p 5432 (conexão TCP)
  • -U seu_usuario: Nome do usuário do banco de dados.
  • -d seu_banco: Nome do banco de dados.
  • -F c: Formato de saída (arquivo de backup personalizado, recomendado).
  • -b: Inclui blobs.
  • -v: Verboso.
  • -f /Applications/ServBay/backup/seu_banco.dump: Caminho e nome do arquivo de backup.

Backup do Redis ​

Para o Redis, normalmente basta copiar o arquivo de persistência dump.rdb:

bash
# Acesse o terminal do ServBay
# Garanta que o Redis está rodando ou que está configurado para salvar automaticamente (BGSAVE)

cp /Applications/ServBay/db/redis/dump.rdb /Applications/ServBay/backup/dump.rdb
  • /Applications/ServBay/db/redis/dump.rdb: Caminho padrão do arquivo de persistência do Redis.
  • /Applications/ServBay/backup/dump.rdb: Altere para onde deseja salvar o backup.

Restauração de Bancos de Dados ​

Se for preciso recuperar dados perdidos ou retornar a um estado anterior, utilize o arquivo de backup para restaurar:

Restauração do MySQL ​

Use o cliente mysql para restaurar arquivos .sql:

bash
# Acesse o terminal do ServBay

mysql -u seu_usuario -p seu_banco < /Applications/ServBay/backup/seu_banco.sql
  • seu_usuario: Usuário do banco.
  • seu_banco: Bancos de dados de destino – normalmente já precisa existir.
  • /Applications/ServBay/backup/seu_banco.sql: Caminho do arquivo de backup.

Restauração do MariaDB ​

O processo é idêntico ao do MySQL:

bash
# Acesse o terminal do ServBay

mysql -u seu_usuario -p seu_banco < /Applications/ServBay/backup/seu_banco.sql
  • Os parâmetros têm a mesma função descrita acima.

Restauração do PostgreSQL ​

Use o pg_restore para restaurar backups personalizados:

bash
# Acesse o terminal do ServBay

pg_restore -h /Applications/ServBay/tmp -U seu_usuario -d seu_banco -v /Applications/ServBay/backup/seu_banco.dump
  • Parâmetros de conexão:
    • macOS: -h /Applications/ServBay/tmp (socket)
    • Windows: -h localhost -p 5432 (TCP)
  • -U seu_usuario: Usuário do banco.
  • -d seu_banco: Banco de destino – deve existir previamente.
  • -v: Verboso.
  • Caminho do arquivo de backup:
    • macOS: /Applications/ServBay/backup/seu_banco.dump
    • Windows: C:\ServBay\backup\seu_banco.dump

Restauração do Redis ​

Para restaurar o Redis, copie o arquivo dump.rdb para o diretório de dados do Redis. Importante: Pare o serviço do Redis antes de executar esta ação.

bash
# Acesse o terminal do ServBay
# Pare o serviço Redis no ServBay
# Copie o arquivo de backup
cp /Applications/ServBay/backup/dump.rdb /Applications/ServBay/db/redis/dump.rdb
# Inicie o serviço Redis no ServBay
  • /Applications/ServBay/backup/dump.rdb: Caminho do backup.
  • /Applications/ServBay/db/redis/dump.rdb: Caminho padrão do Redis.

Migração de Bancos de Dados ​

A migração consiste em mover dados entre ambientes – seja outro ServBay, servidor remoto ou outro local. Geralmente, exporta-se os dados da origem e os importa na nova instância.

Migração do MySQL ​

Veja como migrar o MySQL, parte comum no dia a dia do desenvolvimento.

  1. Exportando o banco do ambiente de origem:

    bash
    # No terminal da origem
mysqldump -u seu_usuario_origem -p seu_banco > seu_banco.sql
    • seu_usuario_origem: Usuário da origem.
    • seu_banco: Nome do banco.
    • seu_banco.sql: Nome do arquivo exportado.

  2. Transfira o arquivo SQL para o ambiente ServBay de destino: Use scp ou outro método para transferir seu_banco.sql para um diretório acessível pelo ServBay, por exemplo /Applications/ServBay/backup/.

  3. Crie o banco de dados no ambiente de destino:

    bash
    # No terminal do ServBay de destino
mysql -u seu_usuario_destino -p -e "CREATE DATABASE seu_banco;"
    • seu_usuario_destino: Usuário no ambiente ServBay destino.
    • seu_banco: Nome do banco (deve ser o mesmo da origem).

  4. Importe o banco no ambiente de destino:

    bash
    # No terminal do ServBay de destino
mysql -u seu_usuario_destino -p seu_banco < /caminho/do/seu_banco.sql
    • /caminho/do/seu_banco.sql: Caminho do arquivo SQL no destino.

Migração do MariaDB ​

Veja como migrar o MariaDB. Os procedimentos são idênticos ao MySQL.

  1. Exportando o banco da origem:
    bash
    # No terminal da origem
mysqldump -u seu_usuario_origem -p seu_banco > seu_banco.sql
  2. Transfira o arquivo SQL ao destino.
  3. Crie o banco de dados no ServBay destino:
    bash
    # No terminal do destino
mysql -u seu_usuario_destino -p -e "CREATE DATABASE seu_banco;"
  4. Importe os dados no destino:
    bash
    # No terminal do destino
mysql -u seu_usuario_destino -p seu_banco < /caminho/do/seu_banco.sql

Migração do PostgreSQL ​

Veja como migrar o PostgreSQL usando pg_dump e pg_restore, lembrando do caminho de socket apropriado.

  1. Exportando do ambiente de origem:

    bash
    # No terminal da origem
# Se a origem for ServBay:
pg_dump -h /Applications/ServBay/tmp -U seu_usuario_origem -d seu_banco -F c -b -v -f seu_banco.dump
# Ajuste os parâmetros de conexão conforme o sistema
    • seu_usuario_origem: Usuário origem.
    • seu_banco: Banco de dados.
    • seu_banco.dump: Arquivo exportado.

  2. Transfira o arquivo para o ambiente de destino ServBay.

  3. Crie o banco no ambiente ServBay:

    bash
    # No terminal do ServBay destino
# Conecte ao banco padrão para criar o novo banco
psql -h /Applications/ServBay/tmp -U seu_usuario_destino -d postgres -c "CREATE DATABASE seu_banco;"
    • seu_usuario_destino: Usuário destino.
    • seu_banco: Banco que será criado.

  4. Importe o backup no destino:

    bash
    # No terminal do ServBay destino
pg_restore -h /Applications/ServBay/tmp -U seu_usuario_destino -d seu_banco -v /caminho/do/seu_banco.dump
    • /caminho/do/seu_banco.dump: Caminho do backup no destino.

Migração do Redis ​

No Redis, migra-se copiando diretamente o arquivo dump.rdb.

  1. Obtenha o arquivo dump.rdb do ambiente de origem:

    bash
    # No terminal de origem
# Pare o Redis ou aguarde o BGSAVE completar
cp /caminho/da/origem/redis/dump.rdb ./dump.rdb

  2. Transfira para o diretório do Redis no ServBay de destino:

    bash
    # No terminal de origem ou de um servidor intermediário
scp ./dump.rdb seu_servidor_destino:/Applications/ServBay/db/redis/dump.rdb
    • seu_servidor_destino: Endereço/hostname do destino.
    • Importante: Antes de copiar, pare o serviço Redis no ServBay de destino.

  3. Inicie o Redis no ambiente ServBay de destino. Com o serviço rodando, o Redis carrega automaticamente o novo arquivo.

Considerações Importantes ​

  • Parar os serviços: Ao copiar ou mover arquivos de dados de bancos (especialmente diretórios MySQL/MariaDB/PostgreSQL), sempre pare os serviços pelos controles do ServBay ou via comando, para evitar corrupção de dados. O Redis também deve ser parado para restaurar via arquivo dump.rdb.
  • Permissões: Garanta que o usuário responsável pelas operações tem permissão suficiente para acessar e modificar os arquivos e diretórios necessários.
  • Caminho dos arquivos: Confira cuidadosamente o caminho de instalação do ServBay (padrão: /Applications/ServBay) e as subpastas específicas de cada banco de dados/versão.
  • Usuários e permissões no banco: Após a migração, revise usuários, permissões e configurações do banco, adaptando ao novo ambiente.
  • Backup nativo do ServBay: O ServBay oferece backup e restauração fáceis pela interface gráfica, incluindo configurações, sites, arquivos de banco de dados e certificados SSL - uma alternativa ou complemento à gestão manual dos arquivos.

Resumo ​

Com uma estrutura de arquivos organizada, o ServBay torna simples e seguro o gerenciamento dos dados de bancos de dados por desenvolvedores. Este guia detalha onde ficam os arquivos dos bancos MySQL, MariaDB, PostgreSQL e Redis no ServBay, e como realizar backup, restauração e migração usando as ferramentas oficiais. Dominando esses processos, você garante segurança e flexibilidade para o desenvolvimento, facilitando a transferência de dados entre diferentes ambientes. E, aproveitando os recursos nativos do ServBay, você potencializa ainda mais sua produtividade e administração dos bancos de dados locais.