@aws-cdk/aws-glue-alpha 2.38.1-alpha.0 → 2.40.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.38.1",
+    "aws-cdk-lib": "^2.40.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -3024,7 +3024,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "1.63.2 (build a8a8833)",
+  "jsiiVersion": "1.66.0 (build 3c9512b)",
   "keywords": [
     "aws",
     "cdk",
@@ -3045,7 +3045,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## Job\n\nA `Job` encapsulates a script that connects to data sources, processes them, and then writes output to a data target.\n\nThere are 3 types of jobs supported by AWS Glue: Spark ETL, Spark Streaming, and Python Shell jobs.\n\nThe `glue.JobExecutable` allows you to specify the type of job, the language to use and the code assets required by the job.\n\n`glue.Code` allows you to refer to the different code assets required by the job, either from an existing S3 location or from a local file path.\n\n### Spark Jobs\n\nThese jobs run in an Apache Spark environment managed by AWS Glue.\n\n#### ETL Jobs\n\nAn ETL job processes data in batches using Apache Spark.\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew glue.Job(this, 'ScalaSparkEtlJob', {\n  executable: glue.JobExecutable.scalaEtl({\n    glueVersion: glue.GlueVersion.V2_0,\n    script: glue.Code.fromBucket(bucket, 'src/com/example/HelloWorld.scala'),\n    className: 'com.example.HelloWorld',\n    extraJars: [glue.Code.fromBucket(bucket, 'jars/HelloWorld.jar')],\n  }),\n  description: 'an example Scala ETL job',\n});\n```\n\n#### Streaming Jobs\n\nA Streaming job is similar to an ETL job, except that it performs ETL on data streams. It uses the Apache Spark Structured Streaming framework. Some Spark job features are not available to streaming ETL jobs.\n\n```ts\nnew glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});\n```\n\n### Python Shell Jobs\n\nA Python shell job runs Python scripts as a shell and supports a Python version that depends on the AWS Glue version you are using.\nThis can be used to schedule and run tasks that don't require an Apache Spark environment.\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});\n```\n\nSee [documentation](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) for more information on adding jobs in Glue.\n\n## Connection\n\nA `Connection` allows Glue jobs, crawlers and development endpoints to access certain types of data stores. For example, to create a network connection to connect to a data source within a VPC:\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\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\n```ts\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\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 for each encryption config, for example, for CloudWatch encryption:\n\n```ts\ndeclare const key: kms.Key;\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n    kmsKey: key,\n  },\n});\n```\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## 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});\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  bucket: myBucket,\n  s3Prefix: 'my-table/',\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nBy default, an S3 bucket will be created to store the table's data and stored in the bucket root. You can also manually pass the `bucket` and `s3Prefix`:\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table;\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.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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## [Encryption](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)\n\nYou can enable encryption on a Table's data:\n\n* `Unencrypted` - files are not encrypted. The default encryption setting.\n* [S3Managed](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) - Server side encryption (`SSE-S3`) with an Amazon S3-managed key.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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 `Table` if you wish to use server-side encryption (`KMS`, `KMS_MANAGED` or `S3_MANAGED`)*.\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.Table(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,string>',\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  tableName: 'my_table',\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Primitives\n\n#### Numeric\n\n| Name      \t| Type     \t| Comments                                                                                                          |\n|-----------\t|----------\t|------------------------------------------------------------------------------------------------------------------\t|\n| FLOAT     \t| Constant \t| A 32-bit single-precision floating point number                                                                   |\n| INTEGER   \t| Constant \t| A 32-bit signed value in two's complement format, with a minimum value of -2^31 and a maximum value of 2^31-1 \t|\n| DOUBLE    \t| Constant \t| A 64-bit double-precision floating point number                                                                   |\n| BIG_INT   \t| Constant \t| A 64-bit signed INTEGER in two’s complement format, with a minimum value of -2^63 and a maximum value of 2^63 -1  |\n| SMALL_INT \t| Constant \t| A 16-bit signed INTEGER in two’s complement format, with a minimum value of -2^15 and a maximum value of 2^15-1   |\n| TINY_INT  \t| Constant \t| A 8-bit signed INTEGER in two’s complement format, with a minimum value of -2^7 and a maximum value of 2^7-1      |\n\n#### Date and time\n\n| Name      \t| Type     \t| Comments                                                                                                                                                                \t|\n|-----------\t|----------\t|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------\t|\n| DATE      \t| Constant \t| A date in UNIX format, such as YYYY-MM-DD.                                                                                                                              \t|\n| TIMESTAMP \t| Constant \t| Date and time instant in the UNiX format, such as yyyy-mm-dd hh:mm:ss[.f...]. For example, TIMESTAMP '2008-09-15 03:04:05.324'. This format uses the session time zone. \t|\n\n#### String\n\n| Name                                       \t| Type     \t| Comments                                                                                                                                                                                          \t|\n|--------------------------------------------\t|----------\t|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\t|\n| STRING                                     \t| Constant \t| A string literal enclosed in single or double quotes                                                                                                                                              \t|\n| decimal(precision: number, scale?: number) \t| Function \t| `precision` is the total number of digits. `scale` (optional) is the number of digits in fractional part with a default of 0. For example, use these type definitions: decimal(11,5), decimal(15) \t|\n| char(length: number)                       \t| Function \t| Fixed length character data, with a specified length between 1 and 255, such as char(10)                                                                                                          \t|\n| varchar(length: number)                    \t| Function \t| Variable length character data, with a specified length between 1 and 65535, such as varchar(10)                                                                                                  \t|\n\n#### Miscellaneous\n\n| Name    \t| Type     \t| Comments                      \t|\n|---------\t|----------\t|-------------------------------\t|\n| BOOLEAN \t| Constant \t| Values are `true` and `false` \t|\n| BINARY  \t| Constant \t| Value is in binary            \t|\n\n### Complex\n\n| Name                                \t| Type     \t| Comments                                                          \t|\n|-------------------------------------\t|----------\t|-------------------------------------------------------------------\t|\n| array(itemType: Type)               \t| Function \t| An array of some other type                                       \t|\n| map(keyType: Type, valueType: Type) \t| Function \t| A map of some primitive key type to any value type                \t|\n| struct(collumns: Column[])          \t| Function \t| Nested structure containing individually named and typed collumns \t|\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## Job\n\nA `Job` encapsulates a script that connects to data sources, processes them, and then writes output to a data target.\n\nThere are 3 types of jobs supported by AWS Glue: Spark ETL, Spark Streaming, and Python Shell jobs.\n\nThe `glue.JobExecutable` allows you to specify the type of job, the language to use and the code assets required by the job.\n\n`glue.Code` allows you to refer to the different code assets required by the job, either from an existing S3 location or from a local file path.\n\n### Spark Jobs\n\nThese jobs run in an Apache Spark environment managed by AWS Glue.\n\n#### ETL Jobs\n\nAn ETL job processes data in batches using Apache Spark.\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew glue.Job(this, 'ScalaSparkEtlJob', {\n  executable: glue.JobExecutable.scalaEtl({\n    glueVersion: glue.GlueVersion.V2_0,\n    script: glue.Code.fromBucket(bucket, 'src/com/example/HelloWorld.scala'),\n    className: 'com.example.HelloWorld',\n    extraJars: [glue.Code.fromBucket(bucket, 'jars/HelloWorld.jar')],\n  }),\n  description: 'an example Scala ETL job',\n});\n```\n\n#### Streaming Jobs\n\nA Streaming job is similar to an ETL job, except that it performs ETL on data streams. It uses the Apache Spark Structured Streaming framework. Some Spark job features are not available to streaming ETL jobs.\n\n```ts\nnew glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});\n```\n\n### Python Shell Jobs\n\nA Python shell job runs Python scripts as a shell and supports a Python version that depends on the AWS Glue version you are using.\nThis can be used to schedule and run tasks that don't require an Apache Spark environment. Currently, three flavors are supported:\n\n* PythonVersion.TWO (2.7; EOL)\n* PythonVersion.THREE (3.6)\n* PythonVersion.THREE_NINE (3.9)\n\n```ts\ndeclare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});\n```\n\nSee [documentation](https://docs.aws.amazon.com/glue/latest/dg/add-job.html) for more information on adding jobs in Glue.\n\n## Connection\n\nA `Connection` allows Glue jobs, crawlers and development endpoints to access certain types of data stores. For example, to create a network connection to connect to a data source within a VPC:\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\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\n```ts\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\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 for each encryption config, for example, for CloudWatch encryption:\n\n```ts\ndeclare const key: kms.Key;\nnew glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n    kmsKey: key,\n  },\n});\n```\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## 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});\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  bucket: myBucket,\n  s3Prefix: 'my-table/',\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\nBy default, an S3 bucket will be created to store the table's data and stored in the bucket root. You can also manually pass the `bucket` and `s3Prefix`:\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  database: myDatabase,\n  tableName: 'my_table',\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.Table;\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.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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## [Encryption](https://docs.aws.amazon.com/athena/latest/ug/encryption.html)\n\nYou can enable encryption on a Table's data:\n\n* `Unencrypted` - files are not encrypted. The default encryption setting.\n* [S3Managed](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) - Server side encryption (`SSE-S3`) with an Amazon S3-managed key.\n\n```ts\ndeclare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.KMS_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.CLIENT_SIDE_KMS,\n  encryptionKey: new kms.Key(this, 'MyKey'),\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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 `Table` if you wish to use server-side encryption (`KMS`, `KMS_MANAGED` or `S3_MANAGED`)*.\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.Table(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,string>',\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  tableName: 'my_table',\n  dataFormat: glue.DataFormat.JSON,\n});\n```\n\n### Primitives\n\n#### Numeric\n\n| Name      \t| Type     \t| Comments                                                                                                          |\n|-----------\t|----------\t|------------------------------------------------------------------------------------------------------------------\t|\n| FLOAT     \t| Constant \t| A 32-bit single-precision floating point number                                                                   |\n| INTEGER   \t| Constant \t| A 32-bit signed value in two's complement format, with a minimum value of -2^31 and a maximum value of 2^31-1 \t|\n| DOUBLE    \t| Constant \t| A 64-bit double-precision floating point number                                                                   |\n| BIG_INT   \t| Constant \t| A 64-bit signed INTEGER in two’s complement format, with a minimum value of -2^63 and a maximum value of 2^63 -1  |\n| SMALL_INT \t| Constant \t| A 16-bit signed INTEGER in two’s complement format, with a minimum value of -2^15 and a maximum value of 2^15-1   |\n| TINY_INT  \t| Constant \t| A 8-bit signed INTEGER in two’s complement format, with a minimum value of -2^7 and a maximum value of 2^7-1      |\n\n#### Date and time\n\n| Name      \t| Type     \t| Comments                                                                                                                                                                \t|\n|-----------\t|----------\t|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------\t|\n| DATE      \t| Constant \t| A date in UNIX format, such as YYYY-MM-DD.                                                                                                                              \t|\n| TIMESTAMP \t| Constant \t| Date and time instant in the UNiX format, such as yyyy-mm-dd hh:mm:ss[.f...]. For example, TIMESTAMP '2008-09-15 03:04:05.324'. This format uses the session time zone. \t|\n\n#### String\n\n| Name                                       \t| Type     \t| Comments                                                                                                                                                                                          \t|\n|--------------------------------------------\t|----------\t|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\t|\n| STRING                                     \t| Constant \t| A string literal enclosed in single or double quotes                                                                                                                                              \t|\n| decimal(precision: number, scale?: number) \t| Function \t| `precision` is the total number of digits. `scale` (optional) is the number of digits in fractional part with a default of 0. For example, use these type definitions: decimal(11,5), decimal(15) \t|\n| char(length: number)                       \t| Function \t| Fixed length character data, with a specified length between 1 and 255, such as char(10)                                                                                                          \t|\n| varchar(length: number)                    \t| Function \t| Variable length character data, with a specified length between 1 and 65535, such as varchar(10)                                                                                                  \t|\n\n#### Miscellaneous\n\n| Name    \t| Type     \t| Comments                      \t|\n|---------\t|----------\t|-------------------------------\t|\n| BOOLEAN \t| Constant \t| Values are `true` and `false` \t|\n| BINARY  \t| Constant \t| Value is in binary            \t|\n\n### Complex\n\n| Name                                \t| Type     \t| Comments                                                          \t|\n|-------------------------------------\t|----------\t|-------------------------------------------------------------------\t|\n| array(itemType: Type)               \t| Function \t| An array of some other type                                       \t|\n| map(keyType: Type, valueType: Type) \t| Function \t| A map of some primitive key type to any value type                \t|\n| struct(collumns: Column[])          \t| Function \t| Nested structure containing individually named and typed collumns \t|\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-glue",
@@ -3322,12 +3322,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "CloudWatch Logs encryption configuration.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
-        "stability": "experimental",
-        "summary": "CloudWatch Logs encryption configuration."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.CloudWatchEncryption",
       "kind": "interface",
@@ -3377,13 +3377,13 @@
     "@aws-cdk/aws-glue-alpha.CloudWatchEncryptionMode": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "see": "https://docs.aws.amazon.com/glue/latest/webapi/API_CloudWatchEncryption.html#Glue-Type-CloudWatchEncryption-CloudWatchEncryptionMode",
         "stability": "experimental",
-        "summary": "Encryption mode for CloudWatch Logs."
+        "summary": "Encryption mode for CloudWatch Logs.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.CloudWatchEncryptionMode",
       "kind": "enum",
@@ -3408,12 +3408,12 @@
       "abstract": true,
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
+        "stability": "experimental",
+        "summary": "Represents a Glue Job's Code assets (an asset can be a scripts, a jar, a python file or any other file).",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
-        "stability": "experimental",
-        "summary": "Represents a Glue Job's Code assets (an asset can be a scripts, a jar, a python file or any other file)."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Code",
       "initializer": {
@@ -3648,12 +3648,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "An AWS Glue connection to a data source.",
+        "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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "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});",
-        "stability": "experimental",
-        "summary": "An AWS Glue connection to a data source."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Connection",
       "initializer": {
@@ -4007,12 +4007,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Construction properties for {@link 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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "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});",
-        "stability": "experimental",
-        "summary": "Construction properties for {@link Connection}."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.ConnectionProps",
       "interfaces": [
@@ -4047,13 +4047,13 @@
     "@aws-cdk/aws-glue-alpha.ConnectionType": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "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});",
         "remarks": "If you need to use a connection type that doesn't exist as a static member, you\ncan instantiate a `ConnectionType` object, e.g: `new ConnectionType('NEW_TYPE')`.",
         "stability": "experimental",
-        "summary": "The type of the glue connection."
+        "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});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.ConnectionType",
       "initializer": {
@@ -4299,12 +4299,12 @@
     "@aws-cdk/aws-glue-alpha.DataFormat": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
+        "stability": "experimental",
+        "summary": "Defines the input/output formats and ser/de for a single DataFormat.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
-        "stability": "experimental",
-        "summary": "Defines the input/output formats and ser/de for a single DataFormat."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.DataFormat",
       "initializer": {
@@ -4651,12 +4651,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "A Glue database.",
+        "example": "new glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n});",
-        "stability": "experimental",
-        "summary": "A Glue database."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Database",
       "initializer": {
@@ -4823,11 +4823,11 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "example": "new glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.Database(this, 'MyDatabase', {\n  databaseName: 'my_database',\n});",
-        "stability": "experimental"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.DatabaseProps",
       "kind": "interface",
@@ -4878,13 +4878,13 @@
     "@aws-cdk/aws-glue-alpha.GlueVersion": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "see": "https://docs.aws.amazon.com/glue/latest/dg/add-job.html.\n\nIf you need to use a GlueVersion that doesn't exist as a static member, you\ncan instantiate a `GlueVersion` object, e.g: `GlueVersion.of('1.5')`.",
         "stability": "experimental",
-        "summary": "AWS Glue version determines the versions of Apache Spark and Python that are available to the job."
+        "summary": "AWS Glue version determines the versions of Apache Spark and Python that are available to the job.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.GlueVersion",
       "kind": "class",
@@ -5756,12 +5756,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "A Glue Job.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
-        "stability": "experimental",
-        "summary": "A Glue Job."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Job",
       "initializer": {
@@ -6327,12 +6327,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Job bookmarks encryption configuration.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
-        "stability": "experimental",
-        "summary": "Job bookmarks encryption configuration."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.JobBookmarksEncryption",
       "kind": "interface",
@@ -6382,13 +6382,13 @@
     "@aws-cdk/aws-glue-alpha.JobBookmarksEncryptionMode": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "see": "https://docs.aws.amazon.com/glue/latest/webapi/API_JobBookmarksEncryption.html#Glue-Type-JobBookmarksEncryption-JobBookmarksEncryptionMode",
         "stability": "experimental",
-        "summary": "Encryption mode for Job Bookmarks."
+        "summary": "Encryption mode for Job Bookmarks.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.JobBookmarksEncryptionMode",
       "kind": "enum",
@@ -6412,18 +6412,18 @@
     "@aws-cdk/aws-glue-alpha.JobExecutable": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
+        "stability": "experimental",
+        "summary": "The executable properties related to the Glue job's GlueVersion, JobType and code.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
-        "stability": "experimental",
-        "summary": "The executable properties related to the Glue job's GlueVersion, JobType and code."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.JobExecutable",
       "kind": "class",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 207
+        "line": 212
       },
       "methods": [
         {
@@ -6433,7 +6433,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 279
+            "line": 284
           },
           "name": "of",
           "parameters": [
@@ -6461,7 +6461,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 240
+            "line": 245
           },
           "name": "pythonEtl",
           "parameters": [
@@ -6489,7 +6489,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 266
+            "line": 271
           },
           "name": "pythonShell",
           "parameters": [
@@ -6517,7 +6517,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 253
+            "line": 258
           },
           "name": "pythonStreaming",
           "parameters": [
@@ -6545,7 +6545,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 214
+            "line": 219
           },
           "name": "scalaEtl",
           "parameters": [
@@ -6573,7 +6573,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 227
+            "line": 232
           },
           "name": "scalaStreaming",
           "parameters": [
@@ -6601,7 +6601,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 309
+            "line": 317
           },
           "name": "bind",
           "returns": {
@@ -6629,7 +6629,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 317
+        "line": 325
       },
       "name": "JobExecutableConfig",
       "properties": [
@@ -6643,7 +6643,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 323
+            "line": 331
           },
           "name": "glueVersion",
           "type": {
@@ -6660,7 +6660,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 330
+            "line": 338
           },
           "name": "language",
           "type": {
@@ -6676,7 +6676,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 347
+            "line": 355
           },
           "name": "script",
           "type": {
@@ -6692,7 +6692,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 335
+            "line": 343
           },
           "name": "type",
           "type": {
@@ -6711,7 +6711,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 356
+            "line": 364
           },
           "name": "className",
           "optional": true,
@@ -6730,7 +6730,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 383
+            "line": 391
           },
           "name": "extraFiles",
           "optional": true,
@@ -6754,7 +6754,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 365
+            "line": 373
           },
           "name": "extraJars",
           "optional": true,
@@ -6778,7 +6778,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 392
+            "line": 400
           },
           "name": "extraJarsFirst",
           "optional": true,
@@ -6797,7 +6797,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 374
+            "line": 382
           },
           "name": "extraPythonFiles",
           "optional": true,
@@ -6820,7 +6820,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 342
+            "line": 350
           },
           "name": "pythonVersion",
           "optional": true,
@@ -6866,12 +6866,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Construction properties for {@link Job}.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
-        "stability": "experimental",
-        "summary": "Construction properties for {@link Job}."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.JobProps",
       "kind": "interface",
@@ -7312,7 +7312,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 86
+        "line": 91
       },
       "methods": [
         {
@@ -7322,7 +7322,7 @@
           },
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 106
+            "line": 111
           },
           "name": "of",
           "parameters": [
@@ -7355,7 +7355,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 90
+            "line": 95
           },
           "name": "ETL",
           "static": true,
@@ -7372,7 +7372,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 100
+            "line": 105
           },
           "name": "PYTHON_SHELL",
           "static": true,
