alibabacloud-pai-feature-store-featuredb-usage-query

PAI-FeatureStore FeatureDB の使用状況に関するクエリと分析

アーキテクチャ：PAI-FeatureStore インスタンス → FeatureDB データソース → フィーチャービュー → 使用統計

主な機能

1. 使用状況の合計分析：日付範囲（最大30日）における読み取り／書き込みの合計を日別にクエリします
2. フィーチャービューの詳細：指定した日付の特定のフィーチャービューの使用状況をクエリし、読み取り／書き込み数で並べ替えます
3. プロジェクトレベルの分析：特定のプロジェクトの読み取り／書き込み合計を日別にクエリします（最大30日）
4. フィーチャービューの傾向：特定のフィーチャービューの読み取り／書き込みの傾向を日別にクエリします（最大30日）
5. コスト計算：地域ごとの公式料金プランに基づいてコストを計算します

対応リージョン

cn-beijing、cn-hangzhou、cn-shanghai、cn-shenzhen、cn-hongkong、ap-southeast-1、ap-southeast-5、us-west-1、eu-central-1

---

インストール

事前確認：Aliyun CLI >= 3.3.3 が必要です

aliyun version を実行して、バージョンが 3.3.3 以上であることを確認してください。インストールされていない場合やバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行して更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。

次に、自動プラグインインストールを有効にするため、[必須] aliyun configure set --auto-plugin-install true を実行してください。 ローカルマシン上の既存のプラグインを常に最新の状態に保つため、[必須] aliyun plugin update を実行してください。

[必須] CLI User-Agent — aliyun CLI コマンドを実行する際は、毎回次を指定する必要があります： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

自動プラグインインストールが有効になっている場合、PAI-FeatureStore CLI プラグインは初回使用時に自動でインストールされます。

タイムアウト：すべての API 呼び出しでデフォルトの 10 秒で十分です。

---

認証

事前確認：Alibaba Cloud の認証情報が必要です

セキュリティルール：

• 絶対に AK/SK の値を読み取ったり、エコーしたり、出力したりしないでください（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止です）
• 絶対に会話やコマンドラインで AK/SK を直接入力するようユーザーに求めないでください
• 絶対に文字列の認証情報を指定して aliyun configure set を使用しないでください
• 絶対にキーに見える文字列を出力しないでください（例：LTAI5t***、AccessKeyId: xxx、ak-***）
• 認証情報の状態確認には aliyun configure list のみを使用してください

aliyun configure list

有効なプロファイル（AK、STS、または OAuth ID）があるか、出力を確認してください。

有効なプロファイルがない場合は、ここで中止してください。

---

必須パラメーター

重要：パラメーターの確認 — コマンドまたは API 呼び出しを実行する前に、ユーザーが変更可能なすべてのパラメーター（例：RegionId、インスタンス名、CIDR ブロック、パスワード、ドメイン名、リソース仕様など）をユーザーに確認する必要があります。明示的な承認なしに値を推測したり、デフォルト値を使用したりしないでください。

パラメーター名	必須／任意	説明	デフォルト値
RegionId	必須	Alibaba Cloud のリージョン ID。上記の対応リージョンのいずれかを指定してください。	なし
WorkspaceId	任意*	PAI ワークスペース ID（数値、例：12345）。DatasourceId が指定されていない場合は必須です。	なし
DatasourceId	任意*	FeatureDB データソース ID（数値、例：67890）。WorkspaceId が指定されていない場合は必須です。	なし
StartDate	任意	yyyy-MM-dd 形式のクエリ開始日。	30日前（使用状況の合計の場合）、または7日前（プロジェクト／フィーチャービューの場合）
EndDate	任意	yyyy-MM-dd 形式のクエリ終了日。	昨日
ProjectName	任意	プロジェクト名（プロジェクトレベルおよびフィーチャービューのクエリで必須）。	なし
FeatureViewName	任意	フィーチャービュー名（フィーチャービューの傾向をクエリする場合に必須）。	なし
SortBy	任意	並べ替えフィールド：ReadCount または WriteCount	ReadCount
Order	任意	並べ替え順：ASC または DESC	DESC

