DataReference クラス
データストア内のデータへの参照を表します。
DataReference はデータストア内のパスを表し、実行でデータを使用できるようにする方法と場所を記述するために使用できます。 Azure Machine Learning でのデータ アクセスと配信に推奨されるアプローチではなくなりました。 データセット では、データ管理機能が追加された統合インターフェイスを使用して、Azure Blob Storage、Azure Files、Azure Data Lake Storage Gen1、Azure Data Lake Storage Gen2、Azure SQL Database、Azure Database for PostgreSQL からのデータへのアクセスがサポートされています。 機械学習プロジェクトのデータを読み取るためにデータセットを使用することをお勧めします。
2 つの一般的なシナリオで Azure ML データセットを使用する方法の詳細については、次の記事を参照してください。
クラス DataReference コンストラクター。
コンストラクター
DataReference(datastore, data_reference_name=None, path_on_datastore=None, mode='mount', path_on_compute=None, overwrite=False)パラメーター
| 名前 | 説明 |
|---|---|
|
datastore
必須
|
参照するデータストア。 |
|
data_reference_name
|
データ参照の名前。 規定値: None
|
|
path_on_datastore
|
データ参照用バッキング ストレージの相対パス。 規定値: None
|
|
mode
|
データ参照に対する操作。 サポートされている値は、"mount" (既定値) と "ダウンロード" です。 スクリプトで入力データの特定の (ハードコーディングされた) パスが必要な場合は、"ダウンロード" モードを使用します。
この場合は、DataReference を宣言するときに、 "マウント" モードでは、マウントされたデータを使用して一時ディレクトリが作成され、一時ディレクトリへのパスで環境変数 $AZUREML_DATAREFERENCE_<data_reference_name> が設定されます。 パイプライン ステップの引数リスト (PythonScriptStep など) に DataReference を渡すと、実行時に参照がローカル データ パスに展開されます。 規定値: mount
|
|
path_on_compute
|
データ参照のコンピューティング 先のパス。 規定値: None
|
|
overwrite
|
既存のデータを上書きするかどうかを示します。 規定値: False
|
|
datastore
必須
|
参照するデータストア。 |
|
data_reference_name
必須
|
データ参照の名前。 |
|
path_on_datastore
必須
|
データ参照用バッキング ストレージの相対パス。 |
|
mode
必須
|
データ参照に対する操作。 サポートされている値 'mount' (既定値) と 'download' です。 スクリプトで入力データの特定の (ハードコーディングされた) パスが必要な場合は、"ダウンロード" モードを使用します。
この場合は、DataReference を宣言するときに、 "マウント" モードでは、マウントされたデータを使用して一時ディレクトリが作成され、一時ディレクトリへのパスで環境変数 $AZUREML_DATAREFERENCE_<data_reference_name> が設定されます。 パイプライン ステップの引数リスト (PythonScriptStep など) に DataReference を渡すと、実行時に参照がローカル データ パスに展開されます。 |
|
path_on_compute
必須
|
データ参照のコンピューティング 先のパス。 |
|
overwrite
必須
|
既存のデータを上書きするかどうかを示します。 |
注釈
DataReference では、データの場所と、ターゲットコンピューティング バインディング (マウントまたはアップロード) でのデータの使用方法の両方を定義します。 データストア内のデータへのパスには、ルート /、データストア内のディレクトリ、またはデータストア内のファイルを指定できます。
メソッド
| as_download |
ダウンロードするデータ参照操作を切り替えます。 DataReference ダウンロードでは、Azure BLOB と Azure ファイル共有のみがサポートされます。 Azure Blob、Azure File Share、Azure Data Lake Gen1、Azure Data Lake Gen2 からデータをダウンロードするには、Azure Machine Learning データセットを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、 https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。 |
| as_mount |
マウントするデータ参照操作を切り替えます。 DataReference マウントでは、Azure BLOB のみがサポートされます。 Azure Blob、Azure File Share、Azure Data Lake Gen1、および Azure Data Lake Gen2 にデータをマウントするには、Azure Machine Learning データセットを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、 https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。 |
| as_upload |
アップロードするデータ参照操作を切り替えます。 データのアップロードをサポートするコンピューティングとデータストアの詳細については、「 https://aka.ms/datastore-matrix」を参照してください。 |
| create |
DataPath と DataPathComputeBinding を使用して DataReference を作成します。 |
| path |
指定されたパスに基づいて DataReference インスタンスを作成します。 |
| to_config |
DataReference オブジェクトを DataReferenceConfiguration オブジェクトに変換します。 |
as_download
ダウンロードするデータ参照操作を切り替えます。
DataReference ダウンロードでは、Azure BLOB と Azure ファイル共有のみがサポートされます。 Azure Blob、Azure File Share、Azure Data Lake Gen1、Azure Data Lake Gen2 からデータをダウンロードするには、Azure Machine Learning データセットを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、 https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。
as_download(path_on_compute=None, overwrite=False)パラメーター
| 名前 | 説明 |
|---|---|
|
path_on_compute
|
データ参照のコンピューティング上のパス。 規定値: None
|
|
overwrite
|
既存のデータを上書きするかどうかを示します。 規定値: False
|
戻り値
| 型 | 説明 |
|---|---|
|
新しいデータ参照オブジェクト。 |
as_mount
マウントするデータ参照操作を切り替えます。
DataReference マウントでは、Azure BLOB のみがサポートされます。 Azure Blob、Azure File Share、Azure Data Lake Gen1、および Azure Data Lake Gen2 にデータをマウントするには、Azure Machine Learning データセットを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、 https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。
as_mount()戻り値
| 型 | 説明 |
|---|---|
|
新しいデータ参照オブジェクト。 |
as_upload
アップロードするデータ参照操作を切り替えます。
データのアップロードをサポートするコンピューティングとデータストアの詳細については、「 https://aka.ms/datastore-matrix」を参照してください。
as_upload(path_on_compute=None, overwrite=False)パラメーター
| 名前 | 説明 |
|---|---|
|
path_on_compute
|
データ参照のコンピューティング上のパス。 規定値: None
|
|
overwrite
|
既存のデータを上書きするかどうかを示します。 規定値: False
|
戻り値
| 型 | 説明 |
|---|---|
|
新しいデータ参照オブジェクト。 |
create
DataPath と DataPathComputeBinding を使用して DataReference を作成します。
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)パラメーター
| 名前 | 説明 |
|---|---|
|
data_reference_name
|
作成するデータ参照の名前。 規定値: None
|
|
datapath
|
[必須]使用するデータパス。 規定値: None
|
|
datapath_compute_binding
|
[必須]使用するデータパス コンピューティング バインディング。 規定値: None
|
戻り値
| 型 | 説明 |
|---|---|
|
DataReference オブジェクト。 |
path
指定されたパスに基づいて DataReference インスタンスを作成します。
path(path=None, data_reference_name=None)パラメーター
| 名前 | 説明 |
|---|---|
|
path
|
データストア上のパス。 規定値: None
|
|
data_reference_name
|
データ参照の名前。 規定値: None
|
戻り値
| 型 | 説明 |
|---|---|
|
データ参照オブジェクト。 |
to_config
DataReference オブジェクトを DataReferenceConfiguration オブジェクトに変換します。
to_config()戻り値
| 型 | 説明 |
|---|---|
|
新しい DataReferenceConfiguration オブジェクト。 |