~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to sql/table.h

Removed SCCS references.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
/* -*- mode: c++; c-basic-offset: 2; indent-tabs-mode: nil; -*-
2
 
 *  vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
3
 
 *
4
 
 *  Copyright (C) 2008 Sun Microsystems
5
 
 *
6
 
 *  This program is free software; you can redistribute it and/or modify
7
 
 *  it under the terms of the GNU General Public License as published by
8
 
 *  the Free Software Foundation; either version 2 of the License, or
9
 
 *  (at your option) any later version.
10
 
 *
11
 
 *  This program is distributed in the hope that it will be useful,
12
 
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13
 
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14
 
 *  GNU General Public License for more details.
15
 
 *
16
 
 *  You should have received a copy of the GNU General Public License
17
 
 *  along with this program; if not, write to the Free Software
18
 
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19
 
 */
20
 
 
21
 
/* Structs that defines the Table */
22
 
 
23
 
#ifndef DRIZZLED_TABLE_H
24
 
#define DRIZZLED_TABLE_H
25
 
 
26
 
#include <storage/myisam/myisam.h>
27
 
#include <drizzled/order.h>
28
 
#include <drizzled/filesort_info.h>
29
 
#include <drizzled/natural_join_column.h>
30
 
#include <drizzled/nested_join.h>
31
 
#include <drizzled/field_iterator.h>
32
 
 
33
 
class Item;                             /* Needed by order_st */
 
1
/* Copyright (C) 2000-2006 MySQL AB
 
2
 
 
3
   This program is free software; you can redistribute it and/or modify
 
4
   it under the terms of the GNU General Public License as published by
 
5
   the Free Software Foundation; version 2 of the License.
 
6
 
 
7
   This program is distributed in the hope that it will be useful,
 
8
   but WITHOUT ANY WARRANTY; without even the implied warranty of
 
9
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
10
   GNU General Public License for more details.
 
11
 
 
12
   You should have received a copy of the GNU General Public License
 
13
   along with this program; if not, write to the Free Software
 
14
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
 
15
 
 
16
 
 
17
/* Structs that defines the TABLE */
 
18
 
 
19
class Item;                             /* Needed by ORDER */
34
20
class Item_subselect;
35
21
class st_select_lex_unit;
36
22
class st_select_lex;
37
23
class COND_EQUAL;
38
24
class Security_context;
39
 
class TableList;
40
25
 
41
26
/*************************************************************************/
42
27
 
 
28
/* Order clause list element */
 
29
 
 
30
typedef struct st_order {
 
31
  struct st_order *next;
 
32
  Item   **item;                        /* Point at item in select fields */
 
33
  Item   *item_ptr;                     /* Storage for initial item */
 
34
  Item   **item_copy;                   /* For SPs; the original item ptr */
 
35
  int    counter;                       /* position in SELECT list, correct
 
36
                                           only if counter_used is true*/
 
37
  bool   asc;                           /* true if ascending */
 
38
  bool   free_me;                       /* true if item isn't shared  */
 
39
  bool   in_field_list;                 /* true if in select field list */
 
40
  bool   counter_used;                  /* parameter was counter of columns */
 
41
  Field  *field;                        /* If tmp-table group */
 
42
  char   *buff;                         /* If tmp-table group */
 
43
  table_map used, depend_map;
 
44
} ORDER;
 
45
 
43
46
enum tmp_table_type
44
47
{
45
48
  NO_TMP_TABLE, NON_TRANSACTIONAL_TMP_TABLE, TRANSACTIONAL_TMP_TABLE,
46
49
  INTERNAL_TMP_TABLE, SYSTEM_TMP_TABLE, TMP_TABLE_FRM_FILE_ONLY
47
50
};
48
51
 
49
 
bool mysql_frm_type(THD *thd, char *path, enum legacy_db_type *dbt);
 
52
enum frm_type_enum
 
53
{
 
54
  FRMTYPE_ERROR= 0,
 
55
  FRMTYPE_TABLE,
 
56
};
 
57
 
 
58
frm_type_enum mysql_frm_type(THD *thd, char *path, enum legacy_db_type *dbt);
50
59
 
51
60
 
52
61
enum release_type { RELEASE_NORMAL, RELEASE_WAIT_FOR_DROP };
53
62
 
 
63
typedef struct st_filesort_info
 
64
{
 
65
  IO_CACHE *io_cache;           /* If sorted through filesort */
 
66
  uchar     **sort_keys;        /* Buffer for sorting keys */
 
67
  uchar     *buffpek;           /* Buffer for buffpek structures */
 
68
  uint      buffpek_len;        /* Max number of buffpeks in the buffer */
 
69
  uchar     *addon_buf;         /* Pointer to a buffer if sorted with fields */
 
70
  size_t    addon_length;       /* Length of the buffer */
 
71
  struct st_sort_addon_field *addon_field;     /* Pointer to the fields info */
 
72
  void    (*unpack)(struct st_sort_addon_field *, uchar *); /* To unpack back */
 
73
  uchar     *record_pointers;    /* If sorted in memory */
 
74
  ha_rows   found_records;      /* How many records in sort */
 
75
} FILESORT_INFO;
 
76
 
 
77
 
54
78
/*
55
79
  Values in this enum are used to indicate how a tables TIMESTAMP field
56
80
  should be treated. It can be set to the current timestamp on insert or
71
95
 
72
96
class Field_timestamp;
73
97
class Field_blob;
 
98
class Table_triggers_list;
74
99
 
75
100
/**
76
101
  Category of table found in the table share.
89
114
    - FLUSH TABLES WITH READ LOCK
90
115
    - SET GLOBAL READ_ONLY = ON
91
116
    do not apply to this table.
92
 
    Note that LOCK Table t FOR READ/WRITE
 
117
    Note that LOCK TABLE t FOR READ/WRITE
93
118
    can be used on temporary tables.
94
119
    Temporary tables are not part of the table cache.
95
120
  */
98
123
  /**
99
124
    User table.
100
125
    These tables do honor:
101
 
    - LOCK Table t FOR READ/WRITE
 
126
    - LOCK TABLE t FOR READ/WRITE
102
127
    - FLUSH TABLES WITH READ LOCK
103
128
    - SET GLOBAL READ_ONLY = ON
104
129
    User tables are cached in the table cache.
106
131
  TABLE_CATEGORY_USER=2,
107
132
 
108
133
  /**
 
134
    System table, maintained by the server.
 
135
    These tables do honor:
 
136
    - LOCK TABLE t FOR READ/WRITE
 
137
    - FLUSH TABLES WITH READ LOCK
 
138
    - SET GLOBAL READ_ONLY = ON
 
139
    Typically, writes to system tables are performed by
 
140
    the server implementation, not explicitly be a user.
 
141
    System tables are cached in the table cache.
 
142
  */
 
143
  TABLE_CATEGORY_SYSTEM=3,
 
