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ők 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
- datastore
- Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]
A hivatkozni kívánt adattár.
- path_on_datastore
- str
A háttértár relatív elérési útja az adathivatkozáshoz.
- mode
- str
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 adatok meghatározott (például hard-coded) elérési útját várja.
Ebben az esetben a DataReference deklarálásakor adja meg a path_on_compute paraméter elérési útját.
Az Azure Machine Learning letölti az elérési út által megadott adatokat a szkript végrehajtása előtt.
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.
- datastore
- Union[AbstractAzureStorageDatastore, AzureDataLakeDatastore]
A hivatkozni kívánt adattár.
- mode
- str
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 adatok meghatározott (például hard-coded) elérési útját várja.
Ebben az esetben a DataReference deklarálásakor adja meg a path_on_compute paraméter elérési útját.
Az Azure Machine Learning letölti az elérési út által megadott adatokat a szkript végrehajtása előtt.
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.
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 |
DataReference létrehozása a DataPath és a DataPathComputeBinding használatával. |
| path |
Hozzon létre 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
Válaszok
Új adathivatkozási objektum.
Visszatérési típus
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
Új adathivatkozási objektum.
Visszatérési típus
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
Válaszok
Új adathivatkozási objektum.
Visszatérési típus
create
DataReference létrehozása a DataPath és a DataPathComputeBinding használatával.
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)Paraméterek
- datapath_compute_binding
- DataPathComputeBinding
[Kötelező] A használni kívánt datapath számítási kötés.
Válaszok
DataReference objektum.
Visszatérési típus
path
Hozzon létre egy DataReference-példányt a megadott elérési út alapján.
path(path=None, data_reference_name=None)Paraméterek
Válaszok
Az adathivatkozási objektum.
Visszatérési típus
to_config
Konvertálja a DataReference objektumot DataReferenceConfiguration objektummá.
to_config()Válaszok
Egy új DataReferenceConfiguration objektum.
Visszatérési típus
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: