Редактирование версионных данных в Oracle с помощью SQL

Уровень сложности:

Начальный

Требования к данным:

Используйте собственные данные

Редактировать версионные данные в базе геоданных в Oracle можно двумя способами: изменяя именованную версию или редактируя версию Default в версионном представлении. См. описание каждой модели редактирования в разделе Обзор редактирования версионных данных с использованием SQL.

В большинстве случаев используется только одна модель редактирования. Однако можно использовать обе модели на одном участке. Поэтому этот рабочий процесс описывает, как использовать обе модели, чтобы вы могли увидеть их отличия. Если вы используете только одну модель, прочитайте соответствующий раздел.

Редактирование версии Default

Можно использовать SQL для подключения к версии Default и редактировать версионное представление. Вам не нужно открывать сеанс редактирования. При начале редактирования вы автоматически подключаетесь к текущему состоянию версии Default.

Необходимо принимать изменения после каждой правки, чтобы избежать блокировки других пользователей, обращающихся к таблицам изменений таблицы или класса объекта.

Ниже приводится порядок изменения версионного представления (blic_еvw). Правки в этом виде записываются в таблицу изменений версионной таблицы blic. Так как изменений всего несколько, они будут внесены в версию Default.

1. Подключитесь к базе данных из клиента SQL. Убедитесь, что вы подключились как пользователь с правами доступа для редактирования набора данных и версионного представления.
2. Выполните редактирование версионного представления с помощью SQL.

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

   UPDATE blic_evw 
   SET propowner = 'C. O. Industry' 
   WHERE lic = 44977;
   

3. Внесите изменения (операция COMMIT).

   COMMIT;
   

4. Внесите следующую правку.

   Новая запись будет добавлена в таблицу в версионном представлении. Таблица содержит столбец ST_Geometry (местоположение).

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'Moe Esposito', 
     SYSDATE, 
     sde.ST_PointFromText ('point (0.0125662 0.0046711)', 12));
   

   Подсказка:

   В выражении INSERT значение ObjectID не указывается. Версионное представление автоматически получает следующий доступный ObjectID и вставляет его для строки.

5. Внесите изменения (операция COMMIT).

   COMMIT;
   

Редактирование именованной версии

Вы получили ряд обновлений для класса объектов blic, поэтому вы решили выполнить правку в именованной версии.

Далее представлены хранимые процедуры, используемые для редактирования именованной версии базы геоданных, и их синтаксис:

Хранимая процедура	Назначение	Синтаксис и описание
version_user_ddl.create_version	Создать именованную версию базы геоданных. Если вы редактируете именованные версии (отличные от Default), всегда изменяйте собственную версию. Несколько пользователей не могут редактировать одну именованную версию с помощью версионных представлений.	EXEC {sde | <schema owner>}.version_user_ddl.create_version ('<parent_version>', :<child_version_variable>, <name_rule>, <access>, '<description>')
version_util.set_current_version	Укажите, к какой версии базы геоданных и состоянию нужно получить доступ. Вы получаете доступ к состоянию, на которое указывала версия при вызове set_current_version.	EXEC {sde | <schema owner>}.version_util.set_current_version('<child_version>')
version_user_ddl.edit_version	Откройте и завершите сеанс редактирования именованной версии. Изменения в транзакции принимаются при каждом выполнении этой процедуры.	EXEC {sde | <schema owner>}.version_user_ddl.edit_version ('<child_version>',<1 or 2>) Укажите 1 для запуска сеанса редактирования. Укажите значение 2, чтобы завершить его.

Параметры в выражениях выполнения представляют следующее:

• {sde | <schema owner>} показывает какой пользователь является владельцем операции. Если вы выполняете операцию в базе геоданных master sde, используйте sde, а если вы выполняете операцию в базе геоданных с другой пользовательской схемой, укажите имя пользователя.
• <parent_version> – эта та версия базы геоданных, на основе которой создана ваша версия.
• <child_version> – это именованная версия, которую вы редактируете.
• <name_rule> указывает, следует ли использовать заданное имя версии без изменений (2), или следует создать уникальное имя при указании дублирующегося имени (1).
• <access> – это уровень разрешений версии: 0 для частного доступа, 1 для общего и 2 для защищенного.
• <description> – текстовое описание дочерней версии.

Далее на основе версии Default будет создана версия под именем myedits12111, и в нее будут внесены изменения через версионное представление blic_evw.

1. Откройте клиент SQL и определите переменную для хранения версии, которую вы создадите в следующем шаге.

   VARIABLE my_version NVARCHAR2(10); 
   EXEC :my_version := 'myedits12111';
   

   В этом примере имя переменной –, my_version, тип данных для переменной – NVARCHAR2(10) и имя версии – myedits12111.

2. Создайте новую версию, в которой вы будете редактировать.

   EXEC sde.version_user_ddl.create_version 
   ('sde.DEFAULT', :my_version, sde.version_util.C_take_name_as_given, sde.version_util.C_version_private, 'versioned view edit version');
   

