ai_predict_value Função

Aplica-se a:assinalado Databricks SQL assinalado sim Databricks Runtime 19.3 e superiores

Importante

Este recurso está em versão Beta. Para o utilizar, um administrador de espaço de trabalho tem de ativar as Funções Preditivas de IA na página de Pré-visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

ai_predict_value() treina um modelo de regressão a partir de linhas onde a coluna alvo não NULL é e prevê o alvo para linhas onde está NULL. A função devolve apenas as linhas que pontua e acrescenta uma coluna de previsão às colunas de entrada.

Requisitos

Syntax

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

Arguments

Passa todos os argumentos escalares pelo nome. Pode passar input pelo nome ou pela posição.

  • input é a entrada com valores de tabela que contém as linhas de treino e as linhas a pontuar. Linhas onde a coluna alvo não NULL é treinam o modelo. As linhas onde está NULL a coluna alvo são pontuadas.
  • target_col é uma constante STRING que nomeia a coluna alvo numérica. A coluna deve ser uma coluna de topo e não deve aparecer em feature_cols.
  • feature_cols é uma constante ARRAY<STRING> não vazia que nomeia as colunas de características. Cada característica deve ser uma coluna numérica, booleana ou de cadeia de nível superior.
  • seed (opcional) é um valor integral que inicializa operações pseudoaleatásticas usadas durante o treino do modelo. A predefinição é 0.

Devoluções

A função devolve uma tabela contendo as linhas de entrada onde a coluna de destino é NULL. A saída mantém todas as colunas de entrada e acrescenta <target_col>_prediction como um DOUBLE.

Se nenhuma linha de entrada tiver um NULL alvo, a função devolve uma tabela vazia.

Exemplo

O exemplo seguinte treina em filas com receitas conhecidas e prevê receitas para lojas onde esta está em falta:

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

  • Cada invocação suporta uma coluna alvo e treina um novo modelo. A função não mantém o modelo para reutilização.
  • As colunas alvo e característica devem ser colunas de nível superior. Campos aninhados não são suportados.
  • A entrada deve conter pelo menos uma linha com um não-alvoNULL .
  • A entrada não deve já conter uma coluna chamada <target_col>_prediction.

Condições de erro

Para colunas, tipos ou argumentos inválidos, veja AI_PREDICT_INVALID_PARAMETER condição de erro. Para dados de treino inadequados, veja AI_PREDICT_INSUFFICIENT_TRAINING_DATA condição de erro.

Para prever um rótulo de classe, use ai_predict_class a função. Para outras Funções de IA, veja Transformar dados não estruturados usando Funções de IA.

  • Última atualização a