Compartir a través de

az ml feature-store

Note

Esta referencia forma parte de la extensión ml para la CLI de Azure (versión 2.15.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az ml feature-store. Obtenga más información sobre las extensiones.

Administrar almacenes de características de Azure ML.

Un almacén de características es un sistema de administración del ciclo de vida para las características. El almacén de características proporciona detección de características, materialización que atiende cargas de trabajo sin conexión (inferencia por lotes/entrenamiento), servicio de inferencia en línea con requisitos de baja latencia y supervisión de la calidad de las características y operativas.

Comandos

Nombre Description Tipo Estado
az ml feature-store create

Cree un almacén de características.

 Extension GA
az ml feature-store delete

Elimina un almacén de características.

 Extension GA
az ml feature-store list

Enumere todos los almacenes de características de una suscripción.

 Extension GA
az ml feature-store provision-network

Aprovisione la red administrada.

 Extension GA
az ml feature-store show

Mostrar detalles de un almacén de características.

 Extension GA
az ml feature-store update

Actualice un almacén de características.

 Extension GA

az ml feature-store create

Cree un almacén de características.

Cuando se crea un almacén de características, también se crean varios recursos de Azure que azure ML usará de forma predeterminada: Azure Storage, Azure Container Registry, Azure Key Vault y App de Azure lication Insights. En su lugar, puede usar instancias de recursos de Azure existentes para aquellos al crear el almacén de características especificando los identificadores de recursos en el archivo YAML de configuración del almacén de características.

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]

Ejemplos

Cree un almacén de características a partir de un archivo de especificación de YAML.

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

Parámetros requeridos

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--application-insights -a

Id. de ARM de Application Insights asociado a esta área de trabajo.

--container-registry -c

Id. de ARM del registro de contenedor asociado a esta área de trabajo.

--description

Descripción del almacén de características.

--display-name

Nombre para mostrar del almacén de características.

--file -f

Ruta de acceso local al archivo YAML que contiene la especificación de feature_store de Azure ML. Los documentos de referencia de YAML para feature_store se pueden encontrar en: https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--image-build-compute -i

Nombre del destino de proceso que se va a usar para compilar imágenes de Docker del entorno cuando el registro de contenedor está detrás de una red virtual.

--location -l

Ubicación que se va a usar para el nuevo almacén de características.

--managed-network -m

Modo de aislamiento de red administrada para el área de trabajo.

--materialization-identity -t

La identidad usada para la conexión de la tienda sin conexión o en línea.

--name -n

Nombre del almacén de características.

--no-wait

No espere a que finalice la creación del almacén de características.

Propiedad Valor
Valor predeterminado: False
--not-grant-permissions

Especificar --not-grant-permissions, para no conceder permiso de identidad de materializtion al almacén de características (área de trabajo, tienda sin conexión y tienda en línea). El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
--offline-store

Configuración del almacén de características sin conexión. materialization-identity es necesario para configurar el almacén sin conexión.

--primary-user-assigned-identity -p

Identificador arm de la identidad administrada asignada por el usuario principal, en caso de que se especifiquen varios. También la identidad administrada predeterminada para el proceso sin clúster.

--public-network-access

Permitir la conectividad del punto de conexión público cuando un área de trabajo está habilitada para un vínculo privado.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=value.

--tags

Pares clave-valor separados por espacios para las etiquetas del objeto.

--update-dependent-resources -u

Al especificar --update_dependent_resources, se da su consentimiento para actualizar los recursos dependientes del almacén de características. La actualización del recurso de Azure Container Registry o Application Insights asociado al área de trabajo puede interrumpir el linaje de los trabajos anteriores, los puntos de conexión de inferencia implementados o la capacidad de volver a ejecutar trabajos anteriores en este almacén de características.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml feature-store delete

Elimina un almacén de características.

De forma predeterminada, los recursos dependientes asociados al almacén de características (Azure Storage, Azure Container Registry, Azure Key Vault, App de Azure lication Insights) no se eliminan. Para eliminarlos también, incluya --all-resources.

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

Parámetros requeridos

