@aws-cdk/aws-glue-alpha 2.266.0-alpha.0 → 2.267.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.266.0",
+    "aws-cdk-lib": "^2.267.0",
     "constructs": "^10.5.0"
   },
   "dependencyClosure": {
@@ -9409,7 +9409,7 @@
   },
   "name": "@aws-cdk/aws-glue-alpha",
   "readme": {
-    "markdown": "# AWS Glue Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.\n\n## README\n\n[AWS Glue](https://aws.amazon.com/glue/) is a serverless data integration\nservice that makes it easier to discover, prepare, move, and integrate data\nfrom multiple sources for analytics, machine learning (ML), and application\ndevelopment.\n\nThe Glue L2 construct has convenience methods working backwards from common\nuse cases and sets required parameters to defaults that align with recommended\nbest practices for each job type. It also provides customers with a balance\nbetween flexibility via optional parameter overrides, and opinionated\ninterfaces that discouraging anti-patterns, resulting in reduced time to develop\nand deploy new resources.\n\n### References\n\n* [Glue Launch Announcement](https://aws.amazon.com/blogs/aws/launch-aws-glue-now-generally-available/)\n* [Glue Documentation](https://docs.aws.amazon.com/glue/index.html)\n* [Glue L1 (CloudFormation) Constructs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Glue.html)\n* Prior version of the [@aws-cdk/aws-glue-alpha module](https://github.com/aws/aws-cdk/blob/v2.51.1/packages/%40aws-cdk/aws-glue/README.md)\n\n## Create a Glue Job\n\nA Job encapsulates a script that connects to data sources, processes\nthem, and then writes output to a data target. There are four types of Glue\nJobs: Spark (ETL and Streaming), Python Shell, and Flex Jobs. Most\nof the required parameters for these jobs are common across all types,\nbut there are a few differences depending on the languages supported\nand features provided by each type. For all job types, the L2 defaults\nto AWS best practice recommendations, such as:\n\n* Use of Secrets Manager for Connection JDBC strings\n* Glue job autoscaling\n* Default parameter values for Glue job creation\n\nThis iteration of the L2 construct introduces breaking changes to\nthe existing glue-alpha-module, but these changes streamline the developer\nexperience, introduce new constants for defaults, and replacing synth-time\nvalidations with interface contracts for enforcement of the parameter combinations\nthat Glue supports. As an opinionated construct, the Glue L2 construct does\nnot allow developers to create resources that use non-current versions\nof Glue or deprecated language dependencies (e.g. deprecated versions of Python).\nAs always, L1s allow you to specify a wider range of parameters if you need\nor want to use alternative configurations.\n\nOptional and required parameters for each job are enforced via interface\nrather than validation; see [Glue's public documentation](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api.html)\nfor more granular details.\n\n### Spark Jobs\n\n#### ETL Jobs\n\nETL jobs support pySpark and Scala languages, for which there are separate but\nsimilar constructors. ETL jobs default to the G2 worker type, but you can\noverride this default with other supported worker type values (G1, G2, G4\nand G8). ETL jobs defaults to Glue version 4.0, which you can override to 3.0.\nThe following ETL features are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log.`\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\nYou can find more details about version, worker type and other features in\n[Glue's public documentation](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html).\n\nReference the pyspark-etl-jobs.test.ts and scalaspark-etl-jobs.test.ts unit tests\nfor examples of required-only and optional job parameters when creating these\ntypes of jobs.\n\nFor the sake of brevity, examples are shown using the pySpark job variety.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  role,\n  script,\n  jobName: 'PySparkETLJob',\n});\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  jobName: 'PySparkETLJobCustomName',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n#### Streaming Jobs\n\nStreaming jobs are similar to ETL jobs, except that they perform ETL on data\nstreams using the Apache Spark Structured Streaming framework. Some Spark\njob features are not available to Streaming ETL jobs. They support Scala\nand pySpark languages. PySpark streaming jobs run on Python 3. It\ndefaults to the G2 worker type and Glue 4.0, both of which you can override.\nThe following best practice features are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log`.\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\n\nReference the pyspark-streaming-jobs.test.ts and scalaspark-streaming-jobs.test.ts\nunit tests for examples of required-only and optional job parameters when creating\nthese types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkStreamingJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkStreamingJob(stack, 'PySparkStreamingJob', {\n  jobName: 'PySparkStreamingJobCustomName',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n#### Flex Jobs\n\nThe flexible execution class is appropriate for non-urgent jobs such as\npre-production jobs, testing, and one-time data loads. Flexible jobs default\nto Glue version 5.0 and worker type `G_2X`. The following best practice\nfeatures are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log`\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\n\nReference the pyspark-flex-etl-jobs.test.ts and scalaspark-flex-etl-jobs.test.ts\nunit tests for examples of required-only and optional job parameters when creating\nthese types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkFlexEtlJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkFlexEtlJob(stack, 'pySparkFlexEtlJob', {\n  jobName: 'pySparkFlexEtlJob',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n### Python Shell Jobs\n\nPython shell jobs support a Python version that depends on the AWS Glue\nversion you use. These can be used to schedule and run tasks that don't\nrequire an Apache Spark environment. Python shell jobs default to\nPython 3.9 and a MaxCapacity of `0.0625`. Python 3.9 supports pre-loaded\nanalytics libraries using the `library-set=analytics` flag, which is\nenabled by default.\n\nReference the pyspark-shell-job.test.ts unit tests for examples of\nrequired-only and optional job parameters when creating these types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PythonShellJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\ndeclare const extraPythonFile: glue.Code;\nnew glue.PythonShellJob(stack, 'PythonShellJob', {\n  jobName: 'PythonShellJobCustomName',\n  description: 'This is a description',\n  pythonVersion: glue.PythonVersion.THREE_NINE,\n  maxCapacity: glue.MaxCapacity.DPU_1,\n  role,\n  script,\n  extraPythonFiles: [extraPythonFile],\n  glueVersion: glue.GlueVersion.V3_0,\n  continuousLogging: { enabled: false },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n### Ray Jobs\n\n> **⚠️ DEPRECATED:** AWS Glue for Ray is closed to new customers as of April 30, 2026 and is in maintenance mode.\n> Migrate to [Amazon EKS with KubeRay Operator](https://docs.aws.amazon.com/glue/latest/dg/awsglue-ray-jobs-availability-change.html).\n\nThe `RayJob` construct, `Runtime.RAY_TWO_FOUR`, and `JobType.RAY` are deprecated and will be removed in a future release.\n\n### Metrics Control\n\nBy default, Glue jobs enable CloudWatch metrics (`--enable-metrics`) and observability metrics (`--enable-observability-metrics`) for monitoring and debugging. You can disable these metrics to reduce CloudWatch costs:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\n\n// Disable both metrics for cost optimization\nnew glue.PySparkEtlJob(stack, 'CostOptimizedJob', {\n  role,\n  script,\n  enableMetrics: false,\n  enableObservabilityMetrics: false,\n});\n\n// Selective control - keep observability, disable profiling\nnew glue.PySparkEtlJob(stack, 'SelectiveJob', {\n  role,\n  script,\n  enableMetrics: false,\n  // enableObservabilityMetrics defaults to true\n});\n```\n\nThis feature is available for all Spark job types (ETL, Streaming, Flex).\n\n### Enable Job Run Queuing\n\nAWS Glue job queuing monitors your account level quotas and limits. If quotas or limits are insufficient to start a Glue job run, AWS Glue will automatically queue the job and wait for limits to free up. Once limits become available, AWS Glue will retry the job run. Glue jobs will queue for limits like max concurrent job runs per account, max concurrent Data Processing Units (DPU), and resource unavailable due to IP address exhaustion in Amazon Virtual Private Cloud (Amazon VPC).\n\nEnable job run queuing by setting the `jobRunQueuingEnabled` property to `true`.\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  role,\n  script,\n  jobName: 'PySparkETLJob',\n  jobRunQueuingEnabled: true\n});\n```\n\n### Uploading scripts from the CDK app repository to S3\n\nSimilar to other L2 constructs, the Glue L2 automates uploading local\nscripts to S3. Use `glue.Code.fromAsset(path)` to point at a script in your\nlocal file structure; it is uploaded to the CDK-managed asset bucket. To\nreference a script that already exists in S3, use\n`glue.Code.fromBucket(bucket, key)`, which performs no upload. A `script` is\nrequired for every job.\n\nReference the unit tests for examples of repo and S3 code target examples.\n\n### Workflow Triggers\n\nYou can use Glue workflows to create and visualize complex\nextract, transform, and load (ETL) activities involving multiple crawlers,\njobs, and triggers. Standalone triggers are an anti-pattern, so you must\ncreate triggers from within a workflow using the L2 construct.\n\nWithin a workflow object, there are functions to create different\ntypes of triggers with actions and predicates. You add triggers to the\nworkflow, and each trigger references the jobs or crawlers it runs as its\nactions.\n\n`startOnCreation` applies to scheduled triggers (and, via\n`ConditionalTriggerOptions`, conditional triggers) only. It defaults to `false`,\nbut you can override it if you prefer for your trigger to start on creation.\n\nReference the workflow-triggers.test.ts unit tests for examples of creating\nworkflows and triggers.\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\n\n// Create a job to run from the workflow\nconst job = new glue.PySparkEtlJob(stack, 'Job', { role, script });\n\n// Create a workflow and add a trigger that runs the job\nconst workflow = new glue.Workflow(stack, 'Workflow');\nworkflow.addOnDemandTrigger('OnDemandTrigger', {\n  actions: [{ job }],\n});\n```\n\n#### **1. On-Demand Triggers**\n\nOn-demand triggers can start glue jobs or crawlers. This construct provides\nconvenience functions to create on-demand crawler or job triggers. The constructor\ntakes an optional description parameter, but abstracts the requirement of an\nactions list using the job or crawler objects using conditional types.\n\n#### **2. Scheduled Triggers**\n\nYou can create scheduled triggers using cron expressions. This construct\nprovides daily and weekly convenience functions,\nas well as a custom function that allows you to create your own\ncustom timing using the [existing event Schedule class](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_events.Schedule.html)\nwithout having to build your own cron expressions. The L2 extracts\nthe expression that Glue requires from the Schedule object. The constructor\ntakes an optional description and a list of jobs or crawlers as actions.\n\n#### **3. Notify  Event Triggers**\n\nThere are two types of notify event triggers: batching and non-batching.\nFor batching triggers, you must specify `BatchSize`. For non-batching\ntriggers, `BatchSize` defaults to 1. For both triggers, `BatchWindow`\ndefaults to 900 seconds, but you can override the window to align with\nyour workload's requirements.\n\n#### **4. Conditional Triggers**\n\nConditional triggers have a predicate and actions associated with them.\nThe trigger actions are executed when the predicateCondition is true.\n\n### Connection Properties\n\nA `Connection` allows Glue jobs, crawlers and development endpoints to access\ncertain types of data stores.\n\n* **Secrets Management**\n    You must specify JDBC connection credentials in Secrets Manager and\n    provide the Secrets Manager Key name as a property to the job connection.\n\n* **Networking - the CDK determines the best fit subnet for Glue connection\nconfiguration**\n    The prior version of the glue-alpha-module requires the developer to\n    specify the subnet of the Connection when it’s defined. Now, you can still\n    specify the specific subnet you want to use, but are no longer required\n    to. You are only required to provide a VPC and either a public or private\n    subnet selection. Without a specific subnet provided, the L2 leverages the\n    existing [EC2 Subnet Selection](https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_ec2/SubnetSelection.html)\n    library to make the best choice selection for the subnet.\n\n```ts\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  // The security groups granting AWS Glue inbound access to the data source within the VPC\n  securityGroups: [securityGroup],\n  // The VPC subnet which contains the data source\n  subnet,\n});\n```\n\nFor RDS `Connection` by JDBC, it is recommended to manage credentials using AWS Secrets Manager. To use Secret, specify `SECRET_ID` in `properties` like the following code. Note that in this case, the subnet must have a route to the AWS Secrets Manager VPC endpoint or to the AWS Secrets Manager endpoint through a NAT gateway.\n\n```ts\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\ndeclare const db: rds.DatabaseCluster;\nnew glue.Connection(this, \"RdsConnection\", {\n  type: glue.ConnectionType.JDBC,\n  securityGroups: [securityGroup],\n  subnet,\n  properties: {\n    JDBC_CONNECTION_URL: `jdbc:mysql://${db.clusterEndpoint.socketAddress}/databasename`,\n    JDBC_ENFORCE_SSL: \"false\",\n    SECRET_ID: db.secret!.secretName,\n  },\n});\n```\n\nConnection `properties` are emitted verbatim into the CloudFormation template, so\nany credential placed there in plaintext is stored in plaintext in the template,\n`cdk.out`, and source control. Reference a Secrets Manager secret through\n`SECRET_ID` (as above) instead. If a property key looks like a credential (for\nexample `PASSWORD`, `SECRET`, or `TOKEN`) and holds a plaintext literal, the\nconstruct emits a synthesis-time warning.\n\nIf you need to use a connection type that doesn't exist as a static member on `ConnectionType`, you can instantiate a `ConnectionType` object, e.g: `new glue.ConnectionType('NEW_TYPE')`.\n\nSee [Adding a Connection to Your Data Store](https://docs.aws.amazon.com/glue/latest/dg/populate-add-connection.html) and [Connection Structure](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-catalog-connections.html#aws-glue-api-catalog-connections-Connection) documentation for more information on the supported data stores and their configurations.\n\n## SecurityConfiguration\n\nA `SecurityConfiguration` is a set of security properties that can be used by AWS Glue to encrypt data at rest.\n\nEach encryption config is built with a factory that pairs the encryption mode\nwith its key, so illegal combinations (such as an S3-managed encryption carrying\na KMS key) cannot be expressed:\n\n```ts\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  cloudWatchEncryption: glue.CloudWatchEncryption.kms(),\n  jobBookmarksEncryption: glue.JobBookmarksEncryption.clientSideKms(),\n  s3Encryption: glue.S3Encryption.kms(),\n});\n```\n\nBy default, a shared KMS key is created for use with the encryption configurations that require one. You can also supply your own key to any factory, for example, for CloudWatch encryption:\n\n```ts\ndeclare const key: kms.Key;\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  cloudWatchEncryption: glue.CloudWatchEncryption.kms(key),\n});\n```\n\nUse `glue.S3Encryption.s3Managed()` for S3-managed (SSE-S3) encryption, which takes no key.\n\nSee [documentation](https://docs.aws.amazon.com/glue/latest/dg/encryption-security-configuration.html) for more info for Glue encrypting data written by Crawlers, Jobs, and Development Endpoints.\n\n## Catalog\n\nThe Glue Data Catalog is a persistent metadata store for your data assets. Every\naccount has an implicit, account-wide catalog that always exists, and you can also\ncreate additional catalogs as `AWS::Glue::Catalog` resources (for example, to\nfederate to another metastore).\n\nA catalog's encryption is fixed when the catalog is created: a catalog either\ncarries encryption settings or it does not. This keeps its configuration easy to\nreason about — there are no mutation methods that change encryption after the fact.\n\n### The account-wide catalog\n\nUse `Catalog.forAccount(scope)` to obtain the implicit account catalog. It is not\na CloudFormation resource — it always exists. Repeated calls within the same stack\nreturn the same instance:\n\n```ts\nconst catalog = glue.Catalog.forAccount(this);\n```\n\nTo configure Data Catalog encryption for the account, use\n`Catalog.encryptAccount(scope, options)`:\n\n```ts\ndeclare const key: kms.Key;\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(key),\n});\n```\n\nBecause encryption is fixed at construction, `encryptAccount` must be called\n*before* the account catalog is first used in the stack — before any\n`Catalog.forAccount(this)` call, and before any `Database` that uses the account\ncatalog. Calling it after the account catalog has been materialized throws.\n\nThe account catalog's encryption is an account- and region-wide setting, managed\nthrough the singleton `PutDataCatalogEncryptionSettings` API. Configure it in\nexactly one stack. Configuring it from multiple stacks in the same account and\nregion makes those stacks overwrite one another at deploy time, and the result is\norder-dependent. Unlike duplicate settings within a single stack (which\nCloudFormation rejects), this cross-stack conflict is not caught at synthesis\ntime, because each stack synthesizes to its own template.\n\n### Creating a catalog\n\nTo create a new catalog resource, use the `Catalog` constructor. Encryption is\nconfigured through the `encryptionAtRest` and `connectionPasswordEncryption` props:\n\n```ts\nnew glue.Catalog(this, 'MyCatalog', {\n  catalogName: 'my-catalog',\n  description: 'my catalog description',\n});\n```\n\n### Encryption at rest\n\nConfigure Data Catalog encryption at rest through the `encryptionAtRest` option\n(on `Catalog.encryptAccount` or the `Catalog` constructor).\nIt accepts a `DataCatalogEncryptionAtRest` describing the mode:\n\n```ts\ndeclare const key: kms.Key;\n\n// SSE-KMS with a customer-managed key\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(key),\n});\n\n// SSE-KMS with an AWS-managed key (omit the key)\nnew glue.Catalog(this, 'ManagedKeyCatalog', {\n  catalogName: 'managed-key-catalog',\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(),\n});\n\n// Disable encryption at rest\nnew glue.Catalog(this, 'PlaintextCatalog', {\n  catalogName: 'plaintext-catalog',\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.disabled(),\n});\n```\n\nWhen you use `SSE-KMS-WITH-SERVICE-ROLE`, AWS Glue accesses the KMS key through a\nservice role you provide. If you pass a customer-managed key, the role is\nautomatically granted the permissions it needs to encrypt and decrypt catalog data:\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const key: kms.Key;\ndeclare const role: iam.IRole;\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kmsWithServiceRole(role, key),\n});\n```\n\nThe customer-managed key, when configured, is exposed on the catalog as\n`encryptionKey` (and the connection-password key as `connectionPasswordKey`), so\nyou can reference it to grant additional access. It is undefined when encryption is\ndisabled or an AWS-managed key is used.\n\n### Connection password encryption\n\nIndependently from encryption at rest, the Data Catalog can encrypt the passwords\nstored in connection properties. Configure it through the\n`connectionPasswordEncryption` option:\n\n```ts\ndeclare const key: kms.Key;\nglue.Catalog.encryptAccount(this, {\n  connectionPasswordEncryption: {\n    kmsKey: key,\n    // Whether GetConnection/GetConnections return the password encrypted (default: true)\n    returnConnectionPasswordEncrypted: true,\n  },\n});\n```\n\nThe two encryption blocks are independent: enabling one does not require the other,\nand each may use a different KMS key. The customer-managed key for connection\npasswords is exposed as `connectionPasswordKey`.\n\n### Importing a catalog\n\nYou can import an existing catalog by ARN or by id. An imported catalog is a pure\nidentity handle — it emits no resources and does not manage the catalog's\nencryption:\n\n```ts\nconst byId = glue.Catalog.fromCatalogId(this, 'ById', 'my-catalog-id');\nconst byArn = glue.Catalog.fromCatalogArn(this, 'ByArn', 'arn:aws:glue:us-east-1:123456789012:catalog/my-catalog-id');\n```\n\nTo manage the Data Catalog encryption of a catalog you did not create in this\nstack, add a `CfnDataCatalogEncryptionSettings` resource targeting its id\ndirectly. Do this from exactly one stack: like the account catalog, a catalog has\na single encryption configuration, so two settings resources targeting the same id\nrace to overwrite one another at deploy time. Within a single stack this is caught\nby CloudFormation template validation (E3019, duplicate primary identifiers);\nacross stacks it is not, since each stack synthesizes to its own template.\n\n```ts\nimport { CfnDataCatalogEncryptionSettings } from 'aws-cdk-lib/aws-glue';\n\nnew CfnDataCatalogEncryptionSettings(this, 'Encryption', {\n  catalogId: 'my-catalog-id',\n  dataCatalogEncryptionSettings: {\n    encryptionAtRest: { catalogEncryptionMode: 'SSE-KMS' },\n  },\n});\n```\n\n## Database\n\nA `Database` is a logical grouping of `Tables` in the Glue Catalog.\n\n```ts\nnew glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n  description: 'my_database_description',\n});\n```\n\nBecause a database is a container for tables and their metadata, it is retained\nby default when removed from the stack, to avoid accidental data loss. Set\n`removalPolicy` to `RemovalPolicy.DESTROY` to have it deleted instead:\n\n```ts\nimport { RemovalPolicy } from 'aws-cdk-lib';\n\nnew glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n  removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\n## Table\n\nA Glue table describes a table of data in S3: its structure (column names and types), location of data (S3 objects with a common prefix in a S3 bucket), and format for the files (Json, Avro, Parquet, etc.):\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }, {\n    name: 'col2',\n    type: glue.Schema.array(glue.Schema.STRING),\n    comment: 'col2 is an array of strings' // comment is optional\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nBy default, a S3 bucket will be created to store the table's data but you can manually pass the `bucket` and `s3Prefix`:\n\n```ts\ndeclare const myBucket: s3.Bucket;\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  bucket: myBucket,\n  s3Prefix: 'my-table/',\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nGlue tables can be configured to contain user-defined properties, to describe the physical storage of table data, through the `storageParameters` property:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storageParameters: [\n    glue.StorageParameter.skipHeaderLineCount(1),\n    glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n    glue.StorageParameter.custom('separatorChar', ',')\n  ],\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nGlue tables can also be configured to contain user-defined table properties through the [`parameters`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-glue-table-tableinput.html#cfn-glue-table-tableinput-parameters) property:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  parameters: {\n    key1: 'val1',\n    key2: 'val2',\n  },\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Partition Keys\n\nTo improve query performance, a table can specify `partitionKeys` on which data is stored and queried separately. For example, you might partition a table by `year` and `month` to optimize queries based on a time window:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.SMALL_INT,\n  }, {\n    name: 'month',\n    type: glue.Schema.SMALL_INT,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Partition Indexes\n\nAnother way to improve query performance is to specify partition indexes. If no partition indexes are\npresent on the table, AWS Glue loads all partitions of the table and filters the loaded partitions using\nthe query expression. The query takes more time to run as the number of partitions increase. With an\nindex, the query will try to fetch a subset of the partitions instead of loading all partitions of the\ntable.\n\nThe keys of a partition index must be a subset of the partition keys of the table. You can have a\nmaximum of 3 partition indexes per table. To specify a partition index, you can use the `partitionIndexes`\nproperty:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.SMALL_INT,\n  }, {\n    name: 'month',\n    type: glue.Schema.SMALL_INT,\n  }],\n  partitionIndexes: [{\n    indexName: 'my-index', // optional\n    keyNames: ['year'],\n  }], // supply up to 3 indexes\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nAlternatively, you can call the `addPartitionIndex()` function on a table:\n\n```ts\ndeclare const myTable: glue.S3Table;\nmyTable.addPartitionIndex({\n  indexName: 'my-index',\n  keyNames: ['year'],\n});\n```\n\n### Partition Filtering\n\nIf you have a table with a large number of partitions that grows over time, consider using AWS Glue partition indexing and filtering.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n      name: 'col1',\n      type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n      name: 'year',\n      type: glue.Schema.SMALL_INT,\n  }, {\n      name: 'month',\n      type: glue.Schema.SMALL_INT,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  enablePartitionFiltering: true,\n});\n```\n\n### Partition Projection\n\nPartition projection allows Athena to automatically add new partitions as new data arrives, without requiring `ALTER TABLE ADD PARTITION` statements. This improves query performance and reduces management overhead by eliminating the need to manually manage partition metadata.\n\nFor more information, see the [AWS documentation on partition projection](https://docs.aws.amazon.com/athena/latest/ug/partition-projection.html).\n\n#### INTEGER Projection\n\nFor partition keys with sequential numeric values:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.INTEGER,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    year: glue.PartitionProjectionConfiguration.integer({\n      min: 2020,\n      max: 2023,\n      interval: 1,  // optional, defaults to 1\n      digits: 4,    // optional, pads with leading zeros\n    }),\n  },\n});\n```\n\n#### DATE Projection\n\nFor partition keys with date or timestamp values. Supports both fixed dates and relative dates using `NOW`:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: '2020-01-01',\n      max: '2023-12-31',\n      format: 'yyyy-MM-dd',\n      interval: 1,  // optional, defaults to 1\n      intervalUnit: glue.DateIntervalUnit.DAYS,  // optional: YEARS, MONTHS, WEEKS, DAYS, HOURS, MINUTES, SECONDS\n    }),\n  },\n});\n```\n\nYou can also use relative dates with `NOW`:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});\n```\n\n#### ENUM Projection\n\nFor partition keys with a known set of values:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'region',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    region: glue.PartitionProjectionConfiguration.enum({\n      values: ['us-east-1', 'us-west-2', 'eu-west-1'],\n    }),\n  },\n});\n```\n\n#### INJECTED Projection\n\nFor custom partition values injected at query time:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'custom',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    custom: glue.PartitionProjectionConfiguration.injected(),\n  },\n});\n```\n\n#### Multiple Partition Projections\n\nYou can configure partition projection for multiple partition keys:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [\n    {\n      name: 'year',\n      type: glue.Schema.INTEGER,\n    },\n    {\n      name: 'month',\n      type: glue.Schema.INTEGER,\n    },\n    {\n      name: 'region',\n      type: glue.Schema.STRING,\n    },\n  ],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    year: glue.PartitionProjectionConfiguration.integer({\n      min: 2020,\n      max: 2023,\n    }),\n    month: glue.PartitionProjectionConfiguration.integer({\n      min: 1,\n      max: 12,\n      digits: 2,\n    }),\n    region: glue.PartitionProjectionConfiguration.enum({\n      values: ['us-east-1', 'us-west-2'],\n    }),\n  },\n});\n```\n\n### Glue Connections\n\nGlue connections allow external data connections to third party databases and data warehouses. However, these connections can also be assigned to Glue Tables, allowing you to query external data sources using the Glue Data Catalog.\n\nWhereas `S3Table` will point to (and if needed, create) a bucket to store the tables' data, `ExternalTable` will point to an existing table in a data source. For example, to create a table in Glue that points to a table in Redshift:\n\n```ts\ndeclare const myConnection: glue.Connection;\ndeclare const myDatabase: glue.Database;\nnew glue.ExternalTable(this, 'MyTable', {\n  connection: myConnection,\n  externalDataLocation: 'default_db_public_example', // A table in Redshift\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n## Data Quality Ruleset\n\nA `DataQualityRuleset` defines a set of data quality rules — authored in Glue's\nData Quality Definition Language (DQDL) — that are evaluated against a table in\nthe Data Catalog.\n\n```ts\nnew glue.DataQualityRuleset(this, 'MyRuleset', {\n  rulesetName: 'my_ruleset',\n  dqdl: glue.Dqdl.fromString('Rules = [ RowCount > 100, IsComplete \"order_id\" ]'),\n  targetTable: new glue.DataQualityTargetTable('my_database', 'my_table'),\n});\n```\n\nBuild the DQDL document with `Dqdl.fromString(...)`. Glue parses and validates the\nDQDL when the ruleset is deployed; see the\n[DQDL reference](https://docs.aws.amazon.com/glue/latest/dg/dqdl.html) for the\nfull rule syntax.\n\n## [Encryption](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)\n\nWhen the table creates its own S3 bucket (i.e. you do not pass an explicit `bucket`), that bucket enforces SSL: a bucket policy denies any request made over plain HTTP. If you provide your own bucket, enabling `enforceSSL` on it is your responsibility.\n\nYou can enable encryption on a Table's data:\n\n* [S3Managed](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) - (default) Server side encryption (`SSE-S3`) with an Amazon S3-managed key.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n* [Kms](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html) - Server-side encryption (`SSE-KMS`) with an AWS KMS Key managed by the account owner.\n\n```ts\ndeclare const myDatabase: glue.Database;\n// KMS key is created automatically\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n\n// with an explicit KMS key\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n* [KmsManaged](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html) - Server-side encryption (`SSE-KMS`), like `Kms`, except with an AWS KMS Key managed by the AWS Key Management Service.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS_MANAGED,\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n* [ClientSideKms](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html#client-side-encryption-kms-managed-master-key-intro) - Client-side encryption (`CSE-KMS`) with an AWS KMS Key managed by the account owner.\n\n```ts\ndeclare const myDatabase: glue.Database;\n// KMS key is created automatically\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n\n// with an explicit KMS key\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n*Note: you cannot provide a `Bucket` when creating the `S3Table` if you wish to use server-side encryption (`KMS`, `KMS_MANAGED` or `S3_MANAGED`)*.\n\n### Marking table data as encrypted\n\nBoth `S3Table` and `ExternalTable` set the `has_encrypted_data` table parameter, which\nAthena reads when querying client-side (`CSE-KMS`) encrypted datasets. It defaults to `true`.\nSet `hasEncryptedData` to `false` when the underlying data is not encrypted:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  hasEncryptedData: false,\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nDo not set `has_encrypted_data` through the free-form `parameters` map as well - a value\nthere that conflicts with `hasEncryptedData` is rejected at synthesis time.\n\n## Types\n\nA table's schema is a collection of columns, each of which have a `name` and a `type`. Types are recursive structures, consisting of primitive and complex types:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  columns: [{\n    name: 'primitive_column',\n    type: glue.Schema.STRING,\n  }, {\n    name: 'array_column',\n    type: glue.Schema.array(glue.Schema.INTEGER),\n    comment: 'array<integer>',\n  }, {\n    name: 'map_column',\n    type: glue.Schema.map(\n      glue.Schema.STRING,\n      glue.Schema.TIMESTAMP),\n    comment: 'map<string,timestamp>',\n  }, {\n    name: 'struct_column',\n    type: glue.Schema.struct([{\n      name: 'nested_column',\n      type: glue.Schema.DATE,\n      comment: 'nested comment',\n    }]),\n    comment: \"struct<nested_column:date COMMENT 'nested comment'>\",\n  }],\n  // ...\n  database: myDatabase,\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n## Public FAQ\n\n### What are we launching today?\n\nWe’re launching new features to an AWS CDK Glue L2 Construct to provide\nbest-practice defaults and convenience methods to create Glue Jobs, Connections,\nTriggers, Workflows, and the underlying permissions and configuration.\n\n### Why should I use this Construct?\n\nDevelopers should use this Construct to reduce the amount of boilerplate\ncode and complexity each individual has to navigate, and make it easier to\ncreate best-practice Glue resources.\n\n### What’s not in scope?\n\nGlue Crawlers and other resources that are now managed by the AWS LakeFormation\nteam are not in scope for this effort. Developers should use existing methods\nto create these resources, and the new Glue L2 construct assumes they already\nexist as inputs. While best practice is for application and infrastructure code\nto be as close as possible for teams using fully-implemented DevOps mechanisms,\nin practice these ETL scripts are likely managed by a data science team who\nknow Python or Scala and don’t necessarily own or manage their own\ninfrastructure deployments. We want to meet developers where they are, and not\nassume that all of the code resides in the same repository, Developers can\nautomate this themselves via the CDK, however, if they do own both.\n\nValidating Glue version and feature use per AWS region at synth time is also\nnot in scope. AWS’ intention is for all features to eventually be propagated to\nall Global regions, so the complexity involved in creating and updating region-\nspecific configuration to match shifting feature sets does not out-weigh the\nlikelihood that a developer will use this construct to deploy resources to a\nregion without a particular new feature to a region that doesn’t yet support\nit without researching or manually attempting to use that feature before\ndeveloping it via IaC. The developer will, of course, still get feedback from\nthe underlying Glue APIs as CloudFormation deploys the resources similar to the\ncurrent CDK L1 Glue experience.\n"
+    "markdown": "# AWS Glue Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.\n\n## README\n\n[AWS Glue](https://aws.amazon.com/glue/) is a serverless data integration\nservice that makes it easier to discover, prepare, move, and integrate data\nfrom multiple sources for analytics, machine learning (ML), and application\ndevelopment.\n\nThe Glue L2 construct has convenience methods working backwards from common\nuse cases and sets required parameters to defaults that align with recommended\nbest practices for each job type. It also provides customers with a balance\nbetween flexibility via optional parameter overrides, and opinionated\ninterfaces that discouraging anti-patterns, resulting in reduced time to develop\nand deploy new resources.\n\n### References\n\n* [Glue Launch Announcement](https://aws.amazon.com/blogs/aws/launch-aws-glue-now-generally-available/)\n* [Glue Documentation](https://docs.aws.amazon.com/glue/index.html)\n* [Glue L1 (CloudFormation) Constructs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Glue.html)\n* Prior version of the [@aws-cdk/aws-glue-alpha module](https://github.com/aws/aws-cdk/blob/v2.51.1/packages/%40aws-cdk/aws-glue/README.md)\n\n## Create a Glue Job\n\nA Job encapsulates a script that connects to data sources, processes\nthem, and then writes output to a data target. There are four types of Glue\nJobs: Spark (ETL and Streaming), Python Shell, and Flex Jobs. Most\nof the required parameters for these jobs are common across all types,\nbut there are a few differences depending on the languages supported\nand features provided by each type. For all job types, the L2 defaults\nto AWS best practice recommendations, such as:\n\n* Use of Secrets Manager for Connection JDBC strings\n* Glue job autoscaling\n* Default parameter values for Glue job creation\n\nThis iteration of the L2 construct introduces breaking changes to\nthe existing glue-alpha-module, but these changes streamline the developer\nexperience, introduce new constants for defaults, and replacing synth-time\nvalidations with interface contracts for enforcement of the parameter combinations\nthat Glue supports. As an opinionated construct, the Glue L2 construct does\nnot allow developers to create resources that use non-current versions\nof Glue or deprecated language dependencies (e.g. deprecated versions of Python).\nAs always, L1s allow you to specify a wider range of parameters if you need\nor want to use alternative configurations.\n\nOptional and required parameters for each job are enforced via interface\nrather than validation; see [Glue's public documentation](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api.html)\nfor more granular details.\n\n### Spark Jobs\n\n#### ETL Jobs\n\nETL jobs support pySpark and Scala languages, for which there are separate but\nsimilar constructors. ETL jobs default to the G2 worker type, but you can\noverride this default with other supported worker type values (G1, G2, G4\nand G8). ETL jobs defaults to Glue version 4.0, which you can override to 3.0.\nThe following ETL features are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log.`\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\nYou can find more details about version, worker type and other features in\n[Glue's public documentation](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html).\n\nReference the pyspark-etl-jobs.test.ts and scalaspark-etl-jobs.test.ts unit tests\nfor examples of required-only and optional job parameters when creating these\ntypes of jobs.\n\nFor the sake of brevity, examples are shown using the pySpark job variety.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  role,\n  script,\n  jobName: 'PySparkETLJob',\n});\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  jobName: 'PySparkETLJobCustomName',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n#### Streaming Jobs\n\nStreaming jobs are similar to ETL jobs, except that they perform ETL on data\nstreams using the Apache Spark Structured Streaming framework. Some Spark\njob features are not available to Streaming ETL jobs. They support Scala\nand pySpark languages. PySpark streaming jobs run on Python 3. It\ndefaults to the G2 worker type and Glue 4.0, both of which you can override.\nThe following best practice features are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log`.\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\n\nReference the pyspark-streaming-jobs.test.ts and scalaspark-streaming-jobs.test.ts\nunit tests for examples of required-only and optional job parameters when creating\nthese types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkStreamingJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkStreamingJob(stack, 'PySparkStreamingJob', {\n  jobName: 'PySparkStreamingJobCustomName',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n#### Flex Jobs\n\nThe flexible execution class is appropriate for non-urgent jobs such as\npre-production jobs, testing, and one-time data loads. Flexible jobs default\nto Glue version 5.0 and worker type `G_2X`. The following best practice\nfeatures are enabled by default:\n`—enable-metrics, —enable-continuous-cloudwatch-log`\nThe Spark UI (`—enable-spark-ui`) is off by default; enable it by setting the\n`sparkUI` prop.\n\nReference the pyspark-flex-etl-jobs.test.ts and scalaspark-flex-etl-jobs.test.ts\nunit tests for examples of required-only and optional job parameters when creating\nthese types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkFlexEtlJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkFlexEtlJob(stack, 'pySparkFlexEtlJob', {\n  jobName: 'pySparkFlexEtlJob',\n  description: 'This is a description',\n  role,\n  script,\n  glueVersion: glue.GlueVersion.V5_1,\n  continuousLogging: { enabled: false },\n  workerConfiguration: {\n    workerType: glue.WorkerType.G_2X,\n    numberOfWorkers: 2,\n  },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n### Python Shell Jobs\n\nPython shell jobs support a Python version that depends on the AWS Glue\nversion you use. These can be used to schedule and run tasks that don't\nrequire an Apache Spark environment. Python shell jobs default to\nPython 3.9 and a MaxCapacity of `0.0625`. Python 3.9 supports pre-loaded\nanalytics libraries using the `library-set=analytics` flag, which is\nenabled by default.\n\nReference the pyspark-shell-job.test.ts unit tests for examples of\nrequired-only and optional job parameters when creating these types of jobs.\n\nExample with only required parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PythonShellJob(stack, 'ImportedJob', { role, script });\n```\n\nExample with optional override parameters:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\ndeclare const extraPythonFile: glue.Code;\nnew glue.PythonShellJob(stack, 'PythonShellJob', {\n  jobName: 'PythonShellJobCustomName',\n  description: 'This is a description',\n  pythonVersion: glue.PythonVersion.THREE_NINE,\n  maxCapacity: glue.MaxCapacity.DPU_1,\n  role,\n  script,\n  extraPythonFiles: [extraPythonFile],\n  glueVersion: glue.GlueVersion.V3_0,\n  continuousLogging: { enabled: false },\n  maxConcurrentRuns: 100,\n  timeout: cdk.Duration.hours(2),\n  connections: [glue.Connection.fromConnectionName(stack, 'Connection', 'connectionName')],\n  securityConfiguration: glue.SecurityConfiguration.fromSecurityConfigurationName(stack, 'SecurityConfig', 'securityConfigName'),\n  tags: {\n    FirstTagName: 'FirstTagValue',\n    SecondTagName: 'SecondTagValue',\n    XTagName: 'XTagValue',\n  },\n  maxRetries: 2,\n});\n```\n\n### Ray Jobs\n\n> **⚠️ DEPRECATED:** AWS Glue for Ray is closed to new customers as of April 30, 2026 and is in maintenance mode.\n> Migrate to [Amazon EKS with KubeRay Operator](https://docs.aws.amazon.com/glue/latest/dg/awsglue-ray-jobs-availability-change.html).\n\nThe `RayJob` construct, `Runtime.RAY_TWO_FOUR`, and `JobType.RAY` are deprecated and will be removed in a future release.\n\n### Metrics Control\n\nBy default, Glue jobs enable CloudWatch metrics (`--enable-metrics`) and observability metrics (`--enable-observability-metrics`) for monitoring and debugging. You can disable these metrics to reduce CloudWatch costs:\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\n\n// Disable both metrics for cost optimization\nnew glue.PySparkEtlJob(stack, 'CostOptimizedJob', {\n  role,\n  script,\n  enableMetrics: false,\n  enableObservabilityMetrics: false,\n});\n\n// Selective control - keep observability, disable profiling\nnew glue.PySparkEtlJob(stack, 'SelectiveJob', {\n  role,\n  script,\n  enableMetrics: false,\n  // enableObservabilityMetrics defaults to true\n});\n```\n\nThis feature is available for all Spark job types (ETL, Streaming, Flex).\n\n### Enable Job Run Queuing\n\nAWS Glue job queuing monitors your account level quotas and limits. If quotas or limits are insufficient to start a Glue job run, AWS Glue will automatically queue the job and wait for limits to free up. Once limits become available, AWS Glue will retry the job run. Glue jobs will queue for limits like max concurrent job runs per account, max concurrent Data Processing Units (DPU), and resource unavailable due to IP address exhaustion in Amazon Virtual Private Cloud (Amazon VPC).\n\nEnable job run queuing by setting the `jobRunQueuingEnabled` property to `true`.\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\nnew glue.PySparkEtlJob(stack, 'PySparkETLJob', {\n  role,\n  script,\n  jobName: 'PySparkETLJob',\n  jobRunQueuingEnabled: true\n});\n```\n\n### Uploading scripts from the CDK app repository to S3\n\nSimilar to other L2 constructs, the Glue L2 automates uploading local\nscripts to S3. Use `glue.Code.fromAsset(path)` to point at a script in your\nlocal file structure; it is uploaded to the CDK-managed asset bucket. To\nreference a script that already exists in S3, use\n`glue.Code.fromBucket(bucket, key)`, which performs no upload. A `script` is\nrequired for every job.\n\nReference the unit tests for examples of repo and S3 code target examples.\n\n### Workflow Triggers\n\nYou can use Glue workflows to create and visualize complex\nextract, transform, and load (ETL) activities involving multiple crawlers,\njobs, and triggers. Standalone triggers are an anti-pattern, so you must\ncreate triggers from within a workflow using the L2 construct.\n\nWithin a workflow object, there are functions to create different\ntypes of triggers with actions and predicates. You add triggers to the\nworkflow, and each trigger references the jobs or crawlers it runs as its\nactions.\n\n`startOnCreation` applies to scheduled triggers (and, via\n`ConditionalTriggerOptions`, conditional triggers) only. It defaults to `false`,\nbut you can override it if you prefer for your trigger to start on creation.\n\nReference the workflow-triggers.test.ts unit tests for examples of creating\nworkflows and triggers.\n\n```ts\nimport * as cdk from 'aws-cdk-lib';\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const stack: cdk.Stack;\ndeclare const role: iam.IRole;\ndeclare const script: glue.Code;\n\n// Create a job to run from the workflow\nconst job = new glue.PySparkEtlJob(stack, 'Job', { role, script });\n\n// Create a workflow and add a trigger that runs the job\nconst workflow = new glue.Workflow(stack, 'Workflow');\nworkflow.addOnDemandTrigger('OnDemandTrigger', {\n  actions: [{ job }],\n});\n```\n\n#### **1. On-Demand Triggers**\n\nOn-demand triggers can start glue jobs or crawlers. This construct provides\nconvenience functions to create on-demand crawler or job triggers. The constructor\ntakes an optional description parameter, but abstracts the requirement of an\nactions list using the job or crawler objects using conditional types.\n\n#### **2. Scheduled Triggers**\n\nYou can create scheduled triggers using cron expressions. This construct\nprovides daily and weekly convenience functions,\nas well as a custom function that allows you to create your own\ncustom timing using the [existing event Schedule class](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_events.Schedule.html)\nwithout having to build your own cron expressions. The L2 extracts\nthe expression that Glue requires from the Schedule object. The constructor\ntakes an optional description and a list of jobs or crawlers as actions.\n\n#### **3. Notify  Event Triggers**\n\nThere are two types of notify event triggers: batching and non-batching.\nFor batching triggers, you must specify `BatchSize`. For non-batching\ntriggers, `BatchSize` defaults to 1. For both triggers, `BatchWindow`\ndefaults to 900 seconds, but you can override the window to align with\nyour workload's requirements.\n\n#### **4. Conditional Triggers**\n\nConditional triggers have a predicate and actions associated with them.\nThe trigger actions are executed when the predicateCondition is true.\n\n### Connection Properties\n\nA `Connection` allows Glue jobs, crawlers and development endpoints to access\ncertain types of data stores.\n\n* **Secrets Management**\n    Manage JDBC connection credentials in Secrets Manager and pass the secret\n    to the connection via the `secret` property (see the example below), rather\n    than embedding credentials in `properties`.\n\n* **Networking - the CDK determines the best fit subnet for Glue connection\nconfiguration**\n    You can specify the exact subnet of the Connection when it's defined, but\n    you are not required to. Instead, you can provide a `vpc` and, optionally, a\n    `vpcSubnets` selection, and the L2 leverages the existing\n    [EC2 Subnet Selection](https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_ec2/SubnetSelection.html)\n    library to make the best choice selection for the subnet. A Glue connection\n    targets a single subnet, so the first subnet of the selection is used.\n    `subnet` and `vpc` are mutually exclusive.\n\nPin the connection to a specific subnet:\n\n```ts\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  // The security groups granting AWS Glue inbound access to the data source within the VPC\n  securityGroups: [securityGroup],\n  // The VPC subnet which contains the data source\n  subnet,\n});\n```\n\nOr let the CDK select a subnet from a VPC:\n\n```ts\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const vpc: ec2.Vpc;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  securityGroups: [securityGroup],\n  vpc,\n  // Optional - defaults to private subnets\n  vpcSubnets: { subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS },\n});\n```\n\nFor RDS `Connection` by JDBC, it is recommended to manage credentials using AWS Secrets Manager. Pass the secret via the `secret` property: Glue reads the credentials at runtime through the connection's `SECRET_ID`, so the secret value never enters the template. Note that in this case, the subnet must have a route to the AWS Secrets Manager VPC endpoint or to the AWS Secrets Manager endpoint through a NAT gateway.\n\n```ts\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\ndeclare const db: rds.DatabaseCluster;\nnew glue.Connection(this, \"RdsConnection\", {\n  type: glue.ConnectionType.JDBC,\n  securityGroups: [securityGroup],\n  subnet,\n  secret: db.secret,\n  properties: {\n    JDBC_CONNECTION_URL: `jdbc:mysql://${db.clusterEndpoint.socketAddress}/databasename`,\n    JDBC_ENFORCE_SSL: \"false\",\n  },\n});\n```\n\nPrefer the `secret` property over placing credentials in `properties`. Connection\n`properties` are emitted verbatim into the CloudFormation template, so any\ncredential placed there in plaintext is stored in plaintext in the template,\n`cdk.out`, and source control. If a property key looks like a credential (for\nexample `PASSWORD`, `SECRET`, or `TOKEN`) and holds a plaintext literal, the\nconstruct emits a synthesis-time warning.\n\nIf you need to use a connection type that doesn't exist as a static member on `ConnectionType`, you can instantiate a `ConnectionType` object, e.g: `new glue.ConnectionType('NEW_TYPE')`.\n\nSee [Adding a Connection to Your Data Store](https://docs.aws.amazon.com/glue/latest/dg/populate-add-connection.html) and [Connection Structure](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-catalog-connections.html#aws-glue-api-catalog-connections-Connection) documentation for more information on the supported data stores and their configurations.\n\n## SecurityConfiguration\n\nA `SecurityConfiguration` is a set of security properties that can be used by AWS Glue to encrypt data at rest.\n\nEach encryption config is built with a factory that pairs the encryption mode\nwith its key, so illegal combinations (such as an S3-managed encryption carrying\na KMS key) cannot be expressed:\n\n```ts\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  cloudWatchEncryption: glue.CloudWatchEncryption.kms(),\n  jobBookmarksEncryption: glue.JobBookmarksEncryption.clientSideKms(),\n  s3Encryption: glue.S3Encryption.kms(),\n});\n```\n\nBy default, a shared KMS key is created for use with the encryption configurations that require one. You can also supply your own key to any factory, for example, for CloudWatch encryption:\n\n```ts\ndeclare const key: kms.Key;\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  cloudWatchEncryption: glue.CloudWatchEncryption.kms(key),\n});\n```\n\nUse `glue.S3Encryption.s3Managed()` for S3-managed (SSE-S3) encryption, which takes no key.\n\nSee [documentation](https://docs.aws.amazon.com/glue/latest/dg/encryption-security-configuration.html) for more info for Glue encrypting data written by Crawlers, Jobs, and Development Endpoints.\n\n## Catalog\n\nThe Glue Data Catalog is a persistent metadata store for your data assets. Every\naccount has an implicit, account-wide catalog that always exists, and you can also\ncreate additional catalogs as `AWS::Glue::Catalog` resources (for example, to\nfederate to another metastore).\n\nA catalog's encryption is fixed when the catalog is created: a catalog either\ncarries encryption settings or it does not. This keeps its configuration easy to\nreason about — there are no mutation methods that change encryption after the fact.\n\n### The account-wide catalog\n\nUse `Catalog.forAccount(scope)` to obtain the implicit account catalog. It is not\na CloudFormation resource — it always exists. Repeated calls within the same stack\nreturn the same instance:\n\n```ts\nconst catalog = glue.Catalog.forAccount(this);\n```\n\nTo configure Data Catalog encryption for the account, use\n`Catalog.encryptAccount(scope, options)`:\n\n```ts\ndeclare const key: kms.Key;\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(key),\n});\n```\n\nBecause encryption is fixed at construction, `encryptAccount` must be called\n*before* the account catalog is first used in the stack — before any\n`Catalog.forAccount(this)` call, and before any `Database` that uses the account\ncatalog. Calling it after the account catalog has been materialized throws.\n\nThe account catalog's encryption is an account- and region-wide setting, managed\nthrough the singleton `PutDataCatalogEncryptionSettings` API. Configure it in\nexactly one stack. Configuring it from multiple stacks in the same account and\nregion makes those stacks overwrite one another at deploy time, and the result is\norder-dependent. Unlike duplicate settings within a single stack (which\nCloudFormation rejects), this cross-stack conflict is not caught at synthesis\ntime, because each stack synthesizes to its own template.\n\n### Creating a catalog\n\nTo create a new catalog resource, use the `Catalog` constructor. Encryption is\nconfigured through the `encryptionAtRest` and `connectionPasswordEncryption` props:\n\n```ts\nnew glue.Catalog(this, 'MyCatalog', {\n  catalogName: 'my-catalog',\n  description: 'my catalog description',\n});\n```\n\n### Encryption at rest\n\nConfigure Data Catalog encryption at rest through the `encryptionAtRest` option\n(on `Catalog.encryptAccount` or the `Catalog` constructor).\nIt accepts a `DataCatalogEncryptionAtRest` describing the mode:\n\n```ts\ndeclare const key: kms.Key;\n\n// SSE-KMS with a customer-managed key\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(key),\n});\n\n// SSE-KMS with an AWS-managed key (omit the key)\nnew glue.Catalog(this, 'ManagedKeyCatalog', {\n  catalogName: 'managed-key-catalog',\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kms(),\n});\n\n// Disable encryption at rest\nnew glue.Catalog(this, 'PlaintextCatalog', {\n  catalogName: 'plaintext-catalog',\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.disabled(),\n});\n```\n\nWhen you use `SSE-KMS-WITH-SERVICE-ROLE`, AWS Glue accesses the KMS key through a\nservice role you provide. If you pass a customer-managed key, the role is\nautomatically granted the permissions it needs to encrypt and decrypt catalog data:\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\ndeclare const key: kms.Key;\ndeclare const role: iam.IRole;\nglue.Catalog.encryptAccount(this, {\n  encryptionAtRest: glue.DataCatalogEncryptionAtRest.kmsWithServiceRole(role, key),\n});\n```\n\nThe customer-managed key, when configured, is exposed on the catalog as\n`encryptionKey` (and the connection-password key as `connectionPasswordKey`), so\nyou can reference it to grant additional access. It is undefined when encryption is\ndisabled or an AWS-managed key is used.\n\n### Connection password encryption\n\nIndependently from encryption at rest, the Data Catalog can encrypt the passwords\nstored in connection properties. Configure it through the\n`connectionPasswordEncryption` option:\n\n```ts\ndeclare const key: kms.Key;\nglue.Catalog.encryptAccount(this, {\n  connectionPasswordEncryption: {\n    kmsKey: key,\n    // Whether GetConnection/GetConnections return the password encrypted (default: true)\n    returnConnectionPasswordEncrypted: true,\n  },\n});\n```\n\nThe two encryption blocks are independent: enabling one does not require the other,\nand each may use a different KMS key. The customer-managed key for connection\npasswords is exposed as `connectionPasswordKey`.\n\n### Importing a catalog\n\nYou can import an existing catalog by ARN or by id. An imported catalog is a pure\nidentity handle — it emits no resources and does not manage the catalog's\nencryption:\n\n```ts\nconst byId = glue.Catalog.fromCatalogId(this, 'ById', 'my-catalog-id');\nconst byArn = glue.Catalog.fromCatalogArn(this, 'ByArn', 'arn:aws:glue:us-east-1:123456789012:catalog/my-catalog-id');\n```\n\nTo manage the Data Catalog encryption of a catalog you did not create in this\nstack, add a `CfnDataCatalogEncryptionSettings` resource targeting its id\ndirectly. Do this from exactly one stack: like the account catalog, a catalog has\na single encryption configuration, so two settings resources targeting the same id\nrace to overwrite one another at deploy time. Within a single stack this is caught\nby CloudFormation template validation (E3019, duplicate primary identifiers);\nacross stacks it is not, since each stack synthesizes to its own template.\n\n```ts\nimport { CfnDataCatalogEncryptionSettings } from 'aws-cdk-lib/aws-glue';\n\nnew CfnDataCatalogEncryptionSettings(this, 'Encryption', {\n  catalogId: 'my-catalog-id',\n  dataCatalogEncryptionSettings: {\n    encryptionAtRest: { catalogEncryptionMode: 'SSE-KMS' },\n  },\n});\n```\n\n## Database\n\nA `Database` is a logical grouping of `Tables` in the Glue Catalog.\n\n```ts\nnew glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n  description: 'my_database_description',\n});\n```\n\nBecause a database is a container for tables and their metadata, it is retained\nby default when removed from the stack, to avoid accidental data loss. Set\n`removalPolicy` to `RemovalPolicy.DESTROY` to have it deleted instead:\n\n```ts\nimport { RemovalPolicy } from 'aws-cdk-lib';\n\nnew glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n  removalPolicy: RemovalPolicy.DESTROY,\n});\n```\n\n## Table\n\nA Glue table describes a table of data in S3: its structure (column names and types), location of data (S3 objects with a common prefix in a S3 bucket), and format for the files (Json, Avro, Parquet, etc.):\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }, {\n    name: 'col2',\n    type: glue.Schema.array(glue.Schema.STRING),\n    comment: 'col2 is an array of strings' // comment is optional\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nBy default, a S3 bucket will be created to store the table's data but you can bring your own with `S3TableStorage.fromBucket` and set an `s3Prefix`:\n\n```ts\ndeclare const myBucket: s3.Bucket;\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.fromBucket(myBucket),\n  s3Prefix: 'my-table/',\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nGlue tables can be configured to contain user-defined properties, to describe the physical storage of table data, through the `storageParameters` property:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storageParameters: [\n    glue.StorageParameter.skipHeaderLineCount(1),\n    glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n    glue.StorageParameter.custom('separatorChar', ',')\n  ],\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nGlue tables can also be configured to contain user-defined table properties through the [`parameters`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-glue-table-tableinput.html#cfn-glue-table-tableinput-parameters) property:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  parameters: {\n    key1: 'val1',\n    key2: 'val2',\n  },\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Partition Keys\n\nTo improve query performance, a table can specify `partitionKeys` on which data is stored and queried separately. For example, you might partition a table by `year` and `month` to optimize queries based on a time window:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.SMALL_INT,\n  }, {\n    name: 'month',\n    type: glue.Schema.SMALL_INT,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Partition Indexes\n\nAnother way to improve query performance is to specify partition indexes. If no partition indexes are\npresent on the table, AWS Glue loads all partitions of the table and filters the loaded partitions using\nthe query expression. The query takes more time to run as the number of partitions increase. With an\nindex, the query will try to fetch a subset of the partitions instead of loading all partitions of the\ntable.\n\nThe keys of a partition index must be a subset of the partition keys of the table. You can have a\nmaximum of 3 partition indexes per table. To specify a partition index, you can use the `partitionIndexes`\nproperty:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.SMALL_INT,\n  }, {\n    name: 'month',\n    type: glue.Schema.SMALL_INT,\n  }],\n  partitionIndexes: [{\n    indexName: 'my-index', // optional\n    keyNames: ['year'],\n  }], // supply up to 3 indexes\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nAlternatively, you can call the `addPartitionIndex()` function on a table:\n\n```ts\ndeclare const myTable: glue.S3Table;\nmyTable.addPartitionIndex({\n  indexName: 'my-index',\n  keyNames: ['year'],\n});\n```\n\n### Partition Filtering\n\nIf you have a table with a large number of partitions that grows over time, consider using AWS Glue partition indexing and filtering.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n      name: 'col1',\n      type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n      name: 'year',\n      type: glue.Schema.SMALL_INT,\n  }, {\n      name: 'month',\n      type: glue.Schema.SMALL_INT,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  enablePartitionFiltering: true,\n});\n```\n\n### Partition Projection\n\nPartition projection allows Athena to automatically add new partitions as new data arrives, without requiring `ALTER TABLE ADD PARTITION` statements. This improves query performance and reduces management overhead by eliminating the need to manually manage partition metadata.\n\nFor more information, see the [AWS documentation on partition projection](https://docs.aws.amazon.com/athena/latest/ug/partition-projection.html).\n\n#### INTEGER Projection\n\nFor partition keys with sequential numeric values:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'year',\n    type: glue.Schema.INTEGER,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    year: glue.PartitionProjectionConfiguration.integer({\n      min: 2020,\n      max: 2023,\n      interval: 1,  // optional, defaults to 1\n      digits: 4,    // optional, pads with leading zeros\n    }),\n  },\n});\n```\n\n#### DATE Projection\n\nFor partition keys with date or timestamp values. Supports both fixed dates and relative dates using `NOW`:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: '2020-01-01',\n      max: '2023-12-31',\n      format: 'yyyy-MM-dd',\n      interval: 1,  // optional, defaults to 1\n      intervalUnit: glue.DateIntervalUnit.DAYS,  // optional: YEARS, MONTHS, WEEKS, DAYS, HOURS, MINUTES, SECONDS\n    }),\n  },\n});\n```\n\nYou can also use relative dates with `NOW`:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});\n```\n\n#### ENUM Projection\n\nFor partition keys with a known set of values:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'region',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    region: glue.PartitionProjectionConfiguration.enum({\n      values: ['us-east-1', 'us-west-2', 'eu-west-1'],\n    }),\n  },\n});\n```\n\n#### INJECTED Projection\n\nFor custom partition values injected at query time:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'custom',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    custom: glue.PartitionProjectionConfiguration.injected(),\n  },\n});\n```\n\n#### Multiple Partition Projections\n\nYou can configure partition projection for multiple partition keys:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [\n    {\n      name: 'year',\n      type: glue.Schema.INTEGER,\n    },\n    {\n      name: 'month',\n      type: glue.Schema.INTEGER,\n    },\n    {\n      name: 'region',\n      type: glue.Schema.STRING,\n    },\n  ],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    year: glue.PartitionProjectionConfiguration.integer({\n      min: 2020,\n      max: 2023,\n    }),\n    month: glue.PartitionProjectionConfiguration.integer({\n      min: 1,\n      max: 12,\n      digits: 2,\n    }),\n    region: glue.PartitionProjectionConfiguration.enum({\n      values: ['us-east-1', 'us-west-2'],\n    }),\n  },\n});\n```\n\n### Glue Connections\n\nGlue connections allow external data connections to third party databases and data warehouses. However, these connections can also be assigned to Glue Tables, allowing you to query external data sources using the Glue Data Catalog.\n\nWhereas `S3Table` will point to (and if needed, create) a bucket to store the tables' data, `ExternalTable` will point to an existing table in a data source. For example, to create a table in Glue that points to a table in Redshift:\n\n```ts\ndeclare const myConnection: glue.Connection;\ndeclare const myDatabase: glue.Database;\nnew glue.ExternalTable(this, 'MyTable', {\n  connection: myConnection,\n  externalDataLocation: 'default_db_public_example', // A table in Redshift\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n## Data Quality Ruleset\n\nA `DataQualityRuleset` defines a set of data quality rules — authored in Glue's\nData Quality Definition Language (DQDL) — that are evaluated against a table in\nthe Data Catalog.\n\n```ts\nnew glue.DataQualityRuleset(this, 'MyRuleset', {\n  rulesetName: 'my_ruleset',\n  dqdl: glue.Dqdl.fromString('Rules = [ RowCount > 100, IsComplete \"order_id\" ]'),\n  targetTable: new glue.DataQualityTargetTable('my_database', 'my_table'),\n});\n```\n\nBuild the DQDL document with `Dqdl.fromString(...)`. Glue parses and validates the\nDQDL when the ruleset is deployed; see the\n[DQDL reference](https://docs.aws.amazon.com/glue/latest/dg/dqdl.html) for the\nfull rule syntax.\n\n## [Encryption](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)\n\nWhen the table creates its own S3 bucket (`S3TableStorage.managedBucket`, the default), that bucket enforces SSL: a bucket policy denies any request made over plain HTTP. If you bring your own bucket with `S3TableStorage.fromBucket`, enabling `enforceSSL` on it is your responsibility.\n\nServer-side encryption applies only to a bucket the table manages. Choose it with\n`storage: glue.S3TableStorage.managedBucket(...)`:\n\n* [S3Managed](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) - (default) Server side encryption (`SSE-S3`) with an Amazon S3-managed key.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.s3Managed()),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n* [Kms](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html) - Server-side encryption (`SSE-KMS`) with an AWS KMS Key managed by the account owner.\n\n```ts\ndeclare const myDatabase: glue.Database;\n// KMS key is created automatically\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.kms()),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n\n// with an explicit KMS key\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.kms(new kms.Key(this, 'MyKey'))),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n* [KmsManaged](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html) - Server-side encryption (`SSE-KMS`), like `Kms`, except with an AWS KMS Key managed by the AWS Key Management Service.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.kmsManaged()),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nClient-side encryption ([CSE-KMS](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html#client-side-encryption-kms-managed-master-key-intro)) is independent of the bucket's server-side encryption and works with either a managed or an existing bucket. Configure it with `clientSideEncryption`:\n\n```ts\ndeclare const myDatabase: glue.Database;\n// KMS key is created automatically\nnew glue.S3Table(this, 'MyTable', {\n  clientSideEncryption: glue.TableClientSideEncryption.kms(),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n\n// with an explicit KMS key\nnew glue.S3Table(this, 'MyTable', {\n  clientSideEncryption: glue.TableClientSideEncryption.kms(new kms.Key(this, 'MyKey')),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nTo store the table's data in an existing bucket, use `glue.S3TableStorage.fromBucket(bucket)`. CDK does not manage that bucket's server-side encryption, so an encryption choice can never be paired with a provided bucket — but client-side encryption still applies.\n\n### Marking table data as encrypted\n\nBoth `S3Table` and `ExternalTable` set the `has_encrypted_data` table parameter, which\nAthena reads when querying client-side (`CSE-KMS`) encrypted datasets. It defaults to `true`.\nSet `hasEncryptedData` to `false` when the underlying data is not encrypted:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  hasEncryptedData: false,\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nDo not set `has_encrypted_data` through the free-form `parameters` map as well - a value\nthere that conflicts with `hasEncryptedData` is rejected at synthesis time.\n\n## Types\n\nA table's schema is a collection of columns, each of which have a `name` and a `type`. Types are recursive structures, consisting of primitive and complex types:\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  columns: [{\n    name: 'primitive_column',\n    type: glue.Schema.STRING,\n  }, {\n    name: 'array_column',\n    type: glue.Schema.array(glue.Schema.INTEGER),\n    comment: 'array<integer>',\n  }, {\n    name: 'map_column',\n    type: glue.Schema.map(\n      glue.Schema.STRING,\n      glue.Schema.TIMESTAMP),\n    comment: 'map<string,timestamp>',\n  }, {\n    name: 'struct_column',\n    type: glue.Schema.struct([{\n      name: 'nested_column',\n      type: glue.Schema.DATE,\n      comment: 'nested comment',\n    }]),\n    comment: \"struct<nested_column:date COMMENT 'nested comment'>\",\n  }],\n  // ...\n  database: myDatabase,\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nFor a type the `Schema` factories don't model, use `glue.Schema.custom('...')`, which takes the raw Glue input string.\n\n## Public FAQ\n\n### What are we launching today?\n\nWe’re launching new features to an AWS CDK Glue L2 Construct to provide\nbest-practice defaults and convenience methods to create Glue Jobs, Connections,\nTriggers, Workflows, and the underlying permissions and configuration.\n\n### Why should I use this Construct?\n\nDevelopers should use this Construct to reduce the amount of boilerplate\ncode and complexity each individual has to navigate, and make it easier to\ncreate best-practice Glue resources.\n\n### What’s not in scope?\n\nGlue Crawlers and other resources that are now managed by the AWS LakeFormation\nteam are not in scope for this effort. Developers should use existing methods\nto create these resources, and the new Glue L2 construct assumes they already\nexist as inputs. While best practice is for application and infrastructure code\nto be as close as possible for teams using fully-implemented DevOps mechanisms,\nin practice these ETL scripts are likely managed by a data science team who\nknow Python or Scala and don’t necessarily own or manage their own\ninfrastructure deployments. We want to meet developers where they are, and not\nassume that all of the code resides in the same repository, Developers can\nautomate this themselves via the CDK, however, if they do own both.\n\nValidating Glue version and feature use per AWS region at synth time is also\nnot in scope. AWS’ intention is for all features to eventually be propagated to\nall Global regions, so the complexity involved in creating and updating region-\nspecific configuration to match shifting feature sets does not out-weigh the\nlikelihood that a developer will use this construct to deploy resources to a\nregion without a particular new feature to a region that doesn’t yet support\nit without researching or manually attempting to use that feature before\ndeveloping it via IaC. The developer will, of course, still get feedback from\nthe underlying Glue APIs as CloudFormation deploys the resources similar to the\ncurrent CDK L1 Glue experience.\n"
   },
   "repository": {
     "directory": "packages/@aws-cdk/aws-glue-alpha",
@@ -10582,7 +10582,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "A column of a table.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\nconst column: glue_alpha.Column = {\n  name: 'name',\n  type: {\n    inputString: 'inputString',\n    isPrimitive: false,\n  },\n\n  // the properties below are optional\n  comment: 'comment',\n};",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\n\ndeclare const type: glue_alpha.Type;\nconst column: glue_alpha.Column = {\n  name: 'name',\n  type: type,\n\n  // the properties below are optional\n  comment: 'comment',\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -10660,7 +10660,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 156
+        "line": 158
       },
       "members": [
         {
@@ -10710,7 +10710,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 6
+        "line": 8
       },
       "members": [
         {
@@ -10940,7 +10940,7 @@
         },
         "locationInModule": {
           "filename": "lib/connection.ts",
-          "line": 359
+          "line": 397
         },
         "parameters": [
           {
@@ -10969,7 +10969,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/connection.ts",
-        "line": 311
+        "line": 349
       },
       "methods": [
         {
@@ -10979,7 +10979,7 @@
           },
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 323
+            "line": 361
           },
           "name": "fromConnectionArn",
           "parameters": [
@@ -11025,7 +11025,7 @@
           },
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 339
+            "line": 377
           },
           "name": "fromConnectionName",
           "parameters": [
@@ -11071,7 +11071,7 @@
           },
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 420
+            "line": 504
           },
           "name": "addProperty",
           "parameters": [
@@ -11107,7 +11107,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 314
+            "line": 352
           },
           "name": "PROPERTY_INJECTION_ID",
           "static": true,
@@ -11123,7 +11123,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 410
+            "line": 494
           },
           "name": "connectionArn",
           "overrides": "@aws-cdk/aws-glue-alpha.IConnection",
@@ -11139,7 +11139,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 402
+            "line": 486
           },
           "name": "connectionName",
           "overrides": "@aws-cdk/aws-glue-alpha.IConnection",
