zoukankan      html  css  js  c++  java
  • PB数据管道

    数据管道提供了一种不同数据库之间传递数据和(或)表结构的方法。


    数据管道对象
    要完毕数据管道的功能须要提供例如以下内容:
    须要数据源和目标数据库,并可以和这两个数据库正常联接
    须要源数据库中的哪些表;
    须要拷贝到目标数据库中的什么位置;
    要完毕哪些管道操作;
    错误发生的频率;
    同意错误发生的最大数;
    须要包含的扩充特性。


    数据管道画板
    New —> DataBase —> Data Pipeline
    数据管道选项:
    Table:目标表名
    Key:目标表的主键名(非主键字段名)
    Options:管道选项
    Create:加入�表、Replace:替换已存在的表、Refresh:删除或者插入行、Append:插入行、Update:更新或者插入行
    Max Errors:同意的最大错误数
    Commit:被提交的事务处理内的行数
    Extended Attributes:扩充特性是否管道化

    Design->Database Bolb 处理Blob类型的字段

    假设在目标数据库中仅仅创建数据表而不拷贝原来的数据,能够通过定义永远不成立的检索条件来实现,比方2<1作为检索条件。


    数据管道用户对象
    New —> PB Object —> Standard Class —> OK —> 选中pipeline —> OK


    属性:
    DataObject:指定使用哪个数据管道
    该属性是数据管道最重要的一个属性,有些类似于数据窗体控件的DataObject属性。此属性仅仅能在执行时设定,尽管在用户对象画板中也提供了设置该属性的地方,但这好像不起作用。以下是一个为管道用户对象设定DataObject的样例:
    iuo_pipeline.DataObject="p_copy_employee"
    数据窗体控件的DataObject属性假设在脚本运行时动态改动,则形成发行文件时,在运行文件里不能包含对应的数据窗体对象。与此类似,数据管道对象也不能包含在运行文件里,而且也不能包含在资源文件pbr中,仅仅能放置到pbd或者dll文件里。

    RowsInError:错误记录数
    Long类型,表示管道执行时已经发生的错误数。该值肯定不会大于管道画板中定义的MaxErrors的取值。

    RowsRead:已经读取的记录数
    Long类型,表示管道执行时已经读取的数据记录数。该值肯定不会大于管道画板中Commit中定义的取值。

    RowsWritten:已经成功写入的记录数
    Long类型,表示已经写入到数据库中的数据记录数

    Syntax:管道对象的语法
    该属性也是一个非常重要的属性,它体现了管道的所有定义,在某种程度上能够把它用做一个管道。利用该属性能够构造出通用性非常强的数据管道,由于能够使用Mid,Pos,Len,Left和Right等字符串处理函数改动数据管道Syntax的语法,以适应程序执行时的情况。
    能够选择管道用户对象 —> 右键:Edit Source查看语法


    事件:
    除了两个标准事件constructor和Destructor之外,还有三个数据管道用户对象所特有的事件,它们是PipeStart,PipeMeter和PipeEnd。这三个事件分别在管道运行时、运行期间和运行结束后触发。通常使用这三个事件和管道的某些属性来反映运行进度。

    PipeStart事件在调用管道函数Start()或者Repair()之后触发。PipeMeter事件在提交某个事务处理之后触发,这一般是在处理的记录数达到Commit值规定的数时,PipeEnd事件在函数Start或者Repair的运行过程终止时触发。


    函数:
    Start:
    pipelineobject.Start(sourcetrans,destinationtrans,errordatawindow{,arg1,arg2,...,argn } )
    当中,pipelineobject为管道用户对象类型变量,在运行该函数之前它的DataObject属性有明白的取值;sourcetrans为联接源库的事务对象,destinationtrans是用来联接目标库的事务对象,这两个事务对象在此之前都应该和对应的库正确建立了联接;当管道运行时假设错误发生,它的错误信息显示在errordatawindow数据窗体控件中。没有必要为该控件指明数据窗体对象,即使指明在显示错误信息时该数据窗体对象也被替换。前面这三个变量是必需要指明的,否则该函数无法正常工作。后面的变量依据数据管道是否定义了检索变量而定。假设数据管道定义了检索变量,arg1,arg2,...,argn要指定,而且变量的个数和检索变量的个数同样,而且对应的类型同样。假设管道对象定义了检索变量,而在Start函数中没有提供对应的值,在管道运行时系统会弹出对话框,要求用户输入检索变量。函数运行时的返回值情况比較复杂,例如以下所看到的:
    返回值 含义
    1 函数运行成功
    -1 管道打开失败
    -2 列太多
    -3 目标表已经存在
    -4 目标表不存在
    -5 联结错误
    -6 检索变量错误
    -7 列不匹配
    -8 源中有致命的SQL错误
    -9 目标中有致命的SQL错误
    -10 超出了最大的错误数
    -12 表语法错误
    -13 没有提供必须的主键
    -15 管道操作已经进行
    -16 源数据库中有错误
    -17 目标数据库中有错误
    -18 目标数据库是仅仅读的


    Repair:
    在脚本中运行管道,错误发生后必须进行一定的处理。Repair函数就是在管道运行错误发生后应该运行的。
    发生错误后,错误信息及错误数据显示在Start函数errordatawindow变量指定的数据窗体控件中。用户在改动错误后能够再次提交数据,这时调用Repair函数。这相当于在数据管道画板中发生错误后使用Painter Bar中的小图标buttonUpdate DB,或者使用菜单项Design->Update Database。

    pipelineobject.Repair ( destinationtrans )
    当中,pipelineobject是管道用户对象类型变量,在运行该函数之前它的DataObject属性有明白的取值;destinationtrans是和目标库建立联接的事务对象。函数的返回值也比較复杂,例如以下所看到的:
    返回值 含义
    1 函数运行成功
    -5 联结错误
    -9 目标中有致命的SQL错误
    -10 超出了最大的错误数
    -11 无效的窗体句柄
    -12 表语法错误
    -15 管道操作已经进行
    -17 目标数据库中有错误
    -18 目标数据库是仅仅读的


    Cancel:
    该函数能够终止正在运行的管道,在用户要强制退出某数据管道时能够调用该函数。

    pipelineobject.Cancel()
    函数正确运行返回1,否则返回-1。


    执行数据管道

    在数据画板中直接执行
    使用菜单项Design -> Execute或者PainterBar中的Execute小图标button来执行当前的数据管道。管道执行过程中,假设出现错误信息,应该依据错误信息改动管道的定义,然后又一次执行。
    假设为提取源表数据指定了检索变量,则在运行时要求用户输入取值,然后使用该值检索源数据窗体中符合该条件的数据。假设未定义检索參数,则直接从源表中读取数据。

    在程序中运行管道
    需例如以下步骤:
    创建相关对象
    和源目标数据库建立联接
    创建数据管道,并设置其相关属性
    运行管道,并处理各种异常。

    在脚本中使用数据管道,须要创建三个对象:数据管道对象、数据管道用户对象以及一个保存错误信息的数据窗体对象,当中数据窗体对象是在管道执行错误时由系统自己主动创建的,数据管道对象在数据管道画板中创建,数据管道用户对象在Standard Class用户对象中创建。

     

  • 相关阅读:
    Django 2.0官方文档中文 渣翻 总索引(个人学习,欢迎指正)
    Deep Learning 之 最优化方法
    2018校招笔试真题汇总
    Java Swing 图形界面开发(目录)
    【目录】Spring 源码学习
    【剑指Offer学习】【所有面试题汇总】
    SSM框架学习思维导图
    关于P2P架构的网络游戏
    Styling FX Buttons with CSS
    JavaFx2.0中CSS的应用
  • 原文地址:https://www.cnblogs.com/hrhguanli/p/3925525.html
Copyright © 2011-2022 走看看