Tüm Ürünler
Search
Belge Merkezi

Quick BI:Özel SQL

Son Güncelleme:Oct 04, 2026

Karmaşık mantıklar veya modeller için özel SQL sorguları yazarak veri kümeleri oluşturun. Geçici sorgular, dinamik analiz senaryoları için parametre aktarımını da destekler.

Ön Koşullar

Bir veri kaynağına bağlanmış olmanız gerekir. Daha fazla bilgi için bkz. Veri kaynağına bağlanma.

Sınırlamalar

API veri kaynakları geçici sorguları desteklemez.

SQL kodunu girin

Aşağıdaki yöntemlerden birini kullanarak geçici bir sorgu oluşturabilirsiniz.

  1. Geçici sorgu sayfasına gidin.

    • Giriş Yolu 1: Data Sources sayfasında sağ üst köşede bulunan Create datasets in SQL seçeneğine tıklayın.image

    • Giriş Yolu 2: Veri kümesi düzenleyicisinin relational model tuvalinde bir veri kaynağı seçin. Tuvalde herhangi bir veri tablosu yoksa tuval üzerindeki Click to use SQL code to create a dataset veya sol paneldeki Create table with SQL code seçeneğine tıklayın.image

    • Giriş Yolu 3: Veri kümesi düzenleyicisinin physical modeling tuvalinde sol paneldeki Create table with SQL code seçeneğine tıklayın.

      image

  2. SQL kodunu girdikten sonra Run seçeneğine tıklayın.

    image

    Aşağıdaki kodda örnek bir SQL ifadesi gösterilmektedir:

    SELECT  report_date,
            or*******el,
            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 :or********er}

    Sorgu başarıyla çalıştıktan sonra sonuçları Result sekmesinde ön izleyebilirsiniz.image

  3. Geçici sorgudan oluşturulan veri kümesini kaydetmek için Create Dataset seçeneğine tıklayın.

SQL kodunu değiştirin

SQL kodunu üç farklı şekilde değiştirebilirsiniz:

  • Hedef tablonun sağındaki image simgesine tıklayın.image

  • Tuvaldeki hedef tabloya tıklayın. Alt kısımdaki Table Details bölümünde Edit SQL seçeneğine tıklayın.image

  • Hedef tablonun sağındaki image simgesine tıklayıp Edit SQL seçeneğini belirleyin.

    image

SQL sözdizimi

  • Geçici sorgular öncelikli olarak SELECT ifadelerini destekler. INSERT, UPDATE, DELETE ve saklı yordamlar desteklenmez.

  • Sorgu sözdizimi, veri kaynağınızın veritabanı sözdizimine uygun olmalıdır. Örneğin, MySQL veri kaynakları için MySQL sorgu sözdizimi kullanın. MongoDB'deki find() ve findone() gibi veritabanına özel sözdizimleri Quick BI tarafından desteklenmez. Geçici sorgularda veri sorgulamak için SELECT ifadelerini kullanın.

  • Geçici bir sorguya açıklama eklemek için -- Comment biçimini kullanın. İki tirenin (--) ardından bir boşluk bırakın.

    image

    Aşağıdaki kodda örnek bir SQL ifadesi gösterilmektedir:

    SELECT  area,  -- Area
            price  -- Price  
    from    company_sales_record
  • Geçici bir sorguda birden fazla tabloyu birleştiriyorsanız tablo takma adlarını ve sütun takma adlarını doğru kullandığınızdan emin olun. Takma ad sözdizimi veritabanlarına göre farklılık gösterebilir.

  • Geçici bir sorguda satır sınırı bulunmaz ancak sorgu 65.536 karakteri aşamaz. Gerekirse sorguyu bölün veya optimize edin ya da birden fazla veri kümesi oluşturup bunları birleştirin.

Not
  • Quick BI, veri kümesi SQL'ini yürütmek üzere veritabanına gönderir. Sorgu zaman aşımı süresi 5 dakikadır. 5 dakika içinde veri döndürülmezse zaman aşımı hatası oluşur.

  • Bir sorgu 5 dakikadan daha kısa bir sürede zaman aşımına uğruyorsa bunun nedeni SLB gibi ağ cihazlarınızda bir zaman aşımı ayarı olması veya sorgu isteğini engelleyen bir güvenlik duvarı ilkesi olabilir.

Yer Tutucular

Quick BI, SQL'de parametreleri iletmek için değer yer tutucuları ve ifade yer tutucuları olmak üzere iki tür yer tutucuyu destekler.

Tür

