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

Уровень сложности: Начальный Требования к данным: Используйте собственные данные

Редактировать версионные данные в базе геоданных в IBM DB2 в операционных системах Linux, UNIX и Windows можно двумя способами: изменяя именованную версию в версионном виде или редактируя версию DEFAULT в версионном виде. См. описание каждой модели редактирования в разделе Краткий обзор редактирования версионных данных с использованием SQL.

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

Примечание:

Версионные виды не поддерживаются в базах данных DB2 в операционных системах Z.

Редактирование версии по умолчанию (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. Внесите следующую правку.

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

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

   Подсказка:

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

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

   COMMIT;
   

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

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

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

Хранимая процедура	Цель	Синтаксис и описание
sde.create_version	Создать именованную версию базы геоданных. Если вы редактируете именованные версии (отличные от DEFAULT), всегда изменяйте собственную версию. Несколько пользователей не могут редактировать одну именованную версию с помощью версионных видов.	CALL sde.create_version ('<parent_version>', '<child_version>', <name_rule>, <access>, '<description>', <message_code_output>, <message_output>)
sde.setcurrentversion	Укажите, к какой версии базы геоданных и состоянию нужно получить доступ. Вы получаете доступ к состоянию, на которое указывала версия при вызове setcurrentversion.	CALL sde.setcurrentversion('<child_version>', <message_code_output>, <message_output>)
sde.edit_version	Откройте и завершите сеанс редактирования именованной версии. Изменения в транзакции принимаются при каждом вызове этой процедуры.	CALL sde.edit_version('<child_version>', <1 или 2>, <message_code_output>, <message_output>) Укажите 1 для запуска сеанса редактирования. Укажите значение 2, чтобы завершить его.

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

• <parent_version> – эта та версия базы геоданных, на основе которой создана ваша версия.
• <child_version> – это именованная версия, которую вы редактируете.
• <name_rule> указывает, следует ли использовать заданное имя версии без изменений (2), или следует создать уникальное имя при указании дублирующегося имени (1).
• <access> – это уровень разрешений версии: 0 для частного доступа, 1 для общего и 2 для защищенного.
• <description> – текстовое описание дочерней версии.
• <message_code_output> указывает, что нужно вернуть код SQL.
• <message_output> указывает, что нужно вернуть сообщения SQL.

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

Шаги:

1. В командной строке можно создать новую версию, которую вы будете редактировать.

   CALL sde.create_version ('SDE.DEFAULT', 'myedits12111', 1, 1, 'versioned view edit version', ?, ?);
   

Текст, заключенный в одиночные кавычки, читается буквально. Поэтому текст в кавычках должен совпадать с текстом (как в нижнем или верхнем регистре, так и при смешанном регистре), как он хранится в базе данных.

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

   CALL sde.setcurrentversion('myedits12111', ?, ?);
   

   Состояние редактирования будет задано как текущее состояние myedits12111.

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

   CALL sde.edit_version('myedits12111', 1, ?, ?);
   

4. В клиенте SQL запустите новую транзакцию для изменения blic_evw.
5. Внесите правки в версионный вид с помощью SQL.

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'V. Nay', 
     CURRENT TIMESTAMP, 
     db2gse.ST_PointFromText ('point (0.0125699 0.0046700)', 12));
   
   UPDATE blic_evw 
   SET (phone1,phone2) = ('555.111.2345','555.111.6789') 
   WHERE propowner = 'Tella Chomsky';
   
   UPDATE blic_evw
   SET exp_date = '2020-06-30 17:00:00'
   WHERE lid = 22903;
   
   UPDATE blic_evw
   SET location = db2gse.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. Остановите сеанс редактирования, вызвав процедуру edit_version, но на этот раз укажите значение 2. 2 указывает на то, что нужно завершить сеанс редактирования.

   CALL sde.edit_version('myedits12111', 2, ?, ?);
   

   Подсказка:

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

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

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

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

Хранимая процедура	Цель	Синтаксис и описание
sde.set_default	Возврат к редактированию текущего состояния версии DEFAULT. Вызовите эту процедуру, если вы редактировали именованную версию или определенное состояние версии DEFAULT, но хотите вернуться к редактированию текущей версии DEFAULT.	CALL sde.set_default (<message_code_output>, <message_output>) <message_code_output> указывает, что нужно вернуть код SQL. <message_output> указывает, что нужно вернуть сообщения SQL.

Шаги:

1. В командной строке SQL вызовите процедуру set_default.

   CALL sde.set_default
   

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

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

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

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

   COMMIT;
   

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

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

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

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

Подсказка:

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

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

Хранимая процедура	Цель	Синтаксис и описание
sde.delete_version	Удалить версию базы геоданных.	CALL sde.delete_version('<child_version>', <message_code_output>, <message_output>)

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

CALL sde.delete_version ('myedits12111', ?,?);