mariadb/sql/optimizer_defaults.h

#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 */