AWS cli documentation change

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

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

Summary

Added documentation for SemanticMetadata structure including column-level metadata (ColumnMetadata) and dataset-level metadata (Description and CustomInstructions)

Security assessment

The changes introduce new semantic metadata features for data preparation and consumption guidance. No security vulnerabilities, encryption, access control, or compliance aspects are mentioned. The changes focus on data organization and descriptive properties.

Diff

diff --git a/cli/latest/reference/quicksight/update-data-set.md b/cli/latest/reference/quicksight/update-data-set.md
index 70ffd9821..1720bb058 100644
--- a//cli/latest/reference/quicksight/update-data-set.md
+++ b//cli/latest/reference/quicksight/update-data-set.md
@@ -15 +15 @@
-  * [AWS CLI 2.34.48 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.49 Command Reference](../../index.html) »
@@ -4984,0 +4985,179 @@ JSON Syntax:
+>>> 
+>>> 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`
+>>>>>>>> 
+
@@ -5016,0 +5196,15 @@ JSON Syntax:
+            },
+            "SemanticMetadata": {
+              "ColumnMetadata": [
+                {
+                  "ColumnNames": ["string", ...],
+                  "ColumnProperties": [
+                    {
+                      "Description": {
+                        "Text": "string"
+                      },
+                      "AdditionalNotes": {
+                        "Text": "string"