Compartilhar via

az ml feature-store

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 feature-store. Saiba mais sobre extensões.

Gerenciar 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 atendendo a cargas de trabalho offline (treinamento/inferência em lote), atendendo a inferência online com requisitos de baixa latência e monitoramento operacional e de qualidade de recursos.

Comandos

Nome Description Tipo Status
az ml feature-store create

Crie um repositório de recursos.

 Extension GA
az ml feature-store delete

Exclua um repositório de recursos.

 Extension GA
az ml feature-store list

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

 Extension GA
az ml feature-store provision-network

Provisione a rede gerenciada.

 Extension GA
az ml feature-store show

Mostrar detalhes de um repositório de recursos.

 Extension GA
az ml feature-store update

Atualize um repositório de recursos.

 Extension 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, Azure Key Vault e Azure Application Insights. Em vez disso, você pode usar instâncias de recursos existentes do Azure para elas 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 Exigidos

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--application-insights -a

ID do ARM dos insights do aplicativo associados a esse workspace.

--container-registry -c

ID do ARM do registro de contêiner associado a esse workspace.

--description

Descrição do repositório de recursos.

--display-name

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

--file -f

Caminho local para o arquivo YAML que contém a especificação de feature_store do Azure ML. Os documentos de referência 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 de 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 workspace.

--materialization-identity -t

A identidade usada para conexão de repositório offline/online.

--name -n

Nome do repositório de recursos.

--no-wait

Não aguarde a conclusão da criação do repositório de recursos.

Propriedade Valor
Valor padrão: False
--not-grant-permissions

Especificando --not-grant-permissions, to not grant materializtion identity permission to feature store (workspace, offline store and online store). O padrão é False.

Propriedade Valor
Valor padrão: False
--offline-store

Configuração do repositório offline do repositório de recursos. A materialização-identidade é necessária para configurar o repositório offline.

--primary-user-assigned-identity -p

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

--public-network-access

Permitir conectividade de ponto de extremidade público quando um workspace 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 de valores-chave 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 do Registro de Contêiner do Azure ou do Application Insights anexado ao workspace pode interromper a linhagem de trabalhos anteriores, os pontos de extremidade de inferência implantados ou a capacidade de executar trabalhos anteriores neste repositório de recursos.

Propriedade Valor
Valor padrão: False
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 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, Azure Key Vault, 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 Exigidos

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--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
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
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 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--max-results -r

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

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<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 feature-store provision-network

Provisione a rede gerenciada.

Aciona o repositório de recursos para provisionar a rede gerenciada. Especificar o sinalizador habilitado para o Spark prepara a rede gerenciada do workspace para dar suporte ao Spark. O padrão é false se não for especificado, mas pode ser habilitado posteriormente executando esse comando novamente com esse sinalizador. Depois de habilitado, ele não pode ser desabilitado.

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

Exemplos

Provisione a rede gerenciada.

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

Parâmetros Exigidos

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--include-spark

Booleano [true/false] para se a rede gerenciada deve ser provisionada para contabilizar trabalhos do Spark. O padrão é false se o sinalizador não estiver definido. Ele pode ser habilitado posteriormente executando este comando novamente com este sinalizador.

Propriedade Valor
Valor padrão: False
--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
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 feature-store show

Mostrar detalhes de um repositório de recursos.

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

Parâmetros Exigidos

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

--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 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: []
--application-insights -a

ID do ARM dos insights do aplicativo associados a esse workspace.

--container-registry -c

ID do ARM do registro de contêiner associado a esse workspace.

--description

Descrição do repositório de recursos.

--display-name

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

--file -f

Caminho local para o arquivo YAML que contém a especificação de feature_store do Azure ML. Os documentos de referência 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 cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: 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 de contêiner estiver atrás de uma VNet.

--managed-network -m

Modo de isolamento de rede gerenciado para o workspace.

--materialization-identity -t

A identidade usada para conexão de repositório offline/online.

--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
--not-grant-permissions

Especificando --not-grant-permissions, to not grant materializtion identity permission to feature store (workspace, offline store and online store). O padrão é False.

Propriedade Valor
Valor padrão: False
--primary-user-assigned-identity -p

ID do ARM da identidade atribuída pelo usuário primário associada a esse workspace.

--public-network-access

Permitir conectividade de ponto de extremidade público quando um workspace estiver habilitado para link privado.

--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: []
--update-dependent-resources -u

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

Propriedade Valor
Valor padrão: False
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