ha_innodb.h 8.19 KB
Newer Older
1
/* Copyright (C) 2000 MySQL AB && Innobase Oy
2 3 4 5 6

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
7

8 9 10 11
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
12

13 14 15 16
   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */

17 18 19 20 21 22 23
/*
  This file is based on ha_berkeley.h of MySQL distribution

  This file defines the Innodb handler: the interface between MySQL and
  Innodb
*/

24 25 26 27 28 29 30 31 32 33 34
#ifdef __GNUC__
#pragma interface			/* gcc class implementation */
#endif

typedef struct st_innobase_share {
  THR_LOCK lock;
  pthread_mutex_t mutex;
  char *table_name;
  uint table_name_length,use_count;
} INNOBASE_SHARE;

unknown's avatar
unknown committed
35

36
/* The class defining a handle to an Innodb table */
37 38 39
class ha_innobase: public handler
{
	void*	innobase_prebuilt;	/* (row_prebuilt_t*) prebuilt
40
					struct in Innodb, used to save
41 42 43 44
					CPU */
	THD*		user_thd;	/* the thread handle of the user
					currently using the handle; this is
					set in external_lock function */
unknown's avatar
unknown committed
45 46
	ulong           last_query_id;  /* the latest query id where the
					handle was used */
47 48 49 50 51 52 53
  	THR_LOCK_DATA 	lock;
	INNOBASE_SHARE  *share;

  	gptr 		alloc_ptr;
  	byte*		upd_buff;	/* buffer used in updates */
  	byte*		key_val_buff;	/* buffer used in converting
  					search key values from MySQL format
54
  					to Innodb format */
unknown's avatar
unknown committed
55 56 57
	ulong		upd_and_key_val_buff_len;
					/* the length of each of the previous
					two buffers */
58
  	ulong 		int_table_flags;
59
  	uint 		primary_key;
unknown's avatar
unknown committed
60
	uint		last_dup_key;
61 62 63
	ulong		start_of_scan;	/* this is set to 1 when we are
					starting a table scan but have not
					yet fetched any row, else 0 */
64
	uint		last_match_mode;/* match mode of the latest search:
65 66
					ROW_SEL_EXACT, ROW_SEL_EXACT_PREFIX,
					or undefined */
unknown's avatar
Merge  
unknown committed
67
	longlong	auto_inc_counter_for_this_stat;
unknown's avatar
unknown committed
68
	ulong max_supported_row_length(const byte *buf);
69

70 71
	uint store_key_val_for_row(uint keynr, char* buff, uint buff_len,
					       const byte* record);
72 73 74
	int update_thd(THD* thd);
	int change_active_index(uint keynr);
	int general_fetch(byte* buf, uint direction, uint match_mode);
unknown's avatar
unknown committed
75
	int innobase_read_and_init_auto_inc(longlong* ret);
76 77 78 79