--name -n

Nombre del almacén de características Puede configurar el grupo predeterminado mediante az configure --defaults feature-store=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--all-resources

Elimine todos los recursos dependientes asociados al almacén de características (cuenta de Azure Storage, Azure Container Registry, Azure Application Insights, Azure Key Vault).

Propiedad Valor
Valor predeterminado: False
--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml feature-store list

Enumere todos los almacenes de características de una suscripción.

El grupo de recursos puede filtrar la lista de almacenes de características.

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

Ejemplos

Enumerar todos los almacenes de características de un grupo de recursos

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

Enumere todos los almacenes de características mediante el argumento --query para ejecutar una consulta JMESPath en los resultados de los comandos.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--max-results -r

Número máximo de resultados que se van a devolver.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml feature-store provision-network

Aprovisione la red administrada.

Desencadena el almacén de características para aprovisionar la red administrada. Al especificar la marca habilitada para Spark, se prepara la red administrada del área de trabajo para admitir Spark. El valor predeterminado es false si no se especifica, pero se puede habilitar más adelante ejecutando este comando de nuevo con esta marca. Una vez habilitado, no se puede deshabilitar.

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

Ejemplos

Aprovisione la red administrada.

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

Parámetros requeridos

--name -n

Nombre del almacén de características Puede configurar el grupo predeterminado mediante az configure --defaults feature-store=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--include-spark

Boolean [true/false] para si se debe aprovisionar la red administrada para tener en cuenta los trabajos de Spark. El valor predeterminado es false si no se establece la marca. Se puede habilitar más adelante ejecutando este comando de nuevo con esta marca.

Propiedad Valor
Valor predeterminado: False
--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml feature-store show

Mostrar detalles de un almacén de características.

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

Parámetros requeridos

--name -n

Nombre del almacén de características Puede configurar el grupo predeterminado mediante az configure --defaults feature-store=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az ml feature-store update

Actualice un almacén de características.

Se pueden actualizar las propiedades "description", "tags", "friendly_name" y materialization_identity.

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]

Ejemplos

actualice un almacén de características desde un archivo de especificación de YAML.

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

Parámetros requeridos

--name -n

Nombre del almacén de características Puede configurar el grupo predeterminado mediante az configure --defaults feature-store=<name>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--application-insights -a

Id. de ARM de Application Insights asociado a esta área de trabajo.

--container-registry -c

Id. de ARM del registro de contenedor asociado a esta área de trabajo.

--description

Descripción del almacén de características.

--display-name

Nombre para mostrar del almacén de características.

--file -f

Ruta de acceso local al archivo YAML que contiene la especificación de feature_store de Azure ML. Los documentos de referencia de YAML para feature_store se pueden encontrar en: https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: False
--image-build-compute -i

Nombre del destino de proceso que se va a usar para compilar imágenes de Docker del entorno cuando el registro de contenedor está detrás de una red virtual.

--managed-network -m

Modo de aislamiento de red administrada para el área de trabajo.

--materialization-identity -t

La identidad usada para la conexión de la tienda sin conexión o en línea.

--no-wait

No espere a que finalice la operación de ejecución prolongada. El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
--not-grant-permissions

Especificar --not-grant-permissions, para no conceder permiso de identidad de materializtion al almacén de características (área de trabajo, tienda sin conexión y tienda en línea). El valor predeterminado es False.

Propiedad Valor
Valor predeterminado: False
--primary-user-assigned-identity -p

Identificador de ARM de la identidad asignada por el usuario principal asociada a esta área de trabajo.

--public-network-access

Permitir la conectividad del punto de conexión público cuando un área de trabajo está habilitada para un vínculo privado.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--update-dependent-resources -u

Al especificar --update_dependent_resources, se da su consentimiento para actualizar los recursos dependientes del área de trabajo. La actualización del recurso de Azure Container Registry o Application Insights asociado al área de trabajo puede interrumpir el linaje de los trabajos anteriores, los puntos de conexión de inferencia implementados o la capacidad de volver a ejecutar trabajos anteriores en esta área de trabajo.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False