---
title: "GET /accounts/{AwsAccountId}/data-sets/{DataSetId}"
method: GET
path: "/accounts/{AwsAccountId}/data-sets/{DataSetId}"
---

# GET /accounts/{AwsAccountId}/data-sets/{DataSetId}

`GET /accounts/{AwsAccountId}/data-sets/{DataSetId}`

Describes a dataset. This operation doesn't support datasets that include uploaded files as a source.

## Path parameters

- `AwsAccountId` string, required
- `DataSetId` string, required

## Response `200`

Success

- DescribeDataSetResponse
  - `DataSet` object — Information on the dataset.
    - `Arn` string — The Amazon Resource Name (ARN) of the resource.
    - `DataSetId` string — The ID of the dataset.
    - `Name` string — A display name for the dataset.
    - `CreatedTime` string, date-time — The time that this dataset was created.
    - `LastUpdatedTime` string, date-time — The last time that this dataset was updated.
    - `PhysicalTableMap` object — Declares the physical tables that are available in the underlying data sources.
    - `LogicalTableMap` object — Configures the combination and transformation of the data from the physical tables.
    - `OutputColumns` OutputColumn[] — The list of columns after all transforms. These columns are available in templates, analyses, and dashboards.
      - `Name` string — A display name for the dataset.
      - `Description` string — A description for a column.
      - `Type` 'STRING' | 'INTEGER' | 'DECIMAL' | 'DATETIME' — Type.
    - `ImportMode` 'SPICE' | 'DIRECT_QUERY' — A value that indicates whether you want to import the data into SPICE.
    - `ConsumedSpiceCapacityInBytes` integer — The amount of SPICE capacity used by this dataset. This is 0 if the dataset isn't imported into SPICE.
    - `ColumnGroups` ColumnGroup[] — Groupings of columns that work together in certain Amazon QuickSight features. Currently, only geospatial hierarchy is supported.
      - `GeoSpatialColumnGroup` object — Geospatial column group that denotes a hierarchy.
        - `Name` string, required — A display name for the hierarchy.
        - `CountryCode` 'US' — Country code.
        - `Columns` ColumnName[], required — Columns in this hierarchy.
    - `FieldFolders` object — The folder that contains fields and nested subfolders for your dataset.
    - `RowLevelPermissionDataSet` object — The row-level security configuration for the dataset.
      - `Namespace` string — The namespace associated with the dataset that contains permissions for RLS.
      - `Arn` string, required — The Amazon Resource Name (ARN) of the dataset that contains permissions for RLS.
      - `PermissionPolicy` 'GRANT_ACCESS' | 'DENY_ACCESS', required — The type of permissions to use when interpreting the permissions for RLS. <code>DENY_ACCESS</code> is included for backward compatibility only.
      - `FormatVersion` 'VERSION_1' | 'VERSION_2' — <p>The user or group rules associated with the dataset that contains permissions for RLS.</p> <p>By default, <code>FormatVersion</code> is <code>VERSION_1</code>. When <code>FormatVersion</code> is <code>VERSION_1</code>, <code>UserName</code> and <code>GroupName</code> are required. When <code>FormatVersion</code> is <code>VERSION_2</code>, <code>UserARN</code> and <code>GroupARN</code> are required, and <code>Namespace</code> must not exist.</p>
      - `Status` 'ENABLED' | 'DISABLED' — The status of the row-level security permission dataset. If enabled, the status is <code>ENABLED</code>. If disabled, the status is <code>DISABLED</code>.
    - `RowLevelPermissionTagConfiguration` object — The element you can use to define tags for row-level security.
      - `Status` 'ENABLED' | 'DISABLED' — The status of row-level security tags. If enabled, the status is <code>ENABLED</code>. If disabled, the status is <code>DISABLED</code>.
      - `TagRules` RowLevelPermissionTagRule[], required — A set of rules associated with row-level security, such as the tag names and columns that they are assigned to.
        - `TagKey` string, required — The unique key for a tag.
        - `ColumnName` string, required — The column name that a tag key is assigned to.
        - `TagMultiValueDelimiter` string — A string that you want to use to delimit the values when you pass the values at run time. For example, you can delimit the values with a comma.
        - `MatchAllValue` string, password — A string that you want to use to filter by all the values in a column in the dataset and don’t want to list the values one by one. For example, you can use an asterisk as your match all value.
      - `TagRuleConfigurations` RowLevelPermissionTagRuleConfiguration[] — A list of tag configuration rules to apply to a dataset. All tag configurations have the OR condition. Tags within each tile will be joined (AND). At least one rule in this structure must have all tag values assigned to it to apply Row-level security (RLS) to the dataset.
        - SessionTagKey[]
    - `ColumnLevelPermissionRules` ColumnLevelPermissionRule[] — 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>.
      - `Principals` String[] — An array of Amazon Resource Names (ARNs) for Amazon QuickSight users or groups.
      - `ColumnNames` String[] — An array of column names.
    - `DataSetUsageConfiguration` object — The usage configuration to apply to child datasets that reference this dataset as a source.
      - `DisableUseAsDirectQuerySource` boolean — An option that controls whether a child dataset of a direct query can use this dataset as a source.
      - `DisableUseAsImportedSource` boolean — An option that controls whether a child dataset that's stored in QuickSight can use this dataset as a source.
  - `RequestId` string — The Amazon Web Services request ID for this operation.
  - `Status` integer — The HTTP status of the request.

## Other responses

- `480` — AccessDeniedException
- `481` — InvalidParameterValueException
- `482` — ThrottlingException
- `483` — ResourceNotFoundException
- `484` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/quicksight.md) · [All operations](https://skmtc.net/aws/apis/quicksight/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/quicksight/versions/2f2bbd7e70ca/schema)