Exportar backups para sua própria conta de Cloud

O ClickHouse Cloud oferece suporte a fazer backups na sua própria conta do provedor de serviços de nuvem (CSP) (AWS S3, Google Cloud Storage ou Azure Blob Storage). Para saber mais sobre como funcionam os backups do ClickHouse Cloud, incluindo backups “completos” e “incrementais”, consulte a documentação de backups. Observe que backups na sua própria conta de Cloud se comportam de forma diferente dos backups do Cloud no local em um aspecto importante: eles não podem usar cópia nativa (veja a observação abaixo). Neste guia, mostramos exemplos de como fazer backups completos e backups incrementais na AWS, no GCP e no armazenamento de objetos do Azure, assim como restaurar a partir desses backups.

Qualquer uso em que backups sejam exportados para uma região diferente dentro do mesmo provedor de nuvem estará sujeito a cobranças de transferência de dados.Backups entre Clouds diferentes são compatíveis apenas por meio dos comandos de backup e restauração descritos nesta página, e não pela UI.

Impacto no desempenho em comparação com backups no local Backups para o seu próprio bucket não podem usar cópia nativa (do lado do servidor). A cópia nativa exige que a origem e o destino compartilhem as mesmas credenciais, o que não é o caso aqui: a origem é um bucket gerenciado pelo ClickHouse e o destino é o seu próprio bucket, autenticado com credenciais separadas.Como a cópia nativa não está disponível, os dados são baixados da origem e reenviados para o seu bucket (“copy-through-buffers”). Como resultado, exportar backups para o seu próprio bucket é mais lento e consome mais recursos do que os backups padrão do Cloud no local.

Requisitos

Antes de executar um comando BACKUP, certifique-se de que seu usuário do ClickHouse tenha o privilégio BACKUP. O default_role no ClickHouse Cloud não inclui esse privilégio. Entre em contato com o suporte do ClickHouse para solicitá-lo antes de exportar backups. Você precisará dos seguintes detalhes para exportar/restaurar backups no bucket de armazenamento do seu próprio CSP.

AWS

endpoint do S3 da AWS, no formato:

  s3://<bucket_name>.s3.amazonaws.com/<directory>

Por exemplo:

  s3://testchbackups.s3.amazonaws.com/backups/

Onde:

testchbackups é o nome do bucket do S3 para onde os backups serão exportados.
- backups é um subdiretório opcional.

Chave de acesso e chave secreta da AWS. A autenticação baseada em AWS Role também é compatível e pode ser usada no lugar da chave de acesso e da chave secreta da AWS.

Para usar a autenticação baseada em AWS Role, siga a configuração de acesso seguro ao S3. Além disso, você precisará adicionar as permissões s3:PutObject e s3:DeleteObject à política do IAM descrita aqui.

Azure

String de conexão da conta de armazenamento do Azure.
Nome do contêiner do Azure na conta de armazenamento.
Blob do Azure dentro do contêiner.

Google Cloud Storage (GCS)

endpoint do GCS, no formato:

https://storage.googleapis.com/<bucket_name>/

Chave de acesso HMAC e chave secreta HMAC.

Backup / Restauração

Backup / Restauração em bucket do S3 da AWS

Fazer backup do banco de dados

Backup completo

BACKUP DATABASE test_backups 
TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>')

Em que uuid é um identificador exclusivo, usado para diferenciar um conjunto de backups.

Você precisará usar um UUID diferente para cada novo backup neste subdiretório; caso contrário, receberá o erro BACKUP_ALREADY_EXISTS. Por exemplo, se estiver fazendo backups diários, precisará usar um novo UUID a cada dia.

Backup incremental

BACKUP DATABASE test_backups 
TO S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>') 
SETTINGS base_backup = S3('https://testchbackups.s3.amazonaws.com/backups/<base-backup-uuid>', '<key id>', '<key secret>')

Restaurar a partir de um backup

RESTORE DATABASE test_backups 
AS test_backups_restored 
FROM S3('https://testchbackups.s3.amazonaws.com/backups/<uuid>', '<key id>', '<key secret>')

Veja: Como configurar o BACKUP/RESTORE para usar um endpoint do S3 para mais detalhes.

Backup / Restauração no Azure Blob Storage

Fazer backup do banco de dados

Backup completo

BACKUP DATABASE test_backups 
TO AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>');

Onde uuid é um identificador exclusivo, usado para distinguir um conjunto de backups. Backup incremental

BACKUP DATABASE test_backups 
TO AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>/my_incremental') 
SETTINGS base_backup = AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>')

Restaurar a partir de um backup

RESTORE DATABASE test_backups 
AS test_backups_restored_azure 
FROM AzureBlobStorage('<AzureBlobStorage endpoint connection string>', '<container>', '<blob>/<uuid>')

Consulte: Configurando o BACKUP/RESTORE para usar um endpoint do AzureBlobStorage para mais detalhes.

Backup / restauração no Google Cloud Storage (GCS)

Fazer backup do banco de dados

Backup completo

BACKUP DATABASE test_backups 
TO S3('https://storage.googleapis.com/<bucket>/<uuid>', <hmac-key>', <hmac-secret>)

Em que uuid é um identificador único usado para diferenciar um conjunto de backups. Backup incremental

BACKUP DATABASE test_backups 
TO S3('https://storage.googleapis.com/test_gcs_backups/<uuid>/my_incremental', 'key', 'secret')
SETTINGS base_backup = S3('https://storage.googleapis.com/test_gcs_backups/<uuid>', 'key', 'secret')

Restaurar a partir de um backup

RESTORE DATABASE test_backups 
AS test_backups_restored_gcs 
FROM S3('https://storage.googleapis.com/test_gcs_backups/<uuid>', 'key', 'secret')

Get started

Services and infrastructure

Bring Your Own Cloud

Data and integrations

Connect and query

Access management

Security and compliance

Monitoring and backups

AI tools and agents

Cloud API

Billing

Support

ClickHouse Private

Exportar backups para sua própria conta de Cloud

Requisitos

AWS

Azure

Google Cloud Storage (GCS)

Backup / Restauração

Backup / Restauração em bucket do S3 da AWS

Fazer backup do banco de dados

Restaurar a partir de um backup

Backup / Restauração no Azure Blob Storage

Fazer backup do banco de dados

Restaurar a partir de um backup

Backup / restauração no Google Cloud Storage (GCS)

Fazer backup do banco de dados

Restaurar a partir de um backup

​Requisitos

​AWS

​Azure

​Google Cloud Storage (GCS)

​Backup / Restauração

​Backup / Restauração em bucket do S3 da AWS

​Fazer backup do banco de dados

​Restaurar a partir de um backup

​Backup / Restauração no Azure Blob Storage

​Fazer backup do banco de dados

​Restaurar a partir de um backup

​Backup / restauração no Google Cloud Storage (GCS)

​Fazer backup do banco de dados

​Restaurar a partir de um backup

Requisitos

AWS

Azure

Google Cloud Storage (GCS)

Backup / Restauração

Backup / Restauração em bucket do S3 da AWS

Fazer backup do banco de dados

Restaurar a partir de um backup

Backup / Restauração no Azure Blob Storage

Fazer backup do banco de dados

Restaurar a partir de um backup

Backup / restauração no Google Cloud Storage (GCS)

Fazer backup do banco de dados

Restaurar a partir de um backup