Properti permintaan

Beralih layanan menggunakan daftar drop-down Versi . Pelajari selengkapnya tentang navigasi.
Berlaku untuk: ✅ Microsoft Fabric ✅ Azure Data Explorer

Properti permintaan mengontrol cara kueri atau perintah menjalankan dan mengembalikan hasil.

Properti permintaan yang didukung

Tabel berikut ini gambaran umum properti permintaan yang didukung.

Catatan

Properti permintaan query_weakconsistency_session_id dan queryconsistency tidak tersedia di Fabric.

Nama properti	Tipe	Deskripsi
best_effort	bool	Jika diatur ke true, memungkinkan resolusi fuzzy dan masalah konektivitas sumber data (union legs.) Kumpulan sumber gabungan dikurangi ke kumpulan referensi tabel yang ada dan dapat diakses pada saat eksekusi. Jika setidaknya satu tabel yang dapat diakses ditemukan, kueri akan dijalankan. Kegagalan apa pun menghasilkan peringatan dalam hasil status kueri tetapi tidak mencegah kueri dijalankan.
client_max_redirect_count	long	Mengontrol jumlah maksimum pengalihan HTTP yang diikuti klien selama pemrosesan.
client_results_reader_allow_varying_row_widths	bool	Jika diatur ke true, pembaca hasil mentolerir tabel yang lebar barisnya bervariasi di seluruh baris.
deferpartialqueryfailures	bool	Jika diatur ke true, menekan pelaporan kegagalan kueri parsial dalam tataan hasil.
materialized_view_shuffle_query	dynamic	Memberikan petunjuk untuk menggunakan strategi acak untuk tampilan materialisasi yang dirujuk dalam kueri. Properti ini secara eksklusif berdampak pada tampilan materialisasi dan bukan operasi berikutnya, seperti gabungan, dalam kueri. Dibutuhkan array nama tampilan materialisasi dan kunci acak yang sesuai. Misalnya, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) menunjukkan tampilan V1 acak menurut kunci K1 dan K2, sementara dynamic([ { "Name": "V1" } ]) acak tampilan V1 oleh semua kunci.
max_memory_consumption_per_query_per_node	long	Mengambil alih jumlah maksimum default yang dapat dialokasikan kueri per simpul.
maxmemoryconsumptionperiterator	long	Mengambil alih jumlah maksimum default yang dapat dialokasikan operator kueri.
maxoutputcolumns	long	Mengambil alih jumlah maksimum default kolom yang diizinkan untuk dihasilkan kueri.
norequesttimeout	bool	Mengatur batas waktu permintaan ke nilai maksimumnya. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
notruncation	bool	Menonaktifkan pemotongan hasil kueri yang dikembalikan ke pemanggil.
push_selection_through_aggregation	bool	Jika diatur ke true, memungkinkan pendorongan pilihan sederhana melalui agregasi.
query_bin_auto_at	harfiah	Menentukan nilai awal yang akan digunakan saat mengevaluasi fungsi bin_auto().
query_bin_auto_size	harfiah	Menentukan nilai ukuran bin yang akan digunakan saat mengevaluasi fungsi bin_auto().
query_cursor_after_default	string	Mengatur nilai parameter default untuk fungsi cursor_after() saat dipanggil tanpa parameter.
query_cursor_before_or_at_default	string	Mengatur nilai parameter default untuk fungsi cursor_before_or_at() saat dipanggil tanpa parameter.
query_cursor_current	string	Mengambil alih nilai kursor yang dikembalikan oleh fungsi cursor_current().
query_cursor_disabled	bool	Menonaktifkan penggunaan fungsi kursor dalam konteks kueri.
query_cursor_scoped_tables	dynamic	Mencantumkan nama tabel yang akan dilingkup ke cursor_after_default .. cursor_before_or_at() (batas atas bersifat opsional).
query_datascope	string	Mengontrol data tempat kueri diterapkan. Nilai yang didukung adalah default, all, atau hotcache.
query_datetimescope_column	string	Menentukan nama kolom untuk cakupan tanggalwaktu kueri (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from	datetime	Mengatur batas tanggal dan waktu minimum untuk cakupan kueri. Jika didefinisikan, ini berfungsi sebagai filter yang diterapkan secara otomatis pada query_datetimescope_column.
query_datetimescope_to	datetime	Mengatur batas tanggal dan waktu maksimum untuk cakupan kueri. Jika didefinisikan, ini berfungsi sebagai filter yang diterapkan secara otomatis pada query_datetimescope_column.
query_distribution_nodes_span	int	Mengontrol perilaku penggabungan subkueri. Simpul yang dieksekusi memperkenalkan tingkat tambahan dalam hierarki kueri untuk setiap subgrup simpul, dan opsi ini mengatur ukuran subgrup.
query_fanout_nodes_percent	int	Menentukan persentase simpul untuk mengeksekusi fan-out.
query_fanout_threads_percent	int	Menentukan persentase utas untuk mengeksekusi fan-out.
query_force_row_level_security	bool	Jika diatur ke true, memberlakukan aturan keamanan tingkat baris, meskipun kebijakan dinonaktifkan.
query_language	string	Menentukan bagaimana teks kueri harus ditafsirkan. Nilai yang didukung adalah csl, kql, atau sql. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
query_log_query_parameters	bool	Mengaktifkan pengelogan parameter kueri untuk ditampilkan nanti di jurnal kueri .show. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
query_max_entities_in_union	long	Mengambil alih jumlah maksimum default kolom yang diizinkan untuk dihasilkan kueri.
query_now	datetime	Mengambil alih nilai datetime yang dikembalikan oleh fungsi now().
query_optimize_fts_at_relop	bool	Saat diatur ke true, memungkinkan pengoptimalan eksperimental untuk kueri yang melakukan operasi pencarian teks bebas biaya. Contohnya, \|where * has "pattern".
query_python_debug	bool atau int	Jika diatur ke true, menghasilkan kueri debug Python untuk simpul Python yang dijumlahkan.
query_results_apply_getschema	bool	Jika diatur ke true, mengambil skema setiap data tabular dalam hasil kueri alih-alih data itu sendiri.
query_results_cache_force_refresh	bool	Jika diatur ke true, memaksa refresh cache hasil kueri untuk kueri tertentu. Harus digunakan dalam kombinasi dengan query_results_cache_max_age, dan dikirim melalui kelas Kusto Data ClientRequestProperties, bukan sebagai pernyataan yang ditetapkan.
query_results_cache_max_age	timespan	Mengontrol usia maksimum hasil kueri yang di-cache yang diizinkan untuk dikembalikan oleh layanan.
query_results_cache_per_shard	bool	Jika diatur ke true, memungkinkan penembolokan kueri per tingkat .
query_results_progressive_row_count	long	Memberikan petunjuk berapa banyak rekaman yang akan dikirim di setiap pembaruan. Berlaku hanya jika results_progressive_enabled diatur.
query_results_progressive_update_period	timespan	Memberikan petunjuk tentang seberapa sering mengirim bingkai kemajuan. Berlaku hanya jika results_progressive_enabled diatur.
query_take_max_records	long	Membatasi hasil kueri ke jumlah rekaman tertentu.
query_weakconsistency_session_id	string	Mengatur ID sesi konsistensi lemah kueri. Berlaku ketika queryconsistency mode diatur ke weakconsistency_by_session_id. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
queryconsistency	string	Mengontrol konsistensi kueri. Nilai yang didukung adalah strongconsistency, , weakconsistencyweakconsistency_by_query, weakconsistency_by_database, atau weakconsistency_by_session_id. Saat menggunakan weakconsistency_by_session_id, pastikan untuk juga mengatur query_weakconsistency_session_id properti . Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
request_app_name	string	Menentukan nama aplikasi permintaan yang akan digunakan dalam pelaporan. Misalnya, kueri .show. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
request_block_row_level_security	bool	Jika diatur ke true, memblokir akses ke tabel dengan kebijakan keamanan tingkat baris diaktifkan.
request_callout_disabled	bool	Jika diatur ke true, mencegah panggilan permintaan ke layanan yang disediakan pengguna.
request_description	string	Memungkinkan penyertaan teks arbitrer sebagai deskripsi permintaan.
request_external_data_disabled	bool	Jika diatur ke true, mencegah permintaan mengakses data eksternal menggunakan operator externaldata atau tabel eksternal.
request_external_table_disabled	bool	Jika diatur ke true, mencegah permintaan mengakses tabel eksternal.
request_impersonation_disabled	bool	Jika diatur ke true, mencegah layanan menggunakan identitas penelepon untuk mengakses layanan hilir atas nama pemanggil, termasuk kueri lintas kluster.
request_readonly	bool	Jika diatur ke true, mencegah akses tulis untuk permintaan. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
request_readonly_hardline	bool	Jika diatur ke true, maka permintaan beroperasi dalam mode baca-saja yang ketat. Permintaan tidak dapat menulis apa pun, dan fungsionalitas yang tidak patuh, seperti plugin, dinonaktifkan. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
request_remote_entities_disabled	bool	Jika diatur ke true, mencegah permintaan mengakses database jarak jauh dan entitas jarak jauh.
request_sandboxed_execution_disabled	bool	Jika diatur ke true, mencegah permintaan memanggil kode di kotak pasir.
request_user	string	Pengidentifikasi pengguna yang disediakan pemanggil teks bebas atas nama permintaan sedang dibuat. Ini diambil dalam jejak diagnostik sisi layanan hanya untuk korelasi. Ini tidak mengisi User kolom kueri .show (kolom tersebut selalu mencerminkan prinsipal yang diautentikasi), dan diredaksi (ditampilkan sebagai ******) di mana pun properti permintaan klien muncul. Untuk meneruskan konteks pemanggil yang harus terlihat di .show queries, atau yang harus digunakan oleh kebijakan klasifikasi permintaan, gunakan request_description sebagai gantinya. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
results_error_reporting_placement	string	Menentukan penempatan kesalahan dalam tataan hasil. Opsinya adalah in_data, end_of_table, dan end_of_dataset.
results_progressive_enabled	bool	Jika diatur ke true, memungkinkan aliran kueri progresif. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
results_v2_fragment_primary_tables	bool	Menyebabkan tabel utama dikirim dalam beberapa fragmen, masing-masing berisi subset baris. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
results_v2_newlines_between_frames	bool	Menambahkan baris baru di antara bingkai dalam hasil, untuk mempermudah penguraiannya.
servertimeout	timespan	Mengambil alih batas waktu permintaan default. Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan. Sebagai gantinya, ubah opsi menggunakan pengaturan dasbor.
truncationmaxrecords	long	Mengambil alih jumlah maksimum default rekaman yang diizinkan kueri untuk kembali ke pemanggil (pemotongan).
truncationmaxsize	long	Mengambil alih ukuran data maksimum default yang diizinkan kueri untuk kembali ke pemanggil (pemotongan). Opsi ini tidak dapat dimodifikasi sebagai bagian dari pernyataan yang ditetapkan.
validatepermissions	bool	Memvalidasi izin pengguna untuk melakukan kueri tanpa benar-benar menjalankan kueri. Kemungkinan hasil untuk properti ini adalah: OK (izin ada dan valid), Incomplete (validasi tidak dapat diselesaikan karena evaluasi skema dinamis), atau KustoRequestDeniedException (izin tidak ditetapkan).

Cara mengatur properti permintaan

Anda dapat mengatur properti permintaan dengan cara berikut:

• Isi POST permintaan HTTP
• Pernyataan set Bahasa Kueri Kusto
• Metode opsi yang ditetapkan dari ClientRequestProperties kelas

Catatan

Properti permintaan berikut tidak dapat diatur dengan pernyataan yang ditetapkan:

• 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

Konten terkait

• Menyesuaikan perilaku kueri dengan properti permintaan klien