aws-cdk-lib 2.186.0__py3-none-any.whl → 2.188.0__py3-none-any.whl

aws_cdk/aws_quicksight/__init__.py

@@ -141794,6 +141794,11 @@ class CfnDataSet(
                 )
             )],
             data_set_refresh_properties=quicksight.CfnDataSet.DataSetRefreshPropertiesProperty(
+                failure_configuration=quicksight.CfnDataSet.RefreshFailureConfigurationProperty(
+                    email_alert=quicksight.CfnDataSet.RefreshFailureEmailAlertProperty(
+                        alert_status="alertStatus"
+                    )
+                ),
                 refresh_configuration=quicksight.CfnDataSet.RefreshConfigurationProperty(
                     incremental_refresh=quicksight.CfnDataSet.IncrementalRefreshProperty(
                         lookback_window=quicksight.CfnDataSet.LookbackWindowProperty(
@@ -141861,6 +141866,8 @@ class CfnDataSet(
                         ),
                         rename_column_operation=quicksight.CfnDataSet.RenameColumnOperationProperty(
                             column_name="columnName",
+        
+                            # the properties below are optional
                             new_column_name="newColumnName"
                         ),
                         tag_column_operation=quicksight.CfnDataSet.TagColumnOperationProperty(
@@ -141940,6 +141947,8 @@ class CfnDataSet(
                     ),
                     s3_source=quicksight.CfnDataSet.S3SourceProperty(
                         data_source_arn="dataSourceArn",
+        
+                        # the properties below are optional
                         input_columns=[quicksight.CfnDataSet.InputColumnProperty(
                             name="name",
                             type="type",
@@ -141947,8 +141956,6 @@ class CfnDataSet(
                             # the properties below are optional
                             sub_type="subType"
                         )],
-        
-                        # the properties below are optional
                         upload_settings=quicksight.CfnDataSet.UploadSettingsProperty(
                             contains_header=False,
                             delimiter="delimiter",
@@ -141985,7 +141992,8 @@ class CfnDataSet(
             tags=[CfnTag(
                 key="key",
                 value="value"
-            )]
+            )],
+            use_as="useAs"
         )
     '''
 
@@ -142013,6 +142021,7 @@ class CfnDataSet(
         row_level_permission_data_set: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RowLevelPermissionDataSetProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         row_level_permission_tag_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RowLevelPermissionTagConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        use_as: typing.Optional[builtins.str] = None,
     ) -> None:
         '''
         :param scope: Scope in which this resource is defined.
@@ -142036,6 +142045,7 @@ class CfnDataSet(
         :param row_level_permission_data_set: The row-level security configuration for the data that you want to create.
         :param row_level_permission_tag_configuration: The element you can use to define tags for row-level security.
         :param tags: Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.
+        :param use_as: The usage of the dataset.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__72d075b7003c65fe0f5754c362b528fce8eccbf0c8bca521f7a3200fbe0f67f5)
@@ -142061,6 +142071,7 @@ class CfnDataSet(
             row_level_permission_data_set=row_level_permission_data_set,
             row_level_permission_tag_configuration=row_level_permission_tag_configuration,
             tags=tags,
+            use_as=use_as,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
@@ -142466,6 +142477,19 @@ class CfnDataSet(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "tagsRaw", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="useAs")
+    def use_as(self) -> typing.Optional[builtins.str]:
+        '''The usage of the dataset.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "useAs"))
+
+    @use_as.setter
+    def use_as(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__041b16104c381498ae6d781957d86a06f6fb6293bf09e3131e88a592c0cf2dd1)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "useAs", value) # pyright: ignore[reportArgumentType]
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_quicksight.CfnDataSet.CalculatedColumnProperty",
         jsii_struct_bases=[],
@@ -142942,7 +142966,7 @@ class CfnDataSet(
         def __init__(
             self,
             *,
-            columns: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.CalculatedColumnProperty", typing.Dict[builtins.str, typing.Any]]]]],
+            columns: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.CalculatedColumnProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         ) -> None:
             '''A transform operation that creates calculated columns.
 
@@ -142970,21 +142994,20 @@ class CfnDataSet(
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__126d3e583c2ac58ef2048d1e7c04201d7b8c4b386e6e2ce57b085e7d0ff1622f)
                 check_type(argname="argument columns", value=columns, expected_type=type_hints["columns"])
-            self._values: typing.Dict[builtins.str, typing.Any] = {
-                "columns": columns,
-            }
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if columns is not None:
+                self._values["columns"] = columns
 
         @builtins.property
         def columns(
             self,
-        ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.CalculatedColumnProperty"]]]:
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.CalculatedColumnProperty"]]]]:
             '''Calculated columns to create.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-createcolumnsoperation.html#cfn-quicksight-dataset-createcolumnsoperation-columns
             '''
             result = self._values.get("columns")
-            assert result is not None, "Required property 'columns' is missing"
-            return typing.cast(typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.CalculatedColumnProperty"]]], result)
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.CalculatedColumnProperty"]]]], result)
 
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -143116,16 +143139,21 @@ class CfnDataSet(
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_quicksight.CfnDataSet.DataSetRefreshPropertiesProperty",
         jsii_struct_bases=[],
-        name_mapping={"refresh_configuration": "refreshConfiguration"},
+        name_mapping={
+            "failure_configuration": "failureConfiguration",
+            "refresh_configuration": "refreshConfiguration",
+        },
     )
     class DataSetRefreshPropertiesProperty:
         def __init__(
             self,
             *,
-            refresh_configuration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RefreshConfigurationProperty", typing.Dict[builtins.str, typing.Any]]],
+            failure_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RefreshFailureConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+            refresh_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RefreshConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
             '''The refresh properties of a dataset.
 
+            :param failure_configuration: The failure configuration for a dataset.
             :param refresh_configuration: The refresh configuration for a dataset.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-datasetrefreshproperties.html
@@ -143138,6 +143166,11 @@ class CfnDataSet(
                 from aws_cdk import aws_quicksight as quicksight
                 
                 data_set_refresh_properties_property = quicksight.CfnDataSet.DataSetRefreshPropertiesProperty(
+                    failure_configuration=quicksight.CfnDataSet.RefreshFailureConfigurationProperty(
+                        email_alert=quicksight.CfnDataSet.RefreshFailureEmailAlertProperty(
+                            alert_status="alertStatus"
+                        )
+                    ),
                     refresh_configuration=quicksight.CfnDataSet.RefreshConfigurationProperty(
                         incremental_refresh=quicksight.CfnDataSet.IncrementalRefreshProperty(
                             lookback_window=quicksight.CfnDataSet.LookbackWindowProperty(
@@ -143151,22 +143184,35 @@ class CfnDataSet(
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__f8112e3ac95c271ef07e7d73f3bc230c7463e9b93fdcd125f136b968bd641daf)
+                check_type(argname="argument failure_configuration", value=failure_configuration, expected_type=type_hints["failure_configuration"])
                 check_type(argname="argument refresh_configuration", value=refresh_configuration, expected_type=type_hints["refresh_configuration"])
-            self._values: typing.Dict[builtins.str, typing.Any] = {
-                "refresh_configuration": refresh_configuration,
-            }
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if failure_configuration is not None:
+                self._values["failure_configuration"] = failure_configuration
+            if refresh_configuration is not None:
+                self._values["refresh_configuration"] = refresh_configuration
+
+        @builtins.property
+        def failure_configuration(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureConfigurationProperty"]]:
+            '''The failure configuration for a dataset.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-datasetrefreshproperties.html#cfn-quicksight-dataset-datasetrefreshproperties-failureconfiguration
+            '''
+            result = self._values.get("failure_configuration")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureConfigurationProperty"]], result)
 
         @builtins.property
         def refresh_configuration(
             self,
-        ) -> typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshConfigurationProperty"]:
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshConfigurationProperty"]]:
             '''The refresh configuration for a dataset.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-datasetrefreshproperties.html#cfn-quicksight-dataset-datasetrefreshproperties-refreshconfiguration
             '''
             result = self._values.get("refresh_configuration")
-            assert result is not None, "Required property 'refresh_configuration' is missing"
-            return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshConfigurationProperty"], result)
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshConfigurationProperty"]], result)
 
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -144684,6 +144730,8 @@ class CfnDataSet(
                         ),
                         rename_column_operation=quicksight.CfnDataSet.RenameColumnOperationProperty(
                             column_name="columnName",
+                
+                            # the properties below are optional
                             new_column_name="newColumnName"
                         ),
                         tag_column_operation=quicksight.CfnDataSet.TagColumnOperationProperty(
@@ -145416,6 +145464,8 @@ class CfnDataSet(
                     ),
                     s3_source=quicksight.CfnDataSet.S3SourceProperty(
                         data_source_arn="dataSourceArn",
+                
+                        # the properties below are optional
                         input_columns=[quicksight.CfnDataSet.InputColumnProperty(
                             name="name",
                             type="type",
@@ -145423,8 +145473,6 @@ class CfnDataSet(
                             # the properties below are optional
                             sub_type="subType"
                         )],
-                
-                        # the properties below are optional
                         upload_settings=quicksight.CfnDataSet.UploadSettingsProperty(
                             contains_header=False,
                             delimiter="delimiter",
@@ -145610,6 +145658,120 @@ class CfnDataSet(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_quicksight.CfnDataSet.RefreshFailureConfigurationProperty",
+        jsii_struct_bases=[],
+        name_mapping={"email_alert": "emailAlert"},
+    )
+    class RefreshFailureConfigurationProperty:
+        def __init__(
+            self,
+            *,
+            email_alert: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RefreshFailureEmailAlertProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        ) -> None:
+            '''The failure configuration of a dataset.
+
+            :param email_alert: The email alert configuration for a dataset refresh failure.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureconfiguration.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_quicksight as quicksight
+                
+                refresh_failure_configuration_property = quicksight.CfnDataSet.RefreshFailureConfigurationProperty(
+                    email_alert=quicksight.CfnDataSet.RefreshFailureEmailAlertProperty(
+                        alert_status="alertStatus"
+                    )
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__d468a6df5019089014051aa389ac9f88d4d11771ae19828e4af5403058743d8f)
+                check_type(argname="argument email_alert", value=email_alert, expected_type=type_hints["email_alert"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if email_alert is not None:
+                self._values["email_alert"] = email_alert
+
+        @builtins.property
+        def email_alert(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureEmailAlertProperty"]]:
+            '''The email alert configuration for a dataset refresh failure.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureconfiguration.html#cfn-quicksight-dataset-refreshfailureconfiguration-emailalert
+            '''
+            result = self._values.get("email_alert")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureEmailAlertProperty"]], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "RefreshFailureConfigurationProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_quicksight.CfnDataSet.RefreshFailureEmailAlertProperty",
+        jsii_struct_bases=[],
+        name_mapping={"alert_status": "alertStatus"},
+    )
+    class RefreshFailureEmailAlertProperty:
+        def __init__(
+            self,
+            *,
+            alert_status: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''The configuration settings for the email alerts that are sent when a dataset refresh fails.
+
+            :param alert_status: The status value that determines if email alerts are sent.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureemailalert.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_quicksight as quicksight
+                
+                refresh_failure_email_alert_property = quicksight.CfnDataSet.RefreshFailureEmailAlertProperty(
+                    alert_status="alertStatus"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__2291b791bc9495270d0113942e61f155ad82ab0a0e20fef5f772df40f55d8fc1)
+                check_type(argname="argument alert_status", value=alert_status, expected_type=type_hints["alert_status"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if alert_status is not None:
+                self._values["alert_status"] = alert_status
+
+        @builtins.property
+        def alert_status(self) -> typing.Optional[builtins.str]:
+            '''The status value that determines if email alerts are sent.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureemailalert.html#cfn-quicksight-dataset-refreshfailureemailalert-alertstatus
+            '''
+            result = self._values.get("alert_status")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "RefreshFailureEmailAlertProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_quicksight.CfnDataSet.RelationalTableProperty",
         jsii_struct_bases=[],
@@ -145754,7 +145916,7 @@ class CfnDataSet(
             self,
             *,
             column_name: builtins.str,
-            new_column_name: builtins.str,
+            new_column_name: typing.Optional[builtins.str] = None,
         ) -> None:
             '''A transform operation that renames a column.
 
@@ -145772,6 +145934,8 @@ class CfnDataSet(
                 
                 rename_column_operation_property = quicksight.CfnDataSet.RenameColumnOperationProperty(
                     column_name="columnName",
+                
+                    # the properties below are optional
                     new_column_name="newColumnName"
                 )
             '''
@@ -145781,8 +145945,9 @@ class CfnDataSet(
                 check_type(argname="argument new_column_name", value=new_column_name, expected_type=type_hints["new_column_name"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "column_name": column_name,
-                "new_column_name": new_column_name,
             }
+            if new_column_name is not None:
+                self._values["new_column_name"] = new_column_name
 
         @builtins.property
         def column_name(self) -> builtins.str:
@@ -145795,14 +145960,13 @@ class CfnDataSet(
             return typing.cast(builtins.str, result)
 
         @builtins.property
-        def new_column_name(self) -> builtins.str:
+        def new_column_name(self) -> typing.Optional[builtins.str]:
             '''The new name for the column.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-renamecolumnoperation.html#cfn-quicksight-dataset-renamecolumnoperation-newcolumnname
             '''
             result = self._values.get("new_column_name")
-            assert result is not None, "Required property 'new_column_name' is missing"
-            return typing.cast(builtins.str, result)
+            return typing.cast(typing.Optional[builtins.str], result)
 
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -146255,7 +146419,7 @@ class CfnDataSet(
             self,
             *,
             data_source_arn: builtins.str,
-            input_columns: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.InputColumnProperty", typing.Dict[builtins.str, typing.Any]]]]],
+            input_columns: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.InputColumnProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
             upload_settings: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.UploadSettingsProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
             '''A physical table type for an S3 data source.
@@ -146275,6 +146439,8 @@ class CfnDataSet(
                 
                 s3_source_property = quicksight.CfnDataSet.S3SourceProperty(
                     data_source_arn="dataSourceArn",
+                
+                    # the properties below are optional
                     input_columns=[quicksight.CfnDataSet.InputColumnProperty(
                         name="name",
                         type="type",
@@ -146282,8 +146448,6 @@ class CfnDataSet(
                         # the properties below are optional
                         sub_type="subType"
                     )],
-                
-                    # the properties below are optional
                     upload_settings=quicksight.CfnDataSet.UploadSettingsProperty(
                         contains_header=False,
                         delimiter="delimiter",
@@ -146300,8 +146464,9 @@ class CfnDataSet(
                 check_type(argname="argument upload_settings", value=upload_settings, expected_type=type_hints["upload_settings"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "data_source_arn": data_source_arn,
-                "input_columns": input_columns,
             }
+            if input_columns is not None:
+                self._values["input_columns"] = input_columns
             if upload_settings is not None:
                 self._values["upload_settings"] = upload_settings
 
@@ -146318,7 +146483,7 @@ class CfnDataSet(
         @builtins.property
         def input_columns(
             self,
-        ) -> typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.InputColumnProperty"]]]:
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.InputColumnProperty"]]]]:
             '''A physical table type for an S3 data source.
 
             .. epigraph::
@@ -146328,8 +146493,7 @@ class CfnDataSet(
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-s3source.html#cfn-quicksight-dataset-s3source-inputcolumns
             '''
             result = self._values.get("input_columns")
-            assert result is not None, "Required property 'input_columns' is missing"
-            return typing.cast(typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.InputColumnProperty"]]], result)
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnDataSet.InputColumnProperty"]]]], result)
 
         @builtins.property
         def upload_settings(
@@ -146691,6 +146855,8 @@ class CfnDataSet(
                     ),
                     rename_column_operation=quicksight.CfnDataSet.RenameColumnOperationProperty(
                         column_name="columnName",
+                
+                        # the properties below are optional
                         new_column_name="newColumnName"
                     ),
                     tag_column_operation=quicksight.CfnDataSet.TagColumnOperationProperty(
@@ -146980,12 +147146,13 @@ class CfnDataSet(
             start_from_row: typing.Optional[jsii.Number] = None,
             text_qualifier: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param contains_header: 
-            :param delimiter: 
-            :param format: 
-            :param start_from_row: 
-            :param text_qualifier: 
+            '''Information about the format for a source file or files.
+
+            :param contains_header: Whether the file has a header row, or the files each have a header row.
+            :param delimiter: The delimiter between values in the file.
+            :param format: File format.
+            :param start_from_row: A row number to start reading data from.
+            :param text_qualifier: Text qualifier.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html
             :exampleMetadata: fixture=_generated
@@ -147027,7 +147194,8 @@ class CfnDataSet(
         def contains_header(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''
+            '''Whether the file has a header row, or the files each have a header row.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-containsheader
             '''
             result = self._values.get("contains_header")
@@ -147035,7 +147203,8 @@ class CfnDataSet(
 
         @builtins.property
         def delimiter(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The delimiter between values in the file.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-delimiter
             '''
             result = self._values.get("delimiter")
@@ -147043,7 +147212,8 @@ class CfnDataSet(
 
         @builtins.property
         def format(self) -> typing.Optional[builtins.str]:
-            '''
+            '''File format.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-format
             '''
             result = self._values.get("format")
@@ -147051,7 +147221,8 @@ class CfnDataSet(
 
         @builtins.property
         def start_from_row(self) -> typing.Optional[jsii.Number]:
-            '''
+            '''A row number to start reading data from.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-startfromrow
             '''
             result = self._values.get("start_from_row")
@@ -147059,7 +147230,8 @@ class CfnDataSet(
 
         @builtins.property
         def text_qualifier(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Text qualifier.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-textqualifier
             '''
             result = self._values.get("text_qualifier")
@@ -147100,6 +147272,7 @@ class CfnDataSet(
         "row_level_permission_data_set": "rowLevelPermissionDataSet",
         "row_level_permission_tag_configuration": "rowLevelPermissionTagConfiguration",
         "tags": "tags",
+        "use_as": "useAs",
     },
 )
 class CfnDataSetProps:
@@ -147125,6 +147298,7 @@ class CfnDataSetProps:
         row_level_permission_data_set: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionDataSetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         row_level_permission_tag_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionTagConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+        use_as: typing.Optional[builtins.str] = None,
     ) -> None:
         '''Properties for defining a ``CfnDataSet``.
 
@@ -147147,6 +147321,7 @@ class CfnDataSetProps:
         :param row_level_permission_data_set: The row-level security configuration for the data that you want to create.
         :param row_level_permission_tag_configuration: The element you can use to define tags for row-level security.
         :param tags: Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.
+        :param use_as: The usage of the dataset.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html
         :exampleMetadata: fixture=_generated
@@ -147219,6 +147394,11 @@ class CfnDataSetProps:
                     )
                 )],
                 data_set_refresh_properties=quicksight.CfnDataSet.DataSetRefreshPropertiesProperty(
+                    failure_configuration=quicksight.CfnDataSet.RefreshFailureConfigurationProperty(
+                        email_alert=quicksight.CfnDataSet.RefreshFailureEmailAlertProperty(
+                            alert_status="alertStatus"
+                        )
+                    ),
                     refresh_configuration=quicksight.CfnDataSet.RefreshConfigurationProperty(
                         incremental_refresh=quicksight.CfnDataSet.IncrementalRefreshProperty(
                             lookback_window=quicksight.CfnDataSet.LookbackWindowProperty(
@@ -147286,6 +147466,8 @@ class CfnDataSetProps:
                             ),
                             rename_column_operation=quicksight.CfnDataSet.RenameColumnOperationProperty(
                                 column_name="columnName",
+            
+                                # the properties below are optional
                                 new_column_name="newColumnName"
                             ),
                             tag_column_operation=quicksight.CfnDataSet.TagColumnOperationProperty(
@@ -147365,6 +147547,8 @@ class CfnDataSetProps:
                         ),
                         s3_source=quicksight.CfnDataSet.S3SourceProperty(
                             data_source_arn="dataSourceArn",
+            
+                            # the properties below are optional
                             input_columns=[quicksight.CfnDataSet.InputColumnProperty(
                                 name="name",
                                 type="type",
@@ -147372,8 +147556,6 @@ class CfnDataSetProps:
                                 # the properties below are optional
                                 sub_type="subType"
                             )],
-            
-                            # the properties below are optional
                             upload_settings=quicksight.CfnDataSet.UploadSettingsProperty(
                                 contains_header=False,
                                 delimiter="delimiter",
@@ -147410,7 +147592,8 @@ class CfnDataSetProps:
                 tags=[CfnTag(
                     key="key",
                     value="value"
-                )]
+                )],
+                use_as="useAs"
             )
         '''
         if __debug__:
@@ -147434,6 +147617,7 @@ class CfnDataSetProps:
             check_type(argname="argument row_level_permission_data_set", value=row_level_permission_data_set, expected_type=type_hints["row_level_permission_data_set"])
             check_type(argname="argument row_level_permission_tag_configuration", value=row_level_permission_tag_configuration, expected_type=type_hints["row_level_permission_tag_configuration"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
+            check_type(argname="argument use_as", value=use_as, expected_type=type_hints["use_as"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if aws_account_id is not None:
             self._values["aws_account_id"] = aws_account_id
@@ -147473,6 +147657,8 @@ class CfnDataSetProps:
             self._values["row_level_permission_tag_configuration"] = row_level_permission_tag_configuration
         if tags is not None:
             self._values["tags"] = tags
+        if use_as is not None:
+            self._values["use_as"] = use_as
 
     @builtins.property
     def aws_account_id(self) -> typing.Optional[builtins.str]:
@@ -147676,6 +147862,15 @@ class CfnDataSetProps:
         result = self._values.get("tags")
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], result)
 
+    @builtins.property
+    def use_as(self) -> typing.Optional[builtins.str]:
+        '''The usage of the dataset.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html#cfn-quicksight-dataset-useas
+        '''
+        result = self._values.get("use_as")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -237629,6 +237824,7 @@ def _typecheckingstub__72d075b7003c65fe0f5754c362b528fce8eccbf0c8bca521f7a3200fb
     row_level_permission_data_set: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionDataSetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     row_level_permission_tag_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionTagConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    use_as: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -237759,6 +237955,12 @@ def _typecheckingstub__0e864069859eae5b6577c26a255c633579a87c4792fb22892d990896a
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__041b16104c381498ae6d781957d86a06f6fb6293bf09e3131e88a592c0cf2dd1(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__c1231ad01a76710b79ae378de78ccc76bb05c75d0f0df4211be06aa6a0b32293(
     *,
     column_id: builtins.str,
@@ -237810,7 +238012,7 @@ def _typecheckingstub__8810951f5cd6f00a3afedc51ad0485b75cccc19bb1600c05ce2728021
 
 def _typecheckingstub__126d3e583c2ac58ef2048d1e7c04201d7b8c4b386e6e2ce57b085e7d0ff1622f(
     *,
-    columns: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.CalculatedColumnProperty, typing.Dict[builtins.str, typing.Any]]]]],
+    columns: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.CalculatedColumnProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -237827,7 +238029,8 @@ def _typecheckingstub__97e4fcb997b025bd8b8162d5528bd73bc1c489c80a53a49d2bf3f33ac
 
 def _typecheckingstub__f8112e3ac95c271ef07e7d73f3bc230c7463e9b93fdcd125f136b968bd641daf(
     *,
-    refresh_configuration: typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RefreshConfigurationProperty, typing.Dict[builtins.str, typing.Any]]],
+    failure_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RefreshFailureConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    refresh_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RefreshConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -238055,6 +238258,20 @@ def _typecheckingstub__4f5b07a3830c8168aac61eee81da7fe4ea32166016cf2c4406b473b41
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__d468a6df5019089014051aa389ac9f88d4d11771ae19828e4af5403058743d8f(
+    *,
+    email_alert: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RefreshFailureEmailAlertProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__2291b791bc9495270d0113942e61f155ad82ab0a0e20fef5f772df40f55d8fc1(
+    *,
+    alert_status: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__bc43d1be088dad877549378a89c5cca422c52436d49d6b5d4f473a7370858ebd(
     *,
     data_source_arn: builtins.str,
@@ -238069,7 +238286,7 @@ def _typecheckingstub__bc43d1be088dad877549378a89c5cca422c52436d49d6b5d4f473a737
 def _typecheckingstub__d5b477884d5da5b0f50ad9bab47f315489aa821b4b6099b0c110eaa21199d621(
     *,
     column_name: builtins.str,
-    new_column_name: builtins.str,
+    new_column_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -238115,7 +238332,7 @@ def _typecheckingstub__81cfe18daaf7f1cce3330a7282c27dcdf7db3dfda4816cbbf0d13de88
 def _typecheckingstub__79cf313addf8aafc0315b078c7ce60c5b690622f4de3e59d06a4acc66261b863(
     *,
     data_source_arn: builtins.str,
-    input_columns: typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.InputColumnProperty, typing.Dict[builtins.str, typing.Any]]]]],
+    input_columns: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.InputColumnProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     upload_settings: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.UploadSettingsProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -238207,6 +238424,7 @@ def _typecheckingstub__61032f5c9704bd9765ba5fe5f2862434b85348f65b701e3a44b806fef
     row_level_permission_data_set: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionDataSetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     row_level_permission_tag_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnDataSet.RowLevelPermissionTagConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
+    use_as: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass