Partilhar via

az ml feature-store

  • Referência

Nota

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

Gerencie repositórios de recursos do Azure ML.

Um repositório de recursos é um sistema de gerenciamento de ciclo de vida para recursos. O repositório de recursos fornece descoberta de recursos, materialização servindo cargas de trabalho offline (treinamento/inferência em lote), atendendo inferência on-line com requisitos de baixa latência e monitoramento operacional e de qualidade de recursos.

Comandos

Name Description Tipo Status
az ml feature-store create

Crie um repositório de recursos.

 Extensão GA
az ml feature-store delete

Exclua um repositório de recursos.

 Extensão GA
az ml feature-store list

Liste todos os repositórios de recursos em uma assinatura.

 Extensão GA
az ml feature-store provision-network

Provisionar rede gerenciada.

 Extensão GA
az ml feature-store show

Mostrar detalhes de uma loja de recursos.

 Extensão GA
az ml feature-store update

Atualize um repositório de recursos.

 Extensão GA

az ml feature-store create

Crie um repositório de recursos.

Quando um repositório de recursos é criado, vários recursos do Azure que serão usados pelo Azure ML também são criados por padrão: Armazenamento do Azure, Registro de Contêiner do Azure, Cofre da Chave do Azure e Azure Application Insights. Em vez disso, você pode usar instâncias de recursos existentes do Azure para aquelas ao criar o repositório de recursos especificando as IDs de recursos no arquivo YAML de configuração do repositório de recursos.

az ml feature-store create --resource-group
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--image-build-compute]
                           [--location]
                           [--managed-network]
                           [--materialization-identity]
                           [--name]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--offline-store]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--set]
                           [--tags]
                           [--update-dependent-resources]

Exemplos

Crie um repositório de recursos a partir de um arquivo de especificação YAML.

az ml feature-store create --file feature-store.yml --resource-group my-resource-group

Parâmetros Obrigatórios

--resource-group -g

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

Parâmetros Opcionais

--application-insights -a

ID ARM dos insights do aplicativo associados a este espaço de trabalho.

--container-registry -c

ID ARM do registo de contentor associado a esta área de trabalho.

--description

Descrição da loja de recursos.

--display-name

Nome para exibição do repositório de recursos.

--file -f

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

--image-build-compute -i

O nome do destino de computação a ser usado para criar imagens do Docker do ambiente quando o registro do contêiner estiver atrás de uma VNet.

--location -l

O local a ser usado para o novo repositório de recursos.

--managed-network -m

Modo de Isolamento de Rede Gerenciado para o espaço de trabalho.

--materialization-identity -t

A identidade usada para conexão offline/loja online.

--name -n

Nome do repositório de recursos.

--no-wait

Não espere a criação da loja de recursos terminar.

Default value: False
--not-grant-permissions

Especificando --not-grant-permissions, para não conceder permissão de identidade de materialização ao repositório de recursos (espaço de trabalho, loja offline e loja online). O padrão é False.

Default value: False
--offline-store

Configuração da loja offline do repositório de recursos. materialization-identity é necessária para configurar o armazenamento offline.

--primary-user-assigned-identity -p

Identificador ARM da identidade gerenciada atribuída ao usuário principal, caso várias sejam especificadas. Também a identidade gerenciada padrão para computação sem cluster.

--public-network-access

Permita a conectividade de ponto de extremidade público quando um espaço de trabalho estiver habilitado para link privado.

--set

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

--tags

Pares chave-valor separados por espaço para as tags do objeto.

--update-dependent-resources -u

Especificando --update_dependent_resources, dá seu consentimento para atualizar os recursos dependentes do repositório de recursos. A atualização do recurso Azure Container Registry ou Application Insights anexado ao espaço de trabalho pode quebrar a linhagem de trabalhos anteriores, pontos de extremidade de inferência implantados ou sua capacidade de executar novamente trabalhos anteriores neste repositório de recursos.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ml feature-store delete

Exclua um repositório de recursos.

Por padrão, os recursos dependentes associados ao repositório de recursos (Armazenamento do Azure, Registro de Contêiner do Azure, Cofre da Chave do Azure, Azure Application Insights) não são excluídos. Para excluí-los também, inclua --all-resources.

az ml feature-store delete --name
                           --resource-group
                           [--all-resources]
                           [--no-wait]
                           [--yes]

Parâmetros Obrigatórios

--name -n

Nome do repositório de recursos Você pode configurar o grupo padrão usando az configure --defaults feature-store=<name>.

--resource-group -g

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

Parâmetros Opcionais

--all-resources

Exclua todos os recursos dependentes associados ao repositório de recursos (conta de Armazenamento do Azure, Registro de Contêiner do Azure, Azure Application Insights, Azure Key Vault).

Default value: False
--no-wait