注：WorkspaceId または DatasourceId のいずれかを指定する必要があります。どちらも指定されていない場合、スキルは利用可能なすべての FeatureDB データソースを一覧表示し、ユーザーに選択を求めます。

---

RAM の権限

このスキルには、以下の RAM 権限が必要です。詳細なポリシー設定については、references/ram-policies.md を参照してください。

必須アクション：

• paifeaturestore:ListInstances
• paifeaturestore:GetDatasource
• paifeaturestore:ListDatasources
• paifeaturestore:ListDatasourceFeatureViews

---

コアワークフロー

機能の対象範囲（最初に必ず確認）

このスキルは、FeatureDB の読み取り／書き込み使用状況の統計情報の照会のみをサポートします。「過去の読み取り／書き込み回数またはコストの照会」以外のリクエストは対象外のため、サポート対象の機能を列挙して丁寧にお断りしてください。

[MUST] リクエストが対象外の場合は、丁寧にお断りし、サポート対象の機能を列挙してください。

「申し訳ありません。このスキルは FeatureDB の読み取り／書き込み使用状況の統計情報の照会のみをサポートしており、[user request]には対応していません。サポート対象の機能：1）日別の読み取り／書き込み合計 2）フィーチャービューの詳細 3）使用状況の傾向 4）コスト計算」

機能の選択ロジック

実行する機能は、ユーザーのリクエストに応じて決まります。

シナリオ	アクション
リクエストが対象外または未サポート	お断りし、サポート対象の機能を列挙する（上記を参照）
ユーザーがサポート対象の機能を指定している	指定された機能を実行する
ユーザーが機能を指定していない	デフォルトの動作を実行する（以下を参照）

サポート対象の機能

1. 分析を含め、StartDate から EndDate までの FeatureDB の日別読み取り／書き込み合計を照会する（期間は最大 30 日）
2. 指定日のフィーチャービューごとの読み取り／書き込み回数を、並べ替えと分析を含めて照会する
3. 分析を含め、特定のプロジェクトについて StartDate から EndDate までの FeatureDB の日別読み取り／書き込み合計を照会する（期間は最大 30 日）
4. 分析を含め、特定のフィーチャービューについて StartDate から EndDate までの FeatureDB の日別読み取り／書き込みの傾向を照会する（期間は最大 30 日）
5. 公式料金と照会結果に基づいてコストを計算する

ユーザー向けのプロンプト

プロンプトでは機能番号ではなく、説明的な名称を使用してください。「機能 3」では、このドキュメントを読んでいないユーザーには意味が伝わりません。

実行手順

ステップ 1：PAI-FeatureStore インスタンスの確認

aliyun paifeaturestore list-instances \
  --region <RegionId> \
  --status Running \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

想定される出力：実行中のインスタンスとその InstanceId の一覧です。

エラー処理（実行中のインスタンスが見つからない場合は、停止し、InstanceId を推測しないでください）：

このリージョンに実行中の PAI-FeatureStore インスタンスが見つかりません。以下をご確認ください。

1. RegionId は正しいですか？
2. 別のリージョンに切り替える必要がありますか？
3. PAI-FeatureStore を有効化するには、コンソールにアクセスしてください。

ステップ 2：FeatureDB データソースの特定

ケース A：ユーザーが WorkspaceId を指定している

aliyun paifeaturestore list-datasources \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --type FeatureDB \
  --workspace-id <WorkspaceId> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

ケース B：ユーザーが DatasourceId を指定している

[MUST] ユーザーが DatasourceId を指定した場合は、GetDatasource または ListDatasources を必ず呼び出し、データソースの種類が FeatureDB であることを確認してください。この検証手順を省略しないでください。

aliyun paifeaturestore get-datasource \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

検証：応答の Type フィールドを確認します。Type が FeatureDB でない場合は処理を停止し、このデータソースは FeatureDB データソースではないことをユーザーに伝えてください。

