Compartir a través de

Propiedades de solicitud

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Las propiedades de solicitud controlan cómo se ejecuta una consulta o un comando y devuelven resultados.

Propiedades de solicitud admitidas

En la tabla siguiente se describen las propiedades de solicitud admitidas.

Nota:

Las propiedades de solicitud query_weakconsistency_session_id y queryconsistency no están disponibles en Fabric.

Nombre de propiedad Type Descripción
best_effort bool Si se establece en true, permite problemas de resolución aproximada y conectividad de orígenes de datos (segmentos de unión). El conjunto de orígenes de unión se reduce al conjunto de referencias de tabla que existen y son accesibles en el momento de la ejecución. Si se encuentra al menos una tabla accesible, se ejecuta la consulta. Cualquier error produce una advertencia en los resultados del estado de la consulta, pero no impide que la consulta se ejecute.
client_max_redirect_count long Controla el número máximo de redireccionamientos HTTP que sigue el cliente durante el procesamiento.
client_results_reader_allow_varying_row_widths bool Si se establece en true, el lector de resultados tolera las tablas cuyo ancho de fila varía entre filas.
deferpartialqueryfailures bool Si se establece en true, suprime los informes de errores de consulta parciales dentro del conjunto de resultados.
materialized_view_shuffle_query dynamic Proporciona una sugerencia para usar la estrategia de orden aleatorio para las vistas materializadas a las que se hace referencia en la consulta. Esta propiedad afecta exclusivamente a las vistas materializadas y no a ninguna operación posterior, como combinaciones, dentro de la consulta. Toma una matriz de nombres de vista materializados y sus claves aleatorias correspondientes.