144
 
 
145
  /**
109
146
    Information schema tables.
110
147
    These tables are an interface provided by the system
111
148
    to inspect the system metadata.
112
149
    These tables do *not* honor:
113
 
    - LOCK Table t FOR READ/WRITE
 
150
    - LOCK TABLE t FOR READ/WRITE
114
151
    - FLUSH TABLES WITH READ LOCK
115
152
    - SET GLOBAL READ_ONLY = ON
116
153
    as there is no point in locking explicitely
125
162
    to I_S tables in the table cache, which should use
126
163
    this table type.
127
164
  */
128
 
  TABLE_CATEGORY_INFORMATION
 
165
  TABLE_CATEGORY_INFORMATION=4,
129
166
};
130
167
typedef enum enum_table_category TABLE_CATEGORY;
131
168
 
155
192
  struct st_table_share *next,          /* Link to unused shares */
156
193
    **prev;
157
194
 
158
 
  /* The following is copied to each Table on OPEN */
 
195
  /* The following is copied to each TABLE on OPEN */
159
196
  Field **field;
160
197
  Field **found_next_number_field;
161
198
  Field *timestamp_field;               /* Used only during open */
162
199
  KEY  *key_info;                       /* data of keys in database */
163
200
  uint  *blob_field;                    /* Index to blobs in Field arrray*/
164
201
 
165
 
  unsigned char *default_values;                /* row with default values */
 
202
  uchar *default_values;                /* row with default values */
166
203
  LEX_STRING comment;                   /* Comment about table */
167
 
  const CHARSET_INFO *table_charset; /* Default charset of string fields */
 
204
  CHARSET_INFO *table_charset;          /* Default charset of string fields */
168
205
 
169
206
  MY_BITMAP all_set;
170
207
  /*
180
217
  LEX_STRING table_cache_key;
181
218
  LEX_STRING db;                        /* Pointer to db */
182
219
  LEX_STRING table_name;                /* Table name (for open) */
183
 
  LEX_STRING path;      /* Path to .frm file (from datadir) */
 
220
  LEX_STRING path;                      /* Path to .frm file (from datadir) */
184
221
  LEX_STRING normalized_path;           /* unpack_filename(path) */
185
222
  LEX_STRING connect_string;
186
223
 
187
 
  /*
 
224
  /* 
188
225
     Set of keys in use, implemented as a Bitmap.
189
 
     Excludes keys disabled by ALTER Table ... DISABLE KEYS.
 
226
     Excludes keys disabled by ALTER TABLE ... DISABLE KEYS.
190
227
  */
191
228
  key_map keys_in_use;
192
229
  key_map keys_for_keyread;
193
230
  ha_rows min_rows, max_rows;           /* create information */
194
 
  uint32_t   avg_row_length;            /* create information */
195
 
  uint32_t   block_size;                   /* create information */
196
 
  uint32_t   version, mysql_version;
197
 
  uint32_t   timestamp_offset;          /* Set to offset+1 of record */
198
 
  uint32_t   reclength;                 /* Recordlength */
199
 
  uint32_t   stored_rec_length;         /* Stored record length 
200
 
                                           (no generated-only virtual fields) */
 
231
  ulong   avg_row_length;               /* create information */
 
232
  ulong   version, mysql_version;
 
233
  ulong   timestamp_offset;             /* Set to offset+1 of record */
 
234
  ulong   reclength;                    /* Recordlength */
201
235
 
202
236
  plugin_ref db_plugin;                 /* storage engine plugin */
203
237
  inline handlerton *db_type() const    /* table_type for handler */
