You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iceberg.apache.org by sz...@apache.org on 2025/03/24 00:55:37 UTC
(iceberg) branch main updated: Spec: Geo spec simplifications (#12533)
This is an automated email from the ASF dual-hosted git repository.
szehon pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg.git
The following commit(s) were added to refs/heads/main by this push:
new 1a94bc0346 Spec: Geo spec simplifications (#12533)
1a94bc0346 is described below
commit 1a94bc0346cb1cdc2cb60d1a666564693e83aed5
Author: Szehon Ho <sz...@gmail.com>
AuthorDate: Sun Mar 23 17:55:31 2025 -0700
Spec: Geo spec simplifications (#12533)
---
format/spec.md | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/format/spec.md b/format/spec.md
index 004eef7e93..7d8777f8e4 100644
--- a/format/spec.md
+++ b/format/spec.md
@@ -266,7 +266,7 @@ The `initial-default` is set only when a field is added to an existing schema. T
The `initial-default` and `write-default` produce SQL default value behavior, without rewriting data files. SQL default value behavior when a field is added handles all existing rows as though the rows were written with the new field's default value. Default value changes may only affect future records and all known fields are written into data files. Omitting a known field when writing a data file is never allowed. The write default for a field must be written if a field is not supplied [...]
-All columns of `unknown` type must default to null. Non-null values for `initial-default` or `write-default` are invalid.
+All columns of `unknown`, `geometry`, and `geography` types must default to null. Non-null values for `initial-default` or `write-default` are invalid.
Default values are attributes of fields in schemas and serialized with fields in the JSON format. See [Appendix C](#appendix-c-json-serialization).
@@ -1395,8 +1395,8 @@ Types are serialized according to this table:
|**`list`**|`JSON object: {`<br /> `"type": "list",`<br /> `"element-id": <id int>,`<br /> `"element-required": <bool>`<br /> `"element": <type JSON>`<br />`}`|`{`<br /> `"type": "list",`<br /> `"element-id": 3,`<br /> `"element-required": true,`<br /> `"element": "string"`<br />`}`|
|**`map`**|`JSON object: {`<br /> `"type": "map",`<br /> `"key-id": <key id int>,`<br /> `"key": <type JSON>,`<br /> `"value-id": <val id int>,`<br /> `"value-required": <bool>`<br /> `"value": <type JSON>`<br />`}`|`{`<br /> `"type": "map",`<br /> `"key-id": 4,`<br /> `"key": "string",`<br /> `"value-id": 5,`<br /> `"value-required": false,`<br /> `"value": [...]
| **`variant`**| `JSON string: "variant"`|`"variant"`|
-| **`geometry(C)`** | `JSON object: {`<br /> `"type": "geometry",`<br /> `"crs": <C>`<br />`}` | `{`<br /> `"type": "geometry",`<br /> `"crs": "srid:4326"`<br />`}` |
-| **`geography(C, A)`** | `JSON object: {`<br /> `"type": "geography",`<br /> `"crs": <C>,`<br /> `"algorithm": <A>`<br />}` | `{`<br /> `"type": "geography",`<br /> `"crs": "srid:4326",`<br /> `"algorithm": "spherical"` <br /> `}` |
+| **`geometry(C)`** |`JSON string: "geometry(<C>)"`|`"geometry(srid:4326)"`|
+| **`geography(C, A)`** |`JSON string: "geography(<C>,<E>)"`|`"geography(srid:4326,spherical)"`|
Note that default values are serialized using the JSON single-value serialization in [Appendix D](#appendix-d-single-value-serialization).