@@ -11156,7 +11156,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Base Connection Options.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\nimport { aws_ec2 as ec2 } from 'aws-cdk-lib';\n\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\nconst connectionOptions: glue_alpha.ConnectionOptions = {\n  connectionName: 'connectionName',\n  description: 'description',\n  matchCriteria: ['matchCriteria'],\n  properties: {\n    propertiesKey: 'properties',\n  },\n  securityGroups: [securityGroup],\n  subnet: subnet,\n};",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\nimport { aws_ec2 as ec2 } from 'aws-cdk-lib';\nimport { aws_secretsmanager as interfaces_secretsmanager } from 'aws-cdk-lib/interfaces';\n\ndeclare const secretRef: interfaces_secretsmanager.ISecretRef;\ndeclare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\ndeclare const subnetFilter: ec2.SubnetFilter;\ndeclare const vpc: ec2.Vpc;\nconst connectionOptions: glue_alpha.ConnectionOptions = {\n  connectionName: 'connectionName',\n  description: 'description',\n  matchCriteria: ['matchCriteria'],\n  properties: {\n    propertiesKey: 'properties',\n  },\n  secret: secretRef,\n  securityGroups: [securityGroup],\n  subnet: subnet,\n  vpc: vpc,\n  vpcSubnets: {\n    availabilityZones: ['availabilityZones'],\n    onePerAz: false,\n    subnetFilters: [subnetFilter],\n    subnetGroupName: 'subnetGroupName',\n    subnets: [subnet],\n    subnetType: ec2.SubnetType.PRIVATE_ISOLATED,\n  },\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -11165,7 +11165,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/connection.ts",
-        "line": 258
+        "line": 259
       },
       "name": "ConnectionOptions",
       "properties": [
@@ -11179,7 +11179,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 263
+            "line": 264
           },
           "name": "connectionName",
           "optional": true,
