cdk-glue-iceberg-table 0.14.2 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.jsii CHANGED
@@ -9751,7 +9751,7 @@
9751
9751
  },
9752
9752
  "name": "cdk-glue-iceberg-table",
9753
9753
  "readme": {
9754
- "markdown": "# cdk-glue-iceberg-table\n\n[![CI](https://img.shields.io/github/actions/workflow/status/ksco92/arceus/ci.yml?branch=main&label=CI)](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[![coverage](https://codecov.io/gh/ksco92/arceus/branch/main/graph/badge.svg)](https://codecov.io/gh/ksco92/arceus)\n[![npm](https://img.shields.io/npm/v/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![PyPI](https://img.shields.io/pypi/v/cdk-glue-iceberg-table.svg)](https://pypi.org/project/cdk-glue-iceberg-table/)\n[![Construct Hub](https://img.shields.io/badge/Construct%20Hub-available-blueviolet)](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[![downloads](https://img.shields.io/npm/dw/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![license](https://img.shields.io/npm/l/cdk-glue-iceberg-table.svg)](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is an AWS CDK L2 construct to create and\nevolve Apache Iceberg tables in the AWS Glue Data Catalog — schema and\npartition changes that survive CloudFormation updates, via cdk\ndeploy.** It supports Iceberg format version 3 (`variant`, nanosecond\ntimestamps, `geometry` / `geography`, `unknown`). It emits the exact\n`AWS::Glue::Table` / `OpenTableFormatInput` shape, so a single `cdk\ndeploy` creates, evolves, and destroys a table like any other CDK\nresource. No custom resource, no Lambda, no \"`cdk deploy` and then run\nthis SQL by hand\" two-step. Table changes (new columns, renames, drops,\nnew partition fields) land as a reviewed diff in a pull request and\napply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and\nPyPI (Python), pre-1.0, with a public surface guarded on every PR by two\nconsumer jobs (`e2e-consumer` compiles and synthesizes an app against a\npinned published version, `packed-consumer` does the same against the PR's\nown `npm pack` tarball) plus real-AWS integration suites, including ones\nfor format version 3. The multi-language packages are generated\nfrom one TypeScript source with [jsii](https://aws.github.io/jsii/)\nand indexed on [Construct\nHub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the [`ksco92/arceus`](https://github.com/ksco92/arceus)\nmonorepo, which also holds a CDK demo app that dogfoods the construct\nagainst a real AWS account.\n\n### Why this exists\n\nAWS documents the CloudFormation shape for Iceberg tables ([AWS Big\nData blog, December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation)),\nbut raw `AWS::Glue::Table` is a minefield: the CREATE succeeds and the\n*first* `Update` silently strips `table_type=ICEBERG`, after which\nevery Athena query fails with `HIVE_UNSUPPORTED_FORMAT`. The\nmotivating CDK issue is [aws/aws-cdk#29660](https://github.com/aws/aws-cdk/issues/29660);\n[`manmartgarc`'s comment](https://github.com/aws/aws-cdk/issues/29660#issuecomment-4411359248)\ndocuments the only working shape and the silent-corruption traps you\nhit by getting it slightly wrong. This construct implements that\nshape, refuses to emit the unsafe alternatives, and pins Iceberg field\nIDs (declared [in creation order](#using-icebergtable) for a new\ntable) so schema evolution never orphans existing data. It was the\nbasis of an upstream proposal to land an `IcebergTable` in\n`@aws-cdk/aws-glue-alpha` ([aws/aws-cdk#37988](https://github.com/aws/aws-cdk/pull/37988)),\nclosed unmerged in September 2026.\n\n### How it compares\n\n| Approach | Declarative IaC (in the PR) | In-place schema + partition evolution | Prevents the silent-corruption footguns | Typed API + synth-time validation |\n| --- | --- | --- | --- | --- |\n| Raw `CfnTable` (L1) | ✅ | ⚠️ only if you hand-write the exact `OpenTableFormatInput` shape | ❌ you own both footguns | ❌ |\n| CDK custom resource (Lambda + Glue SDK) | ⚠️ via a custom resource you maintain | ⚠️ you write the diff logic | ⚠️ your code's responsibility | ❌ |\n| Spark SQL DDL, or Athena SQL DDL, at job runtime | ❌ imperative, outside the PR | ✅ but outside CloudFormation | n/a | ❌ |\n| **`cdk-glue-iceberg-table`** | ✅ | ✅ via `cdk deploy` | ✅ both prevented by construction | ✅ |\n\n## Install\n\nTypeScript / JavaScript (npm):\n\n```bash\nnpm install cdk-glue-iceberg-table\n```\n\nPython (PyPI):\n\n```bash\npip install cdk-glue-iceberg-table\n```\n\nPeer dependencies (your CDK app must already have these). This\nrelease requires `aws-cdk-lib` 2.273.0 or newer and `constructs`\n10.8.1 or newer, plus Node.js 22.14 or newer for both languages (the\nPython package runs under Node.js through jsii).\n\nFor TypeScript / JavaScript:\n\n```bash\nnpm install aws-cdk-lib@^2.273.0 constructs@^10.8.1\n```\n\nFor Python:\n\n```bash\npip install 'aws-cdk-lib>=2.273.0' 'constructs>=10.8.1'\n```\n\n## Use\n\n### TypeScript\n\n```ts\nimport { Bucket } from 'aws-cdk-lib/aws-s3';\nimport { Database } from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\nconst db = new Database(this, 'Db', { databaseName: 'analytics' });\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n columns: [\n { name: 'order_id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'customer_id', type: IcebergType.LONG, required: true, id: 2 },\n { name: 'placed_at', type: IcebergType.TIMESTAMPTZ, required: true, id: 3 },\n ],\n partitionSpec: [\n { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.DAY, fieldId: 1000 },\n { sourceColumn: 'customer_id', transform: IcebergPartitionTransform.bucket(16), fieldId: 1001 },\n ],\n identifierFieldNames: ['order_id'],\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\n### Python\n\nThe same table in Python — the API mirrors TypeScript with\n`snake_case` props and `PascalCase` types:\n\n```python\nfrom aws_cdk.aws_s3 import Bucket\nfrom aws_cdk.aws_glue import Database\nfrom cdk_glue_iceberg_table import (\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n)\n\nbucket = Bucket(self, \"Warehouse\")\ndb = Database(self, \"Db\", database_name=\"analytics\")\n\nIcebergTable(self, \"OrdersTable\",\n database=db,\n table_name=\"orders\",\n location=f\"s3://{bucket.bucket_name}/analytics/orders/\",\n columns=[\n {\"name\": \"order_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 1},\n {\"name\": \"customer_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 2},\n {\"name\": \"placed_at\", \"type\": IcebergType.TIMESTAMPTZ, \"required\": True, \"id\": 3},\n ],\n partition_spec=[\n {\"source_column\": \"placed_at\", \"transform\": IcebergPartitionTransform.DAY, \"field_id\": 1000},\n {\"source_column\": \"customer_id\", \"transform\": IcebergPartitionTransform.bucket(16), \"field_id\": 1001},\n ],\n identifier_field_names=[\"order_id\"],\n format_version=IcebergFormatVersion.V2,\n)\n```\n\nConsumer-facing reference sections:\n\n- [How it compares](#how-it-compares) — `cdk-glue-iceberg-table` vs raw `CfnTable`, custom resources, and runtime SQL DDL.\n- [Using `IcebergTable`](#using-icebergtable) — full API reference with examples.\n- [Format version 3](#format-version-3) — the six v3 types, which engines read them, and the accepted limits.\n- [Two footguns the construct prevents](#two-footguns-the-construct-prevents) — the silent-corruption traps that motivated this construct.\n- [Known limitations](#known-limitations) — what the construct does and doesn't enforce.\n- [FAQ](#faq) — common \"how do I … in CDK / CloudFormation\" questions.\n\n## Exported surface\n\nThe package entry point re-exports the main types you import from\n`cdk-glue-iceberg-table`. In TypeScript / JavaScript the compiled\nsurface lives under `dist/lib/iceberg/` after `npm install`; in Python\nthe same surface is imported from the `cdk_glue_iceberg_table` module\nafter `pip install`:\n\n- **`IcebergTable`** — the L2 construct itself, with `grantRead` / `grantWrite` / `grantReadWrite`, the `fromIcebergTableAttributes(...)` import factory, and `creationOrderFieldIds(columns)` (Python: `creation_order_field_ids`), which returns a map from field path to the id Glue gives that field in a new table; a name containing `.` or a backquote appears in backquotes.\n- **`IcebergType`** — primitive types, the v3 constants `UNKNOWN`, `TIMESTAMP_NS`, `TIMESTAMPTZ_NS`, and `VARIANT`, and the `list` / `map` / `struct` / `decimal` / `fixed` / `geometry(crs?)` / `geography(crs?, algorithm?)` factories. `list` takes an `IcebergListDefinition`, `map` an `IcebergMapDefinition`, and `struct` a list of `IcebergStructFieldDefinition`, each carrying the nested field ids. Renders to the string Glue's `IcebergStructField.type` expects.\n- **`IcebergPartitionTransform`** — identity / `bucket(N)` / `truncate(W)` / year / month / day / hour / void. Each transform validates against the source column type at synth time.\n- **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2/v3, required — set explicitly per table; Athena cannot query v3 tables), **`IcebergSortDirection`**, **`IcebergNullOrder`**, **`IcebergEdgeAlgorithm`** (`SPHERICAL`, `VINCENTY`, `THOMAS`, `ANDOYER`, `KARNEY`; the second argument of `IcebergType.geography`), plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).\n\n## Using `IcebergTable`\n\nA minimal table:\n\n```typescript\nimport {\n Bucket,\n} from 'aws-cdk-lib/aws-s3';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\n\nconst db = new Database(this, 'Db', {\n databaseName: 'analytics',\n});\n\nnew IcebergTable(this, 'Users', {\n database: db,\n tableName: 'users',\n columns: [\n {\n name: 'user_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'email',\n type: IcebergType.STRING,\n required: true,\n id: 2,\n },\n {\n name: 'signed_up_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 3,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/users/`,\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\nEvery top-level column must declare an `id`: a stable, unique,\npositive integer you pick once and never reuse or reassign. Because\nIceberg data files reference fields by id rather than by name, a fixed\nid, declared in creation order when the table is created (below), is\nwhat lets you add, rename, and drop columns across deploys without\ncorrupting old data — see\n[How do I evolve an Iceberg table schema](#how-do-i-evolve-an-iceberg-table-schema-add-rename-or-drop-a-column-in-cloudformation).\nOnce a column is dropped, leave its id retired; never hand it to a new\ncolumn. Nested fields follow the same rule: every struct field takes\nan `id`, every list an `elementId`, and every map a `keyId` and a\n`valueId`. All ids in a schema, top-level and nested, must be distinct\nintegers from 1 to 2147483447.\n\nA new table must declare its ids in creation order. When Glue creates\na table it does not keep the declared ids: it numbers the fields from\n1 in creation order and points the partition spec, sort order and\nidentifier fields at the new ids. An update Glue accepts stores the\ndeclared ids as given, so the first such update of a table created\nwith other ids renumbers its fields; for the update Glue rejects, see\n[Known limitations](#known-limitations). To number a new table, number\nthe top-level columns first, in order, then the nested fields of each\ncolumn in turn (a list's element; a map's key, then its value, then\nthe key's nested fields, then the value's; a struct's fields, then\ntheir nested fields). `IcebergTable.creationOrderFieldIds` returns\nthese ids by field path and ignores the ids in its input:\n\n```typescript\nconst columns = [\n { name: 'id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'tags', type: IcebergType.list({ element: IcebergType.STRING, elementId: 4 }), id: 2 },\n {\n name: 'attrs',\n type: IcebergType.map({ key: IcebergType.STRING, keyId: 5, value: IcebergType.STRING, valueId: 6 }),\n id: 3,\n },\n];\nIcebergTable.creationOrderFieldIds(columns);\n// { id: 1, tags: 2, attrs: 3, 'tags.element': 4, 'attrs.key': 5, 'attrs.value': 6 }\n```\n\nIds out of creation order are for fields a later deploy adds; see\n[Evolving schema and partitions](#evolving-schema-and-partitions).\n\nA table that exercises most of the surface (partitions, sort order,\nnested types, identifier fields, table properties, removal policy):\n\n```typescript\nimport {\n RemovalPolicy,\n} from 'aws-cdk-lib';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergDataFormat,\n IcebergFormatVersion,\n IcebergNullOrder,\n IcebergPartitionTransform,\n IcebergSortDirection,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n comment: 'Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.',\n columns: [\n {\n name: 'order_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'customer_id',\n type: IcebergType.LONG,\n required: true,\n id: 2,\n },\n {\n name: 'order_amount',\n type: IcebergType.decimal(12, 2),\n required: true,\n id: 3,\n },\n {\n name: 'currency',\n type: IcebergType.STRING,\n required: true,\n id: 4,\n },\n {\n name: 'placed_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 5,\n },\n {\n name: 'tags',\n type: IcebergType.list({\n element: IcebergType.STRING,\n elementId: 9,\n }),\n id: 6,\n },\n {\n name: 'shipping_address',\n type: IcebergType.struct([\n {\n id: 10,\n name: 'line1',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 11,\n name: 'city',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 12,\n name: 'country',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 13,\n name: 'postal_code',\n type: IcebergType.STRING,\n },\n ]),\n id: 7,\n },\n {\n name: 'metadata',\n type: IcebergType.map({\n key: IcebergType.STRING,\n keyId: 14,\n value: IcebergType.STRING,\n valueId: 15,\n }),\n id: 8,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n partitionSpec: [\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1000,\n },\n {\n sourceColumn: 'customer_id',\n transform: IcebergPartitionTransform.bucket(16),\n fieldId: 1001,\n },\n ],\n sortOrder: [\n {\n sourceColumn: 'placed_at',\n direction: IcebergSortDirection.ASC,\n nullOrder: IcebergNullOrder.NULLS_LAST,\n },\n {\n sourceColumn: 'order_id',\n direction: IcebergSortDirection.ASC,\n },\n ],\n identifierFieldNames: [\n 'order_id',\n ],\n dataFormat: IcebergDataFormat.PARQUET,\n formatVersion: IcebergFormatVersion.V2,\n tableProperties: {\n 'write.parquet.compression-codec': 'zstd',\n 'write.delete.mode': 'merge-on-read',\n 'write.update.mode': 'merge-on-read',\n 'write.merge.mode': 'merge-on-read',\n 'write.target-file-size-bytes': '134217728',\n 'history.expire.min-snapshots-to-keep': '5',\n 'gc.enabled': 'true',\n },\n removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\nEach partition field also pins a `fieldId`: an integer of 1000 or\nabove (the Iceberg spec reserves lower ids for schema columns), unique\nacross the table's entire partition-spec history. The discipline is\nthe inverse of the column-id rule. A column keeps its id forever; a\npartition field keeps its id only while it stays untouched. Change\nanything about a field — swap `month` for `day`, point it at a\ndifferent source column — and it becomes a *new* field that needs a\nfresh, never-before-used id, while the old id retires with the old\nspec. Reusing a retired id (or reassigning an id to a different field)\nproduces a table that Athena still reads but Spark and Trino reject\nwith `ValidationException: Conflicting partition fields`.\n\n`identifierFieldNames` lists the columns that together identify a row\nand renders as the schema's `identifier-field-ids`. Each one must be a\n`required: true` column (Glue rejects an optional one), and `cdk synth`\nrejects an identifier column of type float, double, list, map, struct,\nunknown, variant, geometry or geography. The construct prefixes each\nidentifier column's `doc` with `(PK) `, so a `doc` you write must not\nstart with `(PK) `; see [Evolving schema and\npartitions](#evolving-schema-and-partitions).\n\nThe resulting Iceberg `metadata.json` for this table contains every\nfeature you set:\n\n```json\n{\n \"format-version\": 2,\n \"table-uuid\": \"39a948f9-...\",\n \"current-schema-id\": 0,\n \"schemas\": [\n {\n \"schema-id\": 0,\n \"identifier-field-ids\": [1],\n \"fields\": [\n { \"id\": 1, \"name\": \"order_id\", \"required\": true, \"type\": \"long\", \"doc\": \"(PK) \" },\n { \"id\": 2, \"name\": \"customer_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 3, \"name\": \"order_amount\", \"required\": true, \"type\": \"decimal(12, 2)\" },\n { \"id\": 4, \"name\": \"currency\", \"required\": true, \"type\": \"string\" },\n { \"id\": 5, \"name\": \"placed_at\", \"required\": true, \"type\": \"timestamptz\" },\n { \"id\": 6, \"name\": \"tags\", \"required\": false,\n \"type\": { \"type\": \"list\", \"element-id\": 9, \"element\": \"string\", \"element-required\": false } },\n { \"id\": 7, \"name\": \"shipping_address\", \"required\": false,\n \"type\": { \"type\": \"struct\", \"fields\": [\n { \"id\": 10, \"name\": \"line1\", \"required\": true, \"type\": \"string\" },\n { \"id\": 11, \"name\": \"city\", \"required\": true, \"type\": \"string\" },\n { \"id\": 12, \"name\": \"country\", \"required\": true, \"type\": \"string\" },\n { \"id\": 13, \"name\": \"postal_code\", \"required\": false, \"type\": \"string\" }\n ] } },\n { \"id\": 8, \"name\": \"metadata\", \"required\": false,\n \"type\": { \"type\": \"map\", \"key-id\": 14, \"key\": \"string\", \"value-id\": 15,\n \"value-required\": false, \"value\": \"string\" } }\n ]\n }\n ],\n \"partition-specs\": [\n { \"spec-id\": 0, \"fields\": [\n { \"name\": \"placed_at_day\", \"transform\": \"day\", \"source-id\": 5, \"field-id\": 1000 },\n { \"name\": \"customer_id_bucket\", \"transform\": \"bucket[16]\", \"source-id\": 2, \"field-id\": 1001 }\n ]}\n ],\n \"sort-orders\": [\n { \"order-id\": 1, \"fields\": [\n { \"transform\": \"identity\", \"source-id\": 5, \"direction\": \"asc\", \"null-order\": \"nulls-last\" },\n { \"transform\": \"identity\", \"source-id\": 1, \"direction\": \"asc\", \"null-order\": \"nulls-last\" }\n ]}\n ],\n \"properties\": {\n \"format-version\": \"2\",\n \"write.format.default\": \"parquet\",\n \"write.parquet.compression-codec\": \"zstd\",\n \"write.merge.mode\": \"merge-on-read\",\n \"write.update.mode\": \"merge-on-read\",\n \"write.delete.mode\": \"merge-on-read\",\n \"write.target-file-size-bytes\": \"134217728\",\n \"history.expire.min-snapshots-to-keep\": \"5\",\n \"gc.enabled\": \"true\",\n \"comment\": \"Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.\"\n }\n}\n```\n\n### Format version 3\n\nSet `formatVersion: IcebergFormatVersion.V3` to create a v3 table. The\nsix v3 types (below) are only accepted on a V3 table, at any nesting\ndepth: inside a struct, as a list element, or as a map key or value.\nSynth fails on a V1 or V2 table that uses one.\n\n```typescript\nimport {\n IcebergEdgeAlgorithm,\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'Events', {\n database: db,\n tableName: 'events',\n location: `s3://${bucket.bucketName}/analytics/events/`,\n columns: [\n { name: 'occurred_at', type: IcebergType.TIMESTAMP_NS, id: 1 },\n { name: 'payload', type: IcebergType.VARIANT, id: 2 },\n {\n name: 'origin',\n type: IcebergType.geography('OGC:CRS84', IcebergEdgeAlgorithm.SPHERICAL),\n id: 3,\n },\n ],\n formatVersion: IcebergFormatVersion.V3,\n});\n```\n\nThe same table in Python:\n\n```python\nfrom cdk_glue_iceberg_table import (\n IcebergEdgeAlgorithm,\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n)\n\nIcebergTable(self, \"Events\",\n database=db,\n table_name=\"events\",\n location=f\"s3://{bucket.bucket_name}/analytics/events/\",\n columns=[\n {\"name\": \"occurred_at\", \"type\": IcebergType.TIMESTAMP_NS, \"id\": 1},\n {\"name\": \"payload\", \"type\": IcebergType.VARIANT, \"id\": 2},\n {\n \"name\": \"origin\",\n \"type\": IcebergType.geography(\"OGC:CRS84\", IcebergEdgeAlgorithm.SPHERICAL),\n \"id\": 3,\n },\n ],\n format_version=IcebergFormatVersion.V3,\n)\n```\n\nThis table has a `timestamp_ns` column; see [Known limitations](#known-limitations)\nbefore reading it from upstream Spark.\n\nThe v3 types, with the rules `cdk synth` enforces:\n\n| Type | Factory | Rendered string | Partition and identifier rules |\n| --- | --- | --- | --- |\n| unknown | `IcebergType.UNKNOWN` | `unknown` | Must be optional, as a column, list element, or map value; never a map key. Partition source only with `void`. Not an identifier field. |\n| timestamp with nanoseconds | `IcebergType.TIMESTAMP_NS` | `timestamp_ns` | `identity`, `year`, `month`, `day`, `hour`, `bucket(N)`, `void`; not `truncate(W)`. Allowed as an identifier field. |\n| timestamptz with nanoseconds | `IcebergType.TIMESTAMPTZ_NS` | `timestamptz_ns` | Same as `timestamp_ns`. |\n| variant | `IcebergType.VARIANT` | `variant` | Never a partition or sort source, `void` included. Not an identifier field. |\n| geometry | `IcebergType.geometry(crs?)` | `geometry`, or `geometry(<crs>)` when a CRS is given | Partition source only with `void`. Not an identifier field. |\n| geography | `IcebergType.geography(crs?, algorithm?)` | `geography`, `geography(<crs>)`, or `geography(<crs>, <algorithm>)` when an algorithm is given, such as `geography(OGC:CRS84, spherical)` | Same as `geometry`. |\n\nA geometry or geography `crs` is an identifier such as `OGC:CRS84` or\n`EPSG:3857`; whitespace, parentheses, braces, and commas are rejected.\nWhen `algorithm` is set without a `crs`, the rendered string spells out\n`OGC:CRS84`.\n\nWhich engines read a v3 table created by the construct:\n\n| Engine | v3 tables | Notes |\n| --- | --- | --- |\n| Spark 4.1 + Iceberg 1.12 (the integration-test runner) | Yes | Reads and writes tables the construct creates, including deletion vectors, row lineage, `variant`, `unknown`, and `geometry` / `geography`, except tables with nanosecond-timestamp columns or a geometry CRS other than `OGC:CRS84` (checked by `scripts/spark/verify_v3_dml.py`; details in [Known limitations](#known-limitations)). |\n| AWS Glue 6.0 | Documented | The [AWS Glue versions](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html) page lists \"Iceberg format version 3 with VARIANT data type, deletion vectors, row lineage tracking, nanosecond timestamps, and geo types\". The integration suites do not run on Glue 6.0. |\n| Amazon EMR Spark 8.1.0 (Spark 4.1.1, Iceberg 1.11.0-amzn-0) | Documented | The [emr-spark-8.1.0 release notes](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-spark810-release.html) state \"Amazon EMR Spark 8.1.0 extends Iceberg v3 spec support for Spark workloads\". The integration suites do not run on EMR 8.1. |\n| Athena SQL | No | The [Athena Iceberg page](https://docs.aws.amazon.com/athena/latest/ug/querying-iceberg.html) states \"Athena only creates and operates on Iceberg v2 tables.\" The v2 integration suites also run through Athena (see [Does it work with Athena and Lake Formation?](#does-it-work-with-athena-and-lake-formation)); no v3 table is queried through Athena. |\n\n### Granting access\n\n```typescript\ntable.grantRead(role); // Glue read + S3 read on the table's prefix\ntable.grantWrite(role); // Glue write + S3 write\ntable.grantReadWrite(role);\n```\n\nThe `grant*` helpers issue **IAM grants only**. Under Lake Formation\nyou still add the matching `SELECT` / `INSERT` / `DELETE` LF grants on\ntop of the construct's IAM grants for Athena queries to succeed.\n\n### Importing an existing table\n\n```typescript\nconst existing = IcebergTable.fromIcebergTableAttributes(this, 'Orders', {\n database: db,\n tableName: 'orders',\n location: 's3://my-bucket/analytics/orders/',\n});\nexisting.grantRead(role);\n```\n\n### Evolving schema and partitions\n\nChange the `columns` array (or `partitionSpec`) and run `cdk deploy`\nagain. The construct passes the new schema to Glue's `UpdateTable`,\nwhich writes a new `metadata.json` with a new `schema-id`; existing\ndata files stay readable because each column's `id` is pinned to the\nid the table holds and never reused. Adds, renames (same `id`, new\n`name`), and drops all flow through `cdk deploy` alone — no\nout-of-band SQL DDL.\n\nNested fields evolve the same way. Each struct field, list element,\nmap key, and map value keeps the id you gave it (the rule is under\n[Using `IcebergTable`](#using-icebergtable)), so adding a column or a\nstruct field anywhere in the schema leaves every other id unchanged. A\nnew nested field takes an id no field of the table has ever used:\n\n```typescript\ntype: IcebergType.struct([\n { id: 10, name: 'line1', type: IcebergType.STRING },\n { id: 16, name: 'line2', type: IcebergType.STRING }, // new field, never-used id\n { id: 11, name: 'city', type: IcebergType.STRING },\n]),\n```\n\nSuch an id is out of creation order, which is expected once a table\nhas evolved: creation order applies only to the ids a table is created\nwith (see [Using `IcebergTable`](#using-icebergtable)).\n\nUpgrading from a version before 0.12.0, which numbered nested fields\nitself: declare the ids the table's current `metadata.json` holds,\ntop-level and nested (each field `id`, `element-id`, `key-id` and\n`value-id`), or the next deploy renumbers the fields that differ and\nexisting data files read under the wrong field. A nested type object\nshared by two columns now fails synth with a duplicate id; give each\ncolumn its own nested type with its own ids. The list element and map\nvalue nullability default also changed: `elementRequired` and\n`valueRequired` now default to `false`. Earlier versions made list\nelements required by default and map values required unless the third\nargument of `map` was `false`; set `elementRequired: true` or\n`valueRequired: true` wherever the deployed schema has\n`\"element-required\": true` or `\"value-required\": true`.\n\nGlue's `UpdateTable` reuses an earlier schema whose fields (name,\ntype, `required`, `doc`) match the request, together with that\nschema's `identifier-field-ids`. The construct therefore prefixes the\n`doc` of every identifier column with `(PK) ` (just `(PK) ` when the\ncolumn has no `doc`), shown as the column comment, so every\nidentifier change is a field change. On a table whose schema history\nwas written with the marker, identifier changes flow through `cdk\ndeploy` like column changes.\n\nPartition evolution flows the same way, with one extra rule on\n`fieldId`: a changed partition field is a new partition field. To move\na table from `month(placed_at)` to `day(placed_at)`, drop the month\nentry and add a day entry under a fresh `fieldId` — never recycle the\nmonth field's id:\n\n```typescript\npartitionSpec: [\n // was: { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.MONTH, fieldId: 1000 },\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1001,\n },\n],\n```\n\nOld data files written under the month spec stay readable; new writes\npartition by day. Reusing `1000` for the day field instead corrupts\nthe spec history for strict engines (Spark, Trino) while Athena keeps\nworking — the failure only surfaces at Spark runtime.\n\n### Inserting and querying\n\n```sql\n-- INSERT into the orders table\nINSERT INTO sample_database.orders VALUES\n (1001, 5001, DECIMAL '149.99', 'USD',\n TIMESTAMP '2026-05-20 09:15:00 UTC',\n ARRAY['holiday-promo','first-order'],\n CAST(ROW('1 Infinite Loop','Cupertino','US','95014')\n AS ROW(line1 VARCHAR,city VARCHAR,country VARCHAR,postal_code VARCHAR)),\n MAP(ARRAY['channel','utm'], ARRAY['web','google'])),\n -- ... more rows\n;\n\n-- merge-on-read DELETE (only legal because we chose v2 + merge-on-read mode)\nDELETE FROM sample_database.orders WHERE order_id = 1003;\n\n-- merge-on-read UPDATE\nUPDATE sample_database.orders SET currency = 'GBP' WHERE customer_id = 5002;\n\n-- SELECT\nSELECT customer_id, SUM(order_amount) AS total\n FROM sample_database.orders\n GROUP BY 1\n ORDER BY 2 DESC;\n```\n\n## Two footguns the construct prevents\n\n### Footgun #1 — schema under `storageDescriptor.columns`\n\nThe CREATE succeeds but the first UPDATE silently strips\n`table_type=ICEBERG` from the table's Glue parameters, and Athena\nqueries after that fail with `HIVE_UNSUPPORTED_FORMAT`.\n\n```typescript\n// DON'T DO THIS — what most StackOverflow / re:Post examples show\nnew CfnTable(this, 'OrdersBad', {\n catalogId: this.account,\n databaseName: 'analytics',\n tableInput: {\n name: 'orders',\n tableType: 'EXTERNAL_TABLE',\n parameters: {\n table_type: 'ICEBERG',\n },\n storageDescriptor: {\n location: 's3://.../orders/',\n columns: [\n /* ... */\n ],\n },\n },\n openTableFormatInput: {\n icebergInput: {\n metadataOperation: 'CREATE',\n version: '2',\n },\n },\n});\n```\n\n`IcebergTable` instead always emits schema/partitions/sort/properties\nunder `openTableFormatInput.icebergInput.icebergTableInput`, never\nunder `storageDescriptor`.\n\n### Footgun #2 — `tableInput` co-present with `openTableFormatInput`\n\nEven setting just `tableInput: { name: 'foo' }` next to\n`openTableFormatInput` returns\n`\"Table metadata is expected only via TableInput or via IcebergTableInputProperties inside OpenTableFormatInput\"`.\nThe construct never emits `tableInput`; the table-level comment goes\ninto `tableProperties['comment']`, which lives inside\n`icebergTableInput.properties`.\n\n(There is a third footgun, field-id reuse after a column drop, that\nthe construct does **not** prevent. See the next section.)\n\n## Known limitations\n\n- **Creation order is not checked.** The construct cannot tell at synth whether a table is new or already deployed, so it accepts a new table whose ids are not in creation order (the rule is under [Using `IcebergTable`](#using-icebergtable)). When the first update of such a table changes the id of a column an identity partition is sourced from, Glue rejects the update with `Cannot create identity partition sourced from different field in schema` and the CloudFormation rollback fails the same way, leaving the stack in `UPDATE_ROLLBACK_FAILED`.\n- **Field-id reuse is not detected across deploys.** This applies to nested ids (struct field, list element, map key and value) as well as column ids. If you drop a column with `id = 5` and then add a different column with `id = 5` in a later deploy, Glue accepts the UPDATE and Iceberg's metadata silently violates the \"never reuse a retired id\" invariant. Readers projecting old snapshots will surface deleted data under the new field's name. The construct enforces uniqueness **within one deploy** (`duplicate field id N` validator), but it doesn't compare against the live table state. The safe workflow is to treat dropped ids as retired forever.\n- **Partition field-id reuse is not detected across deploys either.** The same live-state blindness applies to partition `fieldId`s: the construct validates them within one deploy (integer >= 1000, unique in the spec), but it cannot tell that the id you pinned already appeared in an earlier spec of the deployed table. The invariant partition ids must uphold is stricter than the column one — unique across the table's **entire spec history**, so a changed field (different transform or source column) must take a fresh id rather than keep its old one. Violate it and strict engines (Spark, Trino) reject the table with `Conflicting partition fields` while Athena keeps answering, masking the break until Spark runtime. The safe workflow: treat every id that has ever appeared in any spec as retired, and allocate new fields the next never-used id. A partition change needs a new source column or transform; Glue ignores a `fieldId`-only change.\n- **`last-partition-id` is written by Glue, not by the construct.** The construct supplies the spec's field ids; Glue's `UpdateTable` computes the table's `last-partition-id` counter when it writes the new metadata. The repo's integration test asserts the counter keeps up with the highest supplied field id after a partition evolution, but engines that later evolve the spec themselves (e.g. Spark `ALTER TABLE … ADD PARTITION FIELD`) allocate from that counter — if you mix CDK-managed and engine-managed partition evolution, verify the counter in `metadata.json` before trusting engine-side changes.\n- **Removing the last identifier from a table created with identifiers before 0.11.0 can bring the old ids back.** That table's history holds an unmarked schema with ids, and Glue reuses it when the rendered fields match it again. Change a column `doc` in the same deploy that removes the last identifier.\n- **CREATE-only metadata operation.** The CFN `IcebergInput.metadataOperation` only accepts `CREATE`; the construct always emits that. Subsequent deploys use Glue's normal `UpdateTable` path, which writes new Iceberg metadata in-place.\n- **Format version is immutable after CREATE.** Glue ignores a V2 to V3 `formatVersion` change, though `properties.format-version` then reads `3`. Keep `formatVersion` at the table's real version, or destroy + recreate the table to change it. An engine can upgrade a v2 table to v3 in place with `ALTER TABLE ... SET TBLPROPERTIES ('format-version' = '3')`; after that, set `formatVersion` to `V3` so the next deploy declares the version the table already has.\n- **`merge-on-read` requires v2 or later.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.\n- **Column defaults are not available.** Iceberg v3 `initial-default` and `write-default` cannot be declared through CloudFormation: the `AWS::Glue::Table` resource schema has no `InitialDefault` or `WriteDefault` property. Revisit when that schema gains the two properties.\n- **Nanosecond timestamps are catalog-only for upstream Spark 4.1.** A table with any `timestamp_ns` or `timestamptz_ns` column fails to open in upstream Spark 4.1 with Iceberg 1.12. The integration suite for these columns asserts from `metadata.json` only. The [engine matrix](#format-version-3) lists the engines that document support.\n- **Geometry CRS other than `OGC:CRS84` is catalog-only for upstream Spark 4.1.** Spark 4.1 accepts `OGC:CRS84`, or bare `geometry`, as the geometry CRS; a table declaring another CRS, such as `EPSG:3857`, cannot be read there.\n- **Athena DDL features that don't surface through CFN** (e.g. `ALTER TABLE WRITE ORDERED BY`, `ALTER TABLE … SET LOCATION`, `bucketed_by` / `bucket_count` Hive clauses) are not exposed. Use `IcebergPartitionTransform.bucket(N)` instead of Hive bucketing.\n- **Dropping a partition column requires a `void` intermediate per the Iceberg spec**, and the CFN `OpenTableFormatInput` cannot express that. The construct accepts the change, but Athena queries against the result will fail with `Type cannot be null`. The safe pattern is to drop partitions that source from a column while keeping that column in the schema, and only drop a column once it is no longer partitioning anything.\n\n## FAQ\n\n### How do I create an Apache Iceberg table in AWS CDK?\n\nInstall `cdk-glue-iceberg-table`, then declare an `IcebergTable` with a\ndatabase, a column list, and an S3 `location` — see [Use](#use).\n`cdk deploy` creates the Glue Data Catalog table and writes the\nIceberg `metadata.json` under your S3 prefix. No custom resource or\nLambda is involved; it is a plain `AWS::Glue::Table` in your\nCloudFormation template.\n\n### How do I evolve an Iceberg table schema (add, rename, or drop a column) in CloudFormation?\n\nChange the `columns` array and run `cdk deploy` again. The construct\npasses the new schema to Glue's `UpdateTable`, which writes a new\n`metadata.json` with a new `schema-id`; existing data files stay\nreadable because each column's `id` is pinned to the id the table\nholds and never reused.\nPartition changes work the same way, except a changed partition field\ntakes a fresh `fieldId` instead of keeping its old one. See [Evolving\nschema and partitions](#evolving-schema-and-partitions).\n\n### Does CloudFormation support Iceberg tables natively?\n\nYes, through `AWS::Glue::Table` with `OpenTableFormatInput.IcebergInput`,\ndocumented by AWS in [December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation).\nThe catch is that the raw shape corrupts the table on the first\n`Update` if you place schema under `storageDescriptor.columns` or set\n`tableInput` alongside `openTableFormatInput`. This construct only ever\nemits the safe shape and gives you no way to express the unsafe ones.\nSee [Two footguns the construct prevents](#two-footguns-the-construct-prevents).\n\n### What is the difference between cdk-glue-iceberg-table and a raw CfnTable?\n\nA raw `CfnTable` makes you hand-write the `OpenTableFormatInput` JSON\nand own both silent-corruption footguns. `cdk-glue-iceberg-table` gives\nyou a typed `IcebergType` / `IcebergPartitionTransform` API,\nsynth-time validation (partition transforms checked against column\ntypes, format/version mismatches caught before deploy), pinned field\nIDs for safe evolution (declared in creation order for a new table),\nand `grantRead` / `grantWrite` helpers. See\n[How it compares](#how-it-compares).\n\n### How do I create a partitioned Iceberg table in CDK?\n\nPass a `partitionSpec` of `IcebergPartitionTransform` entries —\n`identity`, `bucket(N)`, `truncate(W)`, `year`, `month`, `day`, `hour`,\nor `void` — each pinned to a `fieldId` of 1000 or above. Transforms are\nvalidated against their source column's type at synth time. See\n[Using `IcebergTable`](#using-icebergtable).\n\n### Does it work with Athena and Lake Formation?\n\nYes for v2 tables, no for v3 (see the engine matrix in [Format\nversion 3](#format-version-3)). The demo app in the\n[`arceus`](https://github.com/ksco92/arceus) repo registers its tables\nwith Lake Formation, and its v2 integration suites query them through\nAthena as well as Spark, on the same tables:\n\n- merge-on-read `INSERT`, `UPDATE`, `DELETE` and `MERGE INTO`, time\n travel (`FOR VERSION AS OF` / `FOR TIMESTAMP AS OF`), `OPTIMIZE ...\n REWRITE DATA USING BIN_PACK`, and `VACUUM`;\n- a read after every schema, partition, identifier and nested-field\n evolution step;\n- the `(PK) ` comment on identifier columns, read from\n `information_schema.columns`;\n- rows written by Spark read through Athena, and rows written by Athena\n read through Spark.\n\nThe suites grant the querying principal `SELECT`, `INSERT`, `DELETE`,\n`ALTER` and `DESCRIBE` through Lake Formation. The construct's `grant*`\nhelpers issue IAM grants only; under Lake Formation you add the\nmatching LF grants. See [Granting access](#granting-access).\n\n### Can I use Iceberg v2 merge-on-read (row-level UPDATE and DELETE)?\n\nYes — set `formatVersion: IcebergFormatVersion.V2` and the\n`write.{delete,update,merge}.mode = merge-on-read` table properties.\nThe construct rejects merge-on-read on a v1 table at synth time.\n\n### Can I create an Iceberg v3 table?\n\nYes. Set `formatVersion: IcebergFormatVersion.V3`; see [Format\nversion 3](#format-version-3) for the types, the engine matrix and the\nlimits.\n\n## Contributing\n\nDevelopment, the monorepo layout, and the demo app live in [CONTRIBUTING.md](https://github.com/ksco92/arceus/blob/main/CONTRIBUTING.md).\n\n## License\n\n[MIT](https://github.com/ksco92/arceus/blob/main/LICENSE).\n"
9754
+ "markdown": "# cdk-glue-iceberg-table\n\n[![CI](https://img.shields.io/github/actions/workflow/status/ksco92/arceus/ci.yml?branch=main&label=CI)](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[![coverage](https://codecov.io/gh/ksco92/arceus/branch/main/graph/badge.svg)](https://codecov.io/gh/ksco92/arceus)\n[![npm](https://img.shields.io/npm/v/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![PyPI](https://img.shields.io/pypi/v/cdk-glue-iceberg-table.svg)](https://pypi.org/project/cdk-glue-iceberg-table/)\n[![Construct Hub](https://img.shields.io/badge/Construct%20Hub-available-blueviolet)](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[![downloads](https://img.shields.io/npm/dw/cdk-glue-iceberg-table.svg)](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[![license](https://img.shields.io/npm/l/cdk-glue-iceberg-table.svg)](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is an AWS CDK L2 construct to create and\nevolve Apache Iceberg tables in the AWS Glue Data Catalog — schema and\npartition changes that survive CloudFormation updates, via cdk\ndeploy.** It supports Iceberg format version 3 (`variant`, nanosecond\ntimestamps, `geometry` / `geography`, `unknown`). It emits the exact\n`AWS::Glue::Table` / `OpenTableFormatInput` shape, so a single `cdk\ndeploy` creates, evolves, and destroys a table like any other CDK\nresource. No custom resource, no Lambda, no \"`cdk deploy` and then run\nthis SQL by hand\" two-step. Table changes (new columns, renames, drops,\nnew partition fields) land as a reviewed diff in a pull request and\napply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and\nPyPI (Python), pre-1.0, with a public surface guarded on every PR by two\nconsumer jobs (`e2e-consumer` compiles and synthesizes an app against a\npinned published version, `packed-consumer` does the same against the PR's\nown `npm pack` tarball) plus real-AWS integration suites, including ones\nfor format version 3. The multi-language packages are generated\nfrom one TypeScript source with [jsii](https://aws.github.io/jsii/)\nand indexed on [Construct\nHub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the [`ksco92/arceus`](https://github.com/ksco92/arceus)\nmonorepo, which also holds a CDK demo app that dogfoods the construct\nagainst a real AWS account.\n\n### Why this exists\n\nAWS documents the CloudFormation shape for Iceberg tables ([AWS Big\nData blog, December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation)),\nbut raw `AWS::Glue::Table` is a minefield: the CREATE succeeds and the\n*first* `Update` silently strips `table_type=ICEBERG`, after which\nevery Athena query fails with `HIVE_UNSUPPORTED_FORMAT`. The\nmotivating CDK issue is [aws/aws-cdk#29660](https://github.com/aws/aws-cdk/issues/29660);\n[`manmartgarc`'s comment](https://github.com/aws/aws-cdk/issues/29660#issuecomment-4411359248)\ndocuments the only working shape and the silent-corruption traps you\nhit by getting it slightly wrong. This construct implements that\nshape, refuses to emit the unsafe alternatives, and pins Iceberg field\nIDs (declared [in creation order](#using-icebergtable) for a new\ntable) so schema evolution never orphans existing data. It was the\nbasis of an upstream proposal to land an `IcebergTable` in\n`@aws-cdk/aws-glue-alpha` ([aws/aws-cdk#37988](https://github.com/aws/aws-cdk/pull/37988)),\nclosed unmerged in September 2026.\n\n### How it compares\n\n| Approach | Declarative IaC (in the PR) | In-place schema + partition evolution | Prevents the silent-corruption footguns | Typed API + synth-time validation |\n| --- | --- | --- | --- | --- |\n| Raw `CfnTable` (L1) | ✅ | ⚠️ only if you hand-write the exact `OpenTableFormatInput` shape | ❌ you own both footguns | ❌ |\n| CDK custom resource (Lambda + Glue SDK) | ⚠️ via a custom resource you maintain | ⚠️ you write the diff logic | ⚠️ your code's responsibility | ❌ |\n| Spark SQL DDL, or Athena SQL DDL, at job runtime | ❌ imperative, outside the PR | ✅ but outside CloudFormation | n/a | ❌ |\n| **`cdk-glue-iceberg-table`** | ✅ | ✅ via `cdk deploy` | ✅ both prevented by construction | ✅ |\n\n## Install\n\nTypeScript / JavaScript (npm):\n\n```bash\nnpm install cdk-glue-iceberg-table\n```\n\nPython (PyPI):\n\n```bash\npip install cdk-glue-iceberg-table\n```\n\nPeer dependencies (your CDK app must already have these). This\nrelease requires `aws-cdk-lib` 2.273.0 or newer and `constructs`\n10.8.1 or newer, plus Node.js 22.14 or newer for both languages (the\nPython package runs under Node.js through jsii).\n\nFor TypeScript / JavaScript:\n\n```bash\nnpm install aws-cdk-lib@^2.273.0 constructs@^10.8.1\n```\n\nFor Python:\n\n```bash\npip install 'aws-cdk-lib>=2.273.0' 'constructs>=10.8.1'\n```\n\n## Use\n\n### TypeScript\n\n```ts\nimport { Bucket } from 'aws-cdk-lib/aws-s3';\nimport { Database } from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\nconst db = new Database(this, 'Db', { databaseName: 'analytics' });\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n columns: [\n { name: 'order_id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'customer_id', type: IcebergType.LONG, required: true, id: 2 },\n { name: 'placed_at', type: IcebergType.TIMESTAMPTZ, required: true, id: 3 },\n ],\n partitionSpec: [\n { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.DAY, fieldId: 1000 },\n { sourceColumn: 'customer_id', transform: IcebergPartitionTransform.bucket(16), fieldId: 1001 },\n ],\n identifierFieldNames: ['order_id'],\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\n### Python\n\nThe same table in Python — the API mirrors TypeScript with\n`snake_case` props and `PascalCase` types:\n\n```python\nfrom aws_cdk.aws_s3 import Bucket\nfrom aws_cdk.aws_glue import Database\nfrom cdk_glue_iceberg_table import (\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n IcebergPartitionTransform,\n)\n\nbucket = Bucket(self, \"Warehouse\")\ndb = Database(self, \"Db\", database_name=\"analytics\")\n\nIcebergTable(self, \"OrdersTable\",\n database=db,\n table_name=\"orders\",\n location=f\"s3://{bucket.bucket_name}/analytics/orders/\",\n columns=[\n {\"name\": \"order_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 1},\n {\"name\": \"customer_id\", \"type\": IcebergType.LONG, \"required\": True, \"id\": 2},\n {\"name\": \"placed_at\", \"type\": IcebergType.TIMESTAMPTZ, \"required\": True, \"id\": 3},\n ],\n partition_spec=[\n {\"source_column\": \"placed_at\", \"transform\": IcebergPartitionTransform.DAY, \"field_id\": 1000},\n {\"source_column\": \"customer_id\", \"transform\": IcebergPartitionTransform.bucket(16), \"field_id\": 1001},\n ],\n identifier_field_names=[\"order_id\"],\n format_version=IcebergFormatVersion.V2,\n)\n```\n\nConsumer-facing reference sections:\n\n- [How it compares](#how-it-compares) — `cdk-glue-iceberg-table` vs raw `CfnTable`, custom resources, and runtime SQL DDL.\n- [Using `IcebergTable`](#using-icebergtable) — full API reference with examples.\n- [Format version 3](#format-version-3) — the six v3 types, which engines read them, and the accepted limits.\n- [Two footguns the construct prevents](#two-footguns-the-construct-prevents) — the silent-corruption traps that motivated this construct.\n- [Known limitations](#known-limitations) — what the construct does and doesn't enforce.\n- [FAQ](#faq) — common \"how do I … in CDK / CloudFormation\" questions.\n\n## Exported surface\n\nThe package entry point re-exports the main types you import from\n`cdk-glue-iceberg-table`. In TypeScript / JavaScript the compiled\nsurface lives under `dist/lib/iceberg/` after `npm install`; in Python\nthe same surface is imported from the `cdk_glue_iceberg_table` module\nafter `pip install`:\n\n- **`IcebergTable`** — the L2 construct itself, with `grantRead` / `grantWrite` / `grantReadWrite`, the `fromIcebergTableAttributes(...)` import factory, and `creationOrderFieldIds(columns)` (Python: `creation_order_field_ids`), which returns a map from field path to the id Glue gives that field in a new table; a name containing `.` or a backquote appears in backquotes.\n- **`IcebergType`** — primitive types, the v3 constants `UNKNOWN`, `TIMESTAMP_NS`, `TIMESTAMPTZ_NS`, and `VARIANT`, and the `list` / `map` / `struct` / `decimal` / `fixed` / `geometry(crs?)` / `geography(crs?, algorithm?)` factories. `list` takes an `IcebergListDefinition`, `map` an `IcebergMapDefinition`, and `struct` a list of `IcebergStructFieldDefinition`, each carrying the nested field ids. Renders to the string Glue's `IcebergStructField.type` expects.\n- **`IcebergPartitionTransform`** — identity / `bucket(N)` / `truncate(W)` / year / month / day / hour / void. Each transform validates against the source column type at synth time.\n- **`IcebergDataFormat`** (parquet/orc/avro, default parquet), **`IcebergFormatVersion`** (v1/v2/v3, required — set explicitly per table; Athena cannot query v3 tables), **`IcebergSortDirection`**, **`IcebergNullOrder`**, **`IcebergEdgeAlgorithm`** (`SPHERICAL`, `VINCENTY`, `THOMAS`, `ANDOYER`, `KARNEY`; the second argument of `IcebergType.geography`), plus a `tableProperties` validator that catches misconfigured properties before they leave your machine (wrong codec for the chosen format, `merge-on-read` on a v1 table, non-positive numeric values, …).\n\n## Using `IcebergTable`\n\nA minimal table:\n\n```typescript\nimport {\n Bucket,\n} from 'aws-cdk-lib/aws-s3';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nconst bucket = new Bucket(this, 'Warehouse');\n\nconst db = new Database(this, 'Db', {\n databaseName: 'analytics',\n});\n\nnew IcebergTable(this, 'Users', {\n database: db,\n tableName: 'users',\n columns: [\n {\n name: 'user_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'email',\n type: IcebergType.STRING,\n required: true,\n id: 2,\n },\n {\n name: 'signed_up_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 3,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/users/`,\n formatVersion: IcebergFormatVersion.V2,\n});\n```\n\nEvery top-level column must declare an `id`: a stable, unique,\npositive integer you pick once and never reuse or reassign. Because\nIceberg data files reference fields by id rather than by name, a fixed\nid, declared in creation order when the table is created (below), is\nwhat lets you add, rename, and drop columns across deploys without\ncorrupting old data — see\n[How do I evolve an Iceberg table schema](#how-do-i-evolve-an-iceberg-table-schema-add-rename-or-drop-a-column-in-cloudformation).\nOnce a column is dropped, leave its id retired; never hand it to a new\ncolumn. Nested fields follow the same rule: every struct field takes\nan `id`, every list an `elementId`, and every map a `keyId` and a\n`valueId`. All ids in a schema, top-level and nested, must be distinct\nintegers from 1 to 2147483447.\n\nA new table must declare its ids in creation order. When Glue creates\na table it does not keep the declared ids: it numbers the fields from\n1 in creation order and points the partition spec, sort order and\nidentifier fields at the new ids. An update Glue accepts stores the\ndeclared ids as given, so the first such update of a table created\nwith other ids renumbers its fields; for the update Glue rejects, see\n[Known limitations](#known-limitations). To number a new table, number\nthe top-level columns first, in order, then the nested fields of each\ncolumn in turn (a list's element; a map's key, then its value, then\nthe key's nested fields, then the value's; a struct's fields, then\ntheir nested fields). `IcebergTable.creationOrderFieldIds` returns\nthese ids by field path and ignores the ids in its input:\n\n```typescript\nconst columns = [\n { name: 'id', type: IcebergType.LONG, required: true, id: 1 },\n { name: 'tags', type: IcebergType.list({ element: IcebergType.STRING, elementId: 4 }), id: 2 },\n {\n name: 'attrs',\n type: IcebergType.map({ key: IcebergType.STRING, keyId: 5, value: IcebergType.STRING, valueId: 6 }),\n id: 3,\n },\n];\nIcebergTable.creationOrderFieldIds(columns);\n// { id: 1, tags: 2, attrs: 3, 'tags.element': 4, 'attrs.key': 5, 'attrs.value': 6 }\n```\n\nIds out of creation order are for fields a later deploy adds; see\n[Evolving schema and partitions](#evolving-schema-and-partitions).\n\nA table that exercises most of the surface (partitions, sort order,\nnested types, identifier fields, table properties, removal policy):\n\n```typescript\nimport {\n RemovalPolicy,\n} from 'aws-cdk-lib';\nimport {\n Database,\n} from 'aws-cdk-lib/aws-glue';\nimport {\n IcebergDataFormat,\n IcebergFormatVersion,\n IcebergNullOrder,\n IcebergPartitionTransform,\n IcebergSortDirection,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'OrdersTable', {\n database: db,\n tableName: 'orders',\n comment: 'Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.',\n columns: [\n {\n name: 'order_id',\n type: IcebergType.LONG,\n required: true,\n id: 1,\n },\n {\n name: 'customer_id',\n type: IcebergType.LONG,\n required: true,\n id: 2,\n },\n {\n name: 'order_amount',\n type: IcebergType.decimal(12, 2),\n required: true,\n id: 3,\n },\n {\n name: 'currency',\n type: IcebergType.STRING,\n required: true,\n id: 4,\n },\n {\n name: 'placed_at',\n type: IcebergType.TIMESTAMPTZ,\n required: true,\n id: 5,\n },\n {\n name: 'tags',\n type: IcebergType.list({\n element: IcebergType.STRING,\n elementId: 9,\n }),\n id: 6,\n },\n {\n name: 'shipping_address',\n type: IcebergType.struct([\n {\n id: 10,\n name: 'line1',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 11,\n name: 'city',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 12,\n name: 'country',\n type: IcebergType.STRING,\n required: true,\n },\n {\n id: 13,\n name: 'postal_code',\n type: IcebergType.STRING,\n },\n ]),\n id: 7,\n },\n {\n name: 'metadata',\n type: IcebergType.map({\n key: IcebergType.STRING,\n keyId: 14,\n value: IcebergType.STRING,\n valueId: 15,\n }),\n id: 8,\n },\n ],\n location: `s3://${bucket.bucketName}/analytics/orders/`,\n partitionSpec: [\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1000,\n },\n {\n sourceColumn: 'customer_id',\n transform: IcebergPartitionTransform.bucket(16),\n fieldId: 1001,\n },\n ],\n sortOrder: [\n {\n sourceColumn: 'placed_at',\n direction: IcebergSortDirection.ASC,\n nullOrder: IcebergNullOrder.NULLS_LAST,\n },\n {\n sourceColumn: 'order_id',\n direction: IcebergSortDirection.ASC,\n },\n ],\n identifierFieldNames: [\n 'order_id',\n ],\n dataFormat: IcebergDataFormat.PARQUET,\n formatVersion: IcebergFormatVersion.V2,\n tableProperties: {\n 'write.parquet.compression-codec': 'zstd',\n 'write.delete.mode': 'merge-on-read',\n 'write.update.mode': 'merge-on-read',\n 'write.merge.mode': 'merge-on-read',\n 'write.target-file-size-bytes': '134217728',\n 'history.expire.min-snapshots-to-keep': '5',\n 'gc.enabled': 'true',\n },\n removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\nEach partition field also pins a `fieldId`: an integer of 1000 or\nabove (the Iceberg spec reserves lower ids for schema columns), unique\nacross the table's entire partition-spec history. The discipline is\nthe inverse of the column-id rule. A column keeps its id forever; a\npartition field keeps its id only while it stays untouched. Change\nanything about a field — swap `month` for `day`, point it at a\ndifferent source column — and it becomes a *new* field that needs a\nfresh, never-before-used id, while the old id retires with the old\nspec. Reusing a retired id (or reassigning an id to a different field)\nproduces a table that Athena still reads but Spark and Trino reject\nwith `ValidationException: Conflicting partition fields`.\n\n`identifierFieldNames` lists the columns that together identify a row\nand renders as the schema's `identifier-field-ids`. Each one must be a\n`required: true` column (Glue rejects an optional one), and `cdk synth`\nrejects an identifier column of type float, double, list, map, struct,\nunknown, variant, geometry or geography. The construct prefixes each\nidentifier column's `doc` with `(PK) `, so a `doc` you write must not\nstart with `(PK) `; see [Evolving schema and\npartitions](#evolving-schema-and-partitions).\n\nEvery string you pass is a literal string, not a token, and an\nenum-typed one must be a member of its enum; the exceptions are\n`location`, `comment`, table property values, and the `tableName` of\nan imported table.\n\nThe resulting Iceberg `metadata.json` for this table contains every\nfeature you set:\n\n```json\n{\n \"format-version\": 2,\n \"table-uuid\": \"39a948f9-...\",\n \"current-schema-id\": 0,\n \"schemas\": [\n {\n \"schema-id\": 0,\n \"identifier-field-ids\": [1],\n \"fields\": [\n { \"id\": 1, \"name\": \"order_id\", \"required\": true, \"type\": \"long\", \"doc\": \"(PK) \" },\n { \"id\": 2, \"name\": \"customer_id\", \"required\": true, \"type\": \"long\" },\n { \"id\": 3, \"name\": \"order_amount\", \"required\": true, \"type\": \"decimal(12, 2)\" },\n { \"id\": 4, \"name\": \"currency\", \"required\": true, \"type\": \"string\" },\n { \"id\": 5, \"name\": \"placed_at\", \"required\": true, \"type\": \"timestamptz\" },\n { \"id\": 6, \"name\": \"tags\", \"required\": false,\n \"type\": { \"type\": \"list\", \"element-id\": 9, \"element\": \"string\", \"element-required\": false } },\n { \"id\": 7, \"name\": \"shipping_address\", \"required\": false,\n \"type\": { \"type\": \"struct\", \"fields\": [\n { \"id\": 10, \"name\": \"line1\", \"required\": true, \"type\": \"string\" },\n { \"id\": 11, \"name\": \"city\", \"required\": true, \"type\": \"string\" },\n { \"id\": 12, \"name\": \"country\", \"required\": true, \"type\": \"string\" },\n { \"id\": 13, \"name\": \"postal_code\", \"required\": false, \"type\": \"string\" }\n ] } },\n { \"id\": 8, \"name\": \"metadata\", \"required\": false,\n \"type\": { \"type\": \"map\", \"key-id\": 14, \"key\": \"string\", \"value-id\": 15,\n \"value-required\": false, \"value\": \"string\" } }\n ]\n }\n ],\n \"partition-specs\": [\n { \"spec-id\": 0, \"fields\": [\n { \"name\": \"placed_at_day\", \"transform\": \"day\", \"source-id\": 5, \"field-id\": 1000 },\n { \"name\": \"customer_id_bucket\", \"transform\": \"bucket[16]\", \"source-id\": 2, \"field-id\": 1001 }\n ]}\n ],\n \"sort-orders\": [\n { \"order-id\": 1, \"fields\": [\n { \"transform\": \"identity\", \"source-id\": 5, \"direction\": \"asc\", \"null-order\": \"nulls-last\" },\n { \"transform\": \"identity\", \"source-id\": 1, \"direction\": \"asc\", \"null-order\": \"nulls-last\" }\n ]}\n ],\n \"properties\": {\n \"format-version\": \"2\",\n \"write.format.default\": \"parquet\",\n \"write.parquet.compression-codec\": \"zstd\",\n \"write.merge.mode\": \"merge-on-read\",\n \"write.update.mode\": \"merge-on-read\",\n \"write.delete.mode\": \"merge-on-read\",\n \"write.target-file-size-bytes\": \"134217728\",\n \"history.expire.min-snapshots-to-keep\": \"5\",\n \"gc.enabled\": \"true\",\n \"comment\": \"Demo Iceberg orders table — exercises partitions, sort order, and merge-on-read.\"\n }\n}\n```\n\n### Format version 3\n\nSet `formatVersion: IcebergFormatVersion.V3` to create a v3 table. The\nsix v3 types (below) are only accepted on a V3 table, at any nesting\ndepth: inside a struct, as a list element, or as a map key or value.\nSynth fails on a V1 or V2 table that uses one.\n\n```typescript\nimport {\n IcebergEdgeAlgorithm,\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n} from 'cdk-glue-iceberg-table';\n\nnew IcebergTable(this, 'Events', {\n database: db,\n tableName: 'events',\n location: `s3://${bucket.bucketName}/analytics/events/`,\n columns: [\n { name: 'occurred_at', type: IcebergType.TIMESTAMP_NS, id: 1 },\n { name: 'payload', type: IcebergType.VARIANT, id: 2 },\n {\n name: 'origin',\n type: IcebergType.geography('OGC:CRS84', IcebergEdgeAlgorithm.SPHERICAL),\n id: 3,\n },\n ],\n formatVersion: IcebergFormatVersion.V3,\n});\n```\n\nThe same table in Python:\n\n```python\nfrom cdk_glue_iceberg_table import (\n IcebergEdgeAlgorithm,\n IcebergFormatVersion,\n IcebergTable,\n IcebergType,\n)\n\nIcebergTable(self, \"Events\",\n database=db,\n table_name=\"events\",\n location=f\"s3://{bucket.bucket_name}/analytics/events/\",\n columns=[\n {\"name\": \"occurred_at\", \"type\": IcebergType.TIMESTAMP_NS, \"id\": 1},\n {\"name\": \"payload\", \"type\": IcebergType.VARIANT, \"id\": 2},\n {\n \"name\": \"origin\",\n \"type\": IcebergType.geography(\"OGC:CRS84\", IcebergEdgeAlgorithm.SPHERICAL),\n \"id\": 3,\n },\n ],\n format_version=IcebergFormatVersion.V3,\n)\n```\n\nThis table has a `timestamp_ns` column; see [Known limitations](#known-limitations)\nbefore reading it from upstream Spark.\n\nThe v3 types, with the rules `cdk synth` enforces:\n\n| Type | Factory | Rendered string | Partition and identifier rules |\n| --- | --- | --- | --- |\n| unknown | `IcebergType.UNKNOWN` | `unknown` | Must be optional, as a column, list element, or map value; never a map key. Partition source only with `void`. Not an identifier field. |\n| timestamp with nanoseconds | `IcebergType.TIMESTAMP_NS` | `timestamp_ns` | `identity`, `year`, `month`, `day`, `hour`, `bucket(N)`, `void`; not `truncate(W)`. Allowed as an identifier field. |\n| timestamptz with nanoseconds | `IcebergType.TIMESTAMPTZ_NS` | `timestamptz_ns` | Same as `timestamp_ns`. |\n| variant | `IcebergType.VARIANT` | `variant` | Never a partition or sort source, `void` included. Not an identifier field. |\n| geometry | `IcebergType.geometry(crs?)` | `geometry`, or `geometry(<crs>)` when a CRS is given | Partition source only with `void`. Not an identifier field. |\n| geography | `IcebergType.geography(crs?, algorithm?)` | `geography`, `geography(<crs>)`, or `geography(<crs>, <algorithm>)` when an algorithm is given, such as `geography(OGC:CRS84, spherical)` | Same as `geometry`. |\n\nA geometry or geography `crs` is an identifier such as `OGC:CRS84` or\n`EPSG:3857`; whitespace, parentheses, braces, and commas are rejected.\nWhen `algorithm` is set without a `crs`, the rendered string spells out\n`OGC:CRS84`.\n\nWhich engines read a v3 table created by the construct:\n\n| Engine | v3 tables | Notes |\n| --- | --- | --- |\n| Spark 4.1.1 + Iceberg 1.11.0 (the integration-test runner) | Yes | Reads and writes tables the construct creates, including deletion vectors, row lineage, `variant` and `unknown`, except tables with a `geometry`, `geography` or nanosecond-timestamp column ([Known limitations](#known-limitations)). |\n| AWS Glue 6.0 | Documented | The [AWS Glue versions](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html) page lists \"Iceberg format version 3 with VARIANT data type, deletion vectors, row lineage tracking, nanosecond timestamps, and geo types\". The integration suites run on Glue 6.0's Spark 4.1.1 and Iceberg 1.11.0 (`scripts/spark/spark-env.sh`); the Glue job runtime itself is not exercised. |\n| Amazon EMR Spark 8.1.0 (Spark 4.1.1, Iceberg 1.11.0-amzn-0) | Documented | The [emr-spark-8.1.0 release notes](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-spark810-release.html) state \"Amazon EMR Spark 8.1.0 extends Iceberg v3 spec support for Spark workloads\". The integration suites do not run on EMR 8.1. |\n| Athena SQL | No | The [Athena Iceberg page](https://docs.aws.amazon.com/athena/latest/ug/querying-iceberg.html) states \"Athena only creates and operates on Iceberg v2 tables.\" The v2 integration suites also run through Athena (see [Does it work with Athena and Lake Formation?](#does-it-work-with-athena-and-lake-formation)); no v3 table is queried through Athena. |\n\n### Granting access\n\n```typescript\ntable.grantRead(role); // Glue read + S3 read on the table's prefix\ntable.grantWrite(role); // Glue write + S3 write\ntable.grantReadWrite(role);\n```\n\nThe `grant*` helpers issue **IAM grants only**. Under Lake Formation\nyou still add the matching `SELECT` / `INSERT` / `DELETE` LF grants on\ntop of the construct's IAM grants for Athena queries to succeed.\n\n### Importing an existing table\n\n```typescript\nconst existing = IcebergTable.fromIcebergTableAttributes(this, 'Orders', {\n database: db,\n tableName: 'orders',\n location: 's3://my-bucket/analytics/orders/',\n});\nexisting.grantRead(role);\n```\n\n### Evolving schema and partitions\n\nChange the `columns` array (or `partitionSpec`) and run `cdk deploy`\nagain. The construct passes the new schema to Glue's `UpdateTable`,\nwhich writes a new `metadata.json` with a new `schema-id`; existing\ndata files stay readable because each column's `id` is pinned to the\nid the table holds and never reused. Adds, renames (same `id`, new\n`name`), and drops all flow through `cdk deploy` alone — no\nout-of-band SQL DDL.\n\nNested fields evolve the same way. Each struct field, list element,\nmap key, and map value keeps the id you gave it (the rule is under\n[Using `IcebergTable`](#using-icebergtable)), so adding a column or a\nstruct field anywhere in the schema leaves every other id unchanged. A\nnew nested field takes an id no field of the table has ever used:\n\n```typescript\ntype: IcebergType.struct([\n { id: 10, name: 'line1', type: IcebergType.STRING },\n { id: 16, name: 'line2', type: IcebergType.STRING }, // new field, never-used id\n { id: 11, name: 'city', type: IcebergType.STRING },\n]),\n```\n\nSuch an id is out of creation order, which is expected once a table\nhas evolved: creation order applies only to the ids a table is created\nwith (see [Using `IcebergTable`](#using-icebergtable)).\n\nUpgrading from a version before 0.12.0, which numbered nested fields\nitself: declare the ids the table's current `metadata.json` holds,\ntop-level and nested (each field `id`, `element-id`, `key-id` and\n`value-id`), or the next deploy renumbers the fields that differ and\nexisting data files read under the wrong field. A nested type object\nshared by two columns now fails synth with a duplicate id; give each\ncolumn its own nested type with its own ids. The list element and map\nvalue nullability default also changed: `elementRequired` and\n`valueRequired` now default to `false`. Earlier versions made list\nelements required by default and map values required unless the third\nargument of `map` was `false`; set `elementRequired: true` or\n`valueRequired: true` wherever the deployed schema has\n`\"element-required\": true` or `\"value-required\": true`.\n\nGlue's `UpdateTable` reuses an earlier schema whose fields (name,\ntype, `required`, `doc`) match the request, together with that\nschema's `identifier-field-ids`. The construct therefore prefixes the\n`doc` of every identifier column with `(PK) ` (just `(PK) ` when the\ncolumn has no `doc`), shown as the column comment, so every\nidentifier change is a field change. On a table whose schema history\nwas written with the marker, identifier changes flow through `cdk\ndeploy` like column changes.\n\nPartition evolution flows the same way, with one extra rule on\n`fieldId`: a changed partition field is a new partition field. To move\na table from `month(placed_at)` to `day(placed_at)`, drop the month\nentry and add a day entry under a fresh `fieldId` — never recycle the\nmonth field's id:\n\n```typescript\npartitionSpec: [\n // was: { sourceColumn: 'placed_at', transform: IcebergPartitionTransform.MONTH, fieldId: 1000 },\n {\n sourceColumn: 'placed_at',\n transform: IcebergPartitionTransform.DAY,\n fieldId: 1001,\n },\n],\n```\n\nOld data files written under the month spec stay readable; new writes\npartition by day. Reusing `1000` for the day field instead corrupts\nthe spec history for strict engines (Spark, Trino) while Athena keeps\nworking — the failure only surfaces at Spark runtime.\n\n### Inserting and querying\n\n```sql\n-- INSERT into the orders table\nINSERT INTO sample_database.orders VALUES\n (1001, 5001, DECIMAL '149.99', 'USD',\n TIMESTAMP '2026-05-20 09:15:00 UTC',\n ARRAY['holiday-promo','first-order'],\n CAST(ROW('1 Infinite Loop','Cupertino','US','95014')\n AS ROW(line1 VARCHAR,city VARCHAR,country VARCHAR,postal_code VARCHAR)),\n MAP(ARRAY['channel','utm'], ARRAY['web','google'])),\n -- ... more rows\n;\n\n-- merge-on-read DELETE (only legal because we chose v2 + merge-on-read mode)\nDELETE FROM sample_database.orders WHERE order_id = 1003;\n\n-- merge-on-read UPDATE\nUPDATE sample_database.orders SET currency = 'GBP' WHERE customer_id = 5002;\n\n-- SELECT\nSELECT customer_id, SUM(order_amount) AS total\n FROM sample_database.orders\n GROUP BY 1\n ORDER BY 2 DESC;\n```\n\n## Two footguns the construct prevents\n\n### Footgun #1 — schema under `storageDescriptor.columns`\n\nThe CREATE succeeds but the first UPDATE silently strips\n`table_type=ICEBERG` from the table's Glue parameters, and Athena\nqueries after that fail with `HIVE_UNSUPPORTED_FORMAT`.\n\n```typescript\n// DON'T DO THIS — what most StackOverflow / re:Post examples show\nnew CfnTable(this, 'OrdersBad', {\n catalogId: this.account,\n databaseName: 'analytics',\n tableInput: {\n name: 'orders',\n tableType: 'EXTERNAL_TABLE',\n parameters: {\n table_type: 'ICEBERG',\n },\n storageDescriptor: {\n location: 's3://.../orders/',\n columns: [\n /* ... */\n ],\n },\n },\n openTableFormatInput: {\n icebergInput: {\n metadataOperation: 'CREATE',\n version: '2',\n },\n },\n});\n```\n\n`IcebergTable` instead always emits schema/partitions/sort/properties\nunder `openTableFormatInput.icebergInput.icebergTableInput`, never\nunder `storageDescriptor`.\n\n### Footgun #2 — `tableInput` co-present with `openTableFormatInput`\n\nEven setting just `tableInput: { name: 'foo' }` next to\n`openTableFormatInput` returns\n`\"Table metadata is expected only via TableInput or via IcebergTableInputProperties inside OpenTableFormatInput\"`.\nThe construct never emits `tableInput`; the table-level comment goes\ninto `tableProperties['comment']`, which lives inside\n`icebergTableInput.properties`.\n\n(There is a third footgun, field-id reuse after a column drop, that\nthe construct does **not** prevent. See the next section.)\n\n## Known limitations\n\n- **Creation order is not checked.** The construct cannot tell at synth whether a table is new or already deployed, so it accepts a new table whose ids are not in creation order (the rule is under [Using `IcebergTable`](#using-icebergtable)). When the first update of such a table changes the id of a column an identity partition is sourced from, Glue rejects the update with `Cannot create identity partition sourced from different field in schema` and the CloudFormation rollback fails the same way, leaving the stack in `UPDATE_ROLLBACK_FAILED`.\n- **Field-id reuse is not detected across deploys.** This applies to nested ids (struct field, list element, map key and value) as well as column ids. If you drop a column with `id = 5` and then add a different column with `id = 5` in a later deploy, Glue accepts the UPDATE and Iceberg's metadata silently violates the \"never reuse a retired id\" invariant. Readers projecting old snapshots will surface deleted data under the new field's name. The construct enforces uniqueness **within one deploy** (`duplicate field id N` validator), but it doesn't compare against the live table state. The safe workflow is to treat dropped ids as retired forever.\n- **Partition field-id reuse is not detected across deploys either.** The same live-state blindness applies to partition `fieldId`s: the construct validates them within one deploy (integer >= 1000, unique in the spec), but it cannot tell that the id you pinned already appeared in an earlier spec of the deployed table. The invariant partition ids must uphold is stricter than the column one — unique across the table's **entire spec history**, so a changed field (different transform or source column) must take a fresh id rather than keep its old one. Violate it and strict engines (Spark, Trino) reject the table with `Conflicting partition fields` while Athena keeps answering, masking the break until Spark runtime. The safe workflow: treat every id that has ever appeared in any spec as retired, and allocate new fields the next never-used id. A partition change needs a new source column or transform; Glue ignores a `fieldId`-only change.\n- **`last-partition-id` is written by Glue, not by the construct.** The construct supplies the spec's field ids; Glue's `UpdateTable` computes the table's `last-partition-id` counter when it writes the new metadata. The repo's integration test asserts the counter keeps up with the highest supplied field id after a partition evolution, but engines that later evolve the spec themselves (e.g. Spark `ALTER TABLE … ADD PARTITION FIELD`) allocate from that counter — if you mix CDK-managed and engine-managed partition evolution, verify the counter in `metadata.json` before trusting engine-side changes.\n- **Removing the last identifier from a table created with identifiers before 0.11.0 can bring the old ids back.** That table's history holds an unmarked schema with ids, and Glue reuses it when the rendered fields match it again. Change a column `doc` in the same deploy that removes the last identifier.\n- **CREATE-only metadata operation.** The CFN `IcebergInput.metadataOperation` only accepts `CREATE`; the construct always emits that. Subsequent deploys use Glue's normal `UpdateTable` path, which writes new Iceberg metadata in-place.\n- **Format version is immutable after CREATE.** Glue ignores a V2 to V3 `formatVersion` change, though `properties.format-version` then reads `3`. Keep `formatVersion` at the table's real version, or destroy + recreate the table to change it. An engine can upgrade a v2 table to v3 in place with `ALTER TABLE ... SET TBLPROPERTIES ('format-version' = '3')`; after that, set `formatVersion` to `V3` so the next deploy declares the version the table already has.\n- **`merge-on-read` requires v2 or later.** The construct rejects `write.{delete,update,merge}.mode = merge-on-read` on a v1 table at synth time.\n- **Column defaults are not available.** Iceberg v3 `initial-default` and `write-default` cannot be declared through CloudFormation: the `AWS::Glue::Table` resource schema has no `InitialDefault` or `WriteDefault` property. Revisit when that schema gains the two properties.\n- **Nanosecond timestamps are catalog-only for Spark 4.1.1 with Iceberg 1.11.0.** In [`TypeToSparkType`](https://github.com/apache/iceberg/blob/apache-iceberg-1.11.0/spark/v4.1/spark/src/main/java/org/apache/iceberg/spark/TypeToSparkType.java) at the `apache-iceberg-1.11.0` tag, `primitive()` has no case for the `TIMESTAMP_NANO` type id, so a table with a `timestamp_ns` or `timestamptz_ns` column reaches the `Cannot convert unsupported type to Spark` error. The integration suite asserts these columns from `metadata.json` only.\n- **Geometry and geography columns are catalog-only for Spark 4.1.1 with Iceberg 1.11.0, the versions AWS Glue 6.0 ships.** The first Spark read of a table holding a `geography` and a `geometry` column failed with `UnsupportedOperationException: Cannot convert unsupported type to Spark: geography(OGC:CRS84, spherical)` on those versions. [`TypeToSparkType`](https://github.com/apache/iceberg/blob/apache-iceberg-1.11.0/spark/v4.1/spark/src/main/java/org/apache/iceberg/spark/TypeToSparkType.java) at the `apache-iceberg-1.11.0` tag has no conversion for `geometry` either. The integration suite deploys these columns on a table no Spark job opens and asserts them from `metadata.json` only.\n- **Athena DDL features that don't surface through CFN** (e.g. `ALTER TABLE WRITE ORDERED BY`, `ALTER TABLE … SET LOCATION`, `bucketed_by` / `bucket_count` Hive clauses) are not exposed. Use `IcebergPartitionTransform.bucket(N)` instead of Hive bucketing.\n- **Dropping a partition column requires a `void` intermediate per the Iceberg spec**, and the CFN `OpenTableFormatInput` cannot express that. The construct accepts the change, but Athena queries against the result will fail with `Type cannot be null`. The safe pattern is to drop partitions that source from a column while keeping that column in the schema, and only drop a column once it is no longer partitioning anything.\n\n## FAQ\n\n### How do I create an Apache Iceberg table in AWS CDK?\n\nInstall `cdk-glue-iceberg-table`, then declare an `IcebergTable` with a\ndatabase, a column list, and an S3 `location` — see [Use](#use).\n`cdk deploy` creates the Glue Data Catalog table and writes the\nIceberg `metadata.json` under your S3 prefix. No custom resource or\nLambda is involved; it is a plain `AWS::Glue::Table` in your\nCloudFormation template.\n\n### How do I evolve an Iceberg table schema (add, rename, or drop a column) in CloudFormation?\n\nChange the `columns` array and run `cdk deploy` again. The construct\npasses the new schema to Glue's `UpdateTable`, which writes a new\n`metadata.json` with a new `schema-id`; existing data files stay\nreadable because each column's `id` is pinned to the id the table\nholds and never reused.\nPartition changes work the same way, except a changed partition field\ntakes a fresh `fieldId` instead of keeping its old one. See [Evolving\nschema and partitions](#evolving-schema-and-partitions).\n\n### Does CloudFormation support Iceberg tables natively?\n\nYes, through `AWS::Glue::Table` with `OpenTableFormatInput.IcebergInput`,\ndocumented by AWS in [December 2025](https://aws.amazon.com/blogs/big-data/create-and-update-apache-iceberg-tables-with-partitions-in-the-aws-glue-data-catalog-using-the-aws-sdk-and-aws-cloudformation).\nThe catch is that the raw shape corrupts the table on the first\n`Update` if you place schema under `storageDescriptor.columns` or set\n`tableInput` alongside `openTableFormatInput`. This construct only ever\nemits the safe shape and gives you no way to express the unsafe ones.\nSee [Two footguns the construct prevents](#two-footguns-the-construct-prevents).\n\n### What is the difference between cdk-glue-iceberg-table and a raw CfnTable?\n\nA raw `CfnTable` makes you hand-write the `OpenTableFormatInput` JSON\nand own both silent-corruption footguns. `cdk-glue-iceberg-table` gives\nyou a typed `IcebergType` / `IcebergPartitionTransform` API,\nsynth-time validation (partition transforms checked against column\ntypes, format/version mismatches caught before deploy), pinned field\nIDs for safe evolution (declared in creation order for a new table),\nand `grantRead` / `grantWrite` helpers. See\n[How it compares](#how-it-compares).\n\n### How do I create a partitioned Iceberg table in CDK?\n\nPass a `partitionSpec` of `IcebergPartitionTransform` entries —\n`identity`, `bucket(N)`, `truncate(W)`, `year`, `month`, `day`, `hour`,\nor `void` — each pinned to a `fieldId` of 1000 or above. Transforms are\nvalidated against their source column's type at synth time. See\n[Using `IcebergTable`](#using-icebergtable).\n\n### Does it work with Athena and Lake Formation?\n\nYes for v2 tables, no for v3 (see the engine matrix in [Format\nversion 3](#format-version-3)). The demo app in the\n[`arceus`](https://github.com/ksco92/arceus) repo registers its tables\nwith Lake Formation, and its v2 integration suites query them through\nAthena as well as Spark, on the same tables:\n\n- merge-on-read `INSERT`, `UPDATE`, `DELETE` and `MERGE INTO`, time\n travel (`FOR VERSION AS OF` / `FOR TIMESTAMP AS OF`), `OPTIMIZE ...\n REWRITE DATA USING BIN_PACK`, and `VACUUM`;\n- a read after every schema, partition, identifier and nested-field\n evolution step;\n- the `(PK) ` comment on identifier columns, read from\n `information_schema.columns`;\n- rows written by Spark read through Athena, and rows written by Athena\n read through Spark.\n\nThe suites grant the querying principal `SELECT`, `INSERT`, `DELETE`,\n`ALTER` and `DESCRIBE` through Lake Formation. The construct's `grant*`\nhelpers issue IAM grants only; under Lake Formation you add the\nmatching LF grants. See [Granting access](#granting-access).\n\n### Can I use Iceberg v2 merge-on-read (row-level UPDATE and DELETE)?\n\nYes — set `formatVersion: IcebergFormatVersion.V2` and the\n`write.{delete,update,merge}.mode = merge-on-read` table properties.\nThe construct rejects merge-on-read on a v1 table at synth time.\n\n### Can I create an Iceberg v3 table?\n\nYes. Set `formatVersion: IcebergFormatVersion.V3`; see [Format\nversion 3](#format-version-3) for the types, the engine matrix and the\nlimits.\n\n## Contributing\n\nDevelopment, the monorepo layout, and the demo app live in [CONTRIBUTING.md](https://github.com/ksco92/arceus/blob/main/CONTRIBUTING.md).\n\n## License\n\n[MIT](https://github.com/ksco92/arceus/blob/main/LICENSE).\n"
9755
9755
  },
