MySQL 5.6.14 Source Code Document
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
ha_federated Class Reference
Inheritance diagram for ha_federated:
Collaboration diagram for ha_federated:

Public Member Functions

 ha_federated (handlerton *hton, TABLE_SHARE *table_arg)
const char * table_type () const
const char * index_type (uint inx)
const char ** bas_ext () const
ulonglong table_flags () const
ulong index_flags (uint inx, uint part, bool all_parts) const
uint max_supported_record_length () const
uint max_supported_keys () const
uint max_supported_key_parts () const
uint max_supported_key_length () const
uint max_supported_key_part_length () const
double scan_time ()
double read_time (uint index, uint ranges, ha_rows rows)
const key_mapkeys_to_use_for_scanning ()
int open (const char *name, int mode, uint test_if_locked)
int close (void)
void start_bulk_insert (ha_rows rows)
 Prepares the storage engine for bulk inserts.
int end_bulk_insert ()
 End bulk insert.
int write_row (uchar *buf)
int update_row (const uchar *old_data, uchar *new_data)
int delete_row (const uchar *buf)
int index_init (uint keynr, bool sorted)
ha_rows estimate_rows_upper_bound ()
int index_read (uchar *buf, const uchar *key, uint key_len, enum ha_rkey_function find_flag)
int index_read_idx (uchar *buf, uint idx, const uchar *key, uint key_len, enum ha_rkey_function find_flag)
int index_next (uchar *buf)
int index_end ()
int read_range_first (const key_range *start_key, const key_range *end_key, bool eq_range, bool sorted)
 Read first row between two ranges. Store ranges for future calls to read_range_next.
int read_range_next ()
 Read next row between two endpoints.
int rnd_init (bool scan)
int rnd_end ()
int rnd_next (uchar *buf)
int rnd_next_int (uchar *buf)
int rnd_pos (uchar *buf, uchar *pos)
void position (const uchar *record)
 Store a reference to current row.
int info (uint)
int extra (ha_extra_function operation)
 Handles extra signals from MySQL server.
void update_auto_increment (void)
int repair (THD *thd, HA_CHECK_OPT *check_opt)
int optimize (THD *thd, HA_CHECK_OPT *check_opt)
int delete_all_rows (void)
int truncate ()
int create (const char *name, TABLE *form, HA_CREATE_INFO *create_info)
ha_rows records_in_range (uint inx, key_range *start_key, key_range *end_key)
uint8 table_cache_type ()
THR_LOCK_DATA ** store_lock (THD *thd, THR_LOCK_DATA **to, enum thr_lock_type lock_type)
bool get_error_message (int error, String *buf)
MYSQL_RESstore_result (MYSQL *mysql)
 Store a result set.
void free_result ()
int external_lock (THD *thd, int lock_type)
int connection_commit ()
int connection_rollback ()
int connection_autocommit (bool state)
int execute_simple_query (const char *query, int len)
int reset (void)
 Reset state of file to after 'open'.
- Public Member Functions inherited from handler
virtual void unbind_psi ()
virtual void rebind_psi ()
 handler (handlerton *ht_arg, TABLE_SHARE *share_arg)
virtual handlerclone (const char *name, MEM_ROOT *mem_root)
void init ()
int ha_open (TABLE *table, const char *name, int mode, int test_if_locked)
 Open database-handler.
int ha_close (void)
int ha_index_init (uint idx, bool sorted)
int ha_index_end ()
int ha_rnd_init (bool scan)
int ha_rnd_end ()
int ha_rnd_next (uchar *buf)
int ha_rnd_pos (uchar *buf, uchar *pos)
int ha_index_read_map (uchar *buf, const uchar *key, key_part_map keypart_map, enum ha_rkey_function find_flag)
int ha_index_read_last_map (uchar *buf, const uchar *key, key_part_map keypart_map)
int ha_index_read_idx_map (uchar *buf, uint index, const uchar *key, key_part_map keypart_map, enum ha_rkey_function find_flag)
int ha_index_next (uchar *buf)
int ha_index_prev (uchar *buf)
int ha_index_first (uchar *buf)
int ha_index_last (uchar *buf)
int ha_index_next_same (uchar *buf, const uchar *key, uint keylen)
int ha_index_read (uchar *buf, const uchar *key, uint key_len, enum ha_rkey_function find_flag)
int ha_index_read_last (uchar *buf, const uchar *key, uint key_len)
int ha_reset ()
 Check handler usage and reset state of file to after 'open'.
