DataReference Klasa
Reprezentuje odwołanie do danych w magazynie danych.
Funkcja DataReference reprezentuje ścieżkę w magazynie danych i może służyć do opisania sposobu i miejsca udostępniania danych w przebiegu. Nie jest to już zalecane podejście do uzyskiwania dostępu do danych i dostarczania ich w usłudze Azure Machine Learning. Zestaw danych obsługuje dostęp do danych z usługi Azure Blob Storage, Azure Files, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2, Azure SQL Database i Azure Database for PostgreSQL dzięki ujednoliconemu interfejsowi z dodanymi możliwościami zarządzania danymi. Zaleca się używanie zestawu danych do odczytywania danych w projektach uczenia maszynowego.
Aby uzyskać więcej informacji na temat korzystania z zestawu danych usługi Azure ML w dwóch typowych scenariuszach, zobacz artykuły:
Konstruktor Klasy DataReference.
- Dziedziczenie
-
builtins.objectDataReference
Konstruktor
DataReference(datastore, data_reference_name=None, path_on_datastore=None, mode='mount', path_on_compute=None, overwrite=False)
Parametry
Nazwa | Opis |
---|---|
datastore
Wymagane
|
Magazyn danych do odwołania. |
data_reference_name
|
Nazwa odwołania do danych. Domyślna wartość: None
|
path_on_datastore
|
Ścieżka względna w magazynie zaplecza dla odwołania do danych. Domyślna wartość: None
|
mode
|
Operacja na odwołaniu do danych. Obsługiwane wartości to "mount" (wartość domyślna) i "download". Użyj trybu pobierania, gdy skrypt oczekuje określonej ścieżki (np. zakodowanej na stałe) dla danych wejściowych.
W takim przypadku określ ścieżkę z parametrem W trybie instalacji katalog tymczasowy jest tworzony z zainstalowanymi danymi i zmienną środowiskową $AZUREML_DATAREFERENCE_<data_reference_name> jest ustawiana ze ścieżką do katalogu tymczasowego. Jeśli przekażesz element DataReference do listy argumentów dla kroku potoku (np. PythonScriptStep), odwołanie zostanie rozwinięte do lokalnej ścieżki danych w czasie wykonywania. Domyślna wartość: mount
|
path_on_compute
|
Ścieżka docelowa zasobów obliczeniowych dla odwołania do danych. Domyślna wartość: None
|
overwrite
|
Wskazuje, czy zastąpić istniejące dane. Domyślna wartość: False
|
datastore
Wymagane
|
Magazyn danych do odwołania. |
data_reference_name
Wymagane
|
Nazwa odwołania do danych. |
path_on_datastore
Wymagane
|
Ścieżka względna w magazynie zaplecza dla odwołania do danych. |
mode
Wymagane
|
Operacja na odwołaniu do danych. Obsługiwane wartości "mount" (wartość domyślna) i "download". Użyj trybu pobierania, gdy skrypt oczekuje określonej ścieżki (np. zakodowanej na stałe) dla danych wejściowych.
W takim przypadku określ ścieżkę z parametrem W trybie instalacji katalog tymczasowy jest tworzony z zainstalowanymi danymi i zmienną środowiskową $AZUREML_DATAREFERENCE_<data_reference_name> jest ustawiana ze ścieżką do katalogu tymczasowego. Jeśli przekażesz element DataReference do listy argumentów dla kroku potoku (np. PythonScriptStep), odwołanie zostanie rozwinięte do lokalnej ścieżki danych w czasie wykonywania. |
path_on_compute
Wymagane
|
Ścieżka docelowa zasobów obliczeniowych dla odwołania do danych. |
overwrite
Wymagane
|
Wskazuje, czy zastąpić istniejące dane. |
Uwagi
Funkcja DataReference definiuje zarówno lokalizację danych, jak i sposób użycia danych w docelowym powiązaniu obliczeniowym (instalowanie lub przekazywanie). Ścieżka do danych w magazynie danych może być katalogiem głównym /, katalogiem w magazynie danych lub plikiem w magazynie danych.
Metody
as_download |
Przełącz operację odwołania do danych, aby pobrać. Pobieranie danychReference obsługuje tylko obiekty blob platformy Azure i udział plików platformy Azure. Aby pobrać dane z usługi Azure Blob, udział plików platformy Azure, usługę Azure Data Lake Gen1 i usługę Azure Data Lake Gen2, zalecamy użycie zestawu danych usługi Azure Machine Learning. Aby uzyskać więcej informacji na temat tworzenia i używania zestawu danych, odwiedź stronę https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
as_mount |
Przełącz operację odwołania do danych, aby zainstalować. Instalacja dataReference obsługuje tylko obiekt blob platformy Azure. Aby zainstalować dane w usłudze Azure Blob, udziale plików platformy Azure, usłudze Azure Data Lake Gen1 i usłudze Azure Data Lake Gen2, zalecamy użycie zestawu danych usługi Azure Machine Learning. Aby uzyskać więcej informacji na temat tworzenia i używania zestawu danych, odwiedź stronę https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets. |
as_upload |
Przełącz operację odwołania do danych w celu przekazania. Aby uzyskać więcej informacji o tym, które obliczenia i magazyny danych obsługują przekazywanie danych, zobacz: https://aka.ms/datastore-matrix. |
create |
Twórca dataReference przy użyciu metod DataPath i DataPathComputeBinding. |
path |
Twórca wystąpienia DataReference na podstawie podanej ścieżki. |
to_config |
Przekonwertuj obiekt DataReference na obiekt DataReferenceConfiguration. |
as_download
Przełącz operację odwołania do danych, aby pobrać.
Pobieranie danychReference obsługuje tylko obiekty blob platformy Azure i udział plików platformy Azure. Aby pobrać dane z usługi Azure Blob, udział plików platformy Azure, usługę Azure Data Lake Gen1 i usługę Azure Data Lake Gen2, zalecamy użycie zestawu danych usługi Azure Machine Learning. Aby uzyskać więcej informacji na temat tworzenia i używania zestawu danych, odwiedź stronę https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_download(path_on_compute=None, overwrite=False)
Parametry
Nazwa | Opis |
---|---|
path_on_compute
|
Ścieżka obliczeniowa dla odwołania do danych. Domyślna wartość: None
|
overwrite
|
Wskazuje, czy zastąpić istniejące dane. Domyślna wartość: False
|
Zwraca
Typ | Opis |
---|---|
Nowy obiekt odwołania do danych. |
as_mount
Przełącz operację odwołania do danych, aby zainstalować.
Instalacja dataReference obsługuje tylko obiekt blob platformy Azure. Aby zainstalować dane w usłudze Azure Blob, udziale plików platformy Azure, usłudze Azure Data Lake Gen1 i usłudze Azure Data Lake Gen2, zalecamy użycie zestawu danych usługi Azure Machine Learning. Aby uzyskać więcej informacji na temat tworzenia i używania zestawu danych, odwiedź stronę https://docs.microsoft.com/en-us/azure/machine-learning/how-to-train-with-datasets.
as_mount()
Zwraca
Typ | Opis |
---|---|
Nowy obiekt odwołania do danych. |
as_upload
Przełącz operację odwołania do danych w celu przekazania.
Aby uzyskać więcej informacji o tym, które obliczenia i magazyny danych obsługują przekazywanie danych, zobacz: https://aka.ms/datastore-matrix.
as_upload(path_on_compute=None, overwrite=False)
Parametry
Nazwa | Opis |
---|---|
path_on_compute
|
Ścieżka obliczeniowa dla odwołania do danych. Domyślna wartość: None
|
overwrite
|
Wskazuje, czy zastąpić istniejące dane. Domyślna wartość: False
|
Zwraca
Typ | Opis |
---|---|
Nowy obiekt odwołania do danych. |
create
Twórca dataReference przy użyciu metod DataPath i DataPathComputeBinding.
static create(data_reference_name=None, datapath=None, datapath_compute_binding=None)
Parametry
Nazwa | Opis |
---|---|
data_reference_name
|
Nazwa odwołania do danych do utworzenia. Domyślna wartość: None
|
datapath
|
[Wymagane] Ścieżka danych do użycia. Domyślna wartość: None
|
datapath_compute_binding
|
[Wymagane] Powiązanie obliczeniowe ścieżki danych do użycia. Domyślna wartość: None
|
Zwraca
Typ | Opis |
---|---|
Obiekt DataReference. |
path
Twórca wystąpienia DataReference na podstawie podanej ścieżki.
path(path=None, data_reference_name=None)
Parametry
Nazwa | Opis |
---|---|
path
|
Ścieżka w magazynie danych. Domyślna wartość: None
|
data_reference_name
|
Nazwa odwołania do danych. Domyślna wartość: None
|
Zwraca
Typ | Opis |
---|---|
Obiekt odwołania do danych. |
to_config
Przekonwertuj obiekt DataReference na obiekt DataReferenceConfiguration.
to_config()
Zwraca
Typ | Opis |
---|---|
Nowy obiekt DataReferenceConfiguration. |