All Products
Search

This Product

    PolarDB:Hasilkan grafik cerdas dari bahasa alami dengan NL2Chart

    Document Center

    PolarDB:Hasilkan grafik cerdas dari bahasa alami dengan NL2Chart

    Last Updated:Dec 12, 2025

    Setelah NL2SQL menghasilkan pernyataan SQL, Anda dapat melihat hasil kueri tersebut. Untuk visualisasi yang lebih intuitif, hasilnya dapat ditampilkan dalam bentuk grafik kolom, grafik pai, atau grafik garis. Fitur NL2Chart di PolarDB mengonversi hasil kueri SQL menjadi laporan dinamis guna membantu Anda memahami dan menganalisis data secara lebih efisien.

    Ikhtisar

    Alur inti NL2Chart terdiri dari dua tahap. Pertama, fitur ini menggunakan teknologi NL2SQL untuk mengonversi kueri bahasa alami menjadi pernyataan SQL. Selanjutnya, fitur ini menggunakan pernyataan SQL yang telah diurai untuk menghasilkan laporan analitik visual.

    1. Sebagai contoh, jika pernyataan Anda di NL2SQL adalah sebagai berikut:

      /*polar4ai*/SELECT * FROM PREDICT (MODEL _polar4ai_nl2sql, select 'merchant type statistics') WITH (basic_index_name='schema_index',pattern_index_name='pattern_index');

      Pernyataan SQL yang dihasilkan adalah sebagai berikut:

      SELECT merchtype AS merchant_type,COUNT(*) AS product_count FROM hkrt_merchant_info GROUP BY merchtype;

    2. Anda kemudian dapat menggunakan fitur NL2Chart.

      Sintaksis

      /*polar4ai*/SELECT * FROM PREDICT (MODEL _polar4ai_nl2chart, <SQL_statement>) WITH (usr_query = <usr_query>, result_type = <result_type>);

      Parameter

      Parameter

      Deskripsi

      Contoh

      usr_query

      Pertanyaan pengguna yang menentukan persyaratan untuk menghasilkan grafik.

      'Quarterly sales statistics for 2023'

      result_type

      Menentukan jenis hasil yang dikembalikan. Saat ini hanya 'IMAGE' yang didukung.

      'IMAGE'

      SQL_statement

      Pernyataan kueri SQL yang dihasilkan oleh modul NL2SQL untuk mengambil data.

      SELECT quarter, sales FROM sales_data WHERE year = 2023

      Contoh: Mengonversi hasil kueri SQL menjadi grafik.

      /*polar4ai*/SELECT * FROM PREDICT (MODEL _polar4ai_nl2chart, SELECT merchtype AS merchant_type, COUNT(*) AS merchant_count FROM hkrt_merchant_info GROUP BY merchtype) WITH (usr_query = 'merchant type statistics', result_type='IMAGE');

      Hasil berikut dikembalikan:

      http://db4ai-xxx-.aliyuncs.com/pc-xxx/OSSAccessKeyId=xxx&Expires=1716130199&Signature=KvPFzxxx
      Catatan

      Tautan yang dikembalikan merupakan URL citra PNG. URL ini tidak memiliki batasan izin dan hanya berlaku selama 90 menit. Untuk memeriksa waktu kedaluwarsa yang tepat, lihat bidang `Expires` dalam URL tersebut.

    image.png

    Pemilihan dan penggantian jenis grafik

    Model memilih jenis grafik yang sesuai berdasarkan pemahamannya terhadap kueri pengguna dan data yang tersedia. Anda dapat mengarahkan model dalam membuat grafik melalui kueri pengguna.

    Tabel berikut menjelaskan pemetaan antara jenis kueri dan jenis grafik.

    Jenis pertanyaan

    Jenis grafik

    Contoh pertanyaan pengguna

    Deskripsi

    Statistik jumlah

    Column chart

    "Count the sales in each city"

    Menampilkan perbandingan numerik antar kategori berbeda, seperti kuantitas, total jumlah, dan frekuensi.

    Perubahan tren

    Line chart

    "Show the user growth trend over the past year"

    Menunjukkan bagaimana data berubah seiring waktu atau di antara kategori terurut. Grafik ini menekankan kontinuitas.

    Distribusi proporsi

    Pie chart

    "Show the sales proportion of each product line"

    Menunjukkan proporsi bagian terhadap keseluruhan. Memerlukan data kategori dengan total yang jelas.

    Untuk memaksa model menggunakan jenis grafik tertentu, tambahkan perintah di akhir nilai parameter usr_query.

    -- Enter the output SQL into nl2chart to draw a line chart
/*polar4ai*/SELECT * FROM PREDICT (MODEL _polar4ai_nl2chart,
SELECT merchtype AS merchant_type, COUNT(*) AS merchant_count FROM hkrt_merchant_info GROUP BY merchtype
) WITH (usr_query = 'merchant type statistics, draw a line chart', result_type='IMAGE');

    image.png

    -- Enter the output SQL into nl2chart to draw a pie chart
/*polar4ai*/SELECT * FROM PREDICT (MODEL _polar4ai_nl2chart,
SELECT merchtype AS merchant_type, COUNT(*) AS merchant_count FROM hkrt_merchant_info GROUP BY merchtype
) WITH (usr_query = 'merchant type statistics, draw a pie chart', result_type='IMAGE');

    image.png

    Rekomendasi penggunaan

    Anda dapat menggunakan fitur NL2Chart dan NL2SQL secara bersamaan untuk menghasilkan grafik secara otomatis dari kueri bahasa alami.

    Catatan

    Pastikan data Anda kompatibel dengan jenis grafik yang dipilih. Misalnya, grafik pai memerlukan data proporsi, sedangkan grafik garis memerlukan data deret waktu terurut.

    1. Pencocokan jenis grafik otomatis: Sistem merekomendasikan jenis grafik yang sesuai berdasarkan kata kunci dalam kueri, seperti 'count', 'trend', atau 'proportion'.

    2. Penentuan jenis grafik manual: Jika rekomendasi default tidak sesuai kebutuhan Anda, Anda dapat secara eksplisit menentukan jenis grafik dengan memodifikasi parameter usr_query.

    Dengan mengikuti rekomendasi ini, Anda dapat menghasilkan grafik statistik yang dibutuhkan secara efisien.