> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/logic-steps/sql-query.md).

# Exécuter une requête SQL

Interrogez directement votre base de données depuis un workflow

L’étape SQL Query vous permet d’exécuter des requêtes directement sur les bases de données connectées. Elle peut être utile pour intégrer des données à vos workflows, ou même pour créer des workflows conçus pour écrire directement dans vos bases de données.

## Configuration d’une étape « SQL Query »

L’étape SQL Query est assez simple à configurer. Le seul prérequis est d’avoir connecté une base de données SQL avec un utilisateur en lecture seule. Consultez notre page de documentation sur la [Connexion des sources de données](https://docs.airops.com/docs/fr/contexte/knowledge-bases/add-data/import-from-sql-database/data-sources.md) pour en savoir plus.

Une fois la source de données connectée, vous pouvez ajouter une étape SQL Query à vos workflows, comme illustré ci-dessous :

{% @arcade/embed url="<https://app.arcade.software/share/10JanDKu9KE0Ahb7n7Fp>" flowId="10JanDKu9KE0Ahb7n7Fp" %}

L’un des cas d’utilisation les plus intéressants de notre étape SQL Query consiste à utiliser un agent pour vous aider à rédiger et à modifier vos propres requêtes. Cette fonctionnalité a rencontré un tel succès que nous avons créé notre modèle d’agent « Data Sidekick » autour de celle-ci.

À mesure que vous approfondissez vos cas d’utilisation, nous vous recommandons de jeter un rapide coup d’œil aux coulisses :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-fc285546ee3b693fb51ce6e6712b54b78b6cc005%2Fsql-step-01-example.png?alt=media" alt="Launch Pricing Analyst Workflow with a SQL Query step that selects launches from the SpaceOps Warehouse, a Run Code step that formats the rows, and a Prompt LLM step that answers the question"><figcaption><p>Une étape SQL Query transmet des lignes au reste du workflow.</p></figcaption></figure>

## Erreurs de délai d’expiration des requêtes

Si le connecteur de base de données atteint sa limite de requête de 300 secondes, l’étape affiche **The query timed out after 300 seconds**. Vérifiez la requête et les performances de la base de données, ou réduisez la quantité de données demandée avant de réessayer. Une nouvelle tentative n’augmente pas le délai d’expiration du connecteur.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/logic-steps/sql-query.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
