ServBay

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Português

English
简体中文
繁體中文
Español
العربية
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano

Appearance

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

O ServBay é um ambiente local de desenvolvimento web poderoso, integrando diversos sistemas populares de gerenciamento de banco de dados e organizando seus arquivos de dados de forma padronizada. Para os desenvolvedores, compreender a estrutura padrão de armazenamento de arquivos de banco de dados do ServBay é fundamental para realizar backups, restaurações e migrações de forma eficiente.

Este guia detalha a estrutura padrão de armazenamento de arquivos de banco de dados no ServBay e oferece instruções sobre o gerenciamento de arquivos e a migração entre diferentes ambientes utilizando ferramentas padrão de linha de comando.

TIP

O ServBay oferece funcionalidades automáticas e manuais de backup e restauração para bancos de dados MySQL, MariaDB e PostgreSQL. Consulte a seção Backup e Restauração para mais informações.

Estrutura de armazenamento padrão de arquivos de banco de dados no ServBay ​

Para facilitar a organização e isolamento dos dados de diferentes versões do banco de dados, o ServBay unifica o armazenamento dos arquivos de dados de todos os bancos no diretório /Applications/ServBay/db. Esse diretório é organizado por tipo de banco de dados e, dentro de cada tipo, pelos principais números de versão (major version).

Veja abaixo um exemplo típico de 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 dos Diretórios ​

  • /Applications/ServBay/db: Diretório principal para todos os arquivos de banco de dados do ServBay.
  • mysql: Contém os arquivos de dados do MySQL, organizados por versão principal (ex: 8.0, 8.1).
  • mariadb: Contém os dados do MariaDB, segmentados por versão principal (ex: 10.11, 11.3).
  • postgresql: Armazena os arquivos do PostgreSQL, separados por versão principal (ex: 15, 16).
  • redis: Guarda os arquivos de persistência do Redis, normalmente o arquivo dump.rdb.

Essa estrutura permite que múltiplas versões principais do mesmo banco de dados sejam instaladas e executadas simultaneamente, com isolamento total dos seus arquivos de dados, evitando qualquer interferência entre elas.

Gerenciamento de Arquivos de Banco de Dados ​

Durante o desenvolvimento local, é comum realizar backups, restaurações e migrações de bancos de dados. Abaixo estão os métodos recomendados para essas operações utilizando as ferramentas de linha de comando padrão. Lembre-se de executar essas operações no terminal fornecido pelo ServBay ou garantir que as variáveis de ambiente estejam corretamente configuradas para acessar os clientes e utilitários dos bancos de dados.

Realizando Backups dos Bancos de Dados ​

Backups regulares são essenciais para garantir a segurança dos dados. Veja como realizar backups dos diferentes tipos de bancos de dados no ServBay.

Backup do MySQL ​

A maneira padrão de criar backup do MySQL é utilizando a ferramenta mysqldump:

bash
# Acesse o terminal do ServBay ou garanta que o diretório bin do ServBay esteja no PATH
# Exemplo: export PATH="/Applications/ServBay/bin:$PATH"

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql
  • your_username: Substitua pelo seu nome de usuário do banco.
  • your_database: Substitua pelo nome do banco de dados a ser copiado.
  • /Applications/ServBay/backup/your_database.sql: Defina o caminho e nome do arquivo de backup. Recomenda-se armazenar os backups fora do diretório do ServBay, como na sua pasta de usuário.

Backup do MariaDB ​

O procedimento de backup do MariaDB é idêntico ao do MySQL, também usando o mysqldump.

bash
# Acesse o terminal do ServBay ou garanta que o diretório bin do ServBay esteja no PATH

mysqldump -u your_username -p your_database > /Applications/ServBay/backup/your_database.sql
  • Parâmetros iguais ao exemplo anterior.

Backup do PostgreSQL ​

Use a ferramenta pg_dump para realizar backup do PostgreSQL. No ServBay, o PostgreSQL normalmente conecta por Unix Domain Socket, cujo caminho padrão é /Applications/ServBay/tmp. Utilize o parâmetro -h /Applications/ServBay/tmp.

bash
# Acesse o terminal do ServBay ou garanta que o diretório bin do ServBay esteja no PATH