@@ -11197,7 +11197,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 269
+            "line": 270
           },
           "name": "description",
           "optional": true,
@@ -11216,7 +11216,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 283
+            "line": 296
           },
           "name": "matchCriteria",
           "optional": true,
@@ -11240,7 +11240,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 276
+            "line": 277
           },
           "name": "properties",
           "optional": true,
@@ -11253,6 +11253,25 @@
             }
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no secret; any credentials must be supplied via `properties`",
+            "remarks": "The secret is referenced through the connection's `SECRET_ID` property, so\nGlue reads the credentials at runtime and the secret value never appears in\nthe synthesized template. Prefer this over placing credentials directly in\n`properties`. Accepts any `secretsmanager.ISecret`.",
+            "stability": "experimental",
+            "summary": "A reference to a Secrets Manager secret holding the credentials for this connection."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/connection.ts",
+            "line": 289
+          },
+          "name": "secret",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.interfaces.aws_secretsmanager.ISecretRef"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -11263,7 +11282,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 289
+            "line": 302
           },
           "name": "securityGroups",
           "optional": true,
@@ -11279,21 +11298,59 @@
         {
           "abstract": true,
           "docs": {
-            "default": "no subnet",
-            "remarks": "See more at https://docs.aws.amazon.com/glue/latest/dg/start-connecting.html.",
+            "default": "- no subnet, unless `vpc` is provided",
+            "remarks": "Mutually exclusive with `vpc`: provide `subnet` to pin the connection to a\nspecific subnet, or provide `vpc` (optionally with `vpcSubnets`) to let the\nCDK select one for you.",
             "stability": "experimental",
-            "summary": "The VPC subnet to connect to resources within a VPC."
+            "summary": "The VPC subnet to connect to resources within a VPC. See more at https://docs.aws.amazon.com/glue/latest/dg/start-connecting.html."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 295
+            "line": 313
           },
           "name": "subnet",
           "optional": true,
           "type": {
             "fqn": "aws-cdk-lib.aws_ec2.ISubnet"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no VPC, the subnet is taken from `subnet` if provided",
+            "remarks": "When provided, the CDK selects a\nsubnet from this VPC using `vpcSubnets`. A Glue connection targets a single\nsubnet, so the first subnet of the selection is used.\n\nMutually exclusive with `subnet`.",
+            "stability": "experimental",
+            "summary": "The VPC to connect to resources within."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/connection.ts",
+            "line": 324
+          },
+          "name": "vpc",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- private subnets",
+            "remarks": "Only used when\n`vpc` is provided. Since a Glue connection targets a single subnet, the\nfirst subnet of the selection is used.",
+            "stability": "experimental",
+            "summary": "Which subnets of `vpc` to select the connection subnet from."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/connection.ts",
+            "line": 333
+          },
+          "name": "vpcSubnets",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.SubnetSelection"
+          }
         }
       ],
       "symbolId": "lib/connection:ConnectionOptions"
