Pular para o conteúdo principal
Este guia aborda como os backups funcionam no ClickHouse Cloud, quais opções você tem para configurar backups para o seu serviço e como restaurar a partir de um backup. Pré-requisitos

Lista de status de backups

Seu serviço terá backups realizados de acordo com a programação definida, seja a programação diária padrão ou uma programação personalizada escolhida por você. Todos os backups disponíveis podem ser visualizados na aba Backups do serviço. Nela, você pode ver o status, a duração e o tamanho do backup. Você também pode restaurar um backup específico pela coluna Actions.

Entendendo o custo dos backups

De acordo com a política padrão, o ClickHouse Cloud exige um backup por dia, com retenção de 24 horas. Escolher um agendamento que exija a retenção de mais dados ou resulte em backups mais frequentes pode gerar cobranças adicionais de armazenamento para os backups. Para entender o custo dos backups, você pode ver o custo por serviço na tela de uso (como mostrado abaixo). Depois de executar os backups por alguns dias com um agendamento personalizado, você poderá ter uma ideia do custo e extrapolar para chegar ao custo mensal dos backups. Para estimar o custo total dos seus backups, é necessário definir um agendamento. Antes de definir um agendamento, você pode usar a calculadora de preços para obter uma estimativa do custo mensal, fornecendo os seguintes dados:
  • Tamanho dos backups completos e incrementais
  • Frequência de backup desejada
  • Retenção de backups desejada
  • Provedor de nuvem e região
Tenha em mente que o custo estimado dos backups mudará à medida que o volume de dados no serviço aumentar ao longo do tempo.

Restaurar um backup

Os backups são restaurados em um novo serviço do ClickHouse Cloud, e não no serviço existente do qual o backup foi gerado. Após clicar no ícone de backup Restore, você pode especificar o nome do novo serviço que será criado e, em seguida, restaurar esse backup: O novo serviço aparecerá na lista de serviços como Provisioning até ficar pronto:

Trabalhando com seu serviço restaurado

Depois que um backup for restaurado, você passará a ter dois serviços semelhantes: o serviço original que precisou ser restaurado e um novo serviço restaurado, restaurado a partir de um backup do original. Quando a restauração do backup for concluída, faça uma das seguintes opções:
  • Use o novo serviço restaurado e remova o serviço original.
  • Migre os dados do novo serviço restaurado de volta para o serviço original e remova o novo serviço restaurado.

Use o novo serviço restaurado

Para usar o novo serviço, siga estas etapas:
  1. Verifique se o novo serviço possui as entradas da IP Access List necessárias para o seu caso de uso.
  2. Verifique se o novo serviço contém os dados de que você precisa.
  3. Remova o serviço original.

Migre os dados do serviço restaurado recentemente de volta para o serviço original

Suponha que, por algum motivo, você não consiga trabalhar com o serviço restaurado recentemente — por exemplo, se ainda houver usuários ou aplicações conectadas ao serviço existente. Nesse caso, você pode optar por migrar os dados restaurados recentemente para o serviço original. A migração pode ser feita seguindo estas etapas: Permita acesso remoto ao serviço restaurado recentemente O novo serviço deve ser restaurado a partir de um backup com a mesma IP Access List do serviço original. Isso é necessário, pois conexões com outros serviços do ClickHouse Cloud não serão permitidas, a menos que você tenha liberado acesso de Anywhere. Modifique a allow list e permita acesso de Anywhere temporariamente. Consulte a documentação de IP Access List para mais detalhes. No serviço ClickHouse restaurado recentemente (o sistema que hospeda os dados restaurados)
Você precisará redefinir a senha do novo serviço para acessá-lo. Isso pode ser feito na aba Settings da lista de serviços.
Adicione um usuário somente leitura que possa ler a source table (db.table neste exemplo):
Copie a definição da tabela:
No sistema de destino do ClickHouse Cloud (aquele que tinha a tabela danificada): Crie o banco de dados de destino:
Usando a instrução CREATE TABLE da origem, crie o destino:
Altere o ENGINE para ReplicatedMergeTree sem nenhum parâmetro ao executar a instrução CREATE. O ClickHouse Cloud sempre replica as tabelas e fornece os parâmetros corretos.
Use a função remoteSecure para extrair os dados do novo serviço do ClickHouse Cloud restaurado para o serviço original:
Depois de inserir os dados com sucesso no seu serviço original, verifique os dados no serviço. Você também deve excluir o novo serviço assim que os dados forem verificados.

Recuperando tabelas excluídas ou removidas

O comando UNDROP é compatível com o ClickHouse Cloud por meio do Shared Catalog. Para evitar que usuários removam tabelas acidentalmente, você pode usar instruções GRANT para revogar as permissões do comando DROP TABLE de um usuário ou Role específico.
Para evitar a exclusão acidental de dados, observe que, por padrão, não é possível excluir tabelas com tamanho >1TB no ClickHouse Cloud. Caso queira excluir tabelas acima desse limite, você pode usar a configuração max_table_size_to_drop para isso:
Planos legados: para clientes em planos legados, os backups diários padrão, retidos por 24 horas, estão incluídos no custo de armazenamento.

Duração dos backups

A duração do backup e da restauração depende de vários fatores, como o tamanho do banco de dados, o schema e o número de tabelas no banco de dados. Os backups incrementais normalmente são concluídos muito mais rápido do que um backup completo, já que há menos dados para incluir no backup. A restauração a partir de um backup incremental será um pouco mais lenta do que a restauração a partir de um backup completo, pois todos os backups incrementais e o último backup completo da cadeia são incluídos na restauração, conforme explicado acima. Em nossos testes, observamos que backups menores, de ~1 TB, podem levar cerca de 10 a 15 minutos ou mais para serem concluídos. Backups com menos de 20 TB devem ser concluídos em até uma hora, e o backup de 50 TB de dados deve levar cerca de 2 a 3 horas. Backups em tamanhos maiores se beneficiam de economias de escala, e vimos backups de até 1 PB para alguns serviços internos serem concluídos em cerca de 10 horas.
Backups para buckets externos podem ser mais lentos do que backups para buckets do ClickHouse
A duração da restauração é aproximadamente a mesma que a do backup. Recomendamos testar com seu próprio banco de dados ou com dados de amostra para obter estimativas mais precisas, já que a duração real depende de vários fatores, conforme descrito acima.

Backups configuráveis

Se você quiser definir uma programação de backups diferente da programação padrão, consulte Backups configuráveis.

Exporte backups para sua própria conta na nuvem

Para usuários que desejam exportar backups para sua própria conta na nuvem, consulte este guia.
Última modificação em 19 de junho de 2026