Quick BI：placeholder

Prosedur

Buat entri

Entri satu: halaman pengeditan SQL kustom

1. Navigasikan ke halaman pengeditan kode SQL dan klik Placeholder Management.

   

2. Di panel Placeholder Management, sistem mencantumkan placeholder yang digunakan dalam SQL Anda. Di sini, Anda dapat menyesuaikan tipe variabel dan nilai default untuk setiap placeholder. Setelah dikonfigurasi, klik Konfirmasi.

   

Entri dua: antarmuka pemrosesan data

• Di Toolbar antarmuka pemrosesan data, klik Create Placeholder, masukkan Variable Name, Variable Type, dan Query Default Value, lalu klik Confirm.

  

• Ketika dataset berisi placeholder, Anda dapat mengklik Field Outline -> ikon Placeholder untuk mengakses antarmuka Placeholder Management.Di antarmuka manajemen placeholder, klik Create Placeholder untuk membuat placeholder secara manual.

Entri tiga: halaman pengeditan dashboard

1. Untuk membuat New Placeholder di halaman pengeditan dashboard, ikuti langkah-langkah berikut:

   1. Klik ikon untuk memulai pembuatan placeholder baru.

      

   2. Di antarmuka Placeholder Management, pilih Create New Placeholder.

2. Di dalam antarmuka Create Placeholder, tentukan Variable Name, Variable Type, dan Query Default Value.

Item Konfigurasi dan Deskripsi

Placeholder Nilai

Lewati nilai atau serangkaian nilai melalui kontrol kueri di dashboard.

Format: '$val{NamaPlaceholder}'

Contoh Kode SQL:

SELECT * FROM tablename
WHERE area in ('$val{area_ph}') -- Tipe teks pilihan ganda
AND name = '$val{name_ph}' -- Tipe teks pilihan tunggal
AND number = $val{number_ph} -- Tipe numerik
AND report_date > '$val{report_date_ph.get(0)}' -- Tipe tanggal mendapatkan tanggal awal rentang tanggal kontrol
AND report_date < '$val{report_date_ph.get(1)}' -- Tipe tanggal mendapatkan tanggal akhir rentang tanggal kontrol

Placeholder Ekspresi

Lewati kondisi melalui kontrol kueri di dashboard.

Ketika pengguna perlu memodifikasi metode filter dalam kondisi filter dashboard, placeholder ekspresi digunakan untuk memasukkan seluruh kondisi filter ke dalam SQL.

Format: $expr{NamaBidangFisik:NamaPlaceholder}

Contoh Kode SQL:

SELECT report_date,
 order_level,
 shipping_type,
 area,
 price,
 order_number
from company_sales_record
where $expr{report_date :report_date}
and $expr{order_level :order_level}
and $expr{order_number :order_number}

Placeholder Tag

Ambil nilai tag pengguna saat ini menggunakan placeholder tag.

Format: $tag{NamaTagPengguna}

Sebagai contoh, untuk memastikan seorang karyawan hanya melihat data dari area Utara dan produk tertentu, konfigurasikan tag pengguna sebagai berikut:

• Area: Utara

• Produk: Produk A, Produk B

select * from table_name
where 
area = '$tag{Area}'
and
product in ('$tag{Product}')

select * from table_name
where 
area = 'Utara'
and
product in ('Produk A', 'Produk B')

Placeholder Sistem

Placeholder sistem berfungsi seperti placeholder lainnya dan dapat digunakan dalam SQL dan bidang terhitung. Mereka mendukung empat placeholder sistem berikut:

• Nama Pengguna (akun logon): $system{accountName}

• Nama Panggilan Pengguna (dalam organisasi): $system{userNick}

• ID Pengguna (dalam sistem Quick BI): $system{userId}

• ID Pengguna sistem pihak ketiga (ID Alibaba Cloud): $system{accountId}

Contoh Pernyataan SQL:

select
  *
from
  company_sales_record
where
  customer_name = '$system{accountName}'
  and customer_name = '$system{userNick}'

Placeholder kondisi

Lewati serangkaian nilai melalui kontrol dropdown pohon kueri di dashboard.

Format: '$condition{BidangUtama, BidangSekunder: NamaPlaceholder}'

