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. Use either individual parameters or a JSON body (--body); the two cannot be combined. The dataset identity's OIDC issuer is configured through governance (az managedcleanroom frontend oidc set-issuer-url), not on the dataset.

az managedcleanroom frontend analytics dataset publish --collaboration-id
                                                       --document-id
                                                       [--access-mode {read, write}]
                                                       [--acquire-policy-token]
                                                       [--allowed-fields]
                                                       [--api-version {2026-03-01-preview}]
                                                       [--body]
                                                       [--change-reference]
                                                       [--container-name]
                                                       [--dek-keyvault-url]
                                                       [--dek-secret-id]
                                                       [--encryption-mode]
                                                       [--identity-client-id]
                                                       [--identity-name]
                                                       [--identity-tenant-id]
                                                       [--kek-authority-endpoint]
                                                       [--kek-authority-type {CGS, MAA}]
                                                       [--kek-keyvault-url]
                                                       [--kek-secret-id]
                                                       [--schema-file]
                                                       [--schema-format]
                                                       [--storage-account-type]
                                                       [--storage-account-url]
                                                       [--subdirectory]

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 Azure_BlobStorage               --encryption-mode SSE               --schema-file @schema.json               --access-mode read               --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

Publish a dataset using CPK encryption with CGS as the KEK authority

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 Azure_BlobStorage               --encryption-mode CPK               --schema-file @schema.json               --access-mode read               --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               --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-authority-type CGS

Publish a dataset using CPK encryption with MAA as the KEK authority

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 Azure_BlobStorage               --encryption-mode CPK               --schema-file @schema.json               --access-mode read               --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               --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-authority-type MAA               --kek-authority-endpoint 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

Publish a dataset mounted at a subdirectory

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 Azure_BlobStorage               --encryption-mode SSE               --schema-file @schema.json               --access-mode read               --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               --subdirectory year=2026/month=05

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 (read or write).

Property Value
Accepted values: read, write
--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--allowed-fields

Comma-separated list of allowed field names (required).

--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).

--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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-name

Managed identity name.

--identity-tenant-id

Tenant ID (GUID).

--kek-authority-endpoint

Attestation authority endpoint for the KEK. Required for MAA, not allowed for CGS (CPK mode only).

--kek-authority-type

Attestation authority for KEK secure key release, CGS or MAA (CPK mode only).

Property Value
Accepted values: CGS, MAA
--kek-keyvault-url

Key Vault 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 (csv, json, or parquet). Overrides the format in the schema file.

--storage-account-type

Storage account type (Azure_BlobStorage, Azure_BlobStorage_DataLakeGen2, Azure_OneLake, or Aws_S3).

--storage-account-url

Azure Storage account URL.

--subdirectory

Optional subdirectory/prefix inside the storage container to mount.

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
                                                       [--acquire-policy-token]
                                                       [--api-version {2026-03-01-preview}]
                                                       [--change-reference]

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.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--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
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
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