Mise à jour de données versionnées dans SQL Server à l'aide de SQL

Complexité : Débutant Exigences en matière de données : Utiliser vos propres données

Vous pouvez mettre à jour des données versionnées dans une géodatabase dans Microsoft SQL Server de deux façons : en modifiant une version nommée via une vue versionnée ou en modifiant la version PAR DEFAUT via une vue versionnée. Consultez la rubrique Présentation rapide de la mise à jour de données versionnées à l'aide de SQL pour une description de chacune des méthodes de mise à jour.

Dans la plupart des cas, vous utiliserez une seule méthode de mise à jour. Il est cependant possible d'utiliser les deux méthodes au même site. Ce workflow explique donc comment utiliser les deux méthodes afin que vous sachiez comment procéder pour passer de l'une à l'autre. Si vous utilisez une seule méthode, lisez la section portant sur la méthode de mise à jour que vous souhaitez utiliser.

Remarque :

Les vues versionnées ne sont pas prises en charge dans les bases de données SQL Windows Azure.

Mise à jour de la version PAR DEFAUT

Vous pouvez utiliser SQL pour vous connecter à la version PAR DEFAUT et mettre à jour une vue versionnée. Il n'est pas nécessaire d'ouvrir une session de mise à jour. Lorsque vous commencez la mise à jour, vous vous connectez automatiquement à l'état courant de la version PAR DEFAUT.

Validez après chaque modification effectuée pour éviter d'empêcher d'autres utilisateurs d'accéder aux tables de deltas de la table ou de la classe d'entités.

Dans les étapes suivantes, une vue versionnée (blic_evw) est mise à jour. Les mises à jour apportées à cette vue sont écrites dans les tables de deltas de la table versionnée blic. Comme il n'y a que deux modifications, elles seront apportées dans la version PAR DEFAUT.

Etapes :

1. Connectez-vous à la base de données à partir d'un client SQL. Veillez à vous connecter en tant qu'utilisateur ayant les privilèges requis pour mettre à jour le jeu de données et la vue versionnée.
2. Effectuez la première modification dans la vue versionnée à l'aide de SQL.

   Dans cet exemple, un enregistrement existant est mis à jour pour modifier le nom du propriétaire de propriété.

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

3. Validez vos mises à jour.

   COMMIT;
   

4. Faites la modification suivante.

   Un nouvel enregistrement est ajouté à la table via la vue versionnée. La table contient une colonne de géométrie (emplacement).

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'Moe Esposito', 
     GETDATE(), 
     geometry::STGeomFromText ('POINT (0.0125662 0.0046711)', 12));
   

   Astuce:

   Dans l'instruction INSERT, aucune valeur d'identifiant d'objet n'est spécifiée. La vue versionnée obtient automatiquement le prochain identifiant d'objet disponible, qui est inséré dans l'enregistrement.

5. Validez vos mises à jour.

   COMMIT;
   

Mise à jour d'une version nommée

Une pile de mises à jour pour la classe d'entités blic vous est remise. Vous décidez donc que ce serait une bonne idée d'effectuer les modifications dans une version nommée.

Les procédures stockées utilisées pour modifier une version nommée de la géodatabase et leur syntaxe sont présentées ci-dessous :

Procédure stockée	Objet	Syntaxe et description
create_version	Crée une version nommée de la géodatabase. Si vous mettez à jour des versions nommées (versions autres que la version PAR DEFAUT), modifiez toujours votre propre version distincte; plusieurs éditeurs ne peuvent pas modifier la même version nommée à l'aide de vues versionnées.	EXEC {dbo | sde}.create_version '<parent_version>', '<child_version>', <name_rule>, <access>, '<description>'
set_current_version	Définit la version de géodatabase à laquelle vous souhaitez accéder et son état. Vous accédez à l'état sur lequel la version pointait lorsque vous avez exécuté set_current_version.	EXEC {dbo | sde}.set_current_version '<child_version>'
edit_version	Démarre et termine une session de mise à jour sur une version nommée. Les modifications dans la transaction sont validées chaque fois que cette procédure est exécutée.	EXEC {dbo | sde}.edit_version '<child_version>',{1 | 2} Spécifiez 1 pour démarrer la session de mise à jour. Spécifiez 2 pour l'arrêter.

Les paramètres dans les instructions d'exécution représentent les éléments suivants :

• {dbo|sde} indique l'utilisateur qui est propriétaire de la procédure. Si vous avez une géodatabase à structure sde, utilisez sde; si vous avez un géodatabase à structure dbo, utilisez dbo.
• <parent_version> est la version à partir de laquelle votre version est créée.
• <child_version> est la version nommée que vous créez pour mise à jour.
• <name_rule> indique si le nom spécifié pour la version doit être accepté tel qu'il est fourni (2) ou si un nom unique doit être créé quand un nom dupliqué est spécifié (1).
• <access> est le niveau d'autorisation de la version : 0 pour Privé, 1 pour Public ou 2 pour Protégé.
• <description> est un texte descriptif de la version enfant.

Dans les étapes suivantes, une version nommée (myedits12111) est créée à partir de la version PAR DEFAUT et les mises à jour sont effectuées dans cette version via la vue versionnée blic_evw.

