You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iceberg.apache.org by gi...@apache.org on 2026/08/13 11:02:05 UTC
(iceberg-go) branch gh-pages updated: deploy: 96be8837cd1923367f88f437ef757c731d16772e
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 db52592ec deploy: 96be8837cd1923367f88f437ef757c731d16772e
db52592ec is described below
commit db52592ec17a1608e46590040ae83e42aa19af16
Author: laskoviymishka <la...@users.noreply.github.com>
AuthorDate: Thu Aug 13 11:02:00 2026 +0000
deploy: 96be8837cd1923367f88f437ef757c731d16772e
---
cli.html | 15 +++++++++++++--
configuration.html | 4 +++-
print.html | 19 ++++++++++++++++---
searchindex.js | 2 +-
searchindex.json | 2 +-
5 files changed, 34 insertions(+), 8 deletions(-)
diff --git a/cli.html b/cli.html
index 1b257f01b..52c407913 100644
--- a/cli.html
+++ b/cli.html
@@ -250,8 +250,8 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
</code></pre>
<p>Catalog connection flags are global and apply to every subcommand:</p>
<div class="table-wrapper"><table><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody>
-<tr><td><code>--catalog</code></td><td>Catalog type: <code>rest</code> (default), <code>glue</code>, <code>hive</code>, <code>hadoop</code></td></tr>
-<tr><td><code>--uri</code></td><td>Catalog URI (REST/Hive)</td></tr>
+<tr><td><code>--catalog</code></td><td>Catalog type: <code>rest</code> (default), <code>glue</code>, <code>hive</code>, <code>hadoop</code>, <code>sql</code>. <code>dynamodb</code> is recognized but not implemented yet.</td></tr>
+<tr><td><code>--uri</code></td><td>Catalog URI (REST/Hive) or SQL DSN</td></tr>
<tr><td><code>--warehouse</code></td><td>Warehouse location</td></tr>
<tr><td><code>--credential</code></td><td>Credentials for the catalog</td></tr>
<tr><td><code>--token</code></td><td>OAuth token (skips OAuth flow)</td></tr>
@@ -259,6 +259,8 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
<tr><td><code>--catalog-name</code></td><td>Catalog name to load from config file (default <code>default</code>)</td></tr>
<tr><td><code>--config</code></td><td>Path to a config file</td></tr>
<tr><td><code>--aws-profile</code></td><td>AWS named profile to use (Glue catalog); overrides <code>aws-profile</code> in the config file</td></tr>
+<tr><td><code>--sql-driver</code></td><td><code>database/sql</code> driver name for the SQL catalog. The default CLI binary only compiles in <code>sqliteshim</code>; other drivers require a custom build.</td></tr>
+<tr><td><code>--sql-dialect</code></td><td>SQL dialect for the SQL catalog. The SQL catalog library supports <code>postgres</code>, <code>mysql</code>, <code>sqlite</code>, <code>mssql</code>, and <code>oracle</code>, but the default CLI binary only ships the <code>sqlite</code> dialect via <code>sqliteshim</code>. Other dialects need a custom build that blank-imports their <code>database/sql</code> drivers.</td></tr>
</tbody></table>
</div>
<p>To avoid passing flags every time, define a config file at <code>~/.iceberg-go.yaml</code>:</p>
@@ -269,6 +271,15 @@ catalog:
uri: http://localhost:8181
warehouse: s3://my-warehouse
</code></pre>
+<p>SQL catalog example:</p>
+<pre><code class="language-yaml">catalog:
+ local:
+ type: sql
+ uri: file:iceberg-catalog.db
+ warehouse: file:///tmp/warehouse
+ sql-driver: sqliteshim
+ sql-dialect: sqlite
+</code></pre>
<p>Flags on the command line override values from the config file.</p>
<h2 id="output-format"><a class="header" href="#output-format">Output format</a></h2>
<p>All commands accept <code>--output text</code> (default, human-readable) or <code>--output json</code> (machine-readable, suitable for piping into <code>jq</code> or scripts).</p>
diff --git a/configuration.html b/configuration.html
index 7e637070b..c0b098fa2 100644
--- a/configuration.html
+++ b/configuration.html
@@ -255,12 +255,14 @@ catalog:
<div class="table-wrapper"><table><thead><tr><th>Key</th><th>Purpose</th></tr></thead><tbody>
<tr><td><code>default-catalog</code></td><td>Name used when <code>--catalog-name</code> is not passed on the CLI.</td></tr>
<tr><td><code>max-workers</code></td><td>Worker pool size for concurrent operations. Default <code>5</code>.</td></tr>
-<tr><td><code>catalog.<name>.type</code></td><td>One of <code>rest</code>, <code>hive</code>, <code>glue</code>, <code>sql</code>, <code>hadoop</code>.</td></tr>
+<tr><td><code>catalog.<name>.type</code></td><td>One of <code>rest</code>, <code>hive</code>, <code>glue</code>, <code>sql</code>, <code>hadoop</code>. <code>dynamodb</code> is recognized by the CLI but not implemented yet.</td></tr>
<tr><td><code>catalog.<name>.uri</code></td><td>Catalog endpoint or DSN.</td></tr>
<tr><td><code>catalog.<name>.warehouse</code></td><td>Warehouse identifier (REST/Glue) or location (Hive/SQL).</td></tr>
<tr><td><code>catalog.<name>.credential</code></td><td>Credential string passed through to the catalog's auth handler.</td></tr>
<tr><td><code>catalog.<name>.output</code></td><td>CLI output format (e.g. <code>text</code>, <code>json</code>).</td></tr>
<tr><td><code>catalog.<name>.aws-profile</code></td><td>AWS named profile for the Glue catalog. When unset, the AWS SDK default credential chain is used.</td></tr>
+<tr><td><code>catalog.<name>.sql-driver</code></td><td><code>database/sql</code> driver name for the SQL catalog. Maps to the <code>sql.driver</code> property. The default CLI binary only compiles in <code>sqliteshim</code>; other drivers require a custom build.</td></tr>
+<tr><td><code>catalog.<name>.sql-dialect</code></td><td>SQL dialect for the SQL catalog (<code>postgres</code>, <code>mysql</code>, <code>sqlite</code>, <code>mssql</code>, <code>oracle</code>). Maps to the <code>sql.dialect</code> property. The default CLI binary only ships <code>sqlite</code> via <code>sqliteshim</code>; other dialects need a custom build with their drivers.</td></tr>
<tr><td><code>catalog.<name>.rest.sigv4-enabled</code></td><td>Enable AWS SigV4 signing for REST.</td></tr>
<tr><td><code>catalog.<name>.rest.signing-name</code></td><td>SigV4 service name.</td></tr>
<tr><td><code>catalog.<name>.rest.signing-region</code></td><td>SigV4 region.</td></tr>
diff --git a/print.html b/print.html
index aa963880e..5128c458d 100644
--- a/print.html
+++ b/print.html
@@ -542,12 +542,14 @@ catalog:
<div class="table-wrapper"><table><thead><tr><th>Key</th><th>Purpose</th></tr></thead><tbody>
<tr><td><code>default-catalog</code></td><td>Name used when <code>--catalog-name</code> is not passed on the CLI.</td></tr>
<tr><td><code>max-workers</code></td><td>Worker pool size for concurrent operations. Default <code>5</code>.</td></tr>
-<tr><td><code>catalog.<name>.type</code></td><td>One of <code>rest</code>, <code>hive</code>, <code>glue</code>, <code>sql</code>, <code>hadoop</code>.</td></tr>
+<tr><td><code>catalog.<name>.type</code></td><td>One of <code>rest</code>, <code>hive</code>, <code>glue</code>, <code>sql</code>, <code>hadoop</code>. <code>dynamodb</code> is recognized by the CLI but not implemented yet.</td></tr>
<tr><td><code>catalog.<name>.uri</code></td><td>Catalog endpoint or DSN.</td></tr>
<tr><td><code>catalog.<name>.warehouse</code></td><td>Warehouse identifier (REST/Glue) or location (Hive/SQL).</td></tr>
<tr><td><code>catalog.<name>.credential</code></td><td>Credential string passed through to the catalog's auth handler.</td></tr>
<tr><td><code>catalog.<name>.output</code></td><td>CLI output format (e.g. <code>text</code>, <code>json</code>).</td></tr>
<tr><td><code>catalog.<name>.aws-profile</code></td><td>AWS named profile for the Glue catalog. When unset, the AWS SDK default credential chain is used.</td></tr>
+<tr><td><code>catalog.<name>.sql-driver</code></td><td><code>database/sql</code> driver name for the SQL catalog. Maps to the <code>sql.driver</code> property. The default CLI binary only compiles in <code>sqliteshim</code>; other drivers require a custom build.</td></tr>
+<tr><td><code>catalog.<name>.sql-dialect</code></td><td>SQL dialect for the SQL catalog (<code>postgres</code>, <code>mysql</code>, <code>sqlite</code>, <code>mssql</code>, <code>oracle</code>). Maps to the <code>sql.dialect</code> property. The default CLI binary only ships <code>sqlite</code> via <code>sqliteshim</code>; other dialects need a custom build with their drivers.</td></tr>
<tr><td><code>catalog.<name>.rest.sigv4-enabled</code></td><td>Enable AWS SigV4 signing for REST.</td></tr>
<tr><td><code>catalog.<name>.rest.signing-name</code></td><td>SigV4 service name.</td></tr>
<tr><td><code>catalog.<name>.rest.signing-region</code></td><td>SigV4 region.</td></tr>
@@ -851,8 +853,8 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
</code></pre>
<p>Catalog connection flags are global and apply to every subcommand:</p>
<div class="table-wrapper"><table><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody>
-<tr><td><code>--catalog</code></td><td>Catalog type: <code>rest</code> (default), <code>glue</code>, <code>hive</code>, <code>hadoop</code></td></tr>
-<tr><td><code>--uri</code></td><td>Catalog URI (REST/Hive)</td></tr>
+<tr><td><code>--catalog</code></td><td>Catalog type: <code>rest</code> (default), <code>glue</code>, <code>hive</code>, <code>hadoop</code>, <code>sql</code>. <code>dynamodb</code> is recognized but not implemented yet.</td></tr>
+<tr><td><code>--uri</code></td><td>Catalog URI (REST/Hive) or SQL DSN</td></tr>
<tr><td><code>--warehouse</code></td><td>Warehouse location</td></tr>
<tr><td><code>--credential</code></td><td>Credentials for the catalog</td></tr>
<tr><td><code>--token</code></td><td>OAuth token (skips OAuth flow)</td></tr>
@@ -860,6 +862,8 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
<tr><td><code>--catalog-name</code></td><td>Catalog name to load from config file (default <code>default</code>)</td></tr>
<tr><td><code>--config</code></td><td>Path to a config file</td></tr>
<tr><td><code>--aws-profile</code></td><td>AWS named profile to use (Glue catalog); overrides <code>aws-profile</code> in the config file</td></tr>
+<tr><td><code>--sql-driver</code></td><td><code>database/sql</code> driver name for the SQL catalog. The default CLI binary only compiles in <code>sqliteshim</code>; other drivers require a custom build.</td></tr>
+<tr><td><code>--sql-dialect</code></td><td>SQL dialect for the SQL catalog. The SQL catalog library supports <code>postgres</code>, <code>mysql</code>, <code>sqlite</code>, <code>mssql</code>, and <code>oracle</code>, but the default CLI binary only ships the <code>sqlite</code> dialect via <code>sqliteshim</code>. Other dialects need a custom build that blank-imports their <code>database/sql</code> drivers.</td></tr>
</tbody></table>
</div>
<p>To avoid passing flags every time, define a config file at <code>~/.iceberg-go.yaml</code>:</p>
@@ -870,6 +874,15 @@ catalog:
uri: http://localhost:8181
warehouse: s3://my-warehouse
</code></pre>
+<p>SQL catalog example:</p>
+<pre><code class="language-yaml">catalog:
+ local:
+ type: sql
+ uri: file:iceberg-catalog.db
+ warehouse: file:///tmp/warehouse
+ sql-driver: sqliteshim
+ sql-dialect: sqlite
+</code></pre>
<p>Flags on the command line override values from the config file.</p>
<h2 id="output-format"><a class="header" href="#output-format">Output format</a></h2>
<p>All commands accept <code>--output text</code> (default, human-readable) or <code>--output json</code> (machine-readable, suitable for piping into <code>jq</code> or scripts).</p>
diff --git a/searchindex.js b/searchindex.js
index f5e763e9d..40ddd56d8 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 d721e15e3..99448b74e 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