DataReference Sınıf
Veri deposundaki verilere yapılan başvuruları temsil eder.
DataReference, veri deposundaki bir yolu temsil eder ve bir çalıştırmada verilerin nasıl ve nerede kullanılabilir hale getirilebileceğini açıklamak için kullanılabilir. Artık Azure Machine Learning'de veri erişimi ve teslimi için önerilen yaklaşım değildir. Veri kümesi , eklenen veri yönetimi özelliklerine sahip birleşik arabirim aracılığıyla Azure Blob depolama, Azure Dosyalar, Azure Data Lake Storage 1. Nesil, Azure Data Lake Storage 2. Nesil, Azure SQL Veritabanı ve PostgreSQL için Azure Veritabanı'ndan verilere erişimi destekler. Makine öğrenmesi projelerinizdeki verileri okumak için veri kümesini kullanmanız önerilir.
Azure ML veri kümesini iki yaygın senaryoda kullanma hakkında daha fazla bilgi için şu makalelere bakın:
Sınıf DataReference oluşturucusu.
Oluşturucu
DataReference(datastore, data_reference_name=None, path_on_datastore=None, mode='mount', path_on_compute=None, overwrite=False)Parametreler
| Name | Description |
|---|---|
|
datastore
Gerekli
|
Başvurulacak veri deposu. |
|
data_reference_name
|
Veri başvurusunun adı. Default value: None
|
|
path_on_datastore
|
Veri başvurusu için yedekleme depolamadaki göreli yol. Default value: None
|
|
mode
|
Veri başvurusundaki işlem. Desteklenen değerler 'mount' (varsayılan) ve 'download' değerleridir. Betiğiniz giriş verileri için belirli bir (örneğin sabit kodlanmış) yol beklediğinde 'indirme' modunu kullanın.
Bu durumda, DataReference'ı bildirirken parametresiyle 'Bağlama' moduyla, bağlı verilerle geçici bir dizin oluşturulur ve geçici dizinin yolu ile $AZUREML_DATAREFERENCE_<data_reference_name> ortam değişkeni ayarlanır. İşlem hattı adımı için bağımsız değişkenler listesine bir DataReference geçirirseniz (örneğin PythonScriptStep), başvuru çalışma zamanında yerel veri yoluna genişletilecektir. Default value: mount
|
|
path_on_compute
|
Veri başvurusu için işlem hedefinde yol. Default value: None
|
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. Default value: False
|
|
datastore
Gerekli
|
Başvurulacak veri deposu. |
|
data_reference_name
Gerekli
|
Veri başvurusunun adı. |
|
path_on_datastore
Gerekli
|
Veri başvurusu için yedekleme depolamadaki göreli yol. |
|
mode
Gerekli
|
Veri başvurusundaki işlem. Desteklenen 'mount' (varsayılan) ve 'download' değerleri. Betiğiniz giriş verileri için belirli bir (örneğin sabit kodlanmış) yol beklediğinde 'indirme' modunu kullanın.
Bu durumda, DataReference'ı bildirirken parametresiyle 'Bağlama' moduyla, bağlı verilerle geçici bir dizin oluşturulur ve geçici dizinin yolu ile $AZUREML_DATAREFERENCE_<data_reference_name> ortam değişkeni ayarlanır. İşlem hattı adımı için bağımsız değişkenler listesine bir DataReference geçirirseniz (örneğin PythonScriptStep), başvuru çalışma zamanında yerel veri yoluna genişletilecektir. |
|
path_on_compute
Gerekli
|
Veri başvurusu için işlem hedefinde yol. |
|
overwrite
Gerekli
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. |
Açıklamalar
DataReference hem veri konumunu hem de verilerin hedef işlem bağlamada (bağlama veya karşıya yükleme) nasıl kullanıldığını tanımlar. Veri deposundaki verilerin yolu kök /, veri deposu içindeki bir dizin veya veri deposundaki bir dosya olabilir.
Yöntemler
| as_download |
İndirmek için veri başvurusu işlemini değiştirin. DataReference indirmesi yalnızca Azure Blob ve Azure Dosya Paylaşımını destekler. Azure Blob, Azure Dosya Paylaşımı, Azure Data Lake 1. Nesil ve Azure Data Lake 2. Nesil'den veri indirmek için Azure Machine Learning Veri Kümesini kullanmanızı öneririz. Veri Kümesi oluşturma ve kullanma hakkında daha fazla bilgi için lütfen adresini ziyaret edin https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
| as_mount |
Veri başvurusu işlemini bağlamaya geçirme. DataReference bağlaması yalnızca Azure Blob'ları destekler. Azure Blob, Azure Dosya Paylaşımı, Azure Data Lake 1. Nesil ve Azure Data Lake 2. Nesil'e veri bağlamak için Azure Machine Learning Veri Kümesini kullanmanızı öneririz. Veri Kümesi oluşturma ve kullanma hakkında daha fazla bilgi için lütfen adresini ziyaret edin https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
| as_upload |
Karşıya yüklemek için veri başvurusu işlemini değiştirin. Hangi işlemlerin ve veri depolarının verilerin karşıya yüklenmesini desteklediği hakkında daha fazla bilgi için bkz. https://aka.ms/datastore-matrix. |
| create |
DataPath ve DataPathComputeBinding kullanarak bir DataReference oluşturun. |
| path |
Verilen yolu temel alan bir DataReference örneği oluşturun. |
| to_config |
DataReference nesnesini DataReferenceConfiguration nesnesine dönüştürün. |
as_download
İndirmek için veri başvurusu işlemini değiştirin.
DataReference indirmesi yalnızca Azure Blob ve Azure Dosya Paylaşımını destekler. Azure Blob, Azure Dosya Paylaşımı, Azure Data Lake 1. Nesil ve Azure Data Lake 2. Nesil'den veri indirmek için Azure Machine Learning Veri Kümesini kullanmanızı öneririz. Veri Kümesi oluşturma ve kullanma hakkında daha fazla bilgi için lütfen adresini ziyaret edin https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_download(path_on_compute=None, overwrite=False)Parametreler
| Name | Description |
|---|---|
|
path_on_compute
|
Veri başvurusu için işlemdeki yol. Default value: None
|
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. Default value: False
|
Döndürülenler
| Tür | Description |
|---|---|
|
Yeni bir veri başvurusu nesnesi. |
as_mount
Veri başvurusu işlemini bağlamaya geçirme.
DataReference bağlaması yalnızca Azure Blob'ları destekler. Azure Blob, Azure Dosya Paylaşımı, Azure Data Lake 1. Nesil ve Azure Data Lake 2. Nesil'e veri bağlamak için Azure Machine Learning Veri Kümesini kullanmanızı öneririz. Veri Kümesi oluşturma ve kullanma hakkında daha fazla bilgi için lütfen adresini ziyaret edin https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_mount()Döndürülenler
| Tür | Description |
|---|---|
|
Yeni bir veri başvurusu nesnesi. |
as_upload
Karşıya yüklemek için veri başvurusu işlemini değiştirin.
Hangi işlemlerin ve veri depolarının verilerin karşıya yüklenmesini desteklediği hakkında daha fazla bilgi için bkz. https://aka.ms/datastore-matrix.
as_upload(path_on_compute=None, overwrite=False)Parametreler
| Name | Description |
|---|---|
|
path_on_compute
|
Veri başvurusu için işlemdeki yol. Default value: None
|
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. Default value: False
|
Döndürülenler
| Tür | Description |
|---|---|
|
Yeni bir veri başvurusu nesnesi. |
create
DataPath ve DataPathComputeBinding kullanarak bir DataReference oluşturun.
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)Parametreler
| Name | Description |
|---|---|
|
data_reference_name
|
Oluşturulacak veri başvurusunun adı. Default value: None
|
|
datapath
|
[Gerekli] Kullanılacak veri yolu. Default value: None
|
|
datapath_compute_binding
|
[Gerekli] Kullanılacak veri yolu işlem bağlaması. Default value: None
|
Döndürülenler
| Tür | Description |
|---|---|
|
DataReference nesnesi. |
path
Verilen yolu temel alan bir DataReference örneği oluşturun.
path(path=None, data_reference_name=None)Parametreler
| Name | Description |
|---|---|
|
path
|
Veri deposundaki yol. Default value: None
|
|
data_reference_name
|
Veri başvurusunun adı. Default value: None
|
Döndürülenler
| Tür | Description |
|---|---|
|
Veri başvuru nesnesi. |
to_config
DataReference nesnesini DataReferenceConfiguration nesnesine dönüştürün.
to_config()Döndürülenler
| Tür | Description |
|---|---|
|
Yeni bir DataReferenceConfiguration nesnesi. |