AI_FIX_GRAMMAR(Transact-SQL)

適用対象:Microsoft Fabric の SQL 分析エンドポイントと Microsoft Fabric のウェアハウス

AI_FIX_GRAMMAR関数は文法を修正し、入力テキストの文の質を向上させます。

Note

  • AI_FIX_GRAMMAR はプレビュー段階です。
  • AI_FIX_GRAMMARSQL分析エンドポイントおよびMicrosoft FabricのWarehouseでのみ利用可能です。

Syntax

Transact-SQL 構文表記規則

AI_FIX_GRAMMAR ( text [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

引数

SMS 送信

例えばnvarcharvarcharnchar、charなど、文字タイプの表現です。

エラーで

ON ERROR節はAI関数が処理エラーをどのように扱うかを制御します。

  • NULL ON ERROR 関数が値を処理できない場合に NULL 返します。 これはデフォルトの動作であり、明示的に指定する必要はありません。
  • ERROR ON ERROR 入力値の処理中にエラーが発生した場合、クエリ全体が失敗します。
  • DEFAULT <value> ON ERROR エラーが発生した場合、 NULL ではなく指定されたデフォルト値を返します。

エラーは 責任あるAI の安全チェック、入力サイズ制限、一時的なサービス問題、その他の処理障害によって引き起こされることがあります。

戻り値の型

修正されたテキストで nvarchar(max) を返します。

Remarks

AIモデルがテキストを処理できない場合、AI関数は NULL を返します。 一般的な理由は次のとおりです。

  • 責任あるAIルールは 入力テキスト内の不適切な内容をブロックします。
  • 入力テキストがトークンの制限を超えています。 現在のモデルでは、最大 15 KB のテキストがサポートされています。

Examples

A. 文字列内の文法を修正する

SELECT ai_fix_grammar('Th room are clean and staff were nice') AS fixed_text;

想定される結果: The rooms are clean, and the staff were nice.

B. コラムを安全に更新する

UPDATE dbo.hotel_reviews
SET review_text = ISNULL(ai_fix_grammar(review_text), review_text);