From e89985256583c67401473eb0e6a41bfc913886d5 Mon Sep 17 00:00:00 2001 From: Abdullah Kaya Date: Sat, 5 Sep 2026 18:25:18 +0300 Subject: [PATCH 1/3] doc/user: add LibreDB Studio to SQL clients LibreDB Studio connects to Materialize over the PostgreSQL wire protocol. The SQL editor works fully, including Materialize specific statements. The object browser and monitoring dashboard both depend on PostgreSQL catalog objects Materialize does not have, so those two are called out as not working rather than left to be discovered. --- doc/user/content/integrations/sql-clients.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/user/content/integrations/sql-clients.md b/doc/user/content/integrations/sql-clients.md index 9c9d9d16e0220..938f8e379337a 100644 --- a/doc/user/content/integrations/sql-clients.md +++ b/doc/user/content/integrations/sql-clients.md @@ -164,6 +164,23 @@ Materialize console. Screenshot 2023-12-28 at 18 45 11 +### LibreDB Studio + +{{< warning >}} +Only the SQL editor is fully supported today. The object/schema browser and the +monitoring dashboard both depend on PostgreSQL catalog objects Materialize does +not have: `MATERIALIZED` is a reserved keyword that breaks LibreDB Studio's +schema-introspection query, and `pg_stat_activity`/`pg_statio_user_tables` do +not exist, so the monitoring panel reports a connection error rather than +data. Running queries, including Materialize-specific statements like `SHOW +MATERIALIZED VIEWS` and `SHOW SOURCES`, works normally. +{{< /warning >}} + +To connect to Materialize using [LibreDB Studio](https://github.com/libredb/libredb-studio), +an open-source, browser-based SQL IDE, choose the **PostgreSQL** driver in the +connection dialog and use the credentials from the Materialize console (host, +port **6875**, your app password, SSL mode **Require**). + ### `psql` {{< warning >}} From 7c3ac80b7fc1f8011aa3c23138f74f17f5739b83 Mon Sep 17 00:00:00 2001 From: Abdullah Kaya Date: Sat, 5 Sep 2026 18:32:11 +0300 Subject: [PATCH 2/3] doc/user: embed the LibreDB Studio connection screenshot --- doc/user/content/integrations/sql-clients.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/user/content/integrations/sql-clients.md b/doc/user/content/integrations/sql-clients.md index 938f8e379337a..2309d8c86c2ef 100644 --- a/doc/user/content/integrations/sql-clients.md +++ b/doc/user/content/integrations/sql-clients.md @@ -181,6 +181,8 @@ an open-source, browser-based SQL IDE, choose the **PostgreSQL** driver in the connection dialog and use the credentials from the Materialize console (host, port **6875**, your app password, SSL mode **Require**). +Connect using the credentials provided in the Materialize console + ### `psql` {{< warning >}} From 47c2fcac4085ab62038e4d9e9c4796b67cd029f0 Mon Sep 17 00:00:00 2001 From: Abdullah Kaya Date: Sun, 6 Sep 2026 21:57:02 +0300 Subject: [PATCH 3/3] doc/user: reflect LibreDB Studio's fixed schema browser support The object browser and monitoring dashboard restrictions documented here were bugs in LibreDB Studio, fixed upstream in libredb/libredb-studio#578. Update the tip to describe current behavior instead of the outdated restrictions. --- doc/user/content/integrations/sql-clients.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/doc/user/content/integrations/sql-clients.md b/doc/user/content/integrations/sql-clients.md index 2309d8c86c2ef..eb5aecce69345 100644 --- a/doc/user/content/integrations/sql-clients.md +++ b/doc/user/content/integrations/sql-clients.md @@ -166,15 +166,11 @@ Materialize console. ### LibreDB Studio -{{< warning >}} -Only the SQL editor is fully supported today. The object/schema browser and the -monitoring dashboard both depend on PostgreSQL catalog objects Materialize does -not have: `MATERIALIZED` is a reserved keyword that breaks LibreDB Studio's -schema-introspection query, and `pg_stat_activity`/`pg_statio_user_tables` do -not exist, so the monitoring panel reports a connection error rather than -data. Running queries, including Materialize-specific statements like `SHOW -MATERIALIZED VIEWS` and `SHOW SOURCES`, works normally. -{{< /warning >}} +{{< tip >}} +The object browser lists Materialize's tables, views, and materialized views +along with their columns, and the SQL editor supports Materialize-specific +statements like `SHOW MATERIALIZED VIEWS` and `SHOW SOURCES`. +{{< /tip >}} To connect to Materialize using [LibreDB Studio](https://github.com/libredb/libredb-studio), an open-source, browser-based SQL IDE, choose the **PostgreSQL** driver in the