STATEMENT_TIMEOUT

Aplica-se a:marcado como sim Databricks SQL

O parâmetro de configuração STATEMENT_TIMEOUT especifica uma duração de tempo limite em segundos. A contagem começa no início da execução da instrução SQL. Qualquer instrução SQL Databricks com um tempo de execução superior ao valor é expirada.

Pode definir este parâmetro em três escopos:

  • Sessão: Aplica-se a declarações na sessão atual. Use a SET declaração.
  • Warehouse (Beta): Aplica-se a todas as instruções que correm num SQL warehouse específico. Usa a API SQL Warehouses.
  • Espaço de Trabalho: Aplica-se a todos os armazéns SQL no espaço de trabalho. Use as definições de administrador do espaço de trabalho ou a API SQL Warehouses.

Configuração

Defina um valor de tempo limite em segundos entre 0 e 172800 segundos (2 dias). Qualquer instrução SQL Databricks que tenha um tempo de execução superior ao valor definido é interrompida.

Predefinição do sistema

O padrão do sistema é 172800 segundos (2 dias).

Precedence

Quando o timeout é definido em mais do que um escopo, aplica-se o primeiro valor não nulo na seguinte ordem:

  1. Session
  2. Armazém (Beta)
  3. Workspace

Se o timeout não estiver definido em qualquer escopo, aplica-se o padrão do sistema .

Exemplos

O exemplo seguinte define um timeout ao nível da sessão e depois reinicia-o.

-- Set a session-level timeout
> SET STATEMENT_TIMEOUT = 86400;
> SELECT * FROM DIAMONDS;

-- Reset the timeout duration
> RESET STATEMENT_TIMEOUT;
> SELECT * FROM DIAMONDS;

Para definir um tempo limite ao nível do espaço de trabalho, vá até as configurações de administrador do espaço de trabalho, clique em Computação, e de seguida, clique em Gerir junto a Armazéns SQL. Na definição de Parâmetros de Configuração SQL , adicione um parâmetro de configuração onde o valor de timeout seja em segundos.

-- Set a workspace-level timeout
> STATEMENT_TIMEOUT 86400

Timeout ao nível do armazém

Podes definir um timeout de instrução num único SQL warehouse para que diferentes armazéns possam aplicar diferentes timeouts às suas consultas. Por exemplo, defina um tempo de espera mais longo num armazém ETL e um tempo de espera mais curto num armazém de BI.

Importante

Os tempos de expiração dos extratos ao nível do armazém estão em Beta. Um administrador de espaço de trabalho deve ativar a pré-visualização do Timeout do Extrato do Armazém a partir da página de Pré-visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Defina um timeout ao nível do armazém com o statement_timeout campo nas APIs de Criar ou Atualizar o armazém. O valor está em segundos. Para remover um timeout ao nível do armazém, defina o campo para 0.

Quando mudas statement_timeout com a API Update warehouse, o warehouse reinicia automaticamente para que o novo valor tenha efeito.

Para verificar o timeout que está atualmente em vigor no armazém a que está ligado, execute o seguinte:

SET STATEMENT_TIMEOUT;

Note

Desligar a pré-visualização do Timeout do Extrato do Armazém não elimina statement_timeout os valores já definidos nos armazéns. Um valor previamente definido ao nível do armazém continua a aplicar-se até reiniciar o armazém.

  • Last updated on