From ec2eaa768569d7c89ee41defe30c9378e8ccec36 Mon Sep 17 00:00:00 2001 From: Mathieu Arnold Date: Fri, 17 Jul 2026 11:37:42 +0200 Subject: [PATCH] Add attach instructions for duckdb iceberg integration --- DuckDB-Iceberg-Integration.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/DuckDB-Iceberg-Integration.md b/DuckDB-Iceberg-Integration.md index 5d15764..b75ef71 100644 --- a/DuckDB-Iceberg-Integration.md +++ b/DuckDB-Iceberg-Integration.md @@ -118,6 +118,25 @@ SELECT * FROM iceberg_scan('s3://my-catalog/my-namespace/my-table'); SELECT * FROM iceberg_scan('s3://my-catalog/my-namespace/my-table/metadata/v1.metadata.json'); ``` +## "Attaching" the catalog + +Once secrets are configured, it is possible to attach the catalog for direct access: + +```sql +ATTACH 's3://my-catalog' AS my_catalog( + TYPE iceberg, + SECRET iceberg_secret, + ENDPOINT 'http://localhost:8181', + READ_ONLY false +); + +SELECT * FROM my_catalog.my-namespace.my-table; + +INSERT INTO my_catalog.my-namespace.my-table VALUES (...); +``` + +Note that remote catalogs are mounted read-only by default, so if you need to be able to modify things, you need the `READ_ONLY false`. If you only need to read, no need to add the `READ_ONLY false`. + ## Configuration Reference | Parameter | Description | Default |