次の方法で共有

az ml datastore

  • リファレンス

手記

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

Azure ML データストアを管理します。

Azure ML データストアは、接続情報をスクリプトにハードコーディングしなくてもストレージにアクセスできるように、Azure Storage サービスをワークスペースに安全にリンクします。 ストレージ サービスの認証資格情報などの接続シークレットは、ワークスペースの Key Vault に格納されます。

ワークスペースを作成すると、Azure Storage アカウントが関連付けられたリソースとして自動的に作成されます。 このアカウントには BLOB コンテナーが作成され、その接続情報は "workspaceblobstore" という名前のデータストアとして格納されます。 これはワークスペースの既定のデータストアとして機能し、BLOB コンテナーはワークスペースの成果物と機械学習ジョブのログと出力を格納するために使用されます。

コマンド

名前 説明 型 状態
az ml datastore create

データストアを作成します。

 延長 ジョージア 州
az ml datastore delete

データストアを削除します。

 延長 ジョージア 州
az ml datastore list

ワークスペース内のデータストアを一覧表示します。

 延長 ジョージア 州
az ml datastore mount

特定のデータストアをローカル パスにマウントします。 現時点では、Linux のみがサポートされています。

 延長 プレビュー
az ml datastore show

データストアの詳細を表示します。

 延長 ジョージア 州
az ml datastore update

データストアを更新します。

 延長 ジョージア 州

az ml datastore create

データストアを作成します。

これにより、基になる Azure ストレージ サービスがワークスペースに接続されます。 データストアを作成して現在接続できるストレージ サービスの種類には、Azure Blob Storage、Azure File Share、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2 などがあります。

az ml datastore create --file
                       --resource-group
                       --workspace-name
                       [--name]
                       [--set]

例

YAML 仕様ファイルからデータストアを作成する

az ml datastore create --file blobstore.yml --resource-group my-resource-group --workspace-name my-workspace

必須のパラメーター

--file -f

Azure ML データストア仕様を含む YAML ファイルへのローカル パス。 データストアの YAML リファレンス ドキュメントは、https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference、https://aka.ms/ml-cli-v2-datastore-file-yaml-reference、https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference、https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-referenceにあります。

--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<name>を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

--name -n

データストアの名前。 これにより、--file/-f に指定された YAML ファイルの 'name' フィールドが上書きされます。

--set

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

グローバル パラメーター
--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 datastore delete

データストアを削除します。

これにより、ワークスペースからストレージ サービスへの接続情報が削除されますが、ストレージ内の基になるデータは削除されません。

az ml datastore delete --name
                       --resource-group
                       --workspace-name

必須のパラメーター

--name -n

データストアの名前。

--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<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 datastore list

ワークスペース内のデータストアを一覧表示します。

az ml datastore list --resource-group
                     --workspace-name
                     [--max-results]

例

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

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

必須のパラメーター

--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<name>を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

--max-results -r

返される結果の最大数。

グローバル パラメーター
--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 datastore mount

プレビュー

このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

特定のデータストアをローカル パスにマウントします。 現時点では、Linux のみがサポートされています。

az ml datastore mount --path
                      [--mode]
                      [--mount-point]
                      [--persistent]
                      [--resource-group]
                      [--workspace-name]

例

名前でデータストアをマウントする

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path my-datastore

データストアの短い形式の URL でデータストアをマウントする

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://datastores/my-datastore

データストアの長い形式の URL でデータストアをマウントする

az ml datastore mount --mount-point /mnt/my-datastore --mode ro_mount --path azureml://subscriptions/my-sub-id/resourcegroups/my-rg/providers/Microsoft.MachineLearningServices/workspaces/myworkspace/datastores/my-datastore

必須のパラメーター

--path

マウントするデータストア パス (<datastore_name> または azureml://datastores/<datastore_name>の形式)。

省略可能のパラメーター

--mode

マウント モード。ro_mount (読み取り専用) または rw_mount (読み取り/書き込み)。

規定値: ro_mount
--mount-point

マウント ポイントとして使用されるローカル パス。

規定値: /home/azureuser/mount/data
--persistent

再起動後もマウントを保持します。 コンピューティング インスタンスでのみサポートされます。

規定値: False
--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<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 datastore show

データストアの詳細を表示します。

az ml datastore show --name
                     --resource-group
                     --workspace-name

必須のパラメーター

--name -n

データストアの名前。

--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<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 datastore update

データストアを更新します。

'description'、'tags'、および 'credential' のプロパティを更新できます。

az ml datastore update --resource-group
                       --workspace-name
                       [--add]
                       [--file]
                       [--force-string]
                       [--name]
                       [--remove]
                       [--set]

必須のパラメーター

--resource-group -g

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

--workspace-name -w

Azure ML ワークスペースの名前。 az configure --defaults workspace=<name>を使用して既定のワークスペースを構成できます。

省略可能のパラメーター

--add

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

規定値: []
--file -f

Azure ML データストア仕様を含む YAML ファイルへのローカル パス。 データストアの YAML リファレンス ドキュメントは、https://aka.ms/ml-cli-v2-datastore-blob-yaml-reference、https://aka.ms/ml-cli-v2-datastore-file-yaml-reference、https://aka.ms/ml-cli-v2-datastore-data-lake-gen1-yaml-reference、https://aka.ms/ml-cli-v2-datastore-data-lake-gen2-yaml-referenceにあります。

--force-string

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

規定値: False
--name -n

データストアの名前。 これにより、--file/-f に指定された YAML ファイルの 'name' フィールドが上書きされます。

--remove

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

規定値: []
--set

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

規定値: []
グローバル パラメーター
--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 を使用します。