← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to drizzled/plugin/storage_engine.h

  • Committer: Jay Pipes
  • Date: 2009-09-21 14:33:44 UTC
  • mfrom: (1126.10.26 dtrace-probes)
  • mto: This revision was merged to the branch mainline in revision 1133.
  • Revision ID: jpipes@serialcoder-20090921143344-jnarp7gcn6zmg19c
Merge fixes from Trond and Padraig on dtrace probes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
drizzled/plugin/storage_engine.h
22
22
 
23
23
 
24
24
#include <drizzled/definitions.h>
25
 
#include <drizzled/plugin.h>
 
25
#include <drizzled/sql_plugin.h>
26
26
#include <drizzled/handler_structs.h>
27
 
#include <drizzled/message/schema.pb.h>
28
27
#include <drizzled/message/table.pb.h>
29
 
#include "drizzled/plugin/plugin.h"
30
 
#include "drizzled/sql_string.h"
31
 
#include "drizzled/schema_identifier.h"
32
 
#include "drizzled/table_identifier.h"
33
 
#include "drizzled/cached_directory.h"
34
 
#include "drizzled/plugin/monitored_in_transaction.h"
35
 
 
36
 
#include "drizzled/hash.h"
 
28
#include <drizzled/registry.h>
37
29
 
38
30
#include <bitset>
39
31
#include <string>
40
32
#include <vector>
41
 
#include <set>
42
 
 
43
 
namespace drizzled
44
 
