概览

云数据端口利用了我们自研发的CData软件的标准连接，可以直接与CData ADO.NET和JDBC驱动程序接口支持与数百个云和内部应用程序、数据库等的连接。

云数据端口使用CData驱动程序将数据库操作转换为特定于目标数据源的应用编程接口调用。因此，云应用程序数据可以作为一组虚拟表和存储过程使用。

每个云数据端口都必须配置适当的CData驱动程序，才能连接到目标数据源。一旦建立了连接，端口就支持创建输入映射和输出映射，它们决定了与数据源的虚拟表交互的XML结构。

生成输入和输出映射后，将自动将XML输入文件转换为插入数据的应用编程接口调用，通过应用编程接口调用从数据源检索的数据将以XML文件的形式输出。

要开始使用云数据端口，必须安装目标数据源的CData驱动程序。

安装CData Driver

必须先安装相应数据源的ADO.NET provider (Windows edition)或是JDBC driver (Java edition)，然后才能连接到数据源。

ADO.NET

下载并运行ADO.NET提供商的CData安装程序，这是云数据端口识别该提供商并在端口下拉设置中使其可用所需的全部内容。

• 在CData数据源列表中找到所需的数据源。单击数据源的名称标题，跳转到该数据源的页面。
• 找到列出可用驱动程序类型的顶部工具栏，然后单击ADO.NET图块。
• 单击结果页面上的下载按钮。
• 下载试用版(30天的完整功能)或购买许可证。
• 运行下载的安装程序。
• 重新启动知行EDI系统，以允许云数据端口检测新的提供商。

建立连接

一旦端口中有了适用的驱动程序/提供程序，就必须提供连接设置来访问应用程序的应用程序接口，端口会自动用与所选云应用数据源相关的连接设置填充设置选项卡。

验证

身份验证证书特定于目标数据源，证书应该直接从云应用程序中获取，以便它们可以包含在端口发出的API中。

OAuth身份验证

有些数据源需要OAuth身份验证，这必须使用端口设置面板中的连接按钮来启动。此按钮将引导浏览器到数据源的身份验证门户，在此处CData驱动程序必须被授予访问数据源的权限。知行EDI系统看不到或存储在此门户中输入的证书(门户返回代表身份验证的证书，而不公开它们)。

知行EDI系统确实存储了保持OAuth身份验证最新所需的OAuth令牌和刷新令牌，因此仅在首次连接到数据源时才需要通过OAuth门户提供凭据。

输入映射

云数据端口表示存储在目标云应用程序中的数据，就像数据存储在关系数据库的表中一样。连接到数据源后，端口会扫描数据源中的可用虚拟表和存储过程。输入映射表示在这些虚拟表中的插入/更新。

输入映射表示为XML，由云数据端口处理的与输入映射的XML结构匹配的文件将自动转换为针对目标数据源的适当的插入或更新查询。

将XML转换为数据库查询的过程在“输入映射为XML”部分中有详细说明；从概念上讲，端口只是简单地从XML元素中读取值，并在进行INSERT/UPDATE语句时使用它们。

创建输入映射

单击“添加映射”按钮(+)创建新映射。从数据源中的可用虚拟表列表中选择目标表/视图，以调出映射编辑器面板。在映射编辑器中，选择应包含在插入/更新中的虚拟表列。对于简单的INSERT，这就是生成映射所需的全部。

创建输入映射后，可以通过单击映射名称旁边的“代码”按钮(</>)来查看其XML表示。

UPSTERT

UPSERT设置控制端口如何决定是插入还是更新，最常见的情况是将UPSERT by设置为表的主键。使用这种配置，端口将从输入的XML中读取主键值，查询数据源以查看该键是否已经存在于表中，如果存在则更新记录，如果不存在则插入新记录。UPSERT by:可以设置为主键以外的列，但这可能会导致从数据源返回多个记录。在这种情况下，端口更新返回的第一条记录。

如果执行此查询以选择UPSERT键:设置为SELECT查询，端口将比较此查询的结果和输入的XML，以确定是INSERT还是UDPATE。例如，如果此字段设置为以下查询:

SELECT CustomerName WHERE CustomerAddress = 101 Main Street

然后端口将首先对数据源运行该查询，然后在输入的XML中查找CustomerName元素，最后将该XML值与数据源返回的值进行比较。如果这些值匹配，那么端口将更新该记录，否则它将插入一个新记录。

INSERT

如果在输入映射中禁用UPSERT，端口将自动将操作设置为INSERT。端口将尝试为每个输入的XML文件插入新记录，而无需查询数据源来查看该记录是否已经存在。

LOOKUP