204
 
  {
205
 
    // assert(db_plugin);
 
238
  { 
 
239
    // DBUG_ASSERT(db_plugin);
206
240
    return db_plugin ? plugin_data(db_plugin, handlerton*) : NULL;
207
241
  }
208
242
  enum row_type row_type;               /* How rows are stored */
 
243
  enum ha_storage_media default_storage_media;
 
244
  char *tablespace;
209
245
  enum tmp_table_type tmp_table;
210
246
  enum ha_choice transactional;
211
247
  enum ha_choice page_checksum;
212
248
 
213
 
  uint32_t ref_count;       /* How many Table objects uses this */
214
 
  uint32_t open_count;                  /* Number of tables in open list */
215
 
  uint32_t blob_ptr_size;                       /* 4 or 8 */
216
 
  uint32_t key_block_size;                      /* create key_block_size, if used */
217
 
  uint32_t null_bytes, last_null_bit_pos;
218
 
  uint32_t fields;                              /* Number of fields */
219
 
  uint32_t stored_fields;                   /* Number of stored fields 
220
 
                                           (i.e. without generated-only ones) */
221
 
  uint32_t rec_buff_length;                 /* Size of table->record[] buffer */
222
 
  uint32_t keys, key_parts;
223
 
  uint32_t max_key_length, max_unique_length, total_key_length;
224
 
  uint32_t uniques;                         /* Number of UNIQUE index */
225
 
  uint32_t null_fields;                 /* number of null fields */
226
 
  uint32_t blob_fields;                 /* number of blob fields */
227
 
  uint32_t timestamp_field_offset;              /* Field number for timestamp field */
228
 
  uint32_t varchar_fields;                  /* number of varchar fields */
229
 
  uint32_t db_create_options;           /* Create options from database */
230
 
  uint32_t db_options_in_use;           /* Options in use */
231
 
  uint32_t db_record_offset;            /* if HA_REC_IN_SEQ */
232
 
  uint32_t rowid_field_offset;          /* Field_nr +1 to rowid field */
 
249
  uint ref_count;                       /* How many TABLE objects uses this */
 
250
  uint open_count;                      /* Number of tables in open list */
 
251
  uint blob_ptr_size;                   /* 4 or 8 */
 
252
  uint key_block_size;                  /* create key_block_size, if used */
 
253
  uint null_bytes, last_null_bit_pos;
 
254
  uint fields;                          /* Number of fields */
 
255
  uint rec_buff_length;                 /* Size of table->record[] buffer */
 
256
  uint keys, key_parts;
 
257
  uint max_key_length, max_unique_length, total_key_length;
 
258
  uint uniques;                         /* Number of UNIQUE index */
 
259
  uint null_fields;                     /* number of null fields */
 
260
  uint blob_fields;                     /* number of blob fields */
 
261
  uint timestamp_field_offset;          /* Field number for timestamp field */
 
262
  uint varchar_fields;                  /* number of varchar fields */
 
263
  uint db_create_options;               /* Create options from database */
 
264
  uint db_options_in_use;               /* Options in use */
 
265
  uint db_record_offset;                /* if HA_REC_IN_SEQ */
 
266
  uint raid_type, raid_chunks;
 
267
  uint rowid_field_offset;              /* Field_nr +1 to rowid field */
233
268
  /* Index of auto-updated TIMESTAMP field in field array */
234
 
  uint32_t primary_key;
235
 
  uint32_t next_number_index;               /* autoincrement key number */
236
 
  uint32_t next_number_key_offset;          /* autoinc keypart offset in a key */
237
 
  uint32_t next_number_keypart;             /* autoinc keypart number in a key */
238
 
  uint32_t error, open_errno, errarg;       /* error from open_table_def() */
239
 
  uint32_t column_bitmap_size;
240
 
  unsigned char frm_version;
241
 
  uint32_t vfields;                         /* Number of virtual fields */
 
269
  uint primary_key;
 
270
  uint next_number_index;               /* autoincrement key number */
 
271
  uint next_number_key_offset;          /* autoinc keypart offset in a key */
 
272
  uint next_number_keypart;             /* autoinc keypart number in a key */
 
273
  uint error, open_errno, errarg;       /* error from open_table_def() */
 
274
  uint column_bitmap_size;
 
275
  uchar frm_version;
242
276
  bool null_field_first;
 
277
  bool system;                          /* Set if system table (one record) */
 
278
  bool crypted;                         /* If .frm file is crypted */
243
279
  bool db_low_byte_first;               /* Portable row format */
244
280
  bool crashed;
245
281
  bool name_lock, replace_with_name_lock;
246
282
  bool waiting_on_cond;                 /* Protection against free */
247
 
  uint32_t table_map_id;                   /* for row-based replication */
 
283
  ulong table_map_id;                   /* for row-based replication */
248
284
  uint64_t table_map_version;
249
285
 
250
286
  /*
271
307
      appropriate values by using table cache key as their source.
272
308
  */
273
309
 
274
 
  void set_table_cache_key(char *key_buff, uint32_t key_length)
 
310
  void set_table_cache_key(char *key_buff, uint key_length)
275
311
  {
276
312
    table_cache_key.str= key_buff;
277
313
    table_cache_key.length= key_length;
301
337
      it should has same life-time as share itself.
302
338
  */
303
339
 
304
 
  void set_table_cache_key(char *key_buff, const char *key, uint32_t key_length)
 
340
  void set_table_cache_key(char *key_buff, const char *key, uint key_length)
305
341
  {
306
342
    memcpy(key_buff, key, key_length);
307
343
    set_table_cache_key(key_buff, key_length);
309
345
 
310
346
  inline bool honor_global_locks()
311
347
  {
312
 
    return (table_category == TABLE_CATEGORY_USER);
 
348
    return ((table_category == TABLE_CATEGORY_USER)
 
349
            || (table_category == TABLE_CATEGORY_SYSTEM));
313
350
  }
314
351
 
315
 
  inline uint32_t get_table_def_version()
 
352
  inline ulong get_table_def_version()
316
353
  {
317
354
    return table_map_id;
318
355
  }
320
357
} TABLE_SHARE;
321
358
 
322
359
 
323
 
extern uint32_t refresh_version;
 
360
extern ulong refresh_version;
324
361
 
325
362
/* Information for one open table */
326
363
enum index_hint_type
330
367
  INDEX_HINT_FORCE
331
368
};
332
369
 
333
 
typedef struct st_table_field_w_type
334
 
{
335
 
  LEX_STRING name;
336
 
  LEX_STRING type;
337
 
  LEX_STRING cset;
338
 
} TABLE_FIELD_W_TYPE;
339
 
 
340
 
bool create_myisam_from_heap(THD *thd, Table *table,
341
 
                             MI_COLUMNDEF *start_recinfo,
342
 
                             MI_COLUMNDEF **recinfo, 
343
 
                             int error, bool ignore_last_dupp_key_error);
344
 
 
345
 
class Table {
346
 
 
347
 
public:
 
370
struct st_table {
 
371
  st_table() {}                               /* Remove gcc warning */
 
372
 
348
373
  TABLE_SHARE   *s;
349
 
  Table() {}                               /* Remove gcc warning */
350
 
 
351
 
  /* SHARE methods */
352
 
  inline TABLE_SHARE *getShare() { return s; } /* Get rid of this long term */
353
 
  inline void setShare(TABLE_SHARE *new_share) { s= new_share; } /* Get rid of this long term */
354
 
  inline uint32_t sizeKeys() { return s->keys; }
355
 
  inline uint32_t sizeFields() { return s->fields; }
356
 
  inline uint32_t getRecordLength() { return s->reclength; }
357
 
  inline uint32_t sizeBlobFields() { return s->blob_fields; }
358
 
  inline uint32_t *getBlobField() { return s->blob_field; }
359
 
  inline uint32_t getNullBytes() { return s->null_bytes; }
360
 
  inline uint32_t getNullFields() { return s->null_fields; }
361
 
  inline unsigned char *getDefaultValues() { return s->default_values; }
362
 
 
363
 
  inline bool isNullFieldFirst() { return s->null_field_first; }
364
 
  inline bool isDatabaseLowByteFirst() { return s->db_low_byte_first; }         /* Portable row format */
365
 
  inline bool isCrashed() { return s->crashed; }
366
 
  inline bool isNameLock() { return s->name_lock; } 
367
 
  inline bool isReplaceWithNameLock() { return s->replace_with_name_lock; }
368
 
  inline bool isWaitingOnCondition() { return s->waiting_on_cond; }                 /* Protection against free */
369
 
 
370
 
  /* For TMP tables, should be pulled out as a class */
371
 
  void updateCreateInfo(HA_CREATE_INFO *create_info);
372
 
  void setup_tmp_table_column_bitmaps(unsigned char *bitmaps);
373
 
  bool create_myisam_tmp_table(KEY *keyinfo, 
374
 
                               MI_COLUMNDEF *start_recinfo,
375
 
                               MI_COLUMNDEF **recinfo, 
376
 
                               uint64_t options);
377
 
  void free_tmp_table(THD *thd);
378
 
  bool open_tmp_table();
379
 
  size_t max_row_length(const unsigned char *data);
380
 
  uint32_t find_shortest_key(const key_map *usable_keys);
381
 
  bool compare_record(Field **ptr);
382
 
  bool compare_record();
383
 
 
384
 
  bool table_check_intact(const uint32_t table_f_count, const TABLE_FIELD_W_TYPE *table_def);
385
 
 
386
 
  /* See if this can be blown away */
387
 
  inline uint32_t getDBStat () { return db_stat; }
388
 
  inline uint32_t setDBStat () { return db_stat; }
389
 
  uint          db_stat;                /* mode of file as in handler.h */
390
 
 
391
374
  handler       *file;
392
 
  Table *next, *prev;
 
375
  struct st_table *next, *prev;
393
376
 
394
377
  THD   *in_use;                        /* Which thread uses this */
395
378
  Field **field;                        /* Pointer to fields */
396
379
 
397
 
  unsigned char *record[2];                     /* Pointer to records */
398
 
  unsigned char *write_row_record;              /* Used as optimisation in
 
380
  uchar *record[2];                     /* Pointer to records */
 
381
  uchar *write_row_record;              /* Used as optimisation in
399
382
                                           THD::write_row */
400
 
  unsigned char *insert_values;                  /* used by INSERT ... UPDATE */
 
383
  uchar *insert_values;                  /* used by INSERT ... UPDATE */
401
384
  /* 
402
385
    Map of keys that can be used to retrieve all data from this table 
403
386
    needed by the query without reading the row.
408
391
    A set of keys that can be used in the query that references this
409
392
    table.
410
393
 
411
 
    All indexes disabled on the table's TABLE_SHARE (see Table::s) will be 
412
 
    subtracted from this set upon instantiation. Thus for any Table t it holds
 
394
    All indexes disabled on the table's TABLE_SHARE (see TABLE::s) will be 
 
395
    subtracted from this set upon instantiation. Thus for any TABLE t it holds
413
396
    that t.keys_in_use_for_query is a subset of t.s.keys_in_use. Generally we 
414
397
    must not introduce any new keys here (see setup_tables).
415
398
 
425
408
  Field *next_number_field;             /* Set if next_number is activated */
426
409
  Field *found_next_number_field;       /* Set on open */
427
410
  Field_timestamp *timestamp_field;
428
 
  Field **vfield;                       /* Pointer to virtual fields*/
429
411
 
430
 
  TableList *pos_in_table_list;/* Element referring to this table */
431
 
  order_st *group;
 
412
  /* Table's triggers, 0 if there are no of them */
 
413
  Table_triggers_list *triggers;
 
414
  TABLE_LIST *pos_in_table_list;/* Element referring to this table */
 
415
  ORDER         *group;
432
416
  const char    *alias;                   /* alias or table name */
433
 
  unsigned char         *null_flags;
 
417
  uchar         *null_flags;
434
418
  my_bitmap_map *bitmap_init_value;
435
419
  MY_BITMAP     def_read_set, def_write_set, tmp_set; /* containers */
436
420
  MY_BITMAP     *read_set, *write_set;          /* Active column sets */
455
439
  query_id_t    query_id;
456
440
 
457
441
  /* 
458
 
    For each key that has quick_keys.is_set(key) == true: estimate of #records
 
442
    For each key that has quick_keys.is_set(key) == TRUE: estimate of #records
459
443
    and max #key parts that range access would use.
460
444
  */
461
445
  ha_rows       quick_rows[MAX_KEY];
491
475
  timestamp_auto_set_type timestamp_field_type;
492
476
  table_map     map;                    /* ID bit of table (1,2,4,8,16...) */
493
477
 
494
 
  uint32_t          lock_position;          /* Position in DRIZZLE_LOCK.table */
495
 
  uint32_t          lock_data_start;        /* Start pos. in DRIZZLE_LOCK.locks */
496
 
  uint32_t          lock_count;             /* Number of locks */
 
478
  uint          lock_position;          /* Position in MYSQL_LOCK.table */
 
479
  uint          lock_data_start;        /* Start pos. in MYSQL_LOCK.locks */
 
480
  uint          lock_count;             /* Number of locks */
497
481
  uint          tablenr,used_fields;
498
 
  uint32_t          temp_pool_slot;             /* Used by intern temp tables */
 
482
  uint          temp_pool_slot;         /* Used by intern temp tables */
499
483
  uint          status;                 /* What's in record[0] */
 
484
  uint          db_stat;                /* mode of file as in handler.h */
500
485
  /* number of select if it is derived table */
501
 
  uint32_t          derived_select_number;
 
486
  uint          derived_select_number;
502
487
  int           current_lock;           /* Type of lock on table */
503
 
  bool copy_blobs;                      /* copy_blobs when storing */
 
488
  my_bool copy_blobs;                   /* copy_blobs when storing */
504
489
 
505
490
  /*
506
491
    0 or JOIN_TYPE_{LEFT|RIGHT}. Currently this is only compared to 0.
507
492
    If maybe_null !=0, this table is inner w.r.t. some outer join operation,
508
493
    and null_row may be true.
509
494
  */
510
 
  bool maybe_null;
511
 
 
 
495
  uint maybe_null;
512
496
  /*
513
497
    If true, the current table row is considered to have all columns set to 
514
498
    NULL, including columns declared as "not null" (see maybe_null).
515
499
  */
516
 
  bool null_row;
 
500
  my_bool null_row;
517
501
 
518
 
  bool force_index;
519
 
  bool distinct,const_table,no_rows;
520
 
  bool key_read, no_keyread;
 
502
  /*
 
503
    TODO: Each of the following flags take up 8 bits. They can just as easily
 
504
    be put into one single unsigned long and instead of taking up 18
 
505
    bytes, it would take up 4.
 
506
  */
 
507
  my_bool force_index;
 
508
  my_bool distinct,const_table,no_rows;
 
509
  my_bool key_read, no_keyread;
521
510
  /*
522
511
    Placeholder for an open table which prevents other connections
523
512
    from taking name-locks on this table. Typically used with
535
524
    object associated with it (db_stat is always 0), but please do
536
525
    not rely on that.
537
526
  */
538
 
  bool open_placeholder;
539
 
  bool locked_by_logger;
540
 
  bool no_replicate;
541
 
  bool locked_by_name;
542
 
  bool no_cache;
 
527
  my_bool open_placeholder;
 
528
  my_bool locked_by_logger;
 
529
  my_bool no_replicate;
 
530
  my_bool locked_by_name;
 
531
  my_bool fulltext_searched;
 
532
  my_bool no_cache;
543
533
  /* To signal that the table is associated with a HANDLER statement */
544
 
  bool open_by_handler;
 
534
  my_bool open_by_handler;
545
535
  /*
546
536
    To indicate that a non-null value of the auto_increment field
547
537
    was provided by the user or retrieved from the current record.
548
538
    Used only in the MODE_NO_AUTO_VALUE_ON_ZERO mode.
549
539
  */
550
 
  bool auto_increment_field_not_null;
551
 
  bool insert_or_update;             /* Can be used by the handler */
552
 
  bool alias_name_used;         /* true if table_name is alias */
553
 
  bool get_fields_in_item_tree;      /* Signal to fix_field */
 
540
  my_bool auto_increment_field_not_null;
 
541
  my_bool insert_or_update;             /* Can be used by the handler */
 
542
  my_bool alias_name_used;              /* true if table_name is alias */
 
543
  my_bool get_fields_in_item_tree;      /* Signal to fix_field */
554
544
 
555
545
  REGINFO reginfo;                      /* field connections */
556
546
  MEM_ROOT mem_root;
557
 
  filesort_info_st sort;
 
547
  FILESORT_INFO sort;
558
548
 
559
549
  bool fill_item_list(List<Item> *item_list) const;
560
550
  void reset_item_list(List<Item> *item_list) const;
561
551
  void clear_column_bitmaps(void);
562
552
  void prepare_for_position(void);
563
 
  void mark_columns_used_by_index_no_reset(uint32_t index, MY_BITMAP *map);
564
 
  void mark_columns_used_by_index(uint32_t index);
 
553
  void mark_columns_used_by_index_no_reset(uint index, MY_BITMAP *map);
 
554
  void mark_columns_used_by_index(uint index);
565
555
  void restore_column_maps_after_mark_index();
566
556
  void mark_auto_increment_column(void);
567
557
  void mark_columns_needed_for_update(void);
568
558
  void mark_columns_needed_for_delete(void);
569
559
  void mark_columns_needed_for_insert(void);
570
 
  void mark_virtual_columns(void);
571
560
  inline void column_bitmaps_set(MY_BITMAP *read_set_arg,
572
561
                                 MY_BITMAP *write_set_arg)
573
562
  {
582
571
    read_set= read_set_arg;
583
572
    write_set= write_set_arg;
584
573
  }
585
 
 
586
 
  void restore_column_map(my_bitmap_map *old);
587
 
 
588
 
  my_bitmap_map *use_all_columns(MY_BITMAP *bitmap);
589
574
  inline void use_all_columns()
590
575
  {
591
576
    column_bitmaps_set(&s->all_set, &s->all_set);
592
577
  }
593
 
 
594
578
  inline void default_column_bitmaps()
595
579
  {
596
580
    read_set= &def_read_set;
597
581
    write_set= &def_write_set;
598
582
  }
599
 
 
600
583
  /* Is table open or should be treated as such by name-locking? */
601
584
  inline bool is_name_opened() { return db_stat || open_placeholder; }
602
585
  /*
604
587
  */
605
588
  inline bool needs_reopen_or_name_lock()
606
589
  { return s->version != refresh_version; }
 
590
};
607
591
 
608
 
  int report_error(int error);
 
592
enum enum_schema_table_state
 
593
 
594
  NOT_PROCESSED= 0,
 
595
  PROCESSED_BY_CREATE_SORT_INDEX,
 
596
  PROCESSED_BY_JOIN_EXEC
609
597
};
610
598
 
611
599
typedef struct st_foreign_key_info
645
633
  SCH_TABLES,
646
634
  SCH_TABLE_CONSTRAINTS,
647
635
  SCH_TABLE_NAMES,
648
 
  SCH_VARIABLES
 
636
  SCH_VARIABLES,
649
637
};
650
638
 
