row0ins.h
上传用户:romrleung
上传日期:2022-05-23
资源大小:18897k
文件大小:6k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /******************************************************
  2. Insert into a table
  3. (c) 1996 Innobase Oy
  4. Created 4/20/1996 Heikki Tuuri
  5. *******************************************************/
  6. #ifndef row0ins_h
  7. #define row0ins_h
  8. #include "univ.i"
  9. #include "data0data.h"
  10. #include "que0types.h"
  11. #include "dict0types.h"
  12. #include "trx0types.h"
  13. #include "row0types.h"
  14. /*******************************************************************
  15. Checks if foreign key constraint fails for an index entry. Sets shared locks
  16. which lock either the success or the failure of the constraint. NOTE that
  17. the caller must have a shared latch on dict_foreign_key_check_lock. */
  18. ulint
  19. row_ins_check_foreign_constraint(
  20. /*=============================*/
  21. /* out: DB_SUCCESS, DB_LOCK_WAIT,
  22. DB_NO_REFERENCED_ROW,
  23. or DB_ROW_IS_REFERENCED */
  24. ibool check_ref,/* in: TRUE If we want to check that
  25. the referenced table is ok, FALSE if we
  26. want to to check the foreign key table */
  27. dict_foreign_t* foreign,/* in: foreign constraint; NOTE that the
  28. tables mentioned in it must be in the
  29. dictionary cache if they exist at all */
  30. dict_table_t* table, /* in: if check_ref is TRUE, then the foreign
  31. table, else the referenced table */
  32. dtuple_t* entry, /* in: index entry for index */
  33. que_thr_t* thr); /* in: query thread */
  34. /*************************************************************************
  35. Creates an insert node struct. */
  36. ins_node_t*
  37. ins_node_create(
  38. /*============*/
  39. /* out, own: insert node struct */
  40. ulint ins_type, /* in: INS_VALUES, ... */
  41. dict_table_t* table,  /* in: table where to insert */
  42. mem_heap_t* heap); /* in: mem heap where created */
  43. /*************************************************************************
  44. Sets a new row to insert for an INS_DIRECT node. This function is only used
  45. if we have constructed the row separately, which is a rare case; this
  46. function is quite slow. */
  47. void
  48. ins_node_set_new_row(
  49. /*=================*/
  50. ins_node_t* node, /* in: insert node */
  51. dtuple_t* row); /* in: new row (or first row) for the node */
  52. /*******************************************************************
  53. Tries to insert an index entry to an index. If the index is clustered
  54. and a record with the same unique key is found, the other record is
  55. necessarily marked deleted by a committed transaction, or a unique key
  56. violation error occurs. The delete marked record is then updated to an
  57. existing record, and we must write an undo log record on the delete
  58. marked record. If the index is secondary, and a record with exactly the
  59. same fields is found, the other record is necessarily marked deleted.
  60. It is then unmarked. Otherwise, the entry is just inserted to the index. */
  61. ulint
  62. row_ins_index_entry_low(
  63. /*====================*/
  64. /* out: DB_SUCCESS, DB_LOCK_WAIT, DB_FAIL
  65. if pessimistic retry needed, or error code */
  66. ulint mode, /* in: BTR_MODIFY_LEAF or BTR_MODIFY_TREE,
  67. depending on whether we wish optimistic or
  68. pessimistic descent down the index tree */
  69. dict_index_t* index, /* in: index */
  70. dtuple_t* entry, /* in: index entry to insert */
  71. ulint* ext_vec,/* in: array containing field numbers of
  72. externally stored fields in entry, or NULL */
  73. ulint n_ext_vec,/* in: number of fields in ext_vec */
  74. que_thr_t* thr); /* in: query thread */
  75. /*******************************************************************
  76. Inserts an index entry to index. Tries first optimistic, then pessimistic
  77. descent down the tree. If the entry matches enough to a delete marked record,
  78. performs the insert by updating or delete unmarking the delete marked
  79. record. */
  80. ulint
  81. row_ins_index_entry(
  82. /*================*/
  83. /* out: DB_SUCCESS, DB_LOCK_WAIT,
  84. DB_DUPLICATE_KEY, or some other error code */
  85. dict_index_t* index, /* in: index */
  86. dtuple_t* entry, /* in: index entry to insert */
  87. ulint* ext_vec,/* in: array containing field numbers of
  88. externally stored fields in entry, or NULL */
  89. ulint n_ext_vec,/* in: number of fields in ext_vec */
  90. que_thr_t* thr); /* in: query thread */
  91. /***************************************************************
  92. Inserts a row to a table. */
  93. ulint
  94. row_ins(
  95. /*====*/
  96. /* out: DB_SUCCESS if operation successfully
  97. completed, else error code or DB_LOCK_WAIT */
  98. ins_node_t* node, /* in: row insert node */
  99. que_thr_t* thr); /* in: query thread */
  100. /***************************************************************
  101. Inserts a row to a table. This is a high-level function used in
  102. SQL execution graphs. */
  103. que_thr_t*
  104. row_ins_step(
  105. /*=========*/
  106. /* out: query thread to run next or NULL */
  107. que_thr_t* thr); /* in: query thread */
  108. /* Insert node structure */
  109. struct ins_node_struct{
  110. que_common_t common; /* node type: QUE_NODE_INSERT */
  111. ulint ins_type;/* INS_VALUES, INS_SEARCHED, or INS_DIRECT */
  112. dtuple_t* row; /* row to insert */
  113. dict_table_t* table; /* table where to insert */
  114. sel_node_t* select; /* select in searched insert */
  115. que_node_t* values_list;/* list of expressions to evaluate and
  116. insert in an INS_VALUES insert */
  117. ulint state; /* node execution state */
  118. dict_index_t* index; /* NULL, or the next index where the index
  119. entry should be inserted */
  120. dtuple_t* entry; /* NULL, or entry to insert in the index;
  121. after a successful insert of the entry,
  122. this should be reset to NULL */
  123. UT_LIST_BASE_NODE_T(dtuple_t)
  124. entry_list;/* list of entries, one for each index */
  125. byte* row_id_buf;/* buffer for the row id sys field in row */
  126. dulint trx_id; /* trx id or the last trx which executed the
  127. node */
  128. byte* trx_id_buf;/* buffer for the trx id sys field in row */
  129. mem_heap_t* entry_sys_heap;
  130. /* memory heap used as auxiliary storage;
  131. entry_list and sys fields are stored here;
  132. if this is NULL, entry list should be created
  133. and buffers for sys fields in row allocated */
  134. ulint magic_n;
  135. };
  136. #define INS_NODE_MAGIC_N 15849075
  137. /* Insert node types */
  138. #define INS_SEARCHED 0 /* INSERT INTO ... SELECT ... */
  139. #define INS_VALUES 1 /* INSERT INTO ... VALUES ... */
  140. #define INS_DIRECT 2 /* this is for internal use in dict0crea:
  141. insert the row directly */
  142. /* Node execution states */
  143. #define INS_NODE_SET_IX_LOCK 1 /* we should set an IX lock on table */
  144. #define INS_NODE_ALLOC_ROW_ID 2 /* row id should be allocated */
  145. #define INS_NODE_INSERT_ENTRIES 3 /* index entries should be built and
  146. inserted */
  147. #ifndef UNIV_NONINL
  148. #include "row0ins.ic"
  149. #endif
  150. #endif