This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/iceberg-go.git
The following commit(s) were added to refs/heads/gh-pages by this push:
new 503e63373 deploy: e0c37e68929117b4ead9815be5d24bd7f2a6f37c
503e63373 is described below
commit 503e63373dbaedda3e201b1a557d2f588839db6d
Author: laskoviymishka <[email protected]>
AuthorDate: Sun Oct 25 09:09:43 2026 +0000
deploy: e0c37e68929117b4ead9815be5d24bd7f2a6f37c
---
api.html | 4 ++++
configuration.html | 2 +-
print.html | 9 ++++++++-
releases.html | 3 +++
searchindex.js | 2 +-
searchindex.json | 2 +-
6 files changed, 18 insertions(+), 4 deletions(-)
diff --git a/api.html b/api.html
index 961e044d9..bf5b1fd8a 100644
--- a/api.html
+++ b/api.html
@@ -303,7 +303,11 @@ cat, err := catalog.Load(ctx, "default",
iceberg.Properties{
"uri": "http://localhost:8181",
"warehouse": "s3://my-bucket/warehouse",
})
+if err != nil { panic(err) }
+defer cat.Close()
</code></pre>
+<p>Every catalog implements <code>Close() error</code>. Close it when done to
release catalog-owned
+resources. A caller-supplied database connection remains caller-owned.</p>
<h3 id="namespaces"><a class="header" href="#namespaces">Namespaces</a></h3>
<pre><code class="language-go">ns := table.Identifier{"sales"}
diff --git a/configuration.html b/configuration.html
index cb97cca7f..b0298393c 100644
--- a/configuration.html
+++ b/configuration.html
@@ -501,7 +501,7 @@ func init() {
))
}
</code></pre>
-<p>After registration, <code>catalog.Load(ctx, "default",
iceberg.Properties{"type": "mycatalog", ...})</code> will
route to the factory. Built-in types: <code>rest</code>, <code>hive</code>,
<code>glue</code>, <code>sql</code>, <code>hadoop</code>.</p>
+<p>After registration, <code>catalog.Load(ctx, "default",
iceberg.Properties{"type": "mycatalog", ...})</code> will
route to the factory. Custom catalogs must implement <code>Close() error</code>
to satisfy <code>catalog.Catalog</code>, and callers must close them when
finished. Built-in types: <code>rest</code>, <code>hive</code>,
<code>glue</code>, <code>sql</code>, <code>hadoop</code>.</p>
<p><code>catalog.GetRegisteredCatalogs()</code> returns the current list;
<code>catalog.Unregister(catalogType)</code> removes one.</p>
<h3 id="locationprovider"><a class="header"
href="#locationprovider">LocationProvider</a></h3>
<p><a
href="https://github.com/apache/iceberg-go/blob/main/table/locations.go";><code>table/locations.go</code></a>
defines the <code>LocationProvider</code> interface and ships two
implementations: <code>simpleLocationProvider</code> (default) and
<code>objectStoreLocationProvider</code> (selected by
<code>write.object-storage.enabled = true</code>). The provider is chosen by
table properties and is not user-pluggable today.</p>
diff --git a/print.html b/print.html
index 13771fe00..676e1e878 100644
--- a/print.html
+++ b/print.html
@@ -788,7 +788,7 @@ func init() {
))
}
</code></pre>
-<p>After registration, <code>catalog.Load(ctx, "default",
iceberg.Properties{"type": "mycatalog", ...})</code> will
route to the factory. Built-in types: <code>rest</code>, <code>hive</code>,
<code>glue</code>, <code>sql</code>, <code>hadoop</code>.</p>
+<p>After registration, <code>catalog.Load(ctx, "default",
iceberg.Properties{"type": "mycatalog", ...})</code> will
route to the factory. Custom catalogs must implement <code>Close() error</code>
to satisfy <code>catalog.Catalog</code>, and callers must close them when
finished. Built-in types: <code>rest</code>, <code>hive</code>,
<code>glue</code>, <code>sql</code>, <code>hadoop</code>.</p>
<p><code>catalog.GetRegisteredCatalogs()</code> returns the current list;
<code>catalog.Unregister(catalogType)</code> removes one.</p>
<h3 id="locationprovider"><a class="header"
href="#locationprovider">LocationProvider</a></h3>
<p><a
href="https://github.com/apache/iceberg-go/blob/main/table/locations.go";><code>table/locations.go</code></a>
defines the <code>LocationProvider</code> interface and ships two
implementations: <code>simpleLocationProvider</code> (default) and
<code>objectStoreLocationProvider</code> (selected by
<code>write.object-storage.enabled = true</code>). The provider is chosen by
table properties and is not user-pluggable today.</p>
@@ -1254,7 +1254,11 @@ cat, err := catalog.Load(ctx, "default",
iceberg.Properties{
"uri": "http://localhost:8181",
"warehouse": "s3://my-bucket/warehouse",
})
+if err != nil { panic(err) }
+defer cat.Close()
</code></pre>
+<p>Every catalog implements <code>Close() error</code>. Close it when done to
release catalog-owned
+resources. A caller-supplied database connection remains caller-owned.</p>
<h3 id="namespaces"><a class="header" href="#namespaces">Namespaces</a></h3>
<pre><code class="language-go">ns := table.Identifier{"sales"}
@@ -2600,6 +2604,9 @@ make integration-external-rest
<p><strong>Transform formatting requires the result type.</strong>
<code>Transform.ToHumanStr(value)</code> is removed. Use
<code>Transform.ToHumanStrType(resultType, value)</code> to format partition
values, including timestamps with time zones.</p>
</li>
<li>
+<p><strong>Catalogs now require cleanup.</strong> The
<code>catalog.Catalog</code> interface includes <code>Close() error</code>.
Custom catalog implementations must provide <code>Close</code>, and callers
should close catalog instances after use. <code>catalog.Closer</code> remains
available as an alias for <code>io.Closer</code>.</p>
+</li>
+<li>
<p><strong>Puffin writer property setter renamed.</strong>
<code>puffin.Writer.AddProperties</code> is now
<code>puffin.Writer.SetProperties</code>. Repeated calls still merge keys; use
<code>ClearProperties</code> to clear custom properties before finishing.</p>
</li>
<li>
diff --git a/releases.html b/releases.html
index a650fbb0b..ee52ec8a9 100644
--- a/releases.html
+++ b/releases.html
@@ -264,6 +264,9 @@
<p><strong>Transform formatting requires the result type.</strong>
<code>Transform.ToHumanStr(value)</code> is removed. Use
<code>Transform.ToHumanStrType(resultType, value)</code> to format partition
values, including timestamps with time zones.</p>
</li>
<li>
+<p><strong>Catalogs now require cleanup.</strong> The
<code>catalog.Catalog</code> interface includes <code>Close() error</code>.
Custom catalog implementations must provide <code>Close</code>, and callers
should close catalog instances after use. <code>catalog.Closer</code> remains
available as an alias for <code>io.Closer</code>.</p>
+</li>
+<li>
<p><strong>Puffin writer property setter renamed.</strong>
<code>puffin.Writer.AddProperties</code> is now
<code>puffin.Writer.SetProperties</code>. Repeated calls still merge keys; use
<code>ClearProperties</code> to clear custom properties before finishing.</p>
</li>
<li>
diff --git a/searchindex.js b/searchindex.js
index 250b8943c..d2eac2153 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Object.assign(window.search,
{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#
[...]
\ No newline at end of file
+Object.assign(window.search,
{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#
[...]
\ No newline at end of file
diff --git a/searchindex.json b/searchindex.json
index bb447be29..89e717e0b 100644
--- a/searchindex.json
+++ b/searchindex.json
@@ -1 +1 @@
-{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#4-write-some-arrow-data","get
[...]
\ No newline at end of file
+{"doc_urls":["introduction.html#iceberg-go","introduction.html#where-to-start","introduction.html#what-works-today","introduction.html#beyond-go","introduction.html#help-and-contribution","install.html#install","install.html#requirements","install.html#installation","getting-started.html#getting-started","getting-started.html#1-install","getting-started.html#2-open-a-local-catalog","getting-started.html#3-create-a-namespace-and-a-table","getting-started.html#4-write-some-arrow-data","get
[...]
\ No newline at end of file
