Class CfnDataSet
java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.CfnElement
software.amazon.awscdk.CfnRefElement
software.amazon.awscdk.CfnResource
software.amazon.awscdk.services.quicksight.CfnDataSet
- All Implemented Interfaces:
IInspectable,ITaggable,software.amazon.jsii.JsiiSerializable,software.constructs.IConstruct,software.constructs.IDependable
@Generated(value="jsii-pacmak/1.110.0 (build 336b265)",
date="2025-04-22T23:08:18.423Z")
@Stability(Stable)
public class CfnDataSet
extends CfnResource
implements IInspectable, ITaggable
Creates a dataset.
This operation doesn't support datasets that include uploaded files as a source.
Example:
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.quicksight.*;
Object tagRuleConfigurations;
CfnDataSet cfnDataSet = CfnDataSet.Builder.create(this, "MyCfnDataSet")
.awsAccountId("awsAccountId")
.columnGroups(List.of(ColumnGroupProperty.builder()
.geoSpatialColumnGroup(GeoSpatialColumnGroupProperty.builder()
.columns(List.of("columns"))
.name("name")
// the properties below are optional
.countryCode("countryCode")
.build())
.build()))
.columnLevelPermissionRules(List.of(ColumnLevelPermissionRuleProperty.builder()
.columnNames(List.of("columnNames"))
.principals(List.of("principals"))
.build()))
.dataSetId("dataSetId")
.datasetParameters(List.of(DatasetParameterProperty.builder()
.dateTimeDatasetParameter(DateTimeDatasetParameterProperty.builder()
.id("id")
.name("name")
.valueType("valueType")
// the properties below are optional
.defaultValues(DateTimeDatasetParameterDefaultValuesProperty.builder()
.staticValues(List.of("staticValues"))
.build())
.timeGranularity("timeGranularity")
.build())
.decimalDatasetParameter(DecimalDatasetParameterProperty.builder()
.id("id")
.name("name")
.valueType("valueType")
// the properties below are optional
.defaultValues(DecimalDatasetParameterDefaultValuesProperty.builder()
.staticValues(List.of(123))
.build())
.build())
.integerDatasetParameter(IntegerDatasetParameterProperty.builder()
.id("id")
.name("name")
.valueType("valueType")
// the properties below are optional
.defaultValues(IntegerDatasetParameterDefaultValuesProperty.builder()
.staticValues(List.of(123))
.build())
.build())
.stringDatasetParameter(StringDatasetParameterProperty.builder()
.id("id")
.name("name")
.valueType("valueType")
// the properties below are optional
.defaultValues(StringDatasetParameterDefaultValuesProperty.builder()
.staticValues(List.of("staticValues"))
.build())
.build())
.build()))
.dataSetRefreshProperties(DataSetRefreshPropertiesProperty.builder()
.failureConfiguration(RefreshFailureConfigurationProperty.builder()
.emailAlert(RefreshFailureEmailAlertProperty.builder()
.alertStatus("alertStatus")
.build())
.build())
.refreshConfiguration(RefreshConfigurationProperty.builder()
.incrementalRefresh(IncrementalRefreshProperty.builder()
.lookbackWindow(LookbackWindowProperty.builder()
.columnName("columnName")
.size(123)
.sizeUnit("sizeUnit")
.build())
.build())
.build())
.build())
.dataSetUsageConfiguration(DataSetUsageConfigurationProperty.builder()
.disableUseAsDirectQuerySource(false)
.disableUseAsImportedSource(false)
.build())
.fieldFolders(Map.of(
"fieldFoldersKey", FieldFolderProperty.builder()
.columns(List.of("columns"))
.description("description")
.build()))
.folderArns(List.of("folderArns"))
.importMode("importMode")
.ingestionWaitPolicy(IngestionWaitPolicyProperty.builder()
.ingestionWaitTimeInHours(123)
.waitForSpiceIngestion(false)
.build())
.logicalTableMap(Map.of(
"logicalTableMapKey", LogicalTableProperty.builder()
.alias("alias")
// the properties below are optional
.dataTransforms(List.of(TransformOperationProperty.builder()
.castColumnTypeOperation(CastColumnTypeOperationProperty.builder()
.columnName("columnName")
.newColumnType("newColumnType")
// the properties below are optional
.format("format")
.subType("subType")
.build())
.createColumnsOperation(CreateColumnsOperationProperty.builder()
.columns(List.of(CalculatedColumnProperty.builder()
.columnId("columnId")
.columnName("columnName")
.expression("expression")
.build()))
.build())
.filterOperation(FilterOperationProperty.builder()
.conditionExpression("conditionExpression")
.build())
.overrideDatasetParameterOperation(OverrideDatasetParameterOperationProperty.builder()
.parameterName("parameterName")
// the properties below are optional
.newDefaultValues(NewDefaultValuesProperty.builder()
.dateTimeStaticValues(List.of("dateTimeStaticValues"))
.decimalStaticValues(List.of(123))
.integerStaticValues(List.of(123))
.stringStaticValues(List.of("stringStaticValues"))
.build())
.newParameterName("newParameterName")
.build())
.projectOperation(ProjectOperationProperty.builder()
.projectedColumns(List.of("projectedColumns"))
.build())
.renameColumnOperation(RenameColumnOperationProperty.builder()
.columnName("columnName")
// the properties below are optional
.newColumnName("newColumnName")
.build())
.tagColumnOperation(TagColumnOperationProperty.builder()
.columnName("columnName")
.tags(List.of(ColumnTagProperty.builder()
.columnDescription(ColumnDescriptionProperty.builder()
.text("text")
.build())
.columnGeographicRole("columnGeographicRole")
.build()))
.build())
.untagColumnOperation(UntagColumnOperationProperty.builder()
.columnName("columnName")
.tagNames(List.of("tagNames"))
.build())
.build()))
.source(LogicalTableSourceProperty.builder()
.dataSetArn("dataSetArn")
.joinInstruction(JoinInstructionProperty.builder()
.leftOperand("leftOperand")
.onClause("onClause")
.rightOperand("rightOperand")
.type("type")
// the properties below are optional
.leftJoinKeyProperties(JoinKeyPropertiesProperty.builder()
.uniqueKey(false)
.build())
.rightJoinKeyProperties(JoinKeyPropertiesProperty.builder()
.uniqueKey(false)
.build())
.build())
.physicalTableId("physicalTableId")
.build())
.build()))
.name("name")
.performanceConfiguration(PerformanceConfigurationProperty.builder()
.uniqueKeys(List.of(UniqueKeyProperty.builder()
.columnNames(List.of("columnNames"))
.build()))
.build())
.permissions(List.of(ResourcePermissionProperty.builder()
.actions(List.of("actions"))
.principal("principal")
.build()))
.physicalTableMap(Map.of(
"physicalTableMapKey", PhysicalTableProperty.builder()
.customSql(CustomSqlProperty.builder()
.dataSourceArn("dataSourceArn")
.name("name")
.sqlQuery("sqlQuery")
// the properties below are optional
.columns(List.of(InputColumnProperty.builder()
.name("name")
.type("type")
// the properties below are optional
.subType("subType")
.build()))
.build())
.relationalTable(RelationalTableProperty.builder()
.dataSourceArn("dataSourceArn")
.name("name")
// the properties below are optional
.catalog("catalog")
.inputColumns(List.of(InputColumnProperty.builder()
.name("name")
.type("type")
// the properties below are optional
.subType("subType")
.build()))
.schema("schema")
.build())
.s3Source(S3SourceProperty.builder()
.dataSourceArn("dataSourceArn")
// the properties below are optional
.inputColumns(List.of(InputColumnProperty.builder()
.name("name")
.type("type")
// the properties below are optional
.subType("subType")
.build()))
.uploadSettings(UploadSettingsProperty.builder()
.containsHeader(false)
.delimiter("delimiter")
.format("format")
.startFromRow(123)
.textQualifier("textQualifier")
.build())
.build())
.build()))
.rowLevelPermissionDataSet(RowLevelPermissionDataSetProperty.builder()
.arn("arn")
.permissionPolicy("permissionPolicy")
// the properties below are optional
.formatVersion("formatVersion")
.namespace("namespace")
.status("status")
.build())
.rowLevelPermissionTagConfiguration(RowLevelPermissionTagConfigurationProperty.builder()
.tagRules(List.of(RowLevelPermissionTagRuleProperty.builder()
.columnName("columnName")
.tagKey("tagKey")
// the properties below are optional
.matchAllValue("matchAllValue")
.tagMultiValueDelimiter("tagMultiValueDelimiter")
.build()))
// the properties below are optional
.status("status")
.tagRuleConfigurations(tagRuleConfigurations)
.build())
.tags(List.of(CfnTag.builder()
.key("key")
.value("value")
.build()))
.useAs("useAs")
.build();
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final classA fluent builder forCfnDataSet.static interfaceA calculated column for a dataset.static interfaceA transform operation that casts a column to a different type.static interfaceMetadata that contains a description for a column.static interfaceGroupings of columns that work together in certain Amazon QuickSight features.static interfaceA rule defined to grant access on one or more restricted columns.static interfaceA tag for a column in a[TagColumnOperation](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_TagColumnOperation.html)structure.static interfaceA transform operation that creates calculated columns.static interfaceA physical table type built from the results of the custom SQL query.static interfaceThe parameter declarations of the dataset.static interfaceThe refresh properties of a dataset.static interfaceThe usage configuration to apply to child datasets that reference this dataset as a source.static interfaceThe default values of a date time parameter.static interfaceA date time parameter that is created in the dataset.static interfaceA list of default values for a given decimal parameter.static interfaceA decimal parameter that is created in the dataset.static interfaceA FieldFolder element is a folder that contains fields and nested subfolders.static interfaceA transform operation that filters rows based on a condition.static interfaceGeospatial column group that denotes a hierarchy.static interfaceThe incremental refresh configuration for a dataset.static interfaceThe wait policy to use when creating or updating a Dataset.static interfaceMetadata for a column that is used as the input of a transform operation.static interfaceA list of default values for a given integer parameter.static interfaceAn integer parameter that is created in the dataset.static interfaceThe instructions associated with a join.static interfaceProperties associated with the columns participating in a join.static interfaceA logical table is a unit that joins and that data transformations operate on.static interfaceInformation about the source of a logical table.static interfaceThe lookback window setup of an incremental refresh configuration.static interfaceThe new default values for the parameter.static interfaceOutput column.static interfaceA transform operation that overrides the dataset parameter values that are defined in another dataset.static interfaceExample:static interfaceA view of a data source that contains information about the shape of the data in the underlying source.static interfaceA transform operation that projects columns.static interfaceThe refresh configuration of a dataset.static interfaceThe failure configuration of a dataset.static interfaceThe configuration settings for the email alerts that are sent when a dataset refresh fails.static interfaceA physical table type for relational data sources.static interfaceA transform operation that renames a column.static interfacePermission for the resource.static interfaceInformation about a dataset that contains permissions for row-level security (RLS).static interfaceThe element you can use to define tags for row-level security.static interfaceA set of rules associated with a tag.static interfaceA physical table type for an S3 data source.static interfaceA list of default values for a given string dataset parameter type.static interfaceA string parameter that is created in the dataset.static interfaceA transform operation that tags a column with additional information.static interfaceA data transformation on a logical table.static interfaceExample:static interfaceA transform operation that removes tags associated with a column.static interfaceInformation about the format for a source file or files.Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject
software.amazon.jsii.JsiiObject.InitializationModeNested classes/interfaces inherited from interface software.constructs.IConstruct
software.constructs.IConstruct.Jsii$DefaultNested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable
IInspectable.Jsii$Default, IInspectable.Jsii$ProxyNested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable
ITaggable.Jsii$Default, ITaggable.Jsii$Proxy -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe CloudFormation resource type name for this resource class. -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedCfnDataSet(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) protectedCfnDataSet(software.amazon.jsii.JsiiObjectRef objRef) CfnDataSet(software.constructs.Construct scope, String id) CfnDataSet(software.constructs.Construct scope, String id, CfnDataSetProps props) -
Method Summary
Modifier and TypeMethodDescriptionThe Amazon Resource Name (ARN) of the dataset.The amount of SPICE capacity used by this dataset.The time this dataset version was created.The time this dataset version was last updated.The list of columns after all transforms.The AWS account ID.Groupings of columns that work together in certain Amazon QuickSight features.A set of one or more definitions of aColumnLevelPermissionRule.An ID for the dataset that you want to create.The parameters that are declared in a dataset.The refresh properties of a dataset.The usage configuration to apply to child datasets that reference this dataset as a source.The folder that contains fields and nested subfolders for your dataset.When you create the dataset, Amazon QuickSight adds the dataset to these folders.Indicates whether you want to import the data into SPICE.The wait policy to use when creating or updating a Dataset.Configures the combination and transformation of the data from the physical tables.getName()The display name for the dataset.The performance optimization configuration of a dataset.A list of resource permissions on the dataset.Declares the physical tables that are available in the underlying data sources.The row-level security configuration for the data that you want to create.The element you can use to define tags for row-level security.getTags()Tag Manager which manages the tags for this resource.Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.getUseAs()The usage of the dataset.voidinspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.renderProperties(Map<String, Object> props) voidsetAwsAccountId(String value) The AWS account ID.voidsetColumnGroups(List<Object> value) Groupings of columns that work together in certain Amazon QuickSight features.voidsetColumnGroups(IResolvable value) Groupings of columns that work together in certain Amazon QuickSight features.voidsetColumnLevelPermissionRules(List<Object> value) A set of one or more definitions of aColumnLevelPermissionRule.voidA set of one or more definitions of aColumnLevelPermissionRule.voidsetDataSetId(String value) An ID for the dataset that you want to create.voidsetDatasetParameters(List<Object> value) The parameters that are declared in a dataset.voidsetDatasetParameters(IResolvable value) The parameters that are declared in a dataset.voidThe refresh properties of a dataset.voidThe refresh properties of a dataset.voidThe usage configuration to apply to child datasets that reference this dataset as a source.voidThe usage configuration to apply to child datasets that reference this dataset as a source.voidsetFieldFolders(Map<String, Object> value) The folder that contains fields and nested subfolders for your dataset.voidsetFieldFolders(IResolvable value) The folder that contains fields and nested subfolders for your dataset.voidsetFolderArns(List<String> value) When you create the dataset, Amazon QuickSight adds the dataset to these folders.voidsetImportMode(String value) Indicates whether you want to import the data into SPICE.voidThe wait policy to use when creating or updating a Dataset.voidThe wait policy to use when creating or updating a Dataset.voidsetLogicalTableMap(Map<String, Object> value) Configures the combination and transformation of the data from the physical tables.voidsetLogicalTableMap(IResolvable value) Configures the combination and transformation of the data from the physical tables.voidThe display name for the dataset.voidThe performance optimization configuration of a dataset.voidThe performance optimization configuration of a dataset.voidsetPermissions(List<Object> value) A list of resource permissions on the dataset.voidsetPermissions(IResolvable value) A list of resource permissions on the dataset.voidsetPhysicalTableMap(Map<String, Object> value) Declares the physical tables that are available in the underlying data sources.voidsetPhysicalTableMap(IResolvable value) Declares the physical tables that are available in the underlying data sources.voidThe row-level security configuration for the data that you want to create.voidThe row-level security configuration for the data that you want to create.voidThe element you can use to define tags for row-level security.voidThe element you can use to define tags for row-level security.voidsetTagsRaw(List<CfnTag> value) Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.voidThe usage of the dataset.Methods inherited from class software.amazon.awscdk.CfnResource
addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validatePropertiesMethods inherited from class software.amazon.awscdk.CfnRefElement
getRefMethods inherited from class software.amazon.awscdk.CfnElement
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalIdMethods inherited from class software.constructs.Construct
getNode, isConstructMethods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSetMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Field Details
-
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
-
-
Constructor Details
-
CfnDataSet
protected CfnDataSet(software.amazon.jsii.JsiiObjectRef objRef) -
CfnDataSet
protected CfnDataSet(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) -
CfnDataSet
@Stability(Stable) public CfnDataSet(@NotNull software.constructs.Construct scope, @NotNull String id, @Nullable CfnDataSetProps props) - Parameters:
scope- Scope in which this resource is defined. This parameter is required.id- Construct identifier for this resource (unique in its scope). This parameter is required.props- Resource properties.
-
CfnDataSet
@Stability(Stable) public CfnDataSet(@NotNull software.constructs.Construct scope, @NotNull String id) - Parameters:
scope- Scope in which this resource is defined. This parameter is required.id- Construct identifier for this resource (unique in its scope). This parameter is required.
-
-
Method Details
-
inspect
Examines the CloudFormation resource and discloses attributes.- Specified by:
inspectin interfaceIInspectable- Parameters:
inspector- tree inspector to collect and process attributes. This parameter is required.
-
renderProperties
@Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String, Object> props) - Overrides:
renderPropertiesin classCfnResource- Parameters:
props- This parameter is required.
-
getAttrArn
The Amazon Resource Name (ARN) of the dataset. -
getAttrConsumedSpiceCapacityInBytes
The amount of SPICE capacity used by this dataset.
This is 0 if the dataset isn't imported into SPICE.
-
getAttrCreatedTime
The time this dataset version was created. -
getAttrLastUpdatedTime
The time this dataset version was last updated. -
getAttrOutputColumns
The list of columns after all transforms.
These columns are available in templates, analyses, and dashboards.
-
getCfnProperties
- Overrides:
getCfnPropertiesin classCfnResource
-
getTags
Tag Manager which manages the tags for this resource. -
getAwsAccountId
The AWS account ID. -
setAwsAccountId
The AWS account ID. -
getColumnGroups
Groupings of columns that work together in certain Amazon QuickSight features. -
setColumnGroups
Groupings of columns that work together in certain Amazon QuickSight features. -
setColumnGroups
Groupings of columns that work together in certain Amazon QuickSight features. -
getColumnLevelPermissionRules
A set of one or more definitions of aColumnLevelPermissionRule. -
setColumnLevelPermissionRules
A set of one or more definitions of aColumnLevelPermissionRule. -
setColumnLevelPermissionRules
A set of one or more definitions of aColumnLevelPermissionRule. -
getDataSetId
An ID for the dataset that you want to create. -
setDataSetId
An ID for the dataset that you want to create. -
getDatasetParameters
The parameters that are declared in a dataset. -
setDatasetParameters
The parameters that are declared in a dataset. -
setDatasetParameters
The parameters that are declared in a dataset. -
getDataSetRefreshProperties
The refresh properties of a dataset. -
setDataSetRefreshProperties
The refresh properties of a dataset. -
setDataSetRefreshProperties
@Stability(Stable) public void setDataSetRefreshProperties(@Nullable CfnDataSet.DataSetRefreshPropertiesProperty value) The refresh properties of a dataset. -
getDataSetUsageConfiguration
The usage configuration to apply to child datasets that reference this dataset as a source. -
setDataSetUsageConfiguration
The usage configuration to apply to child datasets that reference this dataset as a source. -
setDataSetUsageConfiguration
@Stability(Stable) public void setDataSetUsageConfiguration(@Nullable CfnDataSet.DataSetUsageConfigurationProperty value) The usage configuration to apply to child datasets that reference this dataset as a source. -
getFieldFolders
The folder that contains fields and nested subfolders for your dataset. -
setFieldFolders
The folder that contains fields and nested subfolders for your dataset. -
setFieldFolders
The folder that contains fields and nested subfolders for your dataset. -
getFolderArns
When you create the dataset, Amazon QuickSight adds the dataset to these folders.
. -
setFolderArns
When you create the dataset, Amazon QuickSight adds the dataset to these folders.
. -
getImportMode
Indicates whether you want to import the data into SPICE. -
setImportMode
Indicates whether you want to import the data into SPICE. -
getIngestionWaitPolicy
The wait policy to use when creating or updating a Dataset. -
setIngestionWaitPolicy
The wait policy to use when creating or updating a Dataset. -
setIngestionWaitPolicy
@Stability(Stable) public void setIngestionWaitPolicy(@Nullable CfnDataSet.IngestionWaitPolicyProperty value) The wait policy to use when creating or updating a Dataset. -
getLogicalTableMap
Configures the combination and transformation of the data from the physical tables. -
setLogicalTableMap
Configures the combination and transformation of the data from the physical tables. -
setLogicalTableMap
Configures the combination and transformation of the data from the physical tables. -
getName
The display name for the dataset. -
setName
The display name for the dataset. -
getPerformanceConfiguration
The performance optimization configuration of a dataset. -
setPerformanceConfiguration
The performance optimization configuration of a dataset. -
setPerformanceConfiguration
@Stability(Stable) public void setPerformanceConfiguration(@Nullable CfnDataSet.PerformanceConfigurationProperty value) The performance optimization configuration of a dataset. -
getPermissions
A list of resource permissions on the dataset. -
setPermissions
A list of resource permissions on the dataset. -
setPermissions
A list of resource permissions on the dataset. -
getPhysicalTableMap
Declares the physical tables that are available in the underlying data sources. -
setPhysicalTableMap
Declares the physical tables that are available in the underlying data sources. -
setPhysicalTableMap
Declares the physical tables that are available in the underlying data sources. -
getRowLevelPermissionDataSet
The row-level security configuration for the data that you want to create. -
setRowLevelPermissionDataSet
The row-level security configuration for the data that you want to create. -
setRowLevelPermissionDataSet
@Stability(Stable) public void setRowLevelPermissionDataSet(@Nullable CfnDataSet.RowLevelPermissionDataSetProperty value) The row-level security configuration for the data that you want to create. -
getRowLevelPermissionTagConfiguration
The element you can use to define tags for row-level security. -
setRowLevelPermissionTagConfiguration
The element you can use to define tags for row-level security. -
setRowLevelPermissionTagConfiguration
@Stability(Stable) public void setRowLevelPermissionTagConfiguration(@Nullable CfnDataSet.RowLevelPermissionTagConfigurationProperty value) The element you can use to define tags for row-level security. -
getTagsRaw
Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset. -
setTagsRaw
Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset. -
getUseAs
The usage of the dataset. -
setUseAs
The usage of the dataset.
-