Compartilhar via

az managedcleanroom frontend analytics dataset

Observação

Essa referência faz parte da extensão managedcleanroom para o CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de conjunto de dados de análise de front-end do az managedcleanroom . Saiba mais sobre extensões.

Gerenciar conjuntos de dados de colaboração.

Comandos

Nome Description Tipo Status
az managedcleanroom frontend analytics dataset list

Listar conjuntos de dados para uma colaboração.

 Extension GA
az managedcleanroom frontend analytics dataset publish

Publique um conjunto de dados na colaboração.

 Extension GA
az managedcleanroom frontend analytics dataset queries

Listar consultas que usam um conjunto de dados específico.

 Extension GA
az managedcleanroom frontend analytics dataset show

Mostrar detalhes do conjunto de dados.

 Extension GA

az managedcleanroom frontend analytics dataset list

Listar conjuntos de dados para uma colaboração.

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

Exemplos

Listar conjuntos de dados

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

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics dataset publish

Publique um conjunto de dados na colaboração.

Publique uma configuração de conjunto de dados com armazenamento, esquema, política de acesso e informações de identidade. Dá suporte aos modos de criptografia SSE (Server-Side Encryption) e CPK (Customer-Provided Key). Você pode usar parâmetros individuais ou um arquivo de corpo JSON para configuração.

az managedcleanroom frontend analytics dataset publish --collaboration-id
                                                       --document-id
                                                       [--access-mode]
                                                       [--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-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]

Exemplos

Publicar um conjunto de dados usando a criptografia SSE com parâmetros individuais

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

Publicar um conjunto de dados usando a criptografia CPK com parâmetros individuais

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

Publicar um conjunto de dados usando um arquivo de corpo JSON (modo herdado)

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

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento do conjunto de dados.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--access-mode

Modo de acesso (por exemplo, ReadWrite).

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--allowed-fields

Lista separada por vírgulas de nomes de campo permitidos.

--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
--body

Caminho do arquivo de configuração JSON (@file.json) ou cadeia de caracteres JSON (modo herdado).

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--container-name

Nome do contêiner de blob.

--dek-keyvault-url

Key Vault URL para DEK (somente modo CPK).

--dek-secret-id

ID do segredo de DEK (somente modo CPK).

--encryption-mode

Modo de criptografia (SSE ou CPK).

--identity-client-id

GUID (ID do cliente de identidade gerenciada).

--identity-issuer-url

URL do emissor OIDC (HTTPS).

--identity-name

Nome da identidade gerenciada.

--identity-tenant-id

ID do locatário (GUID).

--kek-keyvault-url

Key Vault URL para KEK (somente modo CPK).

--kek-maa-url

URL MAA para KEK (somente modo CPK).

--kek-secret-id

ID do segredo KEK (somente modo CPK).

--schema-file

Caminho para o arquivo de esquema (@path/para/schema.json) que contém definições de campo.

--schema-format

Formato de esquema (o padrão é Delta).

--storage-account-type

Tipo de conta de armazenamento (por exemplo, AzureStorageAccount).

--storage-account-url

Armazenamento do Azure URL da conta.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics dataset queries

Listar consultas que usam um conjunto de dados específico.

Recupera uma lista de todas as consultas que fazem referência ao conjunto de dados especificado como uma entrada. Isso é útil para entender as dependências do conjunto de dados e a análise de impacto.

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

Exemplos

Listar consultas usando um conjunto de dados

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

Listar consultas usando um conjunto de dados (forma curta)

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

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento (conjunto de dados, consulta ou documento de consentimento).

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az managedcleanroom frontend analytics dataset show

Mostrar detalhes do conjunto de dados.

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

Exemplos

Mostrar detalhes do conjunto de dados

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

Parâmetros Exigidos

--collaboration-id -c

Identificador de colaboração.

--document-id -d

Identificador de documento (conjunto de dados, consulta ou documento de consentimento).

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--api-version

Versão da API a ser usada para essa solicitação. Padrão: 2026-03-01-preview.

Propriedade Valor
Valor padrão: 2026-03-01-preview
Valores aceitos: 2026-03-01-preview
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False