Editar datos versionados en DB2 usando SQL

Complejidad: Principante Requisito de datos: Utilizar datos propios

Puede editar datos versionados en una geodatabase en 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 DEFAULT a través de una vista versionada. Vea Un recorrido rápido por 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 DEFAULT

Puede utilizar SQL para conectarse a la versión DEFAULT 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 DEFAULT.

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_vw). 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 DEFAULT.

Pasos:

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_vw 
   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_vw (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 Id.del objeto, la vista versionada obtiene automáticamente el próximo Id. del objeto 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 DEFAULT), 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 DEFAULT y las ediciones se realizan en esa versión a través de la vista versionada blic_vw.

Pasos:

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 lo tanto, el texto que escriba entre comillas debe coincidir con el uso de mayúsculas y minúsculas del texto (todas mayúsculas, todas minúsculas o mayúsculas y minúsculas) según como esté 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_vw.
5. Haga un conjunto de ediciones en la vista versionada usando SQL.

   INSERT INTO blic_vw (propowner, date_entered, location)
   VALUES (
     'V. Nay', 
     CURRENT TIMESTAMP, 
     db2gse.ST_PointFromText ('point (0.0125699 0.0046700)', 12));
   
   UPDATE blic_vw 
   SET (phone1,phone2) = ('555.111.2345','555.111.6789') 
   WHERE propowner = 'Tella Chomsky';
   
   UPDATE blic_vw
   SET exp_date = '2020-06-30 17:00:00'
   WHERE lid = 22903;
   
   UPDATE blic_vw
   SET location = db2gse.ST_PointFromText ('point (0.0125705 0.0046688)', 12))
   WHERE lid = 8992;
   
   INSERT INTO blic_vw 
   (codenum, propowner) 
   VALUES (456, 'Anjo Badsu');
   
   DELETE FROM blic_vw
   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 DEFAULT

Si necesita regresar para editar la versión DEFAULT 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 DEFAULT. Las ediciones que le haga a la versión DEFAULT las pueden ver otros usuarios que están conectados, tan pronto como se actualicen sus conexiones de cliente.

El procedimiento almacenado y su sintaxis que utilizará para editar la versión DEFAULT 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 DEFAULT. Inicie este procedimiento si estaba editando una versión con nombre o un estado específico de la versión DEFAULT, pero desea regresar a editar la versión DEFAULT 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.

Pasos:

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

   CALL sde.set_default
   

   Se establece la sesión ahora para editar el estado actual al que se refiere la versión DEFAULT.

2. Edite la vista versionada blic_vw.

   INSERT INTO blic_vw (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 DEFAULT o 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 for Desktop mediante la herramienta de geoprocesamiento de lotes 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ónConciliar una versiónUn rápido recorrido por la revisión de conflictosPublicar cambiosConciliar 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 DEFAULT.

Una vez publicadas las modificaciones en la versión DEFAULT, puede eliminar la versión con nombre. El procedimiento almacenado y su sintaxis que utilizará para eliminar la versión con nombre después de conciliarla y publicarla en la versión DEFAULT 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>)

El siguiente ejemplo elimina myedits12111 después de haber conciliado y publicado todas las ediciones en la versión DEFAULT:

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