İstek özellikleri

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini

İstek özellikleri, sorgu veya komutun nasıl yürütüldüğü ve sonuçları nasıl döndürdüğü denetler.

Desteklenen istek özellikleri

Aşağıdaki tabloda desteklenen istek özelliklerine genel bakış sunulmaktadır.

Not

query_weakconsistency_session_id ve queryconsistency istek özellikleri Doku'da kullanılamaz.

Özellik adı Türü Açıklama
best_effort bool olarak ayarlanırsa true, veri kaynaklarının (birleşim bacakları) belirsiz çözümleme ve bağlantı sorunlarına izin verir. Birleşim kaynakları kümesi, var olan ve yürütme sırasında erişilebilir olan tablo başvuruları kümesine indirilir. En az bir erişilebilir tablo bulunursa sorgu yürütülür. Herhangi bir hata, sorgu durumu sonuçlarında bir uyarı verir, ancak sorgunun yürütülmesini engellemez.
client_max_redirect_count long İstemcinin işleme sırasında izlediği en fazla HTTP yeniden yönlendirme sayısını denetler.
client_results_reader_allow_varying_row_widths bool olarak ayarlanırsa true, sonuç okuyucu satır genişliği satırlar arasında değişen tabloları tolere eder.
deferpartialqueryfailures bool olarak ayarlanırsa true, sonuç kümesi içindeki kısmi sorgu hatalarının bildirmesini gizler.
materialized_view_shuffle_query dynamic Sorguda başvuruda bulunılan gerçekleştirilmiş görünümler için karıştırma stratejisini kullanmak için bir ipucu sağlar. Bu özellik yalnızca gerçekleştirilmiş görünümleri etkiler ve sorgu içindeki birleşimler gibi sonraki işlemleri etkilemez. Bir dizi gerçekleştirilmiş görünüm adını ve karşılık gelen karıştırma anahtarlarını alır.

