STATEMENT_TIMEOUT

S’applique à :coche marquée oui Databricks SQL

Le STATEMENT_TIMEOUT paramètre de configuration spécifie une durée d’expiration en secondes. Le nombre commence au début de l’exécution de l’instruction SQL. Les instructions Databricks SQL dont la durée d’exécution dépasse la valeur expirent.

Vous pouvez définir ce paramètre à trois étendues :

  • Session : s’applique aux instructions de la session active. Utilisez l’instructionSET.
  • Warehouse (bêta) : S’applique à toutes les instructions qui s’exécutent sur un entrepôt SQL spécifique. Utilisez l’API SQL Warehouses.
  • Espace de travail : s’applique à tous les entrepôts SQL de l’espace de travail. Utilisez les paramètres d’administration de l’espace de travail ou l’API SQL Warehouses.

Réglage

Définissez une valeur de délai d’expiration en secondes comprise entre 0 et 172 800 secondes (2 jours). Les instructions Databricks SQL dont la durée d’exécution dépasse la valeur définie sont arrêtées.

Valeur système par défaut

La valeur système par défaut est 172 800 secondes (2 jours).

Priorité

Lorsque le délai d’expiration est défini à plusieurs étendues, la première valeur non null dans l’ordre suivant s’applique :

  1. session
  2. Warehouse (bêta)
  3. Workspace

Si le délai d’expiration n’est défini à aucune étendue, la valeur par défaut du système s’applique.

Exemples

L’exemple suivant définit un délai d’expiration au niveau de la session, puis le réinitialise.

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

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

Pour définir un délai d’expiration au niveau de l’espace de travail, accédez aux paramètres d’administration de l’espace de travail, cliquez sur Calcul, puis sur Gérer à côté des Entrepôts SQL. Dans le paramètre Paramètres de configuration SQL, ajoutez un paramètre de configuration où la valeur du délai d’expiration est en secondes.

-- Set a workspace-level timeout
> STATEMENT_TIMEOUT 86400

Délai d’expiration au niveau de l’entrepôt

Vous pouvez définir un délai d’expiration d’instruction sur un seul entrepôt SQL afin que différents entrepôts puissent appliquer des délais d’expiration différents à leurs requêtes. Par exemple, définissez un délai d’expiration plus long sur un entrepôt ETL et un délai d’attente plus court sur un entrepôt BI.

Important

Les délais d’expiration des instructions au niveau de l’entrepôt sont en version bêta. Un administrateur d’espace de travail doit activer l’aperçu du délai d’expiration des instructions de l’entrepôt à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Définissez un délai d’expiration au niveau de l’entrepôt avec le statement_timeout champ dans les API créer ou mettre à jour l’entrepôt. La valeur est en secondes. Pour supprimer un délai d’expiration au niveau de l’entrepôt, définissez le champ sur 0.

Lorsque vous changez statement_timeout avec l’API De l’entrepôt de mise à jour, l’entrepôt redémarre automatiquement afin que la nouvelle valeur prenne effet.

Pour vérifier le délai d’expiration actuellement en vigueur sur l’entrepôt auquel vous êtes connecté, exécutez les opérations suivantes :

SET STATEMENT_TIMEOUT;

Note

La désactivation de l’aperçu du délai d’expiration des instructions de l’entrepôt ne efface statement_timeout pas les valeurs déjà définies sur les entrepôts. Une valeur au niveau de l’entrepôt définie précédemment continue de s’appliquer jusqu’à ce que vous redémarrez l’entrepôt.

  • Last updated on