AI_EXTRACT (Transact-SQL)

Platí pro:Koncový bod analýzy SQL v Microsoft Fabric a Warehouse v Microsoft Fabric

Funkce AI_EXTRACT extrahuje hodnoty ze vstupního textu pomocí tříd, které zadáváte, a vrací výsledek jako JSON objekt.

Note

  • AI_EXTRACT je ve verzi Preview.
  • AI_EXTRACTje dostupný pouze v SQL analytics endpointu a Warehouse v Microsoft Fabric.

Syntax

Transact-SQL konvence syntaxe

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

Arguments

poslat SMS

Výraz typu znaku, například nvarchar, varchar, nchar nebo char.

třída 1, třída 2, ... n

Jeden nebo více vlastnostních názvů lze extrahovat z textu.

NA CHYBĚ

Tato ON ERROR klauzule řídí, jak AI funkce zpracovává chyby zpracování.

  • NULL ON ERROR vrací NULL , když funkce nemůže zpracovat hodnotu. Toto je výchozí chování a není nutné to výslovně specifikovat.
  • ERROR ON ERROR způsobí, že celý dotaz selže, pokud při zpracování jakékoli vstupní hodnoty dojde k chybě.
  • DEFAULT <value> ON ERROR vrací zadanou výchozí hodnotu místo NULL toho, kdy nastane chyba.

Chyby mohou být způsobeny bezpečnostními kontrolami odpovědné AI , limity velikosti vstupů, přechodnými službami nebo jinými selháními zpracování.

Návratové typy

Vrací nvarchar(max) se text JSON.

Remarks

AI funkce se vrátí NULL , pokud AI model nedokáže text zpracovat. Mezi běžné důvody patří:

  • Pravidla odpovědné AI blokují nevhodný obsah ve vstupním textu.
  • Vstupní text překračuje limity tokenů. Aktuální model podporuje až 15 kB textu.

Examples

A. Extrahujte vlastnosti z věty

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

Očekávaný výsledek: {"sentiment":"Negative","problem":"Dirty room"}

B. Parse extrahoval JSON do sloupců

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

Související obsah

  • Poslední aktualizace v