Jumlah bidang dibatasi maksimal 10 dan harus sesuai dengan struktur pohon kontrol kueri.

Contoh Pernyataan SQL:

select
 *
from
 company_sales_record
where 
 $condition{product_type,product_sub_type,product_name :product_para}

Konfigurasi kontrol kueri adalah sebagai berikut:

Acceleration placeholder

Acceleration placeholder mempercepat ekstraksi data dalam SQL kustom yang mencakup parameter waktu. Anda dapat menempatkan acceleration placeholder dalam kondisi WHERE. Mesin Quick BI kemudian akan mengganti jendela waktu secara dinamis selama ekstraksi dan melakukan ekstraksi offline inkremental berdasarkan konfigurasi Anda.

Format: $accel{PhysicalFieldName:PlaceholderName}

Contoh kode SQL:

select
  *
from
  company_sales_record
where
  $accel{report_date:report_date}

Nilai default kueri: Untuk mencegah kueri SQL kustom timeout, Anda dapat menetapkan nilai default untuk acceleration placeholder.

Contoh: Nilai default untuk acceleration placeholder harus berupa ekspresi filter lengkap, bukan hanya nilai tanggal, misalnya report_date<'2025-04-01'.

Konfigurasi akselerasi: Untuk dataset yang memiliki acceleration placeholder, pilih field placeholder sebagai field tanggal dalam pengaturan akselerasi. Konfigurasikan rentang waktu ekstraksi dan granularitas inkremental untuk menyelesaikan tugas akselerasi.

Skenario

Skenario 1 - Menyesuaikan Secara Dinamis Nilai Hasil Bidang Terhitung

Deskripsi skenario

Gunakan bidang terhitung dan placeholder dalam ekspresi untuk secara dinamis mengubah nilai bidang terhitung dengan melewati nilai placeholder yang berbeda.

Sebagai contoh, pesanan yang melebihi nilai placeholder dianggap sebagai pesanan besar; jika tidak, mereka adalah pesanan kecil. Sesuaikan kriteria ukuran pesanan secara dinamis menggunakan kontrol kueri, dan grafik akan diperbarui untuk mencerminkan perubahan tersebut.

Prosedur

1. Buat placeholder.

   1. Di halaman pengeditan SQL kustom atau halaman pengeditan dataset, klik Placeholder Management -> Create Placeholder.

   2. Masukkan nama variabel Harga, pilih Value Placeholder sebagai tipe, pilih Numerik untuk tipe variabel, atur nilai default kueri ke Efektivitas Global, dan opsional, nilai default ke 100.

      Catatan

      Placeholder yang digunakan dalam bidang terhitung harus memiliki nilai default yang efektif secara global.

      

2. Buat Bidang Terhitung

   1. Di halaman pengeditan dataset, klik Create Field dan buat bidang Skala Pesanan seperti yang ditunjukkan dalam gambar.

      

      Contoh ekspresi bidang:

      case when [price]>$val{Price}
      then 'Pesanan Besar'
      else 'Pesanan Kecil'
      end

   2. Klik Confirm dan Save dataset.

3. Buat Grafik Visualisasi dan Kontrol Kueri

   1. Mulailah analisis dengan membuat dashboard.

   2. Tambahkan Grafik Batang di halaman pengeditan dashboard seperti yang ditunjukkan dalam gambar.

   3. Tarik bidang ukuran pesanan ke sumbu kategori/dimensi, letakkan bidang harga pada sumbu nilai/ukuran, dan klik Perbarui. Grafik batang akan ditampilkan sebagai berikut:

      

      Saat ini, bidang ukuran harga membedakan antara pesanan besar dan kecil berdasarkan nilai default placeholder 100 untuk Harga.

   4. Buat kontrol kueri seperti yang diilustrasikan.

      

   5. Di antarmuka pengaturan kondisi kueri, tetapkan placeholder Harga sebagai kondisi kueri.

4. Lihat efeknya.

   Anda sekarang dapat menyesuaikan kriteria untuk pesanan besar dan kecil dengan memasukkan nilai di kontrol kueri.

   Sebagai contoh, ketika nilai kontrol kueri diatur ke 100, jumlah pesanan besar adalah 607.200. Jika nilai kontrol kueri diubah menjadi 150, jumlah pesanan besar menjadi 525.000.

   

