Definir limites de tempo limite

No Azure Data Explorer, é possível personalizar o tempo limite para as suas consultas e comandos de gestão. Neste artigo, irá aprender a definir um tempo limite personalizado em várias ferramentas, como a IU da Web do Azure Data Explorer, o Kusto.Explorer, o Kusto.Cli, o Power BI e ao utilizar um SDK. Determinadas ferramentas têm os seus próprios valores de tempo limite predefinidos, mas pode ser útil ajustar estes valores com base na complexidade e no runtime esperado das suas consultas.

Nota

As políticas do lado do servidor, como a política de limites de pedidos, podem substituir o tempo limite especificado pelo cliente.

IU da Web do Azure Data Explorer

Esta secção descreve como configurar um tempo limite de consulta personalizado e o tempo limite do comando de administrador na IU da Web do Azure Data Explorer.

Pré-requisitos

• Uma conta Microsoft ou uma identidade de utilizador Microsoft Entra. Não é necessária uma subscrição do Azure.
• Um cluster e uma base de dados do Azure Data Explorer. Criar um cluster e uma base de dados.

Definir duração do tempo limite

1. Inicie sessão na IU web do Azure Data Explorer com a sua conta Microsoft ou Microsoft Entra credenciais de identidade de utilizador.

2. No menu superior, selecione o ícone Definições .

3. No menu esquerdo, selecione Ligação.

4. Na definição Tempo limite da consulta (em minutos), utilize o controlo de deslize para escolher o tempo limite de consulta pretendido.

5. Na definição Administração tempo limite do comando (em minutos), utilize o controlo de deslize para escolher o tempo limite do comando de administrador pretendido.

   

6. Feche a janela de definições e as alterações serão guardadas automaticamente.

Kusto.Explorer

Esta secção descreve como configurar um tempo limite de consulta personalizado e o tempo limite do comando de administrador no Kusto.Explorer.

Pré-requisitos

• Transfira e instale a ferramenta Kusto.Explorer.
• Um cluster e uma base de dados do Azure Data Explorer. Criar um cluster e uma base de dados.

Definir duração do tempo limite

1. Abra a ferramenta Kusto.Explorer.

2. No menu superior, selecione o separador Ferramentas .

3. No lado direito, selecione Opções.

   

4. No menu esquerdo, selecione Ligações.

5. Na definição Tempo Limite do Servidor de Consultas , introduza o tempo limite pretendido. O máximo é de 1 hora.

6. Na definição Administração Tempo Limite do Servidor de Comandos, introduza o tempo limite pretendido. O máximo é de 1 hora.

   

7. Selecione OK para guardar as alterações.

Kusto.Cli

Esta secção descreve como configurar um tempo limite de servidor personalizado na Kusto.Cli.

Pré-requisitos

• Instale o Kusto.Cli ao transferir o pacote Microsoft.Azure.Kusto.Tools.

Definir duração do tempo limite

Execute o seguinte comando para definir a propriedade servertimeoutclient request com o tempo limite pretendido como um valor de período de tempo válido até 1 hora.

Kusto.Cli.exe <ConnectionString> -execute:"#crp servertimeout=<timespan>" -execute:"…"

Em alternativa, utilize o seguinte comando para definir a propriedade de pedido de clientenorequesttimeout, que definirá o tempo limite para o valor máximo de 1 hora.

Kusto.Cli.exe <ConnectionString> -execute:"#crp norequesttimeout=true" -execute:"…"

Depois de definida, a propriedade do pedido de cliente aplica-se a todos os valores futuros até a aplicação ser reiniciada ou outro valor ser definido. Para obter o valor atual, utilize:

Kusto.Cli.exe <ConnectionString> -execute:"#crp servertimeout"

Power BI

Esta secção descreve como configurar um tempo limite de servidor personalizado no Power BI.

Pré-requisitos

• Power BI Desktop

Definir duração do tempo limite

1. Ligue-se ao cluster do Azure Data Explorer a partir do Power BI Desktop.

2. No menu superior, selecione Transformar Dados.

   

3. No menu superior, selecione Avançadas Editor do Power Query.

   

4. Na janela de pop-up, defina a opção de tempo limite no quarto parâmetro do AzureDataExplorer.Contents método . O exemplo seguinte mostra como definir um período de tempo limite de 59 minutos.

   let 
       Source = AzureDataExplorer.Contents(<cluster>, <database>, <table>, [Timeout=#duration(0,0,59,0)])
   in
       Source
   

5. Selecione Concluído para aplicar as alterações.

SDKs

Para saber como definir tempos limite com os SDKs, veja Personalizar o comportamento das consultas com as propriedades do pedido de cliente.

Conteúdo relacionado

• Limites de consulta