实时和大数据分析中的可用
。
“连接要素”工具 
可根据空间、时间和属性关系或这三者间的某种组合将属性从一个源、图层或表中的要素转移到同一个源中的其他要素或其他源或数据集中的要素。 或者，可以计算已连接要素的统计数据。
工作流示意图
示例
下面是“连接要素”工具的用例：
- 分析师拥有其所在城市的犯罪事件数据。 要分析和研究这些犯罪的影响，必须了解犯罪地点与城市各辖区（如学区、警务区、社区）的关系。 通过使用“连接要素”工具，可将每个地点的附加信息追加到每一起犯罪中，并可以进一步研究和分析对不同辖区的影响。
- 当来自一个源的运输船舶进入另一个源的移动恶劣天气像元时，请使用来自恶劣天气事件要素的属性来丰富该船舶。
用法说明
使用“连接要素”工具时，请谨记以下信息：
- 可以根据空间关系、时间关系、属性关系或上述三者的组合来连接要素。
选项 描述 
空间关系
将确定要素是否彼此相连的空间关系。 可用的关系将取决于正在连接的图层的几何类型（点、线或面）。 可用空间关系类型如下：
- intersects
- enter
- equals
- exit
- near planar
- near geodesic
- 包含
- within
- touches
- crosses
- overlaps
注：
如果已指定出口且存在多个连接要素，则目标要素必须满足其与所有连接要素的空间关系。 对于任何其他空间关系，如果存在多个连接要素，则目标要素可以满足其与任一连接要素的空间关系。
时态关系
将确定要素是否彼此相连的时态关系。 可用的关系取决于正在连接的图层的时间类型（时刻或间隔）。 可用时态关系如下：
- meets
- met by
- overlaps
- overlapped by
- during
- 包含
- equals
- finishes
- finished by
- starts
- started by
- intersects
- near
属性关系
将确定要素是否彼此相连的属性关系。 如果连接图层中的字段值等于目标图层中的字段值，则会对要素进行匹配。
- 如果多个要素与同一目标要素相匹配，则您可以决定是否连接所有匹配要素（一对多连接）或是否将所有匹配要素汇总到一起（一对一连接），具体如下：
- 一对一连接 - 此选项可将所有匹配的连接要素汇总到目标图层中的每个要素。 只有具备匹配项的目标要素才会包括在输出中。 将添加已连接要素计数以及其他统计数据，如总和、最小值、最大值、范围、平均值、方差和标准差。 仅在指定一对一连接操作时，才可计算汇总统计数据。
- 一对多连接 - 此选项可将连接图层中的所有匹配要素连接到目标图层。 此结果图层将包含目标要素的多个记录。
显示了一对多和一对一连接的示例。 在本示例中，一对一连接仅包括计数；可按照“连接要素的工作原理 - 计算”部分下方显示的内容计算其他统计数据。 当将连接操作参数设置为一对多连接时，输出要素类中的每个目标要素都可以包含多个行。
- 在一对一连接中配置“连接要素”工具时，可以选择仅保留已连接的要素或者保留所有要素，不考虑连接结果选项。
- 如果您选择仅保留已连接的要素，则输出中将仅显示能够与连接数据集中的要素成功连接的要素。
- 如果您选择保留所有要素，不考虑连接结果，则无论是否存在任何已连接的属性，目标数据集中的所有要素都将显示在输出中。
- 在保留所有要素时，如果保留了要素，但是不存在该要素的任何连接，则 COUNT 值将为 0，并且任何汇总字段属性值将为空
- 此选项仅适用于一对一连接。
- 如果目标要素与连接要素处于不同的坐标系，则将使用目标要素的坐标系。
- 如果连接要素与多个目标要素具有空间关系，则在根据目标要素对其进行匹配时进行多次计数。 例如，如果点位于三个面内，则该点将计数三次，即每个面计数一次。
- 当空间关系设置为邻近测地线或邻近平面时，目标图层必须已投影或者输出坐标系设置为投影坐标系。
- 或者，可以构建一个表达式以连接要素。 如果指定了表达式，则只会使用符合条件的要素。 例如，如果目标要素大于字段名称为 Explosion 的连接要素，则只能使用表达式 $target["Magnitude"] > $join["Explosion"] 通过字段 Magnitude 连接目标要素。 了解有关具有“连接要素”的 Arcade 表达式的详细信息。
- 在实时分析中，如果空间关系设置为进入或退出，则以下情况为真：
- 工具将以全状态方式运行，从而使其能够将连续观测点相互比较以检测状态变化，例如当前条件是否与上一观测点不同。 通过实时分析中的其他空间关系，该工具无需将任何观测点与先前的观测点进行比较，因此它可以以无状态方式运行，从而减少资源消耗。
- 当以全状态方式运行时，“连接要素”将为每个追踪 ID 保留当前观测点的状态存储。 当新的观测点到达时，将会对其与相同追踪 ID（如果存在）的当前观测点进行比较。 如果新观测点的时间戳比状态存储中当前观测点的时间戳更新，则其将替换当前观测点。 如果新观测点的时间戳与相同追踪 ID 的当前观测点的时间戳相同，则该工具无法区分这两个观测点。 这意味着该工具不会将状态存储中的当前观测点替换为新观测点，也不会将新观测点添加至状态存储，并且将对此追踪 ID 的未来观测点与保留在状态存储中的当前观测点进行比较，直到具有较晚时间戳的新观测点到达为止。 该工具将记录发生这种情况的警告。
- 如果选中初次观测可以触发进入或初次观测可以触发退出，则当接收的第一个目标要素位于连接要素内（进入）时，可以满足过滤条件；当接收的第一个目标要素位于连接要素外（退出）时，可以满足过滤条件，无论是否存在可以与当前目标要素的位置进行比较的先前目标要素。 默认值为 false（未选中）。
- 实时分析中的目标时间窗参数至少应与任意轨迹两次观测之间的最长预期间隔相同。 将从内存中移除早于此持续时间的观测点以管理资源。
- 如果源连接到连接端口，则系统将根据目标源和连接源中不断变化的要素动态执行距离计算。
- 在动态地理围栏中，必须设置连接时间窗参数。 如果连接源没有标记为 END_TIME 的字段，并且连接要素的最后已知观测值早于此时间窗，则系统会将其从工具的内存中移除，且不会将其包含在分析中。 如果连接源具有标记为 END_TIME 的字段，则该要素将根据标记为 END_TIME 的字段中的值或在关闭连接时间窗时（以先到的时间为准）从地理围栏存储中老化。
- 仅针对符合一对一连接操作中所使用的指定空间、时间或属性关系的要素计算统计数据。 可以计算数值和字符串统计数据。
参数
使用“连接要素”工具时，请谨记以下信息：
| 参数 | 描述 | 数据类型 |
|---|---|---|
目标图层 | 包含要处理要素的目标图层。 | 要素 |
连接图层 | 要素将连接至目标图层的要素的图层。 | 要素 |
连接操作 | 指定连接将为一对一或一对多。
| 字符串 |
保留所有要素 | 指定是将仅保留成功连接的要素，还是无论是否存在这些要素的成功连接，均保留所有要素。 此选项仅适用于一对一连接。 对于一对多连接，此选项不可用，并且仅返回成功连接的要素。 如果保留所有要素，则对于没有任何连接的要素，计数将为 0，并且任何汇总字段值将为空。 | 字符串 |
空间关系 | 指定用于空间连接要素的条件。 如果选中空间，则此参数可用。 | 字符串 |
空间邻近距离 | 如果连接要素与目标要素的距离在此指定范围内，则有可能进行空间连接。 空间邻近距离仅在空间关系设置为邻近测地线或邻近平面时有效。 | 线性单位 |
时态关系 | 指定用于匹配要素的时间条件。 如果选中时态，则此参数可用。 提供的不同时态条件取决于时刻或间隔时间要素。
| 字符串 |
时态邻近距离 | 事件之间的时间间隔。 在彼此的这一时间窗口内发生的事件之间将发生连接。 如果将时态关系设置为邻近，则此参数可用。 | 时间单位 |
属性关系 | 基于属性字段中值的连接要素。 必须指定目标图层中的哪个属性字段与连接图层中的属性字段匹配。 如果选中属性，则此参数可用。
| 字符串 |
汇总字段 | 指定将通过连接要素的指定字段计算的统计数据。 针对一对一连接计算统计数据。 可以使用不同的统计数据，具体取决于指定字段是字符串、数值还是日期字段。
| 字符串 |
连接条件 | 将条件应用到指定字段。 将仅连接带有符合这些条件的字段的要素。 例如，如果连接图层中的属性 HealthSpending 比目标图层中的属性 Income 大 20%，则可将连接应用到要素。 应用此表达式的连接条件为：$join["HealthSpending"] > $target["Income"] * .2。 | 字符串 |
初次观测可以触发进入/退出 | 指定在以下情况中，接收的第一个目标要素是否满足空间关系条件：对于进入，当接收的第一个目标要素位于连接要素内时；对于退出，当接收的第一个目标要素位于所有连接要素外时（无论是否存在可以与当前目标要素的位置进行比较的先前目标要素）。 默认值为 false（未选中）。 | 布尔 |
将目标要素的几何更改为连接要素的几何 | 将目标要素的几何更改为连接要素的几何 例如，如果目标要素是一个点并且与其连接的连接要素是一个面，则目标要素将采用连接要素的面几何。 默认为 false。 如果目标要素不具有几何，则目标要素将采用与其连接的连接要素的几何。 如果目标要素具有几何而与其连接的连接要素不具有几何，则目标要素将丢失其几何并变为表。 注：当保留所有要素设置为 true 时，此参数无效。 输出要素不能具有不同的几何。 | 布尔 |
目标时间窗 | 指定一个至少与任意给定轨迹两次观测之间的最长预期间隔相同的值。 将从内存中移除早于此持续时间的观测点以管理资源。 仅当空间关系设置为进入或退出时，此参数才有效。 | 字符串 |
连接时间窗 | 连接源的时间窗（动态地理围栏）。 如果连接要素的最后一个已知观测点早于指定的时间窗，则其将被移除并且不会包含在分析中。 如果连接源具有标记为 END_TIME 的字段，则此参数为可选参数。 | 字符串 |
注意事项和限制
使用“连接要素”工具时，需要牢记几个注意事项和限制：
- 仅在指定一对一连接操作时，才会计算汇总统计数据。
- COUNT 字段名称将用于表示一对一连接的已连接要素数量。 如果目标方案中存在 COUNT 字段名称，则该字段将被称为 join_COUNT。 如果执行多个连续连接，则为了避免字段名称冲突，字段名称将为 COUNT、join_COUNT、join_COUNT1、join_COUNT2 等。