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 コンストラクター。
- 継承
-
builtins.objectDataReference
コンストラクター
DataReference(datastore, data_reference_name=None, path_on_datastore=None, mode='mount', path_on_compute=None, overwrite=False)パラメーター
- mode
- str
データ参照に対する操作。 サポートされている値は、「mount」(既定値) および「download」です。
スクリプトで入力データの特定のパス (ハードコーディングされたパスなど) が期待されている場合は、「download」モードを使用します。
この場合、DataReference を宣言するときに、path_on_compute パラメーターを使用してパスを指定します。
Azure Machine Learning では、スクリプトを実行する前に、そのパスで指定されたデータをダウンロードします。
「mount」モードでは、マウントされたデータを使用して一時ディレクトリが作成され、環境変数 $ AZUREML_DATAREFERENCE_<data_reference_name> に一時ディレクトリへのパスが設定されます。 パイプライン ステップ (PythonScriptStep など) の引数リストに DataReference を渡すと、実行時に参照がローカル データ パスに展開されます。
- mode
- str
データ参照に対する操作。 サポートされている値 'mount' (既定値) と 'download' です。
スクリプトで入力データの特定のパス (ハードコーディングされたパスなど) が期待されている場合は、「download」モードを使用します。
この場合、DataReference を宣言するときに、path_on_compute パラメーターを使用してパスを指定します。
Azure Machine Learning では、スクリプトを実行する前に、そのパスで指定されたデータをダウンロードします。
「mount」モードでは、マウントされたデータを使用して一時ディレクトリが作成され、環境変数 $ AZUREML_DATAREFERENCE_<data_reference_name> に一時ディレクトリへのパスが設定されます。 パイプライン ステップ (PythonScriptStep など) の引数リストに DataReference を渡すと、実行時に参照がローカル データ パスに展開されます。
注釈
DataReference は、データの場所と、ターゲット コンピューティング バインディング (マウントまたはアップロード) でのデータの使用方法の両方を定義します。 データストア内のデータへのパスには、ルート/、データストア内のディレクトリ、またはデータストア内のファイルを指定できます。
メソッド
| as_download |
データ参照操作をダウンロードに切り替えます。 DataReference のダウンロードでは、Azure Blob と Azure File Share のみがサポートされています。 Azure Blob、Azure File Share、Azure Data Lake Gen1、Azure Data Lake Gen2 からデータをダウンロードするには、Azure Machine Learning Dataset を使用することをお勧めします。 データセットを作成して使用する方法の詳細については、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 Datasetを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。 |
| as_upload |
データ参照操作をアップロードに切り替えます。 データのアップロードをサポートしているコンプーティングとデータストアの詳細については、https://aka.ms/datastore-matrixを参照してください。 |
| create |
データパスと DataPathComputeBinding を使用して DataReference を作成します。 |
| path |
指定したパスに基づいて DataReference インスタンスを作成します。 |
| to_config |
DataReference オブジェクトを DataReferenceConfiguration オブジェクトに変換します。 |
as_download
データ参照操作をダウンロードに切り替えます。
DataReference のダウンロードでは、Azure Blob と Azure File Share のみがサポートされています。 Azure Blob、Azure File Share、Azure Data Lake Gen1、Azure Data Lake Gen2 からデータをダウンロードするには、Azure Machine Learning Dataset を使用することをお勧めします。 データセットを作成して使用する方法の詳細については、https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasetsを参照してください。
as_download(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 Datasetを使用することをお勧めします。 データセットを作成して使用する方法の詳細については、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)パラメーター
戻り値
新しいデータ参照オブジェクト。
の戻り値の型 :
create
データパスと DataPathComputeBinding を使用して DataReference を作成します。
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)パラメーター
戻り値
DataReference オブジェクト。
の戻り値の型 :
path
指定したパスに基づいて DataReference インスタンスを作成します。
path(path=None, data_reference_name=None)パラメーター
戻り値
データ参照オブジェクト。
の戻り値の型 :
to_config
DataReference オブジェクトを DataReferenceConfiguration オブジェクトに変換します。
to_config()戻り値
新しい DataReferenceConfiguration オブジェクト。
の戻り値の型 :
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示