AzureFileDatastore Klasa
Reprezentuje magazyn danych, który zapisuje informacje o połączeniu w usłudze Azure File Storage.
Nie należy bezpośrednio pracować z tą klasą. Aby utworzyć magazyn danych tego typu, użyj register_azure_file_share metody magazynu danych.
Uwaga: w przypadku uzyskiwania dostępu do danych przy użyciu magazynu danych musisz mieć uprawnienia dostępu do tych danych, co zależy od poświadczeń zarejestrowanych w magazynie danych.
Zainicjuj nowy magazyn danych udziału plików platformy Azure.
- Dziedziczenie
-
AzureFileDatastore
Konstruktor
AzureFileDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint='core.windows.net', request_session=None)Parametry
- sas_token
- str, <xref:optional>
Token SYGNATURy dostępu współdzielonego na potrzeby uzyskiwania dostępu do tego kontenera. Wartość domyślna to Brak.
- account_key
- str, <xref:optional>
Klucz konta magazynu. Wartość domyślna to Brak.
- protocol
- str, <xref:optional>
Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.
- endpoint
- str, <xref:optional>
Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
Obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to Brak.
- sas_token
- str, <xref:optional>
Token SYGNATURy dostępu współdzielonego na potrzeby uzyskiwania dostępu do tego kontenera. Wartość domyślna to Brak.
- protocol
- str, <xref:optional>
Protokół używany do nawiązywania połączenia z kontem magazynu. Jeśli brak, wartość domyślna to https.
- endpoint
- str, <xref:optional>
Punkt końcowy kontenera obiektów blob. Jeśli brak, wartość domyślna to core.windows.net.
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
Obiekt sesji do użycia dla żądań HTTP. Wartość domyślna to Brak.
Metody
| download |
Pobierz dane z udziału plików do lokalnego systemu plików. |
| upload |
Przekaż dane z lokalnego systemu plików do udziału plików, do którego wskazuje ten magazyn danych. Uwaga: aby ta metoda działała, obiekt magazynu danych musi mieć wypełniony klucz konta lub właściwość tokenu SAS. Jeśli obiekt magazynu danych nie zawiera żadnej formy poświadczeń, ta metoda zakończy się niepowodzeniem.
Ponadto ta metoda została wycofana, może zostać usunięta w przyszłości. Zalecamy użycie |
| upload_files |
Przekaż dane z lokalnego systemu plików do udziału plików, do którego wskazuje ten magazyn danych. Uwaga: ta metoda jest przestarzała i nie będzie już obsługiwana. Zaleca się zamiast tego użycie |
download
Pobierz dane z udziału plików do lokalnego systemu plików.
download(target_path, prefix=None, overwrite=False, show_progress=True)Parametry
- prefix
- str, <xref:optional>
Ścieżka do folderu w udziale plików do pobrania. Jeśli zostanie ustawiona wartość Brak, usługa Azure Machine Learning pobierze wszystko w udziale plików.
- show_progress
- bool, <xref:optional>
Wskazuje, czy ma być wyświetlany postęp pobierania w konsoli programu .
Zwraca
Liczba pomyślnie pobranych plików.
Typ zwracany
upload
Przekaż dane z lokalnego systemu plików do udziału plików, do którego wskazuje ten magazyn danych.
Uwaga: aby ta metoda działała, obiekt magazynu danych musi mieć wypełniony klucz konta lub właściwość tokenu SAS. Jeśli obiekt magazynu danych nie zawiera żadnej formy poświadczeń, ta metoda zakończy się niepowodzeniem.
Ponadto ta metoda została wycofana, może zostać usunięta w przyszłości. Zalecamy użycie Dataset.File.upload_directory metody do przekazania plików z katalogu lokalnego i utworzenia elementu FileDataset w jednym wywołaniu metody.
upload(src_dir, target_path=None, overwrite=False, show_progress=True)Parametry
- target_path
- str
Lokalizacja w udziale plików do przekazania. Jeśli brak, przekaż do katalogu głównego.
- show_progress
- bool, <xref:optional>
Wskazuje, czy ma być wyświetlany postęp przekazywania w konsoli programu .
Zwraca
Wystąpienie DataReference dla przekazanej ścieżki docelowej.
Typ zwracany
upload_files
Przekaż dane z lokalnego systemu plików do udziału plików, do którego wskazuje ten magazyn danych.
Uwaga: ta metoda jest przestarzała i nie będzie już obsługiwana. Zaleca się zamiast tego użycie FileDatasetFactory.upload_directory .
upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)Parametry
- relative_root
- str, <xref:optional>
Ścieżka podstawowa używana do określania ścieżki plików w udziale plików. Jeśli na przykład przekażesz /path/to/file.txt i zdefiniujesz ścieżkę podstawową jako /path, po przekazaniu file.txt do udziału plików będzie miała ścieżkę /to/file.txt. Jeśli target_path zostanie również określony, będzie on używany jako prefiks dla ścieżki pochodnej z powyższego. Ścieżka podstawowa musi być wspólną ścieżką wszystkich plików. W przeciwnym razie zostanie zgłoszony wyjątek. Wartość domyślna to Brak, która będzie znajdować wspólną ścieżkę.
- target_path
- str, <xref:optional>
Lokalizacja w udziale plików, do której mają być przekazywane dane. Wartość domyślna to Brak, katalog główny.
- show_progress
- bool, <xref:optional>
Wskazuje, czy ma być wyświetlany postęp przekazywania w konsoli programu .
Zwraca
Wystąpienie DataReference dla przekazanej ścieżki docelowej.
Typ zwracany
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla