AI_ANALYZE_SENTIMENT(Transact-SQL)

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

AI_ANALYZE_SENTIMENT関数は入力テキストを解析し、positive、negative、mixed、またはneutralのいずれかのセンチメントラベルを返します。

Note

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

Syntax

Transact-SQL 構文表記規則

AI_ANALYZE_SENTIMENT ( 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 は以下のいずれかの値で返します:

  • positive
  • negative
  • mixed
  • neutral

Remarks

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

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

Examples

A. 感情を一つの文字列で分析する

SELECT ai_analyze_sentiment('This hotel was great!') AS sentiment;

想定される結果: positive

B. 表の列から感情を分析する

SELECT review_id,
       ai_analyze_sentiment(review_text ERROR ON ERROR) AS sentiment
FROM dbo.hotel_reviews;

任意の ERROR ON ERROR 節により、入力値が処理できない場合クエリは失敗します。

関連するコンテンツ

  • Last updated on