Açıklama

Kullanım durumları

Biçim

Değer yer tutucusu

Panodaki bir sorgu denetiminden tek bir değeri veya değer kümesini iletir.

Not

Tarih yer tutucuları için iletilen değerin biçimini kontrol etmek amacıyla belirli bir tarih biçimi seçmeniz gerekir.

Çoğu parametre aktarma senaryosu için uygundur.

'$val{placeholder_name}'

İfade yer tutucusu

Panodaki bir sorgu denetiminden bir koşulu iletir.

Kullanıcıların tüm filtre koşulunu SQL ifadesine ileterek panodaki filtreleme yöntemini değiştirmesine olanak tanır.

Örneğin aşağıdaki şekil gösterilen panoda kullanıcı koşulu Profit > 50 veya Profit < 50 olarak ayarlayabilir. İşleç dahil tüm koşulun SQL ifadesine iletilmesi gerekir.参数传参

$expr{physical_field_name:placeholder_name}

Yapılandırma

İş gereksinimlerinize göre SQL ifadenizi yazın ve yer tutucular ekleyin.

  1. SQL düzenleyici sayfasında Parameter Settings seçeneğine tıklayın.

    image

  2. Parameter Settings panelinde yer tutucuları yapılandırın ve OK seçeneğine tıklayın.

    image

    Yapılandırma öğeleri hakkında daha fazla bilgi için bkz. Veri kümesi oluşturma.

    Not

    Bir yer tutucu SELECT yan tümcesinde kullanılıyorsa bunun için genel bir varsayılan değer ayarlamanız gerekir.

    Örneğin, aşağıdaki kodda gösterildiği gibi bir veri kümesi oluştururken SELECT yan tümcesine profit_range adlı bir yer tutucu eklersiniz:

    SELECT report_date, order_level, shipping_type,price,order_number,area,
     case when profit_amt< ${profit_range} then 'Loss' 
     when profit_amt> ${profit_range} then 'Profit'
     else 'Break-even'
     end as 'Or*er Level'
    from company_sales_record
    where $expr{report_date :report_date}
    and $expr{order_level :order_level}
    and $expr{or**********************er}

    Varsayılan bir değer ayarlamazsanız sorgu çalıştırılamaz.

    image

    Parametre ayarlarında profit_range için varsayılan bir sorgu değeri ayarlamanız gerekir.

    image

    Varsayılan değeri ayarladıktan sonra sorgu başarıyla çalışır. Sonuç aşağıdaki şekilde gösterilmiştir:

    image

  3. Veri kümesini kaydetmek için Save seçeneğine tıklayın.image

  4. Üst menü çubuğunda image simgesine tıklayın veya image simgesine tıklayıp Create Dashboard seçeneğini belirleyin.

    image

  5. Pano düzenleyici sayfasında bir sorgu koşulu ekleyin ve bunu bir yer tutucuya bağlayın.

    Örneğin bir sorgu koşulu ayarlarken tekli seçim açılır listesini kullanarak area filtresi uygulayabilir ve tek bir değer iletmek için bunu bir değer yer tutucusuna bağlayabilirsiniz.image.png

    or********er üzerinde metin filtresi kullanın ve bir koşulu iletmek için bunu bir ifade yer tutucusuna bağlayın.image.png

  6. Panoda veri sorgularken sorgu denetimlerinden alınan değerler SQL kodunuzdaki ilgili yer tutuculara iletilir.

    Örneğin aşağıdaki şekilde bir panodaki sorgu koşulları gösterilmektedir.image.png

    İlgili SQL ifadesi aşağıdaki gibidir:

    SELECT * FROM company_sales_record
    WHERE area = 'North China' 
    AND order_number > 100

    Yer tutucu kullanım örneği:

    SELECT * FROM tablename
    WHERE area in ('$val{area_ph}') -- Text type, multi-select
    AND name = '$val{name_ph}' -- Text type, single-select
    AND number = $val{number_ph}  -- Numeric type
    AND report_date > '$val{report_date_ph.get(0)}' -- Date type, get the start date of the date range picker
    AND report_date < '$val{report_date_ph.get(1)}' -- Date type, get the end date of the date range picker

Yer tutucu kullanım durumları hakkında daha fazla bilgi için bkz. Yer Tutucular.

Not

Geriye dönük uyumluluk:

Değer yer tutucuları için eski biçim (eskiden yer tutucular): ${placeholder_name}

İfade yer tutucuları için eski biçim (eskiden parametreler): ${physical_field_name:parameter_name}