Amazon QuickSight の BI アセットに対するバックアップ戦略の実装方法

[Amazon Quick Sight](https://aws.amazon.com/quick/quicksight/) は、[Amazon Quick](https://aws.amazon.com/quicksuite/) の中核機能の一つです。Amazon Quick はエンドユーザーの生産性を最大化するために設計された、エージェント型で AI 駆動のデジタルワークスペースであり、信頼できるエンタープライズデータソースから自然言語クエリ、インタラクティブなダッシュボード、埋め込み分析を通じて、AI 駆動の BI（ビジネスインテリジェンス）[Business Intelligence] 機能を提供します。 この投稿で説明する AssetsAsBundle APIs を使用して、Amazon Quick Sight の資産であるダッシュボード、分析、データセット、およびデータソースをバックアップすることができます。バックアップ戦略は、誤った削除や意図しない変更、地域的な障害から保護するために役立ちます。Quick Sight が重要なビジネス意思決定の支援に不可欠なチームにとっては、よく設計されたバックアッププランが推奨されます。 この投稿は、Amazon Quick Sight の BI 資産に関するバックアップとリストアを扱う 2 部構成シリーズの第 1 弾です： - 第 1 部（本稿）：資産の選定、エクスポートに利用可能な APIs、およびすぐに使用できるサンプル自動化ツールの概要を含む、バックアップ戦略の設計と実装方法について解説します。 - 第 2 部：リストアプロセスについて解説します。第 1 部で作成したバックアップを使用して、誤った削除や意図しない変更後の資産復旧、あるいはより広範なディザスタリカバリ計画の一環として復元を行うことができます。 効果的なバックアップ戦略は、金融サービス、ヘルスケア、エネルギーなど規制の厳しい業界に属する組織にとって、以下の理由から特に重要です： - データ損失防止は、人的ミスや誤った削除、ランサムウェアなどの事象から保護します。 - 復旧目標の達成は、組織が復元ポイント目標（RPO）と復元時間目標（RTO）を達成し、インシデント発生時のデータ損失を最小限に抑えるのに役立ちます。 -監査およびレポート機能は、資産のライフサイクル全体（作成、更新、削除）における追跡と報告をサポートします。 - 負荷耐性の向上により、システムを以前の状態へ迅速に復元でき、ダウンタイムを削減し信頼性を高めます。これは AWS Well-Architected Framework の「信頼性」ピラーとも整合しています。 - 災害復旧（DR）の準備は、技術関連の災害を見据えた DR プロセスの実装の基盤となり、組織の事業継続計画（BCP）に貢献します。 Quick の災害復旧機能の詳細や、組織要件に対してどのように評価するかについては、[Amazon Quick 災害復旧および耐性ガイド](https://builder.aws.com/content/3ARv3heLpgnufWleBwpxLYmHWeu/amazon-quick-disaster-recovery-and-resiliency-guide) をご覧ください。 本記事では、Quick Sight の BI アセットに対して効果的なバックアップ戦略を実装するためのベストプラクティスについて解説します。まず、バックアップに含めるアセットを選択するオプションを説明し、次にその目的で利用可能な高レベル API について解説した上で、素早く着手できるようサンプルコードを紹介して締めくくります。 ## ビジネスインテリジェンスのバックアッププラクティス BI システムは、意思決定プロセスや主要なステークホルダーを支援する役割を果たすため、独自の事業継続上の課題を提示します。効果的なバックアップ計画を実装することで、サービス停止から保護する必要があります。この計画を構築する前に、DR（ディザスタリカバリ）計画の一部として考慮すべきアーキテクチャと次元を理解することが重要です。 ![image](https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2026/06/05/ML-20472-1.png) 上記の図は、Quick Sight がデータソース、データセット、分析、およびダッシュボードを含む Quick Sight アセットに対して [高可用性](https://docs.aws.amazon.com/quicksuite/latest/userguide/disaster-recovery-resiliency.html) を提供するために、複数の AWS リージョンにわたる AWS のグローバルインフラストラクチャに依存していることを示しています。 スーパーファスト・パラレル・インメモリ計算エンジン（SPICE）は、Quick Sight リージョン内の複数のアベイラビリティゾーン（AZ）間で冗長コピーを作成し、高可用性（HA）を確保しながら、インポートされたデータを保存および [暗号化](https://docs.aws.amazon.com/quicksuite/latest/userguide/data-encryption.html) します。 このリージョン設計により、複数のリージョンにリソースを維持し、主要な BI リソースに影響を与えるリージョン障害という稀な事態が発生した場合に、セカンダリリージョンを使用することができます。 ユーザーおよびアイデンティティ管理については、QuickSight は [初期アカウント購読プロセス](https://docs.aws.amazon.com/quicksuite/latest/userguide/signing-up.html) で定義する単一のリージョンを使用します。図に示されているように、このリージョンにはユーザーおよびグループのアイデンティティ情報がホストされており、ユーザーが QuickSight にアクセスするためにはこのリージョンが利用可能である必要があります。 例えば、ユーザーが eu-west-1 リージョンにあるダッシュボードにアクセスしたい場合でも、QuickSight のメインリージョンが us-east-1 である場合、両方のリージョンが利用可能でなければユーザーのアクセスフローは完了しません。QuickSight は冗長性を確保するために AZ（Availability Zone）を備えた地域アーキテクチャを採用しています。ただし、稀なリージョン全体の障害に対する保護が必要な場合は、その要件に応じて災害復旧（DR: Disaster Recovery）戦略を設計する必要があります。 **ヒント:** QuickSight のメインリージョンが不明な場合、以下のコマンドを実行して情報を取得できます: aws quicksight describe-account-settings --aws-account-id XXXXXXXXXXXX --region us-east-1 **注意:** この `aws quicksight describe-account-settings` コマンドでは、エンドポイントリージョンとして us-east-1 が指定されています。200 ステータスが返された場合、アイデンティティリージョンは us-east-1 です。それ以外の場合は、以下のエラーメッセージが返され、現在のアイデンティティリージョン（例：eu-west-1）を指すように指示されます: DescribeAccountSettings オペレーション呼び出し時にエラー (AccessDeniedException) が発生しました：エンドポイント us-east-1 から呼び出されていますが、アイデンティティのリージョンは us-east-1 です。eu-west-1 エンドポイントを使用してください。 ## バックアップ計画に含める Quick Sight アセットの定義 Quick Sight のアーキテクチャについてより明確な理解を得た上で、次のステップとしてバックアップ計画に含めるアセットを選択する必要があります。これには 2 つの戦略に従うことができます： ## 特定のアセットをバックアップする： このオプションは、事業運営において重要なアセットを保護することに焦点を当てた [バックアップまたは DR (ディザスタリカバリ) 戦略](https://docs.aws.amazon.com/prescriptive-guidance/latest/security-best-practices/strategy.html) を定義する場合に適しています。これにより、災害や誤った削除後に容易に復元できるアセットを対象とします。具体的には、主要なステークホルダーが意思決定を行うために使用する特定のダッシュボード（およびその依存アセット）や、財務、物流、調達などの運用チームが事業継続を支援するために使用するアセットが含まれます。 このオプションは、シンプルで分かりやすいバックアップ計画が必要であり、事業継続に不可欠な BI アセットが Quick Sight インスタンス内に存在するすべてのアセットの一部である場合に推奨されます。 ## すべての資産をバックアップする: この戦略は、バージョン管理と潜在的な災害復旧の両方をカバーするバックアップ戦略を定義したい場合に推奨されます。すべての資産をバックアップすることで、人的ミスによる意図しない変更や削除が発生した場合でも、任意の資産を元の状態にその場でロールバックできます。さらに、アカウント内のすべての資産のバックアップを持っているため、DR プランの一部として特定の資産を選択して復元することも可能です。 このアプローチは最大限のカバレッジを提供しますが、より複雑なオーケストレーションと自動化を必要とします。本稿ではこの戦略に焦点を当て、生産環境への導入時間を最小化するために適応可能なサンプルコードを提供します。 戦略を選択した後、エクスポートする BI アセットの種類を選択してください。Quick Sight は以下のアセットタイプを提供しています: - ダッシュボード：リーダーユーザーを対象とした読み取り専用アセットで、分析から公開されます。また、ダッシュボードを分析に保存して編集を行うこともできます。 - 分析とダッシュボード：分析はダッシュボードの編集可能なバージョンです。アクセスできるのはあなたが指定した著者だけです。 - データソース：データソースは、データベースやデータウェアハウスなどの分析ソース、Amazon Simple Storage Service (Amazon S3) などの AWS サービス、Jira や ServiceNow などのサードパーティ製ソフトウェア・アズ・ア・サービス (SaaS) データプロバイダーから来るデータへの接続を実装します。 - データセット：外部データにアクセスするためにデータソースを利用するアセットタイプで、分析やダッシュボードを駆動するためのデータを準備し構造化するために使用できます。 - VPC 接続：VPC リソース（データベースやデータウェアハウスなど）と統合するために使用する機能で、これらはその VPC に存在するか、そこから到達可能（ピアリングされた VPC や、VPN または AWS Direct Connect を介して接続されたネットワーク）です。 - テーマ：複数の分析およびダッシュボードに適用できるスタイルと外観設定のコレクションで、製品または企業のブランディング要件を満たす美的基準に合わせて使用できます。 これらすべてのアセットはお互いに依存関係を持っており、分析とダッシュボードがこの依存チェーンの最上位にあります。これは以下の図が示しています。 ![image](https://d2908q01vomqb2.cloudfront.net/f1f836cb4ea6efb2a0b1b99f41ad8b103eff4b59/2026/06/05/ML-20472-2.png) バックアップするアセットタイプを選択する際は、これらの依存関係を認識し、バックアップからアセットを完全に復元できるようにしてください。例えば、ダッシュボードをバックアップする場合、その依存関係（データセット、データソース、VPC 接続、テーマなど）も同時にバックアップする必要があります。次のセクションでは、QuickSight のエクスポート API がこれらの依存関係をどのように処理するかについて説明します。 ## バックアッププロセスの概要 本記事で取り上げるメカニズムは、QuickSight で利用可能な [AssetsAsBundle APIs](https://docs.aws.amazon.com/quicksight/latest/developerguide/asset-bundle-ops.html) を使用しています。AssetsAsBundle APIs（AAB APIs としても参照されます）は、QuickSight リソースのプログラムによるエクスポートとインポートをサポートするために設計された一連の高レベル API です。これらは、リリース管理、バックアップおよび復元、アカウント間移行、[継続的インテグレーションおよび継続的デリバリー (CI/CD) ワークフロー](https://aws.amazon.com/solutions/guidance/multi-account-environments-on-amazon-quicksight/) など、幅広いユースケースをカバーしています。 この API セットには、以下の操作が含まれます： - StartAssetBundleExportJob: この操作の一部としてエクスポートされたアセットを含むパッケージ（バンドル）を作成します。このパッケージはテキストファイルを含む ZIP ファイルであり、その形式は ExportFormat パラメータで指定された値に応じて、JSON または AWS CloudFormation のいずれかになります。フォーマットに応じて、これらのアセットを AAB API を直接使用してインポートするか、またはプロビジョニングにクラウドフォーメーションのインフラストラクチャ・アズ・コード（IaC）を利用できます。非同期操作が完了した後、システムはバンドルを一時的な S3 ロケーションにアップロードし、ダウンロード可能になります。 - StartAssetBundleImportJob: 以前にエクスポートされたバンドルを取得し、その中にパッキングされたアセットを復元します。インポート操作を使用することで、アセット名やデータソース接続パラメータ（ホスト、ポート、ワークグループなど）といった広範なパラメータに対するオーバーライドを定義できます。 - DescribeAssetBundleImportJob および DescribeAssetBundleExportJob: 両方の AssetBundle オペレーションは非同期です。これらの API を使用して操作の内容を確認し、ステータスをポーリングし、完了後にアクションを実行できます。エクスポートジョブを実行する際、DescribeAssetBundleExportJob を使用してバンドルの DownloadUrl を取得できますが、この URL は 5 分間のみ有効です。さらに DescribeAssetBundleExportJob を呼び出すことで、URL の更新が可能です。 ## AssetsAsBundle API のサポート対象アセットと現在の制限事項 AssetsAsBundle API は、分析、ダッシュボード、データソース、データセット、共有フォルダー、制限付きフォルダー、更新スケジュール、テーマ、VPC 接続を含む Quick Sight アセットのリストをサポートしています。ただし、一部のアーセットタイプには制限があります。 **サポート対象外のデータソース:** Adobe Analytics、ファイル、GitHub、Jira、Salesforce、ServiceNow、Amazon S3（ローカルアップロードされた [マニフェストファイル](https://docs.aws.amazon.com/quicksight/latest/user/supported-manifest-file-format.html) を使用する場合）、および Twitter。 **サポート対象外のデータセット:** 接続された SageMaker ML モデル [1] を介した推論を使用して生成された機械学習 (ML: Machine Learning) カラムを含むデータセット。 これらのアセットをバックアッププランから除外する必要があります。これにより、StartAssetBundleExportJob オペレーションを実行する際に InvalidParameterValueException エラーが発生することを回避できます。 この問題を回避するには、以下の手順に従ってサポート対象外のデータソースおよびデータセットを置き換えることができます。 **ローカルマニフェストファイルを使用する Amazon S3 データソースの場合:** - 新しい Amazon S3 データソースを作成します。 - マニフェストファイルを Amazon S3 にアップロードします。 - データソースからマニフェストファイルを参照します。 - UpdateDataSet API を使用して、依存関係にあるデータセット内のデータソースを置き換えます。 **その他のサポート対象外のデータソースおよびデータセットの場合:** 互換性のないデータセットを互換性のあるものに変換するには、以下の手順に従ってください。 - バックアップ対象とするデータソースに接続された分析を作成します。 - データセットの全列を表示するテーブルビジュアルを作成します。 - データを CSV ファイルとしてエクスポートします。 - Amazon S3 にアップロードしたマニフェストを使用して、Amazon S3 データセットを作成します。 - 置換データセット機能を使用して、新しいデータセットで分析およびダッシュボードを更新します。 ## バックアップの一部として考慮すべきその他の資産 Quick Sight リソースはバックアップの主要な資産ですが、復元や災害復旧の潜在的な状況に備え、バックアップ計画にはいくつかの追加リソースと設定を含める必要があります。 ユーザーおよびアクセス権を持つグループを含む、Quick Sight アセットとその権限をエクスポートできます。これは [IncludePermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_StartAssetBundleExportJob.html#API_StartAssetBundleExportJob_RequestSyntax) フラグを true に設定することで制御します。 各 Quick Sight アセットはユーザーによって所有されているため、完全かつ復元可能なバックアップを実現するには、ユーザーとグループもバックアップする必要があります。 AssetsAsBundle API はユーザーとグループをカバーしていませんが、[DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)、[DescribeGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeGroup.html)、および [DescribeGroupMembership](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeGroupMembership.html) を使用することで、この情報をバックアップに含めることができます。 ユーザーとグループに加えて、アカウントのカスタマイズ（[DescribeAccountCustomization](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeAccountCustomization.html) API）、カスタムブランド（[DescribeBrand](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeBrand.html) API）、およびフォルダ（[ListFolders](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListFolders.html)）などのアカウント設定もバックアップを検討してください。

Amazon QuickSight の BI アセットに対するバックアップ戦略の実装方法

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト