Estratégia de backup para ativos de BI no Amazon Quick Sight: guia prático com APIs AssetsAsBundle

O Amazon Quick Sight, serviço de BI com inteligência artificial integrado ao Amazon Quick, agora oferece um conjunto de APIs de alto nível — as AssetsAsBundle APIs — que permitem exportar e importar dashboards, análises, datasets, fontes de dados e outros ativos de forma programática. Este artigo, primeiro de uma série de duas partes, apresenta as melhores práticas para implementar uma estratégia de backup eficaz, protegendo contra exclusões acidentais, modificações não intencionais e interrupções regionais.

Por que fazer backup de ativos de BI?

Sistemas de BI são críticos para a tomada de decisão. Uma estratégia de backup robusta é essencial para organizações em setores regulados como finanças, saúde e energia, por várias razões:

• Prevenção contra perda de dados: protege contra erros humanos, exclusões acidentais e ransomware.
• Atendimento a RPO e RTO: minimiza a perda de dados e o tempo de recuperação em incidentes.
• Auditoria e relatórios: permite rastrear o ciclo de vida dos ativos (criação, atualização, exclusão).
• Resiliência da carga de trabalho: restauração rápida de sistemas, reduzindo downtime.
• Preparação para disaster recovery (DR): base para planos de continuidade de negócios.

O Quick Sight utiliza a infraestrutura global da AWS em múltiplas regiões. O mecanismo SPICE armazena dados importados com alta disponibilidade através de cópias redundantes em várias zonas de disponibilidade. Para proteção contra falhas regionais, é necessário projetar uma estratégia de DR que inclua backup entre regiões.

Selecionando os ativos para backup

Duas abordagens principais:

• Backup de ativos específicos: ideal quando apenas um subconjunto de ativos é crítico para as operações de negócio. Foco em dashboards e dependências essenciais.
• Backup de todos os ativos: recomendado para versionamento e DR completo. Permite rollback de qualquer ativo a um estado anterior. Mais complexo, mas com cobertura máxima.

Os tipos de ativos disponíveis para exportação incluem: dashboards, análises, fontes de dados, datasets, conexões VPC, temas e pastas. É importante considerar as dependências entre eles: um dashboard depende de datasets, fontes de dados, conexões VPC e temas. As APIs AssetsAsBundle tratam essas dependências automaticamente quando você exporta um ativo.

AssetsAsBundle APIs: o que são e como funcionam

As AssetsAsBundle APIs (AAB) são um conjunto de operações de alto nível para exportar e importar recursos do Quick Sight de forma programática. Elas suportam casos de uso como release management, backup e restore, migração entre contas e pipelines CI/CD.

As principais operações são:

• StartAssetBundleExportJob: cria um pacote (bundle) em formato ZIP contendo os ativos exportados. O formato pode ser JSON ou CloudFormation. O bundle é enviado para um local temporário no S3.
• StartAssetBundleImportJob: restaura os ativos a partir de um bundle exportado anteriormente. Permite sobrescrever parâmetros como nomes de ativos e configurações de conexão.
• DescribeAssetBundleExportJob e DescribeAssetBundleImportJob: operações assíncronas para verificar o status e obter a URL de download (válida por 5 minutos).

Para mais detalhes, consulte a documentação oficial das AssetsAsBundle APIs.

Limitações e ativos não suportados

Alguns tipos de fontes de dados não são suportados pelas AAB APIs: Adobe Analytics, File, GitHub, Jira, Salesforce, ServiceNow, Amazon S3 com manifest local e Twitter. Datasets que contêm colunas geradas por ML via SageMaker também não são suportados. Para contornar:

• Para fontes S3 com manifest local: crie uma nova fonte de dados S3, faça upload do manifest para o S3 e referencie-o. Atualize o dataset com UpdateDataSet.
• Para outros casos: exporte os dados como CSV, crie um dataset S3 com manifest no S3 e substitua o dataset nos dashboards usando a funcionalidade de substituição de dataset.

Outros ativos a considerar no backup

Além dos ativos do Quick Sight, inclua no backup:

• Usuários e grupos: as AAB APIs não cobrem usuários e grupos. Use as APIs DescribeUser, DescribeGroup e DescribeGroupMembership para capturar essas informações.
• Configurações da conta: como personalização da conta (DescribeAccountCustomization), marcas personalizadas (DescribeBrand) e pastas (ListFolders, DescribeFolder, DescribeFolderPermissions).

Implementação técnica: automação com sample code

A AWS fornece um sample code que automatiza o backup de usuários/grupos e ativos. A ferramenta suporta três modos: apenas usuários, apenas ativos, ou ambos. O fluxo é o seguinte:

1. Backup de usuários e grupos: os dados são armazenados em tabelas DynamoDB com sufixo de data (ex: quicksight-users-backup-2025-10-19), permitindo recuperação pontual. As tabelas armazenam nome, ARN, email, papel, associações grupo-usuário, etc.
2. Backup de ativos: a ferramenta coordena a exportação usando StartAssetBundleExportJob e salva o bundle no S3. Por padrão, inclui todas as dependências.

Para executar, você precisará configurar permissões IAM adequadas e definir as regiões (identidade e armazenamento podem ser diferentes). O sample code implementa exponential backoff para lidar com limites de taxa.

Este artigo é a primeira parte de uma série. A segunda parte abordará o processo de restauração, incluindo como usar os backups para recuperar ativos após exclusão acidental ou como parte de um plano de DR. Enquanto isso, você pode começar a implementar sua estratégia de backup usando o sample code disponível no post original.

Links úteis

• Documentação das AssetsAsBundle APIs
• Amazon EventBridge
• Implementação de exponential backoff
• Sobrescrita de parâmetros de importação
• DescribeAccountCustomization
• DescribeAssetBundleExportJob
• DescribeAssetBundleImportJob