@@ -11365,7 +11422,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Construction properties for `Connection`.",
-        "example": "declare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  // The security groups granting AWS Glue inbound access to the data source within the VPC\n  securityGroups: [securityGroup],\n  // The VPC subnet which contains the data source\n  subnet,\n});",
+        "example": "declare const securityGroup: ec2.SecurityGroup;\ndeclare const vpc: ec2.Vpc;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  securityGroups: [securityGroup],\n  vpc,\n  // Optional - defaults to private subnets\n  vpcSubnets: { subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -11377,7 +11434,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/connection.ts",
-        "line": 301
+        "line": 339
       },
       "name": "ConnectionProps",
       "properties": [
@@ -11390,7 +11447,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 305
+            "line": 343
           },
           "name": "type",
           "type": {
@@ -11407,7 +11464,7 @@
         "see": "https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-glue-connection-connectioninput.html#cfn-glue-connection-connectioninput-connectiontype",
         "stability": "experimental",
         "summary": "The type of the glue connection.",
-        "example": "declare const securityGroup: ec2.SecurityGroup;\ndeclare const subnet: ec2.Subnet;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  // The security groups granting AWS Glue inbound access to the data source within the VPC\n  securityGroups: [securityGroup],\n  // The VPC subnet which contains the data source\n  subnet,\n});",
+        "example": "declare const securityGroup: ec2.SecurityGroup;\ndeclare const vpc: ec2.Vpc;\nnew glue.Connection(this, 'MyConnection', {\n  type: glue.ConnectionType.NETWORK,\n  securityGroups: [securityGroup],\n  vpc,\n  // Optional - defaults to private subnets\n  vpcSubnets: { subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -11419,7 +11476,7 @@
         },
         "locationInModule": {
           "filename": "lib/connection.ts",
-          "line": 226
+          "line": 227
         },
         "parameters": [
           {
@@ -11433,7 +11490,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/connection.ts",
-        "line": 18
+        "line": 19
       },
       "methods": [
         {
@@ -11443,7 +11500,7 @@
           },
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 233
+            "line": 234
           },
           "name": "toString",
           "returns": {
@@ -11464,7 +11521,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 174
+            "line": 175
           },
           "name": "AZURECOSMOS",
           "static": true,
@@ -11481,7 +11538,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 169
+            "line": 170
           },
           "name": "AZURESQL",
           "static": true,