651
639
 
667
655
     For string-type columns, this is the maximum number of
668
656
     characters. Otherwise, it is the 'display-length' for the column.
669
657
  */
670
 
  uint32_t field_length;
 
658
  uint field_length;
671
659
  /**
672
660
     This denotes data type for the column. For the most part, there seems to
673
661
     be one entry in the enum for each SQL data type, although there seem to
683
671
     combine them using the bitwise or operator @c |. Both flags are
684
672
     defined in table.h.
685
673
   */
686
 
  uint32_t field_flags;        // Field atributes(maybe_null, signed, unsigned etc.)
 
674
  uint field_flags;        // Field atributes(maybe_null, signed, unsigned etc.)
687
675
  const char* old_name;
688
676
  /**
689
677
     This should be one of @c SKIP_OPEN_TABLE,
690
678
     @c OPEN_FRM_ONLY or @c OPEN_FULL_TABLE.
691
679
  */
692
 
  uint32_t open_method;
 
680
  uint open_method;
693
681
} ST_FIELD_INFO;
694
682
 
695
683
 
696
 
class TableList;
 
684
struct TABLE_LIST;
697
685
typedef class Item COND;
698
686
 
699
 
struct ST_SCHEMA_TABLE
 
687
typedef struct st_schema_table
700
688
{
701
689
  const char* table_name;
702
690
  ST_FIELD_INFO *fields_info;
703
691
  /* Create information_schema table */
704
 
  Table *(*create_table)  (THD *thd, TableList *table_list);
 
692
  TABLE *(*create_table)  (THD *thd, TABLE_LIST *table_list);
705
693
  /* Fill table with data */
706
 
  int (*fill_table) (THD *thd, TableList *tables, COND *cond);
 
694
  int (*fill_table) (THD *thd, TABLE_LIST *tables, COND *cond);
707
695
  /* Handle fileds for old SHOW */
708
 
  int (*old_format) (THD *thd, struct ST_SCHEMA_TABLE *schema_table);
709
 
  int (*process_table) (THD *thd, TableList *tables, Table *table,
 
696
  int (*old_format) (THD *thd, struct st_schema_table *schema_table);
 
697
  int (*process_table) (THD *thd, TABLE_LIST *tables, TABLE *table,
710
698
                        bool res, LEX_STRING *db_name, LEX_STRING *table_name);
711
699
  int idx_field1, idx_field2; 
712
700
  bool hidden;
713
 
  uint32_t i_s_requested_object;  /* the object we need to open(Table | VIEW) */
714
 
};
 
701
  uint i_s_requested_object;  /* the object we need to open(TABLE | VIEW) */
 
702
} ST_SCHEMA_TABLE;
715
703
 
