DataReference Sınıf
Bir 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 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ı verilere erişimi destekler ek veri yönetimi özelliklerine sahip birleşik arabirim aracılığıyla. Makine öğrenmesi projelerinizdeki verileri okumak için veri kümesini kullanmanız önerilir.
İki yaygın senaryoda Azure ML veri kümesini kullanma hakkında daha fazla bilgi için şu makalelere bakın:
Sınıf DataReference oluşturucusu.
- Devralma
-
builtins.objectDataReference
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ı. varsayılan değer: None
|
path_on_datastore
|
Veri başvurusu için yedekleme deposundaki göreli yol. varsayılan değer: None
|
mode
|
Veri başvurusundaki işlem. Desteklenen değerler 'mount' (varsayılan) ve 'download' değerleridir. Betiğiniz giriş verileri için belirli (örneğin sabit kodlanmış) bir yol beklediğinde 'indirme' modunu kullanın.
Bu durumda, DataReference'ı bildirirken parametresiyle 'Bağlama' moduyla, bağlı veriler ile geçici bir dizin oluşturulur ve geçici dizinin yolu ile $AZUREML_DATAREFERENCE_<data_reference_name> bir 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. varsayılan değer: mount
|
path_on_compute
|
Veri başvurusu için işlem hedefi üzerindeki yol. varsayılan değer: None
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. varsayılan değer: 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 deposundaki 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 (örneğin sabit kodlanmış) bir yol beklediğinde 'indirme' modunu kullanın.
Bu durumda, DataReference'ı bildirirken parametresiyle 'Bağlama' moduyla, bağlı veriler ile geçici bir dizin oluşturulur ve geçici dizinin yolu ile $AZUREML_DATAREFERENCE_<data_reference_name> bir 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 hedefi üzerindeki 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 |
veri başvurusu işlemini indirecek şekilde 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ştirme. 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 İçerik Oluşturucu. |
path |
Verilen yola göre bir DataReference örneği İçerik Oluşturucu. |
to_config |
DataReference nesnesini DataReferenceConfiguration nesnesine dönüştürün. |
as_download
veri başvurusu işlemini indirecek şekilde 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. varsayılan değer: None
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. varsayılan değer: 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ştirme.
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. varsayılan değer: None
|
overwrite
|
Varolan verilerin üzerine yazılıp yazılmayacağını gösterir. varsayılan değer: False
|
Döndürülenler
Tür | Description |
---|---|
Yeni bir veri başvurusu nesnesi. |
create
DataPath ve DataPathComputeBinding kullanarak bir DataReference İçerik Oluşturucu.
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)
Parametreler
Name | Description |
---|---|
data_reference_name
|
Oluşturulacak veri başvurusunun adı. varsayılan değer: None
|
datapath
|
[Gerekli] Kullanılacak veri yolu. varsayılan değer: None
|
datapath_compute_binding
|
[Gerekli] Kullanılacak veri yolu işlem bağlaması. varsayılan değer: None
|
Döndürülenler
Tür | Description |
---|---|
DataReference nesnesi. |
path
Verilen yola göre bir DataReference örneği İçerik Oluşturucu.
path(path=None, data_reference_name=None)
Parametreler
Name | Description |
---|---|
path
|
Veri deposundaki yol. varsayılan değer: None
|
data_reference_name
|
Veri başvurusunun adı. varsayılan değer: 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. |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin