Compartilhar via


az ml data

Note

Essa referência faz parte da extensão ml da CLI do Azure (versão 2.15.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az ml data. Saiba mais sobre extensões.

Gerenciar ativos de dados do Azure ML.

Os ativos de dados do Azure ML são referências a arquivos em seus serviços de armazenamento ou URLs públicas, juntamente com quaisquer metadados correspondentes. Eles não são cópias de seus dados. Você pode usar esses ativos de dados para acessar dados relevantes durante o treinamento do modelo e montar ou baixar os dados referenciados para seu destino de computação.

Comandos

Nome Description Tipo Status
az ml data archive

Arquivar um ativo de dados.

Extension GA
az ml data create

Crie um ativo de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

Extension GA
az ml data import

Importe dados e crie um ativo de dados.

Extension Preview
az ml data list

Listar ativos de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

Extension GA
az ml data list-materialization-status

Mostrar o status da lista de trabalhos de materialização de importação de dados que criam versões de um ativo de dados.

Extension Preview
az ml data mount

Monte um ativo de dados específico em um caminho local. Por enquanto, apenas o Linux é suportado.

Extension Preview
az ml data restore

Restaure um ativo de dados arquivado.

Extension GA
az ml data share

Compartilhe um ativo de dados específico do workspace para o registro.

Extension Preview
az ml data show

Mostra detalhes de um ativo de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

Extension GA
az ml data update

Atualize um ativo de dados.

Extension GA

az ml data archive

Arquivar um ativo de dados.

O arquivamento de um ativo de dados o ocultará por padrão das consultas de lista (az ml data list). Você ainda pode continuar a fazer referência e usar um ativo de dados arquivado nos fluxos de trabalho. Você pode arquivar um contêiner de ativos de dados ou uma versão específica do ativo de dados. O arquivamento de um contêiner de ativos de dados arquivará todas as versões do ativo de dados com esse nome. Você pode restaurar um ativo de dados arquivado usando az ml data restoreo . Se todo o contêiner de ativos de dados estiver arquivado, você não poderá restaurar versões individuais do ativo de dados - será necessário restaurar o contêiner de ativos de dados.

az ml data archive --name
                   [--label]
                   [--resource-group]
                   [--version]
                   [--workspace-name]

Exemplos

Arquivar um contêiner de ativo de dados (arquiva todas as versões desse ativo de dados)

az ml data archive --name my-env --resource-group my-resource-group --workspace-name my-workspace

Arquivar uma versão específica do ativo de dados

az ml data archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--name -n

Nome do ativo 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.

--label -l

Rótulo do ativo de dados. Mutuamente exclusivo com a versão.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--version -v

Versão do ativo de dados. Mutuamente exclusivo com rótulo.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data create

Crie um ativo de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

Os ativos de dados podem ser definidos a partir de arquivos em seu computador local ou como referências a arquivos no armazenamento em nuvem. O ativo de dados criado será rastreado no workspace/registro com o nome e a versão especificados.

Para criar um ativo de dados a partir de arquivos em sua máquina local, especifique o campo 'caminho' em sua configuração YAML. O Azure ML carregará esses arquivos no contêiner de blob que dá suporte ao repositório de dados padrão do workspace (chamado 'workspaceblobstore'). O ativo de dados criado apontará para esses dados carregados.

Para criar um ativo de dados que faça referência a arquivos no armazenamento em nuvem, especifique o "caminho" para os arquivos no armazenamento na configuração YAML.

Você também pode criar um ativo de dados diretamente de uma URL de armazenamento ou URL pública. Para fazer isso, especifique a URL para o campo 'path' em sua configuração YAML. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <my-registry-name> opção.

az ml data create [--datastore]
                  [--description]
                  [--file]
                  [--name]
                  [--no-wait]
                  [--path]
                  [--registry-name]
                  [--resource-group]
                  [--set]
                  [--skip-validation]
                  [--type {mltable, uri_file, uri_folder}]
                  [--version]
                  [--workspace-name]

Exemplos

Criar um ativo de dados de um arquivo de especificação YAML em um workspace

az ml data create --file data.yml --resource-group my-resource-group --workspace-name my-workspace

Criar um ativo de dados de um arquivo de especificação YAML em um registro

az ml data create --file data.yml --registry-name my-registry-name

Criar um ativo de dados sem usar um arquivo de especificação YAML em um workspace

az ml data create --name my-data --version 1 --path ./my-data.csv --resource-group my-resource-group --workspace-name my-workspace

Criar um ativo de dados sem usar um arquivo de especificação YAML em um registro

az ml data create --name my-data --version 1 --path ./my-data.csv --registry-name my-registry-name

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.

--datastore

O armazenamento de dados para o qual carregar o artefato local.

--description -d

Descrição do ativo de dados.

--file -f

Caminho local para o arquivo YAML que contém a especificação de dados do Azure ML. Os documentos de referência yaml para dados podem ser encontrados em: https://aka.ms/ml-cli-v2-data-yaml-reference.

--name -n

Nome do ativo de dados. Obrigatório se --registry-name for fornecido.

--no-wait

Não aguarde a conclusão da operação de execução prolongada. O padrão é False.

Propriedade Valor
Valor padrão: False
--path -p

O caminho para o ativo de dados pode ser local ou remoto.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários. Deve ser fornecido se --workspace-name e --resource-group não forem fornecidos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=value.

--skip-validation

Ignorar a validação de metadados do MLTable quando o tipo for MLTable.

Propriedade Valor
Valor padrão: False
--type -t

Tipo do ativo de dados.

Propriedade Valor
Valores aceitos: mltable, uri_file, uri_folder
--version -v

Versão do ativo de dados. Obrigatório se --registry-name for fornecido.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data import

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Importe dados e crie um ativo de dados.

O ativo de dados pode ser criado primeiro importando dados do banco de dados ou sistema de arquivos para o armazenamento em nuvem. O ativo de dados criado será rastreado no workspace com o nome e a versão especificados.

Especifique 'query' da tabela do banco de dados ou 'path' nos campos do sistema de arquivos em sua configuração YAML. O Azure ML executará um trabalho para copiar os dados para o armazenamento em nuvem primeiro.

az ml data import --resource-group
                  --workspace-name
                  [--datastore]
                  [--description]
                  [--file]
                  [--name]
                  [--path]
                  [--set]
                  [--skip-validation]
                  [--type {mltable, uri_file, uri_folder}]
                  [--version]

Exemplos

Importar um ativo de dados de um arquivo de especificação YAML

az ml data import --file dataimport.yml --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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.

--datastore

O armazenamento de dados para o qual carregar o artefato local.

--description -d

Descrição do ativo de dados.

--file -f

Caminho local para o arquivo YAML que contém a especificação de dados do Azure ML. Os documentos de referência yaml para dados podem ser encontrados em: https://aka.ms/ml-cli-v2-data-yaml-reference.

--name -n

Nome do ativo de dados.

--path -p

Caminho para o ativo de dados no armazenamento em nuvem.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=value.

--skip-validation

Ignorar a validação do recurso de computação referenciado pelo trabalho de materialização de importação de dados subjacente.

Propriedade Valor
Valor padrão: False
--type -t

Tipo do ativo de dados.

Propriedade Valor
Valores aceitos: mltable, uri_file, uri_folder
--version -v

Versão do ativo de dados.

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 ml data list

Listar ativos de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

az ml data list [--archived-only]
                [--include-archived]
                [--max-results]
                [--name]
                [--registry-name]
                [--resource-group]
                [--workspace-name]

Exemplos

Listar todos os ativos de dados em um workspace

az ml data list --resource-group my-resource-group --workspace-name my-workspace

Listar todas as versões do ativo de dados para o nome especificado em um workspace

az ml data list --name my-data --resource-group my-resource-group --workspace-name my-workspace

Liste todos os ativos de dados em um workspace usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

az ml data list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace

Listar todos os ativos de dados em um registro

az ml data list --registry-name my-registry-name

Listar todas as versões do ativo de dados para o nome especificado em um registro

az ml data list --name my-data --registry-name my-registry-name

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.

--archived-only

Listar somente ativos de dados arquivados.

Propriedade Valor
Valor padrão: False
--include-archived

Listar ativos de dados arquivados e ativos de dados ativos.

Propriedade Valor
Valor padrão: False
--max-results -r

Número máximo de resultados a serem retornados.

--name -n

Nome do ativo de dados. Se fornecido, todas as versões de dados com esse nome serão retornadas.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários. Deve ser fornecido se --workspace-name e --resource-group não forem fornecidos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data list-materialization-status

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Mostrar o status da lista de trabalhos de materialização de importação de dados que criam versões de um ativo de dados.

az ml data list-materialization-status --resource-group
                                       --workspace-name
                                       [--all-results {false, true}]
                                       [--archived-only]
                                       [--include-archived]
                                       [--max-results]
                                       [--name]

Exemplos

Mostrar o status de materialização de um ativo de dados de um arquivo de especificação YAML

az ml data list-materialization-status --name asset-name --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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.

--all-results

Retorna todos os resultados.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--archived-only

Listar somente trabalhos arquivados.

Propriedade Valor
Valor padrão: False
--include-archived

Listar trabalhos arquivados e trabalhos ativos.

Propriedade Valor
Valor padrão: False
--max-results -r

Número máximo de resultados a serem retornados. O padrão é 50.

Propriedade Valor
Valor padrão: 50
--name -p

Nome do ativo. Listará todos os trabalhos de materialização que criam versões do ativo que correspondem ao nome fornecido.

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 ml data mount

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Monte um ativo de dados específico em um caminho local. Por enquanto, apenas o Linux é suportado.

az ml data mount --path
                 [--mode]
                 [--mount-point]
                 [--persistent]
                 [--resource-group]
                 [--workspace-name]

Exemplos

Montar uma versão de ativo de dados com o URI do Ativo Nomeado

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml:my_urifolder:1

Montar uma versão de ativo de dados com URI completo do AzureML

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/workspaces/myworkspace/data/some_data/versions/5

Montar todas as versões de um ativo de dados com URI de Ativo Nomeado

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml:my_urifolder

Montar todas as versões de um ativo de dados com URI completo do AzureML

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/workspaces/myworkspace/data/some_data

Montar dados no servidor HTTP(s) público por URL

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path https://raw.githubusercontent.com/pandas-dev/pandas/main/doc/data/titanic.csv

Montar dados no Azure pela URL do Armazenamento de Blobs do Azure

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path https://<account_name>.blob.core.windows.net/<container_name>/<path>

Montar dados no Azure pela URL do Azure Data Lake Storage Gen 2

az ml data mount --mount-point /mnt/my-data --mode ro_mount --path abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>

Parâmetros Exigidos

--path

O caminho do ativo de dados a ser montado, na forma de azureml:<name> ou azureml:<name>:<version>.

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.

--mode

Modo de montagem. Somente ro_mount (somente leitura) tem suporte para montagem de ativos de dados.

Propriedade Valor
Valor padrão: ro_mount
--mount-point

Um caminho local usado como ponto de montagem.

Propriedade Valor
Valor padrão: /home/azureuser/mount/data
--persistent

Faça com que a montagem persista entre reinicializações. Com suporte apenas na Instância de Computação.

Propriedade Valor
Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data restore

Restaure um ativo de dados arquivado.

Quando um ativo de dados arquivado for restaurado, ele não ficará mais oculto das consultas de lista (az ml data list). Se um contêiner de ativos de dados inteiro for arquivado, você poderá restaurar esse contêiner arquivado. Isso restaurará todas as versões do ativo de dados com esse nome. Você não pode restaurar apenas uma versão específica do ativo de dados se todo o contêiner de ativos de dados estiver arquivado - você precisará restaurar todo o contêiner. Se apenas uma versão individual do ativo de dados tiver sido arquivada, você poderá restaurar essa versão específica.

az ml data restore --name
                   [--label]
                   [--resource-group]
                   [--version]
                   [--workspace-name]

Exemplos

Restaurar um contêiner de ativo de dados arquivado (restaura todas as versões desse ativo de dados)

az ml data restore --name my-env --resource-group my-resource-group --workspace-name my-workspace

Restaurar uma versão específica do ativo de dados arquivados

az ml data restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

Parâmetros Exigidos

--name -n

Nome do ativo 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.

--label -l

Rótulo do ativo de dados. Mutuamente exclusivo com a versão.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--version -v

Versão do ativo de dados. Mutuamente exclusivo com rótulo.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data share

Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Compartilhe um ativo de dados específico do workspace para o registro.

Copie um ativo de dados existente de um workspace para um registro para reutilização entre workspaces.

az ml data share --name
                 --registry-name
                 --resource-group
                 --share-with-name
                 --share-with-version
                 --version
                 --workspace-name

Exemplos

Compartilhar um ativo de dados existente do workspace para o registro

az ml data share --name my-data --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registry

Parâmetros Exigidos

--name -n

Nome do ativo de dados.

--registry-name

Registro de destino.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--share-with-name

Nome do ativo de dados com o qual será criado.

--share-with-version

Versão do ativo de dados com o qual será criado.

--version -v

Versão do ativo de dados.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data show

Mostra detalhes de um ativo de dados em um workspace/registro. Se você estiver usando um registro, substitua --workspace-name my-workspace pela --registry-name <registry-name> opção.

az ml data show --name
                [--label]
                [--registry-name]
                [--resource-group]
                [--version]
                [--workspace-name]

Exemplos

Mostrar detalhes de um ativo de dados com o nome e a versão especificados em um workspace

az ml data show --name my-data --version 1 --resource-group my-resource-group --workspace-name my-workspace

Mostrar detalhes de um ativo de dados com o nome e o rótulo especificados

az ml data show --name my-data --label latest --resource-group my-resource-group --workspace-name my-workspace

Mostrar detalhes de um ativo de dados com o nome e a versão especificados em um registro

az ml data show --name my-data --version 1 --registry-name my-registry-name

Parâmetros Exigidos

--name -n

Nome do ativo 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.

--label -l

Rótulo do ativo de dados. Deve ser fornecido, se a versão não for fornecida. Mutuamente exclusivo com a versão.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários. Deve ser fornecido se --workspace-name e --resource-group não forem fornecidos.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--version -v

Versão do ativo de dados. Deve ser fornecido, se o rótulo não for fornecido. Mutuamente exclusivo com rótulo.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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 ml data update

Atualize um ativo de dados.

Somente as propriedades 'description' e 'tags' podem ser atualizadas.

az ml data update --name
                  --resource-group
                  --workspace-name
                  [--add]
                  [--force-string]
                  [--label]
                  [--registry-name]
                  [--remove]
                  [--set]
                  [--version]

Parâmetros Exigidos

--name -n

Nome do ativo de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--workspace-name -w

Nome do workspace do Azure ML. Você pode configurar o workspace padrão usando az configure --defaults workspace=<name>.

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.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: False
--label -l

Rótulo do ativo de dados. Deve ser fornecido, se a versão não for fornecida. Mutuamente exclusivo com a versão.

--registry-name

Se fornecido, o comando terá como destino o registro em vez de um workspace. Portanto, o grupo de recursos e o workspace não serão necessários. Deve ser fornecido se --workspace-name e --resource-group não forem fornecidos.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--version -v

Versão do ativo de dados. Deve ser fornecido, se o rótulo não for fornecido. Mutuamente exclusivo com rótulo.

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