int ha_index_or_rnd_end ()
Table_flags ha_table_flags () const
int ha_external_lock (THD *thd, int lock_type)
int ha_write_row (uchar *buf)
int ha_update_row (const uchar *old_data, uchar *new_data)
int ha_delete_row (const uchar *buf)
void ha_release_auto_increment ()
int check_collation_compatibility ()
int ha_check_for_upgrade (HA_CHECK_OPT *check_opt)
int ha_check (THD *thd, HA_CHECK_OPT *check_opt)
int ha_repair (THD *thd, HA_CHECK_OPT *check_opt)
void ha_start_bulk_insert (ha_rows rows)
int ha_end_bulk_insert ()
int ha_bulk_update_row (const uchar *old_data, uchar *new_data, uint *dup_key_found)
int ha_delete_all_rows ()
int ha_truncate ()
int ha_reset_auto_increment (ulonglong value)
int ha_optimize (THD *thd, HA_CHECK_OPT *check_opt)
int ha_analyze (THD *thd, HA_CHECK_OPT *check_opt)
bool ha_check_and_repair (THD *thd)
int ha_disable_indexes (uint mode)
int ha_enable_indexes (uint mode)
int ha_discard_or_import_tablespace (my_bool discard)
int ha_rename_table (const char *from, const char *to)
int ha_delete_table (const char *name)
void ha_drop_table (const char *name)
int ha_create (const char *name, TABLE *form, HA_CREATE_INFO *info)
int ha_create_handler_files (const char *name, const char *old_name, int action_flag, HA_CREATE_INFO *info)
int ha_change_partitions (HA_CREATE_INFO *create_info, const char *path, ulonglong *const copied, ulonglong *const deleted, const uchar *pack_frm_data, size_t pack_frm_len)
int ha_drop_partitions (const char *path)
int ha_rename_partitions (const char *path)
void adjust_next_insert_id_after_explicit_value (ulonglong nr)
virtual void print_error (int error, myf errflag)
uint get_dup_key (int error)
virtual bool get_foreign_dup_key (char *child_table_name, uint child_table_name_len, char *child_key_name, uint child_key_name_len)
virtual void change_table_ptr (TABLE *table_arg, TABLE_SHARE *share)
virtual double index_only_read_time (uint keynr, double records)
virtual longlong get_memory_buffer_size () const
virtual ha_rows multi_range_read_info_const (uint keyno, RANGE_SEQ_IF *seq, void *seq_init_param, uint n_ranges, uint *bufsz, uint *flags, Cost_estimate *cost)
virtual ha_rows multi_range_read_info (uint keyno, uint n_ranges, uint keys, uint *bufsz, uint *flags, Cost_estimate *cost)
virtual int multi_range_read_init (RANGE_SEQ_IF *seq, void *seq_init_param, uint n_ranges, uint mode, HANDLER_BUFFER *buf)
virtual int multi_range_read_next (char **range_info)
bool has_transactions ()
virtual uint extra_rec_buf_length () const
virtual bool is_fatal_error (int error, uint flags)
virtual ha_rows records ()
virtual enum row_type get_row_type () const
virtual void column_bitmaps_signal ()
 MySQL signal that it changed the column bitmap.
