Freigeben über

Anforderungseigenschaften

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

Anforderungseigenschaften steuern, wie eine Abfrage oder ein Befehl ausgeführt wird und Ergebnisse zurückgibt.

Unterstützte Anforderungseigenschaften

Die folgende Tabelle enthält eine Übersicht über die unterstützten Anforderungseigenschaften.

Hinweis

Die Anforderungseigenschaften query_weakconsistency_session_id und queryconsistency sind in Fabic nicht verfügbar.

Eigenschaftenname Type Beschreibung
best_effort bool Wenn dieser Parameter festgelegt ist true, können Fuzzy-Auflösungs- und Konnektivitätsprobleme von Datenquellen (Union-Beine) zulässig sein. Der Satz von Union-Quellen wird auf den Satz von Tabellenverweisen reduziert, die vorhanden sind und zum Zeitpunkt der Ausführung zugänglich sind. Wenn mindestens eine barrierefreie Tabelle gefunden wird, wird die Abfrage ausgeführt. Jeder Fehler gibt eine Warnung in den Abfragestatusergebnissen zurück, verhindert jedoch nicht, dass die Abfrage ausgeführt wird.
client_max_redirect_count long Steuert die maximale Anzahl von HTTP-Umleitungen, die der Client während der Verarbeitung folgt.
client_results_reader_allow_varying_row_widths bool Wenn diese Einstellung truefestgelegt ist, toleriert der Ergebnisleser Tabellen, deren Zeilenbreite sich je nach Zeilen unterscheidet.
deferpartialqueryfailures bool Bei Festlegung auf true, unterdrückt die Berichterstellung von Teilweisen Abfragefehlern innerhalb des Resultsets.
materialized_view_shuffle_query dynamic Stellt einen Hinweis bereit, die Shuffle-Strategie für referenzierte materialisierte Ansichten in der Abfrage zu verwenden. Diese Eigenschaft wirkt sich ausschließlich auf materialisierte Ansichten und keine nachfolgenden Vorgänge wie Verknüpfungen innerhalb der Abfrage aus. Es verwendet ein Array materialisierter Ansichtsnamen und der entsprechenden Shuffle-Tasten.

