Editar datos versionados en DB2 usando SQL

Complejidad:

Principiante

Requisitos de datos:

Usar datos propios

Puede editar datos versionados en una geodatabase de los sistemas operativos IBM DB2 sobre Linux, UNIX o Windows de dos formas: editando una versión con nombre a través de una vista versionada o editando la versión Predeterminada a través de una vista versionada. Consulte Una vista general de la edición de datos versionados usando SQL para obtener una descripción de cada modelo de edición.

En la mayoría de los casos, utilizará solo un modelo de edición. Sin embargo, es posible utilizar ambos modelos en el mismo sitio; por lo tanto, este flujo de trabajo explica cómo utilizar ambos para que pueda ver cómo llevar la transición entre los dos. Si utiliza solo uno, lea la sección específica para editar el modelo que desea utilizar.

Nota:

Las vistas versionadas no son compatibles con las bases de datos DB2 en sistemas operativos z.

Editar la versión Predeterminada

Puede utilizar SQL para conectarse a la versión Predeterminada y editar una vista versionada. No necesita abrir una sesión de edición. Cuando empieza a editar, se conecta automáticamente al estado actual de la versión Predeterminada.

Debería confirmar después de cada edición que realice para evitar el bloqueo de otros usuarios para acceder a las tablas delta de la clase de entidad o tabla.

En los siguientes pasos, se edita una vista versionada (blic_evw). Las ediciones se realizan para que esta vista se escriba en las tablas delta de la tabla versionada blic. Dado que solo hay un par de ediciones, se realizarán en la versión Predeterminada.

1. Conéctese a la base de datos desde un cliente SQL. Asegúrese de conectarse como un usuario con privilegios para editar la vista versionada y dataset.
2. Lleve a cabo la primera modificación en la vista versionada mediante SQL.

   En este ejemplo, se actualiza una fila existente para modificar el nombre del propietario de la propiedad.

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

3. Confirme su edición.

   COMMIT;
   

4. Realice la siguiente edición.

   Se agrega un nuevo registro en la tabla a través de la vista versionada.

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

   Sugerencia:

   En la declaración INSERT, no se especifica ningún valor de ObjectID, la vista versionada obtiene automáticamente el siguiente ObjectID disponible y lo inserta para la fila.

5. Confirme su edición.

   COMMIT;
   

Editar una versión con nombre

Mantiene una pila de actualizaciones para la clase de entidad blic, de manera que decide si sería una buena idea realizar sus ediciones en una versión con nombre.

Los siguientes son procedimientos almacenados y su sintaxis que utilizará para editar una versión con nombre de la geodatabase:

Procedimiento almacenado	Propósito	Sintaxis y descripción
sde.create_version	Crear una versión de geodatabase con nombre. Si está editando versiones con nombre (versiones distintas a la Predeterminada), siempre edite la suya aparte; varios editores no pueden editar la misma versión con nombre usando vistas versionadas.	CALL sde.create_version ('<parent_version>', '<child_version>', <name_rule>, <access>, '<description>', <message_code_output>, <message_output>)
sde.setcurrentversion	Establece a qué versión de geodatabase y estado accederá. Accede al estado de la versión que señaló cuando inició setcurrentversion.	CALL sde.setcurrentversion('<child_version>', <message_code_output>, <message_output>)
sde.edit_version	Inicia y finaliza una sesión de edición en una versión con nombre. Las ediciones en la transacción se confirman siempre que se inicie este procedimiento.	CALL sde.edit_version('<child_version>', <1 or 2>, <message_code_output>, <message_output>) Especifique 1 para iniciar la sesión de edición. Especifique 2 para finalizarla.

Los parámetros en las declaraciones de inicio representan lo siguiente:

• <parent_version> es la versión desde la cual se crea su versión.
• <child_version> es la versión con nombre que creó para editar.
• <name_rule> indica si el nombre especificado para la versión debería haber sido tomado como dado (2) o debería haberse creado un nombre único cuando se especificó un nombre duplicado (1).
• <access> es el nivel de permiso para la versión: 0 si es privada, 1 si es pública o 2 si es protegida.
• <description> es una descripción de texto de una versión secundaria.
• <message_code_output> indica que desea que el código SQL le sea devuelto.
• <message_output> indica que desea que los mensajes SQL le sean devueltos.

En los siguientes pasos, se crea una versión con nombre (myedits12111) a partir de la versión Predeterminada y las ediciones se realizan en esa versión a través de la vista versionada blic_evw.

1. Desde el símbolo del sistema, cree una nueva versión para realizar las modificaciones.

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

El texto entre comillas simples se lee literalmente. Por tanto, el texto que escriba entre comillas debe coincidir con el uso de mayúsculas y minúsculas del texto (todo en mayúsculas, todo en minúsculas o mayúsculas y minúsculas) almacenado en la base de datos.

2. Establezca la versión para la sesión de edición como la versión secundaria recién creada.

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

   Esto establece el estado de edición al estado actual de myedits12111.

3. Inicie una sesión de edición mediante una llamada al procedimiento almacenado edit_version y especifique 1. El número 1 indica que se debe iniciar una sesión de edición.

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

4. Desde el cliente SQL, inicie una nueva transacción para editar blic_evw.
5. Haga un conjunto de ediciones en la vista versionada usando 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. Confirme sus ediciones.

   COMMIT;
   

Se realizan más ediciones en SQL. Después de finalizar el siguiente conjunto de ediciones, cierre la sesión de edición.
7. Detenga la sesión de edición mediante una llamada al procedimiento almacenado edit_version, pero esta vez, especifique 2. El número 2 indica que se debe finalizar la sesión de edición.

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

   Sugerencia:

   Solo puede editar una versión por sesión de edición. Por ejemplo, si desea editar una segunda versión (tal como mynewedits), debe cerrar la sesión de edición en myedits12111, como se muestra en este paso. A continuación podría iniciar setcurrentversion para señalar la versión de mynewedits e iniciar una sesión de edición en esta iniciando edit_version.

Cambiar de editar una versión con nombre para volver a editar la versión Predeterminada

Si necesita regresar para editar la versión Predeterminada directamente (por ejemplo, si su administrador le dice que otros usuarios en su sitio necesitan ver una edición en particular inmediatamente), puede iniciar set_default para cambiar y regresar a la edición de la versión Predeterminada. Las ediciones que realice en la versión Predeterminada las pueden ver otros usuarios que estén conectados tan pronto como se actualicen sus conexiones de cliente.

El procedimiento almacenado y la sintaxis que utilizará para editar la versión Predeterminada de la geodatabase se describen a continuación:

Procedimiento almacenado	Propósito	Sintaxis y descripción
sde.set_default	Regrese para editar el estado actual de la versión Predeterminada. Inicie este procedimiento si estaba editando una versión con nombre o un estado específico de la versión Predeterminada, pero desea regresar a editar la versión Predeterminada actual.	CALL sde.set_default (<message_code_output>, <message_output>) <message_code_output> indica que desea que el código SQL le sea devuelto. <message_output> indica que desea que los mensajes SQL le sean devueltos.

1. En la ventana de SQL, inicie el procedimiento set_default.

   CALL sde.set_default
   

   Ahora se establece la sesión para editar el estado actual al que se refiere la versión Predeterminada.

2. Edite la vista versionada 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. Confirme su edición.

   COMMIT;
   

   Otros clientes que se dirigen al mismo estado de la versión Predeterminada o a cualquier estado en su linaje pueden actualizar sus conexiones y ver la nueva entidad de puntos.

Conciliar y publicar las ediciones para la versión con nombre.

Cuando finalice las ediciones en la versión con nombre, debe utilizar ArcGIS para conciliar, revisar y resolver conflictos y publicar sus ediciones. Esto se puede llevar a cabo en ArcGIS Desktop mediante la herramienta de geoprocesamiento Conciliar versiones o una secuencia de comandos Python. Consulte los siguientes temas para obtener más información:

• Un recorrido rápido por la conciliación de una versión
• Conciliar una versión
• Un rápido recorrido por la revisión de conflictos
• Publicar cambios
• Conciliar versiones

Sugerencia:

Si los datos que estaba editando se han registrado previamente como versionados con la opción de mover las ediciones a la base, esas ediciones se moverán a la tabla base después de conciliarlas y publicarlas en la versión Predeterminada.

Una vez publicadas las modificaciones en la versión Predeterminada, puede eliminar la versión con nombre. El procedimiento almacenado y la sintaxis que utilizará para eliminar la versión con nombre después de conciliarla y publicarla en la versión Predeterminada de la geodatabase se describen a continuación:

Procedimiento almacenado	Propósito	Sintaxis y descripción
sde.delete_version	Elimine una versión de la geodatabase.	CALL sde.delete_version('<child_version>', <message_code_output>, <message_output>)

En el siguiente ejemplo se elimina myedits12111 después de haber conciliado y publicado todas las ediciones en la versión Predeterminada:

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