Skip to main content
Os backups automatizados para seu bucket externo são backups completos e independentes. Eles seguem a frequência de backup e o horário de início configurados para o service (a cada 24 horas por padrão). O ClickHouse também cria um backup separado em um bucket gerenciado pelo ClickHouse a cada 24 horas; essa cadência é fixa.

​
AWS

​
Fazendo backups na AWS

​
  1. Etapas a seguir na AWS

Estas etapas são semelhantes à configuração segura do S3, conforme descrito em “Acessando dados do S3 com segurança”, no entanto, há ações adicionais necessárias nas permissões da role
Siga as etapas abaixo na sua conta da AWS:
1

Crie um bucket do S3 na AWS

Crie um bucket do S3 na AWS na sua conta para o qual você deseja exportar os backups.
2

Crie uma IAM role

A AWS usa autenticação baseada em roles, então crie uma IAM role que o serviço ClickHouse Cloud poderá assumir para gravar nesse bucket.
  • a. Obtenha o ARN na página de configurações do serviço ClickHouse Cloud, em Network security information, que será semelhante a este:
  • b. Para essa role, crie a política de confiança da seguinte forma:
3

Atualize as permissões da role

Você também precisará definir as permissões dessa role para que este serviço ClickHouse Cloud possa gravar no bucket do S3. Isso é feito criando uma política de permissões para a role com um JSON semelhante a este, no qual você substitui o ARN do seu bucket no recurso em ambos os locais.

​
  1. Etapas a seguir no ClickHouse Cloud

Siga as etapas abaixo no console do ClickHouse Cloud para configurar o bucket externo:
1

Alterar backup externo

Na página Settings, clique em Configurar backup externo:
2

Configurar o ARN da IAM role da AWS e os detalhes do bucket do S3

Na tela seguinte, informe o ARN da IAM role da AWS que você acabou de criar e a URL do bucket do S3 no formato a seguir:
3

Salvar alterações

Clique em “Salvar bucket externo” para salvar as configurações
4

Alterar o agendamento de backups em relação ao padrão

Agora, os backups externos serão realizados no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backups na página “Settings”. Se ele for configurado de outra forma, o agendamento personalizado e a configuração de retenção se aplicam aos backups gravados no seu bucket. Os backups no bucket gerenciado pelo ClickHouse Cloud usam o agendamento padrão (backups a cada 24 horas) e a política de retenção padrão.
5

Ver backups armazenados no seu bucket

A página Backups exibirá esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

​
Restaurando backups da AWS

Siga as etapas abaixo para restaurar backups da AWS:
1

Crie um novo serviço para receber a restauração

Crie um novo serviço para o qual o backup será restaurado.
2

Adicione o ARN do serviço

Adicione o ARN do serviço recém-criado (na página de configurações do serviço no console do ClickHouse Cloud) à política de confiança da IAM role. Isso é o mesmo que a segunda etapa na seção Etapas da AWS acima. Isso é necessário para que o novo serviço possa acessar o bucket do S3.
3

Obtenha o comando SQL usado para restaurar o backup

Clique no link “acessar ou restaurar um backup” acima da lista de backups na UI para obter o comando SQL de restauração do backup. O comando será semelhante a este:
Movendo backups para outro localSe você mover os backups para outro local, precisará personalizar o comando de restauração para apontar para o novo local.
Comando ASYNCNo comando de restauração, você também pode adicionar opcionalmente ASYNC ao final para restaurações grandes. Isso permite que as restaurações ocorram de forma assíncrona, para que, se a conexão for perdida, a restauração continue em execução. É importante observar que o comando ASYNC retorna imediatamente um status de sucesso. Isso não significa que a restauração foi bem-sucedida. Você precisará monitorar a tabela system.backups para ver se a restauração foi concluída e se foi bem-sucedida ou falhou.
4

Execute o comando de restauração

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.

​
GCP

​
Fazendo backup no GCP

Siga as etapas abaixo para fazer backup no GCP:

​
Etapas a seguir no GCP

1

Crie um bucket de armazenamento no GCP

Crie um bucket de armazenamento na sua conta do GCP para exportar backups.
2

Gere uma chave HMAC e um segredo

Gere uma chave HMAC e um segredo, necessários para a autenticação baseada em senha. Siga as etapas abaixo para gerar as chaves:
  • a. Crie uma conta de serviço
    • I. Acesse a seção IAM & Admin no Google Cloud Console e selecione Service Accounts.
    • II. Clique em Create Service Account e forneça um nome e um ID. Clique em Create and Continue.
    • III. Conceda a função Storage Object User a essa conta de serviço.
    • IV. Clique em Done para concluir a criação da conta de serviço.
  • b. Gere a chave HMAC
    • I. Vá para Cloud Storage no Google Cloud Console e selecione Settings
    • II Vá para a guia Interoperability.
    • III. Na seção Service account HMAC, clique em Create a key for a service account.
    • IV. Escolha a conta de serviço que você criou na etapa anterior no menu suspenso.
    • V. Clique em Create key.
  • c. Armazene as credenciais com segurança:
    • I. O sistema exibirá o Access ID (sua chave HMAC) e o Secret (seu segredo HMAC). Salve esses valores, pois o segredo não será exibido novamente depois que você fechar esta janela.

​
Etapas a seguir no ClickHouse Cloud

Siga as etapas abaixo no console do ClickHouse Cloud para configurar o bucket externo:
1

