az ml feature-store

Note

このリファレンスは、Azure CLI (バージョン 2.15.0 以降) の ml 拡張機能の一部です。 拡張機能は、az ml feature-store コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

Azure ML 機能ストアを管理します。

フィーチャー ストアは、機能のライフサイクル管理システムです。 フィーチャー ストアには、機能検出、オフライン ワークロードに対応する具体化 (トレーニング/バッチ推論)、待機時間の短い要件でのオンライン推論の提供、運用および機能品質の監視が用意されています。

コマンド

名前	説明	型	Status
az ml feature-store create	フィーチャー ストアを作成します。	拡張機能	GA
az ml feature-store delete	機能ストアを削除します。	拡張機能	GA
az ml feature-store list	サブスクリプション内のすべての機能ストアを一覧表示します。	拡張機能	GA
az ml feature-store provision-network	マネージド ネットワークをプロビジョニングします。	拡張機能	GA
az ml feature-store show	機能ストアの詳細を表示します。	拡張機能	GA
az ml feature-store update	機能ストアを更新します。	拡張機能	GA

az ml feature-store create

フィーチャー ストアを作成します。

機能ストアが作成されると、Azure ML によって使用される複数の Azure リソースも既定で作成されます。Azure Storage、Azure Container Registry、Azure Key Vault、Azure アプリlication インサイト。 代わりに、フィーチャー ストア構成 YAML ファイルでリソース ID を指定することで、フィーチャー ストアの作成時に既存の Azure リソース インスタンスを使用できます。

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]

例

YAML 仕様ファイルからフィーチャー ストアを作成します。

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

必須のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--application-insights -a

このワークスペースに関連付けられているアプリケーション分析情報の ARM ID。

--container-registry -c

このワークスペースに関連付けられているコンテナー レジストリの ARM ID。

--description

特徴量ストアの説明。

--display-name

フィーチャー ストアの表示名。

--file -f

Azure ML feature_store仕様を含む YAML ファイルへのローカル パス。 feature_storeの YAML リファレンス ドキュメントは次 https://aka.ms/ml-cli-v2-featurestore-yaml-referenceの場所にあります。

--image-build-compute -i

コンテナー レジストリが VNet の背後にある場合に環境 Docker イメージの構築に使用するコンピューティング ターゲットの名前。

--location -l

新しいフィーチャ ストアに使用する場所。

--managed-network -m

ワークスペースのマネージド ネットワーク分離モード。

--materialization-identity -t

オフライン/オンライン ストア接続に使用される ID。

--name -n

特徴量ストアの名前。

--no-wait

機能ストアの作成が完了するまで待つ必要はありません。

既定値: False

--not-grant-permissions

機能ストア (ワークスペース、オフライン ストア、およびオンライン ストア) に具体化 ID アクセス許可を付与しないように、--not-grant-permissions を指定します。 既定値は False です。

既定値: False

--offline-store

機能ストアのオフライン ストア構成。オフライン ストアをセットアップするには、materialization-identity が必要です。

--primary-user-assigned-identity -p

複数のユーザー割り当てマネージド ID が指定されている場合の、プライマリ ユーザー割り当てマネージド ID の ARM 識別子。 クラスターレス コンピューティングの既定のマネージド ID でもあります。

--public-network-access

ワークスペースがプライベート リンクが有効になっている場合は、パブリック エンドポイント接続を許可します。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=。

--tags

オブジェクトのタグのスペース区切りのキーと値のペア。

--update-dependent-resources -u

--update_dependent_resources を指定すると、機能ストアに依存するリソースを更新することに同意できます。 ワークスペースにアタッチされた Azure Container Registry または Application インサイト リソースを更新すると、以前のジョブ、デプロイされた推論エンドポイント、またはこの機能ストア内の以前のジョブを再実行する機能の系列が壊れる可能性があります。

既定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ml feature-store delete

機能ストアを削除します。

既定では、機能ストアに関連付けられている依存リソース (Azure Storage、Azure Container Registry、Azure Key Vault、Azure アプリlication インサイト) は削除されません。 それらも削除するには、--all-resources を含めます。

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

必須のパラメーター

--name -n