pg_dump -h /Applications/ServBay/tmp -U your_username -d your_database -F c -b -v -f /Applications/ServBay/backup/your_database.dump
  • -h /Applications/ServBay/tmp: Especifica o caminho do socket do servidor PostgreSQL.
  • -U your_username: Nome de usuário do banco de dados.
  • -d your_database: Nome do banco a ser copiado.
  • -F c: Formato de saída customizado (recomendado).
  • -b: Inclui objetos grandes (blobs).
  • -v: Saída detalhada.
  • -f /Applications/ServBay/backup/your_database.dump: Caminho e nome do arquivo de backup.

Backup do Redis ​

O backup do Redis geralmente consiste em copiar seu arquivo de persistência dump.rdb.

bash
# Acesse o terminal do ServBay
# Certifique-se de que o Redis está em execução ou 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: Defina onde deseja salvar o arquivo de backup.

Restauração de Bancos de Dados ​

Em caso de perda de dados ou para reverter para um estado anterior, utilize os arquivos de backup para restaurar os bancos de dados.

Restaurar MySQL ​

Utilize o cliente mysql para restaurar o backup do MySQL:

bash
# Acesse o terminal do ServBay

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
  • your_username: Nome de usuário do banco.
  • your_database: Nome do banco ao qual restaurar. Este banco deve ser criado previamente.
  • /Applications/ServBay/backup/your_database.sql: Caminho do arquivo de backup.

Restaurar MariaDB ​

O processo para restaurar o MariaDB é igual ao do MySQL:

bash
# Acesse o terminal do ServBay

mysql -u your_username -p your_database < /Applications/ServBay/backup/your_database.sql
  • Parâmetros iguais ao exemplo anterior.

Restaurar PostgreSQL ​

Use o utilitário pg_restore para restaurar backups em formato customizado. Especifique o caminho do socket com -h /Applications/ServBay/tmp.

bash
# Acesse o terminal do ServBay

pg_restore -h /Applications/ServBay/tmp -U your_username -d your_database -v /Applications/ServBay/backup/your_database.dump
  • -h /Applications/ServBay/tmp: Caminho do socket do PostgreSQL.
  • -U your_username: Nome de usuário do banco.
  • -d your_database: Banco de destino (deve ser criado previamente).
  • -v: Saída detalhada.
  • /Applications/ServBay/backup/your_database.dump: Caminho do backup.

Restaurar Redis ​

A restauração do Redis é feita copiando o arquivo dump.rdb de backup para o diretório de dados do Redis. Importante: pare o serviço Redis antes de executar esta operaçã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
# Reinicie o serviço Redis no ServBay
  • /Applications/ServBay/backup/dump.rdb: Caminho do backup.
  • /Applications/ServBay/db/redis/dump.rdb: Caminho padrão do arquivo de dados do Redis.

Migração de Bancos de Dados ​

A migração de banco de dados consiste em transferir dados de um ambiente para outro (por exemplo, entre instâncias diferentes do ServBay, servidores remotos ou locais). Normalmente, isso envolve exportar dados do ambiente de origem e importá-los no destino.

Migração do MySQL ​

Veja instruções detalhadas para migrar o MySQL:

  1. Exporte o banco de dados no ambiente de origem:

    bash
    # No terminal do ambiente de origem
mysqldump -u your_source_username -p your_database > your_database.sql
    • your_source_username: Usuário no ambiente de origem.
    • your_database: Nome do banco a ser migrado.
    • your_database.sql: Nome do arquivo exportado.

  2. Transfira o arquivo SQL exportado para o ambiente de destino: Use o scp ou outro utilitário para transferir o arquivo your_database.sql para um local acessível no ambiente ServBay de destino (como /Applications/ServBay/backup/).

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

    bash
    # No terminal do ServBay de destino
mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
    • your_target_username: Usuário no ambiente de destino.
    • your_database: Nome do banco a ser criado (recomenda-se usar o mesmo do ambiente de origem).

  4. Importe o banco de dados no destino:

    bash
    # No terminal do ServBay de destino
mysql -u your_target_username -p your_database < /path/to/your_database.sql
    • /path/to/your_database.sql: Caminho do arquivo SQL no ambiente de destino.

Migração do MariaDB ​

Veja instruções detalhadas para migrar o MariaDB. O processo é idêntico ao do MySQL, já que ambos utilizam as mesmas ferramentas e formatos.

  1. Exporte o banco de dados no ambiente de origem:
    bash
    # No terminal do ambiente de origem
mysqldump -u your_source_username -p your_database > your_database.sql
  2. Transfira o arquivo SQL exportado para o ambiente ServBay de destino.
  3. Crie o banco de dados no ServBay de destino:
    bash
    # No terminal do ServBay de destino