	/* Init values for the class: */
 public:
  	ha_innobase(TABLE *table): handler(table),
80
	  int_table_flags(HA_REC_NOT_IN_SEQ |
unknown's avatar
unknown committed
81 82
			  HA_NULL_IN_KEY | HA_FAST_KEY_READ |
			  HA_CAN_INDEX_BLOBS |
unknown's avatar
unknown committed
83
			  HA_CAN_SQL_HANDLER |
84
			  HA_NOT_EXACT_COUNT |
85
			  HA_PRIMARY_KEY_IN_READ_INDEX |
86
			  HA_TABLE_SCAN_ON_INDEX),
87 88
	  last_dup_key((uint) -1),
	  start_of_scan(0)
89 90 91 92
  	{
  	}
  	~ha_innobase() {}

unknown's avatar
unknown committed
93
  	const char* table_type() const { return("InnoDB");}
94
	const char *index_type(uint key_number) { return "BTREE"; }
95
  	const char** bas_ext() const;
96
 	ulong table_flags() const { return int_table_flags; }
97
	ulong index_flags(uint idx, uint part, bool all_parts) const
98
	{
unknown's avatar
unknown committed
99 100
	  return (HA_READ_NEXT | HA_READ_PREV | HA_READ_ORDER | HA_READ_RANGE |
                  HA_KEYREAD_ONLY);
101
	}
unknown's avatar
unknown committed
102
  	uint max_supported_keys()          const { return MAX_KEY; }
unknown's avatar
unknown committed
103 104 105 106
				/* An InnoDB page must store >= 2 keys;
				a secondary key record must also contain the
				primary key value:
				max key length is therefore set to slightly
unknown's avatar
unknown committed
107 108 109
				less than 1 / 4 of page size which is 16 kB;
				but currently MySQL does not work with keys
				whose size is > MAX_KEY_LENGTH */
unknown's avatar
unknown committed
110 111
  	uint max_supported_key_length() const { return 3500; }
  	uint max_supported_key_part_length() const { return 3500; }
unknown's avatar
unknown committed
112
	const key_map *keys_to_use_for_scanning() { return &key_map_full; }
113 114
  	bool has_transactions()  { return 1;}

unknown's avatar
unknown committed
115
  	int open(const char *name, int mode, uint test_if_locked);
116 117
  	int close(void);
  	double scan_time();
unknown's avatar
unknown committed
118
	double read_time(uint index, uint ranges, ha_rows rows);
119 120 121 122 123 124 125 126

  	int write_row(byte * buf);
  	int update_row(const byte * old_data, byte * new_data);
  	int delete_row(const byte * buf);

  	int index_init(uint index);
  	int index_end();
  	int index_read(byte * buf, const byte * key,
127
		       uint key_len, enum ha_rkey_function find_flag);
128
  	int index_read_idx(byte * buf, uint index, const byte * key,
129 130
			   uint key_len, enum ha_rkey_function find_flag);
	int index_read_last(byte * buf, const byte * key, uint key_len);
131 132 133 134 135 136
  	int index_next(byte * buf);
  	int index_next_same(byte * buf, const byte *key, uint keylen);
  	int index_prev(byte * buf);
  	int index_first(byte * buf);
  	int index_last(byte * buf);

137
  	int rnd_init(bool scan);
138 139 140 141 142 143
  	int rnd_end();
  	int rnd_next(byte *buf);
  	int rnd_pos(byte * buf, byte *pos);

  	void position(const byte *record);
  	void info(uint);
unknown's avatar
unknown committed
144
        int analyze(THD* thd,HA_CHECK_OPT* check_opt);
145
        int optimize(THD* thd,HA_CHECK_OPT* check_opt);
unknown's avatar
unknown committed
146
	int discard_or_import_tablespace(my_bool discard);
147 148
  	int extra(enum ha_extra_function operation);
  	int external_lock(THD *thd, int lock_type);
unknown's avatar
unknown committed
149 150
	int start_stmt(THD *thd);

151
  	void position(byte *record);
unknown's avatar
unknown committed
152
  	ha_rows records_in_range(uint inx, key_range *min_key, key_range *max_key);
unknown's avatar
unknown committed
153
	ha_rows estimate_rows_upper_bound();
154 155 156 157 158

  	int create(const char *name, register TABLE *form,
					HA_CREATE_INFO *create_info);
  	int delete_table(const char *name);
	int rename_table(const char* from, const char* to);
unknown's avatar
unknown committed
159
	int check(THD* thd, HA_CHECK_OPT* check_opt);
160
        char* update_table_comment(const char* comment);
unknown's avatar
unknown committed
161
	char* get_foreign_key_create_info();
unknown's avatar
unknown committed
162
  	uint referenced_by_foreign_key();
unknown's avatar
unknown committed
163
	void free_foreign_key_create_info(char* str);	
164 165
  	THR_LOCK_DATA **store_lock(THD *thd, THR_LOCK_DATA **to,
			     		enum thr_lock_type lock_type);
unknown's avatar
unknown committed
166
	void init_table_handle_for_HANDLER(); 
167
	longlong get_auto_increment();
unknown's avatar
unknown committed
168
        uint8 table_cache_type() { return HA_CACHE_TBL_ASKTRANSACT; }
unknown's avatar
unknown committed
169 170 171