Alterar backup externo

Na página Settings, clique em Alterar backup externo
2

Configurar a chave HMAC e o Secret do GCP

Na janela pop-up, informe o caminho do bucket do GCP, a chave HMAC e o Secret criados na seção anterior.
3

Salvar bucket externo

Clique em Salvar bucket externo para salvar as configurações.
4

Alterar o agendamento de backup em relação ao padrão

Os backups externos passarão a ser realizados no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backup na página Settings. Se ele for configurado de outra forma, o agendamento personalizado e a configuração de retenção se aplicam aos backups gravados no seu bucket. Os backups no bucket gerenciado pelo ClickHouse Cloud usam o agendamento padrão (backups a cada 24 horas) e a política de retenção padrão.
5

Ver backups armazenados no seu bucket

A página Backups deve exibir esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

​
Restaurando backups do GCP

Siga as etapas abaixo para restaurar backups do GCP:
1

Crie um novo serviço para o qual restaurar

Crie um novo serviço para o qual o backup será restaurado.
2

Obtenha o comando SQL usado para restaurar o backup

Clique no link acessar ou restaurar um backup acima da lista de backups na UI para obter o comando SQL para restaurar o backup. O comando deve ser parecido com este, e você pode selecionar o backup adequado no menu suspenso para obter o comando de restauração desse backup específico. Você precisará adicionar sua chave de acesso secreta ao comando:
Movendo backups para outro localSe você mover os backups para outro local, precisará personalizar o comando de restauração para apontar para o novo local.
Comando ASYNCNo comando de restauração, você também pode adicionar opcionalmente ASYNC ao final para restaurações grandes. Isso permite que as restaurações ocorram de forma assíncrona, de modo que, se a conexão for perdida, a restauração continue em execução. É importante observar que o comando ASYNC retorna imediatamente um status de sucesso. Isso não significa que a restauração foi bem-sucedida. Você precisará monitorar a tabela system.backups para verificar se a restauração foi concluída e se foi bem-sucedida ou falhou.
3

Execute o comando SQL para restaurar o backup

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.

​
Azure

​
Fazendo backups no Azure

Siga as etapas abaixo para fazer backups no Azure:

​
Etapas a seguir no Azure

1

Criar uma conta de armazenamento

Crie uma conta de armazenamento ou selecione uma conta de armazenamento existente no portal do Azure onde deseja armazenar seus backups.
2

Obter a string de conexão

  • a. Na visão geral da sua conta de armazenamento, procure a seção chamada Security + networking e clique em Access keys.
  • b. Aqui, você verá key1 e key2. Em cada uma delas, encontrará um campo Connection string.
  • c. Clique em Show para exibir a string de conexão. Copie a string de conexão que você usará na configuração do ClickHouse Cloud.

​
Etapas a seguir no ClickHouse Cloud

Siga as etapas abaixo no console do ClickHouse Cloud para configurar o bucket externo:
1

Alterar backup externo

Na página Settings, clique em Alterar backup externo
2

Informe a string de conexão e o nome do Container da sua conta de armazenamento do Azure

Na próxima tela, informe a string de conexão e o Container Name da sua conta de armazenamento do Azure criada na seção anterior:
3

Salvar bucket externo

Clique em Salvar bucket externo para salvar as configurações
4

Alterando o agendamento de backup padrão

Os backups externos passarão a ser feitos no seu bucket de acordo com o agendamento padrão. Como alternativa, você pode configurar o agendamento de backup na página Settings. Se ele for configurado de forma diferente, o agendamento personalizado e a configuração de retenção se aplicam aos backups gravados no seu bucket. Os backups no bucket gerenciado pelo ClickHouse Cloud usam o agendamento padrão (backups a cada 24 horas) e a política de retenção padrão.
5

Ver backups armazenados no seu bucket

A página Backups deve exibir esses backups no seu bucket em uma tabela separada, como mostrado abaixo:

​
Restaurando backups do Azure

Para restaurar backups do Azure, siga as etapas abaixo:
1

Crie um novo serviço para restaurar o backup

Crie um novo serviço para o qual o backup será restaurado. No momento, oferecemos suporte apenas à restauração de um backup em um novo serviço.
2

Obtenha o comando SQL usado para restaurar o backup

Clique no link acessar ou restaurar um backup acima da lista de backups na UI para obter o comando SQL de restauração do backup. O comando deve ser parecido com este, e você pode selecionar o backup apropriado na lista suspensa para obter o comando de restauração desse backup específico. Você precisará adicionar ao comando a string de conexão da sua conta de armazenamento do Azure.
Mover backups para outro localSe você mover os backups para outro local, precisará ajustar o comando de restauração para apontar para o novo local.
Comando ASYNCNo comando de restauração, você também pode adicionar opcionalmente ASYNC ao final para restaurações grandes. Isso permite que a restauração ocorra de forma assíncrona, de modo que, se a conexão for perdida, ela continue em execução. É importante observar que o comando ASYNC retorna imediatamente um status de sucesso. Isso não significa que a restauração foi bem-sucedida. Você precisará monitorar a tabela system.backups para verificar se a restauração foi concluída e se foi bem-sucedida ou falhou.
3

Execute o comando SQL para restaurar o backup

Execute o comando de restauração no console SQL do serviço recém-criado para restaurar o backup.
Última modificação em 28 de setembro de 2026