DataReference Osztály
Egy adattár adataira mutató hivatkozást jelöl.
A DataReference egy adattár elérési útját jelöli, és annak leírására használható, hogy az adatok hogyan és hol legyenek elérhetővé egy futtatás során. Az Azure Machine Learningben már nem ez a javasolt módszer az adathozzáféréshez és -kézbesítéshez. Az adatkészlet támogatja az adatok elérését az Azure Blob Storage, Azure Files, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Azure SQL Database és Azure Database for PostgreSQL a hozzáadott adatkezelési képességekkel rendelkező egyesített felületen keresztül. Javasoljuk, hogy adatkészletet használjon a gépi tanulási projektek adatainak olvasásához.
Az Azure ML-adatkészlet két gyakori forgatókönyvben való használatáról a következő cikkekben talál további információt:
Class DataReference konstruktor.
- Öröklődés
-
builtins.objectDataReference
Konstruktor
DataReference(datastore, data_reference_name=None, path_on_datastore=None, mode='mount', path_on_compute=None, overwrite=False)
Paraméterek
Name | Description |
---|---|
datastore
Kötelező
|
A hivatkozni kívánt adattár. |
data_reference_name
|
Az adathivatkozás neve. Alapértelmezett érték: None
|
path_on_datastore
|
A háttértár relatív elérési útja az adathivatkozáshoz. Alapértelmezett érték: None
|
mode
|
A művelet az adathivatkozáson. A támogatott értékek a "mount" (alapértelmezett) és a "download" (letöltés). Akkor használja a "letöltési" módot, ha a szkript a bemeneti adatokhoz egy adott (például hard-coded) elérési utat vár.
Ebben az esetben a DataReference deklarálásakor adja meg a A csatlakoztatási móddal létrejön egy ideiglenes könyvtár a csatlakoztatott adatokkal, a $AZUREML_DATAREFERENCE_<data_reference_name> környezeti változó pedig az ideiglenes könyvtár elérési útjával van beállítva. Ha egy folyamatlépés (például PythonScriptStep) argumentumlistájába ad át egy DataReference értéket, akkor a hivatkozás futásidőben ki lesz bontva a helyi adatútvonalra. Alapértelmezett érték: mount
|
path_on_compute
|
Az adathivatkozás számítási céljának elérési útja. Alapértelmezett érték: None
|
overwrite
|
Azt jelzi, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: False
|
datastore
Kötelező
|
A hivatkozni kívánt adattár. |
data_reference_name
Kötelező
|
Az adathivatkozás neve. |
path_on_datastore
Kötelező
|
A háttértár relatív elérési útja az adathivatkozáshoz. |
mode
Kötelező
|
A művelet az adathivatkozáson. Támogatott értékek: "mount" (alapértelmezett) és "download". Akkor használja a "letöltési" módot, ha a szkript a bemeneti adatokhoz egy adott (például hard-coded) elérési utat vár.
Ebben az esetben a DataReference deklarálásakor adja meg a A csatlakoztatási móddal létrejön egy ideiglenes könyvtár a csatlakoztatott adatokkal, a $AZUREML_DATAREFERENCE_<data_reference_name> környezeti változó pedig az ideiglenes könyvtár elérési útjával van beállítva. Ha egy folyamatlépés (például PythonScriptStep) argumentumlistájába ad át egy DataReference értéket, akkor a hivatkozás futásidőben ki lesz bontva a helyi adatútvonalra. |
path_on_compute
Kötelező
|
Az adathivatkozás számítási céljának elérési útja. |
overwrite
Kötelező
|
Azt jelzi, hogy felülírja-e a meglévő adatokat. |
Megjegyzések
A DataReference meghatározza az adat helyét és az adatok felhasználási módját a cél számítási kötésben (csatlakoztatás vagy feltöltés). Az adattárban lévő adatok elérési útja lehet a gyökér /, egy könyvtár az adattárban, vagy egy fájl az adattárban.
Metódusok
as_download |
Adathivatkozási művelet váltása letöltésre. A DataReference letöltése csak az Azure Blob és az Azure File Share használatát támogatja. Ha adatokat szeretne letölteni az Azure Blobból, az Azure File Share-ből, az Azure Data Lake Gen1-ből és az Azure Data Lake Gen2-ből, javasoljuk az Azure Machine Learning Dataset használatát. Az Adatkészlet létrehozásával és használatával kapcsolatos további információkért látogasson el a webhelyre https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
as_mount |
Állítsa az adathivatkozási műveletet csatlakoztatásra. A DataReference csatlakoztatása csak az Azure Blobot támogatja. Az Azure Blobban, az Azure File Share-ben, az Azure Data Lake Gen1-ben és az Azure Data Lake Gen2-ben való csatlakoztatáshoz javasoljuk az Azure Machine Learning-adatkészlet használatát. Az Adatkészlet létrehozásával és használatával kapcsolatos további információkért látogasson el a webhelyre https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
as_upload |
Adathivatkozási művelet váltása feltöltésre. További információ arról, hogy mely számítások és adattárak támogatják az adatok feltöltését: https://aka.ms/datastore-matrix. |
create |
Létrehozás dataReference-t a DataPath és a DataPathComputeBinding használatával. |
path |
Létrehozás egy DataReference-példányt a megadott elérési út alapján. |
to_config |
Konvertálja a DataReference objektumot DataReferenceConfiguration objektummá. |
as_download
Adathivatkozási művelet váltása letöltésre.
A DataReference letöltése csak az Azure Blob és az Azure File Share használatát támogatja. Ha adatokat szeretne letölteni az Azure Blobból, az Azure File Share-ből, az Azure Data Lake Gen1-ből és az Azure Data Lake Gen2-ből, javasoljuk az Azure Machine Learning Dataset használatát. Az Adatkészlet létrehozásával és használatával kapcsolatos további információkért látogasson el a webhelyre https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_download(path_on_compute=None, overwrite=False)
Paraméterek
Name | Description |
---|---|
path_on_compute
|
Az adathivatkozás számítási útvonala. Alapértelmezett érték: None
|
overwrite
|
Azt jelzi, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: False
|
Válaszok
Típus | Description |
---|---|
Új adathivatkozási objektum. |
as_mount
Állítsa az adathivatkozási műveletet csatlakoztatásra.
A DataReference csatlakoztatása csak az Azure Blobot támogatja. Az Azure Blobban, az Azure File Share-ben, az Azure Data Lake Gen1-ben és az Azure Data Lake Gen2-ben való csatlakoztatáshoz javasoljuk az Azure Machine Learning-adatkészlet használatát. Az Adatkészlet létrehozásával és használatával kapcsolatos további információkért látogasson el a webhelyre https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_mount()
Válaszok
Típus | Description |
---|---|
Új adathivatkozási objektum. |
as_upload
Adathivatkozási művelet váltása feltöltésre.
További információ arról, hogy mely számítások és adattárak támogatják az adatok feltöltését: https://aka.ms/datastore-matrix.
as_upload(path_on_compute=None, overwrite=False)
Paraméterek
Name | Description |
---|---|
path_on_compute
|
Az adathivatkozás számítási útvonala. Alapértelmezett érték: None
|
overwrite
|
Azt jelzi, hogy felülírja-e a meglévő adatokat. Alapértelmezett érték: False
|
Válaszok
Típus | Description |
---|---|
Új adathivatkozási objektum. |
create
Létrehozás dataReference-t a DataPath és a DataPathComputeBinding használatával.
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)
Paraméterek
Name | Description |
---|---|
data_reference_name
|
A létrehozandó adathivatkozás neve. Alapértelmezett érték: None
|
datapath
|
[Kötelező] A használni kívánt adatútvonal. Alapértelmezett érték: None
|
datapath_compute_binding
|
[Kötelező] A használni kívánt datapath számítási kötés. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
DataReference objektum. |
path
Létrehozás egy DataReference-példányt a megadott elérési út alapján.
path(path=None, data_reference_name=None)
Paraméterek
Name | Description |
---|---|
path
|
Az adattár elérési útja. Alapértelmezett érték: None
|
data_reference_name
|
Az adathivatkozás neve. Alapértelmezett érték: None
|
Válaszok
Típus | Description |
---|---|
Az adathivatkozási objektum. |
to_config
Konvertálja a DataReference objektumot DataReferenceConfiguration objektummá.
to_config()
Válaszok
Típus | Description |
---|---|
Egy új DataReferenceConfiguration objektum. |