@@ -11498,7 +11555,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 164
+            "line": 165
           },
           "name": "BIGQUERY",
           "static": true,
@@ -11515,7 +11572,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 59
+            "line": 60
           },
           "name": "CUSTOM",
           "static": true,
@@ -11532,7 +11589,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 219
+            "line": 220
           },
           "name": "DYNAMODB",
           "static": true,
@@ -11549,7 +11606,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 64
+            "line": 65
           },
           "name": "FACEBOOKADS",
           "static": true,
@@ -11566,7 +11623,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 69
+            "line": 70
           },
           "name": "GOOGLEADS",
           "static": true,
@@ -11583,7 +11640,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 79
+            "line": 80
           },
           "name": "GOOGLEANALYTICS4",
           "static": true,
@@ -11600,7 +11657,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 74
+            "line": 75
           },
           "name": "GOOGLESHEETS",
           "static": true,
@@ -11617,7 +11674,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 84
+            "line": 85
           },
           "name": "HUBSPOT",
           "static": true,
@@ -11634,7 +11691,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 89
+            "line": 90
           },
           "name": "INSTAGRAMADS",
           "static": true,
@@ -11651,7 +11708,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 94
+            "line": 95
           },
           "name": "INTERCOM",
           "static": true,
@@ -11668,7 +11725,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 22
+            "line": 23
           },
           "name": "JDBC",
           "static": true,
