Udostępnij za pośrednictwem

az ml feature-store

  • Odwołanie

Nuta

Ta dokumentacja jest częścią rozszerzenia ml ml dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az ml feature-store. Dowiedz się więcej o rozszerzeniach.

Zarządzanie magazynami funkcji usługi Azure ML.

Magazyn funkcji to system zarządzania cyklem życia dla funkcji. Magazyn funkcji zapewnia odnajdywanie funkcji, materializację obsługujących obciążenia offline (trenowanie/wnioskowanie wsadowe), obsługę wnioskowania online z wymaganiami dotyczącymi małych opóźnień oraz monitorowanie jakości funkcji i operacyjnej.

Polecenia

Nazwa Opis Typ Stan
az ml feature-store create

Utwórz magazyn funkcji.

 Rozszerzenie GA
az ml feature-store delete

Usuń magazyn funkcji.

 Rozszerzenie GA
az ml feature-store list

Wyświetl listę wszystkich magazynów funkcji w subskrypcji.

 Rozszerzenie GA
az ml feature-store provision-network

Aprowizuj sieć zarządzaną.

 Rozszerzenie GA
az ml feature-store show

Pokaż szczegóły magazynu funkcji.

 Rozszerzenie GA
az ml feature-store update

Aktualizowanie magazynu funkcji.

 Rozszerzenie GA

az ml feature-store create

Utwórz magazyn funkcji.

Po utworzeniu magazynu funkcji kilka zasobów platformy Azure, które będą używane przez usługę Azure ML, również zostanie utworzonych domyślnie: Azure Storage, Azure Container Registry, Azure Key Vault i Azure Application Insights. Zamiast tego możesz użyć istniejących wystąpień zasobów platformy Azure podczas tworzenia magazynu funkcji, określając identyfikatory zasobów w pliku YAML konfiguracji magazynu funkcji.

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]

Przykłady

Utwórz magazyn funkcji na podstawie pliku specyfikacji YAML.

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

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

--application-insights -a

Identyfikator usługi ARM usługi Application Insights skojarzony z tym obszarem roboczym.

--container-registry -c

Identyfikator usługi ARM rejestru kontenerów skojarzony z tym obszarem roboczym.

--description

Opis magazynu funkcji.

--display-name

Nazwa wyświetlana magazynu funkcji.

--file -f

Ścieżka lokalna do pliku YAML zawierającego specyfikację usługi Azure ML feature_store. Dokumentację referencyjną YAML dla feature_store można znaleźć na stronie: https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--image-build-compute -i

Nazwa docelowego obiektu obliczeniowego do użycia na potrzeby tworzenia obrazów platformy Docker, gdy rejestr kontenerów znajduje się za siecią wirtualną.

--location -l

Lokalizacja, która ma być używana w nowym magazynie funkcji.

--managed-network -m

Zarządzany tryb izolacji sieci dla obszaru roboczego.

--materialization-identity -t

Tożsamość używana na potrzeby połączenia ze sklepem offline/online.

--name -n

Nazwa magazynu funkcji.

--no-wait

Nie czekaj na zakończenie tworzenia magazynu funkcji.

Domyślna wartość: False
--not-grant-permissions

Określanie --not-grant-permissions, aby nie przyznać tożsamości materializtion uprawnienia do magazynu funkcji (obszar roboczy, magazyn offline i sklep online). Wartość domyślna to False.

Domyślna wartość: False
--offline-store

Konfiguracja magazynu funkcji w trybie offline. do skonfigurowania magazynu w trybie offline jest wymagana tożsamość materialization-identity.

--primary-user-assigned-identity -p

Identyfikator usługi ARM tożsamości zarządzanej przypisanej przez użytkownika podstawowego, w przypadku określenia wielu z nich. Ponadto domyślna tożsamość zarządzana dla zasobów obliczeniowych bez klastra.

--public-network-access

Zezwalaj na łączność z publicznym punktem końcowym, gdy obszar roboczy jest włączony łączem prywatnym.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=value.

--tags

Pary klucz-wartość rozdzielone spacjami dla tagów obiektu.

--update-dependent-resources -u

Określenie parametru --update_dependent_resources umożliwia zaktualizowanie zasobów zależnych magazynu funkcji. Zaktualizowanie dołączonego obszaru roboczego usługi Azure Container Registry lub zasobu usługi Application Insights może spowodować przerwanie pochodzenia poprzednich zadań, wdrożonych punktów końcowych wnioskowania lub możliwość ponownego uruchamiania wcześniejszych zadań w tym magazynie funkcji.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml feature-store delete

Usuń magazyn funkcji.

Domyślnie zasoby zależne skojarzone z magazynem funkcji (Azure Storage, Azure Container Registry, Azure Key Vault, Azure Application Insights) nie są usuwane. Aby je również usunąć, uwzględnij wartość --all-resources.

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

Parametry wymagane

--name -n

Nazwa magazynu funkcji Możesz skonfigurować grupę domyślną przy użyciu az configure --defaults feature-store=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

--all-resources

Usuń wszystkie zasoby zależne skojarzone z magazynem funkcji (konto usługi Azure Storage, usługa Azure Container Registry, usługa Azure Application Insights, usługa Azure Key Vault).

Domyślna wartość: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Domyślna wartość: False
--yes -y

Nie monituj o potwierdzenie.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml feature-store list

Wyświetl listę wszystkich magazynów funkcji w subskrypcji.

Listę magazynów funkcji można filtrować według grupy zasobów.

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

Przykłady

Wyświetlanie listy wszystkich magazynów funkcji w grupie zasobów

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

Wyświetl listę wszystkich magazynów funkcji przy użyciu argumentu --query w celu wykonania zapytania JMESPath na wynikach poleceń.

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

Parametry opcjonalne

--max-results -r

Maksymalna liczba wyników do zwrócenia.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml feature-store provision-network

Aprowizuj sieć zarządzaną.

Wyzwala magazyn funkcji w celu aprowizacji sieci zarządzanej. Określanie flagi z obsługą platformy Spark powoduje przygotowanie sieci zarządzanej obszaru roboczego do obsługi platformy Spark. Wartość domyślna to false, jeśli nie zostanie określona, ale można ją włączyć później, uruchamiając to polecenie ponownie z tą flagą. Po włączeniu tej opcji nie można jej wyłączyć.

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

Przykłady

Aprowizuj sieć zarządzaną.

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

Parametry wymagane

--name -n

Nazwa magazynu funkcji Możesz skonfigurować grupę domyślną przy użyciu az configure --defaults feature-store=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

--include-spark

Wartość logiczna [true/false] w przypadku, gdy sieć zarządzana powinna być aprowizowana w celu uwzględnienia zadań platformy Spark. Wartość domyślna to false, jeśli flaga nie jest ustawiona. Można ją włączyć później, uruchamiając to polecenie ponownie z tą flagą.

Domyślna wartość: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml feature-store show

Pokaż szczegóły magazynu funkcji.

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

Parametry wymagane

--name -n

Nazwa magazynu funkcji Możesz skonfigurować grupę domyślną przy użyciu az configure --defaults feature-store=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml feature-store update

Aktualizowanie magazynu funkcji.

Właściwości "description", "tags", "friendly_name" i materialization_identity można zaktualizować.

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]

Przykłady

zaktualizuj magazyn funkcji z pliku specyfikacji YAML.

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

Parametry wymagane

--name -n

Nazwa magazynu funkcji Możesz skonfigurować grupę domyślną przy użyciu az configure --defaults feature-store=<name>.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Domyślna wartość: []
--application-insights -a

Identyfikator usługi ARM usługi Application Insights skojarzony z tym obszarem roboczym.

--container-registry -c

Identyfikator usługi ARM rejestru kontenerów skojarzony z tym obszarem roboczym.

--description

Opis magazynu funkcji.

--display-name

Nazwa wyświetlana magazynu funkcji.

--file -f

Ścieżka lokalna do pliku YAML zawierającego specyfikację usługi Azure ML feature_store. Dokumentację referencyjną YAML dla feature_store można znaleźć na stronie: https://aka.ms/ml-cli-v2-featurestore-yaml-reference.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Domyślna wartość: False
--image-build-compute -i

Nazwa docelowego obiektu obliczeniowego do użycia na potrzeby tworzenia obrazów platformy Docker, gdy rejestr kontenerów znajduje się za siecią wirtualną.

--managed-network -m

Zarządzany tryb izolacji sieci dla obszaru roboczego.

--materialization-identity -t

Tożsamość używana na potrzeby połączenia ze sklepem offline/online.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Domyślna wartość: False
--not-grant-permissions

Określanie --not-grant-permissions, aby nie przyznać tożsamości materializtion uprawnienia do magazynu funkcji (obszar roboczy, magazyn offline i sklep online). Wartość domyślna to False.

Domyślna wartość: False
--primary-user-assigned-identity -p

Identyfikator usługi ARM tożsamości przypisanej przez użytkownika podstawowego skojarzony z tym obszarem roboczym.

--public-network-access

Zezwalaj na łączność z publicznym punktem końcowym, gdy obszar roboczy jest włączony łączem prywatnym.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Domyślna wartość: []
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Domyślna wartość: []
--update-dependent-resources -u

Określenie parametru --update_dependent_resources umożliwia zaktualizowanie zasobów zależnych obszaru roboczego. Zaktualizowanie dołączonego obszaru roboczego usługi Azure Container Registry lub zasobu usługi Application Insights może spowodować przerwanie pochodzenia poprzednich zadań, wdrożonych punktów końcowych wnioskowania lub możliwość ponownego uruchamiania wcześniejszych zadań w tym obszarze roboczym.

Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.