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

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

Начальный

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

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

Чтобы использовать SQL для редактирования данных, зарегистрированных как версионные (традиционные), необходимо использовать версионное представление. Вы можете редактировать версию Default или другую версию, используя версионное представление. См. описание каждого способа в разделе Обзор редактирования версионных данных с использованием SQL.

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

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

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

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

Ниже приводится порядок изменения версионного представления (blic_evw). Правки в этом виде записываются в таблицу изменений версионной таблицы 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', 
     current_date, 
     sde.ST_Point('point (0.0125662 0.0046711)', 12));
   

   Подсказка:

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

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

   COMMIT;
   

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

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

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

Функция	Назначение	Синтаксис и описание
sde.sde_create_version	Создать именованную версию базы геоданных. Если вы редактируете именованные версии (отличные от Default), всегда изменяйте собственную версию. Несколько пользователей не могут редактировать одну именованную версию с помощью версионных представлений.	SELECT sde.sde_create_version ('<parent_name>', '<child_version>', <rule_code>, <access_code>, '<description>')
sde.sde_set_current_version	Укажите, к какой версии базы геоданных и состоянию нужно получить доступ.	SELECT sde.sde_set_current_version('<child_version>');
sde.sde_edit_version	Откройте и завершите сеанс редактирования именованной версии.	SELECT sde.sde_edit_version('<child_version>',<1 или 2>) Укажите 1 для запуска сеанса редактирования. Укажите значение 2, чтобы завершить его.

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

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

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

1. Из клиента SQL создайте новую версию, в которую вы будете вносить исправления.

   SELECT sde.sde_create_version
   ('sde.DEFAULT', 'myedits12111', 2, 1, 'version for edits');
   

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

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

   SELECT sde.sde_set_current_version('myedits12111');
   

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

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

   SELECT sde.sde_edit_version('myedits12111',1);
   

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

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'V. Nay', 
     current_date, 
     sde.ST_Point('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 17:00:00'
   WHERE lid = 22903;
   UPDATE blic_evw
   SET location = sde.ST_Point('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;
   

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

   COMMIT;
   

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

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

   SELECT sde.sde_edit_version('myedits12111',2);
   

   Подсказка:

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

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

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

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

Функция	Назначение	Синтаксис и описание
sde.set_default	Возврат к редактированию текущего состояния версии Default. Вызовите эту функцию, если вы редактировали именованную версию или определенное состояние версии Default, но хотите вернуться к редактированию текущей версии Default.	SELECT sde.set_default

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

   SELECT sde.set_default;
   

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

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

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

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

   COMMIT;
   

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

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

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

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

Подсказка:

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

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

Функция	Назначение	Синтаксис и описание
sde.sde_delete_version	Удалить версию базы геоданных.	SELECT sde.sde_delete_version('<child_version>');

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

SELECT sde.sde_delete_version('myedits12111');