AI_SENTIMENT¶

Sintaxe¶

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

Argumentos¶

Obrigatório:

text

Uma string contendo o texto no qual o sentimento é detectado.

Opcional:

categories

Uma matriz contendo até dez categorias (também chamadas de entidades ou aspectos) para as quais o sentimento deve ser extraído. Cada categoria é uma string. Por exemplo, se extrair um sentimento de uma avaliação de um menu de um menu de um menu do, você pode especificar ['cost', 'quality', 'service', 'wait time'] como as categorias. Cada categoria pode ter no máximo 30 caracteres.

Se você não fornecer esse argumento, AI_SENTIMENT retorna apenas o sentimento geral.

return_error_details

Um sinalizador BOOLEAN que indica se os detalhes do erro devem ser retornados em caso de erro. Quando definido como TRUE, a função retorna um OBJECT que contém o valor e a mensagem de erro, sendo um deles NULL dependendo se a função foi bem-sucedida ou falhou. Consulte Comportamento de erro para obter detalhes.

Retornos¶

Um valor OBJECT contendo um campo categories. categories é uma matriz de registros de categoria. Cada categoria inclui estes campos:

• name: o nome da categoria. Os nomes das categorias correspondem às categorias especificadas no argumento categories.

• sentiment: o sentimento da categoria. Cada resultado de sentimento é uma das seguintes strings.

  • unknown: a categoria não foi mencionada no texto.

  • positive: a categoria foi mencionada positiva no texto.

  • negative: a categoria foi mencionada negativamente no texto.

  • neutral: a categoria foi mencionada no texto, mas não positiva nem negativamente.

  • mixed: a categoria foi mencionada tanto positiva quanto negativamente no texto.

O registro da categoria overall é sempre incluído e contém o sentimento geral do texto.

Exemplo:

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

Comportamento em caso de erro¶

Por padrão, se AI_SENTIMENT não puder processar a entrada, a função retornará NULL. Se a consulta processar várias linhas, as linhas com erros retornarão NULL e não impedirão a conclusão da consulta.

O valor de retorno em caso de erro depende do argumento return_error_details. A tabela a seguir mostra o valor de retorno com base no argumento return_error_details:

return_error_details	Valor de retorno	Descrição
FALSE Não passado	NULL
TRUE	OBJECT com campos value e error	value: Um OBJECT contendo o resultado da análise de sentimento, ou NULL se ocorreu um erro. error: um valor VARCHAR que contém a mensagem de erro se ocorreu um erro ou NULL se a função foi bem-sucedida.

See moreShow less

Expand

Para obter mais informações sobre o tratamento de erros para funções de AI, consulte Snowflake Cortex AI Function: Multirow error handling improvements.

Requisitos de controle de acesso¶

Os usuários devem usar uma função que tenha a função do banco de dados SNOWFLAKE.CORTEX_USER. Consulte Privilégios de LLM do Cortex para obter mais informações sobre essa função.

Notas de uso¶

AI_SENTIMENT pode analisar o sentimento em inglês, francês, alemão, hindi, italiano, espanhol e português. É possível especificar categorias no idioma do texto ou em inglês.

Exemplos¶

O exemplo a seguir usa AI_SENTIMENT para obter o sentimento geral de uma avaliação do serviço de alimentações.

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. 💰🍕🚀');

Valor de retorno:

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

Neste exemplo, uma tabela chamada reviews contém uma coluna chamada review_content contendo o texto das resenhas de filmes enviadas pelos usuários. A consulta retorna o sentimento de várias aspectos de até dez avaliações.

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

Disponibilidade regional¶

AI_SENTIMENT está disponível nas seguintes regiões:

Avisos legais¶

Consulte AI e ML Snowflake.