Amazon QuickSightのアセットのインポート・エクスポートジョブで別アカウントにダッシュボードを共有してみた

インポート・エクスポートジョブで、アカウント間のアセットの共有を試してみました。テンプレートを配布したい場合などに便利そうです。

#AWS

#Amazon QuickSight

nayu.t.s

2023.07.04

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

データアナリティクス事業本部の鈴木です。

Amazon QuickSight でアセットのインポート・エクスポートジョブを実行がサポートされました。エクスポートしたアセットをアカウント間で共有したかったので試してみました。

この機能については以下のブログ記事でいち早く検証して頂いていました。

やりたいこと

以下のように、アカウントAにあるダッシュボードをアカウントBに移し替えたいです。

エクスポート・インポートの全体像

この記事ではダッシュボードと依存するアセットをエクスポートおよびインポートしました。ダッシュボードはS3からSPICEに読み込んだデータを表示するものとしました。

全体的な流れは以下のAWS Big Data Blogで説明されています。特に、とても分かりやすいシーケンス図が掲載されているので、一度確認頂いて流れを理解することをお勧めします。

前提の説明

データについて

今回は下記リンクにて公開されている、UCI Machine Learning RepositoryのIris Data Setを使用しました。

https://archive.ics.uci.edu/ml/datasets/iris

データをダウンロードし、iris.dataをS3バケットにアップロードしておきました。

マニフェストファイルは、例えば以下のように作成し、別途バケットにアップロードしておきました。

{
    "fileLocations": [
        {
            "URIs": [
                "s3://データ用バケット名/iris/iris-dataset.csv"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}

データ用バケット名は自身のものに置き換えてください。

ダッシュボードについて

このように、品種ごとに、花びらの長さが同じ個体の数を棒グラフで表してみました。

ダッシュボードのサンプル

データセットは、エクスポート元のアカウントにて、QuickSightのコンソールから新しいS3データセットを作成しました。

新しいデータセットを作成

新しい分析を作成してこのデータセットに接続し、棒グラフを作成した後、ダッシュボードとして共有することで、ダッシュボードのアセットを作成しました。

やってみた

1. アセットバンドルのエクスポート

まず、start-asset-bundle-export-jobでエクスポートを開始します。

エクスポートの開始

エクスポート対象のAWSアカウントID・ダッシュボードのARN・エクスポート対象のAWSアカウント用のプロファイル名は環境に応じたものに差し替えて下さい。

aws quicksight start-asset-bundle-export-job --aws-account-id エクスポート対象のAWSアカウントID  --asset-bundle-export-job-id iris-dashboard-export-job --resource-arns ダッシュボードのARN --include-all-dependencies --export-format QUICKSIGHT_JSON --profile エクスポート対象のAWSアカウント用のプロファイル名

--asset-bundle-export-job-idでエクスポートジョブ名を指定しますが、これは次に使います。

アセットバンドルのダウンロード

続いて、describe-asset-bundle-export-jobでジョブのステータスを確認します。ジョブがSUCCESSFULであれば、レスポンスのDownloadUrlにアセットの情報が記載したS3の署名付きURLが記載されています。

aws quicksight describe-asset-bundle-export-job --aws-account-id エクスポート対象のAWSアカウントID --asset-bundle-export-job-id iris-dashboard-export-job --profile エクスポート対象のAWSアカウント用のプロファイル名

S3の署名付きURLをブラウザで開くなどしてアセットバンドルをダウンロードしました。今回の名前の付け方だと、assetbundle-iris-dashboard-export-job.qsというファイルがダウンロードできました。

2. アセットバンドルのインポート

続いて、インポート対象のアカウントにassetbundle-iris-dashboard-export-job.qsをインポートしてみました。

アセットバンドルのアップロード

まず、assetbundle-iris-dashboard-export-job.qsをアセット用のS3バケットにアップロードしました。このバケットには、インポート対象のアカウントのQuickSightで、アクセス許可をしておきました。

アセット用のバケット

マニフェストファイルのアップロード

データソース用にマニフェストファイルもアップロードしました。今回は上の画像に写っている場所に上げておきました。

マニフェストファイルの指定は次で行いました。

インポートジョブの実行

start-asset-bundle-import-jobを以下のように実行しました。

aws quicksight start-asset-bundle-import-job --aws-account-id インポート対象のAWSアカウントID --asset-bundle-import-job-id iris-import-job --asset-bundle-import-source "{\"S3Uri\": \"s3://アセット用のバケット名/iris/assetbundle-iris-dashboard-export-job.qs\"}" --override-parameters '{"DataSources": [{"DataSourceId": "データソースのID", "DataSourceParameters":{ "S3Parameters": {"ManifestFileLocation": {"Bucket": "アセット用のバケット", "Key": "iris/manifest.json"}}}}]}' --region ap-northeast-1 --profile インポート対象のAWSアカウント用のプロファイル名

--asset-bundle-import-sourceでアップロードしたassetbundle-iris-dashboard-export-job.qsファイルの場所を指定しました。

--override-parametersは、例えばS3のデータソースのマニフェストファイルのあるS3バケット名のような、インポート/エクスポートで差し替えないといけないパラメータを上書きするための設定でした。今回はS3をデータソースとしたデータセットをエクスポートしているので、マニフェストファイルの場所は差し替える必要があったため、この設定で指定しました。

進行状況および結果は、describe-asset-bundle-import-jobで確認が可能でした。エラーが発生したような場合はここから確認できました。JobStatusがSUCCESSFULであることを確認するとよいでしょう。

aws quicksight describe-asset-bundle-import-job --aws-account-id インポート対象のAWSアカウントID --asset-bundle-import-job-id iris-import-job --region ap-northeast-1 --profile インポート対象のAWSアカウント用のプロファイル名