AWS cli: Add Databricks Delta Sharing to Clean Rooms configured table CLI
Summary
Documents a new Databricks table reference option for create-configured-table, including schema/table names, workspace URL, Delta Sharing endpoint, and share name constraints.
Security assessment
The change is a CLI reference update adding a new Databricks/Delta Sharing data source option and its input validation patterns. It does not describe a vulnerability, incident, or security best practice.
Evidence
+> This is a Tagged Union structure. Only one of the following top level keys can be set: `glue`, `snowflake`, `athena`, `databricks`.
Diff
diff --git a/cli/latest/reference/cleanrooms/create-configured-table.md b/cli/latest/reference/cleanrooms/create-configured-table.md index 3d032cb..5d1f418 100644 --- a//cli/latest/reference/cleanrooms/create-configured-table.md +++ b//cli/latest/reference/cleanrooms/create-configured-table.md @@ -15 +15 @@ - * [AWS CLI 2.38.2 Command Reference](../../index.html) » + * [AWS CLI 2.38.3 Command Reference](../../index.html) » @@ -129 +129 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/cleanr -> This is a Tagged Union structure. Only one of the following top level keys can be set: `glue`, `snowflake`, `athena`. +> This is a Tagged Union structure. Only one of the following top level keys can be set: `glue`, `snowflake`, `athena`, `databricks`. @@ -416,0 +417,76 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/cleanr +> +> databricks -> (structure) +> +>> If present, a reference to the Databricks table referred to by this table reference. +>> +>> schemaName -> (string) [required] +>> +>>> Name of the Schema within Databricks. +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `255` +>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>> + +>> +>> tableName -> (string) [required] +>> +>>> Name of the Table within Databricks. +>>> +>>> Constraints: +>>> +>>> * min: `1` +>>> * max: `255` +>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>> + +>> +>> workspaceUrl -> (string) [required] +>> +>>> URL for the Databricks Workspace. +>>> +>>> Constraints: +>>> +>>> * min: `10` +>>> * max: `256` +>>> * pattern: `https://[a-zA-Z0-9.-]+\.cloud\.databricks\.com/?` +>>> + +>> +>> connectionType -> (tagged union structure) [required] +>> +>>> Type of the connector to be used for connecting to Databricks. Supported connector: Delta Sharing +>>> +>>> ### Note +>>> +>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `deltaSharing`. +>>> +>>> deltaSharing -> (structure) +>>> +>>>> Details about Connector for Databricks +>>>> +>>>> deltaShareEndpoint -> (string) [required] +>>>> +>>>>> The base URL of a Delta Sharing server that hosts shared datasets. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `10` +>>>>> * max: `1024` +>>>>> * pattern: `https://(?:[a-zA-Z0-9.-]+\.cloud\.databricks\.com/api/2\.0/delta-sharing|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.opensharing\.[a-z0-9-]+\.cloud\.databricks\.com/api/2\.0/opensharing)/metastores/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/recipients/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` +>>>>> + +>>>> +>>>> shareName -> (string) [required] +>>>> +>>>>> Name of the Share used for OpenSharing (Delta Sharing) the Databricks Table. +>>>>> +>>>>> Constraints: +>>>>> +>>>>> * min: `1` +>>>>> * max: `255` +>>>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>>>> + @@ -449,0 +526,11 @@ JSON Syntax: + }, + "databricks": { + "schemaName": "string", + "tableName": "string", + "workspaceUrl": "string", + "connectionType": { + "deltaSharing": { + "deltaShareEndpoint": "string", + "shareName": "string" + } + } @@ -730 +817 @@ configuredTable -> (structure) ->> This is a Tagged Union structure. Only one of the following top level keys can be set: `glue`, `snowflake`, `athena`. +>> This is a Tagged Union structure. Only one of the following top level keys can be set: `glue`, `snowflake`, `athena`, `databricks`. @@ -1017,0 +1105,89 @@ configuredTable -> (structure) +>> +>> databricks -> (structure) +>> +>>> If present, a reference to the Databricks table referred to by this table reference. +>>> +>>> schemaName -> (string) [required] +>>> +>>>> Name of the Schema within Databricks. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `255` +>>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>>> + +>>> +>>> tableName -> (string) [required] +>>> +>>>> Name of the Table within Databricks. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `255` +>>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>>> + +>>> +>>> workspaceUrl -> (string) [required] +>>> +>>>> URL for the Databricks Workspace. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `10` +>>>> * max: `256` +>>>> * pattern: `https://[a-zA-Z0-9.-]+\.cloud\.databricks\.com/?` +>>>> + +>>> +>>> connectionType -> (tagged union structure) [required] +>>> +>>>> Type of the connector to be used for connecting to Databricks. Supported connector: Delta Sharing +>>>> +>>>> ### Note +>>>> +>>>> This is a Tagged Union structure. Only one of the following top level keys can be set: `deltaSharing`. +>>>> +>>>> deltaSharing -> (structure) +>>>> +>>>>> Details about Connector for Databricks +>>>>> +>>>>> deltaShareEndpoint -> (string) [required] +>>>>> +>>>>>> The base URL of a Delta Sharing server that hosts shared datasets. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `10` +>>>>>> * max: `1024` +>>>>>> * pattern: `https://(?:[a-zA-Z0-9.-]+\.cloud\.databricks\.com/api/2\.0/delta-sharing|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.opensharing\.[a-z0-9-]+\.cloud\.databricks\.com/api/2\.0/opensharing)/metastores/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/recipients/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` +>>>>>> + +>>>>> +>>>>> shareName -> (string) [required] +>>>>> +>>>>>> Name of the Share used for OpenSharing (Delta Sharing) the Databricks Table. +>>>>>> +>>>>>> Constraints: +>>>>>> +>>>>>> * min: `1` +>>>>>> * max: `255` +>>>>>> * pattern: `[\p{L}\p{M}\p{N}\p{Pc}\p{Pd}]+` +>>>>>> + +> +> tableType -> (string) +> +>> Type of the Configured Table DataSource, example: Glue, Snowflake, Athena, Databricks +>> +>> Possible values: +>> +>> * `GLUE` +>> * `SNOWFLAKE` +>> * `ATHENA` +>> * `DATABRICKS` +>> + @@ -1102 +1278 @@ configuredTable -> (structure) - * [AWS CLI 2.38.2 Command Reference](../../index.html) » + * [AWS CLI 2.38.3 Command Reference](../../index.html) »