trx0roll.h
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:7k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /******************************************************
  2. Transaction rollback
  3. (c) 1996 Innobase Oy
  4. Created 3/26/1996 Heikki Tuuri
  5. *******************************************************/
  6. #ifndef trx0roll_h
  7. #define trx0roll_h
  8. #include "univ.i"
  9. #include "trx0trx.h"
  10. #include "trx0types.h"
  11. #include "mtr0mtr.h"
  12. #include "trx0sys.h"
  13. /***********************************************************************
  14. Returns a transaction savepoint taken at this point in time. */
  15. trx_savept_t
  16. trx_savept_take(
  17. /*============*/
  18. /* out: savepoint */
  19. trx_t* trx); /* in: transaction */
  20. /***********************************************************************
  21. Creates an undo number array. */
  22. trx_undo_arr_t*
  23. trx_undo_arr_create(void);
  24. /*=====================*/
  25. /***********************************************************************
  26. Frees an undo number array. */
  27. void
  28. trx_undo_arr_free(
  29. /*==============*/
  30. trx_undo_arr_t* arr); /* in: undo number array */
  31. /***********************************************************************
  32. Returns pointer to nth element in an undo number array. */
  33. UNIV_INLINE
  34. trx_undo_inf_t*
  35. trx_undo_arr_get_nth_info(
  36. /*======================*/
  37. /* out: pointer to the nth element */
  38. trx_undo_arr_t* arr, /* in: undo number array */
  39. ulint n); /* in: position */
  40. /***************************************************************************
  41. Tries truncate the undo logs. */
  42. void
  43. trx_roll_try_truncate(
  44. /*==================*/
  45. trx_t* trx); /* in: transaction */
  46. /************************************************************************
  47. Pops the topmost record when the two undo logs of a transaction are seen
  48. as a single stack of records ordered by their undo numbers. Inserts the
  49. undo number of the popped undo record to the array of currently processed
  50. undo numbers in the transaction. When the query thread finishes processing
  51. of this undo record, it must be released with trx_undo_rec_release. */
  52. trx_undo_rec_t*
  53. trx_roll_pop_top_rec_of_trx(
  54. /*========================*/
  55. /* out: undo log record copied to heap, NULL
  56. if none left, or if the undo number of the
  57. top record would be less than the limit */
  58. trx_t* trx, /* in: transaction */
  59. dulint limit, /* in: least undo number we need */
  60. dulint* roll_ptr,/* out: roll pointer to undo record */
  61. mem_heap_t* heap); /* in: memory heap where copied */
  62. /************************************************************************
  63. Reserves an undo log record for a query thread to undo. This should be
  64. called if the query thread gets the undo log record not using the pop
  65. function above. */
  66. ibool
  67. trx_undo_rec_reserve(
  68. /*=================*/
  69. /* out: TRUE if succeeded */
  70. trx_t* trx, /* in: transaction */
  71. dulint undo_no);/* in: undo number of the record */
  72. /***********************************************************************
  73. Releases a reserved undo record. */
  74. void
  75. trx_undo_rec_release(
  76. /*=================*/
  77. trx_t* trx, /* in: transaction */
  78. dulint undo_no);/* in: undo number */
  79. /*************************************************************************
  80. Starts a rollback operation. */
  81. void
  82. trx_rollback(
  83. /*=========*/
  84. trx_t* trx, /* in: transaction */
  85. trx_sig_t* sig, /* in: signal starting the rollback */
  86. que_thr_t** next_thr);/* in/out: next query thread to run;
  87. if the value which is passed in is
  88. a pointer to a NULL pointer, then the
  89. calling function can start running
  90. a new query thread */
  91. /***********************************************************************
  92. Rollback uncommitted transactions which have no user session. */
  93. void
  94. trx_rollback_all_without_sess(void);
  95. /*===============================*/
  96. /********************************************************************
  97. Finishes a transaction rollback. */
  98. void
  99. trx_finish_rollback_off_kernel(
  100. /*===========================*/
  101. que_t* graph, /* in: undo graph which can now be freed */
  102. trx_t* trx, /* in: transaction */
  103. que_thr_t** next_thr);/* in/out: next query thread to run;
  104. if the value which is passed in is
  105. a pointer to a NULL pointer, then the
  106.     calling function can start running
  107. a new query thread; if this parameter is
  108. NULL, it is ignored */
  109. /********************************************************************
  110. Builds an undo 'query' graph for a transaction. The actual rollback is
  111. performed by executing this query graph like a query subprocedure call.
  112. The reply about the completion of the rollback will be sent by this
  113. graph. */
  114. que_t*
  115. trx_roll_graph_build(
  116. /*=================*/
  117. /* out, own: the query graph */
  118. trx_t* trx); /* in: trx handle */
  119. /*************************************************************************
  120. Creates a rollback command node struct. */
  121. roll_node_t*
  122. roll_node_create(
  123. /*=============*/
  124. /* out, own: rollback node struct */
  125. mem_heap_t* heap); /* in: mem heap where created */
  126. /***************************************************************
  127. Performs an execution step for a rollback command node in a query graph. */
  128. que_thr_t*
  129. trx_rollback_step(
  130. /*==============*/
  131. /* out: query thread to run next, or NULL */
  132. que_thr_t* thr); /* in: query thread */
  133. /***********************************************************************
  134. Rollback a transaction used in MySQL. */
  135. int
  136. trx_rollback_for_mysql(
  137. /*===================*/
  138. /* out: error code or DB_SUCCESS */
  139. trx_t* trx); /* in: transaction handle */
  140. /***********************************************************************
  141. Rollback the latest SQL statement for MySQL. */
  142. int
  143. trx_rollback_last_sql_stat_for_mysql(
  144. /*=================================*/
  145. /* out: error code or DB_SUCCESS */
  146. trx_t* trx); /* in: transaction handle */
  147. /***********************************************************************
  148. Rollback a transaction used in MySQL. */
  149. int
  150. trx_general_rollback_for_mysql(
  151. /*===========================*/
  152. /* out: error code or DB_SUCCESS */
  153. trx_t* trx, /* in: transaction handle */
  154. ibool partial,/* in: TRUE if partial rollback requested */
  155. trx_savept_t* savept);/* in: pointer to savepoint undo number, if
  156. partial rollback requested */
  157. extern sess_t* trx_dummy_sess;
  158. /* A cell in the array used during a rollback and a purge */
  159. struct trx_undo_inf_struct{
  160. dulint trx_no; /* transaction number: not defined during
  161. a rollback */
  162. dulint undo_no; /* undo number of an undo record */
  163. ibool in_use; /* TRUE if the cell is in use */
  164. };
  165. /* During a rollback and a purge, undo numbers of undo records currently being
  166. processed are stored in this array */
  167. struct trx_undo_arr_struct{
  168. ulint n_cells; /* number of cells in the array */
  169. ulint n_used; /* number of cells currently in use */
  170. trx_undo_inf_t* infos; /* the array of undo infos */
  171. mem_heap_t* heap; /* memory heap from which allocated */
  172. };
  173. /* Rollback command node in a query graph */
  174. struct roll_node_struct{
  175. que_common_t common; /* node type: QUE_NODE_ROLLBACK */
  176. ulint state; /* node execution state */
  177. ibool partial;/* TRUE if we want a partial rollback */
  178. trx_savept_t savept; /* savepoint to which to roll back, in the
  179. case of a partial rollback */
  180. };
  181. /* Rollback node states */
  182. #define ROLL_NODE_SEND 1
  183. #define ROLL_NODE_WAIT 2
  184. #ifndef UNIV_NONINL
  185. #include "trx0roll.ic"
  186. #endif
  187. #endif