Changes between Version 3 and Version 4 of la-cli

Timestamp:

06/26/20 23:40:12 (4 years ago)

Author:

nanardon

Comment:

--

la-cli

@@ -170 +170 @@
 == Transaction ==
 
+Les transactions de la-cli sont reportés tel quel sur la base SQL et le fonctionnement de {{{la-cli}}} reprends les même règles que le client {{{psql}}} de PostgreSQL:
+
+ * par défaut chaque commande démarre et termine une transaction
+ * {{{begin}}} démarre une transaction explicite, elle se termine soit par l'utilisation de {{{commit}}} ou {{{rollback}}} soit parce qu'une erreur SQL intervient
+
+Rappelez-vous également que les modifications posent des verrous sur la base et que seul la fin de la transaction retire ces verrous (ou la mort du processus).
+
+=== begin, commit et rollback ===
+
+{{{begin}}} démarre un transaction:
+
+{{{
+latmostest cli=> begin
+latmostest cli->
+}}}
+
+Notez le subtile changement de prompt indiquant qu'une transaction est en cours.
+
+A partir de là, aucune modification ne sera visible tant que {{{commit}}} n'aura pas été appelé.
+A l'inverse toutes les modifications en cours seront annulé avec {{{rollback}}}
+
+{{{
+latmostest user/bob=> begin
+latmostest user/bob-> set givenName pangolin
+Done.
+latmostest user/bob-> show givenName
+bob: pangolin
+latmostest user/bob-> rollback 
+latmostest user/bob=> show givenName
+bob: Bob
+latmostest user/bob=>
+}}}
+
+=== Mode de transaction automatique ===
+
+Dans ce mode chaque nouvelle commande démarre une nouvelle transaction s'il n'y en a pas une déjà en cours.
+
+Ce mode s'active et se désactive avec la commande transaction (notez le changement de prompt):
+
+{{{
+latmostest cli=> transaction on 
+latmostest cli=# 
+}}}
+
+La première commande démarre une transaction:
+
+{{{
+latmostest user/bob=# set givenName pangolin
+Done.
+latmostest user/bob-# rollback 
+latmostest user/bob=# transaction off 
+latmostest user/bob=>
+}}}