ケース C：WorkspaceId も DatasourceId も指定されていない

aliyun paifeaturestore list-datasources \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --type FeatureDB \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

注：この API はページネーションを使用します。TotalCount と PageSize から合計ページ数を計算し、すべてのページを取得してください。

ページネーションのロジック例：

# First call to get TotalCount
FIRST_RESPONSE=$(aliyun paifeaturestore list-datasources \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --type FeatureDB \
  --page-number 1 \
  --page-size 10 \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query)

# Extract TotalCount and calculate total pages
# Then iterate through all pages
for page in {1..total_pages}; do
  aliyun paifeaturestore list-datasources \
    --region <RegionId> \
    --instance-id <InstanceId> \
    --type FeatureDB \
    --page-number $page \
    --page-size 10 \
    --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query
done

すべての FeatureDB データソースをユーザーに提示してください。データソースが 1 つだけの場合は、そのデータソースをそのまま使用してください。

データソースが複数ある場合の動作は、クエリの種類によって異なります。

クエリの種類	ユーザー確認の要否
使用状況の合計（機能 1）	「N 個すべてのデータソースの使用状況を集計しますか、それとも特定のデータソースを選択しますか？」と尋ね、ユーザーの選択に応じて進めてください。
フィーチャービューの詳細／プロジェクト／傾向（機能 2／3／4）	1 つのデータソースを選択する必要があります。これらのクエリはデータソースごとに実行され、複数のデータソースを対象にすることはできません。

エラー処理：

• WorkspaceId または DatasourceId が無効な場合は、ケース C に切り替え、利用可能なデータソースをすべて列挙してください。

ステップ 3：使用統計のクエリ

日付の検証（API 呼び出し前）：

• 形式：yyyy-MM-dd である必要があります（例：2024-03-15）。ユーザーが別の形式（例：3/15、2024.03.15）を指定した場合は、正しい形式に変換してください。
• 範囲：EndDate - StartDate は 30 日以下である必要があります。超過する場合は、範囲を狭めるか、複数のクエリに分割するようユーザーに依頼してください。
• 境界：EndDate ≤ 今日、StartDate ≤ EndDate である必要があります。

相対日付範囲（「過去 7 日間」、「過去 30 日間」）：StartDate = N 日前、EndDate = 昨日として計算します。最初に date コマンドを別途実行し、その結果の値をそのまま --start-date／--end-date に指定してください。CLI コマンドに 決して $(...) を埋め込まないでください。

ユーザーの要件に基づいてクエリを実行します。

機能 1：日ごとの読み取り／書き込み使用量の合計をクエリする

StartDate から EndDate までの日ごとの合計をクエリします（デフォルト：過去 30 日間）。

aliyun paifeaturestore list-datasource-feature-views \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --start-date <StartDate> \
  --end-date <EndDate> \
  --verbose false \
  --show-storage-usage false \
  --page-size 1 \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

出力：応答から TotalUsageStatistics を抽出します。

機能 2：特定の日付の機能ビューごとの使用量をクエリする

特定の日付におけるすべての機能ビューの読み取り／書き込み回数を、並べ替えてクエリします。

aliyun paifeaturestore list-datasource-feature-views \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --start-date <TargetDate> \
  --end-date <TargetDate> \
  --verbose true \
  --show-storage-usage false \
  --all true \
  --sort-by <ReadCount|WriteCount> \
  --order <ASC|DESC> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

出力：応答から FeatureViews 配列を抽出します。

機能 3：特定のプロジェクトの日ごとの使用量をクエリする

StartDate から EndDate までの特定のプロジェクトの日ごとの合計をクエリします（デフォルト：過去 7 日間）。

aliyun paifeaturestore list-datasource-feature-views \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --start-date <StartDate> \
  --end-date <EndDate> \
  --verbose false \
  --show-storage-usage false \
  --page-size 1 \
  --project-name <ProjectName> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

出力：応答から TotalUsageStatistics を抽出します。