mysql -u your_target_username -p -e "CREATE DATABASE your_database;"
  4. Importe o banco de dados no destino:
    bash
    # No terminal do ServBay de destino
mysql -u your_target_username -p your_database < /path/to/your_database.sql

Migração do PostgreSQL ​

Veja instruções detalhadas de migração para PostgreSQL usando pg_dump e pg_restore. Atente-se para o caminho do socket no ambiente ServBay.

  1. Exporte o banco de dados do ambiente de origem:

    bash
    # No terminal do ambiente de origem
# Se o ambiente de origem for o ServBay
pg_dump -h /Applications/ServBay/tmp -U your_source_username -d your_database -F c -b -v -f your_database.dump
# Se outro sistema, ajuste os parâmetros conforme necessário.
    • your_source_username: Usuário do banco de origem.
    • your_database: Nome do banco a ser migrado.
    • your_database.dump: Nome do arquivo backup.

  2. Transfira o arquivo exportado para o ambiente ServBay de destino usando scp ou outro utilitário.

  3. Crie o banco de dados no destino:

    bash
    # No terminal do ServBay de destino
# Conecte-se ao postgres padrão para criar um novo banco
psql -h /Applications/ServBay/tmp -U your_target_username -d postgres -c "CREATE DATABASE your_database;"
    • your_target_username: Usuário de destino.
    • your_database: Nome do banco a ser criado.

  4. Restaure o banco no destino:

    bash
    # No terminal do ServBay de destino
pg_restore -h /Applications/ServBay/tmp -U your_target_username -d your_database -v /path/to/your_database.dump
    • /path/to/your_database.dump: Caminho do arquivo backup no destino.

Migração do Redis ​

Para migrar bancos Redis, basta copiar o arquivo dump.rdb.

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

    bash
    # No terminal do ambiente de origem
# Certifique-se de parar o serviço Redis, ou executar o BGSAVE antes
cp /path/to/source/redis/dump.rdb ./dump.rdb

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

    bash
    # No ambiente de origem ou servidor intermediário
scp ./dump.rdb your_target_server:/Applications/ServBay/db/redis/dump.rdb
    • your_target_server: Endereço ou hostname do servidor ServBay de destino.
    • Importante: Antes de copiar para o diretório /Applications/ServBay/db/redis/ do ServBay de destino, certifique-se de que o serviço Redis esteja parado.

  3. Inicie o serviço Redis no ambiente de destino: Ao iniciar, o Redis carregará automaticamente o novo arquivo dump.rdb.

Observações Importantes ​

  • Pare os serviços: Antes de copiar ou mover os arquivos de banco de dados diretamente (especialmente diretórios de dados do MySQL/MariaDB/PostgreSQL), sempre pare o serviço correspondente pelo GUI do ServBay ou pela linha de comando. Copiar arquivos de bancos em execução pode causar corrupção ou inconsistências nos dados. O Redis também deve estar parado ao restaurar usando o arquivo dump.rdb.
  • Permissões: Certifique-se de que o usuário que executará cópias, movimentações ou importações tem permissão suficiente para acessar e modificar os diretórios e arquivos necessários.
  • Caminhos dos arquivos: Verifique cuidadosamente o caminho de instalação do ServBay (padrão é /Applications/ServBay) e os diretórios específicos dos bancos, especialmente para diferentes versões.
  • Usuários e permissões: Após a migração, confira se os usuários, permissões e arquivos de configuração dos bancos precisam de atualização para funcionar no novo ambiente.
  • Backup embutido do ServBay: O ServBay também oferece recursos internos de backup e restauração pelo GUI, incluindo configurações, arquivos do site, bancos de dados e certificados SSL, servindo como alternativa ou complemento à administração manual de arquivos.

Resumo ​

Por meio de uma estrutura de arquivos padronizada, o ServBay oferece aos desenvolvedores uma base sólida para o gerenciamento dos arquivos de bancos de dados. Este guia detalhou os caminhos e organização dos arquivos para MySQL, MariaDB, PostgreSQL e Redis dentro do ServBay, além de fornecer orientações práticas de backup, restauração e migração utilizando ferramentas de linha de comando. Dominar esses procedimentos permite gerenciar melhor os dados dos bancos no seu ambiente de desenvolvimento e garantir sua segurança, migrando projetos entre ambientes com eficiência. Aproveite também os demais recursos do ServBay, como os backups internos, para maximizar a produtividade e a segurança dos seus dados.