ai_predict_value Funkce

Platí na:zaškrtnout ano, Databricks SQL zaškrtnout ano, Databricks Runtime 19.3 a výše

Important

Tato funkce je v beta verzi. Pro jeho použití musí správce pracovního prostoru zapnout Prediktivní AI funkce na stránce Náhledy . Viz Manage Azure Databricks preview.

ai_predict_value()trénuje regresní model z řádků, kde cílový sloupec neníNULL, a předpovídá cíl pro řádky, kde je .NULL Funkce vrací pouze řádky, které ohodnotí, a přidá k vstupním sloupcům sloupec predikce.

Požadavky

  • Pro nebo Serverless SQL sklad, nebo cluster s Databricks Runtime 19.3 nebo novějším
  • Zapište si svůj pracovní prostor do náhledu Prediktivních AI funkcí . Viz Manage Azure Databricks preview.

Syntax

ai_predict_value(
  input => TABLE(input),
  target_col => target_col,
  feature_cols => feature_cols
  [, seed => seed]
)

Arguments

Všechny skalární argumenty předávajte podle jména. Můžete přejít input podle jména nebo pozice.

  • input je vstup s hodnotou tabulky, který obsahuje trénovací řádky a řádky pro skórování. Řádky, kde cílový sloupec není NULL , trénují model. Řádky, kde je cílový sloupec NULL , se bodují.
  • target_col je konstanta STRING , která pojmenovává číselný cílový sloupec. Sloupec musí být sloupec nejvyšší úrovně a nesmí se objevovat v .feature_cols
  • feature_cols je neprázdná konstanta ARRAY<STRING> , která pojmenovává sloupce příznaků. Každý rys musí být sloupec nejvyšší úrovně čísel, Booleovské nebo řetězcové části.
  • seed (volitelné) je integrální hodnota, která inicializuje pseudonáhodné operace používané při trénování modelu. Výchozí hodnota je 0.

Returns

Funkce vrací tabulku obsahující vstupní řádky, kde cílový sloupec je NULL. Výstup zachovává všechny vstupní sloupce a přidává <target_col>_prediction se jako .DOUBLE

Pokud žádný vstupní řádek nemá NULL cíl, funkce vrátí prázdnou tabulku.

Example

Následující příklad trénuje na řádcích s známými příjmy a předpovídá příjmy pro obchody, kde chybí:

WITH sales AS (
  SELECT * FROM VALUES
    (1, 10.0, 'east', 120.0),
    (2, 12.0, 'east', 135.0),
    (3, 15.0, 'west', 160.0),
    (4, 18.0, 'west', 190.0),
    (5, 20.0, 'east', 205.0),
    (6, 24.0, 'west', 240.0),
    (7, 16.0, 'east', NULL),
    (8, 22.0, 'west', NULL)
  AS sales(store_id, advertising_spend, region, revenue)
)
SELECT store_id, revenue_prediction
FROM ai_predict_value(
  input => TABLE(sales),
  target_col => 'revenue',
  feature_cols => ARRAY('advertising_spend', 'region'),
  seed => 42
)
ORDER BY store_id;

Omezení

  • Každé vyvolání podporuje jeden cílový sloupec a trénuje nový model. Funkce model neuchovává pro opětovné použití.
  • Cílové a feature sloupce musí být sloupce nejvyšší úrovně. Vnořená pole nejsou podpořena.
  • Vstup musí obsahovat alespoň jeden řádek s ne-cílovýmNULL číslem.
  • Vstup nesmí již obsahovat sloupec s názvem <target_col>_prediction.

Stavy chyb

Pro neplatné sloupce, typy nebo argumenty viz AI_PREDICT_INVALID_PARAMETER chybová podmínka. Pro nedostatečná tréninková data viz AI_PREDICT_INSUFFICIENT_TRAINING_DATA chybová podmínka.

Pro predikci třídního štítku použijte ai_predict_class funkciji. Pro další AI funkce viz Transformace nestrukturovaných dat pomocí AI funkcí.