feat: allow logging the SQL query to stderr

- Logs the main SQL query when `log-query=main-query`. - Only logs at the current `log-level`.
2025-02-18 19:17:26 -05:00
parent 66e966d864
commit 9c880c082a
32 changed files with 267 additions and 48 deletions
@@ -708,6 +708,30 @@ log-level

  Because currently there's no buffering for logging, the levels with minimal logging(``crit/error``) will increase throughput.

+.. _log-query:
+
+log-query
+---------
+
+  =============== =================================
+  **Type**        String
+  **Default**     "disabled"
+  **Reloadable**  Y
+  **Environment** PGRST_LOG_QUERY
+  **In-Database** `n/a`
+  =============== =================================
+
+  Logs the SQL query for the corresponding request at the current :ref:`log-level`.
+  See :ref:``sql_query_logs``.
+
+    .. code:: bash
+
+        # Logs the main SQL query
+        log-query = "main-query"
+
+        # Disables logging the SQL query
+        log-query = "disabled"
+
 .. _openapi-mode:

 openapi-mode