716
704
 
717
705
#define JOIN_TYPE_LEFT  1
721
709
class select_union;
722
710
class TMP_TABLE_PARAM;
723
711
 
 
712
Item *create_view_field(THD *thd, TABLE_LIST *view, Item **field_ref,
 
713
                        const char *name);
 
714
 
724
715
struct Field_translator
725
716
{
726
717
  Item *item;
728
719
};
729
720
 
730
721
 
 
722
/*
 
723
  Column reference of a NATURAL/USING join. Since column references in
 
724
  joins can be both from views and stored tables, may point to either a
 
725
  Field (for tables), or a Field_translator (for views).
 
726
*/
 
727
 
 
728
class Natural_join_column: public Sql_alloc
 
729
{
 
730
public:
 
731
  Field_translator *view_field;  /* Column reference of merge view. */
 
732
  Field            *table_field; /* Column reference of table or temp view. */
 
733
  TABLE_LIST *table_ref; /* Original base table/view reference. */
 
734
  /*
 
735
    True if a common join column of two NATURAL/USING join operands. Notice
 
736
    that when we have a hierarchy of nested NATURAL/USING joins, a column can
 
737
    be common at some level of nesting but it may not be common at higher
 
738
    levels of nesting. Thus this flag may change depending on at which level
 
739
    we are looking at some column.
 
740
  */
 
741
  bool is_common;
 
742
public:
 
743
  Natural_join_column(Field_translator *field_param, TABLE_LIST *tab);
 
744
  Natural_join_column(Field *field_param, TABLE_LIST *tab);
 
745
  const char *name();
 
746
  Item *create_item(THD *thd);
 
747
  Field *field();
 
748
  const char *table_name();
 
749
  const char *db_name();
 
750
};
 
751
 
 
752
 
 
753
/*
 
754
  Table reference in the FROM clause.
 
755
 
 
756
  These table references can be of several types that correspond to
 
757
  different SQL elements. Below we list all types of TABLE_LISTs with
 
758
  the necessary conditions to determine when a TABLE_LIST instance
 
759
  belongs to a certain type.
 
760
 
 
761
  1) table (TABLE_LIST::view == NULL)
 
762
     - base table
 
763
       (TABLE_LIST::derived == NULL)
 
764
     - subquery - TABLE_LIST::table is a temp table
 
765
       (TABLE_LIST::derived != NULL)
 
766
     - information schema table
 
767
       (TABLE_LIST::schema_table != NULL)
 
768
       NOTICE: for schema tables TABLE_LIST::field_translation may be != NULL
 
769
  2) view (TABLE_LIST::view != NULL)
 
770
     - merge    (TABLE_LIST::effective_algorithm == VIEW_ALGORITHM_MERGE)
 
771
           also (TABLE_LIST::field_translation != NULL)
 
772
     - tmptable (TABLE_LIST::effective_algorithm == VIEW_ALGORITHM_TMPTABLE)
 
773
           also (TABLE_LIST::field_translation == NULL)
 
774
  3) nested table reference (TABLE_LIST::nested_join != NULL)
 
775
     - table sequence - e.g. (t1, t2, t3)
 
776
       TODO: how to distinguish from a JOIN?
 
777
     - general JOIN
 
778
       TODO: how to distinguish from a table sequence?
 
779
     - NATURAL JOIN
 
780
       (TABLE_LIST::natural_join != NULL)
 
781
       - JOIN ... USING
 
782
         (TABLE_LIST::join_using_fields != NULL)
 
783
     - semi-join
 
784
       ;
 
785
*/
 