9756
9756
  "repository": {
9757
9757
  "directory": "packages/cdk-glue-iceberg-table",
@@ -9779,7 +9779,7 @@
9779
9779
  "kind": "interface",
9780
9780
  "locationInModule": {
9781
9781
  "filename": "lib/iceberg/iceberg-table.ts",
9782
- "line": 219
9782
+ "line": 224
9783
9783
  },
9784
9784
  "methods": [
9785
9785
  {
@@ -9790,7 +9790,7 @@
9790
9790
  },
9791
9791
  "locationInModule": {
9792
9792
  "filename": "lib/iceberg/iceberg-table.ts",
9793
- "line": 233
9793
+ "line": 238
9794
9794
  },
9795
9795
  "name": "grantRead",
9796
9796
  "parameters": [
@@ -9815,7 +9815,7 @@
9815
9815
  },
9816
9816
  "locationInModule": {
9817
9817
  "filename": "lib/iceberg/iceberg-table.ts",
9818
- "line": 239
9818
+ "line": 244
9819
9819
  },
9820
9820
  "name": "grantReadWrite",
9821
9821
  "parameters": [
@@ -9840,7 +9840,7 @@
9840
9840
  },
9841
9841
  "locationInModule": {
9842
9842
  "filename": "lib/iceberg/iceberg-table.ts",
9843
- "line": 236
9843
+ "line": 241
9844
9844
  },
9845
9845
  "name": "grantWrite",
9846
9846
  "parameters": [
@@ -9869,7 +9869,7 @@
9869
9869
  "immutable": true,
9870
9870
  "locationInModule": {
9871
9871
  "filename": "lib/iceberg/iceberg-table.ts",
9872
- "line": 227
9872
+ "line": 232
9873
9873
  },
9874
9874
  "name": "database",
9875
9875
  "type": {
@@ -9885,7 +9885,7 @@
9885
9885
  "immutable": true,
9886
9886
  "locationInModule": {
9887
9887
  "filename": "lib/iceberg/iceberg-table.ts",
9888
- "line": 230
9888
+ "line": 235
9889
9889
  },
9890
9890
  "name": "location",
9891
9891
  "type": {
@@ -9901,7 +9901,7 @@
9901
9901
  "immutable": true,
9902
9902
  "locationInModule": {
9903
9903
  "filename": "lib/iceberg/iceberg-table.ts",
9904
- "line": 221
9904
+ "line": 226
9905
9905
  },
9906
9906
  "name": "tableArn",
9907
9907
  "type": {
@@ -9917,7 +9917,7 @@
9917
9917
  "immutable": true,
9918
9918
  "locationInModule": {
9919
9919
  "filename": "lib/iceberg/iceberg-table.ts",
9920
- "line": 224
9920
+ "line": 229
9921
9921
  },
9922
9922
  "name": "tableName",
9923
9923
  "type": {
@@ -9938,7 +9938,7 @@
9938
9938
  "kind": "interface",
9939
9939
  "locationInModule": {
9940
9940
  "filename": "lib/iceberg/iceberg-table.ts",
9941
- "line": 79
9941
+ "line": 84
9942
9942
  },
9943
9943
  "name": "IcebergColumn",
9944
9944
  "properties": [
@@ -9952,7 +9952,7 @@
9952
9952
  "immutable": true,
9953
9953
  "locationInModule": {
9954
9954
  "filename": "lib/iceberg/iceberg-table.ts",
9955
- "line": 100
9955
+ "line": 105
9956
9956
  },
9957
9957
  "name": "id",
9958
9958
  "type": {
@@ -9968,7 +9968,7 @@
9968
9968
  "immutable": true,
9969
9969
  "locationInModule": {
9970
9970
  "filename": "lib/iceberg/iceberg-table.ts",
9971
- "line": 81
9971
+ "line": 86
9972
9972
  },
9973
9973
  "name": "name",
9974
9974
  "type": {
@@ -9984,7 +9984,7 @@
9984
9984
  "immutable": true,
9985
9985
  "locationInModule": {
9986
9986
  "filename": "lib/iceberg/iceberg-table.ts",
9987
- "line": 84
9987
+ "line": 89
9988
9988
  },
9989
9989
  "name": "type",
9990
9990
  "type": {
@@ -10001,7 +10001,7 @@
10001
10001
  "immutable": true,
10002
10002
  "locationInModule": {
10003
10003
  "filename": "lib/iceberg/iceberg-table.ts",
10004
- "line": 93
10004
+ "line": 98
10005
10005
  },
10006
10006
  "name": "doc",
10007
10007
  "optional": true,
@@ -10019,7 +10019,7 @@
10019
10019
  "immutable": true,
10020
10020
  "locationInModule": {
10021
10021
  "filename": "lib/iceberg/iceberg-table.ts",
10022
- "line": 90
10022
+ "line": 95
10023
10023
  },
10024
10024
  "name": "required",
10025
10025
  "optional": true,
@@ -10078,7 +10078,7 @@
10078
10078
  "kind": "enum",
10079
10079
  "locationInModule": {
10080
10080
  "filename": "lib/iceberg/iceberg-type.ts",
10081
- "line": 40
10081
+ "line": 44
10082
10082
  },
10083
10083
  "members": [
10084
10084
  {
@@ -10165,7 +10165,7 @@
10165
10165
  "kind": "interface",
10166
10166
  "locationInModule": {
10167
10167
  "filename": "lib/iceberg/iceberg-type.ts",
10168
- "line": 70
10168
+ "line": 74
10169
10169
  },
10170
10170
  "name": "IcebergListDefinition",
10171
10171
  "properties": [
@@ -10178,7 +10178,7 @@
10178
10178
  "immutable": true,
10179
10179
  "locationInModule": {
10180
10180
  "filename": "lib/iceberg/iceberg-type.ts",
10181
- "line": 72
10181
+ "line": 76
10182
10182
  },
10183
10183
  "name": "element",
10184
10184
  "type": {
@@ -10194,7 +10194,7 @@
10194
10194
  "immutable": true,
10195
10195
  "locationInModule": {
10196
10196
  "filename": "lib/iceberg/iceberg-type.ts",
10197
- "line": 75
10197
+ "line": 79
10198
10198
  },
10199
10199
  "name": "elementId",
10200
10200
  "type": {
@@ -10211,7 +10211,7 @@
10211
10211
  "immutable": true,
10212
10212
  "locationInModule": {
10213
10213
  "filename": "lib/iceberg/iceberg-type.ts",
10214
- "line": 78
10214
+ "line": 82
10215
10215
  },
10216
10216
  "name": "elementRequired",
10217
10217
  "optional": true,
@@ -10234,7 +10234,7 @@
10234
10234
  "kind": "interface",
10235
10235
  "locationInModule": {
10236
10236
  "filename": "lib/iceberg/iceberg-type.ts",
10237
- "line": 82
10237
+ "line": 86
10238
10238
  },
10239
10239
  "name": "IcebergMapDefinition",
10240
10240
  "properties": [
@@ -10247,7 +10247,7 @@
10247
10247
  "immutable": true,
10248
10248
  "locationInModule": {
10249
10249
  "filename": "lib/iceberg/iceberg-type.ts",
10250
- "line": 84
10250
+ "line": 88
10251
10251
  },
10252
10252
  "name": "key",
10253
10253
  "type": {
@@ -10263,7 +10263,7 @@
10263
10263
  "immutable": true,
10264
10264
  "locationInModule": {
10265
10265
  "filename": "lib/iceberg/iceberg-type.ts",
10266
- "line": 87
10266
+ "line": 91
10267
10267
  },
10268
10268
  "name": "keyId",
10269
10269
  "type": {
@@ -10279,7 +10279,7 @@
10279
10279
  "immutable": true,
10280
10280
  "locationInModule": {
10281
10281
  "filename": "lib/iceberg/iceberg-type.ts",
10282
- "line": 90
10282
+ "line": 94
10283
10283
  },
10284
10284
  "name": "value",
10285
10285
  "type": {
@@ -10295,7 +10295,7 @@
10295
10295
  "immutable": true,
10296
10296
  "locationInModule": {
10297
10297
  "filename": "lib/iceberg/iceberg-type.ts",
10298
- "line": 93
10298
+ "line": 97
10299
10299
  },
10300
10300
  "name": "valueId",
10301
10301
  "type": {
@@ -10312,7 +10312,7 @@
10312
10312
  "immutable": true,
10313
10313
  "locationInModule": {
10314
10314
  "filename": "lib/iceberg/iceberg-type.ts",
10315
- "line": 96
10315
+ "line": 100
10316
10316
  },
10317
10317
  "name": "valueRequired",
10318
10318
  "optional": true,
@@ -10333,7 +10333,7 @@
10333
10333
  "kind": "enum",
10334
10334
  "locationInModule": {
10335
10335
  "filename": "lib/iceberg/iceberg-table.ts",
10336
- "line": 66
10336
+ "line": 71
10337
10337
  },
10338
10338
  "members": [
10339
10339
  {
@@ -10365,7 +10365,7 @@
10365
10365
  "kind": "interface",
10366
10366
  "locationInModule": {
10367
10367
  "filename": "lib/iceberg/iceberg-table.ts",
10368
- "line": 104
10368
+ "line": 109
10369
10369
  },
10370
10370
  "name": "IcebergPartitionField",
10371
10371
  "properties": [
@@ -10379,7 +10379,7 @@
10379
10379
  "immutable": true,
10380
10380
  "locationInModule": {
10381
10381
  "filename": "lib/iceberg/iceberg-table.ts",
10382
- "line": 135
10382
+ "line": 140
10383
10383
  },
10384
10384
  "name": "fieldId",
10385
10385
  "type": {
@@ -10395,7 +10395,7 @@
10395
10395
  "immutable": true,
10396
10396
  "locationInModule": {
10397
10397
  "filename": "lib/iceberg/iceberg-table.ts",
10398
- "line": 106
10398
+ "line": 111
10399
10399
  },
10400
10400
  "name": "sourceColumn",
10401
10401
  "type": {
@@ -10411,7 +10411,7 @@
10411
10411
  "immutable": true,
10412
10412
  "locationInModule": {
10413
10413
  "filename": "lib/iceberg/iceberg-table.ts",
10414
- "line": 109
10414
+ "line": 114
10415
10415
  },
10416
10416
  "name": "transform",
10417
10417
  "type": {
@@ -10428,7 +10428,7 @@
10428
10428
  "immutable": true,
10429
10429
  "locationInModule": {
10430
10430
  "filename": "lib/iceberg/iceberg-table.ts",
10431
- "line": 116
10431
+ "line": 121
10432
10432
  },
10433
10433
  "name": "name",
10434
10434
  "optional": true,
@@ -10533,7 +10533,7 @@
10533
10533
  },
10534
10534
  "locationInModule": {
10535
10535
  "filename": "lib/iceberg/iceberg-partition-transform.ts",
10536
- "line": 148
10536
+ "line": 152
10537
10537
  },
10538
10538
  "name": "toTransformString",
10539
10539
  "returns": {
@@ -11105,7 +11105,7 @@
11105
11105
  "kind": "enum",
11106
11106
  "locationInModule": {
11107
11107
  "filename": "lib/iceberg/iceberg-table.ts",
11108
- "line": 57
11108
+ "line": 62
11109
11109
  },
11110
11110
  "members": [
11111
11111
  {
@@ -11137,7 +11137,7 @@
11137
11137
  "kind": "interface",
11138
11138
  "locationInModule": {
11139
11139
  "filename": "lib/iceberg/iceberg-table.ts",
11140
- "line": 139
11140
+ "line": 144
11141
11141
  },
11142
11142
  "name": "IcebergSortField",
11143
11143
  "properties": [
@@ -11150,7 +11150,7 @@
11150
11150
  "immutable": true,
11151
11151
  "locationInModule": {
11152
11152
  "filename": "lib/iceberg/iceberg-table.ts",
11153
- "line": 141
11153
+ "line": 146
11154
11154
  },
11155
11155
  "name": "sourceColumn",
11156
11156
  "type": {
@@ -11167,7 +11167,7 @@
11167
11167
  "immutable": true,
11168
11168
  "locationInModule": {
11169
11169
  "filename": "lib/iceberg/iceberg-table.ts",
11170
- "line": 147
11170
+ "line": 152
11171
11171
  },
11172
11172
  "name": "direction",
11173
11173
  "optional": true,
@@ -11185,7 +11185,7 @@
11185
11185
  "immutable": true,
11186
11186
  "locationInModule": {
11187
11187
  "filename": "lib/iceberg/iceberg-table.ts",
11188
- "line": 150
11188
+ "line": 155
11189
11189
  },
11190
11190
  "name": "nullOrder",
11191
11191
  "optional": true,
@@ -11203,7 +11203,7 @@
11203
11203
  "immutable": true,
11204
11204
  "locationInModule": {
11205
11205
  "filename": "lib/iceberg/iceberg-table.ts",
11206
- "line": 144
11206
+ "line": 149
11207
11207
  },
11208
11208
  "name": "transform",
11209
11209
  "optional": true,
@@ -11225,7 +11225,7 @@
11225
11225
  "kind": "interface",
11226
11226
  "locationInModule": {
11227
11227
  "filename": "lib/iceberg/iceberg-type.ts",
11228
- "line": 52
11228
+ "line": 56
11229
11229
  },
11230
11230
  "name": "IcebergStructFieldDefinition",
11231
11231
  "properties": [
@@ -11238,7 +11238,7 @@
11238
11238
  "immutable": true,
11239
11239
  "locationInModule": {
11240
11240
  "filename": "lib/iceberg/iceberg-type.ts",
11241
- "line": 54
11241
+ "line": 58
11242
11242
  },
11243
11243
  "name": "id",
11244
11244
  "type": {
@@ -11254,7 +11254,7 @@
11254
11254
  "immutable": true,
11255
11255
  "locationInModule": {
11256
11256
  "filename": "lib/iceberg/iceberg-type.ts",
11257
- "line": 57
11257
+ "line": 61
11258
11258
  },
11259
11259
  "name": "name",
11260
11260
  "type": {
@@ -11270,7 +11270,7 @@
11270
11270
  "immutable": true,
11271
11271
  "locationInModule": {
11272
11272
  "filename": "lib/iceberg/iceberg-type.ts",
11273
- "line": 60
11273
+ "line": 64
11274
11274
  },
11275
11275
  "name": "type",
11276
11276
  "type": {
@@ -11286,7 +11286,7 @@
11286
11286
  "immutable": true,
11287
11287
  "locationInModule": {
11288
11288
  "filename": "lib/iceberg/iceberg-type.ts",
11289
- "line": 66
11289
+ "line": 70
11290
11290
  },
11291
11291
  "name": "doc",
11292
11292
  "optional": true,
@@ -11304,7 +11304,7 @@
11304
11304
  "immutable": true,
11305
11305
  "locationInModule": {
11306
11306
  "filename": "lib/iceberg/iceberg-type.ts",
11307
- "line": 63
11307
+ "line": 67
11308
11308
  },
11309
11309
  "name": "required",
11310
11310
  "optional": true,
@@ -11330,7 +11330,7 @@
11330
11330
  },
11331
11331
  "locationInModule": {
11332
11332
  "filename": "lib/iceberg/iceberg-table.ts",
11333
- "line": 282
11333
+ "line": 287
11334
11334
  },
11335
11335
  "parameters": [
11336
11336
  {
@@ -11359,7 +11359,7 @@
11359
11359
  "kind": "class",
11360
11360
  "locationInModule": {
11361
11361
  "filename": "lib/iceberg/iceberg-table.ts",
11362
- "line": 256
11362
+ "line": 261
11363
11363
  },
11364
11364
  "methods": [
11365
11365
  {
@@ -11369,7 +11369,7 @@
11369
11369
  },
11370
11370
  "locationInModule": {
11371
11371
  "filename": "lib/iceberg/iceberg-table.ts",
11372
- "line": 357
11372
+ "line": 363
11373
11373
  },
11374
11374
  "name": "creationOrderFieldIds",
11375
11375
  "parameters": [
@@ -11408,7 +11408,7 @@
11408
11408
  },
11409
11409
  "locationInModule": {
11410
11410
  "filename": "lib/iceberg/iceberg-table.ts",
11411
- "line": 367
11411
+ "line": 373
11412
11412
  },
11413
11413
  "name": "fromIcebergTableAttributes",
11414
11414
  "parameters": [
@@ -11445,7 +11445,7 @@
11445
11445
  },
11446
11446
  "locationInModule": {
11447
11447
  "filename": "lib/iceberg/iceberg-table.ts",
11448
- "line": 446
11448
+ "line": 463
11449
11449
  },
11450
11450
  "name": "grantRead",
11451
11451
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11470,7 +11470,7 @@
11470
11470
  },
11471
11471
  "locationInModule": {
11472
11472
  "filename": "lib/iceberg/iceberg-table.ts",
11473
- "line": 474
11473
+ "line": 491
11474
11474
  },
11475
11475
  "name": "grantReadWrite",
11476
11476
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11495,7 +11495,7 @@
11495
11495
  },
11496
11496
  "locationInModule": {
11497
11497
  "filename": "lib/iceberg/iceberg-table.ts",
11498
- "line": 460
11498
+ "line": 477
11499
11499
  },
11500
11500
  "name": "grantWrite",
11501
11501
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11524,7 +11524,7 @@
11524
11524
  "immutable": true,
11525
11525
  "locationInModule": {
11526
11526
  "filename": "lib/iceberg/iceberg-table.ts",
11527
- "line": 264
11527
+ "line": 269
11528
11528
  },
11529
11529
  "name": "database",
11530
11530
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11540,7 +11540,7 @@
11540
11540
  "immutable": true,
11541
11541
  "locationInModule": {
11542
11542
  "filename": "lib/iceberg/iceberg-table.ts",
11543
- "line": 270
11543
+ "line": 275
11544
11544
  },
11545
11545
  "name": "dataFormat",
11546
11546
  "type": {
@@ -11555,7 +11555,7 @@
11555
11555
  "immutable": true,
11556
11556
  "locationInModule": {
11557
11557
  "filename": "lib/iceberg/iceberg-table.ts",
11558
- "line": 273
11558
+ "line": 278
11559
11559
  },
11560
11560
  "name": "formatVersion",
11561
11561
  "type": {
@@ -11570,7 +11570,7 @@
11570
11570
  "immutable": true,
11571
11571
  "locationInModule": {
11572
11572
  "filename": "lib/iceberg/iceberg-table.ts",
11573
- "line": 267
11573
+ "line": 272
11574
11574
  },
11575
11575
  "name": "location",
11576
11576
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11586,7 +11586,7 @@
11586
11586
  "immutable": true,
11587
11587
  "locationInModule": {
11588
11588
  "filename": "lib/iceberg/iceberg-table.ts",
11589
- "line": 276
11589
+ "line": 281
11590
11590
  },
11591
11591
  "name": "resource",
11592
11592
  "type": {
@@ -11601,7 +11601,7 @@
11601
11601
  "immutable": true,
11602
11602
  "locationInModule": {
11603
11603
  "filename": "lib/iceberg/iceberg-table.ts",
11604
- "line": 258
11604
+ "line": 263
11605
11605
  },
11606
11606
  "name": "tableArn",
11607
11607
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11617,7 +11617,7 @@
11617
11617
  "immutable": true,
11618
11618
  "locationInModule": {
11619
11619
  "filename": "lib/iceberg/iceberg-table.ts",
11620
- "line": 261
11620
+ "line": 266
11621
11621
  },
11622
11622
  "name": "tableName",
11623
11623
  "overrides": "cdk-glue-iceberg-table.IIcebergTable",
@@ -11639,7 +11639,7 @@
11639
11639
  "kind": "interface",
11640
11640
  "locationInModule": {
11641
11641
  "filename": "lib/iceberg/iceberg-table.ts",
11642
- "line": 498
11642
+ "line": 515
11643
11643
  },
11644
11644
  "name": "IcebergTableAttributes",
11645
11645
  "properties": [
@@ -11652,7 +11652,7 @@
11652
11652
  "immutable": true,
11653
11653
  "locationInModule": {
11654
11654
  "filename": "lib/iceberg/iceberg-table.ts",
11655
- "line": 500
11655
+ "line": 517
11656
11656
  },
11657
11657
  "name": "database",
11658
11658
  "type": {
@@ -11668,7 +11668,7 @@
11668
11668
  "immutable": true,
11669
11669
  "locationInModule": {
11670
11670
  "filename": "lib/iceberg/iceberg-table.ts",
11671
- "line": 506
11671
+ "line": 523
11672
11672
  },
11673
11673
  "name": "location",
11674
11674
  "type": {
@@ -11684,7 +11684,7 @@
11684
11684
  "immutable": true,
11685
11685
  "locationInModule": {
11686
11686
  "filename": "lib/iceberg/iceberg-table.ts",
11687
- "line": 503
11687
+ "line": 520
11688
11688
  },
11689
11689
  "name": "tableName",
11690
11690
  "type": {
@@ -11705,7 +11705,7 @@
11705
11705
  "kind": "interface",
11706
11706
  "locationInModule": {
11707
11707
  "filename": "lib/iceberg/iceberg-table.ts",
11708
- "line": 154
11708
+ "line": 159
11709
11709
  },
11710
11710
  "name": "IcebergTableProps",
11711
11711
  "properties": [
@@ -11719,7 +11719,7 @@
11719
11719
  "immutable": true,
11720
11720
  "locationInModule": {
11721
11721
  "filename": "lib/iceberg/iceberg-table.ts",
11722
- "line": 162
11722
+ "line": 167
11723
11723
  },
11724
11724
  "name": "columns",
11725
11725
  "type": {
@@ -11740,7 +11740,7 @@
11740
11740
  "immutable": true,
11741
11741
  "locationInModule": {
11742
11742
  "filename": "lib/iceberg/iceberg-table.ts",
11743
- "line": 156
11743
+ "line": 161
11744
11744
  },
11745
11745
  "name": "database",
11746
11746
  "type": {
@@ -11757,7 +11757,7 @@
11757
11757
  "immutable": true,
11758
11758
  "locationInModule": {
11759
11759
  "filename": "lib/iceberg/iceberg-table.ts",
11760
- "line": 188
11760
+ "line": 193
11761
11761
  },
11762
11762
  "name": "formatVersion",
11763
11763
  "type": {
@@ -11774,7 +11774,7 @@
11774
11774
  "immutable": true,
11775
11775
  "locationInModule": {
11776
11776
  "filename": "lib/iceberg/iceberg-table.ts",
11777
- "line": 165
11777
+ "line": 170
11778
11778
  },
11779
11779
  "name": "location",
11780
11780
  "type": {
@@ -11790,7 +11790,7 @@
11790
11790
  "immutable": true,
11791
11791
  "locationInModule": {
11792
11792
  "filename": "lib/iceberg/iceberg-table.ts",
11793
- "line": 159
11793
+ "line": 164
11794
11794
  },
11795
11795
  "name": "tableName",
11796
11796
  "type": {
@@ -11807,7 +11807,7 @@
11807
11807
  "immutable": true,
11808
11808
  "locationInModule": {
11809
11809
  "filename": "lib/iceberg/iceberg-table.ts",
11810
- "line": 208
11810
+ "line": 213
11811
11811
  },
11812
11812
  "name": "comment",
11813
11813
  "optional": true,
@@ -11825,7 +11825,7 @@
11825
11825
  "immutable": true,
11826
11826
  "locationInModule": {
11827
11827
  "filename": "lib/iceberg/iceberg-table.ts",
11828
- "line": 185
11828
+ "line": 190
11829
11829
  },
11830
11830
  "name": "dataFormat",
11831
11831
  "optional": true,
@@ -11843,7 +11843,7 @@
11843
11843
  "immutable": true,
11844
11844
  "locationInModule": {
11845
11845
  "filename": "lib/iceberg/iceberg-table.ts",
11846
- "line": 182
11846
+ "line": 187
11847
11847
  },
11848
11848
  "name": "identifierFieldNames",
11849
11849
  "optional": true,
@@ -11866,7 +11866,7 @@
11866
11866
  "immutable": true,
11867
11867
  "locationInModule": {
11868
11868
  "filename": "lib/iceberg/iceberg-table.ts",
11869
- "line": 168
11869
+ "line": 173
11870
11870
  },
11871
11871
  "name": "partitionSpec",
11872
11872
  "optional": true,
@@ -11889,7 +11889,7 @@
11889
11889
  "immutable": true,
11890
11890
  "locationInModule": {
11891
11891
  "filename": "lib/iceberg/iceberg-table.ts",
11892
- "line": 215
11892
+ "line": 220
11893
11893
  },
11894
11894
  "name": "removalPolicy",
11895
11895
  "optional": true,
@@ -11907,7 +11907,7 @@
11907
11907
  "immutable": true,
11908
11908
  "locationInModule": {
11909
11909
  "filename": "lib/iceberg/iceberg-table.ts",
11910
- "line": 171
11910
+ "line": 176
11911
11911
  },
11912
11912
  "name": "sortOrder",
11913
11913
  "optional": true,
@@ -11930,7 +11930,7 @@
11930
11930
  "immutable": true,
11931
11931
  "locationInModule": {
11932
11932
  "filename": "lib/iceberg/iceberg-table.ts",
11933
- "line": 197
11933
+ "line": 202
11934
11934
  },
11935
11935
  "name": "tableProperties",
11936
11936
  "optional": true,
@@ -11960,11 +11960,11 @@
11960
11960
  },
11961
11961
  "locationInModule": {
11962
11962
  "filename": "lib/iceberg/iceberg-type.ts",
11963
- "line": 373
11963
+ "line": 377
11964
11964
  },
11965
11965
  "parameters": [
11966
11966
  {
11967
- "name": "options",
11967
+ "name": "input",
11968
11968
  "type": {
11969
11969
  "fqn": "cdk-glue-iceberg-table.IcebergTypeOptions"
11970
11970
  }
@@ -11974,7 +11974,7 @@
11974
11974
  "kind": "class",
11975
11975
  "locationInModule": {
11976
11976
  "filename": "lib/iceberg/iceberg-type.ts",
11977
- "line": 158
11977
+ "line": 162
11978
11978
  },
11979
11979
  "methods": [
11980
11980
  {
@@ -11984,7 +11984,7 @@
11984
11984
  },
11985
11985
  "locationInModule": {
11986
11986
  "filename": "lib/iceberg/iceberg-type.ts",
11987
- "line": 246
11987
+ "line": 250
11988
11988
  },
11989
11989
  "name": "decimal",
11990
11990
  "parameters": [
@@ -12021,7 +12021,7 @@
12021
12021
  },
12022
12022
  "locationInModule": {
12023
12023
  "filename": "lib/iceberg/iceberg-type.ts",
12024
- "line": 258
12024
+ "line": 262
12025
12025
  },
12026
12026
  "name": "fixed",
12027
12027
  "parameters": [
@@ -12050,7 +12050,7 @@
12050
12050
  },
12051
12051
  "locationInModule": {
12052
12052
  "filename": "lib/iceberg/iceberg-type.ts",
12053
- "line": 320
12053
+ "line": 324
12054
12054
  },
12055
12055
  "name": "geography",
12056
12056
  "parameters": [
@@ -12092,7 +12092,7 @@
12092
12092
  },
12093
12093
  "locationInModule": {
12094
12094
  "filename": "lib/iceberg/iceberg-type.ts",
12095
- "line": 308
12095
+ "line": 312
12096
12096
  },
12097
12097
  "name": "geometry",
12098
12098
  "parameters": [
@@ -12122,7 +12122,7 @@
12122
12122
  },
12123
12123
  "locationInModule": {
12124
12124
  "filename": "lib/iceberg/iceberg-type.ts",
12125
- "line": 269
12125
+ "line": 273
12126
12126
  },
12127
12127
  "name": "list",
12128
12128
  "parameters": [
@@ -12150,7 +12150,7 @@
12150
12150
  },
12151
12151
  "locationInModule": {
12152
12152
  "filename": "lib/iceberg/iceberg-type.ts",
12153
- "line": 282
12153
+ "line": 286
12154
12154
  },
12155
12155
  "name": "map",
12156
12156
  "parameters": [
@@ -12178,7 +12178,7 @@
12178
12178
  },
12179
12179
  "locationInModule": {
12180
12180
  "filename": "lib/iceberg/iceberg-type.ts",
12181
- "line": 297
12181
+ "line": 301
12182
12182
  },
12183
12183
  "name": "struct",
12184
12184
  "parameters": [
@@ -12211,7 +12211,7 @@
12211
12211
  },
12212
12212
  "locationInModule": {
12213
12213
  "filename": "lib/iceberg/iceberg-type.ts",
12214
- "line": 575
12214
+ "line": 578
12215
12215
  },
12216
12216
  "name": "isDecimal",
12217
12217
  "returns": {
@@ -12227,7 +12227,7 @@
12227
12227
  },
12228
12228
  "locationInModule": {
12229
12229
  "filename": "lib/iceberg/iceberg-type.ts",
12230
- "line": 580
12230
+ "line": 583
12231
12231
  },
12232
12232
  "name": "isFixed",
12233
12233
  "returns": {
@@ -12243,7 +12243,7 @@
12243
12243
  },
12244
12244
  "locationInModule": {
12245
12245
  "filename": "lib/iceberg/iceberg-type.ts",
12246
- "line": 570
12246
+ "line": 573
12247
12247
  },
12248
12248
  "name": "isPrimitive",
12249
12249
  "parameters": [
@@ -12272,7 +12272,7 @@
12272
12272
  "immutable": true,
12273
12273
  "locationInModule": {
12274
12274
  "filename": "lib/iceberg/iceberg-type.ts",
12275
- "line": 217
12275
+ "line": 221
12276
12276
  },
12277
12277
  "name": "BINARY",
12278
12278
  "static": true,
@@ -12289,7 +12289,7 @@
12289
12289
  "immutable": true,
12290
12290
  "locationInModule": {
12291
12291
  "filename": "lib/iceberg/iceberg-type.ts",
12292
- "line": 162
12292
+ "line": 166
12293
12293
  },
12294
12294
  "name": "BOOLEAN",
12295
12295
  "static": true,
@@ -12306,7 +12306,7 @@
12306
12306
  "immutable": true,
12307
12307
  "locationInModule": {
12308
12308
  "filename": "lib/iceberg/iceberg-type.ts",
12309
- "line": 187
12309
+ "line": 191
12310
12310
  },
12311
12311
  "name": "DATE",
12312
12312
  "static": true,
@@ -12323,7 +12323,7 @@
12323
12323
  "immutable": true,
12324
12324
  "locationInModule": {
12325
12325
  "filename": "lib/iceberg/iceberg-type.ts",
12326
- "line": 182
12326
+ "line": 186
12327
12327
  },
12328
12328
  "name": "DOUBLE",
12329
12329
  "static": true,
@@ -12340,7 +12340,7 @@
12340
12340
  "immutable": true,
12341
12341
  "locationInModule": {
12342
12342
  "filename": "lib/iceberg/iceberg-type.ts",
12343
- "line": 177
12343
+ "line": 181
12344
12344
  },
12345
12345
  "name": "FLOAT",
12346
12346
  "static": true,
@@ -12357,7 +12357,7 @@
12357
12357
  "immutable": true,
12358
12358
  "locationInModule": {
12359
12359
  "filename": "lib/iceberg/iceberg-type.ts",
12360
- "line": 167
12360
+ "line": 171
12361
12361
  },
12362
12362
  "name": "INT",
12363
12363
  "static": true,
@@ -12374,7 +12374,7 @@
12374
12374
  "immutable": true,
12375
12375
  "locationInModule": {
12376
12376
  "filename": "lib/iceberg/iceberg-type.ts",
12377
- "line": 172
12377
+ "line": 176
12378
12378
  },
12379
12379
  "name": "LONG",
12380
12380
  "static": true,
@@ -12391,7 +12391,7 @@
12391
12391
  "immutable": true,
12392
12392
  "locationInModule": {
12393
12393
  "filename": "lib/iceberg/iceberg-type.ts",
12394
- "line": 207
12394
+ "line": 211
12395
12395
  },
12396
12396
  "name": "STRING",
12397
12397
  "static": true,
@@ -12408,7 +12408,7 @@
12408
12408
  "immutable": true,
12409
12409
  "locationInModule": {
12410
12410
  "filename": "lib/iceberg/iceberg-type.ts",
12411
- "line": 192
12411
+ "line": 196
12412
12412
  },
12413
12413
  "name": "TIME",
12414
12414
  "static": true,
@@ -12425,7 +12425,7 @@
12425
12425
  "immutable": true,
12426
12426
  "locationInModule": {
12427
12427
  "filename": "lib/iceberg/iceberg-type.ts",
12428
- "line": 197
12428
+ "line": 201
12429
12429
  },
12430
12430
  "name": "TIMESTAMP",
12431
12431
  "static": true,
@@ -12443,7 +12443,7 @@
12443
12443
  "immutable": true,
12444
12444
  "locationInModule": {
12445
12445
  "filename": "lib/iceberg/iceberg-type.ts",
12446
- "line": 227
12446
+ "line": 231
12447
12447
  },
12448
12448
  "name": "TIMESTAMP_NS",
12449
12449
  "static": true,
@@ -12460,7 +12460,7 @@
12460
12460
  "immutable": true,
12461
12461
  "locationInModule": {
12462
12462
  "filename": "lib/iceberg/iceberg-type.ts",
12463
- "line": 202
12463
+ "line": 206
12464
12464
  },
12465
12465
  "name": "TIMESTAMPTZ",
12466
12466
  "static": true,
@@ -12478,7 +12478,7 @@
12478
12478
  "immutable": true,
12479
12479
  "locationInModule": {
12480
12480
  "filename": "lib/iceberg/iceberg-type.ts",
12481
- "line": 232
12481
+ "line": 236
12482
12482
  },
12483
12483
  "name": "TIMESTAMPTZ_NS",
12484
12484
  "static": true,
@@ -12496,7 +12496,7 @@
12496
12496
  "immutable": true,
12497
12497
  "locationInModule": {
12498
12498
  "filename": "lib/iceberg/iceberg-type.ts",
12499
- "line": 222
12499
+ "line": 226
12500
12500
  },
12501
12501
  "name": "UNKNOWN",
12502
12502
  "static": true,
@@ -12513,7 +12513,7 @@
12513
12513
  "immutable": true,
12514
12514
  "locationInModule": {
12515
12515
  "filename": "lib/iceberg/iceberg-type.ts",
12516
- "line": 212
12516
+ "line": 216
12517
12517
  },
12518
12518
  "name": "UUID",
12519
12519
  "static": true,
@@ -12531,7 +12531,7 @@
12531
12531
  "immutable": true,
12532
12532
  "locationInModule": {
12533
12533
  "filename": "lib/iceberg/iceberg-type.ts",
12534
- "line": 237
12534
+ "line": 241
12535
12535
  },
12536
12536
  "name": "VARIANT",
12537
12537
  "static": true,
@@ -12547,7 +12547,7 @@
12547
12547
  "immutable": true,
12548
12548
  "locationInModule": {
12549
12549
  "filename": "lib/iceberg/iceberg-type.ts",
12550
- "line": 329
12550
+ "line": 333
12551
12551
  },
12552
12552
  "name": "kind",
12553
12553
  "type": {
@@ -12562,7 +12562,7 @@
12562
12562
  "immutable": true,
12563
12563
  "locationInModule": {
12564
12564
  "filename": "lib/iceberg/iceberg-type.ts",
12565
- "line": 332
12565
+ "line": 336
12566
12566
  },
12567
12567
  "name": "decimalPrecision",
12568
12568
  "optional": true,
@@ -12578,7 +12578,7 @@
12578
12578
  "immutable": true,
12579
12579
  "locationInModule": {
12580
12580
  "filename": "lib/iceberg/iceberg-type.ts",
12581
- "line": 335
12581
+ "line": 339
12582
12582
  },
12583
12583
  "name": "decimalScale",
12584
12584
  "optional": true,
@@ -12594,7 +12594,7 @@
12594
12594
  "immutable": true,
12595
12595
  "locationInModule": {
12596
12596
  "filename": "lib/iceberg/iceberg-type.ts",
12597
- "line": 338
12597
+ "line": 342
12598
12598
  },
12599
12599
  "name": "fixedLength",
12600
12600
  "optional": true,
@@ -12610,7 +12610,7 @@
12610
12610
  "immutable": true,
12611
12611
  "locationInModule": {
12612
12612
  "filename": "lib/iceberg/iceberg-type.ts",
12613
- "line": 368
12613
+ "line": 372
12614
12614
  },
12615
12615
  "name": "geoCrs",
12616
12616
  "optional": true,
@@ -12626,7 +12626,7 @@
12626
12626
  "immutable": true,
12627
12627
  "locationInModule": {
12628
12628
  "filename": "lib/iceberg/iceberg-type.ts",
12629
- "line": 371
12629
+ "line": 375
12630
12630
  },
12631
12631
  "name": "geographyAlgorithm",
12632
12632
  "optional": true,
@@ -12642,7 +12642,7 @@
12642
12642
  "immutable": true,
12643
12643
  "locationInModule": {
12644
12644
  "filename": "lib/iceberg/iceberg-type.ts",
12645
- "line": 341
12645
+ "line": 345
12646
12646
  },
12647
12647
  "name": "listElement",
12648
12648
  "optional": true,
@@ -12658,7 +12658,7 @@
12658
12658
  "immutable": true,
12659
12659
  "locationInModule": {
12660
12660
  "filename": "lib/iceberg/iceberg-type.ts",
12661
- "line": 344
12661
+ "line": 348
12662
12662
  },
12663
12663
  "name": "listElementId",
12664
12664
  "optional": true,
@@ -12674,7 +12674,7 @@
12674
12674
  "immutable": true,
12675
12675
  "locationInModule": {
12676
12676
  "filename": "lib/iceberg/iceberg-type.ts",
12677
- "line": 347
12677
+ "line": 351
12678
12678
  },
12679
12679
  "name": "listElementRequired",
12680
12680
  "optional": true,
@@ -12690,7 +12690,7 @@
12690
12690
  "immutable": true,
12691
12691
  "locationInModule": {
12692
12692
  "filename": "lib/iceberg/iceberg-type.ts",
12693
- "line": 350
12693
+ "line": 354
12694
12694
  },
12695
12695
  "name": "mapKey",
12696
12696
  "optional": true,
@@ -12706,7 +12706,7 @@
12706
12706
  "immutable": true,
12707
12707
  "locationInModule": {
12708
12708
  "filename": "lib/iceberg/iceberg-type.ts",
12709
- "line": 353
12709
+ "line": 357
12710
12710
  },
12711
12711
  "name": "mapKeyId",
12712
12712
  "optional": true,
@@ -12722,7 +12722,7 @@
12722
12722
  "immutable": true,
12723
12723
  "locationInModule": {
12724
12724
  "filename": "lib/iceberg/iceberg-type.ts",
12725
- "line": 356
12725
+ "line": 360
12726
12726
  },
12727
12727
  "name": "mapValue",
12728
12728
  "optional": true,
@@ -12738,7 +12738,7 @@
12738
12738
  "immutable": true,
12739
12739
  "locationInModule": {
12740
12740
  "filename": "lib/iceberg/iceberg-type.ts",
12741
- "line": 359
12741
+ "line": 363
12742
12742
  },
12743
12743
  "name": "mapValueId",
12744
12744
  "optional": true,
@@ -12754,7 +12754,7 @@
12754
12754
  "immutable": true,
12755
12755
  "locationInModule": {
12756
12756
  "filename": "lib/iceberg/iceberg-type.ts",
12757
- "line": 362
12757
+ "line": 366
12758
12758
  },
12759
12759
  "name": "mapValueRequired",
12760
12760
  "optional": true,
@@ -12770,7 +12770,7 @@
12770
12770
  "immutable": true,
12771
12771
  "locationInModule": {
12772
12772
  "filename": "lib/iceberg/iceberg-type.ts",
12773
- "line": 365
12773
+ "line": 369
12774
12774
  },
12775
12775
  "name": "structFields",
12776
12776
  "optional": true,
@@ -12796,7 +12796,7 @@
12796
12796
  "kind": "enum",
12797
12797
  "locationInModule": {
12798
12798
  "filename": "lib/iceberg/iceberg-type.ts",
12799
- "line": 13
12799
+ "line": 17
12800
12800
  },
12801
12801
  "members": [
12802
12802
  {
@@ -12953,7 +12953,7 @@
12953
12953
  "kind": "interface",
12954
12954
  "locationInModule": {
12955
12955
  "filename": "lib/iceberg/iceberg-type.ts",
12956
- "line": 107
12956
+ "line": 111
12957
12957
  },
12958
12958
  "name": "IcebergTypeOptions",
12959
12959
  "properties": [
@@ -12966,7 +12966,7 @@
12966
12966
  "immutable": true,
12967
12967
  "locationInModule": {
12968
12968
  "filename": "lib/iceberg/iceberg-type.ts",
12969
- "line": 109
12969
+ "line": 113
12970
12970
  },
12971
12971
  "name": "kind",
12972
12972
  "type": {
@@ -12982,7 +12982,7 @@
12982
12982
  "immutable": true,
12983
12983
  "locationInModule": {
12984
12984
  "filename": "lib/iceberg/iceberg-type.ts",
12985
- "line": 112
12985
+ "line": 116
12986
12986
  },
12987
12987
  "name": "decimalPrecision",
12988
12988
  "optional": true,
@@ -12999,7 +12999,7 @@
12999
12999
  "immutable": true,
13000
13000
  "locationInModule": {
13001
13001
  "filename": "lib/iceberg/iceberg-type.ts",
13002
- "line": 115
13002
+ "line": 119
13003
13003
  },
13004
13004
  "name": "decimalScale",
13005
13005
  "optional": true,
@@ -13017,7 +13017,7 @@
13017
13017
  "immutable": true,
13018
13018
  "locationInModule": {
13019
13019
  "filename": "lib/iceberg/iceberg-type.ts",
13020
- "line": 118
13020
+ "line": 122
13021
13021
  },
13022
13022
  "name": "fixedLength",
13023
13023
  "optional": true,
@@ -13035,7 +13035,7 @@
13035
13035
  "immutable": true,
13036
13036
  "locationInModule": {
13037
13037
  "filename": "lib/iceberg/iceberg-type.ts",
13038
- "line": 148
13038
+ "line": 152
13039
13039
  },
13040
13040
  "name": "geoCrs",
13041
13041
  "optional": true,
@@ -13053,7 +13053,7 @@
13053
13053
  "immutable": true,
13054
13054
  "locationInModule": {
13055
13055
  "filename": "lib/iceberg/iceberg-type.ts",
13056
- "line": 151
13056
+ "line": 155
13057
13057
  },
13058
13058
  "name": "geographyAlgorithm",
13059
13059
  "optional": true,
@@ -13071,7 +13071,7 @@
13071
13071
  "immutable": true,
13072
13072
  "locationInModule": {
13073
13073
  "filename": "lib/iceberg/iceberg-type.ts",
13074
- "line": 121
13074
+ "line": 125
13075
13075
  },
13076
13076
  "name": "listElement",
13077
13077
  "optional": true,
@@ -13089,7 +13089,7 @@
13089
13089
  "immutable": true,
13090
13090
  "locationInModule": {
13091
13091
  "filename": "lib/iceberg/iceberg-type.ts",
13092
- "line": 124
13092
+ "line": 128
13093
13093
  },
13094
13094
  "name": "listElementId",
13095
13095
  "optional": true,
@@ -13107,7 +13107,7 @@
13107
13107
  "immutable": true,
13108
13108
  "locationInModule": {
13109
13109
  "filename": "lib/iceberg/iceberg-type.ts",
13110
- "line": 127
13110
+ "line": 131
13111
13111
  },
13112
13112
  "name": "listElementRequired",
13113
13113
  "optional": true,
@@ -13125,7 +13125,7 @@
13125
13125
  "immutable": true,
13126
13126
  "locationInModule": {
13127
13127
  "filename": "lib/iceberg/iceberg-type.ts",
13128
- "line": 130
13128
+ "line": 134
13129
13129
  },
13130
13130
  "name": "mapKey",
13131
13131
  "optional": true,
@@ -13143,7 +13143,7 @@
13143
13143
  "immutable": true,
13144
13144
  "locationInModule": {
13145
13145
  "filename": "lib/iceberg/iceberg-type.ts",
13146
- "line": 133
13146
+ "line": 137
13147
13147
  },
13148
13148
  "name": "mapKeyId",
13149
13149
  "optional": true,
@@ -13161,7 +13161,7 @@
13161
13161
  "immutable": true,
13162
13162
  "locationInModule": {
13163
13163
  "filename": "lib/iceberg/iceberg-type.ts",
13164
- "line": 136
13164
+ "line": 140
13165
13165
  },
13166
13166
  "name": "mapValue",
13167
13167
  "optional": true,
@@ -13179,7 +13179,7 @@
13179
13179
  "immutable": true,
13180
13180
  "locationInModule": {
13181
13181
  "filename": "lib/iceberg/iceberg-type.ts",
13182
- "line": 139
13182
+ "line": 143
13183
13183
  },
13184
13184
  "name": "mapValueId",
13185
13185
  "optional": true,
@@ -13197,7 +13197,7 @@
13197
13197
  "immutable": true,
13198
13198
  "locationInModule": {
13199
13199
  "filename": "lib/iceberg/iceberg-type.ts",
13200
- "line": 142
13200
+ "line": 146
13201
13201
  },
13202
13202
  "name": "mapValueRequired",
13203
13203
  "optional": true,
@@ -13215,7 +13215,7 @@
13215
13215
  "immutable": true,
13216
13216
  "locationInModule": {
13217
13217
  "filename": "lib/iceberg/iceberg-type.ts",
13218
- "line": 145
13218
+ "line": 149
13219
13219
  },
13220
13220
  "name": "structFields",
13221
13221
  "optional": true,
@@ -13232,6 +13232,6 @@
13232
13232
  "symbolId": "lib/iceberg/iceberg-type:IcebergTypeOptions"
13233
13233
  }
13234
13234
  },
13235
- "version": "0.14.2",
13236
- "fingerprint": "yCSxQRguzRD5Hw10xiiqWBqmEBURiuGuQT42i1T4A5I="
13235
+ "version": "0.15.0",
13236
+ "fingerprint": "bK17qZu1+Z7rPaKm565Y+w3ftBOTL5FW/6bMuua7eY8="
13237
13237
  }