#ifndef OPTIMIZER_DEFAULTS_INCLUDED #define OPTIMIZER_DEFAULTS_INCLUDED /* Copyright (c) 2022, MariaDB AB This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1335 USA */ /* This file contains costs constants used by the optimizer All costs should be based on milliseconds (1 cost = 1 ms) */ /* Cost for finding the first key in a key scan */ #define DEFAULT_KEY_LOOKUP_COST ((double) 0.000435777) /* Cost of finding a row based on row_ID */ #define DEFAULT_ROW_LOOKUP_COST ((double) 0.000130839) /* Cost of finding and copying key and row blocks from the storage engine index cache to an internal cache as part of an index scan. This includes all mutexes that needs to be taken to get exclusive access to a page. The number is taken from accessing an existing blocks from Aria page cache. Used in handler::scan_time() and handler::keyread_time() */ #define DEFAULT_INDEX_BLOCK_COPY_COST ((double) 3.56e-05) /* Cost of copying a row to 'table->record'. Used by scan_time() and rnd_pos_time() methods. If this is too small, then table scans will be prefered over 'ref' as with table scans there are no key read (KEY_LOOKUP_COST), fewer disk reads but more record copying and row comparisions. If it's too big then MariaDB will used key lookup even when table scan is better. */ #define DEFAULT_ROW_COPY_COST ((double) 0.000060866) /* Cost of copying the key to 'table->record' If this is too small, then, for small tables, index scans will be prefered over 'ref' as with index scans there are fewer disk reads. */ #define DEFAULT_KEY_COPY_COST ((double) 0.000015685) /* Cost of finding the next index entry and checking its rowid against filter This cost is very low as it's done inside the storage engine. Should be smaller than KEY_COPY_COST. */ #define DEFAULT_KEY_NEXT_FIND_COST ((double) 0.000082347) /* Cost of finding the next row when scanning a table */ #define DEFAULT_ROW_NEXT_FIND_COST ((double) 0.000045916) /** The cost of executing the WHERE clause as part of any row check. Increasing this would force the optimizer to use row combinations that reads fewer rows. The default cost comes from recording times from a simple where clause that compares two fields (date and a double) with constants. */ #define DEFAULT_WHERE_COST ((double) 3.2e-05) /* The cost of comparing a key when using range access or sorting */ #define DEFAULT_KEY_COMPARE_COST 0.000011361 /* Rowid compare is usually just a single memcmp of a short string */ #define DEFAULT_ROWID_COMPARE_COST 0.000002653 /* Rowid copy is usually just a single memcpy of a short string */ #define DEFAULT_ROWID_COPY_COST 0.000002653 /* Cost modifiers rowid_filter. These takes into account the overhead of using and calling Rowid_filter_sorted_array::check() from the engine */ #define ROWID_FILTER_PER_CHECK_MODIFIER 4 /* times key_copy_cost */ #define ROWID_FILTER_PER_ELEMENT_MODIFIER 1 /* times rowid_compare_cost */ /* Average disk seek time on a hard disk is 8-10 ms, which is also about the time to read a IO_SIZE (8192) block. A medium ssd is about 400MB/second, which gives us the time for reading an IO_SIZE block to IO_SIZE/400000000 = 0.0000204 sec= 0.02 ms. */ #define DEFAULT_DISK_READ_COST ((double) IO_SIZE / 400000000.0 * 1000) /* The follwoing is an old comment for hard-disks, please ignore the following, except if you like history: For sequential hard disk seeks the cost formula is: DISK_SEEK_BASE_COST + DISK_SEEK_PROP_COST * #blocks_to_skip The cost of average seek DISK_SEEK_BASE_COST + DISK_SEEK_PROP_COST*BLOCKS_IN_AVG_SEEK = 10. */ /* The table/index cache_miss/total_cache_request ratio. 1.0 means that a searched for key or row will never be in the cache while 0.0 means it always in the cache (and we don't have to do any disk reads). According to folklore, one should not have to access disk for more than 20% of the cache request for MariaDB to run very well. However in practice when we read rows or keys in a query, we will often read the same row over and over again. Because of this we set DEFAULT_DISK_READ_RATIO to 0.20/10 = 0.02. Increasing DISK_READ_RATIO will make MariaDB prefer key lookup over table scans as the impact of ROW_COPY_COST and INDEX_COPY cost will have a larger impact when more rows are examined.. We are not yet taking into account cache usage statistics as this could confuse users as the EXPLAIN and costs for a query would change between to query calls, which may confuse users (and also make the mtr tests very unpredictable). Note that the engine's avg_io_cost() (DEFAULT_DISK_READ_COST by default) is multiplied with this constant! */ #define DEFAULT_DISK_READ_RATIO 0.02 /* The following costs are mainly to ensure we don't do table and index scans for small tables, like the one we have in the mtr test suite. This is mostly to keep the mtr tests use indexes (as the optimizer would if the tables are large). It will also ensure that EXPLAIN is showing more key user for users where they are testing queries with small tables at the start of projects. This is probably OK for most a the execution time difference between table scan and index scan compared to key lookups so small when using small tables. It also helps to fill the index cache which will help mitigate the speed difference. */ /* Extra cost for full table and index scan. Used to prefer key and range over index and table scans INDEX_SCAN_SETUP_COST (defined in optimizer_costs.h) is half of table_scan_setup_cost to get the optimizer to prefer index scans to table scans as key copy is faster than row copy and index blocks provides more information in the cache. This will also help MyISAM as with MyISAM the table scans has a cost very close to index scans (they are fast but require a read call that we want to avoid even if it's small). 10 usec is about 10 MyISAM row lookups with optimizer_disk_read_ratio= 0.02 */ #define DEFAULT_TABLE_SCAN_SETUP_COST 0.01 // 10 usec /* Extra cost for doing a range scan. Used to prefer 'ref' over range */ #define MULTI_RANGE_READ_SETUP_COST KEY_LOOKUP_COST /* Temporary file and temporary table related costs Used with subquery materialization, derived tables etc */ #define TMPFILE_CREATE_COST 0.5 // Cost of creating and deleting files #define HEAP_TEMPTABLE_CREATE_COST 0.025 // ms /* Cost taken from HEAP_LOOKUP_COST in ha_heap.cc */ #define HEAP_TEMPTABLE_LOOKUP_COST (0.00016097) #define DISK_TEMPTABLE_LOOKUP_COST(thd) (tmp_table_optimizer_costs.key_lookup_cost + tmp_table_optimizer_costs.row_lookup_cost + tmp_table_optimizer_costs.row_copy_cost) #define DISK_TEMPTABLE_CREATE_COST TMPFILE_CREATE_COST*2 // 2 tmp tables #define DISK_TEMPTABLE_BLOCK_SIZE IO_SIZE #endif /* OPTIMIZER_DEFAULTS_INCLUDED */