AI_EXTRACT (Transact-SQL)

Aplica-se a:Ponto de extremidade de análise de SQL no Microsoft Fabric e Warehouse no Microsoft Fabric

A AI_EXTRACT função extrai valores do texto de entrada usando as classes que você fornece e retorna o resultado como um objeto JSON.

Note

  • AI_EXTRACT está em versão prévia.
  • AI_EXTRACTestá disponível apenas em endpoints de análise SQL e Warehouse no Microsoft Fabric.

Syntax

Convenções de sintaxe de Transact-SQL

AI_EXTRACT ( text, class1, class2 [ , ...n ] [ (NULL | ERROR | DEFAULT <value>) ON ERROR ] )

Arguments

enviar SMS

Uma expressão de um tipo de caractere, por exemplo nvarchar, varchar, nchar ou char.

Classe 1, Classe 2, ... n

Um ou mais nomes de propriedades para extrair do texto.

ERRO

A ON ERROR cláusula controla como uma função de IA lida com erros de processamento.

  • NULL ON ERROR retorna NULL quando a função não consegue processar um valor. Esse é o comportamento padrão e não precisa ser especificado explicitamente.
  • ERROR ON ERROR faz com que toda a consulta falha se ocorrer um erro durante o processamento de qualquer valor de entrada.
  • DEFAULT <value> ON ERROR retorna o valor padrão especificado em vez de NULL quando ocorre um erro.

Erros podem ser causados por verificações de segurança da IA Responsável , limites de tamanho de entrada, problemas de serviço transitório ou outras falhas de processamento.

Tipos de retorno

Retornos nvarchar(max) contendo texto JSON.

Remarks

As funções de IA retornam NULL se o modelo de IA não conseguir processar o texto. Os motivos comuns incluem:

  • Regras de IA responsável bloqueiam conteúdo inadequado no texto de entrada.
  • O texto de entrada excede os limites de token. O modelo atual dá suporte a até 15 KB de texto.

Exemplos

A. Extrair propriedades de uma sentença

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

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

B. A análise parse extraía o JSON em colunas

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)
);

Conteúdo relacionado

  • Last updated on