From 71f0563d1db286ae217d7f5e712b2528614d465d Mon Sep 17 00:00:00 2001
From: Masaki Yatsu <yatsu@yatsu.info>
Date: Wed, 15 Oct 2025 23:08:43 +0900
Subject: [PATCH] docs(metabase): write about Trino integration

---
 metabase/README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/metabase/README.md b/metabase/README.md
index 8d9aa35..7cc23e2 100644
--- a/metabase/README.md
+++ b/metabase/README.md
@@ -18,3 +18,39 @@ just metabase::install
 ## Access
 
 Access Metabase at `https://metabase.yourdomain.com` and complete the initial setup wizard to create an admin account.
+
+## Data Sources
+
+### Trino Integration
+
+Metabase can connect to Trino to query multiple data sources (PostgreSQL, Iceberg tables, etc.) through a unified SQL interface.
+
+**Adding Trino Database**:
+
+1. In Metabase, go to **Admin → Databases → Add database**
+2. Select **Database type**: Starburst
+3. Configure connection:
+
+    ```plain
+    Display name: Trino (PostgreSQL) or Trino (Iceberg)
+    Host: trino.yourdomain.com
+    Port: 443
+    Username: admin
+    Password: [from just trino::admin-password]
+    Catalog: postgresql or iceberg
+    SSL: Yes
+    ```
+
+**Catalog Selection**:
+
+- **postgresql**: Query PostgreSQL database tables
+- **iceberg**: Query Iceberg tables via Lakekeeper REST Catalog
+- You can create multiple connections, one for each catalog
+
+**Getting Trino Admin Password**:
+
+```bash
+just trino::admin-password
+```
+
+For more details, see the [Trino documentation](../trino/README.md).