uint get_index (void) const
virtual bool start_bulk_update ()
virtual bool start_bulk_delete ()
virtual int exec_bulk_update (uint *dup_key_found)
virtual void end_bulk_update ()
virtual int end_bulk_delete ()
void set_end_range (const key_range *range, enum_range_scan_direction direction)
int compare_key (key_range *range)
int compare_key_icp (const key_range *range) const
virtual int ft_init ()
void ft_end ()
virtual FT_INFOft_init_ext (uint flags, uint inx, String *key)
virtual int ft_read (uchar *buf)
virtual int rnd_pos_by_record (uchar *record)
virtual int read_first_row (uchar *buf, uint primary_key)
virtual int restart_rnd_next (uchar *buf, uchar *pos)
virtual int rnd_same (uchar *buf, uint inx)
virtual void get_dynamic_partition_info (PARTITION_STATS *stat_info, uint part_id)
virtual uint32 calculate_key_hash_value (Field **field_array)
virtual int extra_opt (enum ha_extra_function operation, ulong cache_size)
virtual bool start_read_removal (void)
virtual ha_rows end_read_removal (void)
virtual bool was_semi_consistent_read ()
virtual void try_semi_consistent_read (bool)
virtual void unlock_row ()
virtual int start_stmt (THD *thd, thr_lock_type lock_type)
virtual void get_auto_increment (ulonglong offset, ulonglong increment, ulonglong nb_desired_values, ulonglong *first_value, ulonglong *nb_reserved_values)
void set_next_insert_id (ulonglong id)
void restore_auto_increment (ulonglong prev_insert_id)
virtual void update_create_info (HA_CREATE_INFO *create_info)
int check_old_types ()
virtual int assign_to_keycache (THD *thd, HA_CHECK_OPT *check_opt)
virtual int preload_keys (THD *thd, HA_CHECK_OPT *check_opt)
virtual int indexes_are_disabled (void)
virtual char * update_table_comment (const char *comment)
virtual void append_create_info (String *packet)
virtual bool is_fk_defined_on_table_or_index (uint index)
virtual char * get_foreign_key_create_info ()
virtual bool can_switch_engines ()
virtual int get_foreign_key_list (THD *thd, List< FOREIGN_KEY_INFO > *f_key_list)
virtual int get_parent_foreign_key_list (THD *thd, List< FOREIGN_KEY_INFO > *f_key_list)
virtual uint referenced_by_foreign_key ()
virtual void init_table_handle_for_HANDLER ()
virtual void free_foreign_key_create_info (char *str)
virtual int get_default_no_partitions (HA_CREATE_INFO *info)
virtual void set_auto_partitions (partition_info *part_info)
virtual bool get_no_parts (const char *name, uint *no_parts)
virtual void set_part_info (partition_info *part_info, bool early)
uint max_record_length () const
uint max_keys () const
uint max_key_parts () const
uint max_key_length () const
uint max_key_part_length () const
virtual uint min_record_length (uint options) const
virtual bool low_byte_first () const
virtual uint checksum () const
virtual bool is_crashed () const
virtual bool auto_repair () const
virtual uint lock_count (void) const
virtual my_bool register_query_cache_table (THD *thd, char *table_key, uint key_length, qc_engine_callback *engine_callback, ulonglong *engine_data)
 Register a named table with a call back function to the query cache.
virtual bool primary_key_is_clustered ()
virtual int cmp_ref (const uchar *ref1, const uchar *ref2)
virtual const Itemcond_push (const Item *cond)
virtual void cond_pop ()
virtual Itemidx_cond_push (uint keyno, Item *idx_cond)
virtual void cancel_pushed_idx_cond ()
virtual uint number_of_pushed_joins () const
virtual const TABLEroot_of_pushed_join () const
virtual const TABLEparent_of_pushed_join () const
virtual int index_read_pushed (uchar *buf, const uchar *key, key_part_map keypart_map)
virtual int index_next_pushed (uchar *buf)
virtual bool check_if_incompatible_data (HA_CREATE_INFO *create_info, uint table_changes)
virtual enum_alter_inplace_result check_if_supported_inplace_alter (TABLE *altered_table, Alter_inplace_info *ha_alter_info)
bool ha_prepare_inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info)
bool ha_inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info)
bool ha_commit_inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info, bool commit)
void ha_notify_table_changed ()
virtual void use_hidden_primary_key ()
virtual uint alter_table_flags (uint flags)
virtual int bulk_update_row (const uchar *old_data, uchar *new_data, uint *dup_key_found)
virtual int reset_auto_increment (ulonglong value)
virtual int analyze (THD *thd, HA_CHECK_OPT *check_opt)
virtual bool check_and_repair (THD *thd)
virtual int disable_indexes (uint mode)
virtual int enable_indexes (uint mode)
virtual int discard_or_import_tablespace (my_bool discard)
virtual void drop_table (const char *name)
virtual int create_handler_files (const char *name, const char *old_name, int action_flag, HA_CREATE_INFO *info)
virtual int change_partitions (HA_CREATE_INFO *create_info, const char *path, ulonglong *const copied, ulonglong *const deleted, const uchar *pack_frm_data, size_t pack_frm_len)
virtual int drop_partitions (const char *path)
virtual int rename_partitions (const char *path)
virtual bool set_ha_share_ref (Handler_share **arg_ha_share)
int get_lock_type () const

