AI_EXTRACT (Transact-SQL)

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

La AI_EXTRACT función extrae valores del texto de entrada usando las clases que proporcionas y devuelve el resultado como objeto JSON.

Note

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

Syntax

Convenciones de sintaxis de Transact-SQL

AI_EXTRACT ( text, class1, class2 [ , ...n ] )

Arguments

text

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

Clase 1, Clase 2, ... n

Uno o más nombres de propiedades para extraer del texto.

Tipos de retorno

Retornos nvarchar(max) que contienen texto JSON.

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 responsables bloquean el 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. Extraer propiedades de una oración

SELECT ai_extract('Check-in was late and room dirty', 'sentiment', 'problem') AS extraction;

Resultado esperado: {"sentiment":"Negative","problem":"Dirty room"}

B. El análisis sintáctico extrajo JSON en columnas

SELECT sentiment, time_reported, problem
FROM dbo.hotel_reviews
CROSS APPLY OPENJSON(
    ai_extract(review_text, 'sentiment', 'time_reported', 'problem')
) WITH (
    sentiment VARCHAR(1000),
    time_reported VARCHAR(100),
    problem VARCHAR(1000)
);