23
23
instance of table share per one table in the database.
26
#ifndef DRIZZLED_DEFINITION_TABLE_H
27
#define DRIZZLED_DEFINITION_TABLE_H
26
#ifndef DRIZZLED_TABLE_SHARE_H
27
#define DRIZZLED_TABLE_SHARE_H
31
#include <boost/unordered_map.hpp>
32
#include <boost/thread/condition_variable.hpp>
33
#include <boost/dynamic_bitset.hpp>
34
#include <boost/shared_ptr.hpp>
36
31
#include "drizzled/typelib.h"
32
#include "drizzled/my_hash.h"
37
33
#include "drizzled/memory/root.h"
38
34
#include "drizzled/message/table.pb.h"
39
#include "drizzled/util/string.h"
41
#include "drizzled/table/cache.h"
46
extern uint64_t refresh_version;
48
const static std::string STANDARD_STRING("STANDARD");
49
const static std::string TEMPORARY_STRING("TEMPORARY");
50
const static std::string INTERNAL_STRING("INTERNAL");
51
const static std::string FUNCTION_STRING("FUNCTION");
52
const static std::string NO_PROTOBUFFER_AVAILABLE("NO PROTOBUFFER AVAILABLE");
56
class EventObserverList;
63
typedef std::vector<std::string> StringVector;
66
typedef boost::shared_ptr<TableShare> shared_ptr;
67
typedef std::vector <shared_ptr> vector;
69
TableShare(const TableIdentifier::Type type_arg);
71
TableShare(const TableIdentifier &identifier, const TableIdentifier::Key &key); // Used by placeholder
73
TableShare(const TableIdentifier &identifier); // Just used during createTable()
75
TableShare(const TableIdentifier::Type type_arg,
76
const TableIdentifier &identifier,
77
char *path_arg= NULL, uint32_t path_length_arg= 0); // Shares for cache
43
table_category(TABLE_UNKNOWN_CATEGORY),
46
found_next_number_field(NULL),
47
timestamp_field(NULL),
57
row_type(ROW_TYPE_DEFAULT),
61
tmp_table(NO_TMP_TABLE),
75
timestamp_field_offset(0),
80
rowid_field_offset(0),
83
next_number_key_offset(0),
84
next_number_keypart(0),
88
column_bitmap_size(0),
90
db_low_byte_first(false),
92
replace_with_name_lock(false),
93
waiting_on_cond(false),
100
TableShare(const char *key,
102
const char *new_table_name,
103
const char *new_path) :
104
table_category(TABLE_UNKNOWN_CATEGORY),
107
found_next_number_field(NULL),
108
timestamp_field(NULL),
112
default_values(NULL),
117
stored_rec_length(0),
118
row_type(ROW_TYPE_DEFAULT),
121
storage_engine(NULL),
122
tmp_table(NO_TMP_TABLE),
125
last_null_bit_pos(0),
131
max_unique_length(0),
136
timestamp_field_offset(0),
138
db_create_options(0),
139
db_options_in_use(0),
141
rowid_field_offset(0),
143
next_number_index(0),
144
next_number_key_offset(0),
145
next_number_keypart(0),
149
column_bitmap_size(0),
151
db_low_byte_first(false),
153
replace_with_name_lock(false),
154
waiting_on_cond(false),
158
init(key, key_length, new_table_name, new_path);
82
161
/** Category of this table. */
83
162
enum_table_category table_category;
87
bool isTemporaryCategory() const
89
return (table_category == TABLE_CATEGORY_TEMPORARY);
92
void setTableCategory(enum_table_category arg)
164
uint32_t open_count; /* Number of tables in open list */
97
166
/* The following is copied to each Table on OPEN */
98
typedef std::vector<Field *> Fields;
102
const Fields getFields() const
107
Field ** getFields(bool)
112
void setFields(uint32_t arg)
117
uint32_t positionFields(Field **arg) const
119
return (arg - (Field **)&field[0]);
122
void pushField(Field *arg)
125
field.push_back(arg);
129
168
Field **found_next_number_field;
131
169
Field *timestamp_field; /* Used only during open */
134
Field *getTimestampField() const /* Used only during open */
136
return timestamp_field;
139
void setTimestampField(Field *arg) /* Used only during open */
141
timestamp_field= arg;
146
KeyInfo *key_info; /* data of keys in database */
148
KeyInfo &getKeyInfo(uint32_t arg) const
150
return key_info[arg];
152
std::vector<uint> blob_field; /* Index to blobs in Field arrray*/
170
KEY *key_info; /* data of keys in database */
171
uint *blob_field; /* Index to blobs in Field arrray*/
154
173
/* hash of field names (contains pointers to elements of field array) */
156
typedef boost::unordered_map < std::string, Field **, util::insensitive_hash, util::insensitive_equal_to> FieldMap;
157
typedef std::pair< std::string, Field ** > FieldMapPair;
158
FieldMap name_hash; /* hash of field names */
160
size_t getNamedFieldSize() const
162
return name_hash.size();
165
Field **getNamedField(const std::string &arg)
167
FieldMap::iterator iter= name_hash.find(arg);
169
if (iter == name_hash.end())
172
return (*iter).second;
174
HASH name_hash; /* hash of field names */
176
175
memory::Root mem_root;
178
void *alloc_root(size_t arg)
180
return mem_root.alloc_root(arg);
183
char *strmake_root(const char *str_arg, size_t len_arg)
185
return mem_root.strmake_root(str_arg, len_arg);
188
memory::Root *getMemRoot()
193
std::vector<std::string> _keynames;
195
void addKeyName(std::string arg)
197
std::transform(arg.begin(), arg.end(),
198
arg.begin(), ::toupper);
199
_keynames.push_back(arg);
202
bool doesKeyNameExist(const char *name_arg, uint32_t name_length, uint32_t &position) const
204
return doesKeyNameExist(std::string(name_arg, name_length), position);
207
bool doesKeyNameExist(std::string arg, uint32_t &position) const
209
std::transform(arg.begin(), arg.end(),
210
arg.begin(), ::toupper);
212
std::vector<std::string>::const_iterator iter= std::find(_keynames.begin(), _keynames.end(), arg);
214
if (iter == _keynames.end())
216
position= UINT32_MAX; //historical, required for finding primary key from unique
220
position= iter - _keynames.begin();
226
std::vector<TYPELIB> intervals; /* pointer to interval info */
228
boost::mutex mutex; /* For locking the share */
229
boost::condition_variable cond; /* To signal that share is ready */
242
std::vector<unsigned char> default_values; /* row with default values */
244
// @note This needs to be made to be const in the future
245
unsigned char *getDefaultValues()
247
return &default_values[0];
249
void resizeDefaultValues(size_t arg)
251
default_values.resize(arg);
176
TYPELIB keynames; /* Pointers to keynames */
177
TYPELIB fieldnames; /* Pointer to fieldnames */
178
TYPELIB *intervals; /* pointer to interval info */
179
pthread_mutex_t mutex; /* For locking the share */
180
pthread_cond_t cond; /* To signal that share is ready */
182
unsigned char *default_values; /* row with default values */
254
183
const CHARSET_INFO *table_charset; /* Default charset of string fields */
256
boost::dynamic_bitset<> all_set;
259
187
Key which is used for looking-up table in table cache and in the list
260
188
of thread's temporary tables. Has the form of:
265
193
should correspond to each other.
266
194
To ensure this one can use set_table_cache() methods.
269
TableIdentifier::Key private_key_for_cache; // This will not exist in the final design.
270
std::vector<char> private_normalized_path; // This will not exist in the final design.
196
LEX_STRING table_cache_key;
271
197
LEX_STRING db; /* Pointer to db */
272
198
LEX_STRING table_name; /* Table name (for open) */
273
199
LEX_STRING path; /* Path to table (from datadir) */
274
200
LEX_STRING normalized_path; /* unpack_filename(path) */
277
const char *getNormalizedPath() const
279
return normalized_path.str;
282
const char *getPath() const
287
const TableIdentifier::Key& getCacheKey() const // This should never be called when we aren't looking at a cache.
289
assert(private_key_for_cache.size());
290
return private_key_for_cache;
293
size_t getCacheKeySize() const
295
return private_key_for_cache.size();
299
void setPath(char *str_arg, uint32_t size_arg)
302
path.length= size_arg;
305
void setNormalizedPath(char *str_arg, uint32_t size_arg)
307
normalized_path.str= str_arg;
308
normalized_path.length= size_arg;
312
const char *getTableName() const
314
return table_name.str;
317
uint32_t getTableNameSize() const
319
return table_name.length;
322
const std::string &getTableName(std::string &name_arg) const
325
name_arg.append(table_name.str, table_name.length);
330
const char *getSchemaName() const
335
const std::string &getSchemaName(std::string &schema_name_arg) const
337
schema_name_arg.clear();
338
schema_name_arg.append(db.str, db.length);
340
return schema_name_arg;
343
202
uint32_t block_size; /* create information */
346
203
uint64_t version;
348
uint64_t getVersion() const
353
void refreshVersion()
355
version= refresh_version;
363
204
uint32_t timestamp_offset; /* Set to offset+1 of record */
365
205
uint32_t reclength; /* Recordlength */
367
206
uint32_t stored_rec_length; /* Stored record length*/
369
uint32_t getRecordLength() const
374
void setRecordLength(uint32_t arg)
379
const Field_blob *getBlobFieldAt(uint32_t arg) const
381
if (arg < blob_fields)
382
return (Field_blob*) field[blob_field[arg]];
207
enum row_type row_type; /* How rows are stored */
388
210
/* Max rows is a hint to HEAP during a create tmp table */
476
265
return storage_engine;
480
TableIdentifier::Type tmp_table;
483
TableIdentifier::Type getType() const
267
enum tmp_table_type tmp_table;
489
269
uint32_t ref_count; /* How many Table objects uses this */
492
uint32_t getTableCount() const
497
void incrementTableCount()
504
270
uint32_t null_bytes;
505
271
uint32_t last_null_bit_pos;
506
272
uint32_t fields; /* Number of fields */
508
uint32_t sizeFields() const
513
273
uint32_t rec_buff_length; /* Size of table->record[] buffer */
516
uint32_t sizeKeys() const
274
uint32_t keys, key_parts;
521
275
uint32_t max_key_length, max_unique_length, total_key_length;
522
276
uint32_t uniques; /* Number of UNIQUE index */
523
277
uint32_t null_fields; /* number of null fields */
524
278
uint32_t blob_fields; /* number of blob fields */
526
bool has_variable_width; /* number of varchar fields */
528
bool hasVariableWidth() const
530
return has_variable_width; // We should calculate this.
532
void setVariableWidth()
534
has_variable_width= true;
279
uint32_t timestamp_field_offset; /* Field number for timestamp field */
280
uint32_t varchar_fields; /* number of varchar fields */
536
281
uint32_t db_create_options; /* Create options from database */
537
282
uint32_t db_options_in_use; /* Options in use */
538
283
uint32_t db_record_offset; /* if HA_REC_IN_SEQ */
576
312
key_map keys_in_use;
577
313
key_map keys_for_keyread;
580
event_observers is a class containing all the event plugins that have
581
registered an interest in this table.
584
plugin::EventObserverList *event_observers;
586
plugin::EventObserverList *getTableObservers()
588
return event_observers;
591
void setTableObservers(plugin::EventObserverList *observers)
593
event_observers= observers;
597
Set share's identifier information.
316
Set share's table cache key and update its db and table name appropriately.
319
set_table_cache_key()
320
key_buff Buffer with already built table cache key to be
321
referenced from share.
322
key_length Key length.
605
void setIdentifier(const TableIdentifier &identifier_arg);
325
Since 'key_buff' buffer will be referenced from share it should has same
326
life-time as share itself.
327
This method automatically ensures that TableShare::table_name/db have
328
appropriate values by using table cache key as their source.
331
void set_table_cache_key(char *key_buff, uint32_t key_length)
333
table_cache_key.str= key_buff;
334
table_cache_key.length= key_length;
336
Let us use the fact that the key is "db/0/table_name/0" + optional
337
part for temporary tables.
339
db.str= table_cache_key.str;
340
db.length= strlen(db.str);
341
table_name.str= db.str + db.length + 1;
342
table_name.length= strlen(table_name.str);
347
Set share's table cache key and update its db and table name appropriately.
350
set_table_cache_key()
351
key_buff Buffer to be used as storage for table cache key
352
(should be at least key_length bytes).
353
key Value for table cache key.
354
key_length Key length.
357
Since 'key_buff' buffer will be used as storage for table cache key
358
it should has same life-time as share itself.
361
void set_table_cache_key(char *key_buff, const char *key, uint32_t key_length)
363
memcpy(key_buff, key, key_length);
364
set_table_cache_key(key_buff, key_length);
367
inline bool honor_global_locks()
369
return (table_category == TABLE_CATEGORY_USER);
608
374
Initialize share for temporary tables
617
383
path Path to table (possible in lower case)
386
This is different from alloc_table_share() because temporary tables
387
don't have to be shared between threads or put into the table def
388
cache, so we can do some things notable simpler and faster
390
If table is not put in session->temporary_tables (happens only when
391
one uses OPEN TEMPORARY) then one can specify 'db' as key and
392
use key_length= 0 as neither table_cache_key or key_length will be used).
624
400
void init(const char *new_table_name,
625
const char *new_path);
401
const char *new_path)
403
init("", 0, new_table_name, new_path);
406
void init(const char *key,
407
uint32_t key_length, const char *new_table_name,
408
const char *new_path)
410
memset(this, 0, sizeof(TableShare));
411
memory::init_sql_alloc(&mem_root, TABLE_ALLOC_BLOCK_SIZE, 0);
412
table_category= TABLE_CATEGORY_TEMPORARY;
413
tmp_table= INTERNAL_TMP_TABLE;
415
db.length= strlen(key);
416
table_cache_key.str= (char*) key;
417
table_cache_key.length= key_length;
418
table_name.str= (char*) new_table_name;
419
table_name.length= strlen(new_table_name);
420
path.str= (char*) new_path;
421
normalized_path.str= (char*) new_path;
422
path.length= normalized_path.length= strlen(new_path);
428
Free table share and memory used by it
435
share->mutex must be locked when we come here if it's not a temp table
438
void free_table_share()
440
memory::Root new_mem_root;
441
assert(ref_count == 0);
444
If someone is waiting for this to be deleted, inform it about this.
445
Don't do a delete until we know that no one is refering to this anymore.
447
if (tmp_table == NO_TMP_TABLE)
449
/* share->mutex is locked in release_table_share() */
450
while (waiting_on_cond)
452
pthread_cond_broadcast(&cond);
453
pthread_cond_wait(&cond, &mutex);
455
/* No thread refers to this anymore */
456
pthread_mutex_unlock(&mutex);
457
pthread_mutex_destroy(&mutex);
458
pthread_cond_destroy(&cond);
460
hash_free(&name_hash);
462
storage_engine= NULL;
467
/* We must copy mem_root from share because share is allocated through it */
468
memcpy(&new_mem_root, &mem_root, sizeof(new_mem_root));
469
free_root(&new_mem_root, MYF(0)); // Free's share
628
472
void open_table_error(int pass_error, int db_errno, int pass_errarg);
477
Create a table cache key
481
key Create key here (must be of size MAX_DBKEY_LENGTH)
482
table_list Table definition
485
The table cache_key is created from:
489
if the table is a tmp table, we add the following to make each tmp table
492
4 bytes for master thread id
493
4 bytes pseudo thread id
499
static inline uint32_t createKey(char *key, std::string& db_arg,
500
std::string& table_name_arg)
502
return createKey(key, db_arg.c_str(), table_name_arg.c_str());
505
static inline uint32_t createKey(char *key, const char *db_arg, const char *table_name_arg)
510
key_pos= strcpy(key_pos, db_arg) + strlen(db_arg);
511
key_pos= strcpy(key_pos+1, table_name_arg) +
512
strlen(table_name_arg);
513
key_length= (uint32_t)(key_pos-key)+1;
518
static void cacheStart(void);
519
static void cacheStop(void);
630
520
static void release(TableShare *share);
631
static void release(TableShare::shared_ptr &share);
632
static void release(const TableIdentifier &identifier);
633
static TableShare::shared_ptr getShareCreate(Session *session,
634
const TableIdentifier &identifier,
637
friend std::ostream& operator<<(std::ostream& output, const TableShare &share)
639
output << "TableShare:(";
640
output << share.getSchemaName();
642
output << share.getTableName();
644
output << share.getTableTypeAsString();
646
output << share.getPath();
649
return output; // for multiple << operators.
652
Field *make_field(unsigned char *ptr,
653
uint32_t field_length,
655
unsigned char *null_pos,
656
unsigned char null_bit,
658
enum_field_types field_type,
659
const CHARSET_INFO * field_charset,
660
Field::utype unireg_check,
662
const char *field_name);
664
int open_table_def(Session& session, const TableIdentifier &identifier);
666
int open_table_from_share(Session *session,
667
const TableIdentifier &identifier,
669
uint32_t db_stat, uint32_t ha_open_flags,
672
int open_table_from_share_inner(Session *session,
676
int open_table_cursor_inner(const TableIdentifier &identifier,
677
uint32_t db_stat, uint32_t ha_open_flags,
679
bool &error_reported);
681
int parse_table_proto(Session& session, message::Table &table);
683
int inner_parse_table_proto(Session& session, message::Table &table);
521
static void release(const char *key, uint32_t key_length);
522
static TableShare *getShare(const char *db, const char *table_name);
523
static TableShare *getShare(Session *session,
524
TableList *table_list, char *key,
525
uint32_t key_length, uint32_t, int *error);
686
528
} /* namespace drizzled */
688
#endif /* DRIZZLED_DEFINITION_TABLE_H */
530
#endif /* DRIZZLED_TABLE_SHARE_H */