Public Attributes

ha_federatedtrx_next
- Public Attributes inherited from handler
handlertonht
uchar * ref
uchar * dup_ref
ha_statistics stats
range_seq_t mrr_iter
RANGE_SEQ_IF mrr_funcs
HANDLER_BUFFERmulti_range_buffer
uint ranges_in_seq
bool mrr_is_output_sorted
bool mrr_have_range
KEY_MULTI_RANGE mrr_cur_range
key_rangeend_range
uint errkey
uint key_used_on_scan
uint active_index
uint ref_length
FT_INFOft_handler
enum handler:: { ... }  inited
bool implicit_emptied
const Itempushed_cond
Itempushed_idx_cond
uint pushed_idx_cond_keyno
ulonglong next_insert_id
ulonglong insert_id_for_cur_row
Discrete_interval auto_inc_interval_for_cur_row
uint auto_inc_intervals_count
PSI_table * m_psi

Additional Inherited Members

- Public Types inherited from handler
enum  enum_range_scan_direction { RANGE_SCAN_ASC, RANGE_SCAN_DESC }
enum  { NONE = 0, INDEX, RND }
typedef ulonglong Table_flags
- Static Public Member Functions inherited from Sql_alloc
static void * operator new (size_t size) throw ()
static void * operator new[] (size_t size) throw ()
static void * operator new[] (size_t size, MEM_ROOT *mem_root) throw ()
static void * operator new (size_t size, MEM_ROOT *mem_root) throw ()
static void operator delete (void *ptr, size_t size)
static void operator delete (void *ptr, MEM_ROOT *mem_root)
static void operator delete[] (void *ptr, MEM_ROOT *mem_root)
static void operator delete[] (void *ptr, size_t size)
- Protected Member Functions inherited from handler
virtual int index_read_map (uchar *buf, const uchar *key, key_part_map keypart_map, enum ha_rkey_function find_flag)
 Positions an index cursor to the index specified in the handle ('active_index'). Fetches the row if available. If the key value is null, begin at the first key of the index.
virtual int index_read_idx_map (uchar *buf, uint index, const uchar *key, key_part_map keypart_map, enum ha_rkey_function find_flag)
 Positions an index cursor to the index specified in argument. Fetches the row if available. If the key value is null, begin at the first key of the index.
virtual int index_prev (uchar *buf)
virtual int index_first (uchar *buf)
virtual int index_last (uchar *buf)
virtual int index_next_same (uchar *buf, const uchar *key, uint keylen)
virtual int index_read_last_map (uchar *buf, const uchar *key, key_part_map keypart_map)
 The following functions works like index_read, but it find the last row with the current key value or prefix.
virtual bool prepare_inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info)
virtual bool inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info)
virtual bool commit_inplace_alter_table (TABLE *altered_table, Alter_inplace_info *ha_alter_info, bool commit)
virtual void notify_table_changed ()
void ha_statistic_increment (ulonglong SSV::*offset) const
void ** ha_data (THD *) const
THD * ha_thd (void) const
PSI_table_share * ha_table_share_psi (const TABLE_SHARE *share) const
virtual int rename_table (const char *from, const char *to)
virtual int delete_table (const char *name)
virtual int index_read_last (uchar *buf, const uchar *key, uint key_len)
Handler_shareget_ha_share_ptr ()
void set_ha_share_ptr (Handler_share *arg_ha_share)
void lock_shared_ha_data ()
void unlock_shared_ha_data ()
- Protected Attributes inherited from handler
TABLE_SHAREtable_share
TABLEtable
Table_flags cached_table_flags
ha_rows estimation_rows_to_insert
KEY_PART_INFOrange_key_part
bool eq_range
bool in_range_check_pushed_down