Gibt z. B dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) . die Ansicht V1 nach Tasten K1 und K2,, während die dynamic([ { "Name": "V1" } ]) Ansicht V1 durch alle Tasten neu sortiert wird.
max_memory_consumption_per_query_per_node long Überschreibt die standardmäßige maximale Speichermenge, die eine Abfrage pro Knoten zuordnen kann.
maxmemoryconsumptionperiterator long Überschreibt die standardmäßige maximale Speichermenge, die ein Abfrageoperator zuordnen kann.
maxoutputcolumns long Überschreibt die standardmäßige maximale Anzahl von Spalten, die eine Abfrage erstellen darf.
norequesttimeout bool Legt das Anforderungstimeout auf seinen Maximalwert fest. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
notruncation bool Deaktiviert das Abschneiden von Abfrageergebnissen, die an den Aufrufer zurückgegeben werden.
push_selection_through_aggregation bool Bei Festlegung auf true, ermöglicht das Pushen der einfachen Auswahl durch Aggregation.
query_bin_auto_at Literal Gibt den Startwert an, der beim Auswerten der bin_auto() -Funktion verwendet werden soll.
query_bin_auto_size Literal Gibt den Wert der Bin-Größe an, der beim Auswerten der bin_auto() -Funktion verwendet werden soll.
query_cursor_after_default string Legt den Standardwert für die funktion cursor_after() fest, wenn sie ohne Parameter aufgerufen wird.
query_cursor_before_or_at_default string Legt den Standardwert für die funktion cursor_before_or_at() fest, wenn sie ohne Parameter aufgerufen wird.
query_cursor_current string Überschreibt den Cursorwert, der von der funktion cursor_current() zurückgegeben wird.
query_cursor_disabled bool Deaktiviert die Verwendung von Cursorfunktionen innerhalb des Abfragekontexts.
query_cursor_scoped_tables dynamic Listet Tabellennamen auf, die auf cursor_after_default .. cursor_before_or_at() (Obere Grenze ist optional).
query_datascope string Steuert die Daten, auf die die Abfrage angewendet wird. Unterstützte Werte sind default, oder allhotcache.
query_datetimescope_column string Gibt den Spaltennamen für den Datum/Uhrzeitbereich (query_datetimescope_to / query_datetimescope_from) der Abfrage an.
query_datetimescope_from datetime Legt den Mindestgrenzwert für Datum und Uhrzeit für den Abfragebereich fest. Wenn definiert, dient sie als automatisch angewendeter Filter nach query_datetimescope_column.
query_datetimescope_to datetime Legt das maximale Datums- und Zeitlimit für den Abfragebereich fest. Wenn definiert, dient sie als automatisch angewendeter Filter nach query_datetimescope_column.
query_distribution_nodes_span int Steuert das Verhalten des Zusammenführens von Unterabfragen. Der ausgeführte Knoten führt eine zusätzliche Ebene in der Abfragehierarchie für jede Untergruppe von Knoten ein, und diese Option legt die Größe der Untergruppe fest.
query_fanout_nodes_percent int Gibt den Prozentsatz der Knoten für die Ausführung von Lüftern an.
query_fanout_threads_percent int Gibt den Prozentsatz der Threads für die Ausführung von Fanouts an.
query_force_row_level_security bool Bei Festlegung auf true, erzwingt Sicherheitsregeln auf Zeilenebene, auch wenn die Richtlinie deaktiviert ist.
query_language string Bestimmt, wie der Abfragetext interpretiert werden soll. Unterstützte Werte sind csl, oder kqlsql. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
query_log_query_parameters bool Aktiviert die Abfrageparameterprotokollierung für die spätere Anzeige im Journal "Abfragen anzeigen".
query_max_entities_in_union long Überschreibt die standardmäßige maximale Anzahl von Spalten, die eine Abfrage erstellen darf.
query_now datetime Überschreibt den datetime-Wert, der von der Now() -Funktion zurückgegeben wird.
query_optimize_fts_at_relop bool Bei Festlegung auf true, ermöglicht eine experimentelle Optimierung für Abfragen, die kostspielige Freitext-Suchvorgänge ausführen. Beispielsweise \|where * has "pattern".
query_python_debug bool oder int Bei Festlegung auf true, generiert eine Python-Debugabfrage für den aufgezählten Python-Knoten.
query_results_apply_getschema bool Bei Festlegung auf true, ruft das Schema jeder tabellarischen Daten in den Ergebnissen der Abfrage anstelle der Daten selbst ab.
query_results_cache_force_refresh bool Wenn dieser Parameter festgelegt ist true, erzwingt die Cacheaktualisierung von Abfrageergebnissen für eine bestimmte Abfrage. Muss in Kombination mit query_results_cache_max_ageder Kusto Data ClientRequestProperties-Klasse und nicht als Set-Anweisung verwendet werden.
query_results_cache_max_age timespan Steuert das maximale Alter der zwischengespeicherten Abfrageergebnisse, die der Dienst zurückgeben darf.
query_results_cache_per_shard bool Bei Festlegung auf true, aktiviert die Abfragezwischenspeicherung pro Umfang .
query_results_progressive_row_count long Enthält einen Hinweis darauf, wie viele Datensätze in den einzelnen Aktualisierungen gesendet werden sollen. Wird nur wirksam, wenn results_progressive_enabled sie festgelegt ist.
query_results_progressive_update_period timespan Stellt einen Hinweis zur Häufigkeit des Sendens von Statusframes bereit. Wird nur wirksam, wenn results_progressive_enabled sie festgelegt ist.
query_take_max_records long Beschränkt abfrageergebnisse auf eine angegebene Anzahl von Datensätzen.
query_weakconsistency_session_id string Legt die abfrage schwache Konsistenzsitzungs-ID fest. Wird wirksam, wenn queryconsistency der Modus auf weakconsistency_by_session_id. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
queryconsistency string Steuert die Abfragekonsistenz. Unterstützte Werte sind strongconsistency, , weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseoder weakconsistency_by_session_id. Stellen Sie bei Verwendung weakconsistency_by_session_idsicher, dass sie auch die query_weakconsistency_session_id Eigenschaft festlegen. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
request_app_name string Gibt den Anforderungsanwendungsnamen an, der in der Berichterstellung verwendet werden soll. Beispiel: ".show queries". Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
request_block_row_level_security bool Wenn dieser Wert auf true", blockiert den Zugriff auf Tabellen mit aktivierter Sicherheitsrichtlinie auf Zeilenebene.
request_callout_disabled bool Wenn diese Einstellung truefestgelegt ist, verhindert die Anforderungsbeschriftung an einen vom Benutzer bereitgestellten Dienst.
request_description string Ermöglicht die Aufnahme beliebiger Texte als Anforderungsbeschreibung.
request_external_data_disabled bool Wenn diese Einstellung truefestgelegt ist, verhindert die Anforderung den Zugriff auf externe Daten mithilfe des externen Datenoperators oder externer Tabellen.
request_external_table_disabled bool Wenn diese Einstellung truefestgelegt ist, wird verhindert, dass die Anforderung auf externe Tabellen zugreift.
request_impersonation_disabled bool Wenn dieser Wert auf true", gibt an, dass der Dienst die Identität des Anrufers nicht annehmen soll.
request_readonly bool Wenn diese Einstellung festgelegt trueist, wird der Schreibzugriff für die Anforderung verhindert. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
request_readonly_hardline bool Wenn diese Einstellung truefestgelegt ist, wird die Anforderung in einem strengen schreibgeschützten Modus ausgeführt. Die Anforderung kann nichts schreiben, und alle nicht kompatiblen Funktionen, z. B. Plug-Ins, sind deaktiviert. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
request_remote_entities_disabled bool Wenn diese Einstellung truefestgelegt ist, wird verhindert, dass die Anforderung auf Remotedatenbanken und Remoteentitäten zugreift.
request_sandboxed_execution_disabled bool Wenn diese Einstellung truefestgelegt ist, wird verhindert, dass die Anforderung Code in der Sandbox aufruft.
request_user string Gibt den Anforderungsbenutzer an, der in der Berichterstellung verwendet werden soll. Beispiel: ".show queries". Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
results_error_reporting_placement string Bestimmt die Platzierung von Fehlern im Resultset. Verfügbar sind die Optionen in_data, end_of_table und end_of_dataset.
results_progressive_enabled bool Bei Festlegung auf true, aktiviert den progressiven Abfragedatenstrom. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
results_v2_fragment_primary_tables bool Bewirkt, dass primäre Tabellen in mehreren Fragmenten gesendet werden, die jeweils eine Teilmenge der Zeilen enthalten. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
results_v2_newlines_between_frames bool Fügt neue Linien zwischen Rahmen in den Ergebnissen hinzu, um die Analyse zu vereinfachen.
servertimeout timespan Überschreibt das Standardmäßige Anforderungstimeout. Diese Option kann nicht als Teil einer Set-Anweisung geändert werden. Ändern Sie stattdessen die Option mithilfe der Dashboardeinstellungen.
truncation_max_records long Überschreibt die standardmäßige maximale Anzahl von Datensätzen, die eine Abfrage an den Aufrufer zurückgeben darf (Abschneiden).
truncationmaxsize long Überschreibt die standardmäßige maximale Datengröße, die eine Abfrage an den Aufrufer zurückgeben darf (Kürzung). Diese Option kann nicht als Teil einer Set-Anweisung geändert werden.
validatepermissions bool Überprüft die Berechtigungen des Benutzers, um die Abfrage auszuführen, ohne die Abfrage tatsächlich auszuführen. Mögliche Ergebnisse für diese Eigenschaft sind: OK (Berechtigungen sind vorhanden und gültig), Incomplete (Überprüfung konnte aufgrund der dynamischen Schemaauswertung nicht abgeschlossen werden) oder KustoRequestDeniedException (Berechtigungen wurden nicht festgelegt).

Festlegen von Anforderungseigenschaften

Sie können Anforderungseigenschaften auf folgende Weise festlegen:

Hinweis

Die folgenden Anforderungseigenschaften können nicht mit einer Set-Anweisung festgelegt werden:

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

Hinweis

Zugehöriger Inhalt