feat(client-timestream-write): This release adds the capability for c…

…ustomers to define how their data should be partitioned, optimizing for certain access patterns. This definition will take place as a part of the table creation.

clients/client-timestream-write/src/commands/CreateBatchLoadTaskCommand.ts

@@ -45,8 +45,8 @@ export interface CreateBatchLoadTaskCommandOutput extends CreateBatchLoadTaskRes
  * a CSV source in an S3 location and writes to a Timestream table. A mapping from
  * source to target is defined in a batch load task. Errors and events are written to a report
  * at an S3 location. For the report, if the KMS key is not specified, the
- * batch load task will be encrypted with a Timestream managed KMS key
- * located in your account. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed
+ * report will be encrypted with an S3 managed key when <code>SSE_S3</code> is the option.
+ * Otherwise an error is thrown. For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed
  * keys</a>. <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. For
  * details, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html">code
  * sample</a>.</p>

clients/client-timestream-write/src/commands/CreateTableCommand.ts

@@ -73,6 +73,15 @@ export interface CreateTableCommandOutput extends CreateTableResponse, __Metadat
  * },
  * },
  * },
+ * Schema: { // Schema
+ * CompositePartitionKey: [ // PartitionKeyList
+ * { // PartitionKey
+ * Type: "DIMENSION" || "MEASURE", // required
+ * Name: "STRING_VALUE",
+ * EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * },
+ * ],
+ * },
  * };
  * const command = new CreateTableCommand(input);
  * const response = await client.send(command);
@@ -99,6 +108,15 @@ export interface CreateTableCommandOutput extends CreateTableResponse, __Metadat
  * // },
  * // },
  * // },
+ * // Schema: { // Schema
+ * // CompositePartitionKey: [ // PartitionKeyList
+ * // { // PartitionKey
+ * // Type: "DIMENSION" || "MEASURE", // required
+ * // Name: "STRING_VALUE",
+ * // EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * // },
+ * // ],
+ * // },
  * // },
  * // };
  *

clients/client-timestream-write/src/commands/DescribeTableCommand.ts

@@ -76,6 +76,15 @@ export interface DescribeTableCommandOutput extends DescribeTableResponse, __Met
  * // },
  * // },
  * // },
+ * // Schema: { // Schema
+ * // CompositePartitionKey: [ // PartitionKeyList
+ * // { // PartitionKey
+ * // Type: "DIMENSION" || "MEASURE", // required
+ * // Name: "STRING_VALUE",
+ * // EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * // },
+ * // ],
+ * // },
  * // },
  * // };
  *

clients/client-timestream-write/src/commands/ListTablesCommand.ts

@@ -77,6 +77,15 @@ export interface ListTablesCommandOutput extends ListTablesResponse, __MetadataB
  * // },
  * // },
  * // },
+ * // Schema: { // Schema
+ * // CompositePartitionKey: [ // PartitionKeyList
+ * // { // PartitionKey
+ * // Type: "DIMENSION" || "MEASURE", // required
+ * // Name: "STRING_VALUE",
+ * // EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * // },
+ * // ],
+ * // },
  * // },
  * // ],
  * // NextToken: "STRING_VALUE",

clients/client-timestream-write/src/commands/UpdateTableCommand.ts

@@ -67,6 +67,15 @@ export interface UpdateTableCommandOutput extends UpdateTableResponse, __Metadat
  * },
  * },
  * },
+ * Schema: { // Schema
+ * CompositePartitionKey: [ // PartitionKeyList
+ * { // PartitionKey
+ * Type: "DIMENSION" || "MEASURE", // required
+ * Name: "STRING_VALUE",
+ * EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * },
+ * ],
+ * },
  * };
  * const command = new UpdateTableCommand(input);
  * const response = await client.send(command);
@@ -93,6 +102,15 @@ export interface UpdateTableCommandOutput extends UpdateTableResponse, __Metadat
  * // },
  * // },
  * // },
