Direct Query komut dosyası değişkenleri
Bir Direct Query uygulamasının dahili yapısını açıklamak ve işlemek ya da ek yeniden yükleme çıktısı bilgilerini etkinleştirmek için komut dosyası değişkenlerini kullanabilirsiniz.
Her bir değişkenin kısa açıklamasını ve söz dizimini görmek için açılır menüyü kullanın.
Bu değişken, bir uygulamanın önbelleğe alınmış bir sorgu sonucunun ne kadar süre sonra eski kabul edileceğini belirtmesine olanak tanır.
Süre, sonucun ilk kez önbelleğe alındığı andan itibaren tanımlanır. Önbelleğe alınan bir sonucun süresi n saniyeye eşit veya daha büyükse eski kabul edilir ve eşleşen bir sorgu için önbelleğe alınmış sonuç olarak kullanılmaz. Bunun yerine, söz konusu sorgu önbelleğe alınmış hiçbir sonuç yokmuş gibi yürütülür.
Sorgu tekrar yürütüldüğünde, geçerli önbellek ve bellek durumuna bağlı olarak yeni sonucu önbelleğe alınabilir. Önbelleğe alınırsa n saniyede eski hale gelene kadar süresi yeniden işlemeye başlar.
Bu değişken için varsayılan değer 30'dur. Bu, önbelleğe alınan sorgu sonucunun 30 saniye sonra eski kabul edildiği anlamına gelir.
| Değer | Açıklama |
|---|---|
| -1 |
Bu ayar, önbelleğin kullanıcının oturum açtığı süre boyunca tutulacağı anlamına gelir. |
| 0 |
Önbelleğe alma tamamen devre dışı bırakılır. |
| 1-9,223,372,036,854,775,807 | Önbelleğe alınan sonucun eskime süresini saniye cinsinden ayarlar. |
| > 9,223,372,036,854,775,807 | Değişkeni 30 olarak ayarlamakla aynıdır. |
DirectQueryResultCacheExpirySeconds=n;
Direct Query ile çoğu grafik için alınan maksimum satır sayısı varsayılan değeri, istemci sorgusu tarafından belirlenir ve 256 ile 1000 arasında değişebilir. İstisna, varsayılan maksimum değerin 2500 olarak sabitlendiği dağılım grafikleridir. Bu, Direct Query tarafından desteklenen bazı grafiklerin, grafiğin içeriğine yönelik sınırsız bir SQL sorgusu n satırdan fazlasıyla sonuçlanacak olsa bile n satırdan fazla sonuç göstermeyeceği anlamına gelir.
DirectQueryRowFetchMaxCount komut dosyası değişkeni, bir tablo grafiğinde görüntülenecek maksimum satır sayısını artırmaya veya sınırlamaya ya da bir dağılım grafiğinde görüntülenen maksimum sonuçları varsayılan maksimum değer olan 2500'den daha azıyla kısıtlamaya olanak tanımak için vardır.
Ayrıca, DirectQueryRowFetchMaxCount için aşağıdaki hususlar geçerlidir:
-
DirectQueryRowFetchMaxCount varsayılan değeri -1'dir (kullanılmadığı anlamına gelir).
-
DirectQueryRowFetchMaxCount komut dosyası değişkenini 0'dan büyük belirli bir değere ayarlamak, bir tablo grafiğini dolduran sorgunun veritabanından aşağıdaki tabloda gösterilen maksimum değerlere kadar DirectQueryRowFetchMaxCount satır çekmesine olanak tanır.
-
Eğer DirectQueryRowFetchMaxCount değeri 0 ile 2500 arasında olacak şekilde yapılandırılırsa DirectQueryRowFetchMaxCount değeri, bir dağılım grafiğini doldurmak için alınan maksimum veri satırını sınırlamak için de kullanılır.
-
DirectQueryRowFetchMaxCount komut dosyası değişkeninin etkilerini geri almak için değişken tanımsız bırakılabilir veya açıkça -1 değerine ayarlanabilir.
| Değer | Açıklama |
|---|---|
| 0 |
0 değeri, yalnızca tablo grafiği satır çekme işlemini etkileyen özel bir değerdir. Bu ayar, bir tablo grafiğini doldurmak için tüm geçerli satırlar (seçimlerden etkilenen) üzerinde dinamik olarak sayfalama yapar. Sayfalama için toplam maksimum satır sayısının belirlenmesi, uzak veritabanının tablonun doldurma sorgusu için toplamda kaç satır döndüreceğini belirlemek üzere bir ilk sayım sorgusu gerçekleştirilerek yapılır. Bu değişkenin 0 olarak ayarlanması, desteklenen diğer tüm Direct Query grafiklerinin (tablolar ve dağılım grafikleri hariç) istemci tarafından belirtilen varsayılan maksimum satır sayısını çekmesiyle sonuçlanır. Dağılım grafikleri varsayılan maksimum değer olan 2500 satırı çeker. Bilgi notuBu işlem, her yükleme veya seçim için bir yerine iki sorgu gerçekleştirdiğinden, veritabanı performansı ve maliyetleri açısından daha pahalı olabilir.
|
| 1-100,000 | Uzak veritabanından bir tablo veya dağılım grafiği için çekilecek maksimum satır sayısını ayarlar. Bir Dağılım grafiğinin görüntülemek için asla 2500'den fazla satır almayacağını unutmayın. |
| > 100,000 | Değişkeni 0 olarak ayarlamakla aynı etkiye sahiptir. |
DirectQueryRowFetchMaxCount=n;
Bu değişkenin varsayılan değeri 0'dır.
Bu değişkeni > 0 değerine ayarlamak, bir Direct Query uygulaması Verileri yükle (yeniden yükleme) eyleminin çıktısına ek bilgilerin dahil edilmesini sağlar.
Ek bilgiler, bir tablonun özel SQL tanımının sonucunu önizlemek için uzak veritabanına gönderilen SQL sorgusunu gösterir. Bu bilgiler, özel SQL ifadesi sonuç beklentilerini doğrulamak, değerlendirmek veya iyileştirmek için yararlı olabilir. İlgili bilgiler için DirectQueryPreviewResp değişkenine bakın.
DirectQueryPreviewSql=1;
Bu değişkenin varsayılan değeri 0'dır.
Bu değişkeni > 0 değerine ayarlamak, bir Direct Query uygulaması Verileri yükle (yeniden yükleme) eyleminin çıktısına ek bilgilerin dahil edilmesini sağlar.
Ek bilgiler, bir tablonun özel SQL tanımıyla ilgili olarak uzak veritabanına gönderilen bir SQL sorgusunun sonuçlarını gösterir. İlgili bilgiler için DirectQueryPreviewSql değişkenine bakın.
DirectQueryPreviewResp=1;