Next_RowID

Определение

Next_RowID получает в качестве входного параметра таблицу, зарегистрированную в базе геоданных, и возвращает следующее значение для поля ObjectID (RowID).

Вы можете использовать это значение при добавлении строки в таблицу с помощью SQL.

Если выбранная таблица не зарегистрирована в базе геоданных, будет возвращена ошибка.

Синтаксис

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

В большинстве баз геоданных для схемы администратора базы геоданных используется sde. Однако для баз геоданных с dbo-схемой в SQL Server это dbo, а для баз геоданных с пользовательской схемой в Oracle - это имя пользовательской схемы.

Тип возврата

Целочисл. (Integer)

Примеры

Следующие примеры демонстрируют использование функции Next_RowID для каждого поддерживаемого типа базы данных.

В первом примере в таблицу applicants, владельцем которой является webman, добавляется запись, и вызывается процедура Next_RowID, чтобы добавить значение в поле RowID (ObjectID). В DB2 и SQL Server, вам необходимо сначала вызвать процедуру Next_RowID, чтобы получить значение для поля ObjectID, а затем использовать полученное значение в выражении insert.

Во втором примере производится попытка добавить запись в таблицу logins с помощью вызова процедуры Next_RowID для добавления значения в поле с именем ID. Однако таблица logins не зарегистрирована в базе геоданных; поэтому будет возвращена ошибка.

DB2

В DB2 хранимые процедуры не могут быть использованы напрямую в выражении insert. Поэтому вам необходимо вызвать процедуру Next_RowID, чтобы получить значение следующего RowID, а затем использовать это число в выражении insert.

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

При использовании встроенной процедуры Next_RowID в SQL Server, вам необходимо сначала извлечь значение следующего идентификатора строки, а затем вставить полученное значение при добавлении записи в таблицу.

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.