@@ -7389,7 +7389,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 95
+            "line": 100
           },
           "name": "STREAMING",
           "static": true,
@@ -7405,7 +7405,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 113
+            "line": 118
           },
           "name": "name",
           "type": {
@@ -7575,12 +7575,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Properties of a Partition Index.",
+        "example": "declare const myTable: glue.Table;\nmyTable.addPartitionIndex({\n  indexName: 'my-index',\n  keyNames: ['year'],\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myTable: glue.Table;\nmyTable.addPartitionIndex({\n  indexName: 'my-index',\n  keyNames: ['year'],\n});",
-        "stability": "experimental",
-        "summary": "Properties of a Partition Index."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.PartitionIndex",
       "kind": "interface",
@@ -7637,18 +7637,18 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Props for creating a Python shell job executable.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'PythonShellJob', {\n  executable: glue.JobExecutable.pythonShell({\n    glueVersion: glue.GlueVersion.V1_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromBucket(bucket, 'script.py'),\n  }),\n  description: 'an example Python Shell job',\n});",
-        "stability": "experimental",
-        "summary": "Props for creating a Python shell job executable."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.PythonShellExecutableProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 202
+        "line": 207
       },
       "name": "PythonShellExecutableProps",
       "properties": [
@@ -7662,7 +7662,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 143
+            "line": 148
           },
           "name": "glueVersion",
           "type": {
@@ -7678,7 +7678,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 124
+            "line": 129
           },
           "name": "pythonVersion",
           "type": {
@@ -7694,7 +7694,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 148
+            "line": 153
           },
           "name": "script",
           "type": {
@@ -7713,7 +7713,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 158
+            "line": 163
           },
           "name": "extraFiles",
           "optional": true,
