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

MySQL数据库

开发平台:

Visual C++

  1. /* Copyright (C) 2000,2004 MySQL AB & MySQL Finland AB & TCX DataKonsult AB
  2.    This program is free software; you can redistribute it and/or modify
  3.    it under the terms of the GNU General Public License as published by
  4.    the Free Software Foundation; either version 2 of the License, or
  5.    (at your option) any later version.
  6.    This program is distributed in the hope that it will be useful,
  7.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  8.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  9.    GNU General Public License for more details.
  10.    You should have received a copy of the GNU General Public License
  11.    along with this program; if not, write to the Free Software
  12.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
  13. /* Definitions for parameters to do with handler-routines */
  14. #ifdef USE_PRAGMA_INTERFACE
  15. #pragma interface /* gcc class implementation */
  16. #endif
  17. #include <ft_global.h>
  18. #include <keycache.h>
  19. #ifndef NO_HASH
  20. #define NO_HASH /* Not yet implemented */
  21. #endif
  22. #if defined(HAVE_BERKELEY_DB) || defined(HAVE_INNOBASE_DB) || 
  23.     defined(HAVE_NDBCLUSTER_DB)
  24. #define USING_TRANSACTIONS
  25. #endif
  26. // the following is for checking tables
  27. #define HA_ADMIN_ALREADY_DONE   1
  28. #define HA_ADMIN_OK               0
  29. #define HA_ADMIN_NOT_IMPLEMENTED -1
  30. #define HA_ADMIN_FAILED  -2
  31. #define HA_ADMIN_CORRUPT         -3
  32. #define HA_ADMIN_INTERNAL_ERROR  -4
  33. #define HA_ADMIN_INVALID         -5
  34. #define HA_ADMIN_REJECT          -6
  35. #define HA_ADMIN_TRY_ALTER       -7
  36. /* Bits in table_flags() to show what database can do */
  37. #define HA_READ_RND_SAME       (1 << 0) /* can switch index during the scan
  38.                                            with ::rnd_same() - not used yet.
  39.                                            see mi_rsame/heap_rsame/myrg_rsame */
  40. #define HA_TABLE_SCAN_ON_INDEX (1 << 2) /* No separate data/index file */
  41. #define HA_REC_NOT_IN_SEQ      (1 << 3) /* ha_info don't return recnumber;
  42.                                            It returns a position to ha_r_rnd */
  43. #define HA_CAN_GEOMETRY        (1 << 4)
  44. #define HA_FAST_KEY_READ       (1 << 5) /* no need for a record cache in filesort */
  45. #define HA_NULL_IN_KEY         (1 << 7) /* One can have keys with NULL */
  46. #define HA_DUPP_POS            (1 << 8) /* ha_position() gives dup row */
  47. #define HA_NO_BLOBS            (1 << 9) /* Doesn't support blobs */
  48. #define HA_CAN_INDEX_BLOBS     (1 << 10)
  49. #define HA_AUTO_PART_KEY       (1 << 11) /* auto-increment in multi-part key */
  50. #define HA_REQUIRE_PRIMARY_KEY (1 << 12) /* .. and can't create a hidden one */
  51. #define HA_NOT_EXACT_COUNT     (1 << 13)
  52. #define HA_CAN_INSERT_DELAYED  (1 << 14) /* only handlers with table-level locks
  53.                                             need no special code to support
  54.                                             INSERT DELAYED */
  55. #define HA_PRIMARY_KEY_IN_READ_INDEX (1 << 15)
  56. #define HA_NOT_DELETE_WITH_CACHE (1 << 18)
  57. #define HA_NO_PREFIX_CHAR_KEYS (1 << 20)
  58. #define HA_CAN_FULLTEXT        (1 << 21)
  59. #define HA_CAN_SQL_HANDLER     (1 << 22)
  60. #define HA_NO_AUTO_INCREMENT   (1 << 23)
  61. #define HA_HAS_CHECKSUM        (1 << 24)
  62. /* Table data are stored in separate files (for lower_case_table_names) */
  63. #define HA_FILE_BASED        (1 << 26)
  64. #define HA_ANY_INDEX_MAY_BE_UNIQUE (1 << 30)
  65. /* bits in index_flags(index_number) for what you can do with index */
  66. #define HA_READ_NEXT            1       /* TODO really use this flag */
  67. #define HA_READ_PREV            2       /* supports ::index_prev */
  68. #define HA_READ_ORDER           4       /* index_next/prev follow sort order */
  69. #define HA_READ_RANGE           8       /* can find all records in a range */
  70. #define HA_ONLY_WHOLE_INDEX 16 /* Can't use part key searches */
  71. #define HA_KEYREAD_ONLY         64 /* Support HA_EXTRA_KEYREAD */
  72. /* operations for disable/enable indexes */
  73. #define HA_KEY_SWITCH_NONUNIQ      0
  74. #define HA_KEY_SWITCH_ALL          1
  75. #define HA_KEY_SWITCH_NONUNIQ_SAVE 2
  76. #define HA_KEY_SWITCH_ALL_SAVE     3
  77. /*
  78.   Bits in index_ddl_flags(KEY *wanted_index)
  79.   for what ddl you can do with index
  80.   If none is set, the wanted type of index is not supported
  81.   by the handler at all. See WorkLog 1563.
  82. */
  83. #define HA_DDL_SUPPORT   1 /* Supported by handler */
  84. #define HA_DDL_WITH_LOCK 2 /* Can create/drop with locked table */
  85. #define HA_DDL_ONLINE    4 /* Can create/drop without lock */
  86. /*
  87.   Parameters for open() (in register form->filestat)
  88.   HA_GET_INFO does an implicit HA_ABORT_IF_LOCKED
  89. */
  90. #define HA_OPEN_KEYFILE 1
  91. #define HA_OPEN_RNDFILE 2
  92. #define HA_GET_INDEX 4
  93. #define HA_GET_INFO 8 /* do a ha_info() after open */
  94. #define HA_READ_ONLY 16 /* File opened as readonly */
  95. /* Try readonly if can't open with read and write */
  96. #define HA_TRY_READ_ONLY 32
  97. #define HA_WAIT_IF_LOCKED 64 /* Wait if locked on open */
  98. #define HA_ABORT_IF_LOCKED 128 /* skip if locked on open.*/
  99. #define HA_BLOCK_LOCK 256 /* unlock when reading some records */
  100. #define HA_OPEN_TEMPORARY 512
  101. /* Errors on write which is recoverable  (Key exist) */
  102. #define HA_WRITE_SKIP 121 /* Duplicate key on write */
  103. #define HA_READ_CHECK 123 /* Update with is recoverable */
  104. #define HA_CANT_DO_THAT 131 /* Databasehandler can't do it */
  105. /* Some key definitions */
  106. #define HA_KEY_NULL_LENGTH 1
  107. #define HA_KEY_BLOB_LENGTH 2
  108. #define HA_LEX_CREATE_TMP_TABLE 1
  109. #define HA_LEX_CREATE_IF_NOT_EXISTS 2
  110. #define HA_OPTION_NO_CHECKSUM (1L << 17)
  111. #define HA_OPTION_NO_DELAY_KEY_WRITE (1L << 18)
  112. #define HA_MAX_REC_LENGTH 65535
  113. /* Table caching type */
  114. #define HA_CACHE_TBL_NONTRANSACT 0
  115. #define HA_CACHE_TBL_NOCACHE     1
  116. #define HA_CACHE_TBL_ASKTRANSACT 2
  117. #define HA_CACHE_TBL_TRANSACT    4
  118. /* Options of START TRANSACTION statement (and later of SET TRANSACTION stmt) */
  119. #define MYSQL_START_TRANS_OPT_WITH_CONS_SNAPSHOT 1
  120. enum db_type 
  121.   DB_TYPE_UNKNOWN=0,DB_TYPE_DIAB_ISAM=1,
  122.   DB_TYPE_HASH,DB_TYPE_MISAM,DB_TYPE_PISAM,
  123.   DB_TYPE_RMS_ISAM, DB_TYPE_HEAP, DB_TYPE_ISAM,
  124.   DB_TYPE_MRG_ISAM, DB_TYPE_MYISAM, DB_TYPE_MRG_MYISAM,
  125.   DB_TYPE_BERKELEY_DB, DB_TYPE_INNODB, 
  126.   DB_TYPE_GEMINI, DB_TYPE_NDBCLUSTER,
  127.   DB_TYPE_EXAMPLE_DB, DB_TYPE_ARCHIVE_DB, DB_TYPE_CSV_DB,
  128.   DB_TYPE_FEDERATED_DB,
  129.   DB_TYPE_BLACKHOLE_DB,
  130.   DB_TYPE_DEFAULT // Must be last
  131. };
  132. struct show_table_type_st {
  133.   const char *type;
  134.   SHOW_COMP_OPTION *value;
  135.   const char *comment;
  136.   enum db_type db_type;
  137. };
  138. enum row_type { ROW_TYPE_NOT_USED=-1, ROW_TYPE_DEFAULT, ROW_TYPE_FIXED,
  139. ROW_TYPE_DYNAMIC, ROW_TYPE_COMPRESSED};
  140. /* struct to hold information about the table that should be created */
  141. /* Bits in used_fields */
  142. #define HA_CREATE_USED_AUTO 1
  143. #define HA_CREATE_USED_RAID 2
  144. #define HA_CREATE_USED_UNION 4
  145. #define HA_CREATE_USED_INSERT_METHOD 8
  146. #define HA_CREATE_USED_MIN_ROWS 16
  147. #define HA_CREATE_USED_MAX_ROWS 32
  148. #define HA_CREATE_USED_AVG_ROW_LENGTH 64
  149. #define HA_CREATE_USED_PACK_KEYS 128
  150. #define HA_CREATE_USED_CHARSET 256
  151. #define HA_CREATE_USED_DEFAULT_CHARSET 512
  152. typedef struct st_thd_trans {
  153.   void *bdb_tid;
  154.   void *innobase_tid;
  155.   bool innodb_active_trans;
  156.   void *ndb_tid;
  157. } THD_TRANS;
  158. enum enum_tx_isolation { ISO_READ_UNCOMMITTED, ISO_READ_COMMITTED,
  159.  ISO_REPEATABLE_READ, ISO_SERIALIZABLE};
  160. typedef struct st_ha_create_information
  161. {
  162.   CHARSET_INFO *table_charset, *default_table_charset;
  163.   const char *comment,*password;
  164.   const char *data_file_name, *index_file_name;
  165.   const char *alias;
  166.   ulonglong max_rows,min_rows;
  167.   ulonglong auto_increment_value;
  168.   ulong table_options;
  169.   ulong avg_row_length;
  170.   ulong raid_chunksize;
  171.   ulong used_fields;
  172.   SQL_LIST merge_list;
  173.   enum db_type db_type;
  174.   enum row_type row_type;
  175.   uint null_bits;                       /* NULL bits at start of record */
  176.   uint options; /* OR of HA_CREATE_ options */
  177.   uint raid_type,raid_chunks;
  178.   uint merge_insert_method;
  179.   bool table_existed; /* 1 in create if table existed */
  180. } HA_CREATE_INFO;
  181. /* The handler for a table type.  Will be included in the TABLE structure */
  182. struct st_table;
  183. typedef struct st_table TABLE;
  184. typedef struct st_ha_check_opt
  185. {
  186.   ulong sort_buffer_size;
  187.   uint flags;       /* isam layer flags (e.g. for myisamchk) */
  188.   uint sql_flags;   /* sql layer flags - for something myisamchk cannot do */
  189.   KEY_CACHE *key_cache; /* new key cache when changing key cache */
  190.   void init();
  191. } HA_CHECK_OPT;
  192. class handler :public Sql_alloc
  193. {
  194.  protected:
  195.   struct st_table *table; /* The table definition */
  196.   virtual int index_init(uint idx) { active_index=idx; return 0; }
  197.   virtual int index_end() { active_index=MAX_KEY; return 0; }
  198.   /*
  199.     rnd_init() can be called two times without rnd_end() in between
  200.     (it only makes sense if scan=1).
  201.     then the second call should prepare for the new table scan (e.g
  202.     if rnd_init allocates the cursor, second call should position it
  203.     to the start of the table, no need to deallocate and allocate it again
  204.   */
  205.   virtual int rnd_init(bool scan) =0;
  206.   virtual int rnd_end() { return 0; }
  207. public:
  208.   byte *ref; /* Pointer to current row */
  209.   byte *dupp_ref; /* Pointer to dupp row */
  210.   ulonglong data_file_length; /* Length off data file */
  211.   ulonglong max_data_file_length; /* Length off data file */
  212.   ulonglong index_file_length;
  213.   ulonglong max_index_file_length;
  214.   ulonglong delete_length; /* Free bytes */
  215.   ulonglong auto_increment_value;
  216.   ha_rows records; /* Records in table */
  217.   ha_rows deleted; /* Deleted records */
  218.   ulong raid_chunksize;
  219.   ulong mean_rec_length; /* physical reclength */
  220.   time_t create_time; /* When table was created */
  221.   time_t check_time;
  222.   time_t update_time;
  223.   /* The following are for read_range() */
  224.   key_range save_end_range, *end_range;
  225.   KEY_PART_INFO *range_key_part;
  226.   int key_compare_result_on_equal;
  227.   bool eq_range;
  228.   uint errkey; /* Last dup key */
  229.   uint sortkey, key_used_on_scan;
  230.   uint active_index;
  231.   /* Length of ref (1-8 or the clustered key length) */
  232.   uint ref_length;
  233.   uint block_size; /* index block size */
  234.   uint raid_type,raid_chunks;
  235.   FT_INFO *ft_handler;
  236.   enum {NONE=0, INDEX, RND} inited;
  237.   bool  auto_increment_column_changed;
  238.   bool implicit_emptied;                /* Can be !=0 only if HEAP */
  239.   handler(TABLE *table_arg) :table(table_arg),
  240.     ref(0), data_file_length(0), max_data_file_length(0), index_file_length(0),
  241.     delete_length(0), auto_increment_value(0),
  242.     records(0), deleted(0), mean_rec_length(0),
  243.     create_time(0), check_time(0), update_time(0),
  244.     key_used_on_scan(MAX_KEY), active_index(MAX_KEY),
  245.     ref_length(sizeof(my_off_t)), block_size(0),
  246.     raid_type(0), ft_handler(0), inited(NONE), implicit_emptied(0)
  247.     {}
  248.   virtual ~handler(void) { /* TODO: DBUG_ASSERT(inited == NONE); */ }
  249.   int ha_open(const char *name, int mode, int test_if_locked);
  250.   void update_auto_increment();
  251.   virtual void print_error(int error, myf errflag);
  252.   virtual bool get_error_message(int error, String *buf);
  253.   uint get_dup_key(int error);
  254.   void change_table_ptr(TABLE *table_arg) { table=table_arg; }
  255.   virtual double scan_time()
  256.     { return ulonglong2double(data_file_length) / IO_SIZE + 2; }
  257.   virtual double read_time(uint index, uint ranges, ha_rows rows)
  258.  { return rows2double(ranges+rows); }
  259.   virtual const key_map *keys_to_use_for_scanning() { return &key_map_empty; }
  260.   virtual bool has_transactions(){ return 0;}
  261.   virtual uint extra_rec_buf_length() { return 0; }
  262.   
  263.   /*
  264.     Return upper bound of current number of records in the table
  265.     (max. of how many records one will retrieve when doing a full table scan)
  266.     If upper bound is not known, HA_POS_ERROR should be returned as a max
  267.     possible upper bound.
  268.   */
  269.   virtual ha_rows estimate_rows_upper_bound()
  270.   { return records+EXTRA_RECORDS; }
  271.   virtual const char *index_type(uint key_number) { DBUG_ASSERT(0); return "";}
  272.   int ha_index_init(uint idx)
  273.   {
  274.     DBUG_ASSERT(inited==NONE);
  275.     inited=INDEX;
  276.     return index_init(idx);
  277.   }
  278.   int ha_index_end()
  279.   {
  280.     DBUG_ASSERT(inited==INDEX);
  281.     inited=NONE;
  282.     return index_end();
  283.   }
  284.   int ha_rnd_init(bool scan)
  285.   {
  286.     DBUG_ASSERT(inited==NONE || (inited==RND && scan));
  287.     inited=RND;
  288.     return rnd_init(scan);
  289.   }
  290.   int ha_rnd_end()
  291.   {
  292.     DBUG_ASSERT(inited==RND);
  293.     inited=NONE;
  294.     return rnd_end();
  295.   }
  296.   /* this is neseccary in many places, e.g. in HANDLER command */
  297.   int ha_index_or_rnd_end()
  298.   {
  299.     return inited == INDEX ? ha_index_end() : inited == RND ? ha_rnd_end() : 0;
  300.   }
  301.   uint get_index(void) const { return active_index; }
  302.   virtual int open(const char *name, int mode, uint test_if_locked)=0;
  303.   virtual int close(void)=0;
  304.   virtual int write_row(byte * buf) { return  HA_ERR_WRONG_COMMAND; }
  305.   virtual int update_row(const byte * old_data, byte * new_data)
  306.    { return  HA_ERR_WRONG_COMMAND; }
  307.   virtual int delete_row(const byte * buf)
  308.    { return  HA_ERR_WRONG_COMMAND; }
  309.   virtual int index_read(byte * buf, const byte * key,
  310.  uint key_len, enum ha_rkey_function find_flag)
  311.    { return  HA_ERR_WRONG_COMMAND; }
  312.   virtual int index_read_idx(byte * buf, uint index, const byte * key,
  313.      uint key_len, enum ha_rkey_function find_flag);
  314.   virtual int index_next(byte * buf)
  315.    { return  HA_ERR_WRONG_COMMAND; }
  316.   virtual int index_prev(byte * buf)
  317.    { return  HA_ERR_WRONG_COMMAND; }
  318.   virtual int index_first(byte * buf)
  319.    { return  HA_ERR_WRONG_COMMAND; }
  320.   virtual int index_last(byte * buf)
  321.    { return  HA_ERR_WRONG_COMMAND; }
  322.   virtual int index_next_same(byte *buf, const byte *key, uint keylen);
  323.   virtual int index_read_last(byte * buf, const byte * key, uint key_len)
  324.    { return (my_errno=HA_ERR_WRONG_COMMAND); }
  325.   virtual int read_range_first(const key_range *start_key,
  326.                                const key_range *end_key,
  327.                                bool eq_range, bool sorted);
  328.   virtual int read_range_next();
  329.   int compare_key(key_range *range);
  330.   virtual int ft_init() { return HA_ERR_WRONG_COMMAND; }
  331.   void ft_end() { ft_handler=NULL; }
  332.   virtual FT_INFO *ft_init_ext(uint flags, uint inx,String *key)
  333.     { return NULL; }
  334.   virtual int ft_read(byte *buf) { return HA_ERR_WRONG_COMMAND; }
  335.   virtual int rnd_next(byte *buf)=0;
  336.   virtual int rnd_pos(byte * buf, byte *pos)=0;
  337.   virtual int read_first_row(byte *buf, uint primary_key);
  338.   /*
  339.     The following function is only needed for tables that may be temporary
  340.     tables during joins
  341.   */
  342.   virtual int restart_rnd_next(byte *buf, byte *pos)
  343.     { return HA_ERR_WRONG_COMMAND; }
  344.   virtual int rnd_same(byte *buf, uint inx)
  345.     { return HA_ERR_WRONG_COMMAND; }
  346.   virtual ha_rows records_in_range(uint inx, key_range *min_key,
  347.                                    key_range *max_key)
  348.     { return (ha_rows) 10; }
  349.   virtual void position(const byte *record)=0;
  350.   virtual void info(uint)=0;
  351.   virtual int extra(enum ha_extra_function operation)
  352.   { return 0; }
  353.   virtual int extra_opt(enum ha_extra_function operation, ulong cache_size)
  354.   { return extra(operation); }
  355.   virtual int reset() { return extra(HA_EXTRA_RESET); }
  356.   virtual int external_lock(THD *thd, int lock_type)=0;
  357.   virtual void unlock_row() {}
  358.   virtual int start_stmt(THD *thd) {return 0;}
  359.   /*
  360.     This is called to delete all rows in a table
  361.     If the handler don't support this, then this function will
  362.     return HA_ERR_WRONG_COMMAND and MySQL will delete the rows one
  363.     by one.
  364.   */
  365.   virtual int delete_all_rows()
  366.   { return (my_errno=HA_ERR_WRONG_COMMAND); }
  367.   virtual longlong get_auto_increment();
  368.   virtual void update_create_info(HA_CREATE_INFO *create_info) {}
  369.   /* admin commands - called from mysql_admin_table */
  370.   virtual int check(THD* thd, HA_CHECK_OPT* check_opt)
  371.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  372.   virtual int backup(THD* thd, HA_CHECK_OPT* check_opt)
  373.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  374.   /*
  375.     restore assumes .frm file must exist, and that generate_table() has been
  376.     called; It will just copy the data file and run repair.
  377.   */
  378.   virtual int restore(THD* thd, HA_CHECK_OPT* check_opt)
  379.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  380.   virtual int repair(THD* thd, HA_CHECK_OPT* check_opt)
  381.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  382.   virtual int optimize(THD* thd, HA_CHECK_OPT* check_opt)
  383.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  384.   virtual int analyze(THD* thd, HA_CHECK_OPT* check_opt)
  385.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  386.   virtual int assign_to_keycache(THD* thd, HA_CHECK_OPT* check_opt)
  387.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  388.   virtual int preload_keys(THD* thd, HA_CHECK_OPT* check_opt)
  389.   { return HA_ADMIN_NOT_IMPLEMENTED; }
  390.   /* end of the list of admin commands */
  391.   virtual bool check_and_repair(THD *thd) { return HA_ERR_WRONG_COMMAND; }
  392.   virtual int dump(THD* thd, int fd = -1) { return HA_ERR_WRONG_COMMAND; }
  393.   virtual int disable_indexes(uint mode) { return HA_ERR_WRONG_COMMAND; }
  394.   virtual int enable_indexes(uint mode) { return HA_ERR_WRONG_COMMAND; }
  395.   virtual int indexes_are_disabled(void) {return 0;}
  396.   virtual void start_bulk_insert(ha_rows rows) {}
  397.   virtual int end_bulk_insert() {return 0; }
  398.   virtual int discard_or_import_tablespace(my_bool discard)
  399.   {return HA_ERR_WRONG_COMMAND;}
  400.   virtual int net_read_dump(NET* net) { return HA_ERR_WRONG_COMMAND; }
  401.   virtual char *update_table_comment(const char * comment)
  402.   { return (char*) comment;}
  403.   virtual void append_create_info(String *packet) {}
  404.   virtual char* get_foreign_key_create_info()
  405.   { return(NULL);}  /* gets foreign key create string from InnoDB */
  406.   /* used in ALTER TABLE; 1 if changing storage engine is allowed */
  407.   virtual bool can_switch_engines() { return 1; }
  408.   /* used in REPLACE; is > 0 if table is referred by a FOREIGN KEY */
  409.   virtual uint referenced_by_foreign_key() { return 0;}
  410.   virtual void init_table_handle_for_HANDLER()
  411.   { return; }       /* prepare InnoDB for HANDLER */
  412.   virtual void free_foreign_key_create_info(char* str) {}
  413.   /* The following can be called without an open handler */
  414.   virtual const char *table_type() const =0;
  415.   virtual const char **bas_ext() const =0;
  416.   virtual ulong table_flags(void) const =0;
  417.   virtual ulong index_flags(uint idx, uint part, bool all_parts) const =0;
  418.   virtual ulong index_ddl_flags(KEY *wanted_index) const
  419.   { return (HA_DDL_SUPPORT); }
  420.   virtual int add_index(TABLE *table_arg, KEY *key_info, uint num_of_keys)
  421.   { return (HA_ERR_WRONG_COMMAND); }
  422.   virtual int drop_index(TABLE *table_arg, uint *key_num, uint num_of_keys)
  423.   { return (HA_ERR_WRONG_COMMAND); }
  424.   uint max_record_length() const
  425.   { return min(HA_MAX_REC_LENGTH, max_supported_record_length()); }
  426.   uint max_keys() const
  427.   { return min(MAX_KEY, max_supported_keys()); }
  428.   uint max_key_parts() const
  429.   { return min(MAX_REF_PARTS, max_supported_key_parts()); }
  430.   uint max_key_length() const
  431.   { return min(MAX_KEY_LENGTH, max_supported_key_length()); }
  432.   uint max_key_part_length() const
  433.   { return min(MAX_KEY_LENGTH, max_supported_key_part_length()); }
  434.   virtual uint max_supported_record_length() const { return HA_MAX_REC_LENGTH; }
  435.   virtual uint max_supported_keys() const { return 0; }
  436.   virtual uint max_supported_key_parts() const { return MAX_REF_PARTS; }
  437.   virtual uint max_supported_key_length() const { return MAX_KEY_LENGTH; }
  438.   virtual uint max_supported_key_part_length() const { return 255; }
  439.   virtual uint min_record_length(uint options) const { return 1; }
  440.   virtual bool low_byte_first() const { return 1; }
  441.   virtual uint checksum() const { return 0; }
  442.   virtual bool is_crashed() const  { return 0; }
  443.   virtual bool auto_repair() const { return 0; }
  444.   /*
  445.     default rename_table() and delete_table() rename/delete files with a
  446.     given name and extensions from bas_ext()
  447.   */
  448.   virtual int rename_table(const char *from, const char *to);
  449.   virtual int delete_table(const char *name);
  450.   
  451.   virtual int create(const char *name, TABLE *form, HA_CREATE_INFO *info)=0;
  452.   /* lock_count() can be more than one if the table is a MERGE */
  453.   virtual uint lock_count(void) const { return 1; }
  454.   virtual THR_LOCK_DATA **store_lock(THD *thd,
  455.      THR_LOCK_DATA **to,
  456.      enum thr_lock_type lock_type)=0;
  457.   /* Type of table for caching query */
  458.   virtual uint8 table_cache_type() { return HA_CACHE_TBL_NONTRANSACT; }
  459.   /*
  460.     Is query with this table cachable (have sense only for ASKTRANSACT
  461.     tables)
  462.   */
  463. };
  464. /* Some extern variables used with handlers */
  465. extern struct show_table_type_st sys_table_types[];
  466. extern const char *ha_row_type[];
  467. extern TYPELIB tx_isolation_typelib;
  468. extern TYPELIB myisam_stats_method_typelib;
  469. /* Wrapper functions */
  470. #define ha_commit_stmt(thd) (ha_commit_trans((thd), &((thd)->transaction.stmt)))
  471. #define ha_rollback_stmt(thd) (ha_rollback_trans((thd), &((thd)->transaction.stmt)))
  472. #define ha_commit(thd) (ha_commit_trans((thd), &((thd)->transaction.all)))
  473. #define ha_rollback(thd) (ha_rollback_trans((thd), &((thd)->transaction.all)))
  474. #define ha_supports_generate(T) (T != DB_TYPE_INNODB && 
  475.                                  T != DB_TYPE_BERKELEY_DB && 
  476.                                  T != DB_TYPE_ARCHIVE_DB && 
  477.                                  T != DB_TYPE_FEDERATED_DB && 
  478.                                  T != DB_TYPE_NDBCLUSTER)
  479. bool ha_caching_allowed(THD* thd, char* table_key,
  480.                         uint key_length, uint8 cache_type);
  481. enum db_type ha_resolve_by_name(const char *name, uint namelen);
  482. const char *ha_get_storage_engine(enum db_type db_type);
  483. handler *get_new_handler(TABLE *table, enum db_type db_type);
  484. my_off_t ha_get_ptr(byte *ptr, uint pack_length);
  485. void ha_store_ptr(byte *buff, uint pack_length, my_off_t pos);
  486. int ha_init(void);
  487. int ha_panic(enum ha_panic_function flag);
  488. void ha_close_connection(THD* thd);
  489. enum db_type ha_checktype(enum db_type database_type);
  490. my_bool ha_storage_engine_is_enabled(enum db_type database_type);
  491. int ha_create_table(const char *name, HA_CREATE_INFO *create_info,
  492.     bool update_create_info);
  493. int ha_create_table_from_engine(THD* thd, const char *db, const char *name);
  494. int ha_delete_table(enum db_type db_type, const char *path);
  495. void ha_drop_database(char* path);
  496. int ha_init_key_cache(const char *name, KEY_CACHE *key_cache);
  497. int ha_resize_key_cache(KEY_CACHE *key_cache);
  498. int ha_change_key_cache_param(KEY_CACHE *key_cache);
  499. int ha_end_key_cache(KEY_CACHE *key_cache);
  500. int ha_start_stmt(THD *thd);
  501. int ha_report_binlog_offset_and_commit(THD *thd, char *log_file_name,
  502.        my_off_t end_offset);
  503. int ha_commit_complete(THD *thd);
  504. int ha_release_temporary_latches(THD *thd);
  505. int ha_commit_trans(THD *thd, THD_TRANS *trans);
  506. int ha_rollback_trans(THD *thd, THD_TRANS *trans);
  507. int ha_rollback_to_savepoint(THD *thd, char *savepoint_name);
  508. int ha_savepoint(THD *thd, char *savepoint_name);
  509. int ha_autocommit_or_rollback(THD *thd, int error);
  510. void ha_set_spin_retries(uint retries);
  511. bool ha_flush_logs(void);
  512. int ha_enable_transaction(THD *thd, bool on);
  513. int ha_change_key_cache(KEY_CACHE *old_key_cache,
  514. KEY_CACHE *new_key_cache);
  515. int ha_discover(THD* thd, const char* dbname, const char* name,
  516. const void** frmblob, uint* frmlen);
  517. int ha_find_files(THD *thd,const char *db,const char *path,
  518.   const char *wild, bool dir,List<char>* files);
  519. int ha_table_exists_in_engine(THD* thd, const char* db, const char* name);
  520. TYPELIB *ha_known_exts(void);
  521. int ha_start_consistent_snapshot(THD *thd);