有些列有LOOKUP选项可用。端口检测到这些列与数据源中的另一个虚拟表有外键关系。如果LOOKUP已启用，端口将在插入前查询该外部表，并使用INSERT中返回的值。LOOKUP by:字段确定将使用哪一列来查询外部表。

例如，假设将采购订单插入数据源，其中“PO”虚拟表中的一个字段是CustomerID。假设输入的XML将有一个客户名称元素，但没有客户的内部标识。但是，数据源中的另一个表“Customers”既有名称又有标识，因此它可以用于根据名称查找标识值。端口将识别“Customers”表的CustomerID列是外键，并为该列启用LOOKUP。将LOOKUP by:设置为CustomerName将指示端口使用如下语句查询“客户”表:

SELECT CustomerID FROM Customers WHERE CustomerName = @CustomerName

在此查询中，@CustomerName代表输入XML中CustomerName元素中的值。

使用这种配置，端口将首先从“Customers”中检索客户标识，然后在插入“PO”表时使用该值。

XML形式的输入映射

输入映射用XML表示，结构如下:父元素标识要插入的虚拟表，每个子元素对应于目标表中的一列。输入映射建立了XML元素和数据源列之间的连接，以便端口可以从传入的XML文档中读取值，并在插入或更新查询中使用它们。

以下是“Students”表的输入映射示例:

在上例中，学生标识、姓名、年级和平均成绩是“Students”表的每一列。当端口处理与该结构匹配的一个XML文件时，它会自动将该XML中的值插入到“Students”表中。以下是用于上述映射的示例XML输入文件:

    
        12554
        Ferris Bueller
        11
        1.8
    
    
        12921
        Hermione Granger
        9
        4.0
    

当端口处理上述输入文件时，它将在“Students”表中插入或更新两条记录，每个学生元素一条记录。

批量导入

云数据端口支持批处理，以提高插入大数据集时的性能。批处理通过两个字段配置，事务大小和批处理大小。当这些字段设置为正整数时，端口将在单个操作(批处理)中插入[批处理大小]记录，并将在单个连接(事务)中插入[事务大小]记录。

一个XML输入文件可以包含比单个事务大小更多的记录，在这种情况下，端口将通过多个事务插入数据。

如果在批处理插入期间发生错误，端口将回滚事务并缓存失败事务中第一条记录的索引。重试输入文件时，只有缓存索引后的记录才会插入数据源。

UPDATE操作

默认情况下，输入映射将使用INSERT或UPSERT作为查询操作。与输入映射相关联的动作在XML中显示为table_name元素的“action”属性，例如:

当操作设置为UPDATE时，一些云应用程序数据源支持更好的性能。更新操作假定插入数据源的数据与已经存在的记录相关联。如果这是真的，可能需要尝试将“action”属性设置为UPDATE，以利用更好的后端性能:

请注意，Amazon Dynamo DB数据源是后端数据处理包括UPSERT逻辑的特殊情况(换句话说，对不存在的记录的UPDATE调用将导致创建新记录)。将数据插入Amazon Dynamo DB数据库时，建议将“action”属性设置为“UPDATE”，以利用性能优势。

插入到子表

输入映射支持使用单个映射插入多个虚拟表。当创建具有多个表的输入映射时，这些表应该彼此具有外键关系，这样一个表就是另一个表的子表。否则，使用多个输入映射插入到不通过外键相关的表中。

要插入子表，首先创建一个以父表为目标的输入映射。然后使用左上角的“添加”按钮从输入映射编辑器中添加子表。从表列表中选择适当的表，设计器将自动填充表的层次结构。选择应包含在输入映射中的子表列。

REF

子表中的一些列将用蓝色的“REF”来标记。端口检测到这些列对应于父表中的主键。在插入父表之后，在插入子表之前，端口将在父表中查询它刚刚插入的记录的主键。然后，端口将在插入子表时使用该值。

当父表的主键由数据源生成时，如自动增量键，这很有用。在这种情况下，该列不会作为输入XML传入，因此端口直到将记录插入父表后才知道该列的值。

在输入映射XML中，“ref”属性表示以后可以引用列，或者该列应该包含由数据源生成的具有保留值LAST_INSERT_ID的“ref”属性(例如AUTOINCREMENT主键):

这表示film_id值将在插入后被检索，并可在映射中稍后被引用(通常在子表中)。若要稍后引用该值，请将“ref”元素设置为“AUTOINCREMENT”列的名称:

在上例中，film_id是父表中主键的名称，也是子表中列的名称。“ref”语法指示端口在插入后从父表中检索film_id，并将检索到的值用作子表中的film_id列。

LOOKUP 子表的LOOKUP逻辑与父表相同。有关更多详细信息，请参见创建输入映射中的LOOKUP部分。

子表XML

当插入父表和子表时，输入映射XML结构将是多层的。以下是由外键关联的两个表的输入映射示例: