filter_sql_query
Filter records in a Grist table using conditions, sorting, and pagination without writing SQL. Returns filtered records and query metadata.
Instructions
Exécute une requête SQL de filtrage sur une table Grist.
Version simplifiée pour requêtes SQL courantes sans écrire de SQL. Pour requêtes complexes, utiliser execute_sql_query.
Prérequis recommandés: - list_tables(doc_id) : Vérifier l'existence de la table - list_columns(doc_id, table_id) : Connaître les colonnes disponibles
Alternative à: - list_records : Quand vous avez besoin de filtrer/trier - execute_sql_query : Version simplifiée pour cas courants
Flux de travail typique: 1. list_columns(doc_id, table_id) → identifier les colonnes 2. filter_sql_query(doc_id, table_id, where_conditions={"status": "actif"}, order_by="date_creation DESC", limit=10) 3. Traiter les enregistrements retournés
Cas d'usage: - Filtrage simple: where_conditions={"status": "actif"} - Filtrage multiple: where_conditions={"status": "actif", "type": "A"} - Tri: order_by="nom" ou order_by="valeur DESC" - Pagination: limit=20 - Colonnes spécifiques: columns=["nom", "valeur", "date"]
Args: doc_id: ID du document table_id: ID de la table à requêter columns: Liste des colonnes à retourner (None = toutes) where_conditions: Dict de conditions (AND implicite entre conditions) order_by: Colonne de tri avec direction optionnelle (ex: "nom DESC") limit: Nombre max de résultats
Returns: Dict avec les enregistrements filtrés et métadonnées de requête
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| doc_id | Yes | ||
| columns | No | ||
| order_by | No | ||
| table_id | Yes | ||
| where_conditions | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||