Etapes :

1. Ouvrez une fenêtre de requête Transact-SQL et exécutez la procédure create_version pour créer une version nommée dans laquelle effectuer vos modifications.

   EXEC sde.create_version 'sde.DEFAULT', 'myedits12111', 1, 2, 'version for my mv edits';
   

2. Définissez la version pour la session de mise à jour sur la version enfant que vous venez de créer.

   EXEC sde.set_current_version 'myedits12111';
   

3. Ouvrez une session de mise à jour en exécutant la procédure stockée edit_version et en spécifiant 1.

   EXEC sde.edit_version 'myedits12111', 1;
   

   La valeur 1 indique qu'une session de mise à jour doit être ouverte.

4. Apportez un ensemble de modifications sur la vue versionnée à l'aide de SQL.

   INSERT INTO blic_evw (propowner, date_entered, location)
   VALUES (
     'V. Nay', 
     getdate(), 
     geometry::STGeomFromText('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 = geometry::STGeomFromText('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. Validez vos mises à jour.

   COMMIT;
   

Apportez d'autres modifications avec SQL. Après avoir terminé la série de modifications suivante, fermez la session de mise à jour.
6. Arrêtez la session de mise à jour en exécutant la procédure stockée edit_version, mais cette fois, spécifiez 2. La valeur 2 indique que la session de mise à jour doit être arrêtée.

   EXEC sde.edit_version 'myedits', 2;
   

   Astuce:

   Vous pouvez modifier une seule version par session de mise à jour. Par exemple, si vous désirez modifier une deuxième version (telle que mynewedits), vous devez fermer la session de mise à jour sur myedits12111, comme l'indique cette étape. Vous pourriez ensuite exécuter set_current_version pour pointer la version de mynewedits et démarrer une session de mise à jour sur cette version en exécutant edit_version.

Basculer de la mise à jour d'une version nommée à la mise à jour de la version PAR DEFAUT

Si vous devez revenir à la mise à jour de la version PAR DEFAUT directement, par exemple si votre gestionnaire vous dit que d'autres utilisateurs de votre site doivent voir une modification particulière sur-le-champ, vous pouvez exécuter version_user_ddl.set_default pour ce faire. Les modifications que vous apportez à la version PAR DEFAUT sont visibles par les autres utilisateurs connectés à la version PAR DEFAUT dès qu'ils actualisent leur connexion client.

La procédure stockée utilisée pour modifier la version PAR DEFAUT de la géodatabase et sa syntaxe sont présentées ci-dessous :

Procédure stockée	Objet	Syntaxe et description
set_default	Revient à la mise à jour de l'état courant de la version PAR DEFAUT. Exécutez cette procédure si vous modifiiez une version nommée ou un état spécifique de la version PAR DEFAUT, mais souhaitez revenir à la mise à jour de la version courante de la version PAR DEFAUT.	EXEC {sde | dbo}.set_default

Etapes :

1. Dans la fenêtre Transact-SQL, exécutez la procédure set_default.

   EXEC sde.set_default;
   

   La session est maintenant configurée pour mettre à jour l'état courant référencé par la version PAR DEFAUT.

2. Mettez à jour la vue versionnée blic_evw.

   INSERT INTO blic_evw (propowner, b_name, date_entered, location)
   VALUES (
     'Ruben Gol', 
     getdate(), 
     'Chez Coiffure',
     geometry::STGeomFromText('point (0.0125650 0.0046721)', 12));
   

3. Validez vos mises à jour.

   COMMIT;
   

   Les autres clients qui pointent sur le même état de la version PAR DEFAUT ou sur tout état dans sa lignée peuvent actualiser leur connexion et voir la nouvelle entité ponctuelle.

Réconcilier et publier les modifications à la version nommée

Lorsque vous avez terminé la mise à jour de la version nommée, vous devez vous utiliser ArcGIS pour réconcilier, réviser et résoudre les conflits et publier vos modifications. Cette opération peut être exécutée dans ArcGIS for Desktop à l'aide de l'outil de géotraitement par lot Réconcilier des versions ou d'un script Python. Pour plus d'informations, consultez les rubriques suivantes :

Présentation rapide de la réconciliation d'une versionRéconciliation d'une versionPrésentation rapide de la révision des conflitsRéinjection des modificationsRéconcilier des versions

Astuce:

Si les données que vous modifiiez étaient inscrites comme versionnées avec l'option d'enregistrement des mises à jour dans la table de base, les mises à jour sont déplacées vers la table de base après leur réconciliation et réinjection dans la version PAR DEFAUT.

Une fois les mises à jour réinjectées dans la version PAR DÉFAUT, votre version nommée peut être supprimée. La procédure stockée utilisée pour supprimer la version nommée après avoir réconcilié et réinjecté les mises à jour dans la version PAR DEFAUT de la géodatabase et sa syntaxe sont présentées ci-dessous :

Procédure stockée	Objet	Syntaxe et description
delete_version	Supprime une version de géodatabase.	EXEC {dbo | sde}.delete_version '<child_version>'

L'exemple suivant supprime myedits12111 une fois toutes les modifications réconciliées et réinjectées dans la version PAR DEFAUT :

EXEC sde.delete_version 'myedits12111';