cdk-glue-iceberg-table 0.11.0 → 0.12.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 +410 -155
- package/README.md +51 -8
- package/dist/lib/iceberg/iceberg-partition-transform.js +1 -1
- package/dist/lib/iceberg/iceberg-table-properties.js +1 -1
- package/dist/lib/iceberg/iceberg-table-render.js +30 -41
- package/dist/lib/iceberg/iceberg-table.d.ts +3 -9
- package/dist/lib/iceberg/iceberg-table.js +2 -2
- package/dist/lib/iceberg/iceberg-type.d.ts +59 -38
- package/dist/lib/iceberg/iceberg-type.js +60 -40
- package/dist/lib/iceberg/index.d.ts +1 -1
- package/dist/lib/iceberg/index.js +1 -1
- package/package.json +1 -1
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[](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[](https://codecov.io/gh/ksco92/arceus)\n[](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](https://pypi.org/project/cdk-glue-iceberg-table/)\n[](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](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 by an end-to-end\nconsumer test on every PR plus real-AWS integration suites, including\nones for 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 so schema evolution never orphans existing data. It was the basis\nof 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` and the `fromIcebergTableAttributes(...)` import factory.\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. 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 is what lets you add, rename, and drop columns across deploys\nwithout corrupting 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 struct/list/map field ids are assigned automatically\nabove the highest top-level id — only top-level column ids are\ncaller-provided.)\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(IcebergType.STRING),\n id: 6,\n },\n {\n name: 'shipping_address',\n type: IcebergType.struct([\n {\n name: 'line1',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'city',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'country',\n type: IcebergType.STRING,\n required: true,\n },\n {\n name: 'postal_code',\n type: IcebergType.STRING,\n },\n ]),\n id: 7,\n },\n {\n name: 'metadata',\n type: IcebergType.map(IcebergType.STRING, IcebergType.STRING, false),\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). The construct\nprefixes each identifier column's `doc` with `(PK) `, so a `doc` you\nwrite must not start 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\": true } },\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.\" |\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 and\nnever reused. Adds, renames (same `id`, new `name`), and drops all\nflow through `cdk deploy` alone — no out-of-band SQL DDL.\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- **Field-id reuse is not detected across deploys.** 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 column id N` validator), but it doesn't compare against the live table state. The safe workflow is to always pin `id` explicitly and treat dropped ids as retired forever; never let CDK reassign an id that has ever been used.\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 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, and `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)). On v2, Athena reads and writes,\nincluding merge-on-read `INSERT` / `UPDATE` / `DELETE` / `MERGE`, time\ntravel, `OPTIMIZE`, and `VACUUM`. The demo app in the\n[`arceus`](https://github.com/ksco92/arceus) repo registers its tables\nwith Lake Formation and exercises the same operations through Spark in\nits integration suite. The construct's `grant*` helpers issue IAM\ngrants; under Lake Formation you still add the matching `SELECT` /\n`INSERT` 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[](https://github.com/ksco92/arceus/actions/workflows/ci.yml)\n[](https://codecov.io/gh/ksco92/arceus)\n[](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](https://pypi.org/project/cdk-glue-iceberg-table/)\n[](https://constructs.dev/packages/cdk-glue-iceberg-table)\n[](https://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](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 by an end-to-end\nconsumer test on every PR plus real-AWS integration suites, including\nones for 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 so schema evolution never orphans existing data. It was the basis\nof 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` and the `fromIcebergTableAttributes(...)` import factory.\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 is what lets you add, rename, and drop columns across deploys\nwithout corrupting 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 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). The construct\nprefixes each identifier column's `doc` with `(PK) `, so a `doc` you\nwrite must not start 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.\" |\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 and\nnever reused. Adds, renames (same `id`, new `name`), and drops all\nflow through `cdk deploy` alone — no out-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\nUpgrading from a version before 0.12.0, which numbered nested fields\nitself: pin each nested field to the id the deployed table already\nhas, or the first deploy renumbers it and existing data files read\nunder the wrong field. Read the ids from the `element-id`, `key-id`,\n`value-id`, and struct field `id` values in the previous version's\nsynthesized template (`cdk.out/<Stack>.template.json`) or in the\ntable's current `metadata.json`. A nested type object shared by two\ncolumns now fails synth with a duplicate id; give each column its own\nnested type with its own ids. The list element and map value\nnullability 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- **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 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, and `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)). On v2, Athena reads and writes,\nincluding merge-on-read `INSERT` / `UPDATE` / `DELETE` / `MERGE`, time\ntravel, `OPTIMIZE`, and `VACUUM`. The demo app in the\n[`arceus`](https://github.com/ksco92/arceus) repo registers its tables\nwith Lake Formation and exercises the same operations through Spark in\nits integration suite. The construct's `grant*` helpers issue IAM\ngrants; under Lake Formation you still add the matching `SELECT` /\n`INSERT` 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":
|
|
9782
|
+
"line": 217
|
|
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":
|
|
9793
|
+
"line": 231
|
|
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":
|
|
9818
|
+
"line": 237
|
|
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":
|
|
9843
|
+
"line": 234
|
|
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":
|
|
9872
|
+
"line": 225
|
|
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":
|
|
9888
|
+
"line": 228
|
|
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":
|
|
9904
|
+
"line": 219
|
|
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":
|
|
9920
|
+
"line": 222
|
|
9921
9921
|
},
|
|
9922
9922
|
"name": "tableName",
|
|
9923
9923
|
"type": {
|
|
@@ -9945,14 +9945,14 @@
|
|
|
9945
9945
|
{
|
|
9946
9946
|
"abstract": true,
|
|
9947
9947
|
"docs": {
|
|
9948
|
-
"remarks": "
|
|
9948
|
+
"remarks": "Keep it for the life of the column and never\ngive a dropped column's id to another field.",
|
|
9949
9949
|
"stability": "experimental",
|
|
9950
|
-
"summary": "Iceberg field id for this column."
|
|
9950
|
+
"summary": "Iceberg field id for this column: unique across the table schema, from 1 to 2147483447."
|
|
9951
9951
|
},
|
|
9952
9952
|
"immutable": true,
|
|
9953
9953
|
"locationInModule": {
|
|
9954
9954
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
9955
|
-
"line":
|
|
9955
|
+
"line": 99
|
|
9956
9956
|
},
|
|
9957
9957
|
"name": "id",
|
|
9958
9958
|
"type": {
|
|
@@ -10078,7 +10078,7 @@
|
|
|
10078
10078
|
"kind": "enum",
|
|
10079
10079
|
"locationInModule": {
|
|
10080
10080
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10081
|
-
"line":
|
|
10081
|
+
"line": 40
|
|
10082
10082
|
},
|
|
10083
10083
|
"members": [
|
|
10084
10084
|
{
|
|
@@ -10154,6 +10154,175 @@
|
|
|
10154
10154
|
"name": "IcebergFormatVersion",
|
|
10155
10155
|
"symbolId": "lib/iceberg/iceberg-table-properties:IcebergFormatVersion"
|
|
10156
10156
|
},
|
|
10157
|
+
"cdk-glue-iceberg-table.IcebergListDefinition": {
|
|
10158
|
+
"assembly": "cdk-glue-iceberg-table",
|
|
10159
|
+
"datatype": true,
|
|
10160
|
+
"docs": {
|
|
10161
|
+
"stability": "experimental",
|
|
10162
|
+
"summary": "Definition of a list type."
|
|
10163
|
+
},
|
|
10164
|
+
"fqn": "cdk-glue-iceberg-table.IcebergListDefinition",
|
|
10165
|
+
"kind": "interface",
|
|
10166
|
+
"locationInModule": {
|
|
10167
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10168
|
+
"line": 70
|
|
10169
|
+
},
|
|
10170
|
+
"name": "IcebergListDefinition",
|
|
10171
|
+
"properties": [
|
|
10172
|
+
{
|
|
10173
|
+
"abstract": true,
|
|
10174
|
+
"docs": {
|
|
10175
|
+
"stability": "experimental",
|
|
10176
|
+
"summary": "Element type."
|
|
10177
|
+
},
|
|
10178
|
+
"immutable": true,
|
|
10179
|
+
"locationInModule": {
|
|
10180
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10181
|
+
"line": 72
|
|
10182
|
+
},
|
|
10183
|
+
"name": "element",
|
|
10184
|
+
"type": {
|
|
10185
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
10186
|
+
}
|
|
10187
|
+
},
|
|
10188
|
+
{
|
|
10189
|
+
"abstract": true,
|
|
10190
|
+
"docs": {
|
|
10191
|
+
"stability": "experimental",
|
|
10192
|
+
"summary": "Iceberg field id of the element: unique across the table schema, from 1 to 2147483447."
|
|
10193
|
+
},
|
|
10194
|
+
"immutable": true,
|
|
10195
|
+
"locationInModule": {
|
|
10196
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10197
|
+
"line": 75
|
|
10198
|
+
},
|
|
10199
|
+
"name": "elementId",
|
|
10200
|
+
"type": {
|
|
10201
|
+
"primitive": "number"
|
|
10202
|
+
}
|
|
10203
|
+
},
|
|
10204
|
+
{
|
|
10205
|
+
"abstract": true,
|
|
10206
|
+
"docs": {
|
|
10207
|
+
"remarks": "Defaults to `false`.",
|
|
10208
|
+
"stability": "experimental",
|
|
10209
|
+
"summary": "Whether elements are non-nullable."
|
|
10210
|
+
},
|
|
10211
|
+
"immutable": true,
|
|
10212
|
+
"locationInModule": {
|
|
10213
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10214
|
+
"line": 78
|
|
10215
|
+
},
|
|
10216
|
+
"name": "elementRequired",
|
|
10217
|
+
"optional": true,
|
|
10218
|
+
"type": {
|
|
10219
|
+
"primitive": "boolean"
|
|
10220
|
+
}
|
|
10221
|
+
}
|
|
10222
|
+
],
|
|
10223
|
+
"symbolId": "lib/iceberg/iceberg-type:IcebergListDefinition"
|
|
10224
|
+
},
|
|
10225
|
+
"cdk-glue-iceberg-table.IcebergMapDefinition": {
|
|
10226
|
+
"assembly": "cdk-glue-iceberg-table",
|
|
10227
|
+
"datatype": true,
|
|
10228
|
+
"docs": {
|
|
10229
|
+
"remarks": "Keys are always required per the Iceberg spec.",
|
|
10230
|
+
"stability": "experimental",
|
|
10231
|
+
"summary": "Definition of a map type."
|
|
10232
|
+
},
|
|
10233
|
+
"fqn": "cdk-glue-iceberg-table.IcebergMapDefinition",
|
|
10234
|
+
"kind": "interface",
|
|
10235
|
+
"locationInModule": {
|
|
10236
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10237
|
+
"line": 82
|
|
10238
|
+
},
|
|
10239
|
+
"name": "IcebergMapDefinition",
|
|
10240
|
+
"properties": [
|
|
10241
|
+
{
|
|
10242
|
+
"abstract": true,
|
|
10243
|
+
"docs": {
|
|
10244
|
+
"stability": "experimental",
|
|
10245
|
+
"summary": "Key type."
|
|
10246
|
+
},
|
|
10247
|
+
"immutable": true,
|
|
10248
|
+
"locationInModule": {
|
|
10249
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10250
|
+
"line": 84
|
|
10251
|
+
},
|
|
10252
|
+
"name": "key",
|
|
10253
|
+
"type": {
|
|
10254
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
10255
|
+
}
|
|
10256
|
+
},
|
|
10257
|
+
{
|
|
10258
|
+
"abstract": true,
|
|
10259
|
+
"docs": {
|
|
10260
|
+
"stability": "experimental",
|
|
10261
|
+
"summary": "Iceberg field id of the key: unique across the table schema, from 1 to 2147483447."
|
|
10262
|
+
},
|
|
10263
|
+
"immutable": true,
|
|
10264
|
+
"locationInModule": {
|
|
10265
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10266
|
+
"line": 87
|
|
10267
|
+
},
|
|
10268
|
+
"name": "keyId",
|
|
10269
|
+
"type": {
|
|
10270
|
+
"primitive": "number"
|
|
10271
|
+
}
|
|
10272
|
+
},
|
|
10273
|
+
{
|
|
10274
|
+
"abstract": true,
|
|
10275
|
+
"docs": {
|
|
10276
|
+
"stability": "experimental",
|
|
10277
|
+
"summary": "Value type."
|
|
10278
|
+
},
|
|
10279
|
+
"immutable": true,
|
|
10280
|
+
"locationInModule": {
|
|
10281
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10282
|
+
"line": 90
|
|
10283
|
+
},
|
|
10284
|
+
"name": "value",
|
|
10285
|
+
"type": {
|
|
10286
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
10287
|
+
}
|
|
10288
|
+
},
|
|
10289
|
+
{
|
|
10290
|
+
"abstract": true,
|
|
10291
|
+
"docs": {
|
|
10292
|
+
"stability": "experimental",
|
|
10293
|
+
"summary": "Iceberg field id of the value: unique across the table schema, from 1 to 2147483447."
|
|
10294
|
+
},
|
|
10295
|
+
"immutable": true,
|
|
10296
|
+
"locationInModule": {
|
|
10297
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10298
|
+
"line": 93
|
|
10299
|
+
},
|
|
10300
|
+
"name": "valueId",
|
|
10301
|
+
"type": {
|
|
10302
|
+
"primitive": "number"
|
|
10303
|
+
}
|
|
10304
|
+
},
|
|
10305
|
+
{
|
|
10306
|
+
"abstract": true,
|
|
10307
|
+
"docs": {
|
|
10308
|
+
"remarks": "Defaults to `false`.",
|
|
10309
|
+
"stability": "experimental",
|
|
10310
|
+
"summary": "Whether values are non-nullable."
|
|
10311
|
+
},
|
|
10312
|
+
"immutable": true,
|
|
10313
|
+
"locationInModule": {
|
|
10314
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10315
|
+
"line": 96
|
|
10316
|
+
},
|
|
10317
|
+
"name": "valueRequired",
|
|
10318
|
+
"optional": true,
|
|
10319
|
+
"type": {
|
|
10320
|
+
"primitive": "boolean"
|
|
10321
|
+
}
|
|
10322
|
+
}
|
|
10323
|
+
],
|
|
10324
|
+
"symbolId": "lib/iceberg/iceberg-type:IcebergMapDefinition"
|
|
10325
|
+
},
|
|
10157
10326
|
"cdk-glue-iceberg-table.IcebergNullOrder": {
|
|
10158
10327
|
"assembly": "cdk-glue-iceberg-table",
|
|
10159
10328
|
"docs": {
|
|
@@ -10196,7 +10365,7 @@
|
|
|
10196
10365
|
"kind": "interface",
|
|
10197
10366
|
"locationInModule": {
|
|
10198
10367
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10199
|
-
"line":
|
|
10368
|
+
"line": 103
|
|
10200
10369
|
},
|
|
10201
10370
|
"name": "IcebergPartitionField",
|
|
10202
10371
|
"properties": [
|
|
@@ -10210,7 +10379,7 @@
|
|
|
10210
10379
|
"immutable": true,
|
|
10211
10380
|
"locationInModule": {
|
|
10212
10381
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10213
|
-
"line":
|
|
10382
|
+
"line": 134
|
|
10214
10383
|
},
|
|
10215
10384
|
"name": "fieldId",
|
|
10216
10385
|
"type": {
|
|
@@ -10226,7 +10395,7 @@
|
|
|
10226
10395
|
"immutable": true,
|
|
10227
10396
|
"locationInModule": {
|
|
10228
10397
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10229
|
-
"line":
|
|
10398
|
+
"line": 105
|
|
10230
10399
|
},
|
|
10231
10400
|
"name": "sourceColumn",
|
|
10232
10401
|
"type": {
|
|
@@ -10242,7 +10411,7 @@
|
|
|
10242
10411
|
"immutable": true,
|
|
10243
10412
|
"locationInModule": {
|
|
10244
10413
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10245
|
-
"line":
|
|
10414
|
+
"line": 108
|
|
10246
10415
|
},
|
|
10247
10416
|
"name": "transform",
|
|
10248
10417
|
"type": {
|
|
@@ -10259,7 +10428,7 @@
|
|
|
10259
10428
|
"immutable": true,
|
|
10260
10429
|
"locationInModule": {
|
|
10261
10430
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10262
|
-
"line":
|
|
10431
|
+
"line": 115
|
|
10263
10432
|
},
|
|
10264
10433
|
"name": "name",
|
|
10265
10434
|
"optional": true,
|
|
@@ -10968,7 +11137,7 @@
|
|
|
10968
11137
|
"kind": "interface",
|
|
10969
11138
|
"locationInModule": {
|
|
10970
11139
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10971
|
-
"line":
|
|
11140
|
+
"line": 138
|
|
10972
11141
|
},
|
|
10973
11142
|
"name": "IcebergSortField",
|
|
10974
11143
|
"properties": [
|
|
@@ -10981,7 +11150,7 @@
|
|
|
10981
11150
|
"immutable": true,
|
|
10982
11151
|
"locationInModule": {
|
|
10983
11152
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
10984
|
-
"line":
|
|
11153
|
+
"line": 140
|
|
10985
11154
|
},
|
|
10986
11155
|
"name": "sourceColumn",
|
|
10987
11156
|
"type": {
|
|
@@ -10998,7 +11167,7 @@
|
|
|
10998
11167
|
"immutable": true,
|
|
10999
11168
|
"locationInModule": {
|
|
11000
11169
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11001
|
-
"line":
|
|
11170
|
+
"line": 146
|
|
11002
11171
|
},
|
|
11003
11172
|
"name": "direction",
|
|
11004
11173
|
"optional": true,
|
|
@@ -11016,7 +11185,7 @@
|
|
|
11016
11185
|
"immutable": true,
|
|
11017
11186
|
"locationInModule": {
|
|
11018
11187
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11019
|
-
"line":
|
|
11188
|
+
"line": 149
|
|
11020
11189
|
},
|
|
11021
11190
|
"name": "nullOrder",
|
|
11022
11191
|
"optional": true,
|
|
@@ -11034,7 +11203,7 @@
|
|
|
11034
11203
|
"immutable": true,
|
|
11035
11204
|
"locationInModule": {
|
|
11036
11205
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11037
|
-
"line":
|
|
11206
|
+
"line": 143
|
|
11038
11207
|
},
|
|
11039
11208
|
"name": "transform",
|
|
11040
11209
|
"optional": true,
|
|
@@ -11056,10 +11225,26 @@
|
|
|
11056
11225
|
"kind": "interface",
|
|
11057
11226
|
"locationInModule": {
|
|
11058
11227
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11059
|
-
"line":
|
|
11228
|
+
"line": 52
|
|
11060
11229
|
},
|
|
11061
11230
|
"name": "IcebergStructFieldDefinition",
|
|
11062
11231
|
"properties": [
|
|
11232
|
+
{
|
|
11233
|
+
"abstract": true,
|
|
11234
|
+
"docs": {
|
|
11235
|
+
"stability": "experimental",
|
|
11236
|
+
"summary": "Iceberg field id of the field: unique across the table schema, from 1 to 2147483447."
|
|
11237
|
+
},
|
|
11238
|
+
"immutable": true,
|
|
11239
|
+
"locationInModule": {
|
|
11240
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11241
|
+
"line": 54
|
|
11242
|
+
},
|
|
11243
|
+
"name": "id",
|
|
11244
|
+
"type": {
|
|
11245
|
+
"primitive": "number"
|
|
11246
|
+
}
|
|
11247
|
+
},
|
|
11063
11248
|
{
|
|
11064
11249
|
"abstract": true,
|
|
11065
11250
|
"docs": {
|
|
@@ -11069,7 +11254,7 @@
|
|
|
11069
11254
|
"immutable": true,
|
|
11070
11255
|
"locationInModule": {
|
|
11071
11256
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11072
|
-
"line":
|
|
11257
|
+
"line": 57
|
|
11073
11258
|
},
|
|
11074
11259
|
"name": "name",
|
|
11075
11260
|
"type": {
|
|
@@ -11085,7 +11270,7 @@
|
|
|
11085
11270
|
"immutable": true,
|
|
11086
11271
|
"locationInModule": {
|
|
11087
11272
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11088
|
-
"line":
|
|
11273
|
+
"line": 60
|
|
11089
11274
|
},
|
|
11090
11275
|
"name": "type",
|
|
11091
11276
|
"type": {
|
|
@@ -11101,7 +11286,7 @@
|
|
|
11101
11286
|
"immutable": true,
|
|
11102
11287
|
"locationInModule": {
|
|
11103
11288
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11104
|
-
"line":
|
|
11289
|
+
"line": 66
|
|
11105
11290
|
},
|
|
11106
11291
|
"name": "doc",
|
|
11107
11292
|
"optional": true,
|
|
@@ -11119,7 +11304,7 @@
|
|
|
11119
11304
|
"immutable": true,
|
|
11120
11305
|
"locationInModule": {
|
|
11121
11306
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11122
|
-
"line":
|
|
11307
|
+
"line": 63
|
|
11123
11308
|
},
|
|
11124
11309
|
"name": "required",
|
|
11125
11310
|
"optional": true,
|
|
@@ -11145,7 +11330,7 @@
|
|
|
11145
11330
|
},
|
|
11146
11331
|
"locationInModule": {
|
|
11147
11332
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11148
|
-
"line":
|
|
11333
|
+
"line": 280
|
|
11149
11334
|
},
|
|
11150
11335
|
"parameters": [
|
|
11151
11336
|
{
|
|
@@ -11174,7 +11359,7 @@
|
|
|
11174
11359
|
"kind": "class",
|
|
11175
11360
|
"locationInModule": {
|
|
11176
11361
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11177
|
-
"line":
|
|
11362
|
+
"line": 254
|
|
11178
11363
|
},
|
|
11179
11364
|
"methods": [
|
|
11180
11365
|
{
|
|
@@ -11185,7 +11370,7 @@
|
|
|
11185
11370
|
},
|
|
11186
11371
|
"locationInModule": {
|
|
11187
11372
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11188
|
-
"line":
|
|
11373
|
+
"line": 353
|
|
11189
11374
|
},
|
|
11190
11375
|
"name": "fromIcebergTableAttributes",
|
|
11191
11376
|
"parameters": [
|
|
@@ -11222,7 +11407,7 @@
|
|
|
11222
11407
|
},
|
|
11223
11408
|
"locationInModule": {
|
|
11224
11409
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11225
|
-
"line":
|
|
11410
|
+
"line": 432
|
|
11226
11411
|
},
|
|
11227
11412
|
"name": "grantRead",
|
|
11228
11413
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11247,7 +11432,7 @@
|
|
|
11247
11432
|
},
|
|
11248
11433
|
"locationInModule": {
|
|
11249
11434
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11250
|
-
"line":
|
|
11435
|
+
"line": 460
|
|
11251
11436
|
},
|
|
11252
11437
|
"name": "grantReadWrite",
|
|
11253
11438
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11272,7 +11457,7 @@
|
|
|
11272
11457
|
},
|
|
11273
11458
|
"locationInModule": {
|
|
11274
11459
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11275
|
-
"line":
|
|
11460
|
+
"line": 446
|
|
11276
11461
|
},
|
|
11277
11462
|
"name": "grantWrite",
|
|
11278
11463
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11301,7 +11486,7 @@
|
|
|
11301
11486
|
"immutable": true,
|
|
11302
11487
|
"locationInModule": {
|
|
11303
11488
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11304
|
-
"line":
|
|
11489
|
+
"line": 262
|
|
11305
11490
|
},
|
|
11306
11491
|
"name": "database",
|
|
11307
11492
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11317,7 +11502,7 @@
|
|
|
11317
11502
|
"immutable": true,
|
|
11318
11503
|
"locationInModule": {
|
|
11319
11504
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11320
|
-
"line":
|
|
11505
|
+
"line": 268
|
|
11321
11506
|
},
|
|
11322
11507
|
"name": "dataFormat",
|
|
11323
11508
|
"type": {
|
|
@@ -11332,7 +11517,7 @@
|
|
|
11332
11517
|
"immutable": true,
|
|
11333
11518
|
"locationInModule": {
|
|
11334
11519
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11335
|
-
"line":
|
|
11520
|
+
"line": 271
|
|
11336
11521
|
},
|
|
11337
11522
|
"name": "formatVersion",
|
|
11338
11523
|
"type": {
|
|
@@ -11347,7 +11532,7 @@
|
|
|
11347
11532
|
"immutable": true,
|
|
11348
11533
|
"locationInModule": {
|
|
11349
11534
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11350
|
-
"line":
|
|
11535
|
+
"line": 265
|
|
11351
11536
|
},
|
|
11352
11537
|
"name": "location",
|
|
11353
11538
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11363,7 +11548,7 @@
|
|
|
11363
11548
|
"immutable": true,
|
|
11364
11549
|
"locationInModule": {
|
|
11365
11550
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11366
|
-
"line":
|
|
11551
|
+
"line": 274
|
|
11367
11552
|
},
|
|
11368
11553
|
"name": "resource",
|
|
11369
11554
|
"type": {
|
|
@@ -11378,7 +11563,7 @@
|
|
|
11378
11563
|
"immutable": true,
|
|
11379
11564
|
"locationInModule": {
|
|
11380
11565
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11381
|
-
"line":
|
|
11566
|
+
"line": 256
|
|
11382
11567
|
},
|
|
11383
11568
|
"name": "tableArn",
|
|
11384
11569
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11394,7 +11579,7 @@
|
|
|
11394
11579
|
"immutable": true,
|
|
11395
11580
|
"locationInModule": {
|
|
11396
11581
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11397
|
-
"line":
|
|
11582
|
+
"line": 259
|
|
11398
11583
|
},
|
|
11399
11584
|
"name": "tableName",
|
|
11400
11585
|
"overrides": "cdk-glue-iceberg-table.IIcebergTable",
|
|
@@ -11416,7 +11601,7 @@
|
|
|
11416
11601
|
"kind": "interface",
|
|
11417
11602
|
"locationInModule": {
|
|
11418
11603
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11419
|
-
"line":
|
|
11604
|
+
"line": 484
|
|
11420
11605
|
},
|
|
11421
11606
|
"name": "IcebergTableAttributes",
|
|
11422
11607
|
"properties": [
|
|
@@ -11429,7 +11614,7 @@
|
|
|
11429
11614
|
"immutable": true,
|
|
11430
11615
|
"locationInModule": {
|
|
11431
11616
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11432
|
-
"line":
|
|
11617
|
+
"line": 486
|
|
11433
11618
|
},
|
|
11434
11619
|
"name": "database",
|
|
11435
11620
|
"type": {
|
|
@@ -11445,7 +11630,7 @@
|
|
|
11445
11630
|
"immutable": true,
|
|
11446
11631
|
"locationInModule": {
|
|
11447
11632
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11448
|
-
"line":
|
|
11633
|
+
"line": 492
|
|
11449
11634
|
},
|
|
11450
11635
|
"name": "location",
|
|
11451
11636
|
"type": {
|
|
@@ -11461,7 +11646,7 @@
|
|
|
11461
11646
|
"immutable": true,
|
|
11462
11647
|
"locationInModule": {
|
|
11463
11648
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11464
|
-
"line":
|
|
11649
|
+
"line": 489
|
|
11465
11650
|
},
|
|
11466
11651
|
"name": "tableName",
|
|
11467
11652
|
"type": {
|
|
@@ -11482,7 +11667,7 @@
|
|
|
11482
11667
|
"kind": "interface",
|
|
11483
11668
|
"locationInModule": {
|
|
11484
11669
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11485
|
-
"line":
|
|
11670
|
+
"line": 153
|
|
11486
11671
|
},
|
|
11487
11672
|
"name": "IcebergTableProps",
|
|
11488
11673
|
"properties": [
|
|
@@ -11496,7 +11681,7 @@
|
|
|
11496
11681
|
"immutable": true,
|
|
11497
11682
|
"locationInModule": {
|
|
11498
11683
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11499
|
-
"line":
|
|
11684
|
+
"line": 161
|
|
11500
11685
|
},
|
|
11501
11686
|
"name": "columns",
|
|
11502
11687
|
"type": {
|
|
@@ -11517,7 +11702,7 @@
|
|
|
11517
11702
|
"immutable": true,
|
|
11518
11703
|
"locationInModule": {
|
|
11519
11704
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11520
|
-
"line":
|
|
11705
|
+
"line": 155
|
|
11521
11706
|
},
|
|
11522
11707
|
"name": "database",
|
|
11523
11708
|
"type": {
|
|
@@ -11534,7 +11719,7 @@
|
|
|
11534
11719
|
"immutable": true,
|
|
11535
11720
|
"locationInModule": {
|
|
11536
11721
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11537
|
-
"line":
|
|
11722
|
+
"line": 186
|
|
11538
11723
|
},
|
|
11539
11724
|
"name": "formatVersion",
|
|
11540
11725
|
"type": {
|
|
@@ -11551,7 +11736,7 @@
|
|
|
11551
11736
|
"immutable": true,
|
|
11552
11737
|
"locationInModule": {
|
|
11553
11738
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11554
|
-
"line":
|
|
11739
|
+
"line": 164
|
|
11555
11740
|
},
|
|
11556
11741
|
"name": "location",
|
|
11557
11742
|
"type": {
|
|
@@ -11567,7 +11752,7 @@
|
|
|
11567
11752
|
"immutable": true,
|
|
11568
11753
|
"locationInModule": {
|
|
11569
11754
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11570
|
-
"line":
|
|
11755
|
+
"line": 158
|
|
11571
11756
|
},
|
|
11572
11757
|
"name": "tableName",
|
|
11573
11758
|
"type": {
|
|
@@ -11584,7 +11769,7 @@
|
|
|
11584
11769
|
"immutable": true,
|
|
11585
11770
|
"locationInModule": {
|
|
11586
11771
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11587
|
-
"line":
|
|
11772
|
+
"line": 206
|
|
11588
11773
|
},
|
|
11589
11774
|
"name": "comment",
|
|
11590
11775
|
"optional": true,
|
|
@@ -11602,7 +11787,7 @@
|
|
|
11602
11787
|
"immutable": true,
|
|
11603
11788
|
"locationInModule": {
|
|
11604
11789
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11605
|
-
"line":
|
|
11790
|
+
"line": 183
|
|
11606
11791
|
},
|
|
11607
11792
|
"name": "dataFormat",
|
|
11608
11793
|
"optional": true,
|
|
@@ -11620,7 +11805,7 @@
|
|
|
11620
11805
|
"immutable": true,
|
|
11621
11806
|
"locationInModule": {
|
|
11622
11807
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11623
|
-
"line":
|
|
11808
|
+
"line": 180
|
|
11624
11809
|
},
|
|
11625
11810
|
"name": "identifierFieldNames",
|
|
11626
11811
|
"optional": true,
|
|
@@ -11643,7 +11828,7 @@
|
|
|
11643
11828
|
"immutable": true,
|
|
11644
11829
|
"locationInModule": {
|
|
11645
11830
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11646
|
-
"line":
|
|
11831
|
+
"line": 167
|
|
11647
11832
|
},
|
|
11648
11833
|
"name": "partitionSpec",
|
|
11649
11834
|
"optional": true,
|
|
@@ -11666,7 +11851,7 @@
|
|
|
11666
11851
|
"immutable": true,
|
|
11667
11852
|
"locationInModule": {
|
|
11668
11853
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11669
|
-
"line":
|
|
11854
|
+
"line": 213
|
|
11670
11855
|
},
|
|
11671
11856
|
"name": "removalPolicy",
|
|
11672
11857
|
"optional": true,
|
|
@@ -11684,7 +11869,7 @@
|
|
|
11684
11869
|
"immutable": true,
|
|
11685
11870
|
"locationInModule": {
|
|
11686
11871
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11687
|
-
"line":
|
|
11872
|
+
"line": 170
|
|
11688
11873
|
},
|
|
11689
11874
|
"name": "sortOrder",
|
|
11690
11875
|
"optional": true,
|
|
@@ -11707,7 +11892,7 @@
|
|
|
11707
11892
|
"immutable": true,
|
|
11708
11893
|
"locationInModule": {
|
|
11709
11894
|
"filename": "lib/iceberg/iceberg-table.ts",
|
|
11710
|
-
"line":
|
|
11895
|
+
"line": 195
|
|
11711
11896
|
},
|
|
11712
11897
|
"name": "tableProperties",
|
|
11713
11898
|
"optional": true,
|
|
@@ -11737,7 +11922,7 @@
|
|
|
11737
11922
|
},
|
|
11738
11923
|
"locationInModule": {
|
|
11739
11924
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11740
|
-
"line":
|
|
11925
|
+
"line": 373
|
|
11741
11926
|
},
|
|
11742
11927
|
"parameters": [
|
|
11743
11928
|
{
|
|
@@ -11751,7 +11936,7 @@
|
|
|
11751
11936
|
"kind": "class",
|
|
11752
11937
|
"locationInModule": {
|
|
11753
11938
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11754
|
-
"line":
|
|
11939
|
+
"line": 158
|
|
11755
11940
|
},
|
|
11756
11941
|
"methods": [
|
|
11757
11942
|
{
|
|
@@ -11761,7 +11946,7 @@
|
|
|
11761
11946
|
},
|
|
11762
11947
|
"locationInModule": {
|
|
11763
11948
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11764
|
-
"line":
|
|
11949
|
+
"line": 246
|
|
11765
11950
|
},
|
|
11766
11951
|
"name": "decimal",
|
|
11767
11952
|
"parameters": [
|
|
@@ -11798,7 +11983,7 @@
|
|
|
11798
11983
|
},
|
|
11799
11984
|
"locationInModule": {
|
|
11800
11985
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11801
|
-
"line":
|
|
11986
|
+
"line": 258
|
|
11802
11987
|
},
|
|
11803
11988
|
"name": "fixed",
|
|
11804
11989
|
"parameters": [
|
|
@@ -11827,7 +12012,7 @@
|
|
|
11827
12012
|
},
|
|
11828
12013
|
"locationInModule": {
|
|
11829
12014
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11830
|
-
"line":
|
|
12015
|
+
"line": 320
|
|
11831
12016
|
},
|
|
11832
12017
|
"name": "geography",
|
|
11833
12018
|
"parameters": [
|
|
@@ -11869,7 +12054,7 @@
|
|
|
11869
12054
|
},
|
|
11870
12055
|
"locationInModule": {
|
|
11871
12056
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11872
|
-
"line":
|
|
12057
|
+
"line": 308
|
|
11873
12058
|
},
|
|
11874
12059
|
"name": "geometry",
|
|
11875
12060
|
"parameters": [
|
|
@@ -11899,28 +12084,17 @@
|
|
|
11899
12084
|
},
|
|
11900
12085
|
"locationInModule": {
|
|
11901
12086
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11902
|
-
"line":
|
|
12087
|
+
"line": 269
|
|
11903
12088
|
},
|
|
11904
12089
|
"name": "list",
|
|
11905
12090
|
"parameters": [
|
|
11906
12091
|
{
|
|
11907
12092
|
"docs": {
|
|
11908
|
-
"summary": "Element type."
|
|
12093
|
+
"summary": "Element type, element id, and element nullability."
|
|
11909
12094
|
},
|
|
11910
|
-
"name": "
|
|
11911
|
-
"type": {
|
|
11912
|
-
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
11913
|
-
}
|
|
11914
|
-
},
|
|
11915
|
-
{
|
|
11916
|
-
"docs": {
|
|
11917
|
-
"remarks": "Defaults to `true` (non-null).",
|
|
11918
|
-
"summary": "Whether elements are non-nullable."
|
|
11919
|
-
},
|
|
11920
|
-
"name": "elementRequired",
|
|
11921
|
-
"optional": true,
|
|
12095
|
+
"name": "definition",
|
|
11922
12096
|
"type": {
|
|
11923
|
-
"
|
|
12097
|
+
"fqn": "cdk-glue-iceberg-table.IcebergListDefinition"
|
|
11924
12098
|
}
|
|
11925
12099
|
}
|
|
11926
12100
|
],
|
|
@@ -11933,43 +12107,22 @@
|
|
|
11933
12107
|
},
|
|
11934
12108
|
{
|
|
11935
12109
|
"docs": {
|
|
11936
|
-
"remarks": "Keys are always required per the Iceberg spec.",
|
|
11937
12110
|
"stability": "experimental",
|
|
11938
12111
|
"summary": "Key/value map."
|
|
11939
12112
|
},
|
|
11940
12113
|
"locationInModule": {
|
|
11941
12114
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11942
|
-
"line":
|
|
12115
|
+
"line": 282
|
|
11943
12116
|
},
|
|
11944
12117
|
"name": "map",
|
|
11945
12118
|
"parameters": [
|
|
11946
12119
|
{
|
|
11947
12120
|
"docs": {
|
|
11948
|
-
"summary": "Key
|
|
12121
|
+
"summary": "Key and value types, their ids, and value nullability."
|
|
11949
12122
|
},
|
|
11950
|
-
"name": "
|
|
12123
|
+
"name": "definition",
|
|
11951
12124
|
"type": {
|
|
11952
|
-
"fqn": "cdk-glue-iceberg-table.
|
|
11953
|
-
}
|
|
11954
|
-
},
|
|
11955
|
-
{
|
|
11956
|
-
"docs": {
|
|
11957
|
-
"summary": "Value type."
|
|
11958
|
-
},
|
|
11959
|
-
"name": "value",
|
|
11960
|
-
"type": {
|
|
11961
|
-
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
11962
|
-
}
|
|
11963
|
-
},
|
|
11964
|
-
{
|
|
11965
|
-
"docs": {
|
|
11966
|
-
"remarks": "Defaults to `true` (non-null).",
|
|
11967
|
-
"summary": "Whether values are non-nullable."
|
|
11968
|
-
},
|
|
11969
|
-
"name": "valueRequired",
|
|
11970
|
-
"optional": true,
|
|
11971
|
-
"type": {
|
|
11972
|
-
"primitive": "boolean"
|
|
12125
|
+
"fqn": "cdk-glue-iceberg-table.IcebergMapDefinition"
|
|
11973
12126
|
}
|
|
11974
12127
|
}
|
|
11975
12128
|
],
|
|
@@ -11987,13 +12140,13 @@
|
|
|
11987
12140
|
},
|
|
11988
12141
|
"locationInModule": {
|
|
11989
12142
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11990
|
-
"line":
|
|
12143
|
+
"line": 297
|
|
11991
12144
|
},
|
|
11992
12145
|
"name": "struct",
|
|
11993
12146
|
"parameters": [
|
|
11994
12147
|
{
|
|
11995
12148
|
"docs": {
|
|
11996
|
-
"summary": "Struct fields (each carries
|
|
12149
|
+
"summary": "Struct fields (each carries an id, name, type, required flag, optional doc)."
|
|
11997
12150
|
},
|
|
11998
12151
|
"name": "fields",
|
|
11999
12152
|
"type": {
|
|
@@ -12020,7 +12173,7 @@
|
|
|
12020
12173
|
},
|
|
12021
12174
|
"locationInModule": {
|
|
12022
12175
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12023
|
-
"line":
|
|
12176
|
+
"line": 575
|
|
12024
12177
|
},
|
|
12025
12178
|
"name": "isDecimal",
|
|
12026
12179
|
"returns": {
|
|
@@ -12036,7 +12189,7 @@
|
|
|
12036
12189
|
},
|
|
12037
12190
|
"locationInModule": {
|
|
12038
12191
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12039
|
-
"line":
|
|
12192
|
+
"line": 580
|
|
12040
12193
|
},
|
|
12041
12194
|
"name": "isFixed",
|
|
12042
12195
|
"returns": {
|
|
@@ -12052,7 +12205,7 @@
|
|
|
12052
12205
|
},
|
|
12053
12206
|
"locationInModule": {
|
|
12054
12207
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12055
|
-
"line":
|
|
12208
|
+
"line": 570
|
|
12056
12209
|
},
|
|
12057
12210
|
"name": "isPrimitive",
|
|
12058
12211
|
"parameters": [
|
|
@@ -12081,7 +12234,7 @@
|
|
|
12081
12234
|
"immutable": true,
|
|
12082
12235
|
"locationInModule": {
|
|
12083
12236
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12084
|
-
"line":
|
|
12237
|
+
"line": 217
|
|
12085
12238
|
},
|
|
12086
12239
|
"name": "BINARY",
|
|
12087
12240
|
"static": true,
|
|
@@ -12098,7 +12251,7 @@
|
|
|
12098
12251
|
"immutable": true,
|
|
12099
12252
|
"locationInModule": {
|
|
12100
12253
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12101
|
-
"line":
|
|
12254
|
+
"line": 162
|
|
12102
12255
|
},
|
|
12103
12256
|
"name": "BOOLEAN",
|
|
12104
12257
|
"static": true,
|
|
@@ -12115,7 +12268,7 @@
|
|
|
12115
12268
|
"immutable": true,
|
|
12116
12269
|
"locationInModule": {
|
|
12117
12270
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12118
|
-
"line":
|
|
12271
|
+
"line": 187
|
|
12119
12272
|
},
|
|
12120
12273
|
"name": "DATE",
|
|
12121
12274
|
"static": true,
|
|
@@ -12132,7 +12285,7 @@
|
|
|
12132
12285
|
"immutable": true,
|
|
12133
12286
|
"locationInModule": {
|
|
12134
12287
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12135
|
-
"line":
|
|
12288
|
+
"line": 182
|
|
12136
12289
|
},
|
|
12137
12290
|
"name": "DOUBLE",
|
|
12138
12291
|
"static": true,
|
|
@@ -12149,7 +12302,7 @@
|
|
|
12149
12302
|
"immutable": true,
|
|
12150
12303
|
"locationInModule": {
|
|
12151
12304
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12152
|
-
"line":
|
|
12305
|
+
"line": 177
|
|
12153
12306
|
},
|
|
12154
12307
|
"name": "FLOAT",
|
|
12155
12308
|
"static": true,
|
|
@@ -12166,7 +12319,7 @@
|
|
|
12166
12319
|
"immutable": true,
|
|
12167
12320
|
"locationInModule": {
|
|
12168
12321
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12169
|
-
"line":
|
|
12322
|
+
"line": 167
|
|
12170
12323
|
},
|
|
12171
12324
|
"name": "INT",
|
|
12172
12325
|
"static": true,
|
|
@@ -12183,7 +12336,7 @@
|
|
|
12183
12336
|
"immutable": true,
|
|
12184
12337
|
"locationInModule": {
|
|
12185
12338
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12186
|
-
"line":
|
|
12339
|
+
"line": 172
|
|
12187
12340
|
},
|
|
12188
12341
|
"name": "LONG",
|
|
12189
12342
|
"static": true,
|
|
@@ -12200,7 +12353,7 @@
|
|
|
12200
12353
|
"immutable": true,
|
|
12201
12354
|
"locationInModule": {
|
|
12202
12355
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12203
|
-
"line":
|
|
12356
|
+
"line": 207
|
|
12204
12357
|
},
|
|
12205
12358
|
"name": "STRING",
|
|
12206
12359
|
"static": true,
|
|
@@ -12217,7 +12370,7 @@
|
|
|
12217
12370
|
"immutable": true,
|
|
12218
12371
|
"locationInModule": {
|
|
12219
12372
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12220
|
-
"line":
|
|
12373
|
+
"line": 192
|
|
12221
12374
|
},
|
|
12222
12375
|
"name": "TIME",
|
|
12223
12376
|
"static": true,
|
|
@@ -12234,7 +12387,7 @@
|
|
|
12234
12387
|
"immutable": true,
|
|
12235
12388
|
"locationInModule": {
|
|
12236
12389
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12237
|
-
"line":
|
|
12390
|
+
"line": 197
|
|
12238
12391
|
},
|
|
12239
12392
|
"name": "TIMESTAMP",
|
|
12240
12393
|
"static": true,
|
|
@@ -12252,7 +12405,7 @@
|
|
|
12252
12405
|
"immutable": true,
|
|
12253
12406
|
"locationInModule": {
|
|
12254
12407
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12255
|
-
"line":
|
|
12408
|
+
"line": 227
|
|
12256
12409
|
},
|
|
12257
12410
|
"name": "TIMESTAMP_NS",
|
|
12258
12411
|
"static": true,
|
|
@@ -12269,7 +12422,7 @@
|
|
|
12269
12422
|
"immutable": true,
|
|
12270
12423
|
"locationInModule": {
|
|
12271
12424
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12272
|
-
"line":
|
|
12425
|
+
"line": 202
|
|
12273
12426
|
},
|
|
12274
12427
|
"name": "TIMESTAMPTZ",
|
|
12275
12428
|
"static": true,
|
|
@@ -12287,7 +12440,7 @@
|
|
|
12287
12440
|
"immutable": true,
|
|
12288
12441
|
"locationInModule": {
|
|
12289
12442
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12290
|
-
"line":
|
|
12443
|
+
"line": 232
|
|
12291
12444
|
},
|
|
12292
12445
|
"name": "TIMESTAMPTZ_NS",
|
|
12293
12446
|
"static": true,
|
|
@@ -12305,7 +12458,7 @@
|
|
|
12305
12458
|
"immutable": true,
|
|
12306
12459
|
"locationInModule": {
|
|
12307
12460
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12308
|
-
"line":
|
|
12461
|
+
"line": 222
|
|
12309
12462
|
},
|
|
12310
12463
|
"name": "UNKNOWN",
|
|
12311
12464
|
"static": true,
|
|
@@ -12322,7 +12475,7 @@
|
|
|
12322
12475
|
"immutable": true,
|
|
12323
12476
|
"locationInModule": {
|
|
12324
12477
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12325
|
-
"line":
|
|
12478
|
+
"line": 212
|
|
12326
12479
|
},
|
|
12327
12480
|
"name": "UUID",
|
|
12328
12481
|
"static": true,
|
|
@@ -12340,7 +12493,7 @@
|
|
|
12340
12493
|
"immutable": true,
|
|
12341
12494
|
"locationInModule": {
|
|
12342
12495
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12343
|
-
"line":
|
|
12496
|
+
"line": 237
|
|
12344
12497
|
},
|
|
12345
12498
|
"name": "VARIANT",
|
|
12346
12499
|
"static": true,
|
|
@@ -12356,7 +12509,7 @@
|
|
|
12356
12509
|
"immutable": true,
|
|
12357
12510
|
"locationInModule": {
|
|
12358
12511
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12359
|
-
"line":
|
|
12512
|
+
"line": 329
|
|
12360
12513
|
},
|
|
12361
12514
|
"name": "kind",
|
|
12362
12515
|
"type": {
|
|
@@ -12371,7 +12524,7 @@
|
|
|
12371
12524
|
"immutable": true,
|
|
12372
12525
|
"locationInModule": {
|
|
12373
12526
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12374
|
-
"line":
|
|
12527
|
+
"line": 332
|
|
12375
12528
|
},
|
|
12376
12529
|
"name": "decimalPrecision",
|
|
12377
12530
|
"optional": true,
|
|
@@ -12387,7 +12540,7 @@
|
|
|
12387
12540
|
"immutable": true,
|
|
12388
12541
|
"locationInModule": {
|
|
12389
12542
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12390
|
-
"line":
|
|
12543
|
+
"line": 335
|
|
12391
12544
|
},
|
|
12392
12545
|
"name": "decimalScale",
|
|
12393
12546
|
"optional": true,
|
|
@@ -12403,7 +12556,7 @@
|
|
|
12403
12556
|
"immutable": true,
|
|
12404
12557
|
"locationInModule": {
|
|
12405
12558
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12406
|
-
"line":
|
|
12559
|
+
"line": 338
|
|
12407
12560
|
},
|
|
12408
12561
|
"name": "fixedLength",
|
|
12409
12562
|
"optional": true,
|
|
@@ -12419,7 +12572,7 @@
|
|
|
12419
12572
|
"immutable": true,
|
|
12420
12573
|
"locationInModule": {
|
|
12421
12574
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12422
|
-
"line":
|
|
12575
|
+
"line": 368
|
|
12423
12576
|
},
|
|
12424
12577
|
"name": "geoCrs",
|
|
12425
12578
|
"optional": true,
|
|
@@ -12435,7 +12588,7 @@
|
|
|
12435
12588
|
"immutable": true,
|
|
12436
12589
|
"locationInModule": {
|
|
12437
12590
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12438
|
-
"line":
|
|
12591
|
+
"line": 371
|
|
12439
12592
|
},
|
|
12440
12593
|
"name": "geographyAlgorithm",
|
|
12441
12594
|
"optional": true,
|
|
@@ -12451,7 +12604,7 @@
|
|
|
12451
12604
|
"immutable": true,
|
|
12452
12605
|
"locationInModule": {
|
|
12453
12606
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12454
|
-
"line":
|
|
12607
|
+
"line": 341
|
|
12455
12608
|
},
|
|
12456
12609
|
"name": "listElement",
|
|
12457
12610
|
"optional": true,
|
|
@@ -12459,6 +12612,22 @@
|
|
|
12459
12612
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12460
12613
|
}
|
|
12461
12614
|
},
|
|
12615
|
+
{
|
|
12616
|
+
"docs": {
|
|
12617
|
+
"stability": "experimental",
|
|
12618
|
+
"summary": "List element field id (set when `kind === LIST`)."
|
|
12619
|
+
},
|
|
12620
|
+
"immutable": true,
|
|
12621
|
+
"locationInModule": {
|
|
12622
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12623
|
+
"line": 344
|
|
12624
|
+
},
|
|
12625
|
+
"name": "listElementId",
|
|
12626
|
+
"optional": true,
|
|
12627
|
+
"type": {
|
|
12628
|
+
"primitive": "number"
|
|
12629
|
+
}
|
|
12630
|
+
},
|
|
12462
12631
|
{
|
|
12463
12632
|
"docs": {
|
|
12464
12633
|
"stability": "experimental",
|
|
@@ -12467,7 +12636,7 @@
|
|
|
12467
12636
|
"immutable": true,
|
|
12468
12637
|
"locationInModule": {
|
|
12469
12638
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12470
|
-
"line":
|
|
12639
|
+
"line": 347
|
|
12471
12640
|
},
|
|
12472
12641
|
"name": "listElementRequired",
|
|
12473
12642
|
"optional": true,
|
|
@@ -12483,7 +12652,7 @@
|
|
|
12483
12652
|
"immutable": true,
|
|
12484
12653
|
"locationInModule": {
|
|
12485
12654
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12486
|
-
"line":
|
|
12655
|
+
"line": 350
|
|
12487
12656
|
},
|
|
12488
12657
|
"name": "mapKey",
|
|
12489
12658
|
"optional": true,
|
|
@@ -12491,6 +12660,22 @@
|
|
|
12491
12660
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12492
12661
|
}
|
|
12493
12662
|
},
|
|
12663
|
+
{
|
|
12664
|
+
"docs": {
|
|
12665
|
+
"stability": "experimental",
|
|
12666
|
+
"summary": "Map key field id (set when `kind === MAP`)."
|
|
12667
|
+
},
|
|
12668
|
+
"immutable": true,
|
|
12669
|
+
"locationInModule": {
|
|
12670
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12671
|
+
"line": 353
|
|
12672
|
+
},
|
|
12673
|
+
"name": "mapKeyId",
|
|
12674
|
+
"optional": true,
|
|
12675
|
+
"type": {
|
|
12676
|
+
"primitive": "number"
|
|
12677
|
+
}
|
|
12678
|
+
},
|
|
12494
12679
|
{
|
|
12495
12680
|
"docs": {
|
|
12496
12681
|
"stability": "experimental",
|
|
@@ -12499,7 +12684,7 @@
|
|
|
12499
12684
|
"immutable": true,
|
|
12500
12685
|
"locationInModule": {
|
|
12501
12686
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12502
|
-
"line":
|
|
12687
|
+
"line": 356
|
|
12503
12688
|
},
|
|
12504
12689
|
"name": "mapValue",
|
|
12505
12690
|
"optional": true,
|
|
@@ -12507,6 +12692,22 @@
|
|
|
12507
12692
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12508
12693
|
}
|
|
12509
12694
|
},
|
|
12695
|
+
{
|
|
12696
|
+
"docs": {
|
|
12697
|
+
"stability": "experimental",
|
|
12698
|
+
"summary": "Map value field id (set when `kind === MAP`)."
|
|
12699
|
+
},
|
|
12700
|
+
"immutable": true,
|
|
12701
|
+
"locationInModule": {
|
|
12702
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12703
|
+
"line": 359
|
|
12704
|
+
},
|
|
12705
|
+
"name": "mapValueId",
|
|
12706
|
+
"optional": true,
|
|
12707
|
+
"type": {
|
|
12708
|
+
"primitive": "number"
|
|
12709
|
+
}
|
|
12710
|
+
},
|
|
12510
12711
|
{
|
|
12511
12712
|
"docs": {
|
|
12512
12713
|
"stability": "experimental",
|
|
@@ -12515,7 +12716,7 @@
|
|
|
12515
12716
|
"immutable": true,
|
|
12516
12717
|
"locationInModule": {
|
|
12517
12718
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12518
|
-
"line":
|
|
12719
|
+
"line": 362
|
|
12519
12720
|
},
|
|
12520
12721
|
"name": "mapValueRequired",
|
|
12521
12722
|
"optional": true,
|
|
@@ -12531,7 +12732,7 @@
|
|
|
12531
12732
|
"immutable": true,
|
|
12532
12733
|
"locationInModule": {
|
|
12533
12734
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12534
|
-
"line":
|
|
12735
|
+
"line": 365
|
|
12535
12736
|
},
|
|
12536
12737
|
"name": "structFields",
|
|
12537
12738
|
"optional": true,
|
|
@@ -12557,7 +12758,7 @@
|
|
|
12557
12758
|
"kind": "enum",
|
|
12558
12759
|
"locationInModule": {
|
|
12559
12760
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12560
|
-
"line":
|
|
12761
|
+
"line": 13
|
|
12561
12762
|
},
|
|
12562
12763
|
"members": [
|
|
12563
12764
|
{
|
|
@@ -12714,7 +12915,7 @@
|
|
|
12714
12915
|
"kind": "interface",
|
|
12715
12916
|
"locationInModule": {
|
|
12716
12917
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12717
|
-
"line":
|
|
12918
|
+
"line": 107
|
|
12718
12919
|
},
|
|
12719
12920
|
"name": "IcebergTypeOptions",
|
|
12720
12921
|
"properties": [
|
|
@@ -12727,7 +12928,7 @@
|
|
|
12727
12928
|
"immutable": true,
|
|
12728
12929
|
"locationInModule": {
|
|
12729
12930
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12730
|
-
"line":
|
|
12931
|
+
"line": 109
|
|
12731
12932
|
},
|
|
12732
12933
|
"name": "kind",
|
|
12733
12934
|
"type": {
|
|
@@ -12743,7 +12944,7 @@
|
|
|
12743
12944
|
"immutable": true,
|
|
12744
12945
|
"locationInModule": {
|
|
12745
12946
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12746
|
-
"line":
|
|
12947
|
+
"line": 112
|
|
12747
12948
|
},
|
|
12748
12949
|
"name": "decimalPrecision",
|
|
12749
12950
|
"optional": true,
|
|
@@ -12760,7 +12961,7 @@
|
|
|
12760
12961
|
"immutable": true,
|
|
12761
12962
|
"locationInModule": {
|
|
12762
12963
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12763
|
-
"line":
|
|
12964
|
+
"line": 115
|
|
12764
12965
|
},
|
|
12765
12966
|
"name": "decimalScale",
|
|
12766
12967
|
"optional": true,
|
|
@@ -12778,7 +12979,7 @@
|
|
|
12778
12979
|
"immutable": true,
|
|
12779
12980
|
"locationInModule": {
|
|
12780
12981
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12781
|
-
"line":
|
|
12982
|
+
"line": 118
|
|
12782
12983
|
},
|
|
12783
12984
|
"name": "fixedLength",
|
|
12784
12985
|
"optional": true,
|
|
@@ -12796,7 +12997,7 @@
|
|
|
12796
12997
|
"immutable": true,
|
|
12797
12998
|
"locationInModule": {
|
|
12798
12999
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12799
|
-
"line":
|
|
13000
|
+
"line": 148
|
|
12800
13001
|
},
|
|
12801
13002
|
"name": "geoCrs",
|
|
12802
13003
|
"optional": true,
|
|
@@ -12814,7 +13015,7 @@
|
|
|
12814
13015
|
"immutable": true,
|
|
12815
13016
|
"locationInModule": {
|
|
12816
13017
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12817
|
-
"line":
|
|
13018
|
+
"line": 151
|
|
12818
13019
|
},
|
|
12819
13020
|
"name": "geographyAlgorithm",
|
|
12820
13021
|
"optional": true,
|
|
@@ -12832,7 +13033,7 @@
|
|
|
12832
13033
|
"immutable": true,
|
|
12833
13034
|
"locationInModule": {
|
|
12834
13035
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12835
|
-
"line":
|
|
13036
|
+
"line": 121
|
|
12836
13037
|
},
|
|
12837
13038
|
"name": "listElement",
|
|
12838
13039
|
"optional": true,
|
|
@@ -12843,14 +13044,32 @@
|
|
|
12843
13044
|
{
|
|
12844
13045
|
"abstract": true,
|
|
12845
13046
|
"docs": {
|
|
12846
|
-
"remarks": "
|
|
13047
|
+
"remarks": "Checked by `IcebergTable`.",
|
|
13048
|
+
"stability": "experimental",
|
|
13049
|
+
"summary": "Element field id."
|
|
13050
|
+
},
|
|
13051
|
+
"immutable": true,
|
|
13052
|
+
"locationInModule": {
|
|
13053
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
13054
|
+
"line": 124
|
|
13055
|
+
},
|
|
13056
|
+
"name": "listElementId",
|
|
13057
|
+
"optional": true,
|
|
13058
|
+
"type": {
|
|
13059
|
+
"primitive": "number"
|
|
13060
|
+
}
|
|
13061
|
+
},
|
|
13062
|
+
{
|
|
13063
|
+
"abstract": true,
|
|
13064
|
+
"docs": {
|
|
13065
|
+
"remarks": "Defaults to `false`.",
|
|
12847
13066
|
"stability": "experimental",
|
|
12848
13067
|
"summary": "Whether list elements are non-nullable."
|
|
12849
13068
|
},
|
|
12850
13069
|
"immutable": true,
|
|
12851
13070
|
"locationInModule": {
|
|
12852
13071
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12853
|
-
"line":
|
|
13072
|
+
"line": 127
|
|
12854
13073
|
},
|
|
12855
13074
|
"name": "listElementRequired",
|
|
12856
13075
|
"optional": true,
|
|
@@ -12868,7 +13087,7 @@
|
|
|
12868
13087
|
"immutable": true,
|
|
12869
13088
|
"locationInModule": {
|
|
12870
13089
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12871
|
-
"line":
|
|
13090
|
+
"line": 130
|
|
12872
13091
|
},
|
|
12873
13092
|
"name": "mapKey",
|
|
12874
13093
|
"optional": true,
|
|
@@ -12876,6 +13095,24 @@
|
|
|
12876
13095
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12877
13096
|
}
|
|
12878
13097
|
},
|
|
13098
|
+
{
|
|
13099
|
+
"abstract": true,
|
|
13100
|
+
"docs": {
|
|
13101
|
+
"remarks": "Checked by `IcebergTable`.",
|
|
13102
|
+
"stability": "experimental",
|
|
13103
|
+
"summary": "Map key field id."
|
|
13104
|
+
},
|
|
13105
|
+
"immutable": true,
|
|
13106
|
+
"locationInModule": {
|
|
13107
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
13108
|
+
"line": 133
|
|
13109
|
+
},
|
|
13110
|
+
"name": "mapKeyId",
|
|
13111
|
+
"optional": true,
|
|
13112
|
+
"type": {
|
|
13113
|
+
"primitive": "number"
|
|
13114
|
+
}
|
|
13115
|
+
},
|
|
12879
13116
|
{
|
|
12880
13117
|
"abstract": true,
|
|
12881
13118
|
"docs": {
|
|
@@ -12886,7 +13123,7 @@
|
|
|
12886
13123
|
"immutable": true,
|
|
12887
13124
|
"locationInModule": {
|
|
12888
13125
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12889
|
-
"line":
|
|
13126
|
+
"line": 136
|
|
12890
13127
|
},
|
|
12891
13128
|
"name": "mapValue",
|
|
12892
13129
|
"optional": true,
|
|
@@ -12897,14 +13134,32 @@
|
|
|
12897
13134
|
{
|
|
12898
13135
|
"abstract": true,
|
|
12899
13136
|
"docs": {
|
|
12900
|
-
"remarks": "
|
|
13137
|
+
"remarks": "Checked by `IcebergTable`.",
|
|
13138
|
+
"stability": "experimental",
|
|
13139
|
+
"summary": "Map value field id."
|
|
13140
|
+
},
|
|
13141
|
+
"immutable": true,
|
|
13142
|
+
"locationInModule": {
|
|
13143
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
13144
|
+
"line": 139
|
|
13145
|
+
},
|
|
13146
|
+
"name": "mapValueId",
|
|
13147
|
+
"optional": true,
|
|
13148
|
+
"type": {
|
|
13149
|
+
"primitive": "number"
|
|
13150
|
+
}
|
|
13151
|
+
},
|
|
13152
|
+
{
|
|
13153
|
+
"abstract": true,
|
|
13154
|
+
"docs": {
|
|
13155
|
+
"remarks": "Defaults to `false`.",
|
|
12901
13156
|
"stability": "experimental",
|
|
12902
13157
|
"summary": "Whether map values are non-nullable."
|
|
12903
13158
|
},
|
|
12904
13159
|
"immutable": true,
|
|
12905
13160
|
"locationInModule": {
|
|
12906
13161
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12907
|
-
"line":
|
|
13162
|
+
"line": 142
|
|
12908
13163
|
},
|
|
12909
13164
|
"name": "mapValueRequired",
|
|
12910
13165
|
"optional": true,
|
|
@@ -12922,7 +13177,7 @@
|
|
|
12922
13177
|
"immutable": true,
|
|
12923
13178
|
"locationInModule": {
|
|
12924
13179
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12925
|
-
"line":
|
|
13180
|
+
"line": 145
|
|
12926
13181
|
},
|
|
12927
13182
|
"name": "structFields",
|
|
12928
13183
|
"optional": true,
|
|
@@ -12939,6 +13194,6 @@
|
|
|
12939
13194
|
"symbolId": "lib/iceberg/iceberg-type:IcebergTypeOptions"
|
|
12940
13195
|
}
|
|
12941
13196
|
},
|
|
12942
|
-
"version": "0.
|
|
12943
|
-
"fingerprint": "
|
|
13197
|
+
"version": "0.12.0",
|
|
13198
|
+
"fingerprint": "BVPUg5AHM6eqgtl5oOA6VFaXYLPm9MrB2eqV/wxx41Q="
|
|
12944
13199
|
}
|