ai_predict_value functie

Van toepassing op: Databricks SQL Databricks Runtime 19.3 en hoger

Important

Deze functie bevindt zich in de bètaversie. Om het te gebruiken, moet een workspace-beheerder Predictive AI Functions inschakelen vanaf de pagina Voornemen. Zie Azure Databricks previews beheren.

ai_predict_value() traint een regressiemodel uit rijen waar de doelkolom niet NULL is en voorspelt het doelwit voor rijen waar het is NULL. De functie geeft alleen de rijen terug die zij beoordeelt en voegt een voorspellingskolom toe aan de invoerkolommen.

Requirements

• Een Pro- of Serverless SQL-warehouse, of een cluster met Databricks Runtime 19.3 of hoger
• Schrijf je werkruimte in in de previewversie van Predictive AI Functions . Zie Azure Databricks previews beheren.

Syntaxis

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

Arguments

Geef alle scalaire argumenten op naam door. Je kunt doorgaan input op naam of positie.

• input is de tabelwaarde invoer die de trainingsrijen en de te scoren rijen bevat. Rijen waarbij de doelkolom niet NULL is, train het model. De rijen waar de doelkolom staat NULL , worden gescoord.
• target_col is een constante STRING die de numerieke doelkolom benoemt. De kolom moet een kolom op bovenniveau zijn en mag niet voorkomen in feature_cols.
• feature_cols is een niet-lege constante ARRAY<STRING> die de feature-kolommen benoemt. Elke eigenschap moet een topniveau numerieke, Booleaanse of stringkolom zijn.
• seed (optioneel) is een integrale waarde die pseudowillekeurige operaties initialiseert die tijdens modeltraining worden gebruikt. De standaardwaarde is 0.

Returns

De functie geeft een tabel terug met de invoerrijen waarin de doelkolom is NULL. De uitvoer behoudt alle invoerkolommen en voegt <target_col>_prediction toe als een DOUBLE.

Als geen invoerrijen een NULL doel hebben, geeft de functie een lege tabel terug.

Voorbeeld

Het volgende voorbeeld traint op rijen met bekende omzet en voorspelt omzet voor winkels waar deze ontbreekt:

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;

Limitations

• Elke aanroep ondersteunt één doelkolom en traint een nieuw model. De functie bewaart het model niet voor hergebruik.
• Doel- en featurekolommen moeten kolommen op topniveau zijn. Geneste velden worden niet ondersteund.
• De invoer moet ten minste één rij bevatten met een niet-doelwitNULL .
• De invoer mag nog geen kolom bevatten met de naam <target_col>_prediction.

Foutvoorwaarden

Voor ongeldige kolommen, typen of argumenten, zie AI_PREDICT_INVALID_PARAMETER foutconditie. Voor onvoldoende trainingsgegevens, zie AI_PREDICT_INSUFFICIENT_TRAINING_DATA foutconditie.

Gerelateerde functies

Om een klasselabel te voorspellen, gebruik ai_predict_class je functie. Voor andere AI-functies, zie Transform ongestructureerde data met AI-functies.