Partilhar via


Definir limites de tempo de espera

Aplica-se a: ✅Azure Data Explorer

É possível personalizar o tempo limite para suas consultas e comandos de gerenciamento. Neste artigo, você aprenderá a definir um tempo limite personalizado em várias ferramentas, como a interface do usuário da Web do Azure Data Explorer, Kusto.Explorer, Kusto.Cli, Power BI e ao usar um SDK. Algumas ferramentas têm seus próprios valores de tempo limite padrão, mas pode ser útil ajustar esses valores com base na complexidade e no tempo de execução esperado de suas consultas.

Observação

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

Interface do usuário da Web do Azure Data Explorer

Esta seção descreve como configurar um tempo limite de consulta personalizado e um tempo limite do comando admin na interface do usuário da Web do Azure Data Explorer.

Pré-requisitos

  • Uma conta Microsoft ou uma identidade de utilizador do Microsoft Entra. Uma assinatura do Azure não é necessária.
  • Um cluster e um banco de dados do Azure Data Explorer. Crie um cluster e um banco de dados.

Definir a duração do tempo limite

  1. Entre na interface da Web do Azure Data Explorer com a sua conta da Microsoft ou credenciais de identidade de utilizador do Microsoft Entra.

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

  3. No menu à esquerda, selecione Conexão.

  4. Na configuração Tempo limite da consulta (em minutos), use o controle deslizante para escolher o comprimento do tempo limite de consulta desejado.

  5. Na configuração Tempo limite do comando Admin (em minutos), use o controle deslizante para escolher o comprimento do tempo limite desejado do comando admin.

    Captura de ecrã das definições na IU Web do Azure Data Explorer que controlam a duração do tempo limite.

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

Kusto.Explorer

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

Pré-requisitos

Definir a duração do tempo limite

  1. Abra a ferramenta Kusto.Explorer.

  2. No menu superior, selecione a guia Ferramentas .

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

    Captura de tela mostrando o widget de opções na ferramenta Kusto.Explorer.

  4. No menu à esquerda, selecione Conexões.

  5. Na configuração Tempo Limite do Servidor de Consulta , insira o comprimento de tempo limite desejado. O máximo é de 1 hora.

  6. Na configuração Admin Command Server Timeout , insira o tempo limite desejado. O máximo é de 1 hora.

    Captura de tela mostrando as configurações que controlam o tempo limite no Kusto.Explorer.

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

Kusto.Cli

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

Pré-requisitos

Definir a duração do tempo limite

Execute o seguinte comando para definir a propriedade servertimeoutclient request com o comprimento de tempo limite desejado como um valor de timespan válido de até 1 hora.

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

Como alternativa, use o comando a seguir para definir a propriedade de solicitação do clientenorequesttimeout, que definirá o tempo limite para o valor máximo de 1 hora.

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

Uma vez definida, a propriedade de solicitação do cliente se aplica a todos os valores futuros até que o aplicativo seja reiniciado ou outro valor seja definido. Para recuperar o valor atual, use:

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

Power BI

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

Pré-requisitos

  • Power BI Desktop

Definir a duração do tempo limite

  1. Conecte-se ao cluster do Azure Data Explorer a partir da área de trabalho do Power BI.

  2. No menu superior, selecione Transformar dados.

    Captura de ecrã da opção transformar dados no Power BI Desktop.

  3. No menu superior, selecione Editor de Consultas Avançadas.

    Captura de ecrã da opção de editor de consultas avançado do Power BI no Power BI Desktop.

  4. Na janela pop-up, defina a opção de tempo limite no quarto parâmetro do AzureDataExplorer.Contents método. O exemplo a seguir mostra como definir um 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, consulte Personalizar o comportamento da consulta com as propriedades de solicitação do cliente.