+ * // Schema: { // Schema
+ * // CompositePartitionKey: [ // PartitionKeyList
+ * // { // PartitionKey
+ * // Type: "DIMENSION" || "MEASURE", // required
+ * // Name: "STRING_VALUE",
+ * // EnforcementInRecord: "REQUIRED" || "OPTIONAL",
+ * // },
+ * // ],
+ * // },
  * // },
  * // };
  *

clients/client-timestream-write/src/models/models_0.ts

@@ -455,7 +455,8 @@ export interface ReportS3Configuration {
 
 /**
  * @public
- * <p>Report configuration for a batch load task. This contains details about where error reports are stored.</p>
+ * <p>Report configuration for a batch load task. This contains details about where error
+ * reports are stored.</p>
  */
 export interface ReportConfiguration {
  /**
@@ -491,12 +492,14 @@ export interface BatchLoadTaskDescription {
  ProgressReport?: BatchLoadProgressReport;
 
  /**
- * <p>Report configuration for a batch load task. This contains details about where error reports are stored.</p>
+ * <p>Report configuration for a batch load task. This contains details about where error
+ * reports are stored.</p>
  */
  ReportConfiguration?: ReportConfiguration;
 
  /**
- * <p>Data model configuration for a batch load task. This contains details about where a data model for a batch load task is stored.</p>
+ * <p>Data model configuration for a batch load task. This contains details about where a data
+ * model for a batch load task is stored.</p>
  */
  DataModelConfiguration?: DataModelConfiguration;
 
@@ -580,7 +583,8 @@ export interface CreateBatchLoadTaskRequest {
  DataSourceConfiguration: DataSourceConfiguration | undefined;
 
  /**
- * <p>Report configuration for a batch load task. This contains details about where error reports are stored.</p>
+ * <p>Report configuration for a batch load task. This contains details about where error
+ * reports are stored.</p>
  */
  ReportConfiguration: ReportConfiguration | undefined;
 
@@ -909,6 +913,76 @@ export interface RetentionProperties {
  MagneticStoreRetentionPeriodInDays: number | undefined;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const PartitionKeyEnforcementLevel = {
+ OPTIONAL: "OPTIONAL",
+ REQUIRED: "REQUIRED",
+} as const;
+
+/**
+ * @public
+ */
+export type PartitionKeyEnforcementLevel =
+ (typeof PartitionKeyEnforcementLevel)[keyof typeof PartitionKeyEnforcementLevel];
+
+/**
+ * @public
+ * @enum
+ */
+export const PartitionKeyType = {
+ DIMENSION: "DIMENSION",
+ MEASURE: "MEASURE",
+} as const;
+
+/**
+ * @public
+ */
+export type PartitionKeyType = (typeof PartitionKeyType)[keyof typeof PartitionKeyType];
+
+/**
+ * @public
+ * <p> An attribute used in partitioning data in a table. A dimension key partitions data
+ * using the values of the dimension specified by the dimension-name as partition key, while a
+ * measure key partitions data using measure names (values of the 'measure_name' column).
+ * </p>
+ */
+export interface PartitionKey {
+ /**
+ * <p> The type of the partition key. Options are DIMENSION (dimension key) and MEASURE
+ * (measure key). </p>
+ */
+ Type: PartitionKeyType | string | undefined;
+
+ /**
+ * <p> The name of the attribute used for a dimension key. </p>
+ */
+ Name?: string;
+
+ /**
+ * <p> The level of enforcement for the specification of a dimension key in ingested records.
+ * Options are REQUIRED (dimension key must be specified) and OPTIONAL (dimension key does not
+ * have to be specified). </p>
+ */
+ EnforcementInRecord?: PartitionKeyEnforcementLevel | string;
+}
+
+/**
+ * @public
+ * <p> A Schema specifies the expected data model of the table. </p>
+ */
+export interface Schema {
+ /**
+ * <p>A non-empty list of partition keys defining the attributes used to partition the table
+ * data. The order of the list determines the partition hierarchy. The name and type of each
+ * partition key as well as the partition key order cannot be changed after the table is
+ * created. However, the enforcement level of each partition key can be changed. </p>
+ */
+ CompositePartitionKey?: PartitionKey[];
+}
+
 /**
  * @public
  */
@@ -938,6 +1012,11 @@ export interface CreateTableRequest {
  * <p>Contains properties to set on the table when enabling magnetic store writes.</p>
  */
  MagneticStoreWriteProperties?: MagneticStoreWriteProperties;
+
+ /**
+ * <p> The schema of the table. </p>
+ */
+ Schema?: Schema;
 }
 
 /**
@@ -1011,6 +1090,11 @@ export interface Table {
  * <p>Contains properties to set on the table when enabling magnetic store writes.</p>
  */
  MagneticStoreWriteProperties?: MagneticStoreWriteProperties;
+
+ /**
+ * <p> The schema of the table. </p>
+ */
+ Schema?: Schema;
 }
 
 /**
@@ -1338,7 +1422,8 @@ export interface MeasureValue {
  Name: string | undefined;
 
  /**
- * <p> The value for the MeasureValue. </p>
+ * <p> The value for the MeasureValue. For information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types">Data
+ * types</a>.</p>
  */
  Value: string | undefined;
 
@@ -1384,7 +1469,8 @@ export interface _Record {
 
  /**
  * <p> Contains the data type of the measure value for the time-series data point. Default
- * type is <code>DOUBLE</code>. </p>
+ * type is <code>DOUBLE</code>. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types">Data
+ * types</a>.</p>
  */
  MeasureValueType?: MeasureValueType | string;
 
@@ -1699,6 +1785,11 @@ export interface UpdateTableRequest {
  * <p>Contains properties to set on the table when enabling magnetic store writes.</p>
  */
  MagneticStoreWriteProperties?: MagneticStoreWriteProperties;
+
+ /**
+ * <p> The schema of the table. </p>
+ */
+ Schema?: Schema;
 }
 
 /**

clients/client-timestream-write/src/protocols/Aws_json1_0.ts

@@ -90,13 +90,15 @@ import {
  MixedMeasureMapping,
  MultiMeasureAttributeMapping,
  MultiMeasureMappings,
+ PartitionKey,
  RejectedRecordsException,
  ReportConfiguration,
  ReportS3Configuration,
  ResourceNotFoundException,
  ResumeBatchLoadTaskRequest,
  RetentionProperties,
  S3Configuration,
+ Schema,
  ServiceQuotaExceededException,
  Table,
  Tag,
@@ -1715,6 +1717,10 @@ const se_CreateBatchLoadTaskRequest = (input: CreateBatchLoadTaskRequest, contex
 
 // se_MultiMeasureMappings omitted.
 
+// se_PartitionKey omitted.
+
+// se_PartitionKeyList omitted.
+
 // se__Record omitted.
 
 // se_Records omitted.
@@ -1729,6 +1735,8 @@ const se_CreateBatchLoadTaskRequest = (input: CreateBatchLoadTaskRequest, contex
 
 // se_S3Configuration omitted.
 
+// se_Schema omitted.
+
 // se_Tag omitted.
 
 // se_TagKeyList omitted.
@@ -1944,6 +1952,10 @@ const de_ListTablesResponse = (output: any, context: __SerdeContext): ListTables
 
 // de_MultiMeasureMappings omitted.
 
+// de_PartitionKey omitted.
+
+// de_PartitionKeyList omitted.
+
 // de_RecordsIngested omitted.
 
 // de_RejectedRecord omitted.
@@ -1964,6 +1976,8 @@ const de_ListTablesResponse = (output: any, context: __SerdeContext): ListTables
 
 // de_S3Configuration omitted.
 
+// de_Schema omitted.
+
 // de_ServiceQuotaExceededException omitted.
 
 /**
@@ -1977,6 +1991,7 @@ const de_Table = (output: any, context: __SerdeContext): Table => {
  LastUpdatedTime: (_: any) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
  MagneticStoreWriteProperties: _json,
  RetentionProperties: _json,
+ Schema: _json,
  TableName: __expectString,
  TableStatus: __expectString,
  }) as any;