Örneğin, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) görünümü tuşlara V1 ve K1K2 değerlerine göre karıştırırkendynamic([ { "Name": "V1" } ]), görünümü V1 tüm tuşlara göre karıştırır.
max_memory_consumption_per_query_per_node long Bir sorgunun düğüm başına ayırabileceği varsayılan maksimum bellek miktarını geçersiz kılar.
maxmemoryconsumptionperiterator long Sorgu işlecinin ayırabileceği varsayılan en fazla bellek miktarını geçersiz kılar.
maxoutputcolumns long Bir sorgunun üretmesine izin verilen varsayılan en fazla sütun sayısını geçersiz kılar.
norequesttimeout bool İstek zaman aşımını en yüksek değerine ayarlar. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
notruncation bool Çağırana döndürülen sorgu sonuçlarının kesilmesini devre dışı bırakır.
push_selection_through_aggregation bool olarak ayarlanırsa true, toplama yoluyla basit seçim göndermeye izin verir.
query_bin_auto_at değişmez değer bin_auto() işlevini değerlendirirken kullanılacak başlangıç değerini belirtir.
query_bin_auto_size değişmez değer bin_auto() işlevini değerlendirirken kullanılacak bölme boyutu değerini belirtir.
query_cursor_after_default string parametresiz çağrıldığında cursor_after() işlevi için varsayılan parametre değerini ayarlar.
query_cursor_before_or_at_default string parametresiz çağrıldığında cursor_before_or_at() işlevi için varsayılan parametre değerini ayarlar.
query_cursor_current string cursor_current() işlevi tarafından döndürülen imleç değerini geçersiz kılar.
query_cursor_disabled bool Sorgu bağlamında imleç işlevlerinin kullanımını devre dışı bırakır.
query_cursor_scoped_tables dynamic Kapsamı .. olarak belirlenmiş cursor_after_default tablo adlarını listeler. cursor_before_or_at() (üst sınır isteğe bağlıdır).
query_datascope string Sorgunun uygulandığı verileri denetler. Desteklenen değerler , defaultveya all'dırhotcache.
query_datetimescope_column string Sorgunun tarih saat kapsamıquery_datetimescope_to / query_datetimescope_from () için sütun adını belirtir.
query_datetimescope_from datetime Sorgu kapsamı için en düşük tarih ve saat sınırını ayarlar. Tanımlanırsa, üzerinde query_datetimescope_columnotomatik olarak uygulanan bir filtre görevi görür.
query_datetimescope_to datetime Sorgu kapsamı için en yüksek tarih ve saat sınırını ayarlar. Tanımlanırsa, üzerinde query_datetimescope_columnotomatik olarak uygulanan bir filtre görevi görür.
query_distribution_nodes_span int Alt sorgu birleştirme davranışını denetler. Yürütülen düğüm, her alt düğüm grubu için sorgu hiyerarşisinde ek bir düzey getirir ve bu seçenek alt grup boyutunu ayarlar.
query_fanout_nodes_percent int Fan-out yürütme düğümlerinin yüzdesini belirtir.
query_fanout_threads_percent int Fan-out yürütmek için iş parçacıklarının yüzdesini belirtir.
query_force_row_level_security bool olarak ayarlanırsatrue, ilke devre dışı bırakılıyor olsa bile satır düzeyi güvenlik kurallarını zorlar.
query_language string Sorgu metninin nasıl yorumlanması gerektiğini belirler. Desteklenen değerler , cslveya kql'dırsql. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
query_log_query_parameters bool .show queries günlüğünde daha sonra görüntülemek için sorgu parametrelerini günlüğe kaydetmeyi etkinleştirir. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
query_max_entities_in_union long Bir sorgunun üretmesine izin verilen varsayılan en fazla sütun sayısını geçersiz kılar.
query_now datetime now() işlevi tarafından döndürülen datetime değerini geçersiz kılar.
query_optimize_fts_at_relop bool olarak trueayarlandığında, yüksek maliyetli serbest metin arama işlemleri gerçekleştiren sorgular için deneysel bir iyileştirme sağlar. Örneğin, \|where * has "pattern".
query_python_debug bool veya int olarak trueayarlanırsa, numaralandırılmış Python düğümü için bir Python hata ayıklama sorgusu oluşturur.
query_results_apply_getschema bool olarak trueayarlanırsa, verilerin kendisi yerine sorgu sonuçlarındaki her tablosal verilerin şemasını alır.
query_results_cache_force_refresh bool olarak ayarlanırsa true, belirli bir sorgu için sorgu sonuçlarının önbellek yenilemesini zorlar. ile query_results_cache_max_agebirlikte kullanılmalıdır ve küme deyimi olarak değil Kusto Data ClientRequestProperties sınıfı aracılığıyla gönderilmelidir.
query_results_cache_max_age timespan Hizmetin döndürmesine izin verilen önbelleğe alınmış sorgu sonuçlarının yaş üst sınırını denetler.
query_results_cache_per_shard bool olarak trueayarlanırsa, kapsam başına sorgu önbelleğe almayı etkinleştirir.
query_results_progressive_row_count long Her güncelleştirmede kaç kayıt gönderebileceğine ilişkin bir ipucu sağlar. Yalnızca ayarlandıysa results_progressive_enabled geçerlilik kazanır.
query_results_progressive_update_period timespan İlerleme çerçevesi gönderme sıklıkları hakkında bir ipucu sağlar. Yalnızca ayarlandıysa results_progressive_enabled geçerlilik kazanır.
query_take_max_records long Sorgu sonuçlarını belirtilen sayıda kayıtla sınırlar.
query_weakconsistency_session_id string Sorgu zayıf tutarlılığı oturum kimliğini ayarlar. Mod olarak ayarlandığında queryconsistencygeçerlilik weakconsistency_by_session_id kazanır. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
queryconsistency string Sorgu tutarlılığını denetler. Desteklenen değerler : strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseveya weakconsistency_by_session_id. kullanırken weakconsistency_by_session_idözelliğini de ayarladığınızdan query_weakconsistency_session_id emin olun. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
request_app_name string Raporlamada kullanılacak istek uygulaması adını belirtir. Örneğin, .show sorguları. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
request_block_row_level_security bool olarak trueayarlanırsa, satır düzeyi güvenlik ilkesinin etkinleştirildiği tablolara erişimi engeller.
request_callout_disabled bool olarak ayarlanırsa true, kullanıcı tarafından sağlanan bir hizmete istek belirtme çizgisi yapılmasını engeller.
request_description string İstek açıklaması olarak rastgele metin eklenmesine izin verir.
request_external_data_disabled bool olarak trueayarlanırsa, isteğin externaldata işlecini veya dış tabloları kullanarak dış verilere erişmesini engeller.
request_external_table_disabled bool olarak ayarlanırsa true, isteğin dış tablolara erişmesini engeller.
request_impersonation_disabled bool olarak trueayarlanırsa, hizmetin çağıranın kimliğini kullanarak kümeler arası sorgular da dahil olmak üzere çağıran adına aşağı akış hizmetlerine erişmesini engeller.
request_readonly bool olarak ayarlanırsa true, istek için yazma erişimini engeller. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
request_readonly_hardline bool olarak ayarlanırsa true, istek katı bir salt okunur modda çalışır. İstek hiçbir şey yazamaz ve eklentiler gibi uyumsuz işlevler devre dışı bırakılır. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
request_remote_entities_disabled bool olarak ayarlanırsa true, isteğin uzak veritabanlarına ve uzak varlıklara erişmesini engeller.
request_sandboxed_execution_disabled bool olarak trueayarlanırsa, isteğin korumalı alanda kod çağırmasını engeller.
request_user string İstekte bulunulmakta olan kullanıcının serbest metin, arayan tarafından sağlanan tanımlayıcısı. Yalnızca bağıntı için hizmet tarafı tanılama izlemelerinde yakalanır. .show sorguları sütununu Userdoldurmaz (bu sütun her zaman kimliği doğrulanmış sorumluyu yansıtır) ve istemci isteği özelliklerinin ortaya çıkarıldığı her yerde yeniden uygulanır (olarak ******gösterilir). içinde görünür .show queriesolması gereken veya istek sınıflandırma ilkesi tarafından kullanılması gereken çağıran bağlamını geçirmek için kullanın request_description . Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
results_error_reporting_placement string Sonuç kümesindeki hataların yerleşimini belirler. Seçenekler : in_data, end_of_tableve end_of_dataset.
results_progressive_enabled bool olarak ayarlanırsa true, aşamalı sorgu akışını etkinleştirir. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
results_v2_fragment_primary_tables bool Birincil tabloların, her biri satırların bir alt kümesini içeren birden çok parça halinde gönderilmesine neden olur. Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
results_v2_newlines_between_frames bool Ayrıştırmayı kolaylaştırmak için sonuçlardaki çerçevelerin arasına yeni çizgiler ekler.
servertimeout timespan Varsayılan istek zaman aşımını geçersiz kılar. Bu seçenek bir set deyiminin parçası olarak değiştirilemez. Bunun yerine, pano ayarlarını kullanarak seçeneği değiştirin.
truncationmaxrecords long Bir sorgunun arayana döndürmesine izin verilen varsayılan kayıt sayısı üst sınırını geçersiz kılar (kesme).
truncationmaxsize long Bir sorgunun arayana döndürmesine izin verilen varsayılan maksimum veri boyutunu geçersiz kılar (kesme). Bu seçenek bir set deyiminin parçası olarak değiştirilemez.
validatepermissions bool Kullanıcının sorguyu gerçekten çalıştırmadan gerçekleştirme izinlerini doğrular. Bu özelliğin olası sonuçları şunlardır: OK (izinler var ve geçerli), Incomplete (dinamik şema değerlendirmesi nedeniyle doğrulama tamamlanamadı) veya KustoRequestDeniedException (izinler ayarlanmadı).

İstek özelliklerini ayarlama

İstek özelliklerini aşağıdaki yollarla ayarlayabilirsiniz:

Not

Aşağıdaki istek özellikleri set deyimiyle ayarlanamaz:

  • norequesttimeout
  • queryconsistency
  • query_language
  • query_log_query_parameters
  • query_weakconsistency_session_id
  • request_app_name
  • request_readonly
  • request_readonly_hardline
  • request_user
  • results_progressive_enabled
  • results_v2_fragment_primary_tables
  • servertimeout
  • truncationmaxsize

Not

İlgili içerik

  • Last updated on