Compartilhar via


Propriedades de solicitação

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

As propriedades de solicitação controlam como uma consulta ou comando é executado e retorna resultados.

Propriedades de solicitação com suporte

A tabela a seguir apresenta uma visão geral das propriedades de solicitação com suporte.

Observação

As propriedades query_weakconsistency_session_id da solicitação e queryconsistency não estão disponíveis no Fabic.

Nome da propriedade Type Descrição
best_effort bool Se definido como true, permite resolução difusa e problemas de conectividade de fontes de dados (trechos de união). O conjunto de fontes de união é reduzido ao conjunto de referências de tabela que existem e são acessíveis no momento da execução. Se pelo menos uma tabela acessível for encontrada, a consulta será executada. Qualquer falha gera um aviso nos resultados do status da consulta, mas não impede que a consulta seja executada.
client_max_redirect_count long Controla o número máximo de redirecionamentos HTTP que o cliente segue durante o processamento.
client_results_reader_allow_varying_row_widths bool Se definido como true, o leitor de resultados tolera tabelas cuja largura de linha varia entre as linhas.
deferpartialqueryfailures bool Se definido como true, suprime o relatório de falhas parciais de consulta no conjunto de resultados.
materialized_view_shuffle_query dynamic Fornece uma dica para usar a estratégia de ordem aleatória para exibições materializadas referenciadas na consulta. Essa propriedade afeta exclusivamente as exibições materializadas e não quaisquer operações subsequentes, como junções, dentro da consulta. Ele usa uma matriz de nomes de exibição materializados e suas chaves aleatórias correspondentes.