786
 
 
787
class Index_hint;
 
788
struct TABLE_LIST
 
789
{
 
790
  TABLE_LIST() {}                          /* Remove gcc warning */
 
791
 
 
792
  /**
 
793
    Prepare TABLE_LIST that consists of one table instance to use in
 
794
    simple_open_and_lock_tables
 
795
  */
 
796
  inline void init_one_table(const char *db_name_arg,
 
797
                             const char *table_name_arg,
 
798
                             enum thr_lock_type lock_type_arg)
 
799
  {
 
800
    bzero((char*) this, sizeof(*this));
 
801
    db= (char*) db_name_arg;
 
802
    table_name= alias= (char*) table_name_arg;
 
803
    lock_type= lock_type_arg;
 
804
  }
 
805
 
 
806
  /*
 
807
    List of tables local to a subquery (used by SQL_LIST). Considers
 
808
    views as leaves (unlike 'next_leaf' below). Created at parse time
 
809
    in st_select_lex::add_table_to_list() -> table_list.link_in_list().
 
810
  */
 
811
  TABLE_LIST *next_local;
 
812
  /* link in a global list of all queries tables */
 
813
  TABLE_LIST *next_global, **prev_global;
 
814
  char          *db, *alias, *table_name, *schema_table_name;
 
815
  char          *option;                /* Used by cache index  */
 
816
  Item          *on_expr;               /* Used with outer join */
 
817
  Item          *sj_on_expr;
 
818
  /*
 
819
    (Valid only for semi-join nests) Bitmap of tables that are within the
 
820
    semi-join (this is different from bitmap of all nest's children because
 
821
    tables that were pulled out of the semi-join nest remain listed as
 
822
    nest's children).
 
823
  */
 
824
  table_map     sj_inner_tables;
 
825
  /* Number of IN-compared expressions */
 
826
  uint          sj_in_exprs; 
 
827
  /*
 
828
    The structure of ON expression presented in the member above
 
829
    can be changed during certain optimizations. This member
 
830
    contains a snapshot of AND-OR structure of the ON expression
 
831
    made after permanent transformations of the parse tree, and is
 
832
    used to restore ON clause before every reexecution of a prepared
 
833
    statement or stored procedure.
 
834
  */
 
835
  Item          *prep_on_expr;
 
836
  COND_EQUAL    *cond_equal;            /* Used with outer join */
 
837
  /*
 
838
    During parsing - left operand of NATURAL/USING join where 'this' is
 
839
    the right operand. After parsing (this->natural_join == this) iff
 
840
    'this' represents a NATURAL or USING join operation. Thus after
 
841
    parsing 'this' is a NATURAL/USING join iff (natural_join != NULL).
 
842
  */
 
843
  TABLE_LIST *natural_join;
 
844
  /*
 
845
    True if 'this' represents a nested join that is a NATURAL JOIN.
 
846
    For one of the operands of 'this', the member 'natural_join' points
 
847
    to the other operand of 'this'.
 
848
  */
 
849
  bool is_natural_join;
 
850
  /* Field names in a USING clause for JOIN ... USING. */
 
851
  List<String> *join_using_fields;
 
852
  /*
 
853
    Explicitly store the result columns of either a NATURAL/USING join or
 
854
    an operand of such a join.
 
855
  */
 
856
  List<Natural_join_column> *join_columns;
 
857
  /* TRUE if join_columns contains all columns of this table reference. */
 
858
  bool is_join_columns_complete;
 
859
 
 
860
  /*
 
861
    List of nodes in a nested join tree, that should be considered as
 
862
    leaves with respect to name resolution. The leaves are: views,
 
863
    top-most nodes representing NATURAL/USING joins, subqueries, and
 
864
    base tables. All of these TABLE_LIST instances contain a
 
865
    materialized list of columns. The list is local to a subquery.
 
866
  */
 
867
  TABLE_LIST *next_name_resolution_table;
 
868
  /* Index names in a "... JOIN ... USE/IGNORE INDEX ..." clause. */
 
869
  List<Index_hint> *index_hints;
 
870
  TABLE        *table;                          /* opened table */
 
871
  uint          table_id; /* table id (from binlog) for opened table */
 
872
  /*
 
873
    select_result for derived table to pass it from table creation to table
 
874
    filling procedure
 
875
  */
 
876
  select_union  *derived_result;
 
877
  /*
 
878
    Reference from aux_tables to local list entry of main select of
 
879
    multi-delete statement:
 
880
    delete t1 from t2,t1 where t1.a<'B' and t2.b=t1.b;
 
881
    here it will be reference of first occurrence of t1 to second (as you
 
882
    can see this lists can't be merged)
 
883
  */
 
884
  TABLE_LIST    *correspondent_table;
 
885
  st_select_lex_unit *derived;          /* SELECT_LEX_UNIT of derived table */
 
886
  ST_SCHEMA_TABLE *schema_table;        /* Information_schema table */
 
887
  st_select_lex *schema_select_lex;
 
888
  /*
 
889
    True when the view field translation table is used to convert
 
890
    schema table fields for backwards compatibility with SHOW command.
 
891
  */
 
892
  bool schema_table_reformed;
 
893
  TMP_TABLE_PARAM *schema_table_param;
 
894
  /* link to select_lex where this table was used */
 
895
  st_select_lex *select_lex;
 
896
  Field_translator *field_translation;  /* array of VIEW fields */
 
897
  /* pointer to element after last one in translation table above */
 
898
  Field_translator *field_translation_end;
 
899
  /*
 
900
    List (based on next_local) of underlying tables of this view. I.e. it
 
901
    does not include the tables of subqueries used in the view. Is set only
 
902
    for merged views.
 
903
  */
 
904
  TABLE_LIST    *merge_underlying_list;
 
905
  /*
 
906
    - 0 for base tables
 
907
    - in case of the view it is the list of all (not only underlying
 
908
    tables but also used in subquery ones) tables of the view.
 
909
  */
 
910
  List<TABLE_LIST> *view_tables;
 
911
  /* most upper view this table belongs to */
 
912
  TABLE_LIST    *belong_to_view;
 
913
  /* Ptr to parent MERGE table list item. See top comment in ha_myisammrg.cc */
 
914
  TABLE_LIST    *parent_l;
 
915
  /*
 
916
    List of all base tables local to a subquery including all view
 
917
    tables. Unlike 'next_local', this in this list views are *not*
 
918
    leaves. Created in setup_tables() -> make_leaves_list().
 
919
  */
 
920
  TABLE_LIST    *next_leaf;
 
921
  /* data need by some engines in query cache*/
 
922
  uint64_t     engine_data;
 
923
  /* call back function for asking handler about caching in query cache */
 
924
  qc_engine_callback callback_func;
 
925
  thr_lock_type lock_type;
 
926
  uint          outer_join;             /* Which join type */
 
927
  uint          shared;                 /* Used in multi-upd */
 
928
  size_t        db_length;
 
929
  size_t        table_name_length;
 
930
  bool          straight;               /* optimize with prev table */
 
931
  bool          updating;               /* for replicate-do/ignore table */
 
932
  bool          force_index;            /* prefer index over table scan */
 
933
  bool          ignore_leaves;          /* preload only non-leaf nodes */
 
934
  table_map     dep_tables;             /* tables the table depends on      */
 
935
  table_map     on_expr_dep_tables;     /* tables on expression depends on  */
 
936
  struct st_nested_join *nested_join;   /* if the element is a nested join  */
 
937
  TABLE_LIST *embedding;             /* nested join containing the table */
 
938
  List<TABLE_LIST> *join_list;/* join list the table belongs to   */
 
939
  bool          cacheable_table;        /* stop PS caching */
 
940
  /* FRMTYPE_ERROR if any type is acceptable */
 
941
  enum frm_type_enum required_type;
 
942
  handlerton    *db_type;               /* table_type for handler */
 
943
  char          timestamp_buffer[20];   /* buffer for timestamp (19+1) */
 
944
  /*
 
945
    This TABLE_LIST object corresponds to the table to be created
 
946
    so it is possible that it does not exist (used in CREATE TABLE
 
947
    ... SELECT implementation).
 
948
  */
 
949
  bool          create;
 
950
  /* For transactional locking. */
 
951
  int           lock_timeout;           /* NOWAIT or WAIT [X]               */
 
952
  bool          lock_transactional;     /* If transactional lock requested. */
 
953
  bool          internal_tmp_table;
 
954
  /** TRUE if an alias for this table was specified in the SQL. */
 
955
  bool          is_alias;
 
956
  /** TRUE if the table is referred to in the statement using a fully
 
957
      qualified name (<db_name>.<table_name>).
 
958
  */
 
959
  bool          is_fqtn;
 
960
 
 
961
  uint i_s_requested_object;
 
962
  bool has_db_lookup_value;
 
963
  bool has_table_lookup_value;
 
964
  uint table_open_method;
 
965
  enum enum_schema_table_state schema_table_state;
 
966
  void set_underlying_merge();
 
967
  bool setup_underlying(THD *thd);
 
968
  void cleanup_items();
 
969
  /*
 
970
    If you change placeholder(), please check the condition in
 
971
    check_transactional_lock() too.
 
972
  */
 
973
  bool placeholder()
 
974
  {
 
975
    return derived || schema_table || (create && !table->db_stat) || !table;
 
976
  }
 
977
  void print(THD *thd, String *str, enum_query_type query_type);
 
978
  bool set_insert_values(MEM_ROOT *mem_root);
 
979
  TABLE_LIST *find_underlying_table(TABLE *table);
 
980
  TABLE_LIST *first_leaf_for_name_resolution();
 
981
  TABLE_LIST *last_leaf_for_name_resolution();
 
982
  bool is_leaf_for_name_resolution();
 
983
  inline TABLE_LIST *top_table()
 
984
    { return belong_to_view ? belong_to_view : this; }
 
985
 
 
986
  /*
 
987
    Cleanup for re-execution in a prepared statement or a stored
 
988
    procedure.
 
989
  */
 
990
  void reinit_before_use(THD *thd);
 
991
  Item_subselect *containing_subselect();
 
992
 
 
993
  /* 
 
994
    Compiles the tagged hints list and fills up st_table::keys_in_use_for_query,
 
995
    st_table::keys_in_use_for_group_by, st_table::keys_in_use_for_order_by,
 
996
    st_table::force_index and st_table::covering_keys.
 
997
  */
 
998
  bool process_index_hints(TABLE *table);
 
999
 
 
1000
private:
 
1001
  bool prep_where(THD *thd, Item **conds, bool no_where_clause);
 
1002
  /*
 
1003
    Cleanup for re-execution in a prepared statement or a stored
 
1004
    procedure.
 
1005
  */
 
1006
};
 