@@ -11685,7 +11742,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 99
+            "line": 100
           },
           "name": "JIRACLOUD",
           "static": true,
@@ -11702,7 +11759,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 27
+            "line": 28
           },
           "name": "KAFKA",
           "static": true,
@@ -11719,7 +11776,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 104
+            "line": 105
           },
           "name": "MARKETO",
           "static": true,
@@ -11736,7 +11793,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 53
+            "line": 54
           },
           "name": "MARKETPLACE",
           "static": true,
@@ -11753,7 +11810,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 32
+            "line": 33
           },
           "name": "MONGODB",
           "static": true,
@@ -11770,7 +11827,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 184
+            "line": 185
           },
           "name": "MYSQL",
           "static": true,
@@ -11787,7 +11844,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 109
+            "line": 110
           },
           "name": "NETSUITEERP",
           "static": true,
@@ -11804,7 +11861,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 47
+            "line": 48
           },
           "name": "NETWORK",
           "static": true,
@@ -11821,7 +11878,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 179
+            "line": 180
           },
           "name": "OPENSEARCH",
           "static": true,
@@ -11838,7 +11895,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 194
+            "line": 195
           },
           "name": "ORACLE",
           "static": true,
@@ -11855,7 +11912,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 189
+            "line": 190
           },
           "name": "POSTGRESQL",
           "static": true,
@@ -11872,7 +11929,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 114
+            "line": 115
           },
           "name": "SALESFORCE",
           "static": true,
@@ -11889,7 +11946,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 119
+            "line": 120
           },
           "name": "SALESFORCEMARKETINGCLOUD",
           "static": true,
@@ -11906,7 +11963,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 124
+            "line": 125
           },
           "name": "SALESFORCEPARDOT",
           "static": true,
@@ -11923,7 +11980,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 204
+            "line": 205
           },
           "name": "SAPHANA",
           "static": true,
@@ -11940,7 +11997,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 129
+            "line": 130
           },
           "name": "SAPODATA",
           "static": true,
@@ -11957,7 +12014,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 134
+            "line": 135
           },
           "name": "SERVICENOW",
           "static": true,
@@ -11974,7 +12031,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 139
+            "line": 140
           },
           "name": "SLACK",
           "static": true,
@@ -11991,7 +12048,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 144
+            "line": 145
           },
           "name": "SNAPCHATADS",
           "static": true,
@@ -12008,7 +12065,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 199
+            "line": 200
           },
           "name": "SQLSERVER",
           "static": true,
@@ -12025,7 +12082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 149
+            "line": 150
           },
           "name": "STRIPE",
           "static": true,
@@ -12042,7 +12099,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 209
+            "line": 210
           },
           "name": "TERADATA",
           "static": true,
@@ -12059,7 +12116,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 214
+            "line": 215
           },
           "name": "VERTICA",
           "static": true,
@@ -12076,7 +12133,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 42
+            "line": 43
           },
           "name": "VIEW_VALIDATION_ATHENA",
           "static": true,
@@ -12093,7 +12150,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 37
+            "line": 38
           },
           "name": "VIEW_VALIDATION_REDSHIFT",
           "static": true,
@@ -12110,7 +12167,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 154
+            "line": 155
           },
           "name": "ZENDESK",
           "static": true,
@@ -12127,7 +12184,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 159
+            "line": 160
           },
           "name": "ZOHOCRM",
           "static": true,
@@ -12143,7 +12200,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 224
+            "line": 225
           },
           "name": "name",
           "type": {
@@ -12572,7 +12629,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Defines the input/output formats and ser/de for a single DataFormat.",
-        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: '2020-01-01',\n      max: '2023-12-31',\n      format: 'yyyy-MM-dd',\n      interval: 1,  // optional, defaults to 1\n      intervalUnit: glue.DateIntervalUnit.DAYS,  // optional: YEARS, MONTHS, WEEKS, DAYS, HOURS, MINUTES, SECONDS\n    }),\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -13760,8 +13817,8 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- 1 for single-day or single-month precision, otherwise required",
-            "remarks": "When the provided dates are at single-day or single-month precision,\nthe interval is optional and defaults to 1 day or 1 month, respectively.\nOtherwise, interval is required.",
+            "default": "- Athena's default step for the format's precision; required when `format` is sub-day precision",
+            "remarks": "Required (together with `intervalUnit`) when `format` carries sub-day\nprecision — i.e. a field finer than a day, such as hours or AM/PM. At day\nor coarser precision Athena defaults the step, so it is optional.",
             "stability": "experimental",
             "summary": "Interval between partition values."
           },
@@ -13779,8 +13836,8 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- DAYS for single-day precision, MONTHS for single-month precision, otherwise required",
-            "remarks": "When the provided dates are at single-day or single-month precision,\nthe intervalUnit is optional and defaults to 1 day or 1 month, respectively.\nOtherwise, the intervalUnit is required.",
+            "default": "- Athena's default unit for the format's precision; required when `format` is sub-day precision",
+            "remarks": "Required (together with `interval`) when `format` carries sub-day\nprecision — i.e. a field finer than a day, such as hours or AM/PM. At day\nor coarser precision Athena defaults the step, so it is optional.",
             "stability": "experimental",
             "summary": "Unit for the interval."
           },
@@ -14459,7 +14516,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/connection.ts",
-        "line": 241
+        "line": 242
       },
       "name": "IConnection",
       "properties": [
@@ -14475,7 +14532,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 252
+            "line": 253
           },
           "name": "connectionArn",
           "type": {
@@ -14494,7 +14551,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/connection.ts",
-            "line": 246
+            "line": 247
           },
           "name": "connectionName",
           "type": {
@@ -15477,7 +15534,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 33
+        "line": 35
       },
       "members": [
         {
@@ -16858,7 +16915,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 65
+        "line": 67
       },
       "members": [
         {
@@ -16927,7 +16984,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 200
+        "line": 202
       },
       "members": [
         {
@@ -17148,7 +17205,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/partition-projection.ts",
-        "line": 230
+        "line": 269
       },
       "methods": [
         {
@@ -17158,7 +17215,7 @@
           },
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 288
+            "line": 327
           },
           "name": "date",
           "parameters": [
@@ -17183,7 +17240,7 @@
           },
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 373
+            "line": 424
           },
           "name": "enum",
           "parameters": [
@@ -17210,7 +17267,7 @@
           },
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 413
+            "line": 464
           },
           "name": "injected",
           "returns": {
@@ -17227,7 +17284,7 @@
           },
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 234
+            "line": 273
           },
           "name": "integer",
           "parameters": [
@@ -17256,7 +17313,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 422
+            "line": 473
           },
           "name": "type",
           "type": {
@@ -17272,7 +17329,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 436
+            "line": 487
           },
           "name": "dateRange",
           "optional": true,
@@ -17293,7 +17350,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 446
+            "line": 497
           },
           "name": "digits",
           "optional": true,
@@ -17309,7 +17366,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 451
+            "line": 502
           },
           "name": "format",
           "optional": true,
@@ -17326,7 +17383,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 429
+            "line": 480
           },
           "name": "integerRange",
           "optional": true,
@@ -17347,7 +17404,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 441
+            "line": 492
           },
           "name": "interval",
           "optional": true,
@@ -17363,7 +17420,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 456
+            "line": 507
           },
           "name": "intervalUnit",
           "optional": true,
@@ -17379,7 +17436,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/partition-projection.ts",
-            "line": 461
+            "line": 512
           },
           "name": "values",
           "optional": true,
@@ -19011,7 +19068,7 @@
         },
         "stability": "experimental",
         "summary": "A Glue table that targets a S3 dataset.",
-        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});"
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: '2020-01-01',\n      max: '2023-12-31',\n      format: 'yyyy-MM-dd',\n      interval: 1,  // optional, defaults to 1\n      intervalUnit: glue.DateIntervalUnit.DAYS,  // optional: YEARS, MONTHS, WEEKS, DAYS, HOURS, MINUTES, SECONDS\n    }),\n  },\n});"
       },
       "fqn": "@aws-cdk/aws-glue-alpha.S3Table",
       "initializer": {
@@ -19020,7 +19077,7 @@
         },
         "locationInModule": {
           "filename": "lib/s3-table.ts",
-          "line": 134
+          "line": 204
         },
         "parameters": [
           {
@@ -19046,7 +19103,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/s3-table.ts",
-        "line": 93
+        "line": 165
       },
       "methods": [
         {
@@ -19055,7 +19112,7 @@
           },
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 260
+            "line": 333
           },
           "name": "generateS3PrefixForGrant",
           "protected": true,
@@ -19073,7 +19130,7 @@
           },
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 224
+            "line": 297
           },
           "name": "grantRead",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19102,7 +19159,7 @@
           },
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 252
+            "line": 325
           },
           "name": "grantReadWrite",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19131,7 +19188,7 @@
           },
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 238
+            "line": 311
           },
           "name": "grantWrite",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19164,7 +19221,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 96
+            "line": 168
           },
           "name": "PROPERTY_INJECTION_ID",
           "static": true,
@@ -19180,28 +19237,13 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 103
+            "line": 175
           },
           "name": "bucket",
           "type": {
             "fqn": "aws-cdk-lib.aws_s3.IBucket"
           }
         },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The type of encryption enabled for the table."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/s3-table.ts",
-            "line": 113
-          },
-          "name": "encryption",
-          "type": {
-            "fqn": "@aws-cdk/aws-glue-alpha.TableEncryption"
-          }
-        },
         {
           "docs": {
             "stability": "experimental",
@@ -19210,7 +19252,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 108
+            "line": 180
           },
           "name": "s3Prefix",
           "type": {
@@ -19225,7 +19267,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 209
+            "line": 282
           },
           "name": "tableArn",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19241,7 +19283,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 201
+            "line": 274
           },
           "name": "tableName",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19256,7 +19298,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 125
+            "line": 195
           },
           "name": "tableResource",
           "overrides": "@aws-cdk/aws-glue-alpha.TableBase",
@@ -19267,16 +19309,16 @@
         },
         {
           "docs": {
-            "remarks": "Otherwise, `undefined`.",
+            "remarks": "For server-side (bucket) encryption, read `bucket.encryptionKey` instead.",
             "stability": "experimental",
-            "summary": "The KMS key used to secure the data if `encryption` is set to `CSE-KMS` or `SSE-KMS`."
+            "summary": "The KMS key used for client-side encryption of the table's data, if `clientSideEncryption` was configured. Otherwise, `undefined`."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 118
+            "line": 188
           },
-          "name": "encryptionKey",
+          "name": "clientSideEncryptionKey",
           "optional": true,
           "type": {
             "fqn": "aws-cdk-lib.aws_kms.IKey"
@@ -19290,7 +19332,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 123
+            "line": 193
           },
           "name": "partitionIndexes",
           "optional": true,
@@ -19307,6 +19349,92 @@
       ],
       "symbolId": "lib/s3-table:S3Table"
     },
+    "@aws-cdk/aws-glue-alpha.S3TableEncryption": {
+      "assembly": "@aws-cdk/aws-glue-alpha",
+      "docs": {
+        "remarks": "Applies only when the table manages its own bucket (via\n`S3TableStorage.managedBucket`). An existing bucket keeps whatever encryption\nit was created with.",
+        "stability": "experimental",
+        "summary": "Server-side encryption for the S3 bucket that a managed `S3Table` creates.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.s3Managed()),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-glue-alpha.S3TableEncryption",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/s3-table.ts",
+        "line": 21
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Server-side encryption (SSE-KMS) with an AWS KMS key managed by the account owner."
+          },
+          "locationInModule": {
+            "filename": "lib/s3-table.ts",
+            "line": 34
+          },
+          "name": "kms",
+          "parameters": [
+            {
+              "docs": {
+                "remarks": "A key is created if one is not provided.",
+                "summary": "the KMS key used to encrypt the data."
+              },
+              "name": "key",
+              "optional": true,
+              "type": {
+                "fqn": "aws-cdk-lib.aws_kms.IKey"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.S3TableEncryption"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Server-side encryption (SSE-KMS) with an AWS KMS key managed by the KMS service."
+          },
+          "locationInModule": {
+            "filename": "lib/s3-table.ts",
+            "line": 41
+          },
+          "name": "kmsManaged",
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.S3TableEncryption"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Server-side encryption (SSE-S3) with an Amazon S3-managed key."
+          },
+          "locationInModule": {
+            "filename": "lib/s3-table.ts",
+            "line": 25
+          },
+          "name": "s3Managed",
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.S3TableEncryption"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "S3TableEncryption",
+      "symbolId": "lib/s3-table:S3TableEncryption"
+    },
     "@aws-cdk/aws-glue-alpha.S3TableProps": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
@@ -19324,87 +19452,149 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/s3-table.ts",
-        "line": 47
+        "line": 130
       },
       "name": "S3TableProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "one is created for you",
