Partilhar via


Solicitar propriedades

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 suportadas

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

Observação

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

Nome da propriedade Tipo Descrição
best_effort bool Se definido como true, permite resolução difusa e problemas de conectividade de fontes de dados (pernas 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 produz 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 linhas.
deferpartialqueryfailures bool Se definido como true, suprime o relatório de falhas parciais de consulta dentro do conjunto de resultados.
materialized_view_shuffle_query dynamic Fornece uma dica para usar a estratégia de embaralhar 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 de embaralhamento correspondentes.

Por exemplo, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) indica V1 de exibição aleatória por teclas K1 e K2, enquanto dynamic([ { "Name": "V1" } ]) modo de exibição embaralha 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 pode produzir.
norequesttimeout bool Define o tempo limite da solicitação para seu valor máximo. Esta 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 empurrar a seleção simples através 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 de 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 dentro do contexto de consulta.
query_cursor_scoped_tables dynamic Lista os nomes de tabelas a serem definidos para cursor_after_default .. cursor_before_or_at() (limite superior é opcional).
query_datascope string Controla os dados aos quais a consulta se aplica. Os valores suportados são default, allou hotcache.
query_datetimescope_column string Especifica o nome da coluna para o escopo datetime da consulta (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Define a data e o limite mínimo de tempo para o escopo da consulta. Se definido, ele serve como um filtro aplicado automaticamente em query_datetimescope_column.
query_datetimescope_to datetime Define a data e o limite máximo de tempo para o escopo da consulta. Se definido, ele serve como um filtro aplicado automaticamente em 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 esta 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 ventilação.
query_force_row_level_security bool Se definido como true, impõe regras de segurança nível de linha, mesmo que a política esteja desativada.
query_language string Determina como o texto da consulta deve ser interpretado. Os valores suportados são csl, kqlou sql. Esta opção não pode ser modificada como parte de uma instrução set.
query_log_query_parameters bool Habilita o registro de parâmetros de consulta para visualização posterior nas consultas .show diário.
query_max_entities_in_union long Substitui o número máximo padrão de colunas que uma consulta pode 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 dispendiosas de pesquisa de texto livre. Por exemplo, \|where * has "pattern".
query_python_debug bool ou int Se definido como true, gera uma consulta de depuração Python para o nó 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 próprios dados.
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 via Kusto Data ClientRequestProperties classe, não como uma instrução set.
query_results_cache_max_age timespan Controla a idade máxima dos resultados da consulta em cache que o serviço tem permissão para retornar.
query_results_cache_per_shard bool Se definido como true, habilita por extensão cache de consulta.
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 definida.
query_results_progressive_update_period timespan Fornece uma dica sobre a frequência com que enviar quadros de progresso. Entra em vigor somente se results_progressive_enabled estiver definida.
query_take_max_records long Limita os resultados da consulta a um número especificado de registros.
query_weakconsistency_session_id string Define o ID da sessão de consistência fraca da consulta. Entra em vigor quando queryconsistency modo estiver definido como weakconsistency_by_session_id. Esta 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_id, certifique-se de definir também a propriedade query_weakconsistency_session_id. Esta 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. Esta 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 política de de segurança em nível de linha habilitada.
request_callout_disabled bool Se definido como true, impede o texto explicativo de solicitação para um serviço fornecido pelo usuário.
request_description string Permite a inclusão de texto arbitrário como 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. Esta 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 opera em um modo somente leitura estrito. A solicitação não é capaz de escrever nada, e qualquer funcionalidade não compatível, como plugins, está desativada. Esta 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 código na área restrita.
request_user string Especifica o usuário de solicitação a ser usado no relatório. Por exemplo, consultas .show. Esta 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_tablee end_of_dataset.
results_progressive_enabled bool Se definido como true, habilita o fluxo de consulta progressiva. Esta 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. Esta 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 sua análise.
servertimeout timespan Substitui o tempo limite de solicitação padrão. Esta 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 pode retornar ao chamador (truncamento).
truncationmaxsize long Substitui o tamanho máximo de dados padrão que uma consulta pode retornar ao chamador (truncamento). Esta 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 são 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 as propriedades da solicitação das seguintes maneiras:

  • O corpo POST de uma solicitação HTTP
  • Uma instrução Kusto Query Language set
  • O método set option da classe ClientRequestProperties

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