cdk-glue-iceberg-table 0.8.0 → 0.9.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 +348 -52
- package/README.md +2 -2
- 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 +50 -1
- package/dist/lib/iceberg/iceberg-table.js +1 -1
- package/dist/lib/iceberg/iceberg-type.d.ts +43 -2
- package/dist/lib/iceberg/iceberg-type.js +87 -4
- package/dist/lib/iceberg/index.d.ts +1 -1
- package/dist/lib/iceberg/index.js +3 -2
- 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://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](https://github.com/ksco92/arceus/commits/main)\n[](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is the AWS CDK L2 construct for creating\nand evolving Apache Iceberg tables in the AWS Glue Data Catalog.** It\nemits the exact `AWS::Glue::Table` / `OpenTableFormatInput` shape that\nsurvives a CloudFormation `Update`, so a single `cdk deploy` creates a\ntable, evolves its schema and partitions, and destroys it, the same\nlifecycle CDK gives any other resource. No custom resource, no Lambda,\nno \"`cdk deploy` and then run this SQL by hand\" two-step. Table\nchanges (new columns, renames, drops, new partition fields) land as\na reviewed diff in a pull request and apply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and PyPI\n(Python), pre-1.0, with a public surface guarded by an end-to-end\nconsumer test on every PR plus three real-AWS integration suites. The\nmulti-language packages are generated from one TypeScript source with\n[jsii](https://aws.github.io/jsii/) and indexed on\n[Construct Hub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the\n[`ksco92/arceus`](https://github.com/ksco92/arceus) monorepo, which\nalso holds a CDK demo app that dogfoods the construct against a real\nAWS 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 / 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- [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 everything 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 plus `list` / `map` / `struct` / `decimal` / `fixed` factories. Renders to the JSON shape 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`**, 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\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\" },\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### 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\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.\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- **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.** The `formatVersion` prop is read once at table creation; changing it later requires a destroy + recreate.\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- **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. The demo app in the [`arceus`](https://github.com/ksco92/arceus)\nrepo registers the tables with Lake Formation and queries them from\nAthena, including v2 merge-on-read `INSERT` / `UPDATE` / `DELETE` /\n`MERGE`, time travel, `OPTIMIZE`, and `VACUUM`. The construct's\n`grant*` helpers issue IAM grants; under Lake Formation you still add\nthe matching `SELECT` / `INSERT` LF grants. See [Granting\naccess](#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## 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://www.npmjs.com/package/cdk-glue-iceberg-table)\n[](https://github.com/ksco92/arceus/commits/main)\n[](https://github.com/ksco92/arceus/blob/main/LICENSE)\n\n**`cdk-glue-iceberg-table` is the AWS CDK L2 construct for creating\nand evolving Apache Iceberg tables in the AWS Glue Data Catalog.** It\nemits the exact `AWS::Glue::Table` / `OpenTableFormatInput` shape that\nsurvives a CloudFormation `Update`, so a single `cdk deploy` creates a\ntable, evolves its schema and partitions, and destroys it, the same\nlifecycle CDK gives any other resource. No custom resource, no Lambda,\nno \"`cdk deploy` and then run this SQL by hand\" two-step. Table\nchanges (new columns, renames, drops, new partition fields) land as\na reviewed diff in a pull request and apply through `cdk deploy`.\n\nStatus (October 2026): published on npm (TypeScript/JavaScript) and PyPI\n(Python), pre-1.0, with a public surface guarded by an end-to-end\nconsumer test on every PR plus three real-AWS integration suites. The\nmulti-language packages are generated from one TypeScript source with\n[jsii](https://aws.github.io/jsii/) and indexed on\n[Construct Hub](https://constructs.dev/packages/cdk-glue-iceberg-table).\nDeveloped in the\n[`ksco92/arceus`](https://github.com/ksco92/arceus) monorepo, which\nalso holds a CDK demo app that dogfoods the construct against a real\nAWS 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 / 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- [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 everything 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 (including the v3 `UNKNOWN`, `TIMESTAMP_NS`, `TIMESTAMPTZ_NS`, and `VARIANT`) plus `list` / `map` / `struct` / `decimal` / `fixed` / `geometry` / `geography` factories. Renders to the JSON shape 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`** (for `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\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\" },\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### 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\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.\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- **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.** The `formatVersion` prop is read once at table creation; changing it later requires a destroy + recreate.\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- **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. The demo app in the [`arceus`](https://github.com/ksco92/arceus)\nrepo registers the tables with Lake Formation and queries them from\nAthena, including v2 merge-on-read `INSERT` / `UPDATE` / `DELETE` /\n`MERGE`, time travel, `OPTIMIZE`, and `VACUUM`. The construct's\n`grant*` helpers issue IAM grants; under Lake Formation you still add\nthe matching `SELECT` / `INSERT` LF grants. See [Granting\naccess](#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## 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",
|
|
@@ -10067,6 +10067,53 @@
|
|
|
10067
10067
|
"name": "IcebergDataFormat",
|
|
10068
10068
|
"symbolId": "lib/iceberg/iceberg-table-properties:IcebergDataFormat"
|
|
10069
10069
|
},
|
|
10070
|
+
"cdk-glue-iceberg-table.IcebergEdgeAlgorithm": {
|
|
10071
|
+
"assembly": "cdk-glue-iceberg-table",
|
|
10072
|
+
"docs": {
|
|
10073
|
+
"stability": "experimental",
|
|
10074
|
+
"summary": "Edge-interpolation algorithm of a `geography` type."
|
|
10075
|
+
},
|
|
10076
|
+
"fqn": "cdk-glue-iceberg-table.IcebergEdgeAlgorithm",
|
|
10077
|
+
"kind": "enum",
|
|
10078
|
+
"locationInModule": {
|
|
10079
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
10080
|
+
"line": 58
|
|
10081
|
+
},
|
|
10082
|
+
"members": [
|
|
10083
|
+
{
|
|
10084
|
+
"docs": {
|
|
10085
|
+
"stability": "experimental"
|
|
10086
|
+
},
|
|
10087
|
+
"name": "SPHERICAL"
|
|
10088
|
+
},
|
|
10089
|
+
{
|
|
10090
|
+
"docs": {
|
|
10091
|
+
"stability": "experimental"
|
|
10092
|
+
},
|
|
10093
|
+
"name": "VINCENTY"
|
|
10094
|
+
},
|
|
10095
|
+
{
|
|
10096
|
+
"docs": {
|
|
10097
|
+
"stability": "experimental"
|
|
10098
|
+
},
|
|
10099
|
+
"name": "THOMAS"
|
|
10100
|
+
},
|
|
10101
|
+
{
|
|
10102
|
+
"docs": {
|
|
10103
|
+
"stability": "experimental"
|
|
10104
|
+
},
|
|
10105
|
+
"name": "ANDOYER"
|
|
10106
|
+
},
|
|
10107
|
+
{
|
|
10108
|
+
"docs": {
|
|
10109
|
+
"stability": "experimental"
|
|
10110
|
+
},
|
|
10111
|
+
"name": "KARNEY"
|
|
10112
|
+
}
|
|
10113
|
+
],
|
|
10114
|
+
"name": "IcebergEdgeAlgorithm",
|
|
10115
|
+
"symbolId": "lib/iceberg/iceberg-type:IcebergEdgeAlgorithm"
|
|
10116
|
+
},
|
|
10070
10117
|
"cdk-glue-iceberg-table.IcebergFormatVersion": {
|
|
10071
10118
|
"assembly": "cdk-glue-iceberg-table",
|
|
10072
10119
|
"docs": {
|
|
@@ -11008,7 +11055,7 @@
|
|
|
11008
11055
|
"kind": "interface",
|
|
11009
11056
|
"locationInModule": {
|
|
11010
11057
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11011
|
-
"line":
|
|
11058
|
+
"line": 70
|
|
11012
11059
|
},
|
|
11013
11060
|
"name": "IcebergStructFieldDefinition",
|
|
11014
11061
|
"properties": [
|
|
@@ -11021,7 +11068,7 @@
|
|
|
11021
11068
|
"immutable": true,
|
|
11022
11069
|
"locationInModule": {
|
|
11023
11070
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11024
|
-
"line":
|
|
11071
|
+
"line": 72
|
|
11025
11072
|
},
|
|
11026
11073
|
"name": "name",
|
|
11027
11074
|
"type": {
|
|
@@ -11037,7 +11084,7 @@
|
|
|
11037
11084
|
"immutable": true,
|
|
11038
11085
|
"locationInModule": {
|
|
11039
11086
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11040
|
-
"line":
|
|
11087
|
+
"line": 75
|
|
11041
11088
|
},
|
|
11042
11089
|
"name": "type",
|
|
11043
11090
|
"type": {
|
|
@@ -11053,7 +11100,7 @@
|
|
|
11053
11100
|
"immutable": true,
|
|
11054
11101
|
"locationInModule": {
|
|
11055
11102
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11056
|
-
"line":
|
|
11103
|
+
"line": 81
|
|
11057
11104
|
},
|
|
11058
11105
|
"name": "doc",
|
|
11059
11106
|
"optional": true,
|
|
@@ -11071,7 +11118,7 @@
|
|
|
11071
11118
|
"immutable": true,
|
|
11072
11119
|
"locationInModule": {
|
|
11073
11120
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11074
|
-
"line":
|
|
11121
|
+
"line": 78
|
|
11075
11122
|
},
|
|
11076
11123
|
"name": "required",
|
|
11077
11124
|
"optional": true,
|
|
@@ -11678,7 +11725,7 @@
|
|
|
11678
11725
|
"cdk-glue-iceberg-table.IcebergType": {
|
|
11679
11726
|
"assembly": "cdk-glue-iceberg-table",
|
|
11680
11727
|
"docs": {
|
|
11681
|
-
"remarks": "Use the static factories on this class to construct\nprimitives, decimals, fixed, lists, maps, and structs.",
|
|
11728
|
+
"remarks": "Use the static factories on this class to construct\nprimitives, decimals, fixed, geospatial types, lists, maps, and structs.",
|
|
11682
11729
|
"stability": "experimental",
|
|
11683
11730
|
"summary": "Iceberg type."
|
|
11684
11731
|
},
|
|
@@ -11689,7 +11736,7 @@
|
|
|
11689
11736
|
},
|
|
11690
11737
|
"locationInModule": {
|
|
11691
11738
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11692
|
-
"line":
|
|
11739
|
+
"line": 340
|
|
11693
11740
|
},
|
|
11694
11741
|
"parameters": [
|
|
11695
11742
|
{
|
|
@@ -11703,7 +11750,7 @@
|
|
|
11703
11750
|
"kind": "class",
|
|
11704
11751
|
"locationInModule": {
|
|
11705
11752
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11706
|
-
"line":
|
|
11753
|
+
"line": 134
|
|
11707
11754
|
},
|
|
11708
11755
|
"methods": [
|
|
11709
11756
|
{
|
|
@@ -11713,7 +11760,7 @@
|
|
|
11713
11760
|
},
|
|
11714
11761
|
"locationInModule": {
|
|
11715
11762
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11716
|
-
"line":
|
|
11763
|
+
"line": 222
|
|
11717
11764
|
},
|
|
11718
11765
|
"name": "decimal",
|
|
11719
11766
|
"parameters": [
|
|
@@ -11750,7 +11797,7 @@
|
|
|
11750
11797
|
},
|
|
11751
11798
|
"locationInModule": {
|
|
11752
11799
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11753
|
-
"line":
|
|
11800
|
+
"line": 234
|
|
11754
11801
|
},
|
|
11755
11802
|
"name": "fixed",
|
|
11756
11803
|
"parameters": [
|
|
@@ -11771,6 +11818,79 @@
|
|
|
11771
11818
|
},
|
|
11772
11819
|
"static": true
|
|
11773
11820
|
},
|
|
11821
|
+
{
|
|
11822
|
+
"docs": {
|
|
11823
|
+
"remarks": "Format v3.",
|
|
11824
|
+
"stability": "experimental",
|
|
11825
|
+
"summary": "Geospatial features with edges interpolated by an algorithm."
|
|
11826
|
+
},
|
|
11827
|
+
"locationInModule": {
|
|
11828
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11829
|
+
"line": 296
|
|
11830
|
+
},
|
|
11831
|
+
"name": "geography",
|
|
11832
|
+
"parameters": [
|
|
11833
|
+
{
|
|
11834
|
+
"docs": {
|
|
11835
|
+
"remarks": "Defaults to `OGC:CRS84`.",
|
|
11836
|
+
"summary": "Coordinate reference system identifier."
|
|
11837
|
+
},
|
|
11838
|
+
"name": "crs",
|
|
11839
|
+
"optional": true,
|
|
11840
|
+
"type": {
|
|
11841
|
+
"primitive": "string"
|
|
11842
|
+
}
|
|
11843
|
+
},
|
|
11844
|
+
{
|
|
11845
|
+
"docs": {
|
|
11846
|
+
"remarks": "Defaults to `SPHERICAL`.",
|
|
11847
|
+
"summary": "Edge-interpolation algorithm."
|
|
11848
|
+
},
|
|
11849
|
+
"name": "algorithm",
|
|
11850
|
+
"optional": true,
|
|
11851
|
+
"type": {
|
|
11852
|
+
"fqn": "cdk-glue-iceberg-table.IcebergEdgeAlgorithm"
|
|
11853
|
+
}
|
|
11854
|
+
}
|
|
11855
|
+
],
|
|
11856
|
+
"returns": {
|
|
11857
|
+
"type": {
|
|
11858
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
11859
|
+
}
|
|
11860
|
+
},
|
|
11861
|
+
"static": true
|
|
11862
|
+
},
|
|
11863
|
+
{
|
|
11864
|
+
"docs": {
|
|
11865
|
+
"remarks": "Format v3.",
|
|
11866
|
+
"stability": "experimental",
|
|
11867
|
+
"summary": "Geospatial features with linear edges."
|
|
11868
|
+
},
|
|
11869
|
+
"locationInModule": {
|
|
11870
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11871
|
+
"line": 284
|
|
11872
|
+
},
|
|
11873
|
+
"name": "geometry",
|
|
11874
|
+
"parameters": [
|
|
11875
|
+
{
|
|
11876
|
+
"docs": {
|
|
11877
|
+
"remarks": "Defaults to `OGC:CRS84`.",
|
|
11878
|
+
"summary": "Coordinate reference system identifier, such as `EPSG:3857`."
|
|
11879
|
+
},
|
|
11880
|
+
"name": "crs",
|
|
11881
|
+
"optional": true,
|
|
11882
|
+
"type": {
|
|
11883
|
+
"primitive": "string"
|
|
11884
|
+
}
|
|
11885
|
+
}
|
|
11886
|
+
],
|
|
11887
|
+
"returns": {
|
|
11888
|
+
"type": {
|
|
11889
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
11890
|
+
}
|
|
11891
|
+
},
|
|
11892
|
+
"static": true
|
|
11893
|
+
},
|
|
11774
11894
|
{
|
|
11775
11895
|
"docs": {
|
|
11776
11896
|
"stability": "experimental",
|
|
@@ -11778,7 +11898,7 @@
|
|
|
11778
11898
|
},
|
|
11779
11899
|
"locationInModule": {
|
|
11780
11900
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11781
|
-
"line":
|
|
11901
|
+
"line": 246
|
|
11782
11902
|
},
|
|
11783
11903
|
"name": "list",
|
|
11784
11904
|
"parameters": [
|
|
@@ -11818,7 +11938,7 @@
|
|
|
11818
11938
|
},
|
|
11819
11939
|
"locationInModule": {
|
|
11820
11940
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11821
|
-
"line":
|
|
11941
|
+
"line": 260
|
|
11822
11942
|
},
|
|
11823
11943
|
"name": "map",
|
|
11824
11944
|
"parameters": [
|
|
@@ -11866,7 +11986,7 @@
|
|
|
11866
11986
|
},
|
|
11867
11987
|
"locationInModule": {
|
|
11868
11988
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11869
|
-
"line":
|
|
11989
|
+
"line": 273
|
|
11870
11990
|
},
|
|
11871
11991
|
"name": "struct",
|
|
11872
11992
|
"parameters": [
|
|
@@ -11899,7 +12019,7 @@
|
|
|
11899
12019
|
},
|
|
11900
12020
|
"locationInModule": {
|
|
11901
12021
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11902
|
-
"line":
|
|
12022
|
+
"line": 547
|
|
11903
12023
|
},
|
|
11904
12024
|
"name": "isDecimal",
|
|
11905
12025
|
"returns": {
|
|
@@ -11915,7 +12035,7 @@
|
|
|
11915
12035
|
},
|
|
11916
12036
|
"locationInModule": {
|
|
11917
12037
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11918
|
-
"line":
|
|
12038
|
+
"line": 552
|
|
11919
12039
|
},
|
|
11920
12040
|
"name": "isFixed",
|
|
11921
12041
|
"returns": {
|
|
@@ -11931,7 +12051,7 @@
|
|
|
11931
12051
|
},
|
|
11932
12052
|
"locationInModule": {
|
|
11933
12053
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11934
|
-
"line":
|
|
12054
|
+
"line": 542
|
|
11935
12055
|
},
|
|
11936
12056
|
"name": "isPrimitive",
|
|
11937
12057
|
"parameters": [
|
|
@@ -11960,7 +12080,7 @@
|
|
|
11960
12080
|
"immutable": true,
|
|
11961
12081
|
"locationInModule": {
|
|
11962
12082
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11963
|
-
"line":
|
|
12083
|
+
"line": 193
|
|
11964
12084
|
},
|
|
11965
12085
|
"name": "BINARY",
|
|
11966
12086
|
"static": true,
|
|
@@ -11977,7 +12097,7 @@
|
|
|
11977
12097
|
"immutable": true,
|
|
11978
12098
|
"locationInModule": {
|
|
11979
12099
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11980
|
-
"line":
|
|
12100
|
+
"line": 138
|
|
11981
12101
|
},
|
|
11982
12102
|
"name": "BOOLEAN",
|
|
11983
12103
|
"static": true,
|
|
@@ -11994,7 +12114,7 @@
|
|
|
11994
12114
|
"immutable": true,
|
|
11995
12115
|
"locationInModule": {
|
|
11996
12116
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
11997
|
-
"line":
|
|
12117
|
+
"line": 163
|
|
11998
12118
|
},
|
|
11999
12119
|
"name": "DATE",
|
|
12000
12120
|
"static": true,
|
|
@@ -12011,7 +12131,7 @@
|
|
|
12011
12131
|
"immutable": true,
|
|
12012
12132
|
"locationInModule": {
|
|
12013
12133
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12014
|
-
"line":
|
|
12134
|
+
"line": 158
|
|
12015
12135
|
},
|
|
12016
12136
|
"name": "DOUBLE",
|
|
12017
12137
|
"static": true,
|
|
@@ -12028,7 +12148,7 @@
|
|
|
12028
12148
|
"immutable": true,
|
|
12029
12149
|
"locationInModule": {
|
|
12030
12150
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12031
|
-
"line":
|
|
12151
|
+
"line": 153
|
|
12032
12152
|
},
|
|
12033
12153
|
"name": "FLOAT",
|
|
12034
12154
|
"static": true,
|
|
@@ -12045,7 +12165,7 @@
|
|
|
12045
12165
|
"immutable": true,
|
|
12046
12166
|
"locationInModule": {
|
|
12047
12167
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12048
|
-
"line":
|
|
12168
|
+
"line": 143
|
|
12049
12169
|
},
|
|
12050
12170
|
"name": "INT",
|
|
12051
12171
|
"static": true,
|
|
@@ -12062,7 +12182,7 @@
|
|
|
12062
12182
|
"immutable": true,
|
|
12063
12183
|
"locationInModule": {
|
|
12064
12184
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12065
|
-
"line":
|
|
12185
|
+
"line": 148
|
|
12066
12186
|
},
|
|
12067
12187
|
"name": "LONG",
|
|
12068
12188
|
"static": true,
|
|
@@ -12079,7 +12199,7 @@
|
|
|
12079
12199
|
"immutable": true,
|
|
12080
12200
|
"locationInModule": {
|
|
12081
12201
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12082
|
-
"line":
|
|
12202
|
+
"line": 183
|
|
12083
12203
|
},
|
|
12084
12204
|
"name": "STRING",
|
|
12085
12205
|
"static": true,
|
|
@@ -12096,7 +12216,7 @@
|
|
|
12096
12216
|
"immutable": true,
|
|
12097
12217
|
"locationInModule": {
|
|
12098
12218
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12099
|
-
"line":
|
|
12219
|
+
"line": 168
|
|
12100
12220
|
},
|
|
12101
12221
|
"name": "TIME",
|
|
12102
12222
|
"static": true,
|
|
@@ -12113,7 +12233,7 @@
|
|
|
12113
12233
|
"immutable": true,
|
|
12114
12234
|
"locationInModule": {
|
|
12115
12235
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12116
|
-
"line":
|
|
12236
|
+
"line": 173
|
|
12117
12237
|
},
|
|
12118
12238
|
"name": "TIMESTAMP",
|
|
12119
12239
|
"static": true,
|
|
@@ -12121,6 +12241,24 @@
|
|
|
12121
12241
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12122
12242
|
}
|
|
12123
12243
|
},
|
|
12244
|
+
{
|
|
12245
|
+
"const": true,
|
|
12246
|
+
"docs": {
|
|
12247
|
+
"remarks": "Format v3.",
|
|
12248
|
+
"stability": "experimental",
|
|
12249
|
+
"summary": "Nanosecond-precision timestamp without zone."
|
|
12250
|
+
},
|
|
12251
|
+
"immutable": true,
|
|
12252
|
+
"locationInModule": {
|
|
12253
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12254
|
+
"line": 203
|
|
12255
|
+
},
|
|
12256
|
+
"name": "TIMESTAMP_NS",
|
|
12257
|
+
"static": true,
|
|
12258
|
+
"type": {
|
|
12259
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12260
|
+
}
|
|
12261
|
+
},
|
|
12124
12262
|
{
|
|
12125
12263
|
"const": true,
|
|
12126
12264
|
"docs": {
|
|
@@ -12130,7 +12268,7 @@
|
|
|
12130
12268
|
"immutable": true,
|
|
12131
12269
|
"locationInModule": {
|
|
12132
12270
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12133
|
-
"line":
|
|
12271
|
+
"line": 178
|
|
12134
12272
|
},
|
|
12135
12273
|
"name": "TIMESTAMPTZ",
|
|
12136
12274
|
"static": true,
|
|
@@ -12138,6 +12276,42 @@
|
|
|
12138
12276
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12139
12277
|
}
|
|
12140
12278
|
},
|
|
12279
|
+
{
|
|
12280
|
+
"const": true,
|
|
12281
|
+
"docs": {
|
|
12282
|
+
"remarks": "Format v3.",
|
|
12283
|
+
"stability": "experimental",
|
|
12284
|
+
"summary": "Nanosecond-precision timestamp stored as UTC."
|
|
12285
|
+
},
|
|
12286
|
+
"immutable": true,
|
|
12287
|
+
"locationInModule": {
|
|
12288
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12289
|
+
"line": 208
|
|
12290
|
+
},
|
|
12291
|
+
"name": "TIMESTAMPTZ_NS",
|
|
12292
|
+
"static": true,
|
|
12293
|
+
"type": {
|
|
12294
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12295
|
+
}
|
|
12296
|
+
},
|
|
12297
|
+
{
|
|
12298
|
+
"const": true,
|
|
12299
|
+
"docs": {
|
|
12300
|
+
"remarks": "Format v3; never required.",
|
|
12301
|
+
"stability": "experimental",
|
|
12302
|
+
"summary": "Type of a column whose values are always null."
|
|
12303
|
+
},
|
|
12304
|
+
"immutable": true,
|
|
12305
|
+
"locationInModule": {
|
|
12306
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12307
|
+
"line": 198
|
|
12308
|
+
},
|
|
12309
|
+
"name": "UNKNOWN",
|
|
12310
|
+
"static": true,
|
|
12311
|
+
"type": {
|
|
12312
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12313
|
+
}
|
|
12314
|
+
},
|
|
12141
12315
|
{
|
|
12142
12316
|
"const": true,
|
|
12143
12317
|
"docs": {
|
|
@@ -12147,7 +12321,7 @@
|
|
|
12147
12321
|
"immutable": true,
|
|
12148
12322
|
"locationInModule": {
|
|
12149
12323
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12150
|
-
"line":
|
|
12324
|
+
"line": 188
|
|
12151
12325
|
},
|
|
12152
12326
|
"name": "UUID",
|
|
12153
12327
|
"static": true,
|
|
@@ -12155,6 +12329,24 @@
|
|
|
12155
12329
|
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12156
12330
|
}
|
|
12157
12331
|
},
|
|
12332
|
+
{
|
|
12333
|
+
"const": true,
|
|
12334
|
+
"docs": {
|
|
12335
|
+
"remarks": "Format v3.",
|
|
12336
|
+
"stability": "experimental",
|
|
12337
|
+
"summary": "Semi-structured value: an object, an array, or a primitive."
|
|
12338
|
+
},
|
|
12339
|
+
"immutable": true,
|
|
12340
|
+
"locationInModule": {
|
|
12341
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12342
|
+
"line": 213
|
|
12343
|
+
},
|
|
12344
|
+
"name": "VARIANT",
|
|
12345
|
+
"static": true,
|
|
12346
|
+
"type": {
|
|
12347
|
+
"fqn": "cdk-glue-iceberg-table.IcebergType"
|
|
12348
|
+
}
|
|
12349
|
+
},
|
|
12158
12350
|
{
|
|
12159
12351
|
"docs": {
|
|
12160
12352
|
"stability": "experimental",
|
|
@@ -12163,7 +12355,7 @@
|
|
|
12163
12355
|
"immutable": true,
|
|
12164
12356
|
"locationInModule": {
|
|
12165
12357
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12166
|
-
"line":
|
|
12358
|
+
"line": 305
|
|
12167
12359
|
},
|
|
12168
12360
|
"name": "kind",
|
|
12169
12361
|
"type": {
|
|
@@ -12178,7 +12370,7 @@
|
|
|
12178
12370
|
"immutable": true,
|
|
12179
12371
|
"locationInModule": {
|
|
12180
12372
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12181
|
-
"line":
|
|
12373
|
+
"line": 308
|
|
12182
12374
|
},
|
|
12183
12375
|
"name": "decimalPrecision",
|
|
12184
12376
|
"optional": true,
|
|
@@ -12194,7 +12386,7 @@
|
|
|
12194
12386
|
"immutable": true,
|
|
12195
12387
|
"locationInModule": {
|
|
12196
12388
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12197
|
-
"line":
|
|
12389
|
+
"line": 311
|
|
12198
12390
|
},
|
|
12199
12391
|
"name": "decimalScale",
|
|
12200
12392
|
"optional": true,
|
|
@@ -12210,7 +12402,7 @@
|
|
|
12210
12402
|
"immutable": true,
|
|
12211
12403
|
"locationInModule": {
|
|
12212
12404
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12213
|
-
"line":
|
|
12405
|
+
"line": 314
|
|
12214
12406
|
},
|
|
12215
12407
|
"name": "fixedLength",
|
|
12216
12408
|
"optional": true,
|
|
@@ -12218,6 +12410,38 @@
|
|
|
12218
12410
|
"primitive": "number"
|
|
12219
12411
|
}
|
|
12220
12412
|
},
|
|
12413
|
+
{
|
|
12414
|
+
"docs": {
|
|
12415
|
+
"stability": "experimental",
|
|
12416
|
+
"summary": "Coordinate reference system (set when `kind` is `GEOMETRY` or `GEOGRAPHY` and one was given)."
|
|
12417
|
+
},
|
|
12418
|
+
"immutable": true,
|
|
12419
|
+
"locationInModule": {
|
|
12420
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12421
|
+
"line": 335
|
|
12422
|
+
},
|
|
12423
|
+
"name": "geoCrs",
|
|
12424
|
+
"optional": true,
|
|
12425
|
+
"type": {
|
|
12426
|
+
"primitive": "string"
|
|
12427
|
+
}
|
|
12428
|
+
},
|
|
12429
|
+
{
|
|
12430
|
+
"docs": {
|
|
12431
|
+
"stability": "experimental",
|
|
12432
|
+
"summary": "Edge-interpolation algorithm (set when one was given)."
|
|
12433
|
+
},
|
|
12434
|
+
"immutable": true,
|
|
12435
|
+
"locationInModule": {
|
|
12436
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12437
|
+
"line": 338
|
|
12438
|
+
},
|
|
12439
|
+
"name": "geographyAlgorithm",
|
|
12440
|
+
"optional": true,
|
|
12441
|
+
"type": {
|
|
12442
|
+
"fqn": "cdk-glue-iceberg-table.IcebergEdgeAlgorithm"
|
|
12443
|
+
}
|
|
12444
|
+
},
|
|
12221
12445
|
{
|
|
12222
12446
|
"docs": {
|
|
12223
12447
|
"stability": "experimental",
|
|
@@ -12226,7 +12450,7 @@
|
|
|
12226
12450
|
"immutable": true,
|
|
12227
12451
|
"locationInModule": {
|
|
12228
12452
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12229
|
-
"line":
|
|
12453
|
+
"line": 317
|
|
12230
12454
|
},
|
|
12231
12455
|
"name": "listElement",
|
|
12232
12456
|
"optional": true,
|
|
@@ -12242,7 +12466,7 @@
|
|
|
12242
12466
|
"immutable": true,
|
|
12243
12467
|
"locationInModule": {
|
|
12244
12468
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12245
|
-
"line":
|
|
12469
|
+
"line": 320
|
|
12246
12470
|
},
|
|
12247
12471
|
"name": "listElementRequired",
|
|
12248
12472
|
"optional": true,
|
|
@@ -12258,7 +12482,7 @@
|
|
|
12258
12482
|
"immutable": true,
|
|
12259
12483
|
"locationInModule": {
|
|
12260
12484
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12261
|
-
"line":
|
|
12485
|
+
"line": 323
|
|
12262
12486
|
},
|
|
12263
12487
|
"name": "mapKey",
|
|
12264
12488
|
"optional": true,
|
|
@@ -12274,7 +12498,7 @@
|
|
|
12274
12498
|
"immutable": true,
|
|
12275
12499
|
"locationInModule": {
|
|
12276
12500
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12277
|
-
"line":
|
|
12501
|
+
"line": 326
|
|
12278
12502
|
},
|
|
12279
12503
|
"name": "mapValue",
|
|
12280
12504
|
"optional": true,
|
|
@@ -12290,7 +12514,7 @@
|
|
|
12290
12514
|
"immutable": true,
|
|
12291
12515
|
"locationInModule": {
|
|
12292
12516
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12293
|
-
"line":
|
|
12517
|
+
"line": 329
|
|
12294
12518
|
},
|
|
12295
12519
|
"name": "mapValueRequired",
|
|
12296
12520
|
"optional": true,
|
|
@@ -12306,7 +12530,7 @@
|
|
|
12306
12530
|
"immutable": true,
|
|
12307
12531
|
"locationInModule": {
|
|
12308
12532
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12309
|
-
"line":
|
|
12533
|
+
"line": 332
|
|
12310
12534
|
},
|
|
12311
12535
|
"name": "structFields",
|
|
12312
12536
|
"optional": true,
|
|
@@ -12436,6 +12660,42 @@
|
|
|
12436
12660
|
"stability": "experimental"
|
|
12437
12661
|
},
|
|
12438
12662
|
"name": "STRUCT"
|
|
12663
|
+
},
|
|
12664
|
+
{
|
|
12665
|
+
"docs": {
|
|
12666
|
+
"stability": "experimental"
|
|
12667
|
+
},
|
|
12668
|
+
"name": "UNKNOWN"
|
|
12669
|
+
},
|
|
12670
|
+
{
|
|
12671
|
+
"docs": {
|
|
12672
|
+
"stability": "experimental"
|
|
12673
|
+
},
|
|
12674
|
+
"name": "TIMESTAMP_NS"
|
|
12675
|
+
},
|
|
12676
|
+
{
|
|
12677
|
+
"docs": {
|
|
12678
|
+
"stability": "experimental"
|
|
12679
|
+
},
|
|
12680
|
+
"name": "TIMESTAMPTZ_NS"
|
|
12681
|
+
},
|
|
12682
|
+
{
|
|
12683
|
+
"docs": {
|
|
12684
|
+
"stability": "experimental"
|
|
12685
|
+
},
|
|
12686
|
+
"name": "VARIANT"
|
|
12687
|
+
},
|
|
12688
|
+
{
|
|
12689
|
+
"docs": {
|
|
12690
|
+
"stability": "experimental"
|
|
12691
|
+
},
|
|
12692
|
+
"name": "GEOMETRY"
|
|
12693
|
+
},
|
|
12694
|
+
{
|
|
12695
|
+
"docs": {
|
|
12696
|
+
"stability": "experimental"
|
|
12697
|
+
},
|
|
12698
|
+
"name": "GEOGRAPHY"
|
|
12439
12699
|
}
|
|
12440
12700
|
],
|
|
12441
12701
|
"name": "IcebergTypeKind",
|
|
@@ -12453,7 +12713,7 @@
|
|
|
12453
12713
|
"kind": "interface",
|
|
12454
12714
|
"locationInModule": {
|
|
12455
12715
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12456
|
-
"line":
|
|
12716
|
+
"line": 92
|
|
12457
12717
|
},
|
|
12458
12718
|
"name": "IcebergTypeOptions",
|
|
12459
12719
|
"properties": [
|
|
@@ -12466,7 +12726,7 @@
|
|
|
12466
12726
|
"immutable": true,
|
|
12467
12727
|
"locationInModule": {
|
|
12468
12728
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12469
|
-
"line":
|
|
12729
|
+
"line": 94
|
|
12470
12730
|
},
|
|
12471
12731
|
"name": "kind",
|
|
12472
12732
|
"type": {
|
|
@@ -12482,7 +12742,7 @@
|
|
|
12482
12742
|
"immutable": true,
|
|
12483
12743
|
"locationInModule": {
|
|
12484
12744
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12485
|
-
"line":
|
|
12745
|
+
"line": 97
|
|
12486
12746
|
},
|
|
12487
12747
|
"name": "decimalPrecision",
|
|
12488
12748
|
"optional": true,
|
|
@@ -12499,7 +12759,7 @@
|
|
|
12499
12759
|
"immutable": true,
|
|
12500
12760
|
"locationInModule": {
|
|
12501
12761
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12502
|
-
"line":
|
|
12762
|
+
"line": 100
|
|
12503
12763
|
},
|
|
12504
12764
|
"name": "decimalScale",
|
|
12505
12765
|
"optional": true,
|
|
@@ -12517,7 +12777,7 @@
|
|
|
12517
12777
|
"immutable": true,
|
|
12518
12778
|
"locationInModule": {
|
|
12519
12779
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12520
|
-
"line":
|
|
12780
|
+
"line": 103
|
|
12521
12781
|
},
|
|
12522
12782
|
"name": "fixedLength",
|
|
12523
12783
|
"optional": true,
|
|
@@ -12525,6 +12785,42 @@
|
|
|
12525
12785
|
"primitive": "number"
|
|
12526
12786
|
}
|
|
12527
12787
|
},
|
|
12788
|
+
{
|
|
12789
|
+
"abstract": true,
|
|
12790
|
+
"docs": {
|
|
12791
|
+
"remarks": "Optional when `kind` is `GEOMETRY` or `GEOGRAPHY`.",
|
|
12792
|
+
"stability": "experimental",
|
|
12793
|
+
"summary": "Coordinate reference system identifier."
|
|
12794
|
+
},
|
|
12795
|
+
"immutable": true,
|
|
12796
|
+
"locationInModule": {
|
|
12797
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12798
|
+
"line": 124
|
|
12799
|
+
},
|
|
12800
|
+
"name": "geoCrs",
|
|
12801
|
+
"optional": true,
|
|
12802
|
+
"type": {
|
|
12803
|
+
"primitive": "string"
|
|
12804
|
+
}
|
|
12805
|
+
},
|
|
12806
|
+
{
|
|
12807
|
+
"abstract": true,
|
|
12808
|
+
"docs": {
|
|
12809
|
+
"remarks": "Optional when `kind === GEOGRAPHY`.",
|
|
12810
|
+
"stability": "experimental",
|
|
12811
|
+
"summary": "Edge-interpolation algorithm."
|
|
12812
|
+
},
|
|
12813
|
+
"immutable": true,
|
|
12814
|
+
"locationInModule": {
|
|
12815
|
+
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12816
|
+
"line": 127
|
|
12817
|
+
},
|
|
12818
|
+
"name": "geographyAlgorithm",
|
|
12819
|
+
"optional": true,
|
|
12820
|
+
"type": {
|
|
12821
|
+
"fqn": "cdk-glue-iceberg-table.IcebergEdgeAlgorithm"
|
|
12822
|
+
}
|
|
12823
|
+
},
|
|
12528
12824
|
{
|
|
12529
12825
|
"abstract": true,
|
|
12530
12826
|
"docs": {
|
|
@@ -12535,7 +12831,7 @@
|
|
|
12535
12831
|
"immutable": true,
|
|
12536
12832
|
"locationInModule": {
|
|
12537
12833
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12538
|
-
"line":
|
|
12834
|
+
"line": 106
|
|
12539
12835
|
},
|
|
12540
12836
|
"name": "listElement",
|
|
12541
12837
|
"optional": true,
|
|
@@ -12553,7 +12849,7 @@
|
|
|
12553
12849
|
"immutable": true,
|
|
12554
12850
|
"locationInModule": {
|
|
12555
12851
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12556
|
-
"line":
|
|
12852
|
+
"line": 109
|
|
12557
12853
|
},
|
|
12558
12854
|
"name": "listElementRequired",
|
|
12559
12855
|
"optional": true,
|
|
@@ -12571,7 +12867,7 @@
|
|
|
12571
12867
|
"immutable": true,
|
|
12572
12868
|
"locationInModule": {
|
|
12573
12869
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12574
|
-
"line":
|
|
12870
|
+
"line": 112
|
|
12575
12871
|
},
|
|
12576
12872
|
"name": "mapKey",
|
|
12577
12873
|
"optional": true,
|
|
@@ -12589,7 +12885,7 @@
|
|
|
12589
12885
|
"immutable": true,
|
|
12590
12886
|
"locationInModule": {
|
|
12591
12887
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12592
|
-
"line":
|
|
12888
|
+
"line": 115
|
|
12593
12889
|
},
|
|
12594
12890
|
"name": "mapValue",
|
|
12595
12891
|
"optional": true,
|
|
@@ -12607,7 +12903,7 @@
|
|
|
12607
12903
|
"immutable": true,
|
|
12608
12904
|
"locationInModule": {
|
|
12609
12905
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12610
|
-
"line":
|
|
12906
|
+
"line": 118
|
|
12611
12907
|
},
|
|
12612
12908
|
"name": "mapValueRequired",
|
|
12613
12909
|
"optional": true,
|
|
@@ -12625,7 +12921,7 @@
|
|
|
12625
12921
|
"immutable": true,
|
|
12626
12922
|
"locationInModule": {
|
|
12627
12923
|
"filename": "lib/iceberg/iceberg-type.ts",
|
|
12628
|
-
"line":
|
|
12924
|
+
"line": 121
|
|
12629
12925
|
},
|
|
12630
12926
|
"name": "structFields",
|
|
12631
12927
|
"optional": true,
|
|
@@ -12642,6 +12938,6 @@
|
|
|
12642
12938
|
"symbolId": "lib/iceberg/iceberg-type:IcebergTypeOptions"
|
|
12643
12939
|
}
|
|
12644
12940
|
},
|
|
12645
|
-
"version": "0.
|
|
12646
|
-
"fingerprint": "
|
|
12941
|
+
"version": "0.9.0",
|
|
12942
|
+
"fingerprint": "w78Lq+tpvw/XUnrkSpn/0T9r4++rJIOW4IGbKhXpH6Y="
|
|
12647
12943
|
}
|