3. Укажите созданную дочернюю версию для сеанса редактирования.

   EXEC sde.version_util.set_current_version('myedits12111');
   

4. Начните сеанс редактирования, выполнив операцию version_user_ddl.edit_version и указав значение 1.

   1 указывает на то, что нужно открыть сеанс редактирования.

   EXEC sde.version_user_ddl.edit_version('myedits12111',1);
   

5. Внесите правки в версионное представление с помощью SQL.

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'V. Nay', 
     SYSDATE, 
     sde.ST_PointFromText ('point (0.0125699 0.0046700)', 12));
   UPDATE blic_evw 
   SET phone1='555.111.2345', phone2='555.111.6789' 
   WHERE propowner = 'Tella Chomsky';
   UPDATE blic_evw
   SET exp_date = '2020-06-30'
   WHERE lid = 22903;
   UPDATE blic_evw
   SET location = sde.ST_PointFromText ('point (0.0125705 0.0046688)', 12))
   WHERE lid = 8992;
   INSERT INTO blic_evw 
   (codenum, propowner) 
   VALUES (456, 'Anjo Badsu');
   DELETE FROM blic_evw
   WHERE lid = 133;
   

6. Примените изменения.

   COMMIT;
   

Дополнительные изменения вносятся в SQL. После завершения следующей серии правок закройте сеанс редактирования.
7. Остановите сеанс редактирования, выполнив операцию version_user_ddl.edit_version, но на этот раз укажите значение 2.

   Значение 2 указывает на то, что нужно завершить сеанс редактирования.

   EXEC sde.version_user_ddl.edit_version('myedits12111',2);
   

   Подсказка:

   Вы можете изменить только одну версию в сеансе редактирования. Например, если требуется изменить вторую версию (например, mynewedits), необходимо закрыть сеанс редактирования в myedits12111, как показано на данном этапе. Затем можно выполнить set_current_version для указания на версию mynewedits и начать сеанс редактирования, выполнив edit_version.

Переключение с редактирования именованной версии на редактирование версии Default

Если требуется вернуться к редактированию версии Default (например, если руководитель говорит вам, что другим пользователям на участке требуется быстро внести правку), можно выполнить функцию version_user_ddl.set_default для перехода на редактирование версии Default. Правки, вносимые в версию Default, могут видеть другие пользователи, подключенные к Default, если они обновляют свои подключения.

Ниже представлены хранимые процедуры, используемые для редактирования версии Default базы геоданных, и их синтаксис:

Хранимая процедура	Назначение	Синтаксис и описание
version_util.set_default	Возврат к редактированию текущего состояния версии Default. Выполните эту процедуру, если вы редактировали именованную версию или определенное состояние версии Default, но хотите вернуться к редактированию текущей версии Default.	EXEC {sde | <schema owner>}.version_user_ddl.set_default

1. В подсказке SQL, выполните операцию установить по умолчанию (set_default).

   EXEC sde.version_util.set_default;
   

   Сеанс теперь настроен для редактирования текущего состояния, на которое ссылается версия Default.

2. Измените версионное представление blic_evw.

   INSERT INTO blic_evw (propowner, b_name, date_entered, location) VALUES (  'Ruben Gol',   SYSDATE, 
     'Chez Coiffure',  sde.ST_PointFromText ('point (0.0125650 0.0046721)', 12));
   

3. Внесите изменения (операция COMMIT).

   COMMIT;
   

   Другие клиенты, указывающие на то же состояние версии Default или любое последующее состояние, могут обновить свои подключения, чтобы просмотреть на новый точечный объект.

Согласование и закрепление изменений в именованной версии

После внесения правок в именованную версию необходимо использовать ArcGIS для согласования, анализа и разрешения конфликтов, а затем закрепить изменения. Это можно сделать в ArcGIS for Desktop с помощью инструмента геообработки Согласовать версии или скрипта Python. Более подробную информацию см. в разделах:

• Введение в согласование версий
• Согласование версии
• Краткий обзор по разрешению конфликтов
• Закрепление изменений
• Согласование версий

Подсказка:

Если редактируемые данные были зарегистрированы как версионные с опцией перемещения изменений в базу, то после согласования и закрепления внесенных изменений в версии Default эти изменения будут перемещены в базовую таблицу.

Как только изменения будут закреплены в версии Default, именованную версию можно будет удалить. Далее представлены хранимые процедуры, используемые для удаления именованной версии после согласования и закрепления изменений в версии Default базы геоданных, и их синтаксис:

Хранимая процедура	Назначение	Синтаксис и описание
version_user_ddl.delete_version	Удалить версию базы геоданных.	EXEC {sde | <schema owner>}.version_user_ddl.delete_version('<child_version>')

В следующем примере удаляется версия myedits12111 после согласования и закрепления всех изменений в версии Default:

EXEC sde.version_user_ddl.delete_version('myedits12111');