AzureBlobDatastore Класс
Представляет хранилище данных, в котором содержатся сведения о подключении к хранилищу больших двоичных объектов Azure.
Не следует работать с этим классом напрямую. Чтобы создать хранилище данных этого типа, используйте метод register_azure_blob_container.
Примечание. Для доступа к данным с использованием хранилища необходимо соответствующее разрешение, которое зависит от учетных данных, зарегистрированных в этом хранилище.
Инициализируйте новое хранилище данных BLOB-объектов Azure.
- Наследование
-
AzureBlobDatastore
Конструктор
AzureBlobDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint=None, request_session=None, workspace_msi_has_access=False, subscription_id=None, resource_group=None, service_data_access_auth_identity=None)
Параметры
- name
- str
Имя хранилища данных. Этот параметр может содержать только буквы и символы "-" и "_".
- sas_token
- str, <xref:optional>
Маркер SAS для доступа к этому контейнеру. Значение по умолчанию — None.
- account_key
- str, <xref:optional>
Ключ учетной записи хранения. Значение по умолчанию — None.
- protocol
- str, <xref:optional>
Протокол, который используется для подключения к учетной записи хранения. При значении None по умолчанию используется HTTPS.
- endpoint
- str, <xref:optional>
Конечная точка контейнера больших двоичных объектов. При значении None по умолчанию используется core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
Объект сеанса, который используется для HTTP-запросов. Значение по умолчанию — None.
- name
- str
Имя хранилища данных. Этот параметр может содержать только буквы и символы "-" и "_".
- sas_token
- str, <xref:optional>
Маркер SAS для доступа к этому контейнеру. Значение по умолчанию — None.
- account_key
- str, <xref:optional>
Ключ учетной записи хранения. Значение по умолчанию — None.
- protocol
- str, <xref:optional>
Протокол, который используется для подключения к учетной записи хранения. При значении None по умолчанию используется HTTPS.
- endpoint
- str, <xref:optional>
Конечная точка контейнера больших двоичных объектов. При значении None по умолчанию используется core.windows.net.
- request_session
- <xref:requests.Session>, <xref:optional>
Объект сеанса, который используется для HTTP-запросов. Значение по умолчанию — None (Нет).
- workspace_msi_has_access
- bool, <xref:optional>
Указывает, имеет ли MSI рабочей области доступ к этой учетной записи хранения. (Не рекомендуется)
- subscription_id
- str, <xref:optional>
Идентификатор подписки учетной записи хранения.
- resource_group
- str, <xref:optional>
Группа ресурсов учетной записи хранения.
- service_data_access_auth_identity
- str или <xref:_restclient.models.ServiceDataAccessAuthIdentity>
Указывает, какое удостоверение следует использовать для проверки подлинности доступа к данным службы к хранилищу клиента. Возможные значения: "None", "WorkspaceSystemAssignedIdentity", "WorkspaceUserAssignedIdentity"
Методы
download |
Загрузка данных из контейнера больших двоичных объектов в локальную файловую систему. |
upload |
Отправка данных из локальной файловой системы в контейнер больших двоичных объектов, на который ссылается хранилище данных. Примечание. Чтобы этот метод работал, для объекта хранилища данных должен быть указан ключ учетной записи или свойство маркера SAS. Если объект хранилища данных не содержит ни одной из форм учетной записи, этот метод завершится ошибкой.
Более того, этот метод не рекомендуется и может быть удален в будущем. Чтобы отправить файлы в локальный каталог и создать класс FileDataset одним вызовом, мы рекомендуем использовать метод |
upload_files |
Отправка данных из локальной файловой системы в контейнер больших двоичных объектов, на который ссылается хранилище данных. Примечание. Это устаревший метод, который больше не будет поддерживаться. Вместо него рекомендуется использовать |
download
Загрузка данных из контейнера больших двоичных объектов в локальную файловую систему.
download(target_path, prefix=None, overwrite=False, show_progress=True)
Параметры
- prefix
- str, <xref:optional>
Путь к папке в контейнере больших двоичных объектов, куда загружаются файлы. Если задано значение None, все скачиваемые данные размещаются в большом двоичном объекте. Значение по умолчанию — None.
- overwrite
- bool, <xref:optional>
Указывает, следует ли перезаписывать существующие файлы. Значение по умолчанию — False.
- show_progress
- bool, <xref:optional>
Указывает, демонстрировать ли в консоли ход загрузки. Значение по умолчанию — True.
Возвращаемое значение
Количество загруженных файлов.
Возвращаемый тип
upload
Отправка данных из локальной файловой системы в контейнер больших двоичных объектов, на который ссылается хранилище данных.
Примечание. Чтобы этот метод работал, для объекта хранилища данных должен быть указан ключ учетной записи или свойство маркера SAS. Если объект хранилища данных не содержит ни одной из форм учетной записи, этот метод завершится ошибкой.
Более того, этот метод не рекомендуется и может быть удален в будущем. Чтобы отправить файлы в локальный каталог и создать класс FileDataset одним вызовом, мы рекомендуем использовать метод Dataset.File.upload_directory
.
upload(src_dir, target_path=None, overwrite=False, show_progress=True)
Параметры
- target_path
- str
Расположение в контейнере больших двоичных объектов, куда отправляются файлы. Если указано значение None, данные отправляются в корневую папку. Значение по умолчанию — None.
- overwrite
- bool, <xref:optional>
Указывает, следует ли перезаписывать существующие файлы. Значение по умолчанию — False.
- show_progress
- bool, <xref:optional>
Указывает, демонстрировать ли в консоли ход отправки. Значение по умолчанию — True.
Возвращаемое значение
Экземпляр DataReference целевого пути, по которому выполнялась отправка.
Возвращаемый тип
upload_files
Отправка данных из локальной файловой системы в контейнер больших двоичных объектов, на который ссылается хранилище данных.
Примечание. Это устаревший метод, который больше не будет поддерживаться. Вместо него рекомендуется использовать FileDatasetFactory.upload_directory
.
upload_files(files, relative_root=None, target_path=None, overwrite=False, show_progress=True)
Параметры
- relative_root
- str, <xref:optional>
Корень, используемый для определения пути к файлам в большом двоичном объекте. Например, если мы отправляем файл /path/to/file.txt и определяем базовый путь как /path, когда файл file.txt отправляется в хранилище больших двоичный объектов, у него будет путь /to/file.txt. Если также указан параметр target_path, он будет использоваться как префикс для производного пути выше. Базовый путь должен представлять собой общий путь ко всем файлам, в противном случае вызывается исключение. Значение по умолчанию — None (общий путь находится автоматически).
- target_path
- str, <xref:optional>
Расположение в контейнере больших двоичных объектов для отправки данных. Значение по умолчанию — None (корень).
- overwrite
- bool, <xref:optional>
Указывает, следует ли перезаписывать существующие файлы. Значение по умолчанию — False.
- show_progress
- bool, <xref:optional>
Указывает, демонстрировать ли в консоли ход отправки. Значение по умолчанию — True.
Возвращаемое значение
Экземпляр DataReference целевого пути, по которому выполнялась отправка.
Возвращаемый тип
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по