Del via

az managedcleanroom frontend analytics dataset

Note

This reference is part of the managedcleanroom extension for the Azure CLI (version 2.75.0 or higher). The extension will automatically install the first time you run an az managedcleanroom frontend analytics dataset command. Learn more about extensions.

Manage collaboration datasets.

Commands

Name Description Type Status
az managedcleanroom frontend analytics dataset list

List datasets for a collaboration.

 Extension GA
az managedcleanroom frontend analytics dataset publish

Publish a dataset to the collaboration.

 Extension GA
az managedcleanroom frontend analytics dataset queries

List queries that use a specific dataset.

 Extension GA
az managedcleanroom frontend analytics dataset show

Show dataset details.

 Extension GA

az managedcleanroom frontend analytics dataset list

List datasets for a collaboration.

az managedcleanroom frontend analytics dataset list --collaboration-id
                                                    [--api-version {2026-03-01-preview}]

Examples

List datasets

az managedcleanroom frontend analytics dataset list -c <collaboration-id>

Required Parameters

--collaboration-id -c

Collaboration identifier.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

API version to use for this request. Default: 2026-03-01-preview.

Property Value
Default value: 2026-03-01-preview
Accepted values: 2026-03-01-preview
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az managedcleanroom frontend analytics dataset publish

Publish a dataset to the collaboration.

Publish a dataset configuration with storage, schema, access policy, and identity information. Supports both SSE (Server-Side Encryption) and CPK (Customer-Provided Key) encryption modes. You can use either individual parameters or a JSON body file for configuration.

az managedcleanroom frontend analytics dataset publish --collaboration-id
                                                       --document-id
                                                       [--access-mode]
                                                       [--allowed-fields]
                                                       [--api-version {2026-03-01-preview}]
                                                       [--body]
                                                       [--container-name]
                                                       [--dek-keyvault-url]
                                                       [--dek-secret-id]
                                                       [--encryption-mode]
                                                       [--identity-client-id]
                                                       [--identity-issuer-url]
                                                       [--identity-name]
                                                       [--identity-tenant-id]
                                                       [--kek-keyvault-url]
                                                       [--kek-maa-url]
                                                       [--kek-secret-id]
                                                       [--schema-file]
                                                       [--schema-format]
                                                       [--storage-account-type]
                                                       [--storage-account-url]

Examples

Publish a dataset using SSE encryption with individual parameters

az managedcleanroom frontend analytics dataset publish               --collaboration-id my-collab-123               --document-id my-dataset               --storage-account-url https://mystorageaccount.blob.core.windows.net               --container-name datasets               --storage-account-type AzureStorageAccount               --encryption-mode SSE               --schema-file @schema.json               --access-mode ReadWrite               --allowed-fields "customer_id,revenue,date"               --identity-name northwind-identity               --identity-client-id fb907136-1234-5678-9abc-def012345678               --identity-tenant-id 72f988bf-1234-5678-9abc-def012345678               --identity-issuer-url https://oidc.example.com/issuer

Publish a dataset using CPK encryption with individual parameters

az managedcleanroom frontend analytics dataset publish               --collaboration-id my-collab-123               --document-id my-dataset               --storage-account-url https://mystorageaccount.blob.core.windows.net               --container-name datasets               --storage-account-type AzureStorageAccount               --encryption-mode CPK               --schema-file @schema.json               --access-mode ReadWrite               --identity-name northwind-identity               --identity-client-id fb907136-1234-5678-9abc-def012345678               --identity-tenant-id 72f988bf-1234-5678-9abc-def012345678               --identity-issuer-url https://oidc.example.com/issuer               --dek-keyvault-url https://mykeyvault.vault.azure.net               --dek-secret-id dek-secret-123               --kek-keyvault-url https://mykeyvault.vault.azure.net               --kek-secret-id kek-secret-123               --kek-maa-url https://sharedeus.eus.attest.azure.net

Publish a dataset using a JSON body file (legacy mode)

az managedcleanroom frontend analytics dataset publish               --collaboration-id my-collab-123               --document-id my-dataset               --body @dataset-config.json

Required Parameters

--collaboration-id -c

Collaboration identifier.

--document-id -d

Dataset document identifier.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--access-mode

Access mode (e.g., ReadWrite).

--allowed-fields

Comma-separated list of allowed field names.

--api-version

API version to use for this request. Default: 2026-03-01-preview.

Property Value
Default value: 2026-03-01-preview
Accepted values: 2026-03-01-preview
--body

JSON configuration file path (@file.json) or JSON string (legacy mode).

--container-name

Blob container name.

--dek-keyvault-url

Key Vault URL for DEK (CPK mode only).

--dek-secret-id

DEK secret ID (CPK mode only).

--encryption-mode

Encryption mode (SSE or CPK).

--identity-client-id

Managed identity client ID (GUID).

--identity-issuer-url

OIDC issuer URL (HTTPS).

--identity-name

Managed identity name.

--identity-tenant-id

Tenant ID (GUID).

--kek-keyvault-url

Key Vault URL for KEK (CPK mode only).

--kek-maa-url

MAA URL for KEK (CPK mode only).

--kek-secret-id

KEK secret ID (CPK mode only).

--schema-file

Path to schema file (@path/to/schema.json) containing field definitions.

--schema-format

Schema format (default is Delta).

--storage-account-type

Storage account type (e.g., AzureStorageAccount).

--storage-account-url

Azure Storage account URL.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az managedcleanroom frontend analytics dataset queries

List queries that use a specific dataset.

Retrieves a list of all queries that reference the specified dataset as an input. This is useful for understanding dataset dependencies and impact analysis.

az managedcleanroom frontend analytics dataset queries --collaboration-id
                                                       --document-id
                                                       [--api-version {2026-03-01-preview}]

Examples

List queries using a dataset

az managedcleanroom frontend analytics dataset queries               --collaboration-id <cid>               --document-id <dataset-document-id>

List queries using a dataset (short form)

az managedcleanroom frontend analytics dataset queries -c <cid> -d <dataset-doc-id>

Required Parameters

--collaboration-id -c

Collaboration identifier.

--document-id -d

Document identifier (dataset, query, or consent document).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

API version to use for this request. Default: 2026-03-01-preview.

Property Value
Default value: 2026-03-01-preview
Accepted values: 2026-03-01-preview
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az managedcleanroom frontend analytics dataset show

Show dataset details.

az managedcleanroom frontend analytics dataset show --collaboration-id
                                                    --document-id
                                                    [--api-version {2026-03-01-preview}]

Examples

Show dataset details

az managedcleanroom frontend analytics dataset show -c <cid> -d <document-id>

Required Parameters

--collaboration-id -c

Collaboration identifier.

--document-id -d

Document identifier (dataset, query, or consent document).

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

API version to use for this request. Default: 2026-03-01-preview.

Property Value
Default value: 2026-03-01-preview
Accepted values: 2026-03-01-preview
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False