FeatureJoiner

通过结合基于公共键属性值的属性和/或几何特性来连接特性。执行左、内和全连接。

跳转到配置

典型的使用

在特性之间执行简单的连接，使用属性值作为键

它是如何工作的?

FeatureJoiner执行简单的连接操作，很像SQL连接，不需要了解SQL查询构造。

它有两个输入端口-左和正确的-将两个要连接的功能流路由到转换器。选择一个或多个属性进行联接。

当表上联接中指定的每一对键都具有相同的值时，左特性与右特性匹配。当匹配发生时，来自左右特征的属性/几何图形被合并，合并后的特征被输出到加入端口。

连接模式

连接模式参数定义要执行的连接的类型，确定将通过加入输出端口。

连接模式	联合输出
内部	只有具有匹配的左右配对的功能。
左	具有匹配的左右对的功能，以及所有其他未匹配的左特征。
满的	具有匹配的左右对的功能，以及所有不匹配的左右特征。

加入行为

每当通过键将左特征与右特征匹配时，就会产生一个连接的特征。产生的输出特性的数量取决于多个左右特性是否匹配。

连接的类型由使用的数据的性质决定(它不是参数)。连接的任何类型都可以由连接模式(内，左，或满)。

基数	说明	输出（假设1个键值）
1比1	一对一：如果每个左特征在右特征之间有一个匹配项（例如，通过唯一的地址ID键将单点特征映射到地址表），则这是1:1匹配，并生成一个连接的特征。	1左边的火柴1正确的： 1联接特征输出
1点	一对多：如果每个左特征在右特征之间有多个匹配（例如，一个地址记录映射到该地址的计划应用程序列表），则这是1:M（一对多）匹配，并为发生的每个匹配生成一个连接的特征。	1左边的火柴10正确的： 10联接特征输出
男：1	多对一：如果多个左特征与一个右特征记录匹配（例如，多个地址通过邮政编码字段与同一人口普查数据匹配），则这是M:1（多对一）匹配，并为每次匹配生成一个连接的特征	10左匹配1正确的： 10联接特征输出
M:N	许多许多:如果多个左特征与多个右特征匹配（例如，多个地址与多个停电记录匹配），则这是M:N（多对多）匹配，并为每次匹配生成一个关联特征。	10左匹配10正确的： One hundred.加入特性输出* *当所有的功能都有相同的键值-所有左匹配。

无与伦比的特性

属性处理未找到匹配项的特性(包括左和右)连接模式(内，左，或满)。左模式和全模式都将导致一些或所有不匹配的功能通过连接端口输出，这取决于模式:

连接模式	不匹配的左特征输出	不匹配的功能输出
内部	未连接的左	不结合的权利
左	加入	不结合的权利
满的	加入	加入

使用笔记

FeatureJoiner与FeatureMerger:
- 如果连接要求很简单，FeatureJoiner应该提供更好的性能。
- 如果连接需求更复杂，例如构造键、使用表达式、命名冲突解决，请考虑使用FeatureMerger。
- 如果您只希望获得一个连接的特征，不管连接的数量是多少（1:M join生成一个带有连接列表的特征，而不是像FeatureJoiner那样为每个连接生成一个特征），请使用FeatureMerger。
- FeatureJoiner不执行FeatureMerger执行的某些高级列表生成或几何图形处理操作，但这些操作可以通过使用FeatureJoiner和其他转换器来实现。
对于使用SQL语法的复杂连接，或两个以上的输入特性流，可以考虑使用InlineQuerier。

选择特性连接方法

许多转换器可以根据匹配的属性、表达式和/或几何图形执行数据连接。在为特定的连接任务选择连接时，需要考虑连接的复杂性、数据格式、索引、冲突处理和期望的结果。有些转换器使用SQL语法，有些直接访问外部数据库。他们可能支持，也可能不支持属性列表阅读和创作。

通常，选择最特定于您需要完成的任务的方法将提供最佳性能结果。如果有不止一种方法可以做到这一点(通常是这种情况)，那么花时间在性能测试替代方法上可能是值得的。在读取外部表时(与工作空间中已经存在的特性相反)，根据关键索引的存在，性能可能会有很大的差异。

联接变压器比较矩阵

变压器	匹配的	使用SQL语句	可以创建列表	输入类型	值得注意的	说明
FeatureJoiner	属性	没有	没有	特性	简单最佳性能属性值加入不能创建列表——将多个连接表示为多个输出特性不能使用构造的键或表达式	通过结合基于公共键属性值的属性和/或几何特性来连接特性。执行相当于内部、左侧和完整SQL连接的操作。
FeatureMerger	属性	没有	是的	特性	可以使用表达式作为键(构造的键) 可以创建列表——将多个连接表示为单个特性上的列表吗几何形状不匹配	根据匹配的关键属性值和表达式，将一组特性的属性和/或几何图形合并到另一组特性中。
ListBasedFeature合并	将属性列表为单个属性	没有	是的	特性	只有加入变压器使用的所有列表属性内容密钥(其他人可以使用列表中的一个特定值，但不能使用整个列表)	基于匹配，将一组特性的属性和/或几何形状合并到另一组特性上属性列表具有键属性值和表达式的值。
InlineQuerier	SQL查询	是的	没有	特性	使用SQL对非SQL数据允许多个连接/SQL语句，因此可以将多个转换器替换为一个	从传入的特性创建一组SQLite数据库表，对它们执行SQL查询，并将结果作为特性输出。
SQLCreator	SQL查询	是的	没有	外部数据库	最好的，如果所有的SQL功能的源已经拥有在转换过程中读取外部DB表	根据对数据库执行一次的SQL查询的结果生成FME特性。为SQL查询结果的每一行创建一个FME特性。
SQLExecutor执行器	SQL查询	是的	没有	外部数据库	最适合复杂的功能和SQL功能的源之间的联接在转换过程中读取外部DB表	对数据库执行SQL查询。对于输入transformer的每个初始化特性，都会向数据库发出一个查询。初始化特性和查询结果都可以作为特性输出。
数据库连接程序	属性	没有	是的	外部数据库及特点	最简单的功能和数据库表之间的连接非常有效的，如果密钥索引，并在本地缓存数据在转换过程中读取外部DB表非阻塞	基于一个或多个公共键，将外部表的属性与工作空间中已有的特性连接起来。不需要SQL知识。非阻塞的变压器。
匹配器	几何和/或属性	没有	是的	特性	这些方法的唯一一个可以使用的几何体作为匹配键可以看一下属性差异采用几何，没有空间关系	检测彼此匹配的特性。当特性具有匹配的几何形状、匹配的属性值或两者同时具有时，将声明它们以进行匹配。还可以指定特性之间必须不同的属性列表。如果只匹配属性(而不是几何图形)，那么使用FeatureMerger或其他方法将提供更好的性能。