Por exemplo, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) indica o modo de exibição V1 de embaralhamento por teclas K1 e K2, enquanto dynamic([ { "Name": "V1" } ]) embaralha o modo de exibição V1 por todas as teclas.
max_memory_consumption_per_query_per_node long Substitui a quantidade máxima padrão de memória que uma consulta pode alocar por nó.
maxmemoryconsumptionperiterator long Substitui a quantidade máxima padrão de memória que um operador de consulta pode alocar.
maxoutputcolumns long Substitui o número máximo padrão de colunas que uma consulta tem permissão para produzir.
norequesttimeout bool Define o tempo limite da solicitação para seu valor máximo. Essa opção não pode ser modificada como parte de uma instrução set.
notruncation bool Desabilita o truncamento dos resultados da consulta retornados ao chamador.
push_selection_through_aggregation bool Se definido como true, permite enviar a seleção simples por meio da agregação.
query_bin_auto_at literal Especifica o valor inicial a ser usado ao avaliar a função bin_auto().
query_bin_auto_size literal Especifica o valor do tamanho do compartimento a ser usado ao avaliar a função bin_auto().
query_cursor_after_default string Define o valor do parâmetro padrão para a função cursor_after() quando chamada sem parâmetros.
query_cursor_before_or_at_default string Define o valor do parâmetro padrão para a função cursor_before_or_at() quando chamada sem parâmetros.
query_cursor_current string Substitui o valor do cursor retornado pela função cursor_current().
query_cursor_disabled bool Desabilita o uso de funções de cursor no contexto de consulta.
query_cursor_scoped_tables dynamic Lista os nomes das tabelas a serem definidas para cursor_after_default .. cursor_before_or_at() (o limite superior é opcional).
query_datascope string Controla os dados aos quais a consulta se aplica. Os valores suportados são default, all, ou hotcache.
query_datetimescope_column string Especifica o nome da coluna para o escopo datetime (query_datetimescope_to / query_datetimescope_from) da consulta.
query_datetimescope_from datetime Define o limite mínimo de data e hora para o escopo da consulta. Se definido, ele serve como um filtro aplicado automaticamente no query_datetimescope_column.
query_datetimescope_to datetime Define o limite máximo de data e hora para o escopo da consulta. Se definido, ele serve como um filtro aplicado automaticamente no query_datetimescope_column.
query_distribution_nodes_span int Controla o comportamento da mesclagem de subconsultas. O nó em execução introduz um nível extra na hierarquia de consulta para cada subgrupo de nós, e essa opção define o tamanho do subgrupo.
query_fanout_nodes_percent int Especifica a porcentagem de nós para executar a distribuição.
query_fanout_threads_percent int Especifica a porcentagem de threads para executar a fan-out.
query_force_row_level_security bool Se definido como true, impõe regras de segurança em nível de linha, mesmo que a política esteja desabilitada.
query_language string Determina como o texto da consulta deve ser interpretado. Os valores suportados são csl, kql, ou sql. Essa opção não pode ser modificada como parte de uma instrução set.
query_log_query_parameters bool Habilita o log de parâmetros de consulta para exibição posterior no diário de consultas .show.
query_max_entities_in_union long Substitui o número máximo padrão de colunas que uma consulta tem permissão para produzir.
query_now datetime Substitui o valor datetime retornado pela função now().
query_optimize_fts_at_relop bool Quando definido como true, permite uma otimização experimental para consultas que executam operações de pesquisa de texto livre dispendiosas. Por exemplo, \|where * has "pattern".
query_python_debug bool ou int Se definido como true, gera uma consulta de depuração do Python para o nó do Python enumerado.
query_results_apply_getschema bool Se definido como true, recupera o esquema de cada dado tabular nos resultados da consulta, em vez dos dados em si.
query_results_cache_force_refresh bool Se definido como true, força uma atualização de cache dos resultados da consulta para uma consulta específica. Deve ser usado em combinação com query_results_cache_max_agee enviado por meio da classe Kusto Data ClientRequestProperties, não como uma instrução de conjunto.
query_results_cache_max_age timespan Controla a idade máxima dos resultados da consulta armazenada em cache que o serviço tem permissão para retornar.
query_results_cache_per_shard bool Se definido como true, habilita o cache de consulta por extensão .
query_results_progressive_row_count long Fornece uma dica de quantos registros enviar em cada atualização. Entra em vigor somente se results_progressive_enabled estiver definido.
query_results_progressive_update_period timespan Fornece uma dica de com que frequência enviar quadros de progresso. Entra em vigor somente se results_progressive_enabled estiver definido.
query_take_max_records long Limita os resultados da consulta a um número especificado de registros.
query_weakconsistency_session_id string Define a ID de sessão de consistência fraca da consulta. Entra em vigor quando queryconsistency o modo é definido como weakconsistency_by_session_id. Essa opção não pode ser modificada como parte de uma instrução set.
queryconsistency string Controla a consistência da consulta. Os valores suportados são strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseou weakconsistency_by_session_id. Ao usar weakconsistency_by_session_ido , certifique-se de definir também a query_weakconsistency_session_id propriedade. Essa opção não pode ser modificada como parte de uma instrução set.
request_app_name string Especifica o nome do aplicativo de solicitação a ser usado no relatório. Por exemplo, consultas .show. Essa opção não pode ser modificada como parte de uma instrução set.
request_block_row_level_security bool Se definido como true, bloqueia o acesso a tabelas com a política de segurança em nível de linha habilitada.
request_callout_disabled bool Se definido como true, impede a chamada de solicitação para um serviço fornecido pelo usuário.
request_description string Permite a inclusão de texto arbitrário como a descrição da solicitação.
request_external_data_disabled bool Se definido como true, impede que a solicitação acesse dados externos usando o operador externaldata ou tabelas externas.
request_external_table_disabled bool Se definido como true, impede que a solicitação acesse tabelas externas.
request_impersonation_disabled bool Se definido como true, indica que o serviço não deve representar a identidade do chamador.
request_readonly bool Se definido como true, impede o acesso de gravação para a solicitação. Essa opção não pode ser modificada como parte de uma instrução set.
request_readonly_hardline bool Se definido como true, a solicitação operará em um modo somente leitura estrito. A solicitação não é capaz de gravar nada e qualquer funcionalidade não compatível, como plug-ins, é desabilitada. Essa opção não pode ser modificada como parte de uma instrução set.
request_remote_entities_disabled bool Se definido como true, impede que a solicitação acesse bancos de dados remotos e entidades remotas.
request_sandboxed_execution_disabled bool Se definido como true, impede que a solicitação invoque o código na área restrita.
request_user string Especifica o usuário da solicitação a ser usado no relatório. Por exemplo, consultas .show. Essa opção não pode ser modificada como parte de uma instrução set.
results_error_reporting_placement string Determina o posicionamento de erros no conjunto de resultados. As opções são in_data, end_of_table e end_of_dataset.
results_progressive_enabled bool Se definido como true, habilita o fluxo de consulta progressiva. Essa opção não pode ser modificada como parte de uma instrução set.
results_v2_fragment_primary_tables bool Faz com que as tabelas primárias sejam enviadas em vários fragmentos, cada um contendo um subconjunto das linhas. Essa opção não pode ser modificada como parte de uma instrução set.
results_v2_newlines_between_frames bool Adiciona novas linhas entre quadros nos resultados, a fim de facilitar a análise deles.
servertimeout timespan Substitui o tempo limite de solicitação padrão. Essa opção não pode ser modificada como parte de uma instrução set. Em vez disso, modifique a opção usando as configurações do painel.
truncation_max_records long Substitui o número máximo padrão de registros que uma consulta tem permissão para retornar ao chamador (truncamento).
truncationmaxsize long Substitui o tamanho de dados máximo que uma consulta pode retornar ao chamador (truncamento). Essa opção não pode ser modificada como parte de uma instrução set.
validatepermissions bool Valida as permissões do usuário para executar a consulta sem realmente executá-la. Os resultados possíveis para essa propriedade são: OK (as permissões estão presentes e válidas), Incomplete (a validação não pôde ser concluída devido à avaliação dinâmica do esquema) ou KustoRequestDeniedException (as permissões não foram definidas).

Como definir propriedades de solicitação

Você pode definir propriedades de solicitação das seguintes maneiras:

Observação

As seguintes propriedades de solicitação não podem ser definidas com uma instrução set:

  • 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

Observação

  • Para definir norequesttimeout e servertimeout nas configurações do painel, consulte Definir limites de tempo limite.
  • Para definir queryconsistency a consistência fraca por meio das configurações do painel, selecione Configurações>Conexão. Para obter mais informações, consulte Personalizar configurações na interface do usuário da Web do Azure Data Explorer.