AI_ANALYZE_SENTIMENT (Transact-SQL)

Se aplica a:Punto de conexión de SQL Analytics en Microsoft Fabric y Warehouse en Microsoft Fabric

La AI_ANALYZE_SENTIMENT función analiza el texto de entrada y devuelve una de estas etiquetas de sentimiento: positive, negative, mixed, o neutral.

Note

  • AI_ANALYZE_SENTIMENT está en versión preliminar.
  • AI_ANALYZE_SENTIMENTestá disponible solo en endpoint de analítica SQL y en Warehouse en Microsoft Fabric.

Syntax

Convenciones de sintaxis de Transact-SQL

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

Arguments

text

Una expresión de un tipo de carácter, por ejemplo nvarchar, varchar, nchar o char.

POR ERROR

La ON ERROR cláusula controla cómo una función de IA gestiona los errores de procesamiento.

  • NULL ON ERROR retorna NULL cuando la función no puede procesar un valor. Este es el comportamiento por defecto y no necesita especificarse explícitamente.
  • ERROR ON ERROR hace que toda la consulta falle si ocurre un error mientras se procesa cualquier valor de entrada.
  • DEFAULT <value> ON ERROR devuelve el valor por defecto especificado en lugar de NULL cuando ocurre un error.

Los errores pueden ser causados por comprobaciones de seguridad de IA responsable , límites de tamaño de entrada, problemas de servicio transitorio u otros fallos de procesamiento.

Tipos de retorno

Devuelve nvarchar con uno de los siguientes valores:

  • positive
  • negative
  • mixed
  • neutral

Remarks

Las funciones de IA devuelven NULL si el modelo de IA no puede procesar el texto. Los motivos comunes incluyen los siguientes:

  • Las reglas de IA responsable bloquean contenido inapropiado en el texto de entrada.
  • El texto de entrada supera los límites del token. El modelo actual admite hasta 15 KB de texto.

Examples

A. Analiza el sentimiento en una cuerda

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

Resultado esperado: positive

B. Analizar el sentimiento desde una columna de tabla

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

La cláusula opcional ERROR ON ERROR provoca que la consulta falle si no se puede procesar ningún valor de entrada.

Contenido relacionado

  • Last updated on