AWS cli: Clean Rooms: add Databricks (Delta Sharing) table reference option
Summary
Adds the `databricks` tagged-union member to the configured-table table reference, documenting schemaName, tableName, workspaceUrl, and a deltaSharing connectionType with deltaShareEndpoint and shareName, including length and regex constraints, plus the new DATABRICKS tableType value and JSON syntax example. Version footer bumped to 2.38.3.
Security assessment
This is a feature/API-surface addition for a new Databricks data source. The regex constraints on workspaceUrl and deltaShareEndpoint do restrict values to https://*.cloud.databricks.com endpoints, which is an incidental input-validation/allowlist property, but the diff shows no reference to a specific vulnerability, incident, or CVE, so it is not a security fix.
Evidence
>>> pattern: `https://[a-zA-Z0-9.-]+\.cloud\.databricks\.com/?`
Diff
diff --git a/cli/latest/reference/cleanrooms/update-configured-table.md b/cli/latest/reference/cleanrooms/update-configured-table.md index 451a091..5e82172 100644 --- a//cli/latest/reference/cleanrooms/update-configured-table.md +++ b//cli/latest/reference/cleanrooms/update-configured-table.md @@ -15 +15 @@ - * [AWS CLI 2.38.2 Command Reference](../../index.html) » + * [AWS CLI 2.38.3 Command Reference](../../index.html) » @@ -141 +141 @@ 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`. @@ -428,0 +429,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}]+` +>>>>> + @@ -461,0 +538,11 @@ JSON Syntax: + }, + "databricks": { + "schemaName": "string", + "tableName": "string", + "workspaceUrl": "string", + "connectionType": { + "deltaSharing": { + "deltaShareEndpoint": "string", + "shareName": "string" + } + } @@ -700 +787 @@ 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`. @@ -987,0 +1075,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` +>> + @@ -1072 +1248 @@ configuredTable -> (structure) - * [AWS CLI 2.38.2 Command Reference](../../index.html) » + * [AWS CLI 2.38.3 Command Reference](../../index.html) »