{
45
33
 
46
34
class TableList;
47
35
class Session;
48
 
class Cursor;
49
 
typedef struct st_hash HASH;
 
36
class XID;
 
37
class handler;
50
38
 
51
39
class TableShare;
52
 
typedef drizzle_lex_string LEX_STRING;
 
40
typedef struct st_mysql_lex_string LEX_STRING;
53
41
typedef bool (stat_print_fn)(Session *session, const char *type, uint32_t type_len,
54
42
                             const char *file, uint32_t file_len,
55
43
                             const char *status, uint32_t status_len);
 
44
enum ha_stat_type { HA_ENGINE_STATUS, HA_ENGINE_LOGS, HA_ENGINE_MUTEX };
56
45
 
57
46
/* Possible flags of a StorageEngine (there can be 32 of them) */
58
47
enum engine_flag_bits {
59
48
  HTON_BIT_ALTER_NOT_SUPPORTED,       // Engine does not support alter
 
49
  HTON_BIT_CAN_RECREATE,              // Delete all is used for truncate
60
50
  HTON_BIT_HIDDEN,                    // Engine does not appear in lists
 
51
  HTON_BIT_FLUSH_AFTER_RENAME,
61
52
  HTON_BIT_NOT_USER_SELECTABLE,
62
53
  HTON_BIT_TEMPORARY_NOT_SUPPORTED,   // Having temporary tables not supported
63
54
  HTON_BIT_TEMPORARY_ONLY,
64
55
  HTON_BIT_FILE_BASED, // use for check_lowercase_names
65
 
  HTON_BIT_DOES_TRANSACTIONS,
66
 
  HTON_BIT_STATS_RECORDS_IS_EXACT,
67
 
  HTON_BIT_NULL_IN_KEY,
68
 
  HTON_BIT_CAN_INDEX_BLOBS,
69
 
  HTON_BIT_PRIMARY_KEY_REQUIRED_FOR_POSITION,
70
 
  HTON_BIT_PRIMARY_KEY_IN_READ_INDEX,
71
 
  HTON_BIT_PARTIAL_COLUMN_READ,
72
 
  HTON_BIT_TABLE_SCAN_ON_INDEX,
73
 
  HTON_BIT_FAST_KEY_READ,
74
 
  HTON_BIT_NO_BLOBS,
75
 
  HTON_BIT_HAS_RECORDS,
76
 
  HTON_BIT_NO_AUTO_INCREMENT,
77
 
  HTON_BIT_DUPLICATE_POS,
78
 
  HTON_BIT_AUTO_PART_KEY,
79
 
  HTON_BIT_REQUIRE_PRIMARY_KEY,
80
 
  HTON_BIT_REQUIRES_KEY_COLUMNS_FOR_DELETE,
81
 
  HTON_BIT_PRIMARY_KEY_REQUIRED_FOR_DELETE,
82
 
  HTON_BIT_NO_PREFIX_CHAR_KEYS,
83
 
  HTON_BIT_HAS_CHECKSUM,
84
 
  HTON_BIT_SKIP_STORE_LOCK,
85
 
  HTON_BIT_SCHEMA_DICTIONARY,
86
 
  HTON_BIT_FOREIGN_KEYS,
 
56
  HTON_BIT_HAS_DATA_DICTIONARY,
87
57
  HTON_BIT_SIZE
88
58
};
89
59
 
90
60
static const std::bitset<HTON_BIT_SIZE> HTON_NO_FLAGS(0);
91
61
static const std::bitset<HTON_BIT_SIZE> HTON_ALTER_NOT_SUPPORTED(1 << HTON_BIT_ALTER_NOT_SUPPORTED);
 
62
static const std::bitset<HTON_BIT_SIZE> HTON_CAN_RECREATE(1 << HTON_BIT_CAN_RECREATE);
92
63
static const std::bitset<HTON_BIT_SIZE> HTON_HIDDEN(1 << HTON_BIT_HIDDEN);
 
64
static const std::bitset<HTON_BIT_SIZE> HTON_FLUSH_AFTER_RENAME(1 << HTON_BIT_FLUSH_AFTER_RENAME);
93
65
static const std::bitset<HTON_BIT_SIZE> HTON_NOT_USER_SELECTABLE(1 << HTON_BIT_NOT_USER_SELECTABLE);
94
66
static const std::bitset<HTON_BIT_SIZE> HTON_TEMPORARY_NOT_SUPPORTED(1 << HTON_BIT_TEMPORARY_NOT_SUPPORTED);
95
67
static const std::bitset<HTON_BIT_SIZE> HTON_TEMPORARY_ONLY(1 << HTON_BIT_TEMPORARY_ONLY);
96
68
static const std::bitset<HTON_BIT_SIZE> HTON_FILE_BASED(1 << HTON_BIT_FILE_BASED);
97
 
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_DOES_TRANSACTIONS(1 << HTON_BIT_DOES_TRANSACTIONS);
98
 
static const std::bitset<HTON_BIT_SIZE> HTON_STATS_RECORDS_IS_EXACT(1 << HTON_BIT_STATS_RECORDS_IS_EXACT);
99
 
static const std::bitset<HTON_BIT_SIZE> HTON_NULL_IN_KEY(1 << HTON_BIT_NULL_IN_KEY);
100
 
static const std::bitset<HTON_BIT_SIZE> HTON_CAN_INDEX_BLOBS(1 << HTON_BIT_CAN_INDEX_BLOBS);
101
 
static const std::bitset<HTON_BIT_SIZE> HTON_PRIMARY_KEY_REQUIRED_FOR_POSITION(1 << HTON_BIT_PRIMARY_KEY_REQUIRED_FOR_POSITION);
102
 
static const std::bitset<HTON_BIT_SIZE> HTON_PRIMARY_KEY_IN_READ_INDEX(1 << HTON_BIT_PRIMARY_KEY_IN_READ_INDEX);
103
 
static const std::bitset<HTON_BIT_SIZE> HTON_PARTIAL_COLUMN_READ(1 << HTON_BIT_PARTIAL_COLUMN_READ);
104
 
static const std::bitset<HTON_BIT_SIZE> HTON_TABLE_SCAN_ON_INDEX(1 << HTON_BIT_TABLE_SCAN_ON_INDEX);
105
 
static const std::bitset<HTON_BIT_SIZE> HTON_FAST_KEY_READ(1 << HTON_BIT_FAST_KEY_READ);
106
 
static const std::bitset<HTON_BIT_SIZE> HTON_NO_BLOBS(1 << HTON_BIT_NO_BLOBS);
107
 
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_RECORDS(1 << HTON_BIT_HAS_RECORDS);
108
 
static const std::bitset<HTON_BIT_SIZE> HTON_NO_AUTO_INCREMENT(1 << HTON_BIT_NO_AUTO_INCREMENT);
109
 
static const std::bitset<HTON_BIT_SIZE> HTON_DUPLICATE_POS(1 << HTON_BIT_DUPLICATE_POS);
110
 
static const std::bitset<HTON_BIT_SIZE> HTON_AUTO_PART_KEY(1 << HTON_BIT_AUTO_PART_KEY);
111
 
static const std::bitset<HTON_BIT_SIZE> HTON_REQUIRE_PRIMARY_KEY(1 << HTON_BIT_REQUIRE_PRIMARY_KEY);
112
 
static const std::bitset<HTON_BIT_SIZE> HTON_REQUIRES_KEY_COLUMNS_FOR_DELETE(1 << HTON_BIT_REQUIRES_KEY_COLUMNS_FOR_DELETE);
113
 
static const std::bitset<HTON_BIT_SIZE> HTON_PRIMARY_KEY_REQUIRED_FOR_DELETE(1 << HTON_BIT_PRIMARY_KEY_REQUIRED_FOR_DELETE);
114
 
static const std::bitset<HTON_BIT_SIZE> HTON_NO_PREFIX_CHAR_KEYS(1 << HTON_BIT_NO_PREFIX_CHAR_KEYS);
115
 
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_CHECKSUM(1 << HTON_BIT_HAS_CHECKSUM);
116
 
static const std::bitset<HTON_BIT_SIZE> HTON_SKIP_STORE_LOCK(1 << HTON_BIT_SKIP_STORE_LOCK);
117
 
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_SCHEMA_DICTIONARY(1 << HTON_BIT_SCHEMA_DICTIONARY);
118
 
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_FOREIGN_KEYS(1 << HTON_BIT_FOREIGN_KEYS);
119
 
 
 
69
static const std::bitset<HTON_BIT_SIZE> HTON_HAS_DATA_DICTIONARY(1 << HTON_BIT_HAS_DATA_DICTIONARY);
120
70
 
121
71
class Table;
122
 
class NamedSavepoint;
123
 
 
124
 
namespace plugin
125
 
{
126
 
 
127
 
typedef hash_map<std::string, StorageEngine *> EngineMap;
128
 
typedef std::vector<StorageEngine *> EngineVector;
129
 
 
130
 
typedef std::set<std::string> TableNameList;
131
 
 
132
 
extern const std::string UNKNOWN_STRING;
133
 
extern const std::string DEFAULT_DEFINITION_FILE_EXT;
 
72
class TableNameIteratorImplementation;
134
73
 
135
74
/*
136
75
  StorageEngine is a singleton structure - one instance per storage engine -
137
76
  to provide access to storage engine functionality that works on the
138
 
  "global" level (unlike Cursor class that works on a per-table basis)
 
77
  "global" level (unlike handler class that works on a per-table basis)
139
78
 
140
79
  usually StorageEngine instance is defined statically in ha_xxx.cc as
141
80
 
142
81
  static StorageEngine { ... } xxx_engine;
 
82
 
 
83
  savepoint_*, prepare, recover, and *_by_xid pointers can be 0.
143
84
*/
144
 
class StorageEngine : public Plugin,
145
 
                      public MonitoredInTransaction
 
85
class StorageEngine
146
86
{
147
 
public:
148
 
  typedef uint64_t Table_flags;
149
 
 
150
 
private:
151
 
  const std::bitset<HTON_BIT_SIZE> flags; /* global Cursor flags */
152
 
 
153
 
  static EngineVector &getSchemaEngines();
154
 
 
155
 
  virtual void setTransactionReadWrite(Session& session);
156
 
 
157
 
  /*
158
 
   * Indicates to a storage engine the start of a
159
 
   * new SQL statement.
160
 
   */
161
 
  virtual void doStartStatement(Session *session)
162
 
  {
163
 
    (void) session;
164
 
  }
165
 
 
166
 
  /*
167
 
   * Indicates to a storage engine the end of
168
 
   * the current SQL statement in the supplied
169
 
   * Session.
170
 
   */
171
 
  virtual void doEndStatement(Session *session)
172
 
  {
173
 
    (void) session;
174
 
  }
175
 
 
176
 
protected:
177
 
  std::string table_definition_ext;
178
 
 
179
 
public:
180
 
  const std::string& getTableDefinitionFileExtension()
181
 
  {
182
 
    return table_definition_ext;
183
 
  }
184
 
 
185
 
private:
 
87
  /*
 
88
    Name used for storage engine.
 
89
  */
 
90
  const std::string name;
 
91
  const bool two_phase_commit;
 
92
  bool enabled;
 
93
 
 
94
  const std::bitset<HTON_BIT_SIZE> flags; /* global handler flags */
 
95
  /*
 
96
    to store per-savepoint data storage engine is provided with an area
 
97
    of a requested size (0 is ok here).
 
98
    savepoint_offset must be initialized statically to the size of
 
99
    the needed memory to store per-savepoint information.
 
100
    After xxx_init it is changed to be an offset to savepoint storage
 
101
    area and need not be used by storage engine.
 
102
    see binlog_engine and binlog_savepoint_set/rollback for an example.
 
103
  */
 
104
  size_t savepoint_offset;
 
105
  size_t orig_savepoint_offset;
186
106
  std::vector<std::string> aliases;
187
107
 
 
108
  void setTransactionReadWrite(Session* session);
 
109
 
 
110
protected:
 
111
 
 
112
  /**
 
113
   * Implementing classes should override these to provide savepoint
 
114
   * functionality.
 
115
   */
 
116
  virtual int savepoint_set_hook(Session *, void *) { return 0; }
 
117
 
 
118
  virtual int savepoint_rollback_hook(Session *, void *) { return 0; }
 
119
 
 
120
  virtual int savepoint_release_hook(Session *, void *) { return 0; }
 
121
 
188
122
public:
189
 
  const std::vector<std::string>& getAliases() const
 
123
 
 
124
  StorageEngine(const std::string name_arg,
 
125
                const std::bitset<HTON_BIT_SIZE> &flags_arg= HTON_NO_FLAGS,
 
126
                size_t savepoint_offset_arg= 0,
 
127
                bool support_2pc= false);
 
128
 
 
129
  virtual ~StorageEngine();
 
130
 
 
131
  static int getTableProto(const char* path,
 
132
                           drizzled::message::Table *table_proto);
 
133
 
 
134
  virtual int getTableProtoImplementation(const char* path,
 
135
                                          drizzled::message::Table *table_proto)
 
136
    {
 
137
      (void)path;
 
138
      (void)table_proto;
 
139
      return ENOENT;
 
140
    }
 
141
 
 
142
  /*
 
143
    each storage engine has it's own memory area (actually a pointer)
 
144
    in the session, for storing per-connection information.
 
145
    It is accessed as
 
146
 
 
147
      session->ha_data[xxx_engine.slot]
 
148
 
 
149
   slot number is initialized by MySQL after xxx_init() is called.
 
150
  */
 
151
  uint32_t slot;
 
152
 
 
153
  inline uint32_t getSlot (void) { return slot; }
 
154
  inline void setSlot (uint32_t value) { slot= value; }
 
155
 
 
156
  const std::vector<std::string>& getAliases()
190
157
  {
191
158
    return aliases;
192
159
  }
196
163
    aliases.push_back(alias);
197
164
  }
198
165
 
199
 
protected:
200
 
 
201
 
  /**
202
 
    @brief
203
 
    Used as a protobuf storage currently by TEMP only engines.
204
 
  */
205
 
  typedef std::map <std::string, message::Table> ProtoCache;
206
 
  ProtoCache proto_cache;
207
 
  pthread_mutex_t proto_cache_mutex;
208
 
 
209
 
public:
210
 
 
211
 
  StorageEngine(const std::string name_arg,
212
 
                const std::bitset<HTON_BIT_SIZE> &flags_arg= HTON_NO_FLAGS);
213
 
 
214
 
  virtual ~StorageEngine();
215
 
 
216
 
  virtual int doGetTableDefinition(Session &session,
217
 
                                   TableIdentifier &identifier,
218
 
                                   message::Table &table_message)
219
 
  {
220
 
    (void)session;
221
 
    (void)identifier;
222
 
    (void)table_message;
223
 
 
224
 
    return ENOENT;
225
 
  }
226
 
 
227
 
  /* Old style cursor errors */
228
 
protected:
229
 
  void print_keydup_error(uint32_t key_nr, const char *msg, Table &table);
230
 
  void print_error(int error, myf errflag, Table *table= NULL);
231
 
  virtual bool get_error_message(int error, String *buf);
232
 
public:
233
 
  virtual void print_error(int error, myf errflag, Table& table);
 
166
  bool has_2pc()
 
167
  {
 
168
    return two_phase_commit;
 
169
  }
 
170
 
 
171
 
 
172
  bool is_enabled() const
 
173
  {
 
174
    return enabled;
 
175
  }
234
176
 
235
177
  bool is_user_selectable() const
236
178
  {
242
184
    return flags.test(flag);
243
185
  }
244
186
 
245
 
  // @todo match check_flag interface
246
 
  virtual uint32_t index_flags(enum  ha_key_alg) const { return 0; }
247
 
  virtual void startStatement(Session *session)
248
 
  {
249
 
    doStartStatement(session);
250
 
  }
251
 
  virtual void endStatement(Session *session)
252
 
  {
253
 
    doEndStatement(session);
254
 
  }
 
187
  void enable() { enabled= true; }
 
188
  void disable() { enabled= false; }
 
189
 
 
190
  std::string getName() const { return name; }
255
191
 
256
192
  /*
257
 
   * Called during Session::cleanup() for all engines
258
 
   */
 
193
    StorageEngine methods:
 
194
 
 
195
    close_connection is only called if
 
196
    session->ha_data[xxx_engine.slot] is non-zero, so even if you don't need
 
197
    this storage area - set it to something, so that MySQL would know
 
198
    this storage engine was accessed in this connection
 
199
  */
259
200
  virtual int close_connection(Session  *)
260
201
  {
261
202
    return 0;
262
203
  }
263
 
  virtual Cursor *create(TableShare &, memory::Root *)= 0;
 
204
  /*
 
205
    'all' is true if it's a real commit, that makes persistent changes
 
206
    'all' is false if it's not in fact a commit but an end of the
 
207
    statement that is part of the transaction.
 
208
    NOTE 'all' is also false in auto-commit mode where 'end of statement'
 
209
    and 'real commit' mean the same event.
 
210
  */
 
211
  virtual int  commit(Session *, bool)
 
212
  {
 
213
    return 0;
 
214
  }
 
215
 
 
216
  virtual int  rollback(Session *, bool)
 
217
  {
 
218
    return 0;
 
219
  }
 
220
 
 
221
  /*
 
222
    The void * points to an uninitialized storage area of requested size
 
223
    (see savepoint_offset description)
 
224
  */
 
225
  int savepoint_set(Session *session, void *sp)
 
226
  {
 
227
    return savepoint_set_hook(session, (unsigned char *)sp+savepoint_offset);
 
228
  }
 
229
 
 
230
  /*
 
231
    The void * points to a storage area, that was earlier passed
 
232
    to the savepoint_set call
 
233
  */
 
234
  int savepoint_rollback(Session *session, void *sp)
 
235
  {
 
236
     return savepoint_rollback_hook(session,
 
237
                                    (unsigned char *)sp+savepoint_offset);
 
238
  }
 
239
 
 
240
  int savepoint_release(Session *session, void *sp)
 
241
  {
 
242
    return savepoint_release_hook(session,
 
243
                                  (unsigned char *)sp+savepoint_offset);
 
244
  }
 
245
 
 
246
  virtual int  prepare(Session *, bool) { return 0; }
 
247
  virtual int  recover(XID *, uint32_t) { return 0; }
 
248
  virtual int  commit_by_xid(XID *) { return 0; }
 
249
  virtual int  rollback_by_xid(XID *) { return 0; }
 
250
  virtual handler *create(TableShare *, MEM_ROOT *)= 0;
264
251
  /* args: path */
 
252
  virtual void drop_database(char*) { }
 
253
  virtual int start_consistent_snapshot(Session *) { return 0; }
265
254
  virtual bool flush_logs() { return false; }
266
255
  virtual bool show_status(Session *, stat_print_fn *, enum ha_stat_type)
267
256
  {
268
257
    return false;
269
258
  }
270
259
 
 
260
  /* args: current_session, tables, cond */
 
261
  virtual int fill_files_table(Session *, TableList *,
 
262
                               Item *) { return 0; }
 
263
  virtual int release_temporary_latches(Session *) { return false; }
 
264
 
271
265
  /**
272
266
    If frm_error() is called then we will use this to find out what file
273
267
    extentions exist for the storage engine. This is also used by the default
274
 
    rename_table and delete_table method in Cursor.cc.
 
268
    rename_table and delete_table method in handler.cc.
275
269
 
276
270
    For engines that have two file name extentions (separate meta/index file
277
271
    and data file), the order of elements is relevant. First element of engine
282
276
  virtual const char **bas_ext() const =0;
283
277
 
284
278
protected:
285
 
  virtual int doCreateTable(Session &session,
286
 
                            Table &table_arg,
287
 
                            TableIdentifier &identifier,
288
 
                            message::Table &message)= 0;
289
 
 
290
 
  virtual int doRenameTable(Session &session,
291
 
                            TableIdentifier &from, TableIdentifier &to)= 0;
292
 
 
293
 
public:
294
 
 
295
 
  int renameTable(Session &session, TableIdentifier &from, TableIdentifier &to);
296
 
 
297
 
  // @todo move these to protected
298
 
  virtual void doGetTableNames(CachedDirectory &directory,
299
 
                               drizzled::SchemaIdentifier &schema_identifier,
300
 
                               TableNameList &set_of_names)= 0;
301
 
 
302
 
  virtual void doGetTableIdentifiers(CachedDirectory &directory,
303
 
                                     drizzled::SchemaIdentifier &schema_identifier,
304
 
                                     TableIdentifiers &set_of_identifiers)= 0;
305
 
 
306
 
  virtual int doDropTable(Session &session,
307
 
                          TableIdentifier &identifier)= 0;
308
 
 
309
 
  /* Class Methods for operating on plugin */
310
 
  static bool addPlugin(plugin::StorageEngine *engine);
311
 
  static void removePlugin(plugin::StorageEngine *engine);
312
 
 
313
 
  static int getTableDefinition(Session& session,
314
 
                                TableIdentifier &identifier,
315
 
                                message::Table &table_proto,
316
 
                                bool include_temporary_tables= true);
317
 
  static bool doesTableExist(Session &session,
318
 
                             TableIdentifier &identifier,
319
 
                             bool include_temporary_tables= true);
320
 
 
321
 
  virtual bool doDoesTableExist(Session& session, TableIdentifier &identifier);
322
 
 
323
 
  static plugin::StorageEngine *findByName(const std::string &find_str);
324
 
  static plugin::StorageEngine *findByName(Session& session, const std::string &find_str);
325
 
 
326
 
  static void closeConnection(Session* session);
327
 
  static void dropDatabase(char* path);
328
 
  static bool flushLogs(plugin::StorageEngine *db_type);
329
 
  static int dropTable(Session& session,
330
 
                       TableIdentifier &identifier);
331
 
  static int dropTable(Session& session,
332
 
                       StorageEngine &engine,
333
 
                       TableIdentifier &identifier);
334
 
  static void getTableNames(Session &session, drizzled::SchemaIdentifier& schema_identifier, TableNameList &set_of_names);
335
 
  static void getTableIdentifiers(Session &session, SchemaIdentifier &schema_identifier, TableIdentifiers &set_of_identifiers);
336
 
 
337
 
  // Check to see if any SE objects to creation.
338
 
  static bool canCreateTable(drizzled::TableIdentifier &identifier);
339
 
  virtual bool doCanCreateTable(drizzled::TableIdentifier &identifier)
340
 
  { (void)identifier;  return true; }
341
 
 
342
 
  // @note All schema methods defined here
343
 
  static void getSchemaIdentifiers(Session &session, SchemaIdentifierList &schemas);
344
 
  static bool getSchemaDefinition(TableIdentifier &identifier, message::Schema &proto);
345
 
  static bool getSchemaDefinition(drizzled::SchemaIdentifier &identifier, message::Schema &proto);
346
 
  static bool doesSchemaExist(drizzled::SchemaIdentifier &identifier);
347
 
  static const CHARSET_INFO *getSchemaCollation(drizzled::SchemaIdentifier &identifier);
348
 
  static bool createSchema(const drizzled::message::Schema &schema_message);
349
 
  static bool dropSchema(drizzled::SchemaIdentifier &identifier);
350
 
  static bool alterSchema(const drizzled::message::Schema &schema_message);
351
 
 
352
 
  // @note make private/protected
353
 
  virtual void doGetSchemaIdentifiers(SchemaIdentifierList&)
354
 
  { }
355
 
 
356
 
  virtual bool doGetSchemaDefinition(drizzled::SchemaIdentifier&, drizzled::message::Schema&)
357
 
  { 
358
 
    return false; 
359
 
  }
360
 
 
361
 
  virtual bool doCreateSchema(const drizzled::message::Schema&)
362
 
  { return false; }
363
 
 
364
 
  virtual bool doAlterSchema(const drizzled::message::Schema&)
365
 
  { return false; }
366
 
 
367
 
  virtual bool doDropSchema(drizzled::SchemaIdentifier&)
368
 
  { return false; }
369
 
 
370
 
  static inline const std::string &resolveName(const StorageEngine *engine)
371
 
  {
372
 
    return engine == NULL ? UNKNOWN_STRING : engine->getName();
373
 
  }
374
 
 
375
 
  static int createTable(Session& session,
376
 
                         TableIdentifier &identifier,
377
 
                         bool update_create_info,
378
 
                         message::Table& table_proto);
379
 
 
380
 
  static void removeLostTemporaryTables(Session &session, const char *directory);
381
 
 
382
 
  Cursor *getCursor(TableShare &share, memory::Root *alloc);
383
 
 
384
 
  uint32_t max_record_length() const
385
 
  { return std::min((unsigned int)HA_MAX_REC_LENGTH, max_supported_record_length()); }
386
 
  uint32_t max_keys() const
387
 
  { return std::min((unsigned int)MAX_KEY, max_supported_keys()); }
388
 
  uint32_t max_key_parts() const
389
 
  { return std::min((unsigned int)MAX_REF_PARTS, max_supported_key_parts()); }
390
 
  uint32_t max_key_length() const
391
 
  { return std::min((unsigned int)MAX_KEY_LENGTH, max_supported_key_length()); }
392
 
  uint32_t max_key_part_length(void) const
393
 
  { return std::min((unsigned int)MAX_KEY_LENGTH, max_supported_key_part_length()); }
394
 
 
395
 
  virtual uint32_t max_supported_record_length(void) const
396
 
  { return HA_MAX_REC_LENGTH; }
397
 
  virtual uint32_t max_supported_keys(void) const { return 0; }
398
 
  virtual uint32_t max_supported_key_parts(void) const { return MAX_REF_PARTS; }
399
 
  virtual uint32_t max_supported_key_length(void) const { return MAX_KEY_LENGTH; }
400
 
  virtual uint32_t max_supported_key_part_length(void) const { return 255; }
401
 
 
402
 
  /* TODO-> Make private */
403
 
  static int deleteDefinitionFromPath(TableIdentifier &identifier);
404
 
  static int renameDefinitionFromPath(TableIdentifier &dest, TableIdentifier &src);
405
 
  static int writeDefinitionFromPath(TableIdentifier &identifier, message::Table &proto);
406
 
  static bool readTableFile(const std::string &path, message::Table &table_message);
407
 
 
408
 
public:
409
 
  /* 
410
 
   * The below are simple virtual overrides for the plugin::MonitoredInTransaction
411
 
   * interface.
412
 
   */
413
 
  virtual bool participatesInSqlTransaction() const
414
 
  {
415
 
    return false; /* plugin::StorageEngine is non-transactional in terms of SQL */
416
 
  }
417
 
  virtual bool participatesInXaTransaction() const
418
 
  {
419
 
    return false; /* plugin::StorageEngine is non-transactional in terms of XA */
420
 
  }
421
 
  virtual bool alwaysRegisterForXaTransaction() const
422
 
  {
423
 
    return false;
424
 
  }
425
 
};
426
 
 
427
 
} /* namespace plugin */
428
 
} /* namespace drizzled */
 
