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 2025/07/25 16:24:46 UTC
(iceberg-go) branch gh-pages updated: deploy: b4babc8b919258be7b25f5cc295fc68a458f9559
This is an automated email from the ASF dual-hosted git repository.
github-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 666da99 deploy: b4babc8b919258be7b25f5cc295fc68a458f9559
666da99 is described below
commit 666da9919deb81b818228490da87451a1eb3edcb
Author: zeroshade <ze...@users.noreply.github.com>
AuthorDate: Fri Jul 25 16:24:40 2025 +0000
deploy: b4babc8b919258be7b25f5cc295fc68a458f9559
---
api.html | 20 +++++++++---------
cli.html | 42 ++++++++++++++++++++++++++++++++++++++
print.html | 62 +++++++++++++++++++++++++++++++++++++++++++++++---------
searchindex.js | 2 +-
searchindex.json | 2 +-
5 files changed, 106 insertions(+), 22 deletions(-)
diff --git a/api.html b/api.html
index 5087f9c..ff1cdbf 100644
--- a/api.html
+++ b/api.html
@@ -203,7 +203,7 @@
<li>Create and list namespaces.</li>
<li>Create, load, and drop tables</li>
</ul>
-<p>Currently only rest catalog has been implemented, and other catalogs are under active development. Here is an
+<p>Currently, only the REST catalog has been implemented, and other catalogs are under active development. Here is an
example of how to create a <code>RestCatalog</code>:</p>
<pre><code class="language-go">import (
"context"
@@ -218,7 +218,7 @@ if err != nil {
log.Fatal(err)
}
</code></pre>
-<p>You can run following code to list all root namespaces:</p>
+<p>You can run the following code to list all root namespaces:</p>
<pre><code class="language-go">// List all root namespaces
namespaces, err := cat.ListNamespaces(context.Background(), nil)
if err != nil {
@@ -229,7 +229,7 @@ for _, ns := range namespaces {
fmt.Printf("Namespace: %v\n", ns)
}
</code></pre>
-<p>Then you can run following code to create namespace:</p>
+<p>Then you can run the following code to create namespace:</p>
<pre><code class="language-go">// Create a namespace
namespace := catalog.ToIdentifier("my_namespace")
err = cat.CreateNamespace(context.Background(), namespace, nil)
@@ -276,7 +276,7 @@ if err != nil {
// Create Glue catalog
cat := glue.NewCatalog(glue.WithAwsConfig(awsCfg))
-// Create table in Glue
+// Create a table in Glue
tableIdent := catalog.ToIdentifier("my_database", "my_table")
tbl, err := cat.CreateTable(
context.Background(),
@@ -290,7 +290,7 @@ if err != nil {
</code></pre>
<h1 id="table"><a class="header" href="#table">Table</a></h1>
<p>After creating <code>Catalog</code>, we can manipulate tables through <code>Catalog</code>.</p>
-<p>You can use following code to create a table:</p>
+<p>You can use the following code to create a table:</p>
<pre><code class="language-go">import (
"github.com/apache/iceberg-go"
"github.com/apache/iceberg-go/catalog"
@@ -304,10 +304,10 @@ schema := iceberg.NewSchemaWithIdentifiers(1, []int{2},
iceberg.NestedField{ID: 3, Name: "baz", Type: iceberg.PrimitiveTypes.Bool, Required: false},
)
-// Create table identifier
+// Create a table identifier
tableIdent := catalog.ToIdentifier("my_namespace", "my_table")
-// Create table with optional properties
+// Create a table with optional properties
tbl, err := cat.CreateTable(
context.Background(),
tableIdent,
@@ -409,7 +409,7 @@ fmt.Printf("Number of fields: %d\n", schema.NumFields())
props := tbl.Properties()
fmt.Printf("Owner: %s\n", props["owner"])
-// Access current snapshot
+// Access the current snapshot
if snapshot := tbl.CurrentSnapshot(); snapshot != nil {
fmt.Printf("Current snapshot ID: %d\n", snapshot.SnapshotID)
fmt.Printf("Snapshot timestamp: %d\n", snapshot.TimestampMs)
@@ -434,12 +434,12 @@ schema := iceberg.NewSchemaWithIdentifiers(1, []int{1},
iceberg.NestedField{ID: 3, Name: "date", Type: iceberg.PrimitiveTypes.Date, Required: false},
)
-// Create partition spec
+// Create a partition spec
partitionSpec := iceberg.NewPartitionSpec(
iceberg.PartitionField{SourceID: 3, FieldID: 1000, Transform: iceberg.IdentityTransform{}, Name: "date"},
)
-// Create table with partitioning
+// Create a table with partitioning
tbl, err := cat.CreateTable(
context.Background(),
tableIdent,
diff --git a/cli.html b/cli.html
index 8cc625a..8943368 100644
--- a/cli.html
+++ b/cli.html
@@ -225,6 +225,48 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
└───────────┘
+</code></pre>
+<p><strong>Create Table</strong></p>
+<ul>
+<li>Notes: Only identity transform is supported at this moment</li>
+</ul>
+<pre><code># Create a simple table with REST catalog and Minio
+./iceberg create table default.table-1
+ --properties write.format.default=parquet \
+ --partition-spec foo \
+ --sort-order foo:desc:nulls-last \
+ --schema '[{"id":1,"name":"foo","type":"string","required":false},{"id":2,"name":"bar","type":"int","required":true}]' \
+ --catalog rest \
+ --uri http://localhost:8181
+Table default.table-1 created successfully
+
+# Describe the newly created table
+./iceberg describe --catalog rest --uri http://localhost:8181 default.table-1
+Table format version | 2
+Metadata location | s3://warehouse/default/table-1/metadata/00000-f0ccaadd-d988-482e-99da-3a37870288fe.metadata.json
+Table UUID | 33fa3fac-e638-4335-a085-343c6d9e7de5
+Last updated | 1753133512562
+Sort Order | 1: [
+ | 1 desc nulls-last
+ | ]
+Partition Spec | [
+ | 1000: foo: identity(1)
+ | ]
+
+Current Schema, id=0
+├──1: foo: optional string
+└──2: bar: required int
+
+Current Snapshot |
+
+Snapshots
+
+Properties
+key | value
+-----------------------------------------
+write.format.default | parquet
+write.parquet.compression-codec | zstd
+
</code></pre>
</main>
diff --git a/print.html b/print.html
index adea149..3861fa4 100644
--- a/print.html
+++ b/print.html
@@ -351,6 +351,48 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
└───────────┘
+</code></pre>
+<p><strong>Create Table</strong></p>
+<ul>
+<li>Notes: Only identity transform is supported at this moment</li>
+</ul>
+<pre><code># Create a simple table with REST catalog and Minio
+./iceberg create table default.table-1
+ --properties write.format.default=parquet \
+ --partition-spec foo \
+ --sort-order foo:desc:nulls-last \
+ --schema '[{"id":1,"name":"foo","type":"string","required":false},{"id":2,"name":"bar","type":"int","required":true}]' \
+ --catalog rest \
+ --uri http://localhost:8181
+Table default.table-1 created successfully
+
+# Describe the newly created table
+./iceberg describe --catalog rest --uri http://localhost:8181 default.table-1
+Table format version | 2
+Metadata location | s3://warehouse/default/table-1/metadata/00000-f0ccaadd-d988-482e-99da-3a37870288fe.metadata.json
+Table UUID | 33fa3fac-e638-4335-a085-343c6d9e7de5
+Last updated | 1753133512562
+Sort Order | 1: [
+ | 1 desc nulls-last
+ | ]
+Partition Spec | [
+ | 1000: foo: identity(1)
+ | ]
+
+Current Schema, id=0
+├──1: foo: optional string
+└──2: bar: required int
+
+Current Snapshot |
+
+Snapshots
+
+Properties
+key | value
+-----------------------------------------
+write.format.default | parquet
+write.parquet.compression-codec | zstd
+
</code></pre>
<div style="break-before: page; page-break-before: always;"></div><!--
~ Licensed to the Apache Software Foundation (ASF) under one
@@ -376,7 +418,7 @@ docker run -p 8181:8181 apache/iceberg-rest-fixture:latest
<li>Create and list namespaces.</li>
<li>Create, load, and drop tables</li>
</ul>
-<p>Currently only rest catalog has been implemented, and other catalogs are under active development. Here is an
+<p>Currently, only the REST catalog has been implemented, and other catalogs are under active development. Here is an
example of how to create a <code>RestCatalog</code>:</p>
<pre><code class="language-go">import (
"context"
@@ -391,7 +433,7 @@ if err != nil {
log.Fatal(err)
}
</code></pre>
-<p>You can run following code to list all root namespaces:</p>
+<p>You can run the following code to list all root namespaces:</p>
<pre><code class="language-go">// List all root namespaces
namespaces, err := cat.ListNamespaces(context.Background(), nil)
if err != nil {
@@ -402,7 +444,7 @@ for _, ns := range namespaces {
fmt.Printf("Namespace: %v\n", ns)
}
</code></pre>
-<p>Then you can run following code to create namespace:</p>
+<p>Then you can run the following code to create namespace:</p>
<pre><code class="language-go">// Create a namespace
namespace := catalog.ToIdentifier("my_namespace")
err = cat.CreateNamespace(context.Background(), namespace, nil)
@@ -449,7 +491,7 @@ if err != nil {
// Create Glue catalog
cat := glue.NewCatalog(glue.WithAwsConfig(awsCfg))
-// Create table in Glue
+// Create a table in Glue
tableIdent := catalog.ToIdentifier("my_database", "my_table")
tbl, err := cat.CreateTable(
context.Background(),
@@ -463,7 +505,7 @@ if err != nil {
</code></pre>
<h1 id="table"><a class="header" href="#table">Table</a></h1>
<p>After creating <code>Catalog</code>, we can manipulate tables through <code>Catalog</code>.</p>
-<p>You can use following code to create a table:</p>
+<p>You can use the following code to create a table:</p>
<pre><code class="language-go">import (
"github.com/apache/iceberg-go"
"github.com/apache/iceberg-go/catalog"
@@ -477,10 +519,10 @@ schema := iceberg.NewSchemaWithIdentifiers(1, []int{2},
iceberg.NestedField{ID: 3, Name: "baz", Type: iceberg.PrimitiveTypes.Bool, Required: false},
)
-// Create table identifier
+// Create a table identifier
tableIdent := catalog.ToIdentifier("my_namespace", "my_table")
-// Create table with optional properties
+// Create a table with optional properties
tbl, err := cat.CreateTable(
context.Background(),
tableIdent,
@@ -582,7 +624,7 @@ fmt.Printf("Number of fields: %d\n", schema.NumFields())
props := tbl.Properties()
fmt.Printf("Owner: %s\n", props["owner"])
-// Access current snapshot
+// Access the current snapshot
if snapshot := tbl.CurrentSnapshot(); snapshot != nil {
fmt.Printf("Current snapshot ID: %d\n", snapshot.SnapshotID)
fmt.Printf("Snapshot timestamp: %d\n", snapshot.TimestampMs)
@@ -607,12 +649,12 @@ schema := iceberg.NewSchemaWithIdentifiers(1, []int{1},
iceberg.NestedField{ID: 3, Name: "date", Type: iceberg.PrimitiveTypes.Date, Required: false},
)
-// Create partition spec
+// Create a partition spec
partitionSpec := iceberg.NewPartitionSpec(
iceberg.PartitionField{SourceID: 3, FieldID: 1000, Transform: iceberg.IdentityTransform{}, Name: "date"},
)
-// Create table with partitioning
+// Create a table with partitioning
tbl, err := cat.CreateTable(
context.Background(),
tableIdent,
diff --git a/searchindex.js b/searchindex.js
index 09cbf13..d32f869 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Object.assign(window.search, {"doc_urls":["introduction.html#iceberg-go","introduction.html#feature-support--roadmap","introduction.html#filesystem-support","introduction.html#metadata","introduction.html#catalog-support","introduction.html#readwrite-data-support","introduction.html#get-in-touch","install.html#install","install.html#requirements","install.html#installation","cli.html#cli","api.html#catalog","api.html#other-catalog-types","api.html#sql-catalog","api.html#glue-catalog","ap [...]
\ No newline at end of file
+Object.assign(window.search, {"doc_urls":["introduction.html#iceberg-go","introduction.html#feature-support--roadmap","introduction.html#filesystem-support","introduction.html#metadata","introduction.html#catalog-support","introduction.html#readwrite-data-support","introduction.html#get-in-touch","install.html#install","install.html#requirements","install.html#installation","cli.html#cli","api.html#catalog","api.html#other-catalog-types","api.html#sql-catalog","api.html#glue-catalog","ap [...]
\ No newline at end of file
diff --git a/searchindex.json b/searchindex.json
index 4fea905..9a27776 100644
--- a/searchindex.json
+++ b/searchindex.json
@@ -1 +1 @@
-{"doc_urls":["introduction.html#iceberg-go","introduction.html#feature-support--roadmap","introduction.html#filesystem-support","introduction.html#metadata","introduction.html#catalog-support","introduction.html#readwrite-data-support","introduction.html#get-in-touch","install.html#install","install.html#requirements","install.html#installation","cli.html#cli","api.html#catalog","api.html#other-catalog-types","api.html#sql-catalog","api.html#glue-catalog","api.html#table","api.html#schem [...]
\ No newline at end of file
+{"doc_urls":["introduction.html#iceberg-go","introduction.html#feature-support--roadmap","introduction.html#filesystem-support","introduction.html#metadata","introduction.html#catalog-support","introduction.html#readwrite-data-support","introduction.html#get-in-touch","install.html#install","install.html#requirements","install.html#installation","cli.html#cli","api.html#catalog","api.html#other-catalog-types","api.html#sql-catalog","api.html#glue-catalog","api.html#table","api.html#schem [...]
\ No newline at end of file