STATEMENT_TIMEOUT

Van toepassing op:aangevinkt als ja Databricks SQL

De STATEMENT_TIMEOUT configuratieparameter geeft een time-outduur op in seconden. Het tellen begint bij het starten van de uitvoering van de SQL-instructie. Ontstaat er een time-out voor elke Databricks SQL-instructie waarvan de uitvoeringstijd de gedefinieerde waarde overschrijdt.

U kunt deze parameter instellen op drie bereiken:

  • Sessie: Van toepassing op instructies in de huidige sessie. Gebruik de SET instructie.
  • Warehouse (bèta): is van toepassing op alle instructies die worden uitgevoerd op een specifiek SQL-warehouse. Gebruik de SQL Warehouses-API.
  • Werkruimte: van toepassing op alle SQL-warehouses in de werkruimte. Gebruik werkruimtebeheerdersinstellingen of de SQL Warehouses-API.

Instelling

Stel een time-outwaarde in seconden in tussen 0 en 172800 seconden (2 dagen). Elke Databricks SQL-instructie met een uitvoeringstijd die de ingestelde waarde overschrijdt, wordt gestopt.

Systeemstandaard

De systeemstandaard is 172800 seconden (2 dagen).

Precedence

Wanneer de time-out is ingesteld op meer dan één bereik, is de eerste niet-null-waarde in de volgende volgorde van toepassing:

  1. Session
  2. Magazijn (bèta)
  3. Workspace

Als de time-out niet is ingesteld op een bepaald bereik, is de systeemstandaard van toepassing.

Voorbeelden

In het volgende voorbeeld wordt een time-out op sessieniveau ingesteld en vervolgens opnieuw ingesteld.

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

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

Als u een time-out op werkruimteniveau wilt instellen, gaat u naar de instellingen van de werkruimtebeheerder, klikt u op Compute-en klikt u vervolgens op Beheren naast SQL-warehouses. Voeg in de sql-configuratieparameters instelling een configuratieparameter toe waarbij de time-outwaarde in seconden is.

-- Set a workspace-level timeout
> STATEMENT_TIMEOUT 86400

Time-out op magazijnniveau

U kunt een time-out voor de instructie instellen voor één SQL-warehouse, zodat verschillende warehouses verschillende time-outs kunnen toepassen op hun query's. Stel bijvoorbeeld een langere time-out in op een ETL-magazijn en een kortere time-out op een BI-magazijn.

Important

Time-outs voor instructie op magazijnniveau bevinden zich in de bètaversie. Een werkruimtebeheerder moet het time-outvoorbeeld van de magazijninstructie inschakelen op de pagina Previews . Zie Azure Databricks previews beheren.

Stel een time-out op magazijnniveau in met het statement_timeout veld in de API's voor het maken of bijwerken van magazijnen. De waarde is in seconden. Als u een time-out op magazijnniveau wilt verwijderen, stelt u het veld in op 0.

Wanneer u wijzigt statement_timeout met de Updatewarehouse-API, wordt het magazijn automatisch opnieuw gestart, zodat de nieuwe waarde van kracht wordt.

Voer de volgende opdracht uit om de time-out te controleren die momenteel van kracht is op het magazijn waarmee u bent verbonden:

SET STATEMENT_TIMEOUT;

Opmerking

Als u het time-outvoorbeeld van de magazijninstructie uitschakelt, worden de waarden die al zijn ingesteld voor magazijnen, niet gewist statement_timeout . Een eerder ingestelde waarde op magazijnniveau blijft van toepassing totdat u het magazijn opnieuw start.