279
  virtual int createTableImplementation(Session *session,
 
280
                                        const char *table_name,
 
281
                                        Table *table_arg,
 
282
                                        HA_CREATE_INFO *create_info,
 
283
                                        drizzled::message::Table* proto)= 0;
 
284
 
 
285
  virtual int renameTableImplementation(Session* session,
 
286
                                        const char *from, const char *to);
 
287
 
 
288
  virtual int deleteTableImplementation(Session* session,
 
289
                                        const std::string table_path);
 
290
 
 
291
public:
 
292
  int createTable(Session *session, const char *path, Table *table_arg,
 
293
                  HA_CREATE_INFO *create_info,
 
294
                  drizzled::message::Table *proto) 
 
295
  {
 
296
    char name_buff[FN_REFLEN];
 
297
    const char *table_name;
 
298
 
 
299
    table_name= checkLowercaseNames(path, name_buff);
 
300
 
 
301
    setTransactionReadWrite(session);
 
302
 
 
303
    return createTableImplementation(session, table_name, table_arg,
 
304
                                     create_info, proto);
 
305
  }
 
306
 
 
307
  int renameTable(Session *session, const char *from, const char *to) 
 
308
  {
 
309
    setTransactionReadWrite(session);
 
310
 
 
311
    return renameTableImplementation(session, from, to);
 
312
  }
 
313
 
 
314
  int deleteTable(Session* session, const std::string table_path) 
 
315
  {
 
316
    setTransactionReadWrite(session);
 
317
 
 
318
    return deleteTableImplementation(session, table_path);
 
319
  }
 
320
 
 
321
  const char *checkLowercaseNames(const char *path, char *tmp_path);
 
322
 
 
323
  virtual TableNameIteratorImplementation* tableNameIterator(const std::string &database)
 
324
  {
 
325
    (void)database;
 
326
    return NULL;
 
327
  }
 
328
};
 
329
 
 
330
class TableNameIteratorImplementation
 
331
{
 
332
protected:
 
333
  std::string db;
 
334
public:
 
335
  TableNameIteratorImplementation(const std::string &database) : db(database)
 
336
    {};
 
337
  virtual ~TableNameIteratorImplementation() {};
 
338
 
 
339
  virtual int next(std::string *name)= 0;
 
340
 
 
341
};
 
342
 
 
343
class TableNameIterator
 
344
{
 
345
private:
 
346
  drizzled::Registry<StorageEngine *>::iterator engine_iter;
 
347
  TableNameIteratorImplementation *current_implementation;
 
348
  TableNameIteratorImplementation *default_implementation;
 
349
  std::string database;
 
350
public:
 
351
  TableNameIterator(const std::string &db);
 
352
  ~TableNameIterator();
 
353
 
 
354
  int next(std::string *name);
 
355
};
 
356
 
 
357
/* lookups */
 
358
StorageEngine *ha_default_storage_engine(Session *session);
 
359
StorageEngine *ha_resolve_by_name(Session *session, std::string find_str);
 
360
 
 
361
handler *get_new_handler(TableShare *share, MEM_ROOT *alloc,
 
362
                         StorageEngine *db_type);
 
363
const std::string ha_resolve_storage_engine_name(const StorageEngine *db_type);
429
364
 
430
365
#endif /* DRIZZLED_PLUGIN_STORAGE_ENGINE_H */