View a markdown version of this page

トピックへのカスタム手順の追加 - Amazon Quick
カスタム手順の例カスタム手順のベストプラクティス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トピックへのカスタム手順の追加

 適用対象: Enterprise Edition 
   対象者: Amazon Quick 管理者と作成者 

カスタム命令は、AI エンジンがドメイン固有の用語とクロスデータセットロジックを解釈するための永続的な自然言語ルールです。これらがないと、エンジンは用語を文字通り解釈します。たとえば、「今年」はデフォルトで暦年になります。ただし、組織が 4 月 1 日以降の事業年度に実行されている場合は、そのデフォルトを上書きする指示が必要です。

カスタム手順は以下の場合に特に役立ちます。

  • あいまいさの排除ルール。同じビジネス用語が複数のデータセットまたはフィールドにマッピングできる場合は、どちらを優先するか AI に伝えます。たとえば、「ユーザーが「sales」について質問するときは、SALES_FACT を使用します。ユーザーが「returns」または「refunds」について質問した場合は、RETURNS_FACT を使用します。」

  • クロスデータセット定義。複数のデータセットにまたがるメトリクスを定義します。たとえば、「Net Revenue = SUM(SALES_FACT.total_amount) - SUM(RETURNS_FACT.refund_amount)」です。

  • デフォルトの結合動作。目的のセマンティクスを保持する結合方向を指定します。例えば、「ディメンションレコードに一致しないファクトがサイレントにドロップされないように、ファクトテーブルからディメンションテーブルに LEFT JOIN を優先する」などです。

  • カスタム日付ロジック。たとえば、「会計年度は 4 月 1 日に開始されます。会計年度の境界を使用して「今年」を解釈します。」

カスタム手順を追加するには

  1. 設定するトピックを開きます。

  2. カスタム手順タブに移動します。

  3. [編集] を選択します。

  4. 自然言語ルールとして指示を入力します。わかりやすくするために箇条書きスタイルを使用します。

  5. [Save changes] (変更の保存) をクリックします。

カスタム手順の例

次の例は、小売分析トピックの本番稼働用のトピックレベルの手順のセットを示しています。

Disambiguation:
- "sales", "revenue", "orders" -> use SALES_FACT
- "returns", "refunds" -> use RETURNS_FACT
- "net sales", "net revenue" -> join SALES_FACT LEFT JOIN RETURNS_FACT on order_line_id

Cross-dataset metrics:
- Net Revenue = SUM(SALES_FACT.total_amount) - SUM(RETURNS_FACT.refund_amount)
- Return Rate = COUNT(RETURNS_FACT.return_id) / COUNT(SALES_FACT.order_line_id)

Default joins:
- SALES_FACT LEFT JOIN CUSTOMER_DIM on customer_id
- SALES_FACT LEFT JOIN PRODUCT_DIM on product_id

Date handling:
- Fiscal year starts April 1. Interpret "this year" using fiscal year boundaries.
- YTD: current fiscal year up to and including today.

カスタム手順のベストプラクティス

  • 指示は簡潔にしてください。prose 段落よりも箇条書きのルールリストを優先します。

  • トピックレベルの手順は、クロスデータセットロジックにのみ使用します。単一データセットセマンティクス (グレイン、キー、集約ルール) は、データセット独自のエンリッチメントメタデータに属します。

  • データセットレベルとトピックレベルの手順の間に矛盾が生じないようにしてください。

  • チャットで質問をし、 説明パネルで生成された SQL を確認して、手順をテストします。