DataAgent では、カスタム Alibaba Cloud Object Storage Service (OSS) バケットを設定して、ローカルアップロード、セッション履歴、結果レポートを保存できます。これにより、データの保存、アクセス、保持を完全に制御できます。
ユースケース
-
データ分析ファイルの管理:アップロードしたファイル (CSV、Excel など) を指定した OSS バケットに保存し、追跡や再利用に活用します。
-
セッション履歴の永続化:セッションリプレイを保存し、過去の分析を確認したり、チームメンバーと共有したりします。
-
結果レポートのアーカイブ:DataAgent のアーティファクト (分析レポート、可視化など) を長期保存します。OSS のダウンロードリンクを通じて共有できます。
-
ワークスペース別のデータ分離:ワークスペースごとに個別の OSS バケットを割り当て、プロジェクトレベルでデータを分離します。
設定の優先順位
DataAgent は、次の優先順位で OSS 設定を適用します:
ワークスペース OSS 設定 > グローバル OSS 設定 > 組み込み OSS 設定
-
ワークスペースレベルの設定が最優先で適用されます。
-
ワークスペース設定が存在しない場合は、グローバル設定が適用されます。
-
グローバル設定が設定されていない場合は、組み込みのデフォルトストレージが使用されます。
前提条件
-
OSS 設定のトグルが、グローバルレベルまたはワークスペースレベルで有効になっていること。
-
保存するコンテンツタイプ (ローカルアップロード、セッション履歴、または結果レポート) を選択していること。
-
業務サービスと同じリージョンに、標準ストレージクラスの OSS バケットがあること。
-
必要な Resource Access Management (RAM) 権限を設定していること。
RAM 権限
OSS ストレージを設定するには、次の RAM 権限が必要です:
|
設定レベル |
必要な RAM 権限 |
|
グローバル OSS 設定 |
|
|
ワークスペース OSS 設定 |
|
AliyunDMSDataAgentFullAccess システムポリシーには、デフォルトで dms:UpsertDataAgentCustomUserConfig 権限が含まれます。dms:UpsertDataAgentGlobalCustomUserConfig 権限については、メインアカウントの所有者または管理者がカスタムポリシーを作成する必要があります。
カスタムロールの設定
DataAgent が OSS バケットにアクセスできるようにするには、カスタム RAM ロールを作成し、最小権限のポリシーを付与します。
ステップ 1:カスタムポリシーの作成
-
RAM Policy Console にログインします。
-
[ポリシーの作成] をクリックします。
-
[JSON エディター] モードを選択します。
-
以下の「最小 OSS バケット権限」セクションから、ストレージタイプに対応するポリシー例をコピーします。
-
ポリシー名に
CustomPolicyForAliyunDataAgentAccessOssを入力します。 -
[OK] をクリックしてポリシーを作成します。
ステップ 2:カスタムロールの作成
-
RAM Role Console にログインします。
-
[ロールの作成] をクリックし、信頼されたエンティティタイプとして [クラウドサービス] を選択します。
-
[プリンシパル名] ドロップダウンリストから [Data Management/DMSEnterprise] を選択し、[OK] をクリックします。
-
表示されたダイアログボックスで、ロール名に
CustomRoleForAliyunDataAgentAccessOssを入力し、[OK] をクリックします。説明CustomRoleForAliyunDataAgentAccessOssはロール名であり、前のステップで作成したポリシー名とは異なります。 -
ロール一覧に戻り、ロール名をクリックして、詳細ページで[権限を付与]をクリックします。
-
検索して、前のステップで作成した
CustomPolicyForAliyunDataAgentAccessOssポリシーを選択します。 -
[OK] をクリックして承認を確定します。
最小 OSS バケット権限
DataAgent は 3 種類のファイルを保存し、それぞれで必要となる OSS 権限が異なります。必要な権限のみを付与してください。
ローカルアップロード
グローバル設定とワークスペースレベル設定の両方でサポートされています。
|
RAM 権限 |
説明 |
|
oss:GetObject |
アップロードしたファイルのデータを読み取ります。 |
|
oss:PutObject |
ファイルをアップロードします。 |
|
oss:DeleteObject |
アップロードしたファイルを削除します (オプション)。 |
セッション履歴ファイル
グローバル設定とワークスペースレベル設定の両方でサポートされています。
|
RAM 権限 |
説明 |
|
oss:GetObject |
セッションリプレイ履歴を読み取ります。 |
|
oss:PutObject |
セッション履歴ファイルをアップロードします。 |
|
oss:ListObjects |
セッション履歴ファイルを一覧表示します。この権限では、リソースをバケットレベルで設定する必要があります。 |
結果レポートファイル
グローバル設定とワークスペースレベル設定の両方でサポートされています。
|
RAM 権限 |
説明 |
|
oss:GetObject |
結果アーティファクトを読み取ります。 |
|
oss:PutObject |
結果アーティファクトをアップロードします。 |
完全な設定例
次のポリシーは 3 つのストレージタイプすべてに対応しています。この例では、中国 (杭州) リージョンを使用します。
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"oss:ListObjects"
],
"Resource": "acs:oss:oss-cn-hangzhou:${your-aliyun-parent-uid}:${your-oss-bucket-name}"
},
{
"Effect": "Allow",
"Action": [
"oss:GetObject",
"oss:PutObject",
"oss:DeleteObject"
],
"Resource": "acs:oss:oss-cn-hangzhou:${your-aliyun-parent-uid}:${your-oss-bucket-name}/*"
}
]
}
-
${your-aliyun-parent-uid}を、Alibaba Cloud メインアカウントの UID に置き換えます。 -
${your-oss-bucket-name}を、OSS バケット名に置き換えます。 -
oss:ListObjects権限のリソースはバケットレベル (/*サフィックスなし) に設定する必要があります。一方、その他の権限のリソースはオブジェクトレベル (/*サフィックスあり) に設定する必要があります。
CORS の設定
DataAgent の Web インターフェイスで ファイルを直接アップロードしたり、セッション履歴をリプレイしたりする必要がある場合は、オリジン間リソース共有 (CORS) ルールを設定します。OSS コンソールで、バケットに次の許可されたオリジンを追加します:
http://*.console.aliyun.com
https://*.console.aliyun.com
http://*.dms.aliyun.com
https://*.dms.aliyun.com
http://*.dms.alibabacloud.com
https://*.dms.alibabacloud.com
DataAgent OpenAPI を独自の Web アプリケーションに統合する場合は、許可されたオリジンに独自ドメインも追加してください。