fungsi ai_predict_value

Berlaku untuk: Databricks SQL Databricks Runtime 19.3 ke atas

Important

Fitur ini ada di Beta. Admin ruang kerja dapat mengontrol akses ke fitur ini dari halaman Pratinjau . Lihat Kelola Pratinjau Azure Databricks.

ai_predict_value() melatih model regresi dari baris di mana kolom target tidak NULL dan memprediksi target untuk baris di mana kolom tersebut berada NULLdi . Fungsi ini hanya mengembalikan baris yang diberi skor dan menambahkan kolom prediksi ke kolom input.

Persyaratan

• Gudang SQL Pro atau Serverless, atau klaster yang menjalankan Databricks Runtime 19.3 atau lebih tinggi
• Daftarkan ruang kerja Anda dalam pratinjau Predictive AI Functions . Lihat Kelola Pratinjau Azure Databricks.

Sintaksis

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

Arguments

Lewatkan semua argumen skalar berdasarkan nama. Anda bisa menyebut input nama atau posisi.

• input adalah input bernilai tabel yang berisi baris pelatihan dan baris yang akan dinilai. Baris di mana kolom target tidak NULL dilatih model. Baris tempat kolom target berada NULL akan diberi skor.
• target_col adalah konstanta STRING yang menamai kolom target numerik. Kolom harus berupa kolom tingkat atas dan tidak boleh muncul di .feature_cols
• feature_cols adalah konstanta ARRAY<STRING> yang tidak kosong yang memberi nama pada kolom fitur. Setiap fitur harus berupa kolom numerik, Boolean, atau string tingkat atas.
• seed (opsional) adalah nilai integral yang menginisialisasi operasi pseudorandom yang digunakan selama pelatihan model. Defaultnya adalah 0.

Returns

Fungsi ini mengembalikan tabel yang berisi baris input di mana kolom target adalah NULL. Output mempertahankan semua kolom input dan menambahkan <target_col>_prediction sebagai DOUBLE.

Jika tidak ada baris input yang memiliki NULL target, fungsi akan mengembalikan tabel kosong.

Example

Contoh berikut melatih pada baris dengan pendapatan yang diketahui dan memprediksi pendapatan untuk toko yang hilang:

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

• Setiap pemanggilan mendukung satu kolom target dan melatih model baru. Fungsi ini tidak mempertahankan model untuk digunakan kembali.
• Kolom target dan fitur harus berupa kolom tingkat atas. Field bersarang tidak didukung.
• Input harus berisi setidaknya satu baris dengan non-targetNULL .
• Input tidak boleh sudah berisi kolom bernama <target_col>_prediction.

Kondisi kesalahan

Untuk kolom, tipe, atau argumen yang tidak valid, lihat AI_PREDICT_INVALID_PARAMETER kondisi kesalahan. Untuk data pelatihan yang tidak memadai, lihat kondisi AI_PREDICT_INSUFFICIENT_TRAINING_DATA kesalahan.

Fungsi terkait

Untuk memprediksi label kelas, gunakan ai_predict_class fungsi. Untuk Fungsi AI lainnya, lihat Transformasi data tidak terstruktur menggunakan Fungsi AI.