update_data_set ¶

def update_data_set(
    self,
    aws_account_id: "capo_quicksight.types.aws_account_id.AwsAccountId",
    data_set_id: "capo_quicksight.types.resource_id.ResourceId",
    name: "capo_quicksight.types.resource_name.ResourceName",
    physical_table_map: "capo_quicksight.types.physical_table_map.PhysicalTableMap",
    import_mode: "capo_quicksight.types.data_set_import_mode.DataSetImportMode",
    *,
    config_overrides: Optional[QuickSightClientConfig] = None,
    logical_table_map: Optional[
        "capo_quicksight.types.logical_table_map.LogicalTableMap"
    ] = None,
    column_groups: Optional[
        "capo_quicksight.types.column_group_list.ColumnGroupList"
    ] = None,
    field_folders: Optional[
        "capo_quicksight.types.field_folder_map.FieldFolderMap"
    ] = None,
    row_level_permission_data_set: Optional[
        "capo_quicksight.types.row_level_permission_data_set.RowLevelPermissionDataSet"
    ] = None,
    row_level_permission_tag_configuration: Optional[
        "capo_quicksight.types.row_level_permission_tag_configuration.RowLevelPermissionTagConfiguration"
    ] = None,
    column_level_permission_rules: Optional[
        "capo_quicksight.types.column_level_permission_rule_list.ColumnLevelPermissionRuleList"
    ] = None,
    data_set_usage_configuration: Optional[
        "capo_quicksight.types.data_set_usage_configuration.DataSetUsageConfiguration"
    ] = None,
    dataset_parameters: Optional[
        "capo_quicksight.types.dataset_parameter_list.DatasetParameterList"
    ] = None,
    performance_configuration: Optional[
        "capo_quicksight.types.performance_configuration.PerformanceConfiguration"
    ] = None,
    data_prep_configuration: Optional[
        "capo_quicksight.types.data_prep_configuration.DataPrepConfiguration"
    ] = None,
    semantic_model_configuration: Optional[
        "capo_quicksight.types.semantic_model_configuration.SemanticModelConfiguration"
    ] = None,
) -> "capo_quicksight.types.update_data_set_response.UpdateDataSetResponse":
    """<p>Updates a dataset. Partial updates are not supported by this operation.</p>

    Args:
        aws_account_id: <p>The Amazon Web Services account ID.</p>
        data_set_id: <p>The ID for the dataset that you want to update. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.</p>
        name: <p>The display name for the dataset.</p>
        physical_table_map: <p>Declares the physical tables that are available in the underlying data sources.</p>
        logical_table_map: <p>Configures the combination and transformation of the data from the physical tables. This parameter is used with the legacy data preparation experience.</p>
        import_mode: <p>Indicates whether you want to import the data into SPICE.</p>
        column_groups: <p>Groupings of columns that work together in certain Amazon Quick Sight features. Currently, only geospatial hierarchy is supported.</p>
        field_folders: <p>The folder that contains fields and nested subfolders for your dataset.</p>
        row_level_permission_data_set: <p>The row-level security configuration for the data you want to create. This parameter is used with the legacy data preparation experience.</p>
        row_level_permission_tag_configuration: <p>The configuration of tags on a dataset to set row-level security. Row-level security tags are currently supported for anonymous embedding only. This parameter is used with the legacy data preparation experience.</p>
        column_level_permission_rules: <p>A set of one or more definitions of a <code> <a href="https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ColumnLevelPermissionRule.html">ColumnLevelPermissionRule</a> </code>.</p>
        dataset_parameters: <p>The parameter declarations of the dataset.</p>
        performance_configuration: <p>The configuration for the performance optimization of the dataset that contains a <code>UniqueKey</code> configuration.</p>
        data_prep_configuration: <p>The data preparation configuration for the dataset. This configuration defines the source tables, transformation steps, and destination tables used to prepare the data. Required when using the new data preparation experience.</p>
        semantic_model_configuration: <p>The semantic model configuration for the dataset. This configuration defines how the prepared data is structured for an analysis, including table mappings and row-level security configurations. Required when using the new data preparation experience.</p>

    Raises:
        capo_quicksight.errors.access_denied_exception.AccessDeniedException: <p>You don't have access to this item. The provided credentials couldn't be validated. You might not be authorized to carry out the request. Make sure that your account is authorized to use the Amazon Quick Sight service, that your policies have the correct permissions, and that you are using the correct credentials.</p>
        capo_quicksight.errors.conflict_exception.ConflictException: <p>Updating or deleting a resource can cause an inconsistent state.</p>
        capo_quicksight.errors.internal_failure_exception.InternalFailureException: <p>An internal failure occurred.</p>
        capo_quicksight.errors.invalid_data_set_parameter_value_exception.InvalidDataSetParameterValueException: <p>An exception thrown when an invalid parameter value is provided for dataset operations.</p>
        capo_quicksight.errors.invalid_parameter_value_exception.InvalidParameterValueException: <p>One or more parameters has a value that isn't valid.</p>
        capo_quicksight.errors.limit_exceeded_exception.LimitExceededException: <p>A limit is exceeded.</p>
        capo_quicksight.errors.resource_not_found_exception.ResourceNotFoundException: <p>One or more resources can't be found.</p>
        capo_quicksight.errors.throttling_exception.ThrottlingException: <p>Access is throttled.</p>
        capo_quicksight.errors.unsupported_user_edition_exception.UnsupportedUserEditionException: <p>This error indicates that you are calling an operation on an Amazon Quick Suite subscription where the edition doesn't include support for that operation. Amazon Quick Suite currently has Standard Edition and Enterprise Edition. Not every operation and capability is available in every edition.</p>
        capo_quicksight.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_quicksight.types.update_data_set_request.UpdateDataSetRequest]",
    ) -> OperationResponse[
        "capo_quicksight.types.update_data_set_response.UpdateDataSetResponse"
    ]:
        import capo_quicksight._operations.quick_sight_20180401.update_data_set

        output, http_response = (
            capo_quicksight._operations.quick_sight_20180401.update_data_set.update_data_set(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    def _redact_input(
        input_: "capo_quicksight.types.update_data_set_request.UpdateDataSetRequest",
    ) -> dict[str, Any]:
        import capo_quicksight.types.update_data_set_request

        return capo_quicksight.types.update_data_set_request.redact_sensitive(
            input_
        )

    interceptors_, options_ = self.operation_options(
        config_overrides,
        OperationLogging("UpdateDataSet", redact_input=_redact_input),
    )
    input_: capo_quicksight.types.update_data_set_request.UpdateDataSetRequest = {
        "aws_account_id": aws_account_id,
        "data_set_id": data_set_id,
        "name": name,
        "physical_table_map": physical_table_map,
        "import_mode": import_mode,
    }
    if logical_table_map is not None:
        input_["logical_table_map"] = logical_table_map
    if column_groups is not None:
        input_["column_groups"] = column_groups
    if field_folders is not None:
        input_["field_folders"] = field_folders
    if row_level_permission_data_set is not None:
        input_["row_level_permission_data_set"] = row_level_permission_data_set
    if row_level_permission_tag_configuration is not None:
        input_["row_level_permission_tag_configuration"] = (
            row_level_permission_tag_configuration
        )
    if column_level_permission_rules is not None:
        input_["column_level_permission_rules"] = column_level_permission_rules
    if data_set_usage_configuration is not None:
        input_["data_set_usage_configuration"] = data_set_usage_configuration
    if dataset_parameters is not None:
        input_["dataset_parameters"] = dataset_parameters
    if performance_configuration is not None:
        input_["performance_configuration"] = performance_configuration
    if data_prep_configuration is not None:
        input_["data_prep_configuration"] = data_prep_configuration
    if semantic_model_configuration is not None:
        input_["semantic_model_configuration"] = semantic_model_configuration

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output