機能ストアの名前 を使用して az configure --defaults feature-store=<name>、既定のグループを構成できます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--all-resources

機能ストアに関連付けられているすべての依存リソース (Azure Storage アカウント、Azure Container Registry、Azure アプリlication インサイト、Azure Key Vault) を削除します。

既定値: False

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。 既定値は False です。

既定値: False

--yes -y

確認のダイアログを表示しません。

既定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ml feature-store list

サブスクリプション内のすべての機能ストアを一覧表示します。

機能ストアの一覧は、リソース グループでフィルター処理できます。

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

例

リソース グループ内のすべての機能ストアを一覧表示する

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

--query 引数を使用してすべての機能ストアを一覧表示し、コマンドの結果に対して JMESPath クエリを実行します。

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

省略可能のパラメーター

--max-results -r

返される結果の最大数。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ml feature-store provision-network

マネージド ネットワークをプロビジョニングします。

マネージド ネットワークをプロビジョニングする機能ストアをトリガーします。 Spark 対応フラグを指定すると、Spark をサポートするためにワークスペースのマネージド ネットワークが準備されます。 既定値は false (指定しない場合) ですが、後でこのフラグを指定してこのコマンドを再度実行することで有効にできます。 一度有効にすると、無効にすることはできません。

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

例

マネージド ネットワークをプロビジョニングします。

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

必須のパラメーター

--name -n

機能ストアの名前 を使用して az configure --defaults feature-store=<name>、既定のグループを構成できます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--include-spark

Spark ジョブを考慮するためにマネージド ネットワークをプロビジョニングする必要がある場合のブール値 [true/false] です。 フラグが設定されていない場合、既定値は false です。 このフラグを指定してこのコマンドを再度実行することで、後で有効にすることができます。

既定値: False

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。 既定値は False です。

既定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ml feature-store show

機能ストアの詳細を表示します。

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

必須のパラメーター

--name -n

機能ストアの名前 を使用して az configure --defaults feature-store=<name>、既定のグループを構成できます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ml feature-store update

機能ストアを更新します。

'description'、'tags'、'friendly_name'、および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]

例

YAML 仕様ファイルから機能ストアを更新します。

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

必須のパラメーター

--name -n

機能ストアの名前 を使用して az configure --defaults feature-store=<name>、既定のグループを構成できます。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。

既定値: []

--application-insights -a

このワークスペースに関連付けられているアプリケーション分析情報の ARM ID。

--container-registry -c

このワークスペースに関連付けられているコンテナー レジストリの ARM ID。

--description

特徴量ストアの説明。

--display-name

フィーチャー ストアの表示名。

--file -f

Azure ML feature_store仕様を含む YAML ファイルへのローカル パス。 feature_storeの YAML リファレンス ドキュメントは次 https://aka.ms/ml-cli-v2-featurestore-yaml-referenceの場所にあります。

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

既定値: False

--image-build-compute -i

コンテナー レジストリが VNet の背後にある場合に環境 Docker イメージの構築に使用するコンピューティング ターゲットの名前。

--managed-network -m

ワークスペースのマネージド ネットワーク分離モード。

--materialization-identity -t

オフライン/オンライン ストア接続に使用される ID。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。 既定値は False です。

既定値: False

--not-grant-permissions

機能ストア (ワークスペース、オフライン ストア、およびオンライン ストア) に具体化 ID アクセス許可を付与しないように、--not-grant-permissions を指定します。 既定値は False です。

既定値: False

--primary-user-assigned-identity -p

このワークスペースに関連付けられているプライマリ ユーザー割り当て ID の ARM ID。

--public-network-access

ワークスペースがプライベート リンクが有効になっている場合は、パブリック エンドポイント接続を許可します。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

既定値: []

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

既定値: []

--update-dependent-resources -u

--update_dependent_resources を指定すると、ワークスペース依存リソースを更新することに同意できます。 ワークスペースにアタッチされた Azure Container Registry または Application インサイト リソースを更新すると、以前のジョブ、デプロイされた推論エンドポイント、またはこのワークスペース内の以前のジョブを再実行する機能の系列が壊れる可能性があります。

既定値: False

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。