Propriedades de solicitação
Aplica-se a: ✅Microsoft Fabric✅Azure 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_age e 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_database ou weakconsistency_by_session_id . Ao usar weakconsistency_by_session_id o , 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:
- O corpo POST de uma solicitação HTTP
- Uma instrução de conjunto de linguagem de consulta Kusto
- O método set option da
ClientRequestProperties
classe
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
eservertimeout
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.