Detailed Description

Definition at line 77 of file ha_federated.h.

Member Function Documentation

const char ** ha_federated::bas_ext ( ) const
virtual

If frm_error() is called then we will use this to find out what file extentions exist for the storage engine. This is also used by the default rename_table and delete_table method in handler.cc.

For engines that have two file name extentions (separate meta/index file and data file), the order of elements is relevant. First element of engine file name extentions array should be meta/index file extention. Second element - data file extention. This order is assumed by prepare_for_repair() when REPAIR TABLE ... USE_FRM is issued.

Implements handler.

Definition at line 1621 of file ha_federated.cc.

int ha_federated::delete_all_rows ( void  )
virtual

This is called to delete all rows in a table If the handler don't support this, then this function will return HA_ERR_WRONG_COMMAND and MySQL will delete the rows one by one.

Reimplemented from handler.

Definition at line 2986 of file ha_federated.cc.

Here is the caller graph for this function:

int ha_federated::end_bulk_insert ( )
virtual

End bulk insert.

This method will send any remaining rows to the remote server. Finally, it will deinitialize the bulk insert data structure.

Returns
Operation status
Return values
0No error
!=0 Error occured at remote server. Also sets my_errno.

Reimplemented from handler.

Definition at line 1985 of file ha_federated.cc.

ha_rows ha_federated::estimate_rows_upper_bound ( void  )
virtual

Return upper bound of current number of records in the table (max. of how many records one will retrieve when doing a full table scan) If upper bound is not known, HA_POS_ERROR should be returned as a max possible upper bound.

Reimplemented from handler.

Definition at line 2450 of file ha_federated.cc.

int ha_federated::extra ( ha_extra_function  operation)
virtual

Handles extra signals from MySQL server.

Parameters
[in]operationHint for storage engine
Returns
Operation Status
Return values
0OK

Reimplemented from handler.

Definition at line 2913 of file ha_federated.cc.

bool ha_federated::get_error_message ( int  error,
String buf 
)
virtual

Return an error message specific to this handler.

Parameters
errorerror code previously returned by handler
bufpointer to String where to add error message
Returns
Returns true if this is a temporary error

Reimplemented from handler.

Definition at line 3225 of file ha_federated.cc.

int ha_federated::index_next ( uchar *  buf)
virtual
Returns
See Also
index_read_map().

Reimplemented from handler.

Definition at line 2526 of file ha_federated.cc.

void ha_federated::position ( const uchar *  record)
virtual

Store a reference to current row.

During a query execution we may have different result sets (RS), e.g. for different ranges. All the RS's used are stored in memory and placed in results dynamic array. At the end of execution all stored RS's are freed at once in the ha_federated::reset(). So, in case of federated, a reference to current row is a stored result address and current data cursor position. As we keep all RS in memory during a query execution, we can get any record using the reference any time until ha_federated::reset() is called. TODO: we don't have to store all RS's rows but only those we call ha_federated::position() for, so we can free memory where we store other rows in the ha_federated::index_end().

Parameters
[in]recordrecord data (unused)

Implements handler.

Definition at line 2715 of file ha_federated.cc.

int ha_federated::read_range_first ( const key_range start_key,
const key_range end_key,
bool  eq_range_arg,
bool  sorted 
)
virtual

Read first row between two ranges. Store ranges for future calls to read_range_next.

Parameters
start_keyStart key. Is 0 if no min range
end_keyEnd key. Is 0 if no max range
eq_range_argSet to 1 if start_key == end_key
sortedSet to 1 if result should be sorted per key
Note
Record is read into table->record[0]
Return values
0Found row
HA_ERR_END_OF_FILENo rows in range
\::Error code

Reimplemented from handler.

Definition at line 2471 of file ha_federated.cc.

Here is the call graph for this function:

int ha_federated::read_range_next ( )
virtual

Read next row between two endpoints.

Note
Record is read into table->record[0]
Return values
0Found row
HA_ERR_END_OF_FILENo rows in range
\::Error code

Reimplemented from handler.

Definition at line 2514 of file ha_federated.cc.

double ha_federated::read_time ( uint  index,
uint  ranges,
ha_rows  rows 
)
inlinevirtual

The cost of reading a set of ranges from the table using an index to access it.

Parameters
indexThe index number.
rangesThe number of ranges to be read.
rowsTotal number of rows to be read.

This method can be used to calculate the total cost of scanning a table using an index by calling it using read_time(index, 1, table_size).

Reimplemented from handler.

Definition at line 191 of file ha_federated.h.

int ha_federated::repair ( THD *  thd,
HA_CHECK_OPT check_opt 
)
virtual

In this method check_opt can be modified to specify CHECK option to use to call check() upon the table.

Reimplemented from handler.

Definition at line 2048 of file ha_federated.cc.

int ha_federated::reset ( void  )
virtual

Reset state of file to after 'open'.

This function is called after every statement for all tables used by that statement.

Returns
Operation status
Return values
0OK

Reimplemented from handler.

Definition at line 2955 of file ha_federated.cc.

int ha_federated::rnd_init ( bool  scan)
virtual

rnd_init() can be called two times without rnd_end() in between (it only makes sense if scan=1). then the second call should prepare for the new table scan (e.g if rnd_init allocates the cursor, second call should position it to the start of the table, no need to deallocate and allocate it again

Implements handler.

Definition at line 2551 of file ha_federated.cc.

Here is the call graph for this function:

int ha_federated::rnd_next ( uchar *  buf)
virtual
Returns
See Also
index_read_map().

Implements handler.

Definition at line 2625 of file ha_federated.cc.

int ha_federated::rnd_pos ( uchar *  buf,
uchar *  pos 
)
virtual
Returns
See Also
index_read_map().

Implements handler.

Definition at line 2740 of file ha_federated.cc.

void ha_federated::start_bulk_insert ( ha_rows  rows)
virtual

Prepares the storage engine for bulk inserts.

Parameters
[in]rowsestimated number of rows in bulk insert or 0 if unknown.

Initializes memory structures required for bulk insert.

We don't bother with bulk-insert semantics when the estimated rows == 1 The rows value will be 0 if the server does not know how many rows would be inserted. This can occur when performing INSERT...SELECT

Reimplemented from handler.

Definition at line 1941 of file ha_federated.cc.

THR_LOCK_DATA ** ha_federated::store_lock ( THD *  thd,
THR_LOCK_DATA **  to,
enum thr_lock_type  lock_type 
)
virtual

Is not invoked for non-transactional temporary tables.

Note
store_lock() can return more than one lock if the table is MERGE or partitioned.
that one can NOT rely on table->in_use in store_lock(). It may refer to a different thread if called from mysql_lock_abort_for_thread().
If the table is MERGE, store_lock() can return less locks than lock_count() claimed. This can happen when the MERGE children are not attached when this is called from another thread.

Implements handler.

Definition at line 3052 of file ha_federated.cc.

MYSQL_RES * ha_federated::store_result ( MYSQL mysql_arg)

Store a result set.

Call mysql_store_result() to save a result set then append it to the stored results array.

Parameters
[in]mysql_argMySLQ connection structure.
Returns
Stored result set (MYSQL_RES object).

Definition at line 3255 of file ha_federated.cc.

Here is the caller graph for this function:

uint8 ha_federated::table_cache_type ( void  )
inlinevirtual

Type of table for caching query

Reimplemented from handler.

Definition at line 254 of file ha_federated.h.

const char* ha_federated::table_type ( ) const
inlinevirtual

The following can be called without an open handler

Implements handler.

Definition at line 123 of file ha_federated.h.

int ha_federated::truncate ( )
virtual

Quickly remove all rows from a table.

Remarks
This method is responsible for implementing MySQL's TRUNCATE TABLE statement, which is a DDL operation. As such, a engine can bypass certain integrity checks and in some cases avoid fine-grained locking (e.g. row locks) which would normally be required for a DELETE statement.
Typically, truncate is not used if it can result in integrity violation. For example, truncate is not used when a foreign key references the table, but it might be used if foreign key checks are disabled.
Engine is responsible for resetting the auto-increment counter.
The table is locked in exclusive mode.

Reimplemented from handler.

Definition at line 3016 of file ha_federated.cc.

Here is the call graph for this function:


The documentation for this class was generated from the following files: