適用対象:
Microsoft Fabric の SQL 分析エンドポイントと Microsoft Fabric のウェアハウス
AI_SUMMARIZE 入力テキストの簡潔な要約を作成します。
Note
-
AI_SUMMARIZEはプレビュー段階です。 -
AI_SUMMARIZESQL分析エンドポイントおよびMicrosoft FabricのWarehouseでのみ利用可能です。
Syntax
AI_SUMMARIZE ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )
引数
SMS 送信
例えばnvarchar、varchar、nchar、charなど、文字タイプの表現です。
エラーで
ON ERROR節はAI関数が処理エラーをどのように扱うかを制御します。
-
NULL ON ERROR関数が値を処理できない場合にNULL返します。 これはデフォルトの動作であり、明示的に指定する必要はありません。 -
ERROR ON ERROR入力値の処理中にエラーが発生した場合、クエリ全体が失敗します。 -
DEFAULT <value> ON ERRORエラーが発生した場合、NULLではなく指定されたデフォルト値を返します。
エラーは 責任あるAI の安全チェック、入力サイズ制限、一時的なサービス問題、その他の処理障害によって引き起こされることがあります。
戻り値の型
生成された要約を含む nvarchar を返します。
Remarks
AIモデルがテキストを処理できない場合、AI関数は NULL を返します。 一般的な理由は次のとおりです。
- 責任あるAIルールは 入力テキスト内の不適切な内容をブロックします。
- 入力テキストがトークンの制限を超えています。 現在のモデルでは、最大 15 KB のテキストがサポートされています。
Examples
A. 文を要約してください
SELECT ai_summarize('The hotel was clean and staff were friendly.') AS summary;
想定される結果: Clean hotel, friendly staff.
B. レビューテキストを表でまとめる
次のクエリは、すべてのreview_text値を外部のAIサービスに送り、それを要約します。
SELECT review_id,
ai_summarize(review_text DEFAULT 'N/A' ON ERROR) AS review_summary
FROM dbo.hotel_reviews;
オプションの DEFAULT 'N/A' ON ERROR 節は、処理できないすべての入力値に対してAI関数に「N/A」の値を返すよう指示します。