Next_RowID

定义

Next_RowID 将注册到地理数据库的表作为输入参数,并返回 ObjectID (RowID) 字段的下一个值。

使用 SQL 将一行插入到表中时,可以使用此值。

如果您指定的表未注册到地理数据库,则返回错误。

语法

<geodatabase administrator schema>.next_rowid (<table owner>, <table name>)

在大多数地理数据库中,地理数据库管理员方案是 sde。但是,在 SQL Server dbo 方案地理数据库中,则为 dbo;而在 Oracle 用户方案地理数据库中,则为用户方案的名称。

返回类型

整型

示例

下面是在每种支持的数据库类型中使用 Next_RowID 函数的示例。

第一个示例将记录插入由 webman 拥有的 applicants 表,并调用 Next_RowID 过程将值插入 RowID 字段 (ObjectID) 中。在 DB2 和 SQL Server 中,必须首先调用 Next_RowID 过程获取 ObjectID 字段的值,然后在插入语句中使用该值。

第二个示例尝试将记录插入 logins 表,调用 Next_RowID 过程将值插入名为 ID 的字段。但是,logins 表没有注册到地理数据库;因此,将返回一条错误。

DB2

在 DB2 中,不能在插入语句中使用存储过程。因此,必须调用 Next_RowID 过程获取下一 RowID 的值,然后在插入语句中使用此编号。

CALL sde.next_rowid('WEBMAN', 'APPLICANTS', ?, ?, ?);

Value of output parameters
----------------------------
Parameter Name :   O_ROWID
Parameter Value :  30

Parameter Name :   O_MSGCODE
Parameter Value :  0

Parameter Name :   O_MESSAGE
Parameter Value :  Procedure successfully completed.

Return Status = 1


INSERT INTO webman.applicants (objectid, app_name, status)
VALUES
(30, 'Roy Bean', 'active')

The SQL command completed successfully

在此例中,表未注册到地理数据库,因此不返回 ID 值。

CALL sde.next_rowid('WEBMAN', 'LOGINS', ?, ?, ?);

Value of output parameters
----------------------------
Parameter Name :   O_ROWID
Parameter Value :  -

Parameter Name :   O_MSGCODE
Parameter Value :  -20169

Parameter Name :   O_MESSAGE
Parameter Value :  No SDE ROWID column.

Return Status = 1

Oracle

INSERT INTO webman.applicants (objectid, app_name, status)
VALUES
(sde.gdb_util.next_rowid('WEBMAN', 'APPLICANTS'), 'Roy Bean', 'active');

1 row created

COMMIT;
INSERT INTO webman.logins (id, l_name)
VALUES 
(sde.gdb_util.next_rowid('WEBMAN', 'LOGINS'), 'maplebutter');


(sde.gdb_util.next_rowid('WEBMAN', 'LOGINS'), 'maplebutter');
 *
ERROR at line 3:
ORA-20220: Class WEBMAN.LOGINS not registered to the Geodatabase.

PostgreSQL

INSERT INTO webman.applicants (objectid, app_name, status)
VALUES
(sde.next_rowid('webman', 'applicants'), 'Roy Bean', 'active')

Query returned successfully: 1 row affected, 109 ms execution time.
INSERT INTO webman.logins (id, l_name)
VALUES 
(sde.next_rowid('WEBMAN', 'LOGINS'), 'maplebutter')

Notice: Class webman.logins not registered to the Geodatabase.

SQL Server

在 SQL Server 中使用 Next_RowID 存储过程时,必须获取下一行 ID 值,然后在将记录插入到表时插入该值。

DECLARE @myval int
EXEC sde.next_rowid 'mgr', 'customers', @myval OUTPUT
SELECT @myval "Next RowID";

Next RowID
3188
INSERT INTO webman.applicants (objectid, app_name, status)
VALUES
(3188, 'Roy Bean', 'active');

Query returned successfully: 1 row affected, 109 ms execution time.

如果尝试为没有注册到地理数据库的表运行 Next_RowID 过程,您将会收到一条错误消息,如下面的示例中所示:

DECLARE @myval int;
EXEC sde.next_rowid 'mgr', 'inventory', @myval OUTPUT;
SELECT @myval "Next RowID"

Msg 50000, Level 16, State 1, Procedure next_rowid, Line 16
Class inventory not registered to the Geodatabase.

相关主题

5/25/2014