连接信息类。用于矢量数据集与外部表的连接。外部表可以为另一个矢量数据集(其中纯属性数据集中没有空间几何信息)所对应的DBMS表,也可以是用户自建的业务表。需要注意的是,矢量数据集与外部表必须属于同一数据源。
程序集: SuperMap.Data (in SuperMap.Data)
版本: dll
语法
C# |
---|
public class JoinItem : IDisposable |
备注
当两个表格之间建立了连接,通过对主表进行操作,可以对外部表进行查询,制作专题图以及分析等。当两个表格之间是一对一或多对一的关系时,可以使用join连接。当为多对一的关系时,允许指定多个字段之间的关联。该类型的实例可被创建。
数据集表之间的联系的建立有两种方式,一种是连接(join),一种是关联(link)。连接的相关设置是通过 JoinItem 类实现的,关联的相关设置是通过 LinkItem 类实现的,另外,用于建立连接的两个表必须在同一个数据源下,而用于建立关联关系的两个数据集表可以不在同一个数据源下。
下面通过查询的例子来说明连接和关联的区别,假设用来进行查询的数据集表为 DatasetTableA,被关联或者连接的表为 DatasetTableB,现通过建立 DatasetTableA 与 DatasetTableB 的连接或关联关系来查询 DatasetTableA中满足查询条件的记录:
1.连接(join)
设置将 DatasetTableB 连接 DatasetTableA 的连接信息,即建立 JoinItem 类并设置其属性,当执行 DatasetTableA 的查询操作时,系统将根据连接条件及查询条件,将满足条件的 DatasetTableA 中的内容与满足条件的 DatasetTableB 中的内容构成一个查询结果表,并这个查询表保存在内存中,需要获取结果时,再从内存中取出相应的内容。
2.关联(link)
设置将 DatasetTableB(副表)关联到 DatasetTableA(主表)的关联信息,即建立 LinkItem 类并设置其属性,DatasetTableA 与 DatasetTableB 是通过主表 DatasetTableA 的外键( LinkItem.ForeignKeys 属性)和副表 DatasetTableB 的主键( LinkItem.PrimaryKeys 属性)实现关联的,当执行 DatasetTableA 的查询操作时,系统将根据关联信息中的过滤条件及查询条件,分别查询 DatasetTableA 与 DatasetTableB 中满足条件的内容,DatasetTableA 的查询结果与 DatasetTableB 的查询结果分别作为独立的两个结果表保存在内存中,当需要获取结果时,SuperMap 将对两个结果进行拼接并返回,因此,在应用层看来,连接和关联操作很相似。
3.LinkItem 只支持左连接,UDB、PostgreSQL 和 DB2 数据源不支持 LinkItem,即对 UDB、PostgreSQL 和 DB2 类型的数据引擎设置 LinkItem 不起作用;
4.JoinItem 目前支持左连接和内连接,不支持全连接和右连接,UDB 引擎不支持内连接;
5.使用 LinkItem 的约束条件:空间数据和属性数据必须有关联条件,即主空间数据集与外部属性表之间存在关联字段。主空间数据集:用来与外部表进行关联的数据集。外部属性表:用户通过 Oracle 或者 SQL Server 创建的数据表,或者是另一个矢量数据集所对应的 DBMS 表。
示例
以下代码示范如何构造一个连接信息类,并将其添加到连接信息集合中。
假设打开一个工作空间workspace,工作空间中存在一个数据源 datasource 对象。
public void JoinItemSample(Workspace workspace, Datasource datasource) { // 从数据源里得到名为“World”和“Capital”的数据集,分别为 datasetVector 和 datasetVector1,两个数据集都有 capital 字段 DatasetVector datasetVector = datasource.Datasets["World"] as DatasetVector; DatasetVector datasetVector1 = datasource.Datasets["Capital"] as DatasetVector; // 构造连接信息类对象,获得用于连接的表名 JoinItem joinitem = new JoinItem(); String foreignTableName = datasetVector1.TableName; // 设置连接信息类的属性 joinitem.ForeignTable = foreignTableName; joinitem.JoinFilter = "World.capital=" + foreignTableName + ".capital"; joinitem.JoinType = JoinType.LeftJoin; joinitem.Name = "Connect"; // 设置连接信息集合类,将连接信息加入到连接信息集合中 JoinItems joinitems = new JoinItems(); joinitems.Add(joinitem); // 生成利用外接表制作的默认标签专题图 ThemeLabel themelabel = ThemeLabel.MakeDefault(datasetVector, foreignTableName + ".SmID", RangeMode.EqualInterval, 10.0, ColorGradientType.Rainbow, joinitems); themelabel.LabelExpression = "country"; }
继承层次
SuperMap.Data..::.JoinItem