Não espere que a operação de longa duração termine. O padrão é False.

Default value: False
--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ml feature-store list

Liste todos os repositórios de recursos em uma assinatura.

A lista de repositórios de recursos pode ser filtrada por grupo de recursos.

az ml feature-store list [--max-results]
                         [--resource-group]

Exemplos

Listar todos os repositórios de recursos em um grupo de recursos

az ml feature-store list --resource-group my-resource-group

Liste todos os repositórios de recursos usando o argumento --query para executar uma consulta JMESPath nos resultados dos comandos.

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

Parâmetros Opcionais

--max-results -r

Número máximo de resultados a retornar.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ml feature-store provision-network

Provisionar rede gerenciada.

Aciona o repositório de recursos para provisionar a rede gerenciada. A especificação do sinalizador habilitado para faísca prepara a rede gerenciada do espaço de trabalho para oferecer suporte ao Spark. O padrão é false se não for especificado, mas pode ser ativado posteriormente executando este comando novamente com este sinalizador. Uma vez ativado, não pode ser desativado.

az ml feature-store provision-network --name
                                      --resource-group
                                      [--include-spark]
                                      [--no-wait]

Exemplos

Provisionar rede gerenciada.

az ml feature-store provision-network --resource-group my-resource-group --name my-feature-store-name

Parâmetros Obrigatórios

--name -n

Nome do repositório de recursos Você pode configurar o grupo padrão usando az configure --defaults feature-store=<name>.

--resource-group -g

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

Parâmetros Opcionais

--include-spark

Boolean [true/false] para se a rede gerenciada deve ser provisionada para levar em conta os trabalhos de faísca. O padrão é false se o sinalizador não estiver definido. Ele pode ser ativado mais tarde, executando este comando novamente com este sinalizador.

Default value: False
--no-wait

Não espere que a operação de longa duração termine. O padrão é False.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ml feature-store show

Mostrar detalhes de uma loja de recursos.

az ml feature-store show --name
                         --resource-group

Parâmetros Obrigatórios

--name -n

Nome do repositório de recursos Você pode configurar o grupo padrão usando az configure --defaults feature-store=<name>.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ml feature-store update

Atualize um repositório de recursos.

As propriedades 'description', 'tags', 'friendly_name' e materialization_identity podem ser atualizadas.

az ml feature-store update --name
                           --resource-group
                           [--add]
                           [--application-insights]
                           [--container-registry]
                           [--description]
                           [--display-name]
                           [--file]
                           [--force-string]
                           [--image-build-compute]
                           [--managed-network]
                           [--materialization-identity]
                           [--no-wait]
                           [--not-grant-permissions]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--remove]
                           [--set]
                           [--update-dependent-resources]

Exemplos

atualizar um repositório de recursos a partir de um arquivo de especificação YAML.

az ml feature-store update --resource-group my-resource-group --name my-feature-store-name --file feature-store.yml

Parâmetros Obrigatórios

--name -n

Nome do repositório de recursos Você pode configurar o grupo padrão usando az configure --defaults feature-store=<name>.

--resource-group -g

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

Parâmetros Opcionais

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

Default value: []
--application-insights -a

ID ARM dos insights do aplicativo associados a este espaço de trabalho.

--container-registry -c

ID ARM do registo de contentor associado a esta área de trabalho.

--description

Descrição da loja de recursos.

--display-name

Nome para exibição do repositório de recursos.

--file -f

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

--force-string

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

Default value: False
--image-build-compute -i

O nome do destino de computação a ser usado para criar imagens do Docker do ambiente quando o registro do contêiner estiver atrás de uma VNet.

--managed-network -m

Modo de Isolamento de Rede Gerenciado para o espaço de trabalho.

--materialization-identity -t

A identidade usada para conexão offline/loja online.

--no-wait

Não espere que a operação de longa duração termine. O padrão é False.

Default value: False
--not-grant-permissions

Especificando --not-grant-permissions, para não conceder permissão de identidade de materialização ao repositório de recursos (espaço de trabalho, loja offline e loja online). O padrão é False.

Default value: False
--primary-user-assigned-identity -p

ID ARM da identidade atribuída ao usuário principal associada a este espaço de trabalho.

--public-network-access

Permita a conectividade de ponto de extremidade público quando um espaço de trabalho estiver habilitado para link privado.

--remove

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

Default value: []
--set

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

Default value: []
--update-dependent-resources -u

Especificar --update_dependent_resources, dá seu consentimento para atualizar os recursos dependentes do espaço de trabalho. Atualizar o recurso Azure Container Registry ou Application Insights anexado ao espaço de trabalho pode quebrar a linhagem de trabalhos anteriores, pontos de extremidade de inferência implantados ou sua capacidade de executar novamente trabalhos anteriores neste espaço de trabalho.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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