All Products
Search
Document Center

:Pusat AI

Last Updated:Jul 16, 2026

Fungsi AI StarRocks menyematkan kemampuan model bahasa besar (LLM) langsung ke dalam SQL, memungkinkan Anda menjalankan analisis teks, transformasi, dan generasi sebagai bagian dari kueri OLAP apa pun—tanpa memindahkan data ke pipeline eksternal.

Kedua belas fungsi bawaan mengembalikan nilai bertipe VARCHAR, FLOAT, JSON, atau BOOLEAN yang secara alami dapat dikombinasikan dengan operasi JOIN, GROUP BY, agregasi, dan filter. Data mentah tetap berada di StarRocks; hanya bidang yang diteruskan ke fungsi yang dikirim ke titik akhir model.

Setiap pengguna mendapatkan kuota percobaan gratis sebesar 1 juta token. Setelah melebihi kuota percobaan gratis, penggunaan tambahan akan dikenai biaya berdasarkan konsumsi token aktual. Untuk detail harga, lihat Harga fungsi AI.

Keunggulan fitur

  • Efisiensi konkurensi tinggi: Empat thread mendorong ratusan panggilan LLM secara konkuren. Pendekatan sisi klien akan memerlukan jumlah proses yang setara, dan penjadwal OS akan kolaps jauh sebelum beban kerja selesai.

  • Tanpa operasi pembatasan laju: Perlindungan tiga lapis bawaan plus penanganan kompatibel DashScope memastikan pelanggan tidak perlu mempertimbangkan mekanisme RPM atau TPM.

  • Data tetap di tempatnya: Seluruh pipeline berjalan dalam SQL di dalam database, tanpa ETL dan tanpa risiko eksfiltrasi data.

  • Biaya token lebih rendah: Predicate pushdown mengurangi volume panggilan, caching menghilangkan duplikasi, dan pencatatan akurat melacak setiap token. Beban kerja yang sama dapat menghemat biaya hingga 30% atau lebih.

  • Keandalan tingkat industri: Toleransi kesalahan tingkat baris, retry cerdas, dan observabilitas berbasis Profile memungkinkan pekerjaan batch jutaan baris berjalan tanpa pengawasan.

Kasus penggunaan

Kasus penggunaan

Fungsi

Skor sentimen siap dashboard pada ulasan pelanggan

ai_sentiment

Penandaan otomatis katalog produk atau tiket dukungan

ai_classify

Mengekstraksi bidang terstruktur (nama, tanggal, lokasi) dari teks bebas

ai_extract

Menyamarkan PII sebelum menulis ke lingkungan staging

ai_redact

Pembersihan dan standarisasi konten yang dibuat pengguna

ai_fix_grammar

Meringkas dokumen panjang atau utas tiket

ai_summarize

Menerjemahkan dan melokalkan catatan multibahasa

ai_translate

Memberi peringkat FAQ atau hasil pencarian berdasarkan relevansi semantik

ai_similarity

Penyelesaian teks AI umum dan pembuatan konten

ai_complete

Menyaring baris berdasarkan kondisi bahasa alami

ai_filter

Menjalankan tanya jawab terhadap basis pengetahuan atau resource kustom

ai_custom_query

Prasyarat

Sebelum memulai, pastikan Anda memenuhi persyaratan kernel dan jaringan:

Persyaratan versi kernel

  • 3.3.20-2.1.1 dan yang lebih baru

  • 3.5.16-2.1.1 dan yang lebih baru

Konfigurasi akses jaringan

Node BE StarRocks memerlukan akses internet arah keluar untuk mencapai titik akhir layanan model eksternal. Siapkan Gateway NAT pada VPC tempat kluster Anda berjalan:

  1. Buat Gateway NAT dan bind Elastic IP Address (EIP) ke gateway tersebut.

  2. Tambahkan aturan SNAT yang mengarahkan traffic dari Blok CIDR node BE melalui Gateway NAT.

  3. Konfirmasi bahwa tabel rute VPC dan kebijakan security group Anda mengizinkan lalu lintas outbound.

Untuk detail penyiapan, lihat Gateway NAT Internet.

Referensi fungsi

Semua fungsi dipanggil dalam SQL standar. Hasil dikembalikan sebagai nilai bertipe dan dapat digunakan langsung dalam ekspresi kueri berikutnya.