@@ -7738,7 +7738,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 134
+            "line": 139
           },
           "name": "extraPythonFiles",
           "optional": true,
@@ -7758,18 +7758,18 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Props for creating a Python Spark (ETL or Streaming) job executable.",
+        "example": "new glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});",
-        "stability": "experimental",
-        "summary": "Props for creating a Python Spark (ETL or Streaming) job executable."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.PythonSparkJobExecutableProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 197
+        "line": 202
       },
       "name": "PythonSparkJobExecutableProps",
       "properties": [
@@ -7783,7 +7783,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 143
+            "line": 148
           },
           "name": "glueVersion",
           "type": {
@@ -7799,7 +7799,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 124
+            "line": 129
           },
           "name": "pythonVersion",
           "type": {
@@ -7815,7 +7815,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 148
+            "line": 153
           },
           "name": "script",
           "type": {
@@ -7834,7 +7834,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 158
+            "line": 163
           },
           "name": "extraFiles",
           "optional": true,
@@ -7858,7 +7858,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 170
+            "line": 175
           },
           "name": "extraJars",
           "optional": true,
@@ -7882,7 +7882,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 179
+            "line": 184
           },
           "name": "extraJarsFirst",
           "optional": true,
@@ -7902,7 +7902,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 134
+            "line": 139
           },
           "name": "extraPythonFiles",
           "optional": true,
