1
/*****************************************************************************
3
Copyright (C) 2000, 2010, MySQL AB & Innobase Oy. All Rights Reserved.
5
This program is free software; you can redistribute it and/or modify it under
6
the terms of the GNU General Public License as published by the Free Software
7
Foundation; version 2 of the License.
9
This program is distributed in the hope that it will be useful, but WITHOUT
10
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
11
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
13
You should have received a copy of the GNU General Public License along with
14
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
15
St, Fifth Floor, Boston, MA 02110-1301 USA
17
*****************************************************************************/
20
This file is based on ha_berkeley.h of MySQL distribution
22
This file defines the Innodb Cursor: the interface between MySQL and
26
#ifndef INNODB_HANDLER_HA_INNODB_H
27
#define INNODB_HANDLER_HA_INNODB_H
29
#include <drizzled/cursor.h>
30
#include <drizzled/thr_lock.h>
31
#include <drizzled/plugin/transactional_storage_engine.h>
33
using namespace drizzled;
35
/* Structure defines translation table between mysql index and innodb
37
typedef struct innodb_idx_translate_struct {
38
ulint index_count; /*!< number of valid index entries
39
in the index_mapping array */
40
ulint array_size; /*!< array size of index_mapping */
41
dict_index_t** index_mapping; /*!< index pointer array directly
42
maps to index in Innodb from MySQL
44
} innodb_idx_translate_t;
46
/** InnoDB table share */
47
typedef struct st_innobase_share {
48
THR_LOCK lock; /*!< MySQL lock protecting
50
char table_name[FN_REFLEN]; /*!< InnoDB table name */
51
uint use_count; /*!< reference count,
52
incremented in get_share()
53
and decremented in free_share() */
54
void* table_name_hash;/*!< hash table chain node */
55
innodb_idx_translate_t idx_trans_tbl; /*!< index translation
56
table between MySQL and
59
st_innobase_share(const char *arg) :
62
strncpy(table_name, arg, FN_REFLEN);
68
/** InnoDB B-tree index */
69
struct dict_index_struct;
70
/** Prebuilt structures in an Innobase table handle used within MySQL */
71
struct row_prebuilt_struct;
73
/** InnoDB B-tree index */
74
typedef struct dict_index_struct dict_index_t;
75
/** Prebuilt structures in an Innobase table handle used within MySQL */
76
typedef struct row_prebuilt_struct row_prebuilt_t;
78
/** The class defining a handle to an Innodb table */
79
class ha_innobase: public Cursor
81
row_prebuilt_t* prebuilt; /*!< prebuilt struct in InnoDB, used
82
to save CPU time with prebuilt data
84
Session* user_session; /*!< the thread handle of the user
85
currently using the handle; this is
86
set in external_lock function */
88
INNOBASE_SHARE* share; /*!< information for MySQL
91
std::vector<unsigned char> upd_buff; /*!< buffer used in updates */
92
std::vector<unsigned char> key_val_buff; /*!< buffer used in converting
93
search key values from MySQL format
95
ulong upd_and_key_val_buff_len;
96
/* the length of each of the previous
99
ulong start_of_scan; /*!< this is set to 1 when we are
100
starting a table scan but have not
101
yet fetched any row, else 0 */
102
uint last_match_mode;/* match mode of the latest search:
103
ROW_SEL_EXACT, ROW_SEL_EXACT_PREFIX,
105
uint num_write_row; /*!< number of doInsertRecord() calls */
107
UNIV_INTERN uint store_key_val_for_row(uint keynr, char* buff,
108
uint buff_len, const unsigned char* record);
109
UNIV_INTERN void update_session(Session* session);
110
UNIV_INTERN int change_active_index(uint32_t keynr);
111
UNIV_INTERN int general_fetch(unsigned char* buf, uint32_t direction, uint32_t match_mode);
112
UNIV_INTERN ulint innobase_lock_autoinc();
113
UNIV_INTERN uint64_t innobase_peek_autoinc();
114
UNIV_INTERN ulint innobase_set_max_autoinc(uint64_t auto_inc);
115
UNIV_INTERN ulint innobase_reset_autoinc(uint64_t auto_inc);
116
UNIV_INTERN ulint innobase_get_autoinc(uint64_t* value);
117
ulint innobase_update_autoinc(uint64_t auto_inc);
118
UNIV_INTERN void innobase_initialize_autoinc();
119
UNIV_INTERN dict_index_t* innobase_get_index(uint keynr);
121
/* Init values for the class: */
123
UNIV_INTERN ha_innobase(plugin::StorageEngine &engine,
125
UNIV_INTERN ~ha_innobase();
127
* Returns the plugin::TransactionStorageEngine pointer
128
* of the cursor's underlying engine.
132
* Have a TransactionalCursor subclass...
134
UNIV_INTERN plugin::TransactionalStorageEngine *getTransactionalEngine()
136
return static_cast<plugin::TransactionalStorageEngine *>(getEngine());
139
UNIV_INTERN const char* index_type(uint key_number);
140
UNIV_INTERN const key_map* keys_to_use_for_scanning();
142
UNIV_INTERN int doOpen(const drizzled::identifier::Table &identifier, int mode, uint test_if_locked);
143
UNIV_INTERN int close(void);
144
UNIV_INTERN double scan_time();
145
UNIV_INTERN double read_time(uint index, uint ranges, ha_rows rows);
147
UNIV_INTERN int doInsertRecord(unsigned char * buf);
148
UNIV_INTERN int doUpdateRecord(const unsigned char * old_data, unsigned char * new_data);
149
UNIV_INTERN int doDeleteRecord(const unsigned char * buf);
150
UNIV_INTERN bool was_semi_consistent_read();
151
UNIV_INTERN void try_semi_consistent_read(bool yes);
152
UNIV_INTERN void unlock_row();
154
UNIV_INTERN int doStartIndexScan(uint index, bool sorted);
155
UNIV_INTERN int doEndIndexScan();
156
UNIV_INTERN int index_read(unsigned char * buf, const unsigned char * key,
157
uint key_len, enum ha_rkey_function find_flag);
158
UNIV_INTERN int index_read_idx(unsigned char * buf, uint index, const unsigned char * key,
159
uint key_len, enum ha_rkey_function find_flag);
160
UNIV_INTERN int index_read_last(unsigned char * buf, const unsigned char * key, uint key_len);
161
UNIV_INTERN int index_next(unsigned char * buf);
162
UNIV_INTERN int index_next_same(unsigned char * buf, const unsigned char *key, uint keylen);
163
UNIV_INTERN int index_prev(unsigned char * buf);
164
UNIV_INTERN int index_first(unsigned char * buf);
165
UNIV_INTERN int index_last(unsigned char * buf);
167
UNIV_INTERN int doStartTableScan(bool scan);
168
UNIV_INTERN int doEndTableScan();
169
UNIV_INTERN int rnd_next(unsigned char *buf);
170
UNIV_INTERN int rnd_pos(unsigned char * buf, unsigned char *pos);
172
UNIV_INTERN void position(const unsigned char *record);
173
UNIV_INTERN int info(uint);
174
UNIV_INTERN int analyze(Session* session);
175
UNIV_INTERN int discard_or_import_tablespace(bool discard);
176
UNIV_INTERN int extra(enum ha_extra_function operation);
177
UNIV_INTERN int reset();
178
UNIV_INTERN int external_lock(Session *session, int lock_type);
179
void position(unsigned char *record);
180
UNIV_INTERN ha_rows records_in_range(uint inx, key_range *min_key, key_range
182
UNIV_INTERN ha_rows estimate_rows_upper_bound();
184
UNIV_INTERN int delete_all_rows();
185
UNIV_INTERN int check(Session* session);
186
UNIV_INTERN char* update_table_comment(const char* comment);
187
UNIV_INTERN char* get_foreign_key_create_info();
188
UNIV_INTERN int get_foreign_key_list(Session *session, List<ForeignKeyInfo> *f_key_list);
189
UNIV_INTERN bool can_switch_engines();
190
UNIV_INTERN uint referenced_by_foreign_key();
191
UNIV_INTERN void free_foreign_key_create_info(char* str);
192
UNIV_INTERN THR_LOCK_DATA **store_lock(Session *session, THR_LOCK_DATA **to,
193
enum thr_lock_type lock_type);
194
UNIV_INTERN virtual void get_auto_increment(uint64_t offset,
196
uint64_t nb_desired_values,
197
uint64_t *first_value,
198
uint64_t *nb_reserved_values);
199
UNIV_INTERN int reset_auto_increment(uint64_t value);
201
UNIV_INTERN bool primary_key_is_clustered();
202
UNIV_INTERN int cmp_ref(const unsigned char *ref1, const unsigned char *ref2);
203
/** Fast index creation (smart ALTER TABLE) @see handler0alter.cc @{ */
204
// Don't use these, I have just left them in here as reference for
205
// the future. -Brian
207
UNIV_INTERN int add_index(Session *session, TABLE *table_arg, KeyInfo *key_info, uint num_of_keys);
208
UNIV_INTERN int prepare_drop_index(Session *session,
212
UNIV_INTERN int final_drop_index(Session *session, TABLE *table_arg);
216
int read_range_first(const key_range *start_key, const key_range *end_key,
217
bool eq_range_arg, bool sorted);
218
int read_range_next();
222
/** Get the file name of the MySQL binlog.
223
* @return the name of the binlog file
225
const char* drizzle_bin_log_file_name(void);
227
/** Get the current position of the MySQL binlog.
228
* @return byte offset from the beginning of the binlog
230
uint64_t drizzle_bin_log_file_pos(void);
233
Check if a user thread is a replication slave thread
234
@param session user thread
235
@retval 0 the user thread is not a replication slave thread
236
@retval 1 the user thread is a replication slave thread
238
int session_slave_thread(const Session *session);
240
typedef struct trx_struct trx_t;
241
/********************************************************************//**
242
@file Cursor/ha_innodb.h
243
Converts an InnoDB error code to a MySQL error code and also tells to MySQL
244
about a possible transaction rollback inside InnoDB caused by a lock wait
245
timeout or a deadlock.
246
@return MySQL error code */
249
convert_error_code_to_mysql(
250
/*========================*/
251
int error, /*!< in: InnoDB error code */
252
ulint flags, /*!< in: InnoDB table flags, or 0 */
253
Session *session); /*!< in: user thread handle or NULL */
255
/*********************************************************************//**
256
Allocates an InnoDB transaction for a MySQL Cursor object.
257
@return InnoDB transaction handle */
260
innobase_trx_allocate(
261
/*==================*/
262
Session *session); /*!< in: user thread handle */
264
/***********************************************************************
265
This function checks each index name for a table against reserved
266
system default primary index name 'GEN_CLUST_INDEX'. If a name matches,
267
this function pushes an error message to the client, and returns true. */
269
innobase_index_name_is_reserved(
270
/*============================*/
271
/* out: true if index name matches a
273
const trx_t* trx, /* in: InnoDB transaction handle */
274
const drizzled::KeyInfo* key_info,/* in: Indexes to be created */
275
ulint num_of_keys); /* in: Number of indexes to
278
#endif /* INNODB_HANDLER_HA_INNODB_H */