+            "default": "- no client-side encryption",
+            "remarks": "Independent of the bucket's server-side encryption, and valid whether the\nbucket is managed or provided.",
             "stability": "experimental",
-            "summary": "S3 bucket in which to store data."
+            "summary": "Client-side encryption (CSE-KMS) for the table's data."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 53
+            "line": 158
           },
-          "name": "bucket",
+          "name": "clientSideEncryption",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
+            "fqn": "@aws-cdk/aws-glue-alpha.TableClientSideEncryption"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "BucketEncryption.S3_MANAGED",
-            "remarks": "You can only provide this option if you are not explicitly passing in a bucket.\n\nIf you choose `SSE-KMS`, you *can* provide an un-managed KMS key with `encryptionKey`.\nIf you choose `CSE-KMS`, you *may* provide an un-managed KMS key with `encryptionKey`;\none is created automatically if omitted.",
+            "default": "- No prefix. The data will be stored under the root of the bucket.",
+            "remarks": "When the table shares a bucket with other tables or consumers, set this so\nthat the `grant*` methods scope S3 access to this table's data. Without a\nprefix, those grants cover the entire bucket.",
             "stability": "experimental",
-            "summary": "The kind of encryption to secure the data with."
+            "summary": "S3 prefix under which table objects are stored."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 77
+            "line": 148
           },
-          "name": "encryption",
+          "name": "s3Prefix",
           "optional": true,
           "type": {
-            "fqn": "@aws-cdk/aws-glue-alpha.TableEncryption"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "key is managed by KMS.",
-            "remarks": "The `encryption` property must be `SSE-KMS` or `CSE-KMS`.",
+            "default": "- a managed bucket with S3-managed (SSE-S3) encryption",
             "stability": "experimental",
-            "summary": "External KMS key to use for bucket encryption."
+            "summary": "Where the table's data is stored: a bucket created and managed by the table, or an existing bucket you provide."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 86
+            "line": 137
           },
-          "name": "encryptionKey",
+          "name": "storage",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_kms.IKey"
+            "fqn": "@aws-cdk/aws-glue-alpha.S3TableStorage"
           }
-        },
-        {
-          "abstract": true,
+        }
+      ],
+      "symbolId": "lib/s3-table:S3TableProps"
+    },
+    "@aws-cdk/aws-glue-alpha.S3TableStorage": {
+      "assembly": "@aws-cdk/aws-glue-alpha",
+      "docs": {
+        "remarks": "The two paths are mutually exclusive: a managed bucket may specify its\nserver-side encryption, while an existing bucket keeps its own encryption — so\nan encryption choice can never be paired with a bring-your-own bucket.",
+        "stability": "experimental",
+        "summary": "Where an `S3Table` stores its data.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  storage: glue.S3TableStorage.managedBucket(glue.S3TableEncryption.s3Managed()),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-glue-alpha.S3TableStorage",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/s3-table.ts",
+        "line": 64
+      },
+      "methods": [
+        {
           "docs": {
-            "default": "- No prefix. The data will be stored under the root of the bucket.",
-            "remarks": "When the table shares a bucket with other tables or consumers, set this so\nthat the `grant*` methods scope S3 access to this table's data. Without a\nprefix, those grants cover the entire bucket.",
+            "remarks": "The bucket can be one you don't own, imported with\n`Bucket.fromBucketArn()` or `Bucket.fromBucketAttributes()`. If that bucket\nis KMS-encrypted, import it with `Bucket.fromBucketAttributes()` and supply\nthe `encryptionKey` attribute. Otherwise, CDK has no reference to the key,\nwhich means that `S3Table.grantRead()`/`grantWrite()` will correctly grant\nS3 access but silently skip the KMS permissions on the key. As a consequence,\nat runtime, reads and writes will fail with access denied on the key.",
             "stability": "experimental",
-            "summary": "S3 prefix under which table objects are stored."
+            "summary": "Store the table's data in an existing bucket. CDK does not manage the bucket's encryption."
           },
-          "immutable": true,
           "locationInModule": {
             "filename": "lib/s3-table.ts",
-            "line": 64
+            "line": 89
           },
-          "name": "s3Prefix",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
+          "name": "fromBucket",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "the bucket that holds the table's data."
+              },
+              "name": "bucket",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_s3.IBucket"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.S3TableStorage"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "default": "- S3-managed (SSE-S3) encryption",
+            "stability": "experimental",
+            "summary": "Store the table's data in a bucket created and managed by the table."
+          },
+          "locationInModule": {
+            "filename": "lib/s3-table.ts",
+            "line": 71
+          },
+          "name": "managedBucket",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "the server-side encryption for the created bucket."
+              },
+              "name": "encryption",
+              "optional": true,
+              "type": {
+                "fqn": "@aws-cdk/aws-glue-alpha.S3TableEncryption"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.S3TableStorage"
+            }
+          },
+          "static": true
         }
       ],
-      "symbolId": "lib/s3-table:S3TableProps"
+      "name": "S3TableStorage",
+      "symbolId": "lib/s3-table:S3TableStorage"
     },
     "@aws-cdk/aws-glue-alpha.ScalaSparkEtlJob": {
       "assembly": "@aws-cdk/aws-glue-alpha",
@@ -20116,7 +20306,7 @@
       "docs": {
         "see": "https://docs.aws.amazon.com/athena/latest/ug/data-types.html",
         "stability": "experimental",
-        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n      name: 'col1',\n      type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n      name: 'year',\n      type: glue.Schema.SMALL_INT,\n  }, {\n      name: 'month',\n      type: glue.Schema.SMALL_INT,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  enablePartitionFiltering: true,\n});",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -20130,7 +20320,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/schema.ts",
-        "line": 44
+        "line": 62
       },
       "methods": [
         {
@@ -20140,7 +20330,7 @@
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 177
+            "line": 158
           },
           "name": "array",
           "parameters": [
@@ -20168,7 +20358,7 @@
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 141
+            "line": 128
           },
           "name": "char",
           "parameters": [
@@ -20191,19 +20381,59 @@
         },
         {
           "docs": {
-            "remarks": "TODO: Bounds",
+            "remarks": "Escape hatch for column types the other `Schema` factories don't model. The\n`inputString` is emitted verbatim and is not validated.",
+            "stability": "experimental",
+            "summary": "Creates a custom type from a raw Glue input string."
+          },
+          "locationInModule": {
+            "filename": "lib/schema.ts",
+            "line": 195
+          },
+          "name": "custom",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "the Glue input string for the type (for example `interval_day_to_second`)."
+              },
+              "name": "inputString",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "docs": {
+                "remarks": "Defaults to true.",
+                "summary": "whether the type is a primitive (non-nested) data type."
+              },
+              "name": "isPrimitive",
+              "optional": true,
+              "type": {
+                "primitive": "boolean"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.Type"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "see": "https://docs.aws.amazon.com/athena/latest/ug/data-types.html",
             "stability": "experimental",
             "summary": "Creates a decimal type."
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 129
+            "line": 113
           },
           "name": "decimal",
           "parameters": [
             {
               "docs": {
-                "summary": "the total number of digits."
+                "summary": "the total number of digits, between 1 and 38."
               },
               "name": "precision",
               "type": {
@@ -20212,7 +20442,8 @@
             },
             {
               "docs": {
-                "summary": "the number of digits in fractional part, the default is 0."
+                "remarks": "the default is 0",
+                "summary": "the number of digits in the fractional part, between 0 and 38;"
               },
               "name": "scale",
               "optional": true,
@@ -20235,7 +20466,7 @@
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 190
+            "line": 168
           },
           "name": "map",
           "parameters": [
@@ -20272,7 +20503,7 @@
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 205
+            "line": 180
           },
           "name": "struct",
           "parameters": [
@@ -20305,7 +20536,7 @@
           },
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 159
+            "line": 143
           },
           "name": "varchar",
           "parameters": [
@@ -20338,7 +20569,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 58
+            "line": 70
           },
           "name": "BIG_INT",
           "static": true,
@@ -20354,7 +20585,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 50
+            "line": 65
           },
           "name": "BINARY",
           "static": true,
@@ -20370,7 +20601,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 45
+            "line": 63
           },
           "name": "BOOLEAN",
           "static": true,
@@ -20387,7 +20618,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 100
+            "line": 94
           },
           "name": "DATE",
           "static": true,
@@ -20403,7 +20634,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 63
+            "line": 72
           },
           "name": "DOUBLE",
           "static": true,
@@ -20419,7 +20650,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 68
+            "line": 74
           },
           "name": "FLOAT",
           "static": true,
@@ -20436,7 +20667,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 76
+            "line": 79
           },
           "name": "INTEGER",
           "static": true,
@@ -20470,7 +20701,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 116
+            "line": 104
           },
           "name": "STRING",
           "static": true,
@@ -20487,7 +20718,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 108
+            "line": 99
           },
           "name": "TIMESTAMP",
           "static": true,
@@ -20504,7 +20735,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 92
+            "line": 89
           },
           "name": "TINY_INT",
           "static": true,
@@ -21545,7 +21776,7 @@
         },
         "locationInModule": {
           "filename": "lib/storage-parameter.ts",
-          "line": 422
+          "line": 434
         },
         "parameters": [
           {
@@ -21566,7 +21797,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 303
+        "line": 305
       },
       "methods": [
         {
@@ -21577,7 +21808,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 363
+            "line": 365
           },
           "name": "columnCountMismatchHandling",
           "parameters": [
@@ -21603,7 +21834,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 321
+            "line": 323
           },
           "name": "compressionType",
           "parameters": [
@@ -21628,7 +21859,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 418
+            "line": 430
           },
           "name": "custom",
           "parameters": [
@@ -21647,7 +21878,7 @@
               },
               "name": "value",
               "type": {
-                "primitive": "any"
+                "primitive": "string"
               }
             }
           ],
@@ -21665,7 +21896,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 314
+            "line": 316
           },
           "name": "dataCleansingEnabled",
           "parameters": [
@@ -21690,7 +21921,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 328
+            "line": 330
           },
           "name": "invalidCharHandling",
           "parameters": [
@@ -21715,7 +21946,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 342
+            "line": 344
           },
           "name": "numericOverflowHandling",
           "parameters": [
@@ -21741,7 +21972,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 370
+            "line": 372
           },
           "name": "numRows",
           "parameters": [
@@ -21768,7 +21999,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 386
+            "line": 388
           },
           "name": "orcSchemaResolution",
           "parameters": [
@@ -21793,7 +22024,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 335
+            "line": 337
           },
           "name": "replacementChar",
           "parameters": [
@@ -21818,7 +22049,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 377
+            "line": 379
           },
           "name": "serializationNullFormat",
           "parameters": [
@@ -21843,7 +22074,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 307
+            "line": 309
           },
           "name": "skipHeaderLineCount",
           "parameters": [
@@ -21869,7 +22100,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 349
+            "line": 351
           },
           "name": "surplusBytesHandling",
           "parameters": [
@@ -21895,7 +22126,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 356
+            "line": 358
           },
           "name": "surplusCharHandling",
           "parameters": [
@@ -21915,19 +22146,21 @@
         },
         {
           "docs": {
+            "remarks": "Redshift Spectrum accepts either the key's ARN or its bare key ID for the\n`write.kms.key.id` property, and encrypts the written objects with that key;\nthis renders the ARN. To use the S3 bucket's default KMS key instead, set the\nliteral value `auto` via `StorageParameter.custom('write.kms.key.id', 'auto')` —\nthis typed factory cannot express `auto`.",
+            "see": "https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_TABLE.html",
             "stability": "experimental",
-            "summary": "You can specify an AWS Key Management Service key to enable Server–Side Encryption (SSE) for Amazon S3 objects."
+            "summary": "Enables server-side encryption (SSE-KMS) with the given AWS KMS key on the files Redshift Spectrum writes for this table (via `CREATE EXTERNAL TABLE AS` or `INSERT`)."
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 409
+            "line": 421
           },
           "name": "writeKmsKeyId",
           "parameters": [
             {
-              "name": "value",
+              "name": "key",
               "type": {
-                "primitive": "string"
+                "fqn": "aws-cdk-lib.interfaces.aws_kms.IKeyRef"
               }
             }
           ],
@@ -21946,7 +22179,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 402
+            "line": 404
           },
           "name": "writeMaxFileSizeMb",
           "parameters": [
@@ -21973,7 +22206,7 @@
           },
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 395
+            "line": 397
           },
           "name": "writeParallel",
           "parameters": [
@@ -22001,7 +22234,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 422
+            "line": 434
           },
           "name": "key",
           "type": {
@@ -22015,7 +22248,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/storage-parameter.ts",
-            "line": 422
+            "line": 434
           },
           "name": "value",
           "type": {
@@ -22030,7 +22263,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "The storage parameter keys that are currently known, this list is not exhaustive and other keys may be used.",
-        "example": "   declare const glueDatabase: glue.IDatabase;\n   const table = new glue.Table(this, 'Table', {\n     storageParameters: [\n         glue.StorageParameter.skipHeaderLineCount(1),\n         glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n         glue.StorageParameter.custom('foo', 'bar'), // Will have no effect\n         glue.StorageParameter.custom('separatorChar', ','), // Will describe the separator char used in the data\n         glue.StorageParameter.custom(glue.StorageParameters.WRITE_PARALLEL, 'off'),\n     ],\n     // ...\n     database: glueDatabase,\n     columns: [{\n         name: 'col1',\n         type: glue.Schema.STRING,\n     }],\n     dataFormat: glue.DataFormat.CSV,\n   });",
+        "example": "   declare const glueDatabase: glue.IDatabase;\n   const table = new glue.S3Table(this, 'Table', {\n     storageParameters: [\n         glue.StorageParameter.skipHeaderLineCount(1),\n         glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n         glue.StorageParameter.custom('foo', 'bar'), // Will have no effect\n         glue.StorageParameter.custom('separatorChar', ','), // Will describe the separator char used in the data\n         glue.StorageParameter.custom(glue.StorageParameters.WRITE_PARALLEL, 'off'),\n     ],\n     // ...\n     database: glueDatabase,\n     columns: [{\n         name: 'col1',\n         type: glue.Schema.STRING,\n     }],\n     dataFormat: glue.DataFormat.CSV,\n   });",
         "custom": {
           "exampleMetadata": "infused"
         }
@@ -22039,7 +22272,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 215
+        "line": 217
       },
       "members": [
         {
@@ -22171,7 +22404,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 92
+        "line": 94
       },
       "members": [
         {
@@ -22225,7 +22458,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 124
+        "line": 126
       },
       "members": [
         {
@@ -22267,76 +22500,6 @@
       "name": "SurplusCharHandlingAction",
       "symbolId": "lib/storage-parameter:SurplusCharHandlingAction"
     },
-    "@aws-cdk/aws-glue-alpha.Table": {
-      "assembly": "@aws-cdk/aws-glue-alpha",
-      "base": "@aws-cdk/aws-glue-alpha.S3Table",
-      "docs": {
-        "deprecated": "Use {@link S3Table } instead.",
-        "stability": "deprecated",
-        "summary": "A Glue table.",
-        "example": "   declare const glueDatabase: glue.IDatabase;\n   const table = new glue.Table(this, 'Table', {\n     storageParameters: [\n         glue.StorageParameter.skipHeaderLineCount(1),\n         glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n         glue.StorageParameter.custom('foo', 'bar'), // Will have no effect\n         glue.StorageParameter.custom('separatorChar', ','), // Will describe the separator char used in the data\n         glue.StorageParameter.custom(glue.StorageParameters.WRITE_PARALLEL, 'off'),\n     ],\n     // ...\n     database: glueDatabase,\n     columns: [{\n         name: 'col1',\n         type: glue.Schema.STRING,\n     }],\n     dataFormat: glue.DataFormat.CSV,\n   });",
-        "custom": {
-          "exampleMetadata": "infused"
-        }
-      },
-      "fqn": "@aws-cdk/aws-glue-alpha.Table",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "lib/s3-table.ts",
-          "line": 134
-        },
-        "parameters": [
-          {
-            "name": "scope",
-            "type": {
-              "fqn": "constructs.Construct"
-            }
-          },
-          {
-            "name": "id",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "name": "props",
-            "type": {
-              "fqn": "@aws-cdk/aws-glue-alpha.S3TableProps"
-            }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "lib/table-deprecated.ts",
-        "line": 12
-      },
-      "name": "Table",
-      "properties": [
-        {
-          "const": true,
-          "docs": {
-            "stability": "deprecated",
-            "summary": "Uniquely identifies this class."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "lib/table-deprecated.ts",
-            "line": 15
-          },
-          "name": "PROPERTY_INJECTION_ID",
-          "overrides": "@aws-cdk/aws-glue-alpha.S3Table",
-          "static": true,
-          "type": {
-            "primitive": "string"
-          }
-        }
-      ],
-      "symbolId": "lib/table-deprecated:Table"
-    },
     "@aws-cdk/aws-glue-alpha.TableAttributes": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
@@ -22945,7 +23108,7 @@
       "datatype": true,
       "docs": {
         "stability": "experimental",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\n\ndeclare const database: glue_alpha.Database;\ndeclare const dataFormat: glue_alpha.DataFormat;\ndeclare const partitionProjectionConfiguration: glue_alpha.PartitionProjectionConfiguration;\ndeclare const storageParameter: glue_alpha.StorageParameter;\nconst tableBaseProps: glue_alpha.TableBaseProps = {\n  columns: [{\n    name: 'name',\n    type: {\n      inputString: 'inputString',\n      isPrimitive: false,\n    },\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  database: database,\n  dataFormat: dataFormat,\n\n  // the properties below are optional\n  compressed: false,\n  description: 'description',\n  enablePartitionFiltering: false,\n  hasEncryptedData: false,\n  parameters: {\n    parametersKey: 'parameters',\n  },\n  partitionIndexes: [{\n    keyNames: ['keyNames'],\n\n    // the properties below are optional\n    indexName: 'indexName',\n  }],\n  partitionKeys: [{\n    name: 'name',\n    type: {\n      inputString: 'inputString',\n      isPrimitive: false,\n    },\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  partitionProjection: {\n    partitionProjectionKey: partitionProjectionConfiguration,\n  },\n  storageParameters: [storageParameter],\n  storedAsSubDirectories: false,\n  tableName: 'tableName',\n};",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\n\ndeclare const database: glue_alpha.Database;\ndeclare const dataFormat: glue_alpha.DataFormat;\ndeclare const partitionProjectionConfiguration: glue_alpha.PartitionProjectionConfiguration;\ndeclare const storageParameter: glue_alpha.StorageParameter;\ndeclare const type: glue_alpha.Type;\nconst tableBaseProps: glue_alpha.TableBaseProps = {\n  columns: [{\n    name: 'name',\n    type: type,\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  database: database,\n  dataFormat: dataFormat,\n\n  // the properties below are optional\n  compressed: false,\n  description: 'description',\n  enablePartitionFiltering: false,\n  hasEncryptedData: false,\n  parameters: {\n    parametersKey: 'parameters',\n  },\n  partitionIndexes: [{\n    keyNames: ['keyNames'],\n\n    // the properties below are optional\n    indexName: 'indexName',\n  }],\n  partitionKeys: [{\n    name: 'name',\n    type: type,\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  partitionProjection: {\n    partitionProjectionKey: partitionProjectionConfiguration,\n  },\n  storageParameters: [storageParameter],\n  storedAsSubDirectories: false,\n  tableName: 'tableName',\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -23187,7 +23350,7 @@
           "abstract": true,
           "docs": {
             "default": "- The parameter is not defined",
-            "example": "   declare const glueDatabase: glue.IDatabase;\n   const table = new glue.Table(this, 'Table', {\n     storageParameters: [\n         glue.StorageParameter.skipHeaderLineCount(1),\n         glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n         glue.StorageParameter.custom('foo', 'bar'), // Will have no effect\n         glue.StorageParameter.custom('separatorChar', ','), // Will describe the separator char used in the data\n         glue.StorageParameter.custom(glue.StorageParameters.WRITE_PARALLEL, 'off'),\n     ],\n     // ...\n     database: glueDatabase,\n     columns: [{\n         name: 'col1',\n         type: glue.Schema.STRING,\n     }],\n     dataFormat: glue.DataFormat.CSV,\n   });",
+            "example": "   declare const glueDatabase: glue.IDatabase;\n   const table = new glue.S3Table(this, 'Table', {\n     storageParameters: [\n         glue.StorageParameter.skipHeaderLineCount(1),\n         glue.StorageParameter.compressionType(glue.CompressionType.GZIP),\n         glue.StorageParameter.custom('foo', 'bar'), // Will have no effect\n         glue.StorageParameter.custom('separatorChar', ','), // Will describe the separator char used in the data\n         glue.StorageParameter.custom(glue.StorageParameters.WRITE_PARALLEL, 'off'),\n     ],\n     // ...\n     database: glueDatabase,\n     columns: [{\n         name: 'col1',\n         type: glue.Schema.STRING,\n     }],\n     dataFormat: glue.DataFormat.CSV,\n   });",
             "remarks": "These properties help describe the format of the data that is stored within the crawled data sources.\n\nThe key/value pairs that are allowed to be submitted are not limited, however their functionality is not guaranteed.\n\nSome keys will be auto-populated by glue crawlers, however, you can override them by specifying the key and value in this property.",
             "see": "https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_EXTERNAL_TABLE.html#r_CREATE_EXTERNAL_TABLE-parameters - under _\"TABLE PROPERTIES\"_",
             "stability": "experimental",
@@ -23248,80 +23411,57 @@
       ],
       "symbolId": "lib/table-base:TableBaseProps"
     },
-    "@aws-cdk/aws-glue-alpha.TableEncryption": {
+    "@aws-cdk/aws-glue-alpha.TableClientSideEncryption": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "see": "https://docs.aws.amazon.com/athena/latest/ug/encryption.html",
+        "remarks": "Independent of the bucket's server-side encryption and of who owns the bucket:\nthe data is encrypted by the client before it is written to S3. When set, the\n`grant*` methods also grant the relevant KMS permissions on the key.",
         "stability": "experimental",
-        "summary": "Encryption options for a Table.",
-        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});",
+        "summary": "Client-side encryption for an `S3Table`'s data.",
+        "example": "declare const myDatabase: glue.Database;\n// KMS key is created automatically\nnew glue.S3Table(this, 'MyTable', {\n  clientSideEncryption: glue.TableClientSideEncryption.kms(),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n\n// with an explicit KMS key\nnew glue.S3Table(this, 'MyTable', {\n  clientSideEncryption: glue.TableClientSideEncryption.kms(new kms.Key(this, 'MyKey')),\n  // ...\n  database: myDatabase,\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
       },
-      "fqn": "@aws-cdk/aws-glue-alpha.TableEncryption",
-      "kind": "enum",
+      "fqn": "@aws-cdk/aws-glue-alpha.TableClientSideEncryption",
+      "kind": "class",
       "locationInModule": {
         "filename": "lib/s3-table.ts",
-        "line": 19
+        "line": 112
       },
-      "members": [
-        {
-          "docs": {
-            "see": "https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html",
-            "stability": "experimental",
-            "summary": "Server side encryption (SSE) with an Amazon S3-managed key."
-          },
-          "name": "S3_MANAGED"
-        },
+      "methods": [
         {
           "docs": {
-            "see": "https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html",
             "stability": "experimental",
-            "summary": "Server-side encryption (SSE) with an AWS KMS key managed by the account owner."
+            "summary": "Client-side encryption (CSE-KMS) with an AWS KMS key managed by the account owner."
           },
-          "name": "KMS"
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Server-side encryption (SSE) with an AWS KMS key managed by the KMS service."
+          "locationInModule": {
+            "filename": "lib/s3-table.ts",
+            "line": 118
           },
-          "name": "KMS_MANAGED"
-        },
-        {
-          "docs": {
-            "see": "https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html",
-            "stability": "experimental",
-            "summary": "Client-side encryption (CSE) with an AWS KMS key managed by the account owner."
+          "name": "kms",
+          "parameters": [
+            {
+              "docs": {
+                "remarks": "A key is created if one is not provided.",
+                "summary": "the KMS key used to encrypt the data."
+              },
+              "name": "key",
+              "optional": true,
+              "type": {
+                "fqn": "aws-cdk-lib.aws_kms.IKey"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-glue-alpha.TableClientSideEncryption"
+            }
           },
-          "name": "CLIENT_SIDE_KMS"
+          "static": true
         }
       ],
-      "name": "TableEncryption",
-      "symbolId": "lib/s3-table:TableEncryption"
-    },
-    "@aws-cdk/aws-glue-alpha.TableProps": {
-      "assembly": "@aws-cdk/aws-glue-alpha",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as glue_alpha from '@aws-cdk/aws-glue-alpha';\nimport { aws_kms as kms } from 'aws-cdk-lib';\nimport { aws_s3 as s3 } from 'aws-cdk-lib';\n\ndeclare const bucket: s3.Bucket;\ndeclare const database: glue_alpha.Database;\ndeclare const dataFormat: glue_alpha.DataFormat;\ndeclare const key: kms.Key;\ndeclare const partitionProjectionConfiguration: glue_alpha.PartitionProjectionConfiguration;\ndeclare const storageParameter: glue_alpha.StorageParameter;\nconst tableProps: glue_alpha.TableProps = {\n  columns: [{\n    name: 'name',\n    type: {\n      inputString: 'inputString',\n      isPrimitive: false,\n    },\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  database: database,\n  dataFormat: dataFormat,\n\n  // the properties below are optional\n  bucket: bucket,\n  compressed: false,\n  description: 'description',\n  enablePartitionFiltering: false,\n  encryption: glue_alpha.TableEncryption.S3_MANAGED,\n  encryptionKey: key,\n  hasEncryptedData: false,\n  parameters: {\n    parametersKey: 'parameters',\n  },\n  partitionIndexes: [{\n    keyNames: ['keyNames'],\n\n    // the properties below are optional\n    indexName: 'indexName',\n  }],\n  partitionKeys: [{\n    name: 'name',\n    type: {\n      inputString: 'inputString',\n      isPrimitive: false,\n    },\n\n    // the properties below are optional\n    comment: 'comment',\n  }],\n  partitionProjection: {\n    partitionProjectionKey: partitionProjectionConfiguration,\n  },\n  s3Prefix: 's3Prefix',\n  storageParameters: [storageParameter],\n  storedAsSubDirectories: false,\n  tableName: 'tableName',\n};",
-        "custom": {
-          "exampleMetadata": "fixture=_generated"
-        }
-      },
-      "fqn": "@aws-cdk/aws-glue-alpha.TableProps",
-      "interfaces": [
-        "@aws-cdk/aws-glue-alpha.S3TableProps"
-      ],
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "lib/table-deprecated.ts",
-        "line": 5
-      },
-      "name": "TableProps",
-      "symbolId": "lib/table-deprecated:TableProps"
+      "name": "TableClientSideEncryption",
+      "symbolId": "lib/s3-table:TableClientSideEncryption"
     },
     "@aws-cdk/aws-glue-alpha.TriggerOptions": {
       "assembly": "@aws-cdk/aws-glue-alpha",
@@ -23500,25 +23640,24 @@
     },
     "@aws-cdk/aws-glue-alpha.Type": {
       "assembly": "@aws-cdk/aws-glue-alpha",
-      "datatype": true,
       "docs": {
+        "remarks": "Instances are opaque: obtain one from a `Schema` factory (for example\n`Schema.STRING`, `Schema.decimal(...)`, `Schema.array(...)`) or, for a type the\n`Schema` factories don't model, from `Schema.custom(...)`.",
         "stability": "experimental",
-        "summary": "Represents a type of a column in a table schema.",
-        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: 'NOW-3YEARS',\n      max: 'NOW',\n      format: 'yyyy-MM-dd',\n    }),\n  },\n});",
+        "summary": "The type of a column in a table schema.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.S3Table(this, 'MyTable', {\n  database: myDatabase,\n  columns: [{\n    name: 'data',\n    type: glue.Schema.STRING,\n  }],\n  partitionKeys: [{\n    name: 'date',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n  partitionProjection: {\n    date: glue.PartitionProjectionConfiguration.date({\n      min: '2020-01-01',\n      max: '2023-12-31',\n      format: 'yyyy-MM-dd',\n      interval: 1,  // optional, defaults to 1\n      intervalUnit: glue.DateIntervalUnit.DAYS,  // optional: YEARS, MONTHS, WEEKS, DAYS, HOURS, MINUTES, SECONDS\n    }),\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
         }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Type",
-      "kind": "interface",
+      "kind": "class",
       "locationInModule": {
         "filename": "lib/schema.ts",
-        "line": 29
+        "line": 33
       },
       "name": "Type",
       "properties": [
         {
-          "abstract": true,
           "docs": {
             "stability": "experimental",
             "summary": "Glue InputString for this type."
@@ -23526,7 +23665,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 38
+            "line": 51
           },
           "name": "inputString",
           "type": {
@@ -23534,7 +23673,6 @@
           }
         },
         {
-          "abstract": true,
           "docs": {
             "stability": "experimental",
             "summary": "Indicates whether this type is a primitive data type."
@@ -23542,7 +23680,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/schema.ts",
-            "line": 33
+            "line": 46
           },
           "name": "isPrimitive",
           "type": {
@@ -24522,7 +24660,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "lib/storage-parameter.ts",
-        "line": 183
+        "line": 185
       },
       "members": [
         {
@@ -24544,6 +24682,6 @@
       "symbolId": "lib/storage-parameter:WriteParallel"
     }
   },
-  "version": "2.266.0-alpha.0",
+  "version": "2.267.0-alpha.0",
   "fingerprint": "**********"
 }