SQL sorgularında parametreleri kullanma

Bu makalede, Genie alanında örnek SQL yönergeleri yazarken parametrelerin nasıl kullanılacağı açıklanmaktadır.

Parametreler neden kullanılır?

Parametreler, çalışma zamanında değiştirilecek belirli değerlerin yer tutucularıyla örnek sorgular yazmanızı sağlar. Parametrelerle Genie, kullanıcı sorularından belirli girişleri alabilir ve güvenilir varlıklar olarak doğrulanmış yanıtlar sağlamak için örnek bir sorgunun yapısını yeniden kullanabilir. Örneğin, önceki SQL sorgusunu o.forecastcategory değerine göre filtreleyen bir parametre içerecek şekilde ayarlayabilir ve sorgunun farklı tahmin kategorilerinde etiketlenen fırsatlar hakkındaki soruları ele almasını sağlayabilirsiniz. Güvenilir varlıklar olarak etiketlenmiş yanıtlar oluşturmak için parametreli sorguları kullanma hakkında daha fazla bilgi için bkz. AI/BI Genie alanlarında güvenilen varlıkları kullanma.

Aşağıdaki örnek sorgu, bölgeye göre toplam açık işlem hattı değeri satış fırsatlarını hesaplar. o.forecastcategory değeri için bir parametre içerir. Parametreler, adlandırılmış parametre işaretçileriyle aynı söz dizimini kullanır. Genie alanında parametreleri kullanma hakkında daha fazla kılavuz için bkz. Sorgu parametreleri ile çalışma ve Adlandırılmış parametre işaretçileri.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Sorguya parametre eklemek için:

1. İmlecinizi parametreyi sorgunuza yerleştirmek istediğiniz yere getirin.

2. Yeni bir parametre eklemek için Add parameter'e tıklayın.

   Bu, parametervarsayılan adıyla yeni bir parametre oluşturur. Varsayılan adı değiştirmek için sorgu düzenleyicisinde değiştirin. Ayrıca düzenleyiciye iki nokta ve ardından bir parametre adı (:parameter_name) yazarak da parametre ekleyebilirsiniz.

Sorgu parametresini düzenleme

Parametreyi düzenlemek için aşağıdakileri yapın:

1. Parametre adının yanındaki tıklayın. Parametre ayrıntıları iletişim kutusu görüntülenir ve aşağıdaki yapılandırma seçeneklerini içerir:

   • Anahtar Sözcük: Sorgudaki parametreyi temsil eden anahtar sözcük. Anahtar sözcüğü yalnızca sorgudaki metin doğrudan güncelleştirilerek değiştirilebilir.

   • Görünen ad: Genie'nin sohbet deneyiminde kullandığı okunabilir ad. Genie parametreli bir sorgu kullanarak bir yanıt oluşturduğunda, yanıtta görüntü adı ve ilişkili değer yer alır.

   • Tür: Desteklenen türler arasında String, Date, Date and Timeve Numericbulunur.

     • Varsayılan tür, String.
     • Sayısal veri türü, Ondalık ile Tamsayıarasında belirtmenize olanak tanır. Varsayılan sayısal tür ondalık.

     Uyarı

     Gerçek giriş değeri seçilen parametre türüyle eşleşmiyorsa Genie, giriş değerini yanlış tür olarak değerlendirir ve bu da yanlış sonuçlara yol açabilir.

2. İletişim kutusunu kapatmak için kullanıcı arabiriminin başka bir bölümüne tıklayın.

Parametreli sorgu yanıtları

Yanıtta bir parametrenin tam metni kullanıldığında yanıt güvenilir olarak işaretlenir. Bu, Genie'nin ortamın bağlamına dayanarak kullanıcının sorusunun örnek bir soru veya sorgunun amacıyla eşleştiği anlamına gelir.

Güvenilen etiketi, alan kullanıcılarının Genie'nin yanıtının onaylanmış bir SQL sorgusuna dayandığını bilmelerini sağlar. Yanıtta kullanılan oluşturulan SQL ve parametre değerlerini görebilirler.