Por ejemplo, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) indica la vista V1 aleatoria por claves K1 y K2, mientras dynamic([ { "Name": "V1" } ]) que la vista V1 aleatoria por todas las claves.
max_memory_consumption_per_query_per_node long Invalida la cantidad máxima predeterminada de memoria que una consulta puede asignar por nodo.
maxmemoryconsumptionperiterator long Invalida la cantidad máxima predeterminada de memoria que un operador de consulta puede asignar.
maxoutputcolumns long Invalida el número máximo predeterminado de columnas que puede generar una consulta.
norequesttimeout bool Establece el tiempo de espera de la solicitud en su valor máximo. Esta opción no se puede modificar como parte de una instrucción set.
notruncation bool Deshabilita el truncamiento de los resultados de la consulta devueltos al autor de la llamada.
push_selection_through_aggregation bool Si se establece en true, permite insertar la selección simple a través de la agregación.
query_bin_auto_at literal Especifica el valor inicial que se va a usar al evaluar la función bin_auto().
query_bin_auto_size literal Especifica el valor de tamaño de intervalo que se va a usar al evaluar la función bin_auto().
query_cursor_after_default string Establece el valor de parámetro predeterminado para la función cursor_after() cuando se llama sin parámetros.
query_cursor_before_or_at_default string Establece el valor de parámetro predeterminado para la función cursor_before_or_at() cuando se llama sin parámetros.
query_cursor_current string Invalida el valor del cursor devuelto por la función cursor_current().
query_cursor_disabled bool Deshabilita el uso de funciones de cursor dentro del contexto de consulta.
query_cursor_scoped_tables dynamic Enumera los nombres de tabla que se van a limitar a cursor_after_default .. cursor_before_or_at() (el límite superior es opcional).
query_datascope string Controla los datos a los que se aplica la consulta. Los valores admitidos son default, allo hotcache.
query_datetimescope_column string Especifica el nombre de columna para el ámbito de fecha y hora de la consulta (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Establece el límite mínimo de fecha y hora para el ámbito de consulta. Si se define, actúa como filtro autoaplicado en query_datetimescope_column.
query_datetimescope_to datetime Establece el límite máximo de fecha y hora para el ámbito de consulta. Si se define, actúa como filtro autoaplicado en query_datetimescope_column.
query_distribution_nodes_span int Controla el comportamiento de la combinación de subconsulta. El nodo en ejecución presenta un nivel adicional en la jerarquía de consultas para cada subgrupo de nodos y esta opción establece el tamaño del subgrupo.
query_fanout_nodes_percent int Especifica el porcentaje de nodos para ejecutar la distribución ramificada.
query_fanout_threads_percent int Especifica el porcentaje de subprocesos para ejecutar la distribución ramificada.
query_force_row_level_security bool Si se establece trueen , aplica reglas de seguridad de nivel de fila, incluso si la directiva está deshabilitada.
query_language string Determina cómo se debe interpretar el texto de la consulta. Los valores admitidos son csl, kqlo sql. Esta opción no se puede modificar como parte de una instrucción set.
query_log_query_parameters bool Habilita el registro de parámetros de consulta para su visualización posterior en el diario de consultas .show. Esta opción no se puede modificar como parte de una instrucción set.
query_max_entities_in_union long Invalida el número máximo predeterminado de columnas que puede generar una consulta.
query_now datetime Invalida el valor datetime devuelto por la función now().
query_optimize_fts_at_relop bool Cuando se establece trueen , habilita una optimización experimental para las consultas que realizan costosas operaciones de búsqueda de texto libre. Por ejemplo, \|where * has "pattern".
query_python_debug bool o int Si se establece en true, genera una consulta de depuración de Python para el nodo de Python enumerado.
query_results_apply_getschema bool Si se establece trueen , recupera el esquema de cada dato tabular en los resultados de la consulta en lugar de los propios datos.
query_results_cache_force_refresh bool Si se establece en true, fuerza una actualización en caché de los resultados de la consulta para una consulta específica. Debe usarse en combinación con query_results_cache_max_agey enviar a través de la clase Kusto Data ClientRequestProperties, no como instrucción set.
query_results_cache_max_age timespan Controla la antigüedad máxima de los resultados de la consulta almacenada en caché que el servicio puede devolver.
query_results_cache_per_shard bool Si se establece en true, habilita el almacenamiento en caché de consultas por extensión .
query_results_progressive_row_count long Proporciona una sugerencia para el número de registros que se van a enviar en cada actualización. Solo surte efecto si results_progressive_enabled se establece.
query_results_progressive_update_period timespan Proporciona una sugerencia sobre la frecuencia con la que se envían fotogramas de progreso. Solo surte efecto si results_progressive_enabled se establece.
query_take_max_records long Limita los resultados de la consulta a un número especificado de registros.
query_weakconsistency_session_id string Establece el identificador de sesión de coherencia débil de la consulta. Surte efecto cuando queryconsistency el modo se establece weakconsistency_by_session_iden . Esta opción no se puede modificar como parte de una instrucción set.
queryconsistency string Controla la coherencia de las consultas. Los valores admitidos son strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseo weakconsistency_by_session_id. Al usar weakconsistency_by_session_id, asegúrese de establecer también la query_weakconsistency_session_id propiedad . Esta opción no se puede modificar como parte de una instrucción set.
request_app_name string Especifica el nombre de la aplicación de solicitud que se va a usar en los informes. Por ejemplo, .show consultas. Esta opción no se puede modificar como parte de una instrucción set.
request_block_row_level_security bool Si se establece en true, bloquea el acceso a tablas con la directiva de seguridad de nivel de fila habilitada.
request_callout_disabled bool Si se establece en true, impide la llamada de solicitud a un servicio proporcionado por el usuario.
request_description string Permite la inclusión de texto arbitrario como descripción de la solicitud.
request_external_data_disabled bool Si se establece en true, impide que la solicitud acceda a datos externos mediante el operador externaldata o las tablas externas.
request_external_table_disabled bool Si se establece en true, impide que la solicitud acceda a tablas externas.
request_impersonation_disabled bool Si se establece trueen , impide que el servicio use la identidad del autor de la llamada para acceder a los servicios de bajada en nombre del autor de la llamada, incluidas las consultas entre clústeres.
request_readonly bool Si se establece en true, impide el acceso de escritura para la solicitud. Esta opción no se puede modificar como parte de una instrucción set.
request_readonly_hardline bool Si se establece trueen , la solicitud funciona en un modo estricto de solo lectura. La solicitud no puede escribir nada y se deshabilitan las funcionalidades no compatibles, como los complementos. Esta opción no se puede modificar como parte de una instrucción set.
request_remote_entities_disabled bool Si se establece en true, impide que la solicitud acceda a bases de datos remotas y entidades remotas.
request_sandboxed_execution_disabled bool Si se establece trueen , impide que la solicitud invoque código en el espacio aislado.
request_user string Especifica el usuario de solicitud que se va a usar en los informes. Por ejemplo, .show consultas. Esta opción no se puede modificar como parte de una instrucción set.
results_error_reporting_placement string Determina la ubicación de los errores en el conjunto de resultados. Las opciones son in_data, end_of_table y end_of_dataset.
results_progressive_enabled bool Si se establece en true, habilita el flujo de consulta progresiva. Esta opción no se puede modificar como parte de una instrucción set.
results_v2_fragment_primary_tables bool Hace que las tablas principales se envíen en varios fragmentos, cada una que contiene un subconjunto de las filas. Esta opción no se puede modificar como parte de una instrucción set.
results_v2_newlines_between_frames bool Agrega nuevas líneas entre fotogramas en los resultados, con el fin de facilitar su análisis.
servertimeout timespan Invalida el tiempo de espera de solicitud predeterminado. Esta opción no se puede modificar como parte de una instrucción set. En su lugar, modifique la opción mediante la configuración del panel.
truncationmaxrecords long Invalida el número máximo predeterminado de registros que una consulta puede devolver al autor de la llamada (truncamiento).
truncationmaxsize long Invalida el tamaño máximo predeterminado de los datos que una consulta puede devolver al autor de la llamada (truncamiento). Esta opción no se puede modificar como parte de una instrucción set.
validatepermissions bool Valida los permisos del usuario para realizar la consulta sin ejecutar realmente la consulta. Los posibles resultados de esta propiedad son: OK (los permisos están presentes y válidos), Incomplete (no se pudo completar la validación debido a la evaluación dinámica del esquema) o KustoRequestDeniedException (no se establecieron permisos).

Establecimiento de propiedades de solicitud

Puede establecer las propiedades de solicitud de las maneras siguientes:

Nota:

Las siguientes propiedades de solicitud no se pueden establecer con una instrucción set:

  • 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

Nota:

Contenido relacionado

  • Last updated on