Commit cf6ffcf6 authored by unknown's avatar unknown

ft_* and *bulk_insert* variables re-documented

parent 0c2d19b5
...@@ -19568,9 +19568,9 @@ The output resembles that shown below, though the format and numbers may ...@@ -19568,9 +19568,9 @@ The output resembles that shown below, though the format and numbers may
differ somewhat: differ somewhat:
@example @example
+-------------------------+---------------------------+ +------------------------------+---------------------------+
| Variable_name | Value | | Variable_name | Value |
+-------------------------+---------------------------+ +------------------------------+---------------------------+
| ansi_mode | OFF | | ansi_mode | OFF |
| back_log | 50 | | back_log | 50 |
| basedir | /my/monty/ | | basedir | /my/monty/ |
...@@ -19591,6 +19591,9 @@ differ somewhat: ...@@ -19591,6 +19591,9 @@ differ somewhat:
| delayed_queue_size | 1000 | | delayed_queue_size | 1000 |
| flush | OFF | | flush | OFF |
| flush_time | 0 | | flush_time | 0 |
| ft_min_word_len | 4 |
| ft_max_word_len | 254 |
| ft_max_word_len_for_sort | 20 |
| have_bdb | YES | | have_bdb | YES |
| have_innodb | YES | | have_innodb | YES |
| have_raid | YES | | have_raid | YES |
...@@ -19618,6 +19621,7 @@ differ somewhat: ...@@ -19618,6 +19621,7 @@ differ somewhat:
| max_sort_length | 1024 | | max_sort_length | 1024 |
| max_tmp_tables | 32 | | max_tmp_tables | 32 |
| max_write_lock_count | 4294967295 | | max_write_lock_count | 4294967295 |
| myisam_bulk_insert_tree_size | 8388608 |
| myisam_recover_options | DEFAULT | | myisam_recover_options | DEFAULT |
| myisam_sort_buffer_size | 8388608 | | myisam_sort_buffer_size | 8388608 |
| net_buffer_length | 16384 | | net_buffer_length | 16384 |
...@@ -19646,7 +19650,7 @@ differ somewhat: ...@@ -19646,7 +19650,7 @@ differ somewhat:
| tmpdir | /tmp/ | | tmpdir | /tmp/ |
| version | 3.23.29a-gamma-debug | | version | 3.23.29a-gamma-debug |
| wait_timeout | 28800 | | wait_timeout | 28800 |
+-------------------------+---------------------------+ +------------------------------+---------------------------+
@end example @end example
Each option is described below. Values for buffer sizes, lengths, and stack Each option is described below. Values for buffer sizes, lengths, and stack
...@@ -19773,6 +19777,30 @@ tables will be closed (to free up resources and sync things to disk). We ...@@ -19773,6 +19777,30 @@ tables will be closed (to free up resources and sync things to disk). We
only recommend this option on Win95, Win98, or on systems where you have only recommend this option on Win95, Win98, or on systems where you have
very little resources. very little resources.
@item @code{ft_min_word_len}
The minimum length of the word to be included in a @code{FULLTEXT} index.
@strong{Note: @code{FULLTEXT} index have to be rebuilt after changing
this variable.}
@item @code{ft_max_word_len}
The maximum length of the word to be included in a @code{FULLTEXT} index.
@strong{Note: @code{FULLTEXT} index have to be rebuilt after changing
this variable.}
@item @code{ft_max_word_len_sort}
The maximum length of the word in a @code{FULLTEXT} index
to be used in fast index recreation method in @code{REPAIR},
@code{CREATE INDEX}, or @code{ALTER TABLE}. Longer words are inserted the
slow way. The rule of the thumb is as follows: with
@code{ft_max_word_len_sort} increasing, @strong{MySQL} will create bigger
temporary files (thus slowing the process down, due to disk I/O), and will put
fewer keys in one sort block (againg, decreasing the efficiency). When
@code{ft_max_word_len_sort} is too small, instead, @strong{MySQL} will insert a
lot of words into index the slow way - but short words will be inserted very
fast. It applies only to index recreation during @code{REPAIR},
@code{CREATE INDEX}, or @code{ALTER TABLE}.
@item @code{have_bdb} @item @code{have_bdb}
@code{YES} if @code{mysqld} supports Berkeley DB tables. @code{DISABLED} @code{YES} if @code{mysqld} supports Berkeley DB tables. @code{DISABLED}
if @code{--skip-bdb} is used. if @code{--skip-bdb} is used.
...@@ -19919,6 +19947,12 @@ Maximum number of temporary tables a client can keep open at the same time. ...@@ -19919,6 +19947,12 @@ Maximum number of temporary tables a client can keep open at the same time.
@item @code{max_write_lock_count} @item @code{max_write_lock_count}
After this many write locks, allow some read locks to run in between. After this many write locks, allow some read locks to run in between.
@item @code{myisam_bulk_insert_tree_size}
MySQL uses special tree-like cache to make bulk inserts (that is,
@code{INSERT ... SELECT}, @code{INSERT ... VALUES (...), (...), ...}, and
@code{LOAD DATA INFILE}) faster. This variable limits
the size of the cache tree in bytes per thread. Default value is 8 MB.
@item @code{myisam_recover_options} @item @code{myisam_recover_options}
The value of the @code{--myisam-recover} option. The value of the @code{--myisam-recover} option.
...@@ -35079,10 +35113,10 @@ The argument to @code{AGAINST} must be a constant string. ...@@ -35079,10 +35113,10 @@ The argument to @code{AGAINST} must be a constant string.
@node Fulltext Fine-tuning, Fulltext Features to Appear in MySQL 4.0, Fulltext restrictions, Fulltext Search @node Fulltext Fine-tuning, Fulltext Features to Appear in MySQL 4.0, Fulltext restrictions, Fulltext Search
@subsection Fine-tuning MySQL Full-text Search @subsection Fine-tuning MySQL Full-text Search
Unfortunately, full-text search has no user-tunable parameters yet, Unfortunately, full-text search has few user-tunable parameters yet,
although adding some is very high on the TODO. However, if you have a although adding some is very high on the TODO. If you have a
MySQL source distribution (@pxref{Installing source}), you can MySQL source distribution (@pxref{Installing source}), you can
somewhat alter the full-text search behavior. more control on the full-text search behavior.
Note that full-text search was carefully tuned for the best searching Note that full-text search was carefully tuned for the best searching
effectiveness. Modifying the default behavior will, in most cases, effectiveness. Modifying the default behavior will, in most cases,
...@@ -35092,12 +35126,9 @@ unless you know what you are doing! ...@@ -35092,12 +35126,9 @@ unless you know what you are doing!
@itemize @bullet @itemize @bullet
@item @item
Minimal length of word to be indexed is defined in Minimal length of word to be indexed is defined by MySQL
@code{myisam/ftdefs.h} file by the line variable @code{ft_min_word_length}. @xref{SHOW VARIABLES}.
@example Change it to the value you prefer, and rebuild
#define MIN_WORD_LEN 4
@end example
Change it to the value you prefer, recompile MySQL, and rebuild
your @code{FULLTEXT} indexes. your @code{FULLTEXT} indexes.
@item @item
...@@ -35392,8 +35423,8 @@ The following options to @code{mysqld} can be used to change the behavior of ...@@ -35392,8 +35423,8 @@ The following options to @code{mysqld} can be used to change the behavior of
@item @code{-O myisam_sort_buffer_size=#} @tab Buffer used when recovering tables. @item @code{-O myisam_sort_buffer_size=#} @tab Buffer used when recovering tables.
@item @code{--delay-key-write-for-all-tables} @tab Don't flush key buffers between writes for any MyISAM table @item @code{--delay-key-write-for-all-tables} @tab Don't flush key buffers between writes for any MyISAM table
@item @code{-O myisam_max_extra_sort_file_size=#} @tab Used to help MySQL to decide when to use the slow but safe key cache index create method. @strong{NOTE} that this parameter is given in megabytes! @item @code{-O myisam_max_extra_sort_file_size=#} @tab Used to help MySQL to decide when to use the slow but safe key cache index create method. @strong{NOTE} that this parameter is given in megabytes!
@item @code{-O myisam_max_sort_file_size=#} @tab Don't use the fast sort index method to created index if the temporary file would get bigger than this. @item @code{-O myisam_max_sort_file_size=#} @tab Don't use the fast sort index method to created index if the temporary file would get bigger than this. @strong{NOTE} that this paramter is given in megabytes!
@strong{NOTE} that this paramter is given in megabytes! @item @code{-O myisam_bulk_insert_tree_size=#} @tab Size of tree cache used in bulk insert optimization. @strong{NOTE} that this is a limit @strong{per thread}!
@end multitable @end multitable
The automatic recovery is activated if you start @code{mysqld} with The automatic recovery is activated if you start @code{mysqld} with
...@@ -47875,6 +47906,9 @@ Fixed a bug when using @code{HEAP} tables with @code{LIKE}. ...@@ -47875,6 +47906,9 @@ Fixed a bug when using @code{HEAP} tables with @code{LIKE}.
@item @item
Added @code{--mysql-version} to @code{safe_mysqld} Added @code{--mysql-version} to @code{safe_mysqld}
@item @item
Added variables @code{ft_min_word_len}, @code{ft_max_word_len}, and
@code{ft_max_word_len_for_sort}.
@item
Changed @code{INNOBASE} to @code{InnoDB} (because the @code{INNOBASE} Changed @code{INNOBASE} to @code{InnoDB} (because the @code{INNOBASE}
name was already used). All @code{configure} options and @code{mysqld} name was already used). All @code{configure} options and @code{mysqld}
start options are now using @code{innodb} instead of @code{innobase}. This start options are now using @code{innodb} instead of @code{innobase}. This
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment