oci_new_cursor

(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)

oci_new_cursor分配并返回一个新的游标(语句句柄)

描述

oci_new_cursor(resource $connection): resource|false

在指定连接上分配一个新的语句句柄。

参数

connection

一个 Oracle 连接标识符,由 oci_connect()oci_pconnect() 返回。

返回值

返回一个新的语句句柄,或者在出错时返回 false

示例

示例 #1 在 Oracle 存储过程调用中绑定 REF CURSOR

<?php

// 预创建:
// create or replace procedure myproc(myrc out sys_refcursor) as
// begin
// open myrc for select first_name from employees;
// end;

$conn = oci_connect("hr", "hrpwd", "localhost/XE");
if (!
$conn) {
$m = oci_error();
trigger_error(htmlentities($m['message']), E_USER_ERROR);
}

$curs = oci_new_cursor($conn);
$stid = oci_parse($conn, "begin myproc(:cursbv); end;");
oci_bind_by_name($stid, ":cursbv", $curs, -1, OCI_B_CURSOR);
oci_execute($stid);

oci_execute($curs); // 像普通语句 ID 一样执行 REF CURSOR
while (($row = oci_fetch_array($curs, OCI_ASSOC+OCI_RETURN_NULLS)) != false) {
echo
$row['FIRST_NAME'] . "<br />\n";
}

oci_free_statement($stid);
oci_free_statement($curs);
oci_close($conn);

?>

添加注释

用户贡献的注释 3 个注释

10
mgumiel at mgait dot com
11 年前
Oracle 中的一些包是函数,这些函数返回游标。

例如

CREATE FUNCTION F_Function( p1 char(2), p2 int)
RETURN SYS_REFCURSOR
AS
my_cursor SYS_REFCURSOR;
BEGIN
OPEN my_cursor FOR SELECT * FROM allitems
WHERE (cod=p1)
AND (Number=p2);
RETURN my_cursor;
END F_Function;

以下代码允许从返回游标的函数中获取数据。

<pre>
<?php
$conn
=oci_connect("server", "user", "pass");
if (!
$conn) {
$e = oci_error();
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}

// 您必须在之前分配。
$p1 = '03';
$p2 = 2012016191;

$stid = oci_parse($conn, 'begin :cursor := server.PKG_package.F_Function(:p1,:p2); end;');
$p_cursor = oci_new_cursor($conn);

// 发送参数变量值长度
oci_bind_by_name($stid, ':p1', $p1,2);
oci_bind_by_name($stid, ':p2', $p2,10);

// 绑定游标并放置 -1
oci_bind_by_name($stid, ':cursor', $p_cursor, -1, OCI_B_CURSOR);

// 执行语句
oci_execute($stid);
oci_execute($p_cursor, OCI_DEFAULT);

oci_fetch_all($p_cursor, $cursor, null, null, OCI_FETCHSTATEMENT_BY_ROW);
echo
'<br>';
print_r($cursor);
?>
-3
sixd at php dot net
14 年前
Oracle 11.2 引入了对 REF CURSOR 预取的支持
-4
sixd at php dot net
15 年前
由于 OCI8 使用“预取”来极大地提高返回查询结果的效率,但 Oracle 不支持对 REF CURSOR 进行预取,因此,可以使用一个从 REF CURSOR 中拉取数据并通过管道输出的 PL/SQL 函数来极大地提高使用 REF CURSOR 的应用程序的性能。新函数可以在 SELECT 中像表一样查询。请参阅 http://blogs.oracle.com/opal/2008/11/
converting_ref_cursor_to_pipe.html
To Top