エラー処理：

• API がプロジェクトが存在しないことを示すエラーを返した場合は、クエリ可能なプロジェクトの完全な一覧を取得するため、まず機能 2 をクエリするよう提案してください（プロジェクト名で重複を除外します）。

機能 4：特定の機能ビューの日ごとの使用量をクエリする

StartDate から EndDate までの特定の機能ビューの日ごとの傾向をクエリします（デフォルト：過去 7 日間）。

aliyun paifeaturestore list-datasource-feature-views \
  --region <RegionId> \
  --instance-id <InstanceId> \
  --datasource-id <DatasourceId> \
  --start-date <StartDate> \
  --end-date <EndDate> \
  --verbose true \
  --show-storage-usage false \
  --all true \
  --project-name <ProjectName> \
  --name <FeatureViewName> \
  --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-feature-store-featuredb-usage-query

出力：FeatureViews 配列から該当する機能ビューを抽出します。

エラー処理：

• 応答に一致する機能ビューが見つからない場合、その機能ビューは存在しません。クエリ可能な機能ビューの完全な一覧を取得するため、まず機能 2 をクエリするよう提案してください。

ステップ 4：結果の分析とコストの計算

ユーザーの要件に基づいて、次の操作を行います。

1. クエリ結果から使用傾向を分析します。
2. コストを計算します。 公式料金（10,000 リクエストあたり）：

地域	書き込みコスト	読み取りコスト
北京、上海、杭州、深圳	¥0.151	¥0.0755
香港、シンガポール、シリコンバレー、フランクフルト、ジャカルタ	¥0.2651	¥0.1326

3. 分析結果を提示します：

   • トラフィックの多い機能ビューを特定する
   • 使用パターン（急増、傾向）を強調する
   • 該当する場合は、コストの内訳と最適化の提案を提示する

4. 次のステップを提案します：

   • 特定のプロジェクトや機能ビューを詳しく調べるか、ユーザーに尋ねる
   • まだコストを計算していない場合は、計算を提案する
   • 追加の分析オプションを提案する

---

成功の確認

次の条件を満たす場合、スキルの実行は成功です。

1. ✅ 有効な PAI-FeatureStore インスタンスが見つかっている
2. ✅ FeatureDB データソースが特定または選択されている
3. ✅ 使用統計を正常に取得できている
4. ✅ 結果が明確に分析され、提示されている
5. ✅ （依頼された場合）コストが正確に計算されている
6. ✅ 応答の言語がユーザーの質問の言語と一致している

詳細な確認手順については、references/verification-method.md を参照してください。

---

クリーンアップ

このスキルは読み取り専用の操作を実行し、リソースを作成しません。クリーンアップは不要です。

---

ベストプラクティス

1. コマンドを実行する前に、必ずユーザーに RegionId を確認します
2. データソースを一覧表示する際は、すべての結果を取得できるよう、ページネーションを適切に使用します
3. 分析では背景も説明します。数値を提示するだけでなく、傾向やパターンについて説明します
4. 実行可能なインサイトを提供します。さらに調査すべき機能ビューやプロジェクトを提案します
5. エラーに適切に対処します。プロジェクトまたは機能ビューが存在しない場合は、まず利用可能な選択肢をすべて一覧表示するようユーザーに案内します
6. コストを正確に計算します。リージョンに応じて適切な料金プランを使用します
7. ユーザーの関心を保ちます。結果を提示した後、さらに詳しく調べるか、特定の側面を分析するかを尋ねます
8. 対象外のリクエストには丁寧に対応します。使用統計のクエリに関するリクエストではない場合は、丁寧に断り、対応している機能を列挙します

---

リファレンスドキュメント

リファレンス	説明
RAM Policies	必要な RAM 権限とポリシーの設定
Related APIs	使用する API と CLI コマンドの全リスト
Verification Method	各操作の詳細な検証手順
CLI Installation Guide	Aliyun CLI のインストールとセットアップ手順
Acceptance Criteria	テストパターンと検証基準