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 az adatkézbesítéshez. Az adatkészlet az Azure Blob Storage, az Azure Files, az Azure Data Lake Storage Gen1, az Azure Data Lake Storage Gen2, az Azure SQL Database és az Azure Database for PostgreSQL adatainak elérését támogatja a hozzáadott adatkezelési képességekkel rendelkező egységes felületen keresztül. Javasoljuk, hogy adathalmazt 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 további információt a következő cikkekben talál:
Class DataReference konstruktor.
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
|
Az adathivatkozáson lévő művelet. A támogatott értékek a "csatlakoztatás" (alapértelmezett) és a "letöltés". Akkor használja a "letöltési" módot, ha a szkript a bemeneti adatok meghatározott (pl. hard-coded) elérési útját várja.
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 függvényt, 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ő
|
Az adathivatkozáson lévő művelet. Támogatott értékek : "csatlakoztatás" (alapértelmezett) és "letöltés". Akkor használja a "letöltési" módot, ha a szkript a bemeneti adatok meghatározott (pl. hard-coded) elérési útját várja.
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 függvényt, 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 adathelyet é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 /, az adattár könyvtára vagy az adattárban lévő fájl.
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. Az Azure Blobból, az Azure File Shareből, az Azure Data Lake Gen1-ből és az Azure Data Lake Gen2-ből való adatok letöltéséhez javasoljuk az Azure Machine Learning Dataset használatát. Az adatkészlet létrehozásáról és használatáról további információt a következő webhelyen talál https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets: |
| as_mount |
Kapcsolja be az adathivatkozási műveletet a csatlakoztatáshoz. A DataReference csatlakoztatása csak az Azure Blob használatát 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áról és használatáról további információt a következő webhelyen talál 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. Az Azure Blobból, az Azure File Shareből, az Azure Data Lake Gen1-ből és az Azure Data Lake Gen2-ből való adatok letöltéséhez javasoljuk az Azure Machine Learning Dataset használatát. Az adatkészlet létrehozásáról és használatáról további információt a következő webhelyen talál 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
Kapcsolja be az adathivatkozási műveletet a csatlakoztatáshoz.
A DataReference csatlakoztatása csak az Azure Blob használatát 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áról és használatáról további információt a következő webhelyen talál 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
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
| 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
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
| 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. |