1007
 
 
1008
class Item;
 
1009
 
 
1010
/*
 
1011
  Iterator over the fields of a generic table reference.
 
1012
*/
 
1013
 
 
1014
class Field_iterator: public Sql_alloc
 
1015
{
 
1016
public:
 
1017
  Field_iterator() {}                         /* Remove gcc warning */
 
1018
  virtual ~Field_iterator() {}
 
1019
  virtual void set(TABLE_LIST *)= 0;
 
1020
  virtual void next()= 0;
 
1021
  virtual bool end_of_fields()= 0;              /* Return 1 at end of list */
 
1022
  virtual const char *name()= 0;
 
1023
  virtual Item *create_item(THD *)= 0;
 
1024
  virtual Field *field()= 0;
 
1025
};
 
1026
 
 
1027
 
 
1028
/* 
 
1029
  Iterator over the fields of a base table, view with temporary
 
1030
  table, or subquery.
 
1031
*/
 
1032
 
 
1033
class Field_iterator_table: public Field_iterator
 
1034
{
 
1035
  Field **ptr;
 
1036
public:
 
1037
  Field_iterator_table() :ptr(0) {}
 
1038
  void set(TABLE_LIST *table) { ptr= table->table->field; }
 
1039
  void set_table(TABLE *table) { ptr= table->field; }
 
1040
  void next() { ptr++; }
 
1041
  bool end_of_fields() { return *ptr == 0; }
 
1042
  const char *name();
 
1043
  Item *create_item(THD *thd);
 
1044
  Field *field() { return *ptr; }
 
1045
};
 
1046
 
 
1047
 
 
1048
/* Iterator over the fields of a merge view. */
 
1049
 
 
1050
class Field_iterator_view: public Field_iterator
 
1051
{
 
1052
  Field_translator *ptr, *array_end;
 
1053
  TABLE_LIST *view;
 
1054
public:
 
1055
  Field_iterator_view() :ptr(0), array_end(0) {}
 
1056
  void set(TABLE_LIST *table);
 
1057
  void next() { ptr++; }
 
1058
  bool end_of_fields() { return ptr == array_end; }
 
1059
  const char *name();
 
1060
  Item *create_item(THD *thd);
 
1061
  Item **item_ptr() {return &ptr->item; }
 
1062
  Field *field() { return 0; }
 
1063
  inline Item *item() { return ptr->item; }
 
1064
  Field_translator *field_translator() { return ptr; }
 
1065
};
 
1066
 
 
1067
 
 
1068
/*
 
1069
  Field_iterator interface to the list of materialized fields of a
 
1070
  NATURAL/USING join.
 
1071
*/
 
1072
 
 
1073
class Field_iterator_natural_join: public Field_iterator
 
1074
{
 
1075
  List_iterator_fast<Natural_join_column> column_ref_it;
 
1076
  Natural_join_column *cur_column_ref;
 
1077
public:
 
1078
  Field_iterator_natural_join() :cur_column_ref(NULL) {}
 
1079
  ~Field_iterator_natural_join() {}
 
1080
  void set(TABLE_LIST *table);
 
1081
  void next();
 
1082
  bool end_of_fields() { return !cur_column_ref; }
 
1083
  const char *name() { return cur_column_ref->name(); }
 
1084
  Item *create_item(THD *thd) { return cur_column_ref->create_item(thd); }
 
1085
  Field *field() { return cur_column_ref->field(); }
 
1086
  Natural_join_column *column_ref() { return cur_column_ref; }
 
1087
};
 
1088
 
 
1089
 
 
1090
/*
 
1091
  Generic iterator over the fields of an arbitrary table reference.
 
1092
 
 
1093
  DESCRIPTION
 
1094
    This class unifies the various ways of iterating over the columns
 
1095
    of a table reference depending on the type of SQL entity it
 
1096
    represents. If such an entity represents a nested table reference,
 
1097
    this iterator encapsulates the iteration over the columns of the
 
1098
    members of the table reference.
 
1099
 
 
1100
  IMPLEMENTATION
 
1101
    The implementation assumes that all underlying NATURAL/USING table
 
1102
    references already contain their result columns and are linked into
 
1103
    the list TABLE_LIST::next_name_resolution_table.
 
1104
*/
 
1105
 
 
1106
class Field_iterator_table_ref: public Field_iterator
 
1107
{
 
1108
  TABLE_LIST *table_ref, *first_leaf, *last_leaf;
 
1109
  Field_iterator_table        table_field_it;
 
1110
  Field_iterator_view         view_field_it;
 
1111
  Field_iterator_natural_join natural_join_it;
 
1112
  Field_iterator *field_it;
 
1113
  void set_field_iterator();
 
1114
public:
 
1115
  Field_iterator_table_ref() :field_it(NULL) {}
 
1116
  void set(TABLE_LIST *table);
 
1117
  void next();
 
1118
  bool end_of_fields()
 
1119
  { return (table_ref == last_leaf && field_it->end_of_fields()); }
 
1120
  const char *name() { return field_it->name(); }
 
1121
  const char *table_name();
 
1122
  const char *db_name();
 
1123
  Item *create_item(THD *thd) { return field_it->create_item(thd); }
 
1124
  Field *field() { return field_it->field(); }
 
1125
  Natural_join_column *get_or_create_column_ref(TABLE_LIST *parent_table_ref);
 
1126
  Natural_join_column *get_natural_column_ref();
 
1127
};
 
1128
 
 
1129
 
 
1130
typedef struct st_nested_join
 
1131
{
 
1132
  List<TABLE_LIST>  join_list;       /* list of elements in the nested join */
 
1133
  table_map         used_tables;     /* bitmap of tables in the nested join */
 
1134
  table_map         not_null_tables; /* tables that rejects nulls           */
 
1135
  struct st_join_table *first_nested;/* the first nested table in the plan  */
 
1136
  /* 
 
1137
    Used to count tables in the nested join in 2 isolated places:
 
1138
    1. In make_outerjoin_info(). 
 
1139
    2. check_interleaving_with_nj/restore_prev_nj_state (these are called
 
1140
       by the join optimizer. 
 
1141
    Before each use the counters are zeroed by reset_nj_counters.
 
1142
  */
 
1143
  uint              counter_;
 
1144
  nested_join_map   nj_map;          /* Bit used to identify this nested join*/
 
1145
  /*
 
1146
    (Valid only for semi-join nests) Bitmap of tables outside the semi-join
 
1147
    that are used within the semi-join's ON condition.
 
1148
  */
 
1149
  table_map         sj_depends_on;
 
1150
  /* Outer non-trivially correlated tables */
 
1151
  table_map         sj_corr_tables;
 
1152
  List<Item>        sj_outer_expr_list;
 
1153
} NESTED_JOIN;
 
1154
 
 
1155
 
731
1156
typedef struct st_changed_table_list
732
1157
{
733
1158
  struct        st_changed_table_list *next;
734
1159
  char          *key;
735
 
  uint32_t        key_length;
736
 
} CHANGED_TableList;
737
 
 
738
 
 
739
 
typedef struct st_open_table_list
740
 
{
 
1160
  uint32        key_length;
 
1161
} CHANGED_TABLE_LIST;
 
1162
 
 
1163
 
 
1164
typedef struct st_open_table_list{
741
1165
  struct st_open_table_list *next;
742
1166
  char  *db,*table;
743
 
  uint32_t in_use,locked;
744
 
} OPEN_TableList;
745
 
 
746
 
 
747
 
#endif /* DRIZZLED_TABLE_H */
 
1167
  uint32 in_use,locked;
 
1168
} OPEN_TABLE_LIST;
 
1169
 
 
1170
typedef struct st_table_field_w_type
 
1171
{
 
1172
  LEX_STRING name;
 
1173
  LEX_STRING type;
 
1174
  LEX_STRING cset;
 
1175
} TABLE_FIELD_W_TYPE;
 
1176
 
 
1177
 
 
1178
my_bool
 
1179
table_check_intact(TABLE *table, const uint table_f_count,
 
1180
                   const TABLE_FIELD_W_TYPE *table_def);
 
1181
 
 
1182
static inline my_bitmap_map *tmp_use_all_columns(TABLE *table,
 
1183
                                                 MY_BITMAP *bitmap)
 
1184
{
 
1185
  my_bitmap_map *old= bitmap->bitmap;
 
1186
  bitmap->bitmap= table->s->all_set.bitmap;
 
1187
  return old;
 
1188
}
 
1189
 
 
1190
 
 
1191
static inline void tmp_restore_column_map(MY_BITMAP *bitmap,
 
1192
                                          my_bitmap_map *old)
 
1193
{
 
1194
  bitmap->bitmap= old;
 
1195
}
 
1196
 
 
1197
/* The following is only needed for debugging */
 
1198
 
 
1199
static inline my_bitmap_map *dbug_tmp_use_all_columns(TABLE *table,
 
1200
                                                      MY_BITMAP *bitmap)
 
1201
{
 
1202
#ifndef DBUG_OFF
 
1203
  return tmp_use_all_columns(table, bitmap);
 
1204
#else
 
1205
  return 0;
 
1206
#endif
 
1207
}
 
1208
 
 
1209
static inline void dbug_tmp_restore_column_map(MY_BITMAP *bitmap,
 
1210
                                               my_bitmap_map *old)
 
1211
{
 
1212
#ifndef DBUG_OFF
 
1213
  tmp_restore_column_map(bitmap, old);
 
1214
#endif
 
1215
}
 
1216
 
 
1217
size_t max_row_length(TABLE *table, const uchar *data);
 
1218