        static char      *get_mysql_bin_log_name();
        static ulonglong get_mysql_bin_log_pos();
172 173 174
};

extern uint innobase_init_flags, innobase_lock_type;
unknown's avatar
unknown committed
175
extern uint innobase_flush_log_at_trx_commit;
176 177 178
extern ulong innobase_cache_size;
extern char *innobase_home, *innobase_tmpdir, *innobase_logdir;
extern long innobase_lock_scan_time;
unknown's avatar
unknown committed
179
extern long innobase_mirrored_log_groups, innobase_log_files_in_group;
180
extern long innobase_log_file_size, innobase_log_buffer_size;
unknown's avatar
unknown committed
181 182
extern long innobase_buffer_pool_size, innobase_additional_mem_pool_size;
extern long innobase_buffer_pool_awe_mem_mb;
183
extern long innobase_file_io_threads, innobase_lock_wait_timeout;
unknown's avatar
Merge  
unknown committed
184
extern long innobase_force_recovery, innobase_thread_concurrency;
unknown's avatar
unknown committed
185
extern long innobase_open_files;
186
extern long innobase_auto_extend_increment;
187 188
extern char *innobase_data_home_dir, *innobase_data_file_path;
extern char *innobase_log_group_home_dir, *innobase_log_arch_dir;
189
extern char *innobase_unix_file_flush_method;
unknown's avatar
unknown committed
190
/* The following variables have to be my_bool for SHOW VARIABLES to work */
unknown's avatar
unknown committed
191
extern my_bool innobase_log_archive,
unknown's avatar
unknown committed
192
               innobase_use_native_aio, innobase_fast_shutdown,
unknown's avatar
unknown committed
193
	       innobase_file_per_table, innobase_locks_unsafe_for_binlog,
194
               innobase_create_status_file;
195 196 197
extern "C" {
extern ulong srv_max_buf_pool_modified_pct;
}
198 199 200 201 202 203

extern TYPELIB innobase_lock_typelib;

bool innobase_init(void);
bool innobase_end(void);
bool innobase_flush_logs(void);
204
uint innobase_get_free_space(void);
205

unknown's avatar
unknown committed
206
int innobase_commit(THD *thd, void* trx_handle);
207 208 209 210 211
int innobase_report_binlog_offset_and_commit(
        THD*    thd,
	void*	trx_handle,
        char*   log_file_name,
        my_off_t end_offset);
unknown's avatar
unknown committed
212 213
int innobase_commit_complete(
        void*   trx_handle);
unknown's avatar
unknown committed
214
int innobase_rollback(THD *thd, void* trx_handle);
unknown's avatar
unknown committed
215 216 217 218 219 220 221 222
int innobase_rollback_to_savepoint(
	THD*	thd,
	char*	savepoint_name,
	my_off_t* binlog_cache_pos);
int innobase_savepoint(
	THD*	thd,
	char*	savepoint_name,
	my_off_t binlog_cache_pos);
223
int innobase_close_connection(THD *thd);
224
int innobase_drop_database(char *path);
unknown's avatar
unknown committed
225
int innodb_show_status(THD* thd);
226

unknown's avatar
unknown committed
227 228
my_bool innobase_query_caching_of_table_permitted(THD* thd, char* full_name,
						uint full_name_len);
229
void innobase_release_temporary_latches(void* innobase_tid);
unknown's avatar
unknown committed
230 231

void innobase_store_binlog_offset_and_flush_log(char *binlog_name,longlong offset);
232