AzureFileDatastore 类
表示将连接信息保存到 Azure File 的数据存储。
不应直接使用此类。 若要创建此类型的数据存储,请使用数据存储的 register_azure_file_share 方法。
注意:使用数据存储访问数据时,必须具有访问数据的权限,这取决于在数据存储中注册的凭据。
初始化新的 Azure 文件共享数据存储。
- 继承
-
AzureFileDatastore
构造函数
AzureFileDatastore(workspace, name, container_name, account_name, sas_token=None, account_key=None, protocol=None, endpoint='core.windows.net', request_session=None)
参数
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
用于 http 请求的会话对象。 默认值为 None。
- request_session
- <xref:requests.sessions.Session>, <xref:optional>
用于 http 请求的会话对象。 默认值为 None。
方法
download |
将数据从文件共享下载到本地文件系统。 |
upload |
将数据从本地文件系统上传到该数据存储指向的文件共享。 注意:若要使此方法正常工作,数据存储对象必须填充帐户密钥或 SAS 令牌属性。 如果数据存储对象不包含任何形式的凭据,则此方法将失败。
此外,此方法已弃用,将来可能会删除。 我们建议使用 |
upload_files |
将数据从本地文件系统上传到该数据存储指向的文件共享。 注意:此方法已弃用,将不再受支持。 建议改用 |
download
将数据从文件共享下载到本地文件系统。
download(target_path, prefix=None, overwrite=False, show_progress=True)
参数
返回
成功下载的文件数。
返回类型
upload
将数据从本地文件系统上传到该数据存储指向的文件共享。
注意:若要使此方法正常工作,数据存储对象必须填充帐户密钥或 SAS 令牌属性。 如果数据存储对象不包含任何形式的凭据,则此方法将失败。
此外,此方法已弃用,将来可能会删除。 我们建议使用 Dataset.File.upload_directory
方法从本地目录上传文件,在单个方法调用中创建 FileDataset。
upload(src_dir, target_path=None, overwrite=False, show_progress=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,它将查找公共路径。
返回
上传的目标路径的 DataReference 实例。
返回类型
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