配置

输入端口

输出端口

参数

连接模式

连接模式

指定要执行的连接类型。

内部

内部连接只包括完整的连接 - 来自左和右具有匹配的特征。输出是：

加入时间：左，右功能的所有对具有匹配值的加入按键，包括来自左和右匹配功能属性。

UnjoinedLeft：左功能，没有找到匹配。

UnjoinedRight：右键功能，没有找到匹配。

左

左连接包括完整的加入，再加上左功能，没有找到匹配的 - 那就是，所有的左特点，结合或以其他方式。输出是：

加入时间：左的所有对和右键的功能，具有匹配值的加入对键，包括来自左和右匹配功能属性。

此外，无与伦比的左功能在这里输出。他们将加入到他们的匹配的特征相同的属性名称，但空值。

UnjoinedLeft：无

UnjoinedRight：右键功能，没有找到匹配。

满的

一个完整的加入包括完整的加入，再加上左和右的功能，没有找到匹配的 - 那就是，所有的功能，加入或以其他方式。输出是：

加入时间：左的所有对和右键的功能，具有匹配值的加入对键，包括来自左和右匹配功能属性。

此外，无与伦比的左，右功能在这里输出。他们将加入到他们的匹配的特征相同的属性名称，但空值。

UnjoinedLeft：无

UnjoinedRight：无

注意：要执行右连接，请反转左和右输入连接并使用左连接模式。

属性冲突解决

当连接的功能部件从左、右功能部件接收到具有相同名称(或公共属性)的属性时，这将指定连接输出的首选值。

几何处理

指定连接特性将使用什么几何图形。

使用左：左边输入的几何图形将被使用，右边输入的几何图形将被丢弃。

使用权：右边输入的几何图形将被使用，左边输入的几何图形将被丢弃。

总结左侧和右侧（强制唯一的名称）：来自左边和右边输入的几何图形将被保留，并且每个几何图形部分将被赋予一个唯一的名称。

如果已经独特输出几何图形将保留原来的名称。
未命名的几何形状会根据他们的输入端口（左或右）上进行命名。
否则，从输入功能的所有几何图形将在注册输出功能，通过重命名的几何形状，以避免冲突被保留。
右输入端口将被预置到冲突的几何形状的名字。左几何名称将保持不变。
如果出现多个名称冲突，索引将被附加到名称，起始于2。

几何聚合的例子

左输入几何	右输入几何	输出几何
一种	乙	A B
无名	无名	左右
一种	一种	一个Right_A
一个Right_A	一种	一个Right_A Right_A2

编辑变压器参数

使用一组菜单选项，可以通过引用工作空间中的其他元素来分配transformer参数。更高级的功能，如高级编辑器和算术编辑器，也可以在一些转换器中使用。要访问这些选项的菜单，请单击在可适用的参数旁边。有关更多信息，请参见变压器参数菜单选项。

定义值

有几种方法可以定义在转换器中使用的值。最简单的方法是简单地键入一个值或字符串，其中可以包括各种类型的函数，如属性引用、数学和字符串函数以及工作区参数。有许多工具和快捷方式可以帮助构造值，通常可以从value字段附近的下拉上下文菜单中获得。

参考

处理行为	组的
功能持有	是的
依赖关系	无
FME许可级别	FME基础版及以上
别名
历史
类别	过滤器和连接

FME社亚搏国际在线官网区

FME社区是演示亚搏国际在线官网、操作、文章、常见问题等的地方。获取问题的答案，向其他用户学习，并对新功能提出建议、投票和评论。

搜索关于FeatureJoiner的所有结果在FME社区。亚搏国际在线官网

例子可能包含在政府开放执照下的信息-温哥华

左	从左侧的特性流中选择要用作键的属性。
正确的	从右侧的特性流中选择要用作键的属性。
比较模式	指定如何执行左右属性值之间的比较。如果自动或数字如果指定，则将尝试在比较属性值之前将其转换为数字。

字符串函数	这些功能操作和格式字符串。
特殊字符	一组控制字符在文本编辑器中提供。
数学函数	数学函数在两种编辑器中可用。
时间/日期函数	日期和时间函数是在文本编辑器中提供。
数学运算符	这些运营商都在算术编辑器中使用。
FME特征函数	这些收益主要功能特定的值。
FME参数	FME和工作区特有的参数可被使用。
创建和修改用户参数	创建您自己的可编辑参数。