@@ -7921,12 +7921,12 @@
     "@aws-cdk/aws-glue-alpha.PythonVersion": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
+        "stability": "experimental",
+        "summary": "Python version.",
+        "example": "new glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.Job(this, 'PythonSparkStreamingJob', {\n  executable: glue.JobExecutable.pythonStreaming({\n    glueVersion: glue.GlueVersion.V2_0,\n    pythonVersion: glue.PythonVersion.THREE,\n    script: glue.Code.fromAsset(path.join(__dirname, 'job-script/hello_world.py')),\n  }),\n  description: 'an example Python Streaming job',\n});",
-        "stability": "experimental",
-        "summary": "Python version."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.PythonVersion",
       "kind": "enum",
@@ -7948,6 +7948,13 @@
             "summary": "Python 3 (the exact version depends on GlueVersion and JobCommand used)."
           },
           "name": "THREE"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Python 3.9 (the exact version depends on GlueVersion and JobCommand used)."
+          },
+          "name": "THREE_NINE"
         }
       ],
       "name": "PythonVersion",
@@ -8033,12 +8040,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "S3 encryption configuration.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
-        "stability": "experimental",
-        "summary": "S3 encryption configuration."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.S3Encryption",
       "kind": "interface",
@@ -8088,13 +8095,13 @@
     "@aws-cdk/aws-glue-alpha.S3EncryptionMode": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "see": "https://docs.aws.amazon.com/glue/latest/webapi/API_S3Encryption.html#Glue-Type-S3Encryption-S3EncryptionMode",
         "stability": "experimental",
