AI_EXTRACT (Transact-SQL)

Gäller för:SQL-analysslutpunkt i Microsoft Fabric och Warehouse i Microsoft Fabric

Funktionen AI_EXTRACT extraherar värden från inmatningstexten med hjälp av de klasser du tillhandahåller och returnerar resultatet som ett JSON-objekt.

Note

  • AI_EXTRACT är i förhandsversion.
  • AI_EXTRACTfinns endast i SQL analytics endpoint och Warehouse i Microsoft Fabric.

Syntax

Transact-SQL syntaxkonventioner

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

Arguments

text

Ett uttryck för en karaktärstyp, till exempel nvarchar, varchar, nchar eller char.

klass1, klass2, ... n

Ett eller flera egenskapsnamn att extrahera från texten.

PÅ MISSTAG

Klausulen ON ERROR styr hur en AI-funktion hanterar bearbetningsfel.

  • NULL ON ERROR returnerar NULL när funktionen inte kan bearbeta ett värde. Detta är standardbeteendet och behöver inte specificeras uttryckligen.
  • ERROR ON ERROR gör att hela frågan misslyckas om ett fel uppstår under bearbetningen av något indatavärde.
  • DEFAULT <value> ON ERROR returnerar det angivna standardvärdet istället för NULL när ett fel uppstår.

Fel kan orsakas av säkerhetskontroller för Responsible AI , begränsningar av inmatningsstorlek, problem med tillfällig service eller andra bearbetningsfel.

Returtyper

Returnerar nvarchar(max) innehåller JSON-text.

Remarks

AI-funktioner återvänder NULL om AI-modellen inte kan bearbeta texten. Vanliga orsaker är:

  • Ansvarsfulla AI-regler blockerar olämpligt innehåll i inmatningstexten.
  • Indatatexten överskrider tokengränserna. Den aktuella modellen stöder upp till 15 kB text.

Examples

A. Extrahera egenskaper från en sats

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

Förväntat resultat: {"sentiment":"Negative","problem":"Dirty room"}

B. Parse extraherade JSON i kolumner

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

Relaterat innehåll

  • Last updated on