Solicitar propriedades
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 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 , all ou 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 , kql ou 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_age e 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_database ou 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_table e 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
- Para definir
norequesttimeout
eservertimeout
nas configurações do painel, consulte Definir limites de tempo limite. - Para definir
queryconsistency
consistência fraca através 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.