Skenario 2 - Alihkan Indikator atau Dimensi Analisis Secara Fleksibel

Deskripsi skenario

Manfaatkan fitur ini untuk beralih antara beberapa indikator dan dimensi pada grafik, menghindari kekacauan atau redundansi dari membuat banyak grafik.

Pertimbangkan contoh beralih dimensi indikator.

Prosedur

1. Buat Placeholder

   1. Di halaman pengeditan SQL kustom atau halaman pengeditan dataset, klik Placeholder Management -> Create Placeholder.

   2. Masukkan nama variabel Indikator, atur tipe ke Value Placeholder, pilih Teks untuk tipe variabel, atur nilai default kueri ke Efektivitas Global, dan nilai default ke Harga Satuan.

2. Buat Bidang Terhitung

   1. Klik Create Field dan buat bidang Data seperti yang ditunjukkan dalam gambar.

      Contoh ekspresi bidang:

      case when '$val{Indicator}'='Jumlah Pesanan' then [Jumlah Pesanan]
      when '$val{Indicator}'='Jumlah Keuntungan' then [Jumlah Keuntungan]
      when '$val{Indicator}'='Harga Satuan' then [Harga Satuan]
      when '$val{Indicator}'='Biaya Pengiriman' then [Biaya Pengiriman]
      else 0
      end

      Catatan

      Placeholder tipe teks harus diapit oleh tanda kutip tunggal, seperti '$val{Indicator}'.

   2. Klik Confirm dan Save dataset.

3. Buat Grafik Visualisasi dan Kontrol Kueri

   1. Mulailah analisis dengan membuat dashboard.

   2. Di halaman pengeditan dashboard, tambahkan Grafik Batang seperti yang ditunjukkan dalam gambar.

      

   3. Tarik bidang Area ke Sumbu Kategori/Dimensi, letakkan segmen Data pada Sumbu Nilai/Ukuran, dan klik Perbarui. Grafik batang akan ditampilkan sebagai berikut:

   4. Buat kontrol kueri seperti yang digambarkan dalam gambar.

   5. Di antarmuka pengaturan kondisi kueri, tetapkan placeholder Indikator sebagai kondisi kueri. Pilih Input Manual sebagai sumber nilai opsi dan konfigurasikan nilai Dimasukkan Secara Manual.

4. Lihat Efek

   Anda sekarang dapat beralih antara indikator yang berbeda dengan menyaring nilai di kontrol kueri.

   

Skenario 3 - Sesuaikan Garis Bantu Secara Dinamis

Deskripsi skenario

Tautkan nilai garis bantu ke placeholder sehingga ketika nilai placeholder diperbarui, garis bantu menyesuaikan sesuai.

Sebagai contoh, jika garis bantu mewakili KPI penjualan bulanan, Anda dapat memperbarui posisinya secara dinamis setiap bulan melalui kontrol kueri tanpa perlu mengedit laporan lagi.

Prosedur

1. Buat placeholder.

   Catatan

   Placeholder garis bantu hanya mendukung tipe numerik.

   1. Di halaman pengeditan dashboard, buat placeholder seperti yang diilustrasikan.

   2. Masukkan nama variabel Target, atur tipe variabel ke Numerik, nilai default kueri ke Efektivitas Global, dan nilai default ke 4.000.000.

      Catatan

      Placeholder yang digunakan dalam garis bantu harus memiliki nilai default yang efektif secara global.

      

2. Atur Garis Bantu

   1. Di tab Analisis, temukan garis bantu dan klik ikon pensil untuk mengedit.

   2. Konfigurasikan dan tambahkan garis bantu seperti yang ditunjukkan, atur nilainya ke placeholder Target.

      Grafik sekarang menampilkan garis bantu pada angka 4 juta.

3. Buat Query Control.

   1. Hasilkan kontrol kueri seperti yang ditunjukkan dalam gambar.

   2. Tetapkan placeholder Target sebagai kondisi kueri dan klik Confirm.

4. Lihat Efeknya.

   Ubah posisi garis bantu dengan mengubah nilai di kontrol kueri.

   

