AzureFileStorageConnector
访问Azure文件存储文件存储服务以从Azure帐户上传,下载或删除文件和文件夹或列表文件/文件夹信息。
Typical Uses
- 通过上传,下载和删除文件和文件夹来管理文件存储上的数据集
- 将文件的内容(例如XML或栅格)传输到FME中的属性中
- 使用读取下载的文件存储数据FeatureReader或上传由featurewriter.文件存储
- 从文件存储中检索文件和文件夹名称,路径,链接和其他信息以在工作区中的其他位置使用。
它是如何工作的?
AzureFileStorageConnector使用Azure存储帐户凭据(通过先前定义的FME Web连接,或通过从变压器设置新的FME Web连接)来访问文件存储服务。
根据您的选择,它将上传或下载文件,文件夹和属性;列出服务的信息;或从服务中删除项目。在上传时,可以将链接属性添加到输出功能。在列表操作上,文件/文件夹信息作为属性添加。
例子
In this example, the AzureFileStorageConnector is used to download an Esri Geodatabase from File Storage. After creating a valid web connection to an Azure Storage account (which can be done right in the Account parameter), and browsing to the geodatabase folder, the Share and Path to the object are retrieved, and a destination for the download is selected.
AFeatureReaderis added to read the newly downloaded dataset. Here, the PostalAddress feature type will be further processed elsewhere in the workspace.
通过在工作区中执行下载,每次运行工作空间时都会刷新地理数据库。
在该工作空间的此示例部分中,AzureFileStorageConnector用于将栅格OrthoImage从文件存储下载到属性中。
该文件从文件存储中读取,并将内容存储为Blob属性。然后一个RasterReplaceris used to interpret the blob into a usable raster format.
这两个变换器的组合避免了必须将图像下载到本地存储并重新读取它。一种类似的技术可以用于点云文件,使用pointcloudreplacer.变压器。
使用说明
- 此变换器不能用于直接移动或复制不同天蓝色存储位置之间的文件。但是,多个AzureFiLestorAgeConnectors可用于使用中间下载移动或复制文件。
- TheFeatureReader可以直接访问Azure文件存储,而无需使用AzureFilestorAgeConnector。在这种情况下,不会创建数据集的永久本地副本。
配置
输入Ports
此变形器接受任何功能。
输出端口
The output of this transformer will vary depending on the action performed.
- After an上传操作,有关该文件的选定信息将可用作属性。
- ADownload操作将输出传入功能,可以保存到文件,文件夹或属性。
- A删除action will output the incoming feature.
- AList操作将为指定路径中的每个文件/文件夹输出新功能。这些新功能中的每一个都将具有列出有关对象的各种信息的属性。
The incoming feature is output through this port.
导致操作失败操作的功能将通过此端口输出。一个fme_reimpe_code.attribute, having the valueERROR_DURING_PROCESSING,将添加,以及更具描述性的fme_rejection_message属性包含更具体的细节,以及失败的原因。
Note: ">Note:如果一个功能进入AzureFileStorageConnector已经具有值fme_reimpe_code., this value will be removed.
拒绝功能处理:可以设置为终止翻译或在遇到被拒绝的功能时继续运行。此设置可用作默认设置FME option和A.工作区参数。
Parameters
凭证来源 | AzureFileStorageConnector可以使用来自不同来源的凭据。使用Web连接最佳FME,但在某些情况下,您可能希望使用其中一个来源。
|
帐户 | Available when the credential source is网页Connection。要创建Azure存储连接,请单击“帐户”下拉框,然后选择“添加Web连接...”。 然后可以通过工具 - > FME选项... - > Web连接来管理连接。 |
帐户Name and Account Key | Available when the credential source isEmbedded。可以直接在变压器中而不是在Web连接中指定帐户名称和访问密钥。 |
帐户名称和共享访问签名 | Available when the credential source is萨。一个account name and shared access signature can be specified directly in the transformer. |
行动 | The type of operation to perform. Choices include:
|
可用的剩余参数取决于请求>操作参数的值。每个操作的参数如下所述。
删除Options
分享 | The share the file or folder is in. If valid credentials have been provided as a web connection, you may browse for a share. |
Path | The full path of a file or folder on File Storage to delete. If valid credentials have been provided as a web connection, you may browse for a location. |
下载选项
分享 | The share the file or folder is in. If valid credentials have been provided as a web connection, you may browse for a share. |
Path | 文件存储上的文件或文件夹的完整路径要下载。如果已作为Web连接提供有效凭据,则可以浏览位置。 |
目的地
下载as. | 选择是否将下载的数据存储在文件,文件夹或属性中。
|
下载到属性 | Specify the attribute that will store the contents of the downloaded file. Valid for Download as Attribute only. |
响应身体编码 | 如需下载作为属性,可以指定字符集编码以确保输出处于人类可读的形式。 如果Auto Detect from HTTP Headeris specified but there is no encoding in the Content-Type metadata associated with the data, the output will be returned as raw bytes. |
Download to Folder | 指定将存储下载文件的文件夹的路径。有效地下载为文件或文件夹。 |
如果文件Exists | 如果该文件已在本地存在,请指定该怎么办。有效地下载为文件或文件夹。
|
Include Subfolders | Choose whether to download subfolders of the File Storage source or not. Valid for Download as Folder only. |
List Options
分享 | 该文件夹中的共享。如果已作为Web连接提供有效凭据,则可以浏览共享。 |
Path | 文件存储上的文件夹的完整路径为列表。如果已作为Web连接提供有效凭据,则可以浏览位置。 |
Include Subfolders | 如果设置为是的, then subfolders are recursively traversed, and their contents are included in the result. |
输出属性
所选属性将添加到输出功能。
_name |
Name of the file or folder |
_完整路径 |
Full path of the file or folder |
_url |
文件或文件夹的URL。 |
_file_or_folder. |
Whether the item is a file or a folder |
_文件大小 |
文件大小(文件夹不存在) |
_最后修改 |
Date and time when the file was last modified |
_relative_path. |
Path to the item relative to the list path |
Data Source
上传 |
The type of data to be uploaded.
使用大型对象时,文件是比属性更好的选择,因为数据将直接从磁盘流式传输,而不要求对象完全存储在功能上的内存中。 When wanting to upload content from a folder, it is better to upload as a folder instead of setting a fixed path and sending multiple features into the connector to upload as a file. |
文件上传 |
The file to be uploaded to File Storage if上传设定为文件。 |
要上传的文件夹 |
如果要将文件夹上载到文件存储上传设定为文件夹。 |
Include Subfolders |
Choose whether to upload subfolders of the要上传的文件夹或不。 |
属性以载为文件 |
从属性提供的要上载的数据上传设定为Attribute。 |
上传选项
分享 | 该文件夹中的共享。如果已作为Web连接提供有效凭据,则可以浏览共享。 |
Path | The full path to the folder on File Storage to upload to. If valid credentials have been provided as a web connection, you may browse for a location. |
上传文件名 | The name of the file created from the data supplied in属性以载为文件。名称必须包含文件名扩展名(例如,.txt,.jpg,.doc)。 |
如果文件Exists | Specify what to do if the file already exists on File Storage.
|
Metadata
It is possible to specify custom name-value pairs that are associated with the uploaded features.
Generate Shared Access Signature
如果选中,将为上传的文件生成共享访问签名(SAS)。属性_sas_url.and_sas_token.will be added to the output feature. This option is only available for file and attribute upload. For more information about SAS, please see theMicrosoft Azure documentation。
萨Token Expiry Time | When the token should expire. |
IP地址或范围 | 如果provided, restrict access to an IP address or range of IP addresses. Ranges are given in the format “203.0.113.0–203.0.113.255”. |
限制到https. |
如果是,令牌只能通过HTTPS使用。 |
输出属性
所选属性将添加到输出功能。仅适用于文件和文件夹上传。
_name | 文件或文件夹的名称。 |
_完整路径 | Full path of the file or folder. |
_url |
文件或文件夹的URL。 |
Editing Transformer Parameters
Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, clickbeside the applicable parameter. For more information, see变换器参数菜单选项。
Defining Values
有几种方法可以在变压器中定义使用的值。最简单的是简单地输入值或字符串,其可以包括各种类型的函数,例如属性引用,数学和字符串函数和工作区参数。有许多工具和快捷方式可以帮助构造值的值,通常可以从与值字段相邻的下拉上下文菜单中提供。
使用文本编辑器
The Text Editor provides a convenient way to construct text strings (including regular expressions) from various data sources, such as attributes, parameters, and constants, where the result is used directly inside a parameter.
Using the Arithmetic Editor
算术编辑器提供了一种方便的方法来构建来自各种数据源的数学表达式,例如属性,参数和特征函数,其中结果直接在参数内使用。
Conditional Values
Set values depending on one or more test conditions that either pass or fail.
内容
表达式和字符串可以包括许多函数,字符,参数等。
设置值 - 无论是否直接在参数中输入或使用其中一个编辑器和包含字符串的表达式都是构造的,都会评估这些函数的字符串和表达式。因此,这些函数的名称(以@ <function_name.>) should not be used as literal string values.
These functions manipulate and format strings. | |
Special Characters |
文本编辑器中提供了一组控制字符。 |
数学函数可用于编辑。 | |
Date/Time Functions | 文本编辑器中提供日期和时间函数。 |
这些运算符可在算术编辑器中使用。 | |
These return primarily feature-specific values. | |
可以使用FME和工作区的参数。 | |
创建和修改用户参数 | 创建自己的可编辑参数。 |
对话框选项 - 表格
具有桌面参数的变压器具有填充和操作值的其他工具。
行重新排序 |
启用后,单击行项目后。选择包括:
|
Cut, Copy, and Paste |
启用后,单击行项目后。选择包括:
Cut, copy, and paste may be used within a transformer, or between transformers. |
筛选 |
开始键入字符串,矩阵仅显示匹配这些字符的行。搜索所有列。这仅影响变换器内的属性的显示 - 它不会更改输出哪个属性。 |
进口 |
导入使用从数据集读取的一组新属性填充表。特定应用在变压器之间变化。 |
Reset/Refresh |
Generally resets the table to its initial state, and may provide additional options to remove invalid entries. Behavior varies between transformers. |
Note:Not all tools are available in all transformers.
参考
处理行为 |
|
Feature Holding |
No |
Dependencies | Azure存储帐户 |
FME许可级别 | FME基本版及以上 |
Aliases | |
History | Released FME 2019.0 |
FME社亚搏国际在线官网区
FME社区是演示亚搏国际在线官网,TOS,文章,常见问题和更多的地方。获取您的问题的答案,从其他用户学习,并建议,投票和评论新功能。
Search forall results about the AzureFileStorageConnectoron the FME Community.
例子可能包含根据开放政府许可证的信息 - 温哥华和/或公开的政府许可证 - 加拿大。