AI_SENTIMENT¶

構文¶

AI_SENTIMENT( <text> [ , <categories> ] [, <return_error_details> ] )

引数¶

必須：

text

感情が検出されるテキストを含む文字列。

オプション：

categories

感情を抽出する必要がある最大10個のカテゴリ（エンティティまたはアスペクトとも呼ばれる）を含む配列。各カテゴリは文字列です。たとえば、レストランのレビューから感情を抽出する場合は、['cost', 'quality', 'service', 'wait time'] をカテゴリとして指定できます。各カテゴリの長さは最大30文字に設定できます。

この引数を指定しない場合、AI_SENTIMENT は全体的な感情のみを返します。

return_error_details

エラーが発生した場合にエラーの詳細を返すかどうかを示す BOOLEAN フラグ。TRUE に設定した場合、関数は値とエラーメッセージを含む OBJECT を返します。そのうちの1つは関数が成功したか失敗したかに応じて NULL になります。詳細については、`エラー動作`_を参照してください。

戻り値¶

categories フィールドを含む OBJECT 値。categories はカテゴリレコードの配列です。各カテゴリには、以下のフィールドが含まれます。

• name:カテゴリの名前。カテゴリ名は、categories 引数で指定されたカテゴリと一致します。

• sentiment:カテゴリの感情。各感情の結果は、次の文字列のいずれかです。

  • unknown:カテゴリについてテキストで言及されていませんでした。

  • positive:カテゴリについてテキストで肯定的に言及されていました。

  • negative:カテゴリについてテキストで否定的に言及されていました。

  • neutral:カテゴリについてテキストで言及されていましたが、肯定的または否定的な意味合いのいずれでもありませんでした。

  • mixed:テキストでは、カテゴリは肯定的な意味合いおよび否定的な意味合いの両方で言及されていました。

overall カテゴリレコードは常に含まれ、テキストの全体的な感情が含まれます。

例:

{
  "categories": [
    {
      "name": "overall",
      "sentiment": "mixed"
    },
    {
      "name": "Brand",
      "sentiment": "unknown"
    },
    {
      "name": "Cost",
      "sentiment": "negative"
    },
    {
      "name": "Professionalism",
      "sentiment": "unknown"
    }
  ]
}

エラー動作¶

デフォルトでは、AI_SENTIMENTが入力を処理できない場合、関数はNULLを返します。クエリが複数の行を処理する場合、エラーのある行はNULLを返し、クエリの完了を妨げません。

エラー時の戻り値は``return_error_details``引数によって異なります。次の表は、``return_error_details``引数に基づいて、どのような戻り値が返されるかを示しています。

return_error_details	戻り値	説明
FALSE 引数が省略された場合	NULL
TRUE	``value``と``error``のフィールドを持つOBJECT	value:感情分析の結果を含むOBJECT。エラーが発生した場合はNULL。 error:エラーが発生した場合はエラーメッセージを含む VARCHAR 値、または関数が成功した場合は NULL。

See moreShow less

Expand

AI関数のエラー処理について詳しくは、:doc:`/release-notes/bcr-bundles/2026_02/bcr-2184`を参照してください。

アクセス制御の要件¶

ユーザーは、 SNOWFLAKE.CORTEX_USER データベースロール が付与されているロールを使用する必要があります。このロールの詳細については Cortex LLM 権限 をご参照ください。

使用上の注意¶

AI_SENTIMENT は、英語、フランス語、ドイツ語、ヒンディー語、イタリア語、スペイン語、ポルトガル語で感情を分析できます。テキストの言語または英語でカテゴリを指定できます。

例¶

次の例では、AI_SENTIMENT を使用してフードサービスのレビューに関する全体的な感情を取得しています。

SELECT AI_SENTIMENT('A tourist\'s delight, in low urban light,
    Recommended gem, a pizza night sight. Swift arrival, a pleasure so right,
    Yet, pockets felt lighter, a slight pricey bite. 💰🍕🚀');

戻り値:

{
  "categories": [
    {
      "name": "overall",
      "sentiment": "positive"
    }
  ]
}

この例では、reviews という名前のテーブルに review_content という名前の列があり、ユーザーが投稿した映画に関するレビューのテキストが格納されています。クエリは、最大10件のレビューのいくつかのファセットの感情を返します。

SELECT
  AI_SENTIMENT(
    review_content,
    ['concept', 'performance', 'script', 'cinematography', 'soundtrack']
  ),
  review_content
  FROM reviews LIMIT 10;

リージョンの可用性¶

AI_SENTIMENT は以下のリージョンで利用できます。

法的通知¶

Snowflake AI と ML をご参照ください。