logo - 跳到首页

VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

语句相关接口

DCIStmtPrepare

功能描述

准备要执行的SQL或PL/SQL语句。

功能说明

DCI应用程序使用此调用准备SQL或PL/SQL语句以供执行。DCIStmtPrepare()调用定义应用程序请求。

接口信息

函数/过程

DCIStmtPrepare的语法如下：

sword DCIStmtPrepare ( DCIStmt       *stmtp,
        DCIError      *errhp,
        const OraText *stmt, 
        ub4            stmt_len,
        ub4            language,
        ub4            mode );

参数解释如下：

  • stmtp(IN)：与要执行的语句关联的语句句柄。默认情况下，它在派生它的环境句柄中包含编码设置。语句只能在UTF-16环境中以UTF-16编码编写。

  • errhp(IN)：输出参数，当出现错误时，您可以传递给DCIErrorGet()以获取诊断信息的错误句柄。

  • stmt(IN)：要执行的SQL或PL/SQL语句。必须是以NULL结尾的字符串。也就是说，结束字符是一个空字节数，具体取决于编码。该语句必须采用前一次调用DCIEnvNlsCreate（）的charset参数指定的编码。始终将参数强制转换为（text*）。在UTF-16中准备语句后，绑定和定义缓冲区的字符集默认为UTF-16。

  • stmt_len(IN)：语句的长度（字符或字节数），具体取决于编码。不能为零。

  • Language(IN)：指定V7或本机语法。可能的值如下所示：

    • DCI_V7_SYNTAX—V7 ORACLE解析语法。（暂不支持）

    • DCI_NTV_SYNTAX—语法取决于服务器的版本。

    • DCI_FOREIGN_SYNTAX—根据会话中设置的SQL翻译配置文件指定要翻译的语句。（暂不支持）

  • mode(IN) ：与DCIEnvCreate（）调用中的模式类似，但此模式具有更高的优先级，因为它可以覆盖“自然”继承的模式设置。可能的值是DCI_DEFAULT（默认模式）或DCI_PREP2_IMPL_RESULTS_CLIENT。当在外部过程中进行此调用且需要处理隐式结果时，该模式应作为DCI_PREP2_IMPL_RESULTS_CLIENT传递。

外部接口

无。

其它说明

无。

DCIStmtExecute

功能描述

将应用程序请求与服务器关联。

功能说明

将应用程序请求与服务器关联。

接口信息

函数/过程

DCIStmtExecute的语法如下：

sword DCIStmtExecute ( DCISvcCtx           *svchp,
            DCIStmt             *stmtp,
            DCIError            *errhp,
            ub4                  iters,
            ub4                  rowoff,
            const DCISnapshot   *snap_in,
            DCISnapshot         *snap_out,
            ub4                  mode );

参数解释如下：

  • svchp(IN/OUT)：服务上下文句柄。

  • stmtp(IN/OUT)：语句句柄。它定义了要在服务器上执行的语句和相关数据。

  • errhp(IN/OUT)：输出参数，当出现错误时，您可以传递给DCIErrorGet()以获取诊断信息的错误句柄。

  • iters(IN)：语句执行次数

    • 对于非SELECT语句，此语句的执行次数等于iters-rowoff。

    • 对于SELECT语句，如果iters为非零，则必须对语句句柄进行定义。执行过程会将iters行提取到这些预定义的缓冲区中，并根据预取行数预取更多行。如果不知道SELECT语句检索多少行，则将iters设置为零。

    • 如果非SELECT语句的iters=0，此函数将返回一个错误。

    • 如果DDL语句的iters不是1，此函数将返回一个错误。

    • 对于阵列DML操作，将iters设置为<=32767以获得更好的性能。

  • rowoff(IN)：数组绑定中的数据与此多行执行相关的起始索引。

  • snap_in(IN)：此参数是可选的。如果提供了，则必须指向DCI_DTYPE_SNAP类型的快照描述符。此描述符的内容必须从上一次调用的snap_out参数中获取。如果SQL不是SELECT语句，则忽略描述符。该功能允许Oracle数据库的多个服务上下文查看数据库提交数据的相同一致快照。但是，即使使用相同的快照，一个上下文 中未提交的数据对另一个上下文也不可见。

  • snap_out(IN)：此参数是可选的。如果提供了，则必须指向DCI_DTYPE_SNAP类型的描述符。此描述符由不透明表示形式填充，该表示形式是当前的Oracle数据库系统更改号（SCN），适合作为后续调用DCIstTextExecute（）的管理单元输入。为避免“快照太旧”错误，请不要使用此描述符超过必要的时间。

  • mode(IN) ：模式如下所示：

    • DCI_BATCH_ERRORS -有关此模式的信息，请参阅使用批次错误模式。

    • DCI_COMMIT_ON_SUCCESS—在这种模式下执行语句时，如果执行成功，则在执行后提交当前事务。

    • DCI_DEFAULT-在此模式下调用DCIStmtExecute（）将执行该语句。它还隐式返回有关选择列表的描述信息。

    • DCI_DESCRIBE_ONLY-此模式适用于希望在执行前描述查询的用户。在此模式下调用DCIStmtExecute（）不会执行该语句，但会返回选择列表描述。为了最大限度地提高性能，Oracle建议应用程序以默认模式执行该语句，并使用伴随执行的隐式描述。

    • DCI_EXACT_FETCH——当应用程序提前确切知道要提取多少行时使用。此模式关闭Oracle Database release 8或更高版本模式的预取，并要求在执行调用之前完成预取。使用此模式会在获取所需行后取消光标，并可能导致服务器端资源使用率降低。

    • DCI_PARSE_ONLY-此模式允许用户在执行前解析查询。在此模式下执行将解析查询并返回SQL中的解析错误（如果有）。用户必须注意，这涉及到到到服务器的额外往返。为了最大限度地提高性能，Oracle建议用户以默认模式执行语句，默认模式将语句作为捆绑操作的一部分进行解析。

    • DCI_STMT_SCROLLABLE_READONLY-结果集可滚动所需。无法更新结果集。有关此模式的更多信息，请参阅关于获取结果。此模式不能与任何其它模式一起使用。

    • DCI_RETURN_ROW_COUNT_ARRAY-此模式允许用户在每次迭代中获取DML行数。为非DML的语句传递此模式是错误的。有关更多信息，请参见语句句柄属性。此模式可与DCI_BATCH_ERRORS一起使用。

外部接口

无。

其它说明

无。

DCIStmtFetch

功能描述

从（可滚动的）结果集中获取一行。

功能说明

如果预取的行足够，则fetch调用是本地调用。然而，这对应用程序来说是透明的。如果正在读取LOB列，将获取LOB定位器，以便在这些定位器上执行后续LOB操作。如果涉及长列，则关闭预取。

使用DCI_ATTR_ROWS_FETCHED查找在上一次提取调用中成功提取到用户缓冲区的行数。

接口信息

函数/过程

DCIStmtFetch的语法如下：

sword DCIStmtFetch ( DCIStmt     *stmtp,
        DCIError    *errhp, 
        ub4          nrows,
        ub2          orientation,
        ub4          mode );

参数解释如下：

  • stmtp(IN)：语句句柄。

  • errhp(IN)：当出现错误时，您可以传递给DCIErrorGet()以获取诊断信息的错误句柄。

  • nrows(IN)：要从当前位置提取的行数。

  • orientation(IN)：唯一可接受的值是DCI_FETCH_NEXT，这也是默认值。

  • mode(IN)：指定各种操作模式。对于默认模式，唯一有效的模式是DCI_DEFAULT。

外部接口

无。

其它说明

无。