Fungsi

Apa yang dilakukan

Mengembalikan

ai_sentiment(text)

Mengklasifikasikan teks sebagai positif, negatif, netral, campuran, atau tidak diketahui

VARCHAR

ai_classify(text, labels)

Menetapkan satu label dari daftar kustom

JSON

ai_extract(text, entity_labels)

Mengambil entitas bernama dan mengembalikannya sebagai JSON

JSON

ai_redact(text, categories)

Mengganti kategori PII tertentu dengan [REDACTED]

VARCHAR

ai_fix_grammar(text)

Memperbaiki tata bahasa dan ejaan

VARCHAR

ai_summarize(text)

Menghasilkan ringkasan, dengan batas kata opsional

VARCHAR

ai_translate(text, source_lang, target_lang)

Menerjemahkan teks ke bahasa target

VARCHAR

ai_similarity(text1, text2)

Mengembalikan skor kemiripan semantik dari 0 hingga 1

FLOAT

ai_complete(model, prompt)

Menghasilkan konten menggunakan model dan prompt tertentu

VARCHAR

ai_complete(model, prompt, params)

Menghasilkan konten dengan parameter tambahan (temperature, max_tokens, dll.)

VARCHAR

ai_filter(text, condition)

Menyaring baris dengan mengevaluasi kondisi bahasa alami

BOOLEAN

ai_custom_query(resource, prompt)

Menjalankan kueri terhadap resource atau basis pengetahuan kustom

VARCHAR

Detail fungsi

ai_sentiment

Mengklasifikasikan sentimen dari teks input.

Sintaks

ai_sentiment(text)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan dianalisis

Nilai Kembali

VARCHAR — 'positive', 'negative', 'neutral', 'mixed', atau 'unknown'. Mengembalikan NULL jika sentimen tidak dapat ditentukan.

Contoh

Pengujian nilai tunggal:

SELECT ai_sentiment('I am happy');
-- Returns: 'positive'

Terapkan pada kolom tabel:

SELECT
  review_id,
  review_text,
  ai_sentiment(review_text) AS sentiment
FROM customer_reviews
LIMIT 10;

ai_classify

Menetapkan satu label dari daftar yang Anda definisikan.

Sintaks

ai_classify(text, labels)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan diklasifikasi

labels

ARRAY<VARCHAR>

Label kandidat — minimal 2 dan maksimal 20 elemen

Mengembalikan

JSON — berisi hasil klasifikasi. Mengembalikan NULL jika klasifikasi gagal.

Contoh

Pengujian nilai tunggal:

SELECT ai_classify('My password is leaked.', ['urgent', 'not urgent']);
-- Returns: {"labels": ["urgent"]}

Tag deskripsi produk secara massal:

SELECT
  product_id,
  description,
  ai_classify(description, ['clothing', 'shoes', 'accessories', 'furniture']) AS category
FROM products
LIMIT 10;

ai_extract

Mengekstraksi entitas bernama dari teks dan mengembalikannya sebagai objek JSON.

Sintaks

ai_extract(text, entity_labels)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan diekstraksi

entity_labels

ARRAY<VARCHAR>

Jenis entitas yang akan diekstraksi, misalnya ['person', 'location', 'organization']

Nilai Kembali

Objek JSON di mana kunci adalah jenis entitas dan nilai adalah teks yang diekstraksi.

Contoh

SELECT ai_extract(
  'John Doe lives in New York and works for Acme Corp.',
  ['person', 'location', 'organization']
);
-- Returns: {"person":"John Doe","location":"New York","organization":"Acme Corp"}

ai_redact

Mengganti kategori PII tertentu dengan [REDACTED].

Sintaks

ai_redact(text, categories)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan disamarkan

categories

ARRAY<VARCHAR>

Kategori PII yang akan disamarkan, misalnya ['person', 'email', 'phone']

Mengembalikan

VARCHAR dengan entitas yang cocok diganti oleh [REDACTED].

Contoh

Pengujian nilai tunggal:

SELECT ai_redact(
  'John Doe lives in New York. His email is john.doe@example.com.',
  ['person', 'email']
);
-- Returns: "[REDACTED] lives in New York. His email is [REDACTED]."

Samarkan PII di seluruh tabel log sebelum ekspor:

SELECT
  log_id,
  ai_redact(log_text, ['person', 'email', 'phone']) AS redacted_log
FROM audit_logs
LIMIT 10;

ai_fix_grammar

Memperbaiki tata bahasa dan ejaan dalam teks.

Sintaks

ai_fix_grammar(text)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan diperbaiki

Mengembalikan

VARCHAR dengan tata bahasa dan ejaan yang telah diperbaiki.

Contoh

SELECT ai_fix_grammar('This sentence have some mistake');
-- Returns: "This sentence has some mistake"

ai_summarize

Menghasilkan ringkasan singkat dari teks input.

Sintaks

ai_summarize(text)

Parameter

Parameter

Tipe

Wajib

Deskripsi

text

VARCHAR

Ya

Teks yang akan diringkas

Mengembalikan

Ringkasan VARCHAR.

Contoh

SELECT ai_summarize(
  'Apache Spark is a unified analytics engine for large-scale data processing...',
  10
);
-- Returns: "Spark: unified engine for large-scale data processing with APIs and tools."

ai_translate

Menerjemahkan teks dari satu bahasa ke bahasa lain.

Sintaks

ai_translate(text, source_lang, target_lang)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan diterjemahkan

source_lang

VARCHAR

Kode bahasa sumber (ISO 639-1)

target_lang

VARCHAR

Kode bahasa target (ISO 639-1)

Kode bahasa umum:

Bahasa

Kode

Arab

'ar'

Tionghoa (Sederhana)

'zh'

Inggris

'en'

Prancis

'fr'

Jerman

'de'

Hindi

'hi'

Jepang

'ja'

Bahasa Korea

'ko'

Portugis

'pt'

Rusia

'ru'

Spanyol

'es'

Nilai Kembali

VARCHAR yang telah diterjemahkan.

Contoh

SELECT ai_translate('Hello, how are you?', 'en', 'es');
-- Returns: "Hola, ¿cómo estás?"

ai_similarity

Menghitung kemiripan semantik antara dua teks.

Sintaks

ai_similarity(text1, text2)

Parameter

Parameter

Tipe

Deskripsi

text1

VARCHAR

Teks pertama

text2

VARCHAR

Teks kedua

Mengembalikan

FLOAT antara 0 dan 1. Skor 1,0 berarti teks identik. Skor ini terutama digunakan untuk pengurutan.

Contoh

SELECT ai_similarity(
  'I enjoy hiking in the mountains.',
  'I love walking through mountain trails.'
);
-- Returns: 0.82

ai_complete

Menghasilkan konten menggunakan model tertentu. Mendukung dua bentuk overload: bentuk sederhana dan bentuk berparameter.

Sintaks

-- Overload 1: Sederhana
ai_complete(model, prompt)
-- Overload 2: Dengan parameter
ai_complete(model, prompt, params)

Parameter

Parameter

Tipe

Deskripsi

model

VARCHAR

Nama model, misalnya 'qwen-plus'

prompt

VARCHAR

Prompt yang mengarahkan pembuatan konten

params

MAP<VARCHAR, VARCHAR>

Opsional. Parameter model tambahan seperti temperature, max_tokens, top_p, stop

Pengembalian

VARCHAR — teks yang dihasilkan.

Contoh

Bentuk sederhana:

SELECT ai_complete('qwen-plus', 'Write a catchy email subject for a summer bike sale with a 20% discount');
-- Returns: "Summer Cycling Carnival: 20% Off for a Limited Time!"

Dengan parameter:

SELECT ai_complete('qwen-plus', 'Summarize the benefits of cloud computing', map{'temperature':'0.7', 'max_tokens':'200'});
-- Returns: "Cloud computing offers scalable resources, cost efficiency..."

ai_filter

Mengevaluasi kondisi bahasa alami terhadap teks dan mengembalikan TRUE atau FALSE. Berguna untuk menyaring baris dalam klausa WHERE.

Sintaks

ai_filter(text, condition)

Parameter

Parameter

Tipe

Deskripsi

text

VARCHAR

Teks yang akan dievaluasi

condition

VARCHAR

Kondisi bahasa alami yang menjelaskan kriteria filter

Mengembalikan

BOOLEAN — TRUE jika teks memenuhi kondisi, FALSE jika tidak.

Contoh

SELECT * FROM reviews WHERE ai_filter(review_text, 'mentions product quality issues');
-- Returns rows where the review text discusses product quality problems

ai_custom_query

Menjalankan kueri terhadap resource kustom atau basis pengetahuan.

Sintaks

ai_custom_query(resource, prompt)

Parameter

Parameter

Tipe

Deskripsi

resource

VARCHAR

Nama resource kustom atau basis pengetahuan yang akan dikueri

prompt

VARCHAR

Kueri atau pertanyaan yang diajukan ke resource

Nilai Kembali

VARCHAR.

Contoh

SELECT ai_custom_query('my_knowledge_base', 'What is StarRocks?');
-- Returns: "StarRocks is a high-performance analytical data warehouse..."

Konfigurasi kluster

Perilaku fungsi AI dikendalikan oleh parameter dinamis BE. Ubah parameter tersebut saat runtime menggunakan ADMIN SET CONFIG — tidak perlu restart.

Untuk melihat nilai saat ini:

SELECT * FROM information_schema.be_configs WHERE NAME LIKE 'ai_%';

Koneksi model

Parameter

Bawaan

Deskripsi

ai_function_model_endpoint

"https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"

Titik akhir layanan model. Mendukung titik akhir Chat/Completions yang kompatibel OpenAI.

ai_function_model_type

"qwen-plus"

Model yang akan dipanggil. Mendukung model generasi teks.

ai_function_model_api_key

"sk-89c1***********95d0"

Kunci API untuk Alibaba Cloud Model Studio. Lihat Dapatkan Kunci API.

ai_function_system_prompt

"You are a helpful assistant."

Prompt sistem yang diterapkan ke semua fungsi AI.

ai_function_http_connect_timeout_ms

10000

Timeout koneksi HTTP dalam milidetik (bawaan: 10 detik).

ai_function_http_timeout_ms

600000

Timeout permintaan HTTP dalam milidetik (bawaan: 10 menit).

ai_function_max_inflight_requests

100

Jumlah maksimum permintaan HTTP konkuren ke model. Mengontrol throughput permintaan.

ai_function_request_template

(Format kompatibel OpenAI)

Templat isi permintaan. Placeholder: $0=model, $1=prompt sistem, $2=prompt pengguna, $3=parameter tambahan opsional (diawali koma).

Ukuran batch

Setiap fungsi mengirim permintaan ke model dalam batch. Batch yang lebih besar mengurangi jumlah panggilan model dan dapat memperpendek waktu respons total.

Parameter

Bawaan

Fungsi

ai_function_sentiment_batch_size

10

ai_sentiment

ai_function_classify_batch_size

10

ai_classify

ai_function_similarity_batch_size

10

ai_similarity

ai_function_fix_grammar_batch_size

3

ai_fix_grammar

ai_function_mask_batch_size

3

ai_redact

ai_function_translate_batch_size

3

ai_translate

ai_function_extract_batch_size

1

ai_extract

ai_function_gen_batch_size

1

ai_complete

ai_function_query_batch_size

1

ai_filter

ai_function_summarize_batch_size

1

ai_summarize

Templat prompt

Setiap fungsi menggunakan templat prompt yang dapat dikonfigurasi. Placeholder templat menggunakan $0, $1, dll.

Parameter

Placeholder

Fungsi

ai_function_sentiment_prompt

$0=teks

ai_sentiment

ai_function_classify_prompt

$0=label (dienkode JSON), $1=teks

ai_classify

ai_function_extract_prompt

$0=label, $1=teks

ai_extract

ai_function_fix_grammar_prompt

$0=teks

ai_fix_grammar

ai_function_mask_prompt

$0=label, $1=teks

ai_redact

ai_function_summarize_prompt

$0=jumlah kata, $1=teks

ai_summarize

ai_function_translate_prompt

$0=bahasa target, $1=teks

ai_translate

ai_function_similarity_prompt

$0=pasangan teks

ai_similarity

ai_function_gen_prompt

$0=instruksi generasi

ai_complete

ai_function_query_prompt

$0=instruksi kueri, $1=teks

ai_filter

ai_function_custom_query_prompt

$0=instruksi kueri, $1=teks

ai_custom_query