AWS cli documentation change

Service: cli · 2026-05-19 · Documentation low

File: cli/latest/reference/quicksight/describe-data-set.md

Summary

Added documentation for new SemanticMetadata structure including column-level and dataset-level semantic metadata, descriptions, custom instructions, and constraints

Security assessment

The changes document new semantic metadata features for data preparation and consumption guidance. There is no evidence of security vulnerability fixes, security incident response, or explicit security controls. The additions focus on data categorization and usage instructions without security implications.

Diff

diff --git a/cli/latest/reference/quicksight/describe-data-set.md b/cli/latest/reference/quicksight/describe-data-set.md
index b24e915c0..47106e88d 100644
--- a//cli/latest/reference/quicksight/describe-data-set.md
+++ b//cli/latest/reference/quicksight/describe-data-set.md
@@ -15 +15 @@
-  * [AWS CLI 2.34.48 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.49 Command Reference](../../index.html) »
@@ -4416,0 +4417,179 @@ DataSet -> (structure)
+>>>> 
+>>>> SemanticMetadata -> (structure)
+>>>>
+>>>>> The column-level semantic metadata for this semantic table.
+>>>>> 
+>>>>> ColumnMetadata -> (list)
+>>>>>
+>>>>>> A list of column semantic metadata entries.
+>>>>>> 
+>>>>>> Constraints:
+>>>>>> 
+>>>>>>   * min: `1`
+>>>>>>   * max: `2000`
+>>>>>> 
+
+>>>>>> 
+>>>>>> (structure)
+>>>>>>
+>>>>>>> Semantic metadata shared across one or more columns.
+>>>>>>> 
+>>>>>>> ColumnNames -> (list)
+>>>>>>>
+>>>>>>>> The names of the columns this metadata applies to.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>>   * max: `2000`
+>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> (string)
+>>>>>>>>
+>>>>>>>>> Constraints:
+>>>>>>>>> 
+>>>>>>>>>   * min: `1`
+>>>>>>>>>   * max: `128`
+>>>>>>>>> 
+
+>>>>>>> 
+>>>>>>> ColumnProperties -> (list) [required]
+>>>>>>>
+>>>>>>>> The semantic properties for the specified columns.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>>   * max: `3`
+>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> (structure)
+>>>>>>>>
+>>>>>>>>> A semantic property for a column.
+>>>>>>>>> 
+>>>>>>>>> Description -> (structure)
+>>>>>>>>>
+>>>>>>>>>> A description of the column.
+>>>>>>>>>> 
+>>>>>>>>>> Text -> (string)
+>>>>>>>>>>
+>>>>>>>>>>> The text of a description for a column.
+>>>>>>>>>>> 
+>>>>>>>>>>> Constraints:
+>>>>>>>>>>> 
+>>>>>>>>>>>   * min: `0`
+>>>>>>>>>>>   * max: `500`
+>>>>>>>>>>> 
+
+>>>>>>>>> 
+>>>>>>>>> AdditionalNotes -> (structure)
+>>>>>>>>>
+>>>>>>>>>> Additional notes for the column.
+>>>>>>>>>> 
+>>>>>>>>>> Text -> (string)
+>>>>>>>>>>
+>>>>>>>>>>> The additional notes text.
+>>>>>>>>>>> 
+>>>>>>>>>>> Constraints:
+>>>>>>>>>>> 
+>>>>>>>>>>>   * min: `0`
+>>>>>>>>>>>   * max: `2000`
+>>>>>>>>>>> 
+
+>>>>>>>>> 
+>>>>>>>>> SemanticType -> (structure)
+>>>>>>>>>
+>>>>>>>>>> The semantic type of the column.
+>>>>>>>>>> 
+>>>>>>>>>> GeographicalRole -> (string)
+>>>>>>>>>>
+>>>>>>>>>>> The geographical role of the column in the new data preparation experience.
+>>>>>>>>>>> 
+>>>>>>>>>>> Possible values:
+>>>>>>>>>>> 
+>>>>>>>>>>>   * `COUNTRY`
+>>>>>>>>>>>   * `STATE`
+>>>>>>>>>>>   * `COUNTY`
+>>>>>>>>>>>   * `CITY`
+>>>>>>>>>>>   * `POSTCODE`
+>>>>>>>>>>>   * `LONGITUDE`
+>>>>>>>>>>>   * `LATITUDE`
+>>>>>>>>>>> 
+
+>> 
+>> SemanticMetadata -> (list)
+>>
+>>> The dataset-level semantic metadata, including a description and custom instructions.
+>>> 
+>>> Constraints:
+>>> 
+>>>   * min: `1`
+>>>   * max: `1`
+>>> 
+
+>>> 
+>>> (structure)
+>>>
+>>>> Semantic metadata for a dataset, including a description and custom instructions.
+>>>> 
+>>>> Description -> (structure)
+>>>>
+>>>>> A description of the dataset.
+>>>>> 
+>>>>> Text -> (string) [required]
+>>>>>
+>>>>>> The descriptive text for the dataset.
+>>>>>> 
+>>>>>> Constraints:
+>>>>>> 
+>>>>>>   * min: `1`
+>>>>>>   * max: `500`
+>>>>>> 
+
+>>>> 
+>>>> CustomInstructions -> (list)
+>>>>
+>>>>> A list of custom instructions that guide how the dataset should be consumed.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `2`
+>>>>> 
+
+>>>>> 
+>>>>> (structure)
+>>>>>
+>>>>>> A custom instruction that provides guidance on how the dataset should be consumed.
+>>>>>> 
+>>>>>> InlineCustomInstruction -> (structure)
+>>>>>>
+>>>>>>> An inline custom instruction containing text and optional uploaded document metadata.
+>>>>>>> 
+>>>>>>> InstructionText -> (string) [required]
+>>>>>>>
+>>>>>>>> The instruction text content.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `0`
+>>>>>>>>   * max: `50000`
+>>>>>>>> 
+
+>>>>>>> 
+>>>>>>> UploadedDocumentMetadata -> (structure)
+>>>>>>>
+>>>>>>>> Metadata about an uploaded document associated with this instruction.
+>>>>>>>> 
+>>>>>>>> Name -> (string)
+>>>>>>>>
+>>>>>>>>> The name of the uploaded document.
+>>>>>>>>> 
+>>>>>>>>> Constraints:
+>>>>>>>>> 
+>>>>>>>>>   * min: `1`
+>>>>>>>>>   * max: `127`
+>>>>>>>>> 
+
@@ -4436 +4615 @@ Status -> (integer)
-  * [AWS CLI 2.34.48 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.49 Command Reference](../../index.html) »