-        "summary": "Encryption mode for S3."
+        "summary": "Encryption mode for S3.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.S3EncryptionMode",
       "kind": "enum",
@@ -8127,18 +8134,18 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Props for creating a Scala Spark (ETL or Streaming) job executable.",
+        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'ScalaSparkEtlJob', {\n  executable: glue.JobExecutable.scalaEtl({\n    glueVersion: glue.GlueVersion.V2_0,\n    script: glue.Code.fromBucket(bucket, 'src/com/example/HelloWorld.scala'),\n    className: 'com.example.HelloWorld',\n    extraJars: [glue.Code.fromBucket(bucket, 'jars/HelloWorld.jar')],\n  }),\n  description: 'an example Scala ETL job',\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const bucket: s3.Bucket;\nnew glue.Job(this, 'ScalaSparkEtlJob', {\n  executable: glue.JobExecutable.scalaEtl({\n    glueVersion: glue.GlueVersion.V2_0,\n    script: glue.Code.fromBucket(bucket, 'src/com/example/HelloWorld.scala'),\n    className: 'com.example.HelloWorld',\n    extraJars: [glue.Code.fromBucket(bucket, 'jars/HelloWorld.jar')],\n  }),\n  description: 'an example Scala ETL job',\n});",
-        "stability": "experimental",
-        "summary": "Props for creating a Scala Spark (ETL or Streaming) job executable."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.ScalaJobExecutableProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/job-executable.ts",
-        "line": 185
+        "line": 190
       },
       "name": "ScalaJobExecutableProps",
       "properties": [
@@ -8152,7 +8159,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 191
+            "line": 196
           },
           "name": "className",
           "type": {
@@ -8169,7 +8176,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 143
+            "line": 148
           },
           "name": "glueVersion",
           "type": {
@@ -8185,7 +8192,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 148
+            "line": 153
           },
           "name": "script",
           "type": {
@@ -8204,7 +8211,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 158
+            "line": 163
           },
           "name": "extraFiles",
           "optional": true,
@@ -8228,7 +8235,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 170
+            "line": 175
           },
           "name": "extraJars",
           "optional": true,
@@ -8252,7 +8259,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/job-executable.ts",
-            "line": 179
+            "line": 184
           },
           "name": "extraJarsFirst",
           "optional": true,
@@ -8266,12 +8273,12 @@
     "@aws-cdk/aws-glue-alpha.Schema": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
+        "see": "https://docs.aws.amazon.com/athena/latest/ug/data-types.html",
+        "stability": "experimental",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
-        "see": "https://docs.aws.amazon.com/athena/latest/ug/data-types.html",
-        "stability": "experimental"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Schema",
       "initializer": {
@@ -8671,13 +8678,13 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "remarks": "The following scenarios show some of the ways that you can use a security configuration.\n- Attach a security configuration to an AWS Glue crawler to write encrypted Amazon CloudWatch Logs.\n- Attach a security configuration to an extract, transform, and load (ETL) job to write encrypted Amazon Simple Storage Service (Amazon S3) targets and encrypted CloudWatch Logs.\n- Attach a security configuration to an ETL job to write its jobs bookmarks as encrypted Amazon S3 data.\n- Attach a security configuration to a development endpoint to write encrypted Amazon S3 targets.",
         "stability": "experimental",
-        "summary": "A security configuration is a set of security properties that can be used by AWS Glue to encrypt data at rest."
+        "summary": "A security configuration is a set of security properties that can be used by AWS Glue to encrypt data at rest.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.SecurityConfiguration",
       "initializer": {
@@ -8841,12 +8848,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Constructions properties of {@link SecurityConfiguration}.",
+        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "new glue.SecurityConfiguration(this, 'MySecurityConfiguration', {\n  securityConfigurationName: 'name',\n  cloudWatchEncryption: {\n    mode: glue.CloudWatchEncryptionMode.KMS,\n  },\n  jobBookmarksEncryption: {\n    mode: glue.JobBookmarksEncryptionMode.CLIENT_SIDE_KMS,\n  },\n  s3Encryption: {\n    mode: glue.S3EncryptionMode.KMS,\n  },\n});",
-        "stability": "experimental",
-        "summary": "Constructions properties of {@link SecurityConfiguration}."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.SecurityConfigurationProps",
       "kind": "interface",
@@ -9288,12 +9295,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "base": "aws-cdk-lib.Resource",
       "docs": {
+        "stability": "experimental",
+        "summary": "A Glue table.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
-        "stability": "experimental",
-        "summary": "A Glue table."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Table",
       "initializer": {
@@ -9850,13 +9857,13 @@
     "@aws-cdk/aws-glue-alpha.TableEncryption": {
       "assembly": "@aws-cdk/aws-glue-alpha",
       "docs": {
-        "custom": {
-          "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\n  columns: [{\n    name: 'col1',\n    type: glue.Schema.STRING,\n  }],\n  dataFormat: glue.DataFormat.JSON,\n});",
         "see": "https://docs.aws.amazon.com/athena/latest/ug/encryption.html",
         "stability": "experimental",
-        "summary": "Encryption options for a Table."
+        "summary": "Encryption options for a Table.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n  encryption: glue.TableEncryption.S3_MANAGED,\n  // ...\n  database: myDatabase,\n  tableName: 'my_table',\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",
@@ -9910,11 +9917,11 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
-        "stability": "experimental"
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.TableProps",
       "kind": "interface",
@@ -10194,12 +10201,12 @@
       "assembly": "@aws-cdk/aws-glue-alpha",
       "datatype": true,
       "docs": {
+        "stability": "experimental",
+        "summary": "Represents a type of a column in a table schema.",
+        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
         "custom": {
           "exampleMetadata": "infused"
-        },
-        "example": "declare const myDatabase: glue.Database;\nnew glue.Table(this, 'MyTable', {\n    database: myDatabase,\n    tableName: 'my_table',\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});",
-        "stability": "experimental",
-        "summary": "Represents a type of a column in a table schema."
+        }
       },
       "fqn": "@aws-cdk/aws-glue-alpha.Type",
       "kind": "interface",
@@ -10365,6 +10372,6 @@
       "symbolId": "lib/job:WorkerType"
     }
   },
-  "version": "2.38.1-alpha.0",
+  "version": "2.40.0-alpha.0",
   "fingerprint": "**********"
 }