Skenario 4 - Gunakan Placeholder dalam Kode SQL untuk Mencapai Penyesuaian dan Penyaringan Nilai Hasil Bidang Secara Dinamis

Deskripsi skenario

Masukkan placeholder ke dalam kode SQL saat membuat dataset untuk secara dinamis menyesuaikan dan menyaring nilai hasil bidang dengan memodifikasi nilai placeholder.

Prosedur

1. Di halaman pengeditan dataset, klik Click To Create Dataset Using SQL Code di kanvas atau Create Table with SQL Code di panel kiri.

   

2. Setelah memasukkan kode SQL

   

   Contoh Pernyataan SQL:

   SELECT report_date, order_level, shipping_type,price,order_number,area,
    case when profit_amt< ${profit_range} then'Rugi' 
    when profit_amt> ${profit_range} then'Untung'
    else 'Impas'
    end 'Tingkat Pesanan'
   from company_sales_record
   where $expr{report_date :report_date}
   and $expr{order_level :order_level}
   and $expr{order_number :order_number}

3. Klik Placeholder Management.

   

4. Akses antarmuka manajemen placeholder dan masukkan nilai default.

   

   Catatan

   Placeholder yang diterapkan setelah pernyataan select harus memiliki nilai default yang efektif secara global.

   Dalam contoh ini, placeholder "profit_range" memerlukan nilai default yang efektif secara global.

5. Jalankan kueri dengan mengklik Run untuk melihat hasilnya.

   

6. Finalisasikan editan Anda dengan mengklik Confirm Edit lalu Save dataset.

7. Buat Grafik Visualisasi dan Kontrol Kueri

   1. Mulailah analisis dengan membuat dashboard.

   2. Di halaman pengeditan dashboard, tambahkan Grafik Pie seperti yang digambarkan dalam gambar.

      

   3. Buat kontrol kueri seperti yang diilustrasikan.

      

   4. Lihat Efek

      Anda sekarang dapat memodifikasi kriteria rentang keuntungan dengan memasukkan nilai di kontrol kueri.

      

Skenario 5: Aktifkan akselerasi ekstraksi untuk dataset yang berisi acceleration placeholder

Deskripsi skenario

Anda dapat menambahkan acceleration placeholder ke kondisi WHERE pernyataan custom SQL dan mengatur ukuran partisi dalam pengaturan akselerasi. Hal ini memungkinkan ekstraksi data offline dinamis dan penulisan inkremental. Metode ini berguna jika tabel sumber berisi volume data besar, yang menyebabkan kueri custom SQL asli timeout dan mencegah Anda mengonfigurasi akselerasi ekstraksi.

Prosedur

1. Buat placeholder.

   Tambahkan acceleration placeholder ke kondisi WHERE pernyataan custom SQL Anda.

   Fokus pada logika kueri inti dan biarkan placeholder menangani filter waktu.

   

   Contoh: Tambahkan acceleration placeholder report_date ke kondisi WHERE: where $accel{report_date:report_date}.

2. Tetapkan nilai default kueri.

   Untuk memastikan SQL berjalan cepat selama pengeditan dan pratinjau, Anda dapat menetapkan nilai default untuk placeholder.

   Pada panel Placeholder Management dataset, tetapkan ekspresi lengkap sebagai nilai default untuk acceleration placeholder, seperti report_date < '2025-04-01'.

   

3. Konfigurasikan akselerasi ekstraksi.

   Setelah menyimpan dataset, Anda dapat mengonfigurasi extraction acceleration.

   1. Aktifkan Quick BI engine.

      

   2. Untuk Extraction Range, pilih Specify Date Range. Untuk Date Field, pilih field yang sesuai dengan acceleration placeholder, seperti report_date.

      

   3. Konfigurasikan rentang tanggal ekstraksi dan rentang inkremental. Lalu, simpan dan mulai tugas akselerasi.

4. Verifikasi kueri dan efek akselerasi

   1. Gunakan dataset untuk membuat grafik dan menjalankan kueri.

   2. Pada halaman Performance Diagnostics grafik, periksa Widget Loading Duration dan lihat apakah Acceleration Engine diaktifkan dalam Widget Loading Details untuk memastikan akselerasi berfungsi.