az ml feature-store

Note

Esta referência faz parte da extensão ml para o 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.

Gerir as funcionalidades 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.

Extension disponibilidade geral
az ml feature-store delete

Exclua um repositório de recursos.

Extension disponibilidade geral
az ml feature-store list

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

Extension disponibilidade geral
az ml feature-store provision-network

Provisionar rede gerenciada.

Extension disponibilidade geral
az ml feature-store show

Mostrar detalhes de uma loja de recursos.

Extension disponibilidade geral
az ml feature-store update

Atualize um repositório de recursos.

Extension disponibilidade geral

az ml feature-store create

Crie um repositório de recursos.

Quando uma feature store é criada, vários recursos do Azure que serão usados pelo Azure ML também são criados por defeito: Armazenamento do Azure, Azure Container Registry, Azure Key Vault e Aplicação Azure Insights. Pode, em vez disso, usar instâncias de recursos do Azure existentes para essas ao criar a feature store, especificando os IDs de recursos no ficheiro YAML da configuração da feature store.

az ml feature-store create --resource-group
                           [--acquire-policy-token]
                           [--application-insights]
                           [--change-reference]
                           [--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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--application-insights -a

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

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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 ficheiro YAML que contém a especificação feature_store 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.

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

Propriedade Valor
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=value.

--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. Atualizar o recurso Azure Container Registry ou Application Insights ligado ao workspace pode quebrar a linhagem de trabalhos anteriores, endpoints de inferência implementados ou a sua capacidade de reexecutar trabalhos anteriores nesta feature store.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ml feature-store delete

Exclua um repositório de recursos.

Por defeito, os recursos dependentes associados à feature store (Armazenamento do Azure, Azure Container Registry, Azure Key Vault, Aplicação Azure Insights) não são eliminados. Para excluí-los também, inclua --all-resources.

az ml feature-store delete --name
                           --resource-group
                           [--acquire-policy-token]
                           [--all-resources]
                           [--change-reference]
                           [--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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--all-resources

Elimine todos os recursos dependentes associados à feature store (Armazenamento do Azure account, Azure Container Registry, Aplicação Azure Insights, Azure Key Vault).

Propriedade Valor
Default value: False
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--no-wait

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

Propriedade Valor
Default value: False
--yes -y

Não solicite confirmação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--max-results -r

Número máximo de resultados a retornar.

--resource-group -g

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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
                                      [--acquire-policy-token]
                                      [--change-reference]
                                      [--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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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.

Propriedade Valor
Default value: False
--no-wait

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

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
                           [--acquire-policy-token]
                           [--add]
                           [--application-insights]
                           [--change-reference]
                           [--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

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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
Default value: []
--application-insights -a

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

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--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 ficheiro YAML que contém a especificação feature_store 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.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
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.

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

Propriedade Valor
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> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--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
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 ligado ao workspace pode quebrar a linhagem de trabalhos anteriores, endpoints de inferência implementados ou a sua capacidade de reexecutar trabalhos anteriores neste espaço de trabalho.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False