mysqlnd_ms_xa_begin

Description

Démarre une transaction distribuée/XA sur les serveurs MySQL particpants. PECL/mysqlnd_ms agit comme un coordinateur de la transaction distribuée.

Une fois qu'une transaction globale a commencé, le plugin injecte les requêtes SQL XA BEGIN appropriées sur tous les serveurs MySQL particpants. La transaction globale est soit terminée par un appel à la fonction mysqlnd_ms_xa_commit(), ou la fonction mysqlnd_ms_xa_rollback() soit, par une annulation implicite lorsqu'une erreur survient.

Pendant une transaction globale, le plugin surveille tous les changements de serveurs, par exemple, lorsque l'on passe d'un serveur MySQL partagé à un autre. Si une requête est émise vers un serveur qui ne participe pas à la transaction globale, une requête XA BEGIN y sera exécutée avant la requête demandée. D'un point de vue utilisateur, l'injection intervient pendant un appel à une fonction d'exécution de requête, comme mysqli_query(). Si l'injection échoue, l'erreur sera rapportée à l'appelant, soit la fonction d'exécution de la requête. Le serveur défaillant ne devient pas un participant de la transaction globale. L'utilisateur doit re-tenter la requête sur le serveur, et ainsi, re-tenter l'injection XA BEGIN, soit stopper la transaction globale car tous les serveurs voulus ne peuvent participer, soit ignorer et continuer l'action globale sans le serveur défaillant.

Il existe plusieurs raisons dans l'échec d'une injection XA BEGIN comme un serveur qui ne peut être atteint, ou un serveur qui a une transaction XA concurrente qui utilise le même xid.

Notez que les transactions globales et locales sont mutuellement exclusives. Vous ne pouvez pas démarrer une transaction XA lorsque vous avez une transaction locale en cours. La transaction locale doit d'abord être fermée. Le plugin tente de détecter ce conflit aussi vite que possible. Il va surveiller les appels APIs de contrôler des transactions locales afin d'en vérifier le statut. Cependant, si des requêtes SQL sont utilisées pour les transactions locales, comme BEGIN, le plugin peut ne pas connaître le statut courant et le conflit n'est pas détecté avant que l'injection XA BEGIN ne soit effectuée.

L'utilisation de ressources XA différents des serveurs MySQL n'est pas supportée par cette fonction. Pour mener à bien une transaction globale entre, par exemple, un serveur MySQL et un autre système de base de données, vous devez réaliser vous même les commandates systèmes SQL.

Note: Expérimental

Cette fonctionalité est actuellement en cours de développement. Il peut y avoir des bogues ou des limitations dans la fonctionalité. Ne pas utiliser en environnement de production.