3 use InvalidArgumentException
;
4 use Wikimedia\Rdbms\LikeMatch
;
7 * Test the parts of the Database abstract class that deal
8 * with creating SQL text.
10 class DatabaseSQLTest
extends PHPUnit\Framework\TestCase
{
12 use MediaWikiCoversValidator
;
14 /** @var DatabaseTestHelper */
17 protected function setUp() {
19 $this->database
= new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => true ] );
22 protected function assertLastSql( $sqlText ) {
25 $this->database
->getLastSqls()
29 protected function assertLastSqlDb( $sqlText, DatabaseTestHelper
$db ) {
30 $this->assertEquals( $sqlText, $db->getLastSqls() );
34 * @dataProvider provideSelect
35 * @covers Wikimedia\Rdbms\Database::select
36 * @covers Wikimedia\Rdbms\Database::selectSQLText
37 * @covers Wikimedia\Rdbms\Database::tableNamesWithIndexClauseOrJOIN
38 * @covers Wikimedia\Rdbms\Database::useIndexClause
39 * @covers Wikimedia\Rdbms\Database::ignoreIndexClause
40 * @covers Wikimedia\Rdbms\Database::makeSelectOptions
41 * @covers Wikimedia\Rdbms\Database::makeOrderBy
42 * @covers Wikimedia\Rdbms\Database::makeGroupByWithHaving
44 public function testSelect( $sql, $sqlText ) {
45 $this->database
->select(
48 isset( $sql['conds'] ) ?
$sql['conds'] : [],
50 isset( $sql['options'] ) ?
$sql['options'] : [],
51 isset( $sql['join_conds'] ) ?
$sql['join_conds'] : []
53 $this->assertLastSql( $sqlText );
56 public static function provideSelect() {
61 'fields' => [ 'field', 'alias' => 'field2' ],
62 'conds' => [ 'alias' => 'text' ],
64 "SELECT field,field2 AS alias " .
66 "WHERE alias = 'text'"
71 'fields' => [ 'field', 'alias' => 'field2' ],
72 'conds' => 'alias = \'text\'',
74 "SELECT field,field2 AS alias " .
76 "WHERE alias = 'text'"
81 'fields' => [ 'field', 'alias' => 'field2' ],
84 "SELECT field,field2 AS alias " .
90 'fields' => [ 'field', 'alias' => 'field2' ],
93 "SELECT field,field2 AS alias " .
99 'fields' => [ 'field', 'alias' => 'field2' ],
100 'conds' => '0', // T188314
102 "SELECT field,field2 AS alias " .
108 // 'tables' with space prepended indicates pre-escaped table name
109 'tables' => ' table LEFT JOIN table2',
110 'fields' => [ 'field' ],
111 'conds' => [ 'field' => 'text' ],
113 "SELECT field FROM table LEFT JOIN table2 WHERE field = 'text'"
117 // Empty 'tables' is allowed
119 'fields' => [ 'SPECIAL_QUERY()' ],
121 "SELECT SPECIAL_QUERY()"
126 'fields' => [ 'field', 'alias' => 'field2' ],
127 'conds' => [ 'alias' => 'text' ],
128 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
130 "SELECT field,field2 AS alias " .
132 "WHERE alias = 'text' " .
138 'tables' => [ 'table', 't2' => 'table2' ],
139 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
140 'conds' => [ 'alias' => 'text' ],
141 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
142 'join_conds' => [ 't2' => [
143 'LEFT JOIN', 'tid = t2.id'
146 "SELECT tid,field,field2 AS alias,t2.id " .
147 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
148 "WHERE alias = 'text' " .
154 'tables' => [ 'table', 't2' => 'table2' ],
155 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
156 'conds' => [ 'alias' => 'text' ],
157 'options' => [ 'LIMIT' => 1, 'GROUP BY' => 'field', 'HAVING' => 'COUNT(*) > 1' ],
158 'join_conds' => [ 't2' => [
159 'LEFT JOIN', 'tid = t2.id'
162 "SELECT tid,field,field2 AS alias,t2.id " .
163 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
164 "WHERE alias = 'text' " .
165 "GROUP BY field HAVING COUNT(*) > 1 " .
170 'tables' => [ 'table', 't2' => 'table2' ],
171 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
172 'conds' => [ 'alias' => 'text' ],
175 'GROUP BY' => [ 'field', 'field2' ],
176 'HAVING' => [ 'COUNT(*) > 1', 'field' => 1 ]
178 'join_conds' => [ 't2' => [
179 'LEFT JOIN', 'tid = t2.id'
182 "SELECT tid,field,field2 AS alias,t2.id " .
183 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
184 "WHERE alias = 'text' " .
185 "GROUP BY field,field2 HAVING (COUNT(*) > 1) AND field = '1' " .
190 'tables' => [ 'table' ],
191 'fields' => [ 'alias' => 'field' ],
192 'conds' => [ 'alias' => [ 1, 2, 3, 4 ] ],
194 "SELECT field AS alias " .
196 "WHERE alias IN ('1','2','3','4')"
201 'fields' => [ 'field' ],
202 'options' => [ 'USE INDEX' => [ 'table' => 'X' ] ],
205 "SELECT field FROM table"
210 'fields' => [ 'field' ],
211 'options' => [ 'IGNORE INDEX' => [ 'table' => 'X' ] ],
214 "SELECT field FROM table"
219 'fields' => [ 'field' ],
220 'options' => [ 'DISTINCT', 'LOCK IN SHARE MODE' ],
222 "SELECT DISTINCT field FROM table LOCK IN SHARE MODE"
227 'fields' => [ 'field' ],
228 'options' => [ 'EXPLAIN' => true ],
230 'EXPLAIN SELECT field FROM table'
235 'fields' => [ 'field' ],
236 'options' => [ 'FOR UPDATE' ],
238 "SELECT field FROM table FOR UPDATE"
244 * @dataProvider provideUpdate
245 * @covers Wikimedia\Rdbms\Database::update
246 * @covers Wikimedia\Rdbms\Database::makeUpdateOptions
247 * @covers Wikimedia\Rdbms\Database::makeUpdateOptionsArray
249 public function testUpdate( $sql, $sqlText ) {
250 $this->database
->update(
255 isset( $sql['options'] ) ?
$sql['options'] : []
257 $this->assertLastSql( $sqlText );
260 public static function provideUpdate() {
265 'values' => [ 'field' => 'text', 'field2' => 'text2' ],
266 'conds' => [ 'alias' => 'text' ],
269 "SET field = 'text'" .
270 ",field2 = 'text2' " .
271 "WHERE alias = 'text'"
276 'values' => [ 'field = other', 'field2' => 'text2' ],
277 'conds' => [ 'id' => '1' ],
280 "SET field = other" .
281 ",field2 = 'text2' " .
287 'values' => [ 'field = other', 'field2' => 'text2' ],
291 "SET field = other" .
298 * @dataProvider provideDelete
299 * @covers Wikimedia\Rdbms\Database::delete
301 public function testDelete( $sql, $sqlText ) {
302 $this->database
->delete(
307 $this->assertLastSql( $sqlText );
310 public static function provideDelete() {
315 'conds' => [ 'alias' => 'text' ],
317 "DELETE FROM table " .
318 "WHERE alias = 'text'"
331 * @dataProvider provideUpsert
332 * @covers Wikimedia\Rdbms\Database::upsert
334 public function testUpsert( $sql, $sqlText ) {
335 $this->database
->upsert(
338 $sql['uniqueIndexes'],
342 $this->assertLastSql( $sqlText );
345 public static function provideUpsert() {
349 'table' => 'upsert_table',
350 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
351 'uniqueIndexes' => [ 'field' ],
352 'set' => [ 'field' => 'set' ],
355 "UPDATE upsert_table " .
356 "SET field = 'set' " .
357 "WHERE ((field = 'text')); " .
358 "INSERT IGNORE INTO upsert_table " .
360 "VALUES ('text','text2'); " .
367 * @dataProvider provideDeleteJoin
368 * @covers Wikimedia\Rdbms\Database::deleteJoin
370 public function testDeleteJoin( $sql, $sqlText ) {
371 $this->database
->deleteJoin(
379 $this->assertLastSql( $sqlText );
382 public static function provideDeleteJoin() {
386 'delTable' => 'table',
387 'joinTable' => 'table_join',
389 'joinVar' => 'field_join',
390 'conds' => [ 'alias' => 'text' ],
392 "DELETE FROM table " .
394 "SELECT field_join FROM table_join WHERE alias = 'text'" .
399 'delTable' => 'table',
400 'joinTable' => 'table_join',
402 'joinVar' => 'field_join',
405 "DELETE FROM table " .
407 "SELECT field_join FROM table_join " .
414 * @dataProvider provideInsert
415 * @covers Wikimedia\Rdbms\Database::insert
416 * @covers Wikimedia\Rdbms\Database::makeInsertOptions
418 public function testInsert( $sql, $sqlText ) {
419 $this->database
->insert(
423 isset( $sql['options'] ) ?
$sql['options'] : []
425 $this->assertLastSql( $sqlText );
428 public static function provideInsert() {
433 'rows' => [ 'field' => 'text', 'field2' => 2 ],
435 "INSERT INTO table " .
437 "VALUES ('text','2')"
442 'rows' => [ 'field' => 'text', 'field2' => 2 ],
443 'options' => 'IGNORE',
445 "INSERT IGNORE INTO table " .
447 "VALUES ('text','2')"
453 [ 'field' => 'text', 'field2' => 2 ],
454 [ 'field' => 'multi', 'field2' => 3 ],
456 'options' => 'IGNORE',
458 "INSERT IGNORE INTO table " .
468 * @dataProvider provideInsertSelect
469 * @covers Wikimedia\Rdbms\Database::insertSelect
470 * @covers Wikimedia\Rdbms\Database::nativeInsertSelect
472 public function testInsertSelect( $sql, $sqlTextNative, $sqlSelect, $sqlInsert ) {
473 $this->database
->insertSelect(
479 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
480 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
481 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
483 $this->assertLastSql( $sqlTextNative );
485 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
486 $dbWeb->forceNextResult( [
487 array_flip( array_keys( $sql['varMap'] ) )
489 $dbWeb->insertSelect(
495 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
496 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
497 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
499 $this->assertLastSqlDb( implode( '; ', [ $sqlSelect, 'BEGIN', $sqlInsert, 'COMMIT' ] ), $dbWeb );
502 public static function provideInsertSelect() {
506 'destTable' => 'insert_table',
507 'srcTable' => 'select_table',
508 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
511 "INSERT INTO insert_table " .
512 "(field_insert,field) " .
513 "SELECT field_select,field2 " .
514 "FROM select_table WHERE *",
515 "SELECT field_select AS field_insert,field2 AS field " .
516 "FROM select_table WHERE * FOR UPDATE",
517 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
521 'destTable' => 'insert_table',
522 'srcTable' => 'select_table',
523 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
524 'conds' => [ 'field' => 2 ],
526 "INSERT INTO insert_table " .
527 "(field_insert,field) " .
528 "SELECT field_select,field2 " .
529 "FROM select_table " .
531 "SELECT field_select AS field_insert,field2 AS field FROM " .
532 "select_table WHERE field = '2' FOR UPDATE",
533 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
537 'destTable' => 'insert_table',
538 'srcTable' => 'select_table',
539 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
540 'conds' => [ 'field' => 2 ],
541 'insertOptions' => 'IGNORE',
542 'selectOptions' => [ 'ORDER BY' => 'field' ],
544 "INSERT IGNORE INTO insert_table " .
545 "(field_insert,field) " .
546 "SELECT field_select,field2 " .
547 "FROM select_table " .
548 "WHERE field = '2' " .
550 "SELECT field_select AS field_insert,field2 AS field " .
551 "FROM select_table WHERE field = '2' ORDER BY field FOR UPDATE",
552 "INSERT IGNORE INTO insert_table (field_insert,field) VALUES ('0','1')"
556 'destTable' => 'insert_table',
557 'srcTable' => [ 'select_table1', 'select_table2' ],
558 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
559 'conds' => [ 'field' => 2 ],
560 'insertOptions' => [ 'NO_AUTO_COLUMNS' ],
561 'selectOptions' => [ 'ORDER BY' => 'field', 'FORCE INDEX' => [ 'select_table1' => 'index1' ] ],
562 'selectJoinConds' => [
563 'select_table2' => [ 'LEFT JOIN', [ 'select_table1.foo = select_table2.bar' ] ],
566 "INSERT INTO insert_table " .
567 "(field_insert,field) " .
568 "SELECT field_select,field2 " .
569 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
570 "WHERE field = '2' " .
572 "SELECT field_select AS field_insert,field2 AS field " .
573 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
574 "WHERE field = '2' ORDER BY field FOR UPDATE",
575 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
580 public function testInsertSelectBatching() {
581 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
583 for ( $i = 0; $i <= 25000; $i++
) {
584 $rows[] = [ 'field' => $i ];
586 $dbWeb->forceNextResult( $rows );
587 $dbWeb->insertSelect(
590 [ 'field' => 'field2' ],
594 $this->assertLastSqlDb( implode( '; ', [
595 'SELECT field2 AS field FROM select_table WHERE * FOR UPDATE',
597 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 0, 9999 ) ) . "')",
598 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 10000, 19999 ) ) . "')",
599 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 20000, 25000 ) ) . "')",
605 * @dataProvider provideReplace
606 * @covers Wikimedia\Rdbms\Database::replace
608 public function testReplace( $sql, $sqlText ) {
609 $this->database
->replace(
611 $sql['uniqueIndexes'],
615 $this->assertLastSql( $sqlText );
618 public static function provideReplace() {
622 'table' => 'replace_table',
623 'uniqueIndexes' => [ 'field' ],
624 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
626 "BEGIN; DELETE FROM replace_table " .
627 "WHERE (field = 'text'); " .
628 "INSERT INTO replace_table " .
630 "VALUES ('text','text2'); COMMIT"
634 'table' => 'module_deps',
635 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
637 'md_module' => 'module',
642 "BEGIN; DELETE FROM module_deps " .
643 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
644 "INSERT INTO module_deps " .
645 "(md_module,md_skin,md_deps) " .
646 "VALUES ('module','skin','deps'); COMMIT"
650 'table' => 'module_deps',
651 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
654 'md_module' => 'module',
658 'md_module' => 'module2',
659 'md_skin' => 'skin2',
660 'md_deps' => 'deps2',
664 "BEGIN; DELETE FROM module_deps " .
665 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
666 "INSERT INTO module_deps " .
667 "(md_module,md_skin,md_deps) " .
668 "VALUES ('module','skin','deps'); " .
669 "DELETE FROM module_deps " .
670 "WHERE (md_module = 'module2' AND md_skin = 'skin2'); " .
671 "INSERT INTO module_deps " .
672 "(md_module,md_skin,md_deps) " .
673 "VALUES ('module2','skin2','deps2'); COMMIT"
677 'table' => 'module_deps',
678 'uniqueIndexes' => [ 'md_module', 'md_skin' ],
681 'md_module' => 'module',
685 'md_module' => 'module2',
686 'md_skin' => 'skin2',
687 'md_deps' => 'deps2',
691 "BEGIN; DELETE FROM module_deps " .
692 "WHERE (md_module = 'module') OR (md_skin = 'skin'); " .
693 "INSERT INTO module_deps " .
694 "(md_module,md_skin,md_deps) " .
695 "VALUES ('module','skin','deps'); " .
696 "DELETE FROM module_deps " .
697 "WHERE (md_module = 'module2') OR (md_skin = 'skin2'); " .
698 "INSERT INTO module_deps " .
699 "(md_module,md_skin,md_deps) " .
700 "VALUES ('module2','skin2','deps2'); COMMIT"
704 'table' => 'module_deps',
705 'uniqueIndexes' => [],
707 'md_module' => 'module',
712 "BEGIN; INSERT INTO module_deps " .
713 "(md_module,md_skin,md_deps) " .
714 "VALUES ('module','skin','deps'); COMMIT"
720 * @dataProvider provideNativeReplace
721 * @covers Wikimedia\Rdbms\Database::nativeReplace
723 public function testNativeReplace( $sql, $sqlText ) {
724 $this->database
->nativeReplace(
729 $this->assertLastSql( $sqlText );
732 public static function provideNativeReplace() {
736 'table' => 'replace_table',
737 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
739 "REPLACE INTO replace_table " .
741 "VALUES ('text','text2')"
747 * @dataProvider provideConditional
748 * @covers Wikimedia\Rdbms\Database::conditional
750 public function testConditional( $sql, $sqlText ) {
751 $this->assertEquals( trim( $this->database
->conditional(
758 public static function provideConditional() {
762 'conds' => [ 'field' => 'text' ],
766 "(CASE WHEN field = 'text' THEN 1 ELSE NULL END)"
770 'conds' => [ 'field' => 'text', 'field2' => 'anothertext' ],
774 "(CASE WHEN field = 'text' AND field2 = 'anothertext' THEN 1 ELSE NULL END)"
778 'conds' => 'field=1',
782 "(CASE WHEN field=1 THEN 1 ELSE NULL END)"
788 * @dataProvider provideBuildConcat
789 * @covers Wikimedia\Rdbms\Database::buildConcat
791 public function testBuildConcat( $stringList, $sqlText ) {
792 $this->assertEquals( trim( $this->database
->buildConcat(
797 public static function provideBuildConcat() {
800 [ 'field', 'field2' ],
801 "CONCAT(field,field2)"
804 [ "'test'", 'field2' ],
805 "CONCAT('test',field2)"
811 * @dataProvider provideBuildLike
812 * @covers Wikimedia\Rdbms\Database::buildLike
813 * @covers Wikimedia\Rdbms\Database::escapeLikeInternal
815 public function testBuildLike( $array, $sqlText ) {
816 $this->assertEquals( trim( $this->database
->buildLike(
821 public static function provideBuildLike() {
825 "LIKE 'text' ESCAPE '`'"
828 [ 'text', new LikeMatch( '%' ) ],
829 "LIKE 'text%' ESCAPE '`'"
832 [ 'text', new LikeMatch( '%' ), 'text2' ],
833 "LIKE 'text%text2' ESCAPE '`'"
836 [ 'text', new LikeMatch( '_' ) ],
837 "LIKE 'text_' ESCAPE '`'"
841 "LIKE 'more`_text' ESCAPE '`'"
844 [ 'C:\\Windows\\', new LikeMatch( '%' ) ],
845 "LIKE 'C:\\Windows\\%' ESCAPE '`'"
848 [ 'accent`_test`', new LikeMatch( '%' ) ],
849 "LIKE 'accent```_test``%' ESCAPE '`'"
855 * @dataProvider provideUnionQueries
856 * @covers Wikimedia\Rdbms\Database::unionQueries
858 public function testUnionQueries( $sql, $sqlText ) {
859 $this->assertEquals( trim( $this->database
->unionQueries(
865 public static function provideUnionQueries() {
869 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
872 "(RAW SQL) UNION ALL (RAW2SQL)"
876 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
879 "(RAW SQL) UNION (RAW2SQL)"
883 'sqls' => [ 'RAW SQL', 'RAW2SQL', 'RAW3SQL' ],
886 "(RAW SQL) UNION (RAW2SQL) UNION (RAW3SQL)"
892 * @dataProvider provideUnionConditionPermutations
893 * @covers Wikimedia\Rdbms\Database::unionConditionPermutations
895 public function testUnionConditionPermutations( $params, $expect ) {
896 if ( isset( $params['unionSupportsOrderAndLimit'] ) ) {
897 $this->database
->setUnionSupportsOrderAndLimit( $params['unionSupportsOrderAndLimit'] );
900 $sql = trim( $this->database
->unionConditionPermutations(
903 $params['permute_conds'],
904 isset( $params['extra_conds'] ) ?
$params['extra_conds'] : '',
906 isset( $params['options'] ) ?
$params['options'] : [],
907 isset( $params['join_conds'] ) ?
$params['join_conds'] : []
909 $this->assertEquals( $expect, $sql );
912 public static function provideUnionConditionPermutations() {
913 // phpcs:disable Generic.Files.LineLength
917 'table' => [ 'table1', 'table2' ],
918 'vars' => [ 'field1', 'alias' => 'field2' ],
920 'field3' => [ 1, 2, 3 ],
921 'duplicates' => [ 4, 5, 4 ],
925 'extra_conds' => 'table2.bar > 23',
927 'ORDER BY' => [ 'field1', 'alias' ],
928 'INNER ORDER BY' => [ 'field1', 'field2' ],
932 'table2' => [ 'JOIN', 'table1.foo_id = table2.foo_id' ],
935 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '1' AND duplicates = '4' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) UNION ALL " .
936 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '1' AND duplicates = '5' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) UNION ALL " .
937 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '2' AND duplicates = '4' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) UNION ALL " .
938 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '2' AND duplicates = '5' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) UNION ALL " .
939 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '3' AND duplicates = '4' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) UNION ALL " .
940 "(SELECT field1,field2 AS alias FROM table1 JOIN table2 ON ((table1.foo_id = table2.foo_id)) WHERE field3 = '3' AND duplicates = '5' AND single = '0' AND (table2.bar > 23) ORDER BY field1,field2 LIMIT 100 ) " .
941 "ORDER BY field1,alias LIMIT 100"
946 'vars' => [ 'foo_id' ],
948 'bar' => [ 1, 2, 3 ],
950 'extra_conds' => [ 'baz' => null ],
953 'ORDER BY' => [ 'foo_id' ],
957 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
958 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
959 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) " .
960 "ORDER BY foo_id LIMIT 25"
965 'vars' => [ 'foo_id' ],
967 'bar' => [ 1, 2, 3 ],
969 'extra_conds' => [ 'baz' => null ],
972 'ORDER BY' => [ 'foo_id' ],
975 'unionSupportsOrderAndLimit' => false,
977 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ) UNION " .
978 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ) UNION " .
979 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ) " .
980 "ORDER BY foo_id LIMIT 25"
985 'vars' => [ 'foo_id' ],
986 'permute_conds' => [],
987 'extra_conds' => [ 'baz' => null ],
989 'ORDER BY' => [ 'foo_id' ],
993 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
998 'vars' => [ 'foo_id' ],
1002 'extra_conds' => [ 'baz' => null ],
1004 'ORDER BY' => [ 'foo_id' ],
1008 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
1013 'vars' => [ 'foo_id' ],
1014 'permute_conds' => [
1018 'ORDER BY' => [ 'foo_id' ],
1023 "SELECT foo_id FROM foo WHERE bar = '1' ORDER BY foo_id LIMIT 150,25"
1028 'vars' => [ 'foo_id' ],
1029 'permute_conds' => [],
1030 'extra_conds' => [ 'baz' => null ],
1032 'ORDER BY' => [ 'foo_id' ],
1035 'INNER ORDER BY' => [ 'bar_id' ],
1038 "(SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY bar_id LIMIT 175 ) ORDER BY foo_id LIMIT 150,25"
1043 'vars' => [ 'foo_id' ],
1044 'permute_conds' => [],
1045 'extra_conds' => [ 'baz' => null ],
1047 'ORDER BY' => [ 'foo_id' ],
1050 'INNER ORDER BY' => [ 'bar_id' ],
1052 'unionSupportsOrderAndLimit' => false,
1054 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 150,25"
1061 * @covers Wikimedia\Rdbms\Database::commit
1062 * @covers Wikimedia\Rdbms\Database::doCommit
1064 public function testTransactionCommit() {
1065 $this->database
->begin( __METHOD__
);
1066 $this->database
->commit( __METHOD__
);
1067 $this->assertLastSql( 'BEGIN; COMMIT' );
1071 * @covers Wikimedia\Rdbms\Database::rollback
1072 * @covers Wikimedia\Rdbms\Database::doRollback
1074 public function testTransactionRollback() {
1075 $this->database
->begin( __METHOD__
);
1076 $this->database
->rollback( __METHOD__
);
1077 $this->assertLastSql( 'BEGIN; ROLLBACK' );
1081 * @covers Wikimedia\Rdbms\Database::dropTable
1083 public function testDropTable() {
1084 $this->database
->setExistingTables( [ 'table' ] );
1085 $this->database
->dropTable( 'table', __METHOD__
);
1086 $this->assertLastSql( 'DROP TABLE table CASCADE' );
1090 * @covers Wikimedia\Rdbms\Database::dropTable
1092 public function testDropNonExistingTable() {
1094 $this->database
->dropTable( 'non_existing', __METHOD__
)
1099 * @dataProvider provideMakeList
1100 * @covers Wikimedia\Rdbms\Database::makeList
1102 public function testMakeList( $list, $mode, $sqlText ) {
1103 $this->assertEquals( trim( $this->database
->makeList(
1108 public static function provideMakeList() {
1111 [ 'value', 'value2' ],
1116 [ 'field', 'field2' ],
1121 [ 'field' => 'value', 'field2' => 'value2' ],
1123 "field = 'value' AND field2 = 'value2'"
1126 [ 'field' => null, "field2 != 'value2'" ],
1128 "field IS NULL AND (field2 != 'value2')"
1131 [ 'field' => [ 'value', null, 'value2' ], 'field2' => 'value2' ],
1133 "(field IN ('value','value2') OR field IS NULL) AND field2 = 'value2'"
1136 [ 'field' => [ null ], 'field2' => null ],
1138 "field IS NULL AND field2 IS NULL"
1141 [ 'field' => 'value', 'field2' => 'value2' ],
1143 "field = 'value' OR field2 = 'value2'"
1146 [ 'field' => 'value', 'field2' => null ],
1148 "field = 'value' OR field2 IS NULL"
1151 [ 'field' => [ 'value', 'value2' ], 'field2' => [ 'value' ] ],
1153 "field IN ('value','value2') OR field2 = 'value'"
1156 [ 'field' => [ null, 'value', null, 'value2' ], "field2 != 'value2'" ],
1158 "(field IN ('value','value2') OR field IS NULL) OR (field2 != 'value2')"
1161 [ 'field' => 'value', 'field2' => 'value2' ],
1163 "field = 'value',field2 = 'value2'"
1166 [ 'field' => 'value', 'field2' => null ],
1168 "field = 'value',field2 = NULL"
1171 [ 'field' => 'value', "field2 != 'value2'" ],
1173 "field = 'value',field2 != 'value2'"
1179 * @covers Wikimedia\Rdbms\Database::registerTempTableOperation
1181 public function testSessionTempTables() {
1182 $temp1 = $this->database
->tableName( 'tmp_table_1' );
1183 $temp2 = $this->database
->tableName( 'tmp_table_2' );
1184 $temp3 = $this->database
->tableName( 'tmp_table_3' );
1186 $this->database
->query( "CREATE TEMPORARY TABLE $temp1 LIKE orig_tbl", __METHOD__
);
1187 $this->database
->query( "CREATE TEMPORARY TABLE $temp2 LIKE orig_tbl", __METHOD__
);
1188 $this->database
->query( "CREATE TEMPORARY TABLE $temp3 LIKE orig_tbl", __METHOD__
);
1190 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1191 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1192 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1194 $this->database
->dropTable( 'tmp_table_1', __METHOD__
);
1195 $this->database
->dropTable( 'tmp_table_2', __METHOD__
);
1196 $this->database
->dropTable( 'tmp_table_3', __METHOD__
);
1198 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1199 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1200 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1202 $this->database
->query( "CREATE TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1203 $this->database
->query( "CREATE TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1204 $this->database
->query( "CREATE TEMPORARY TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1206 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1207 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1208 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1210 $this->database
->query( "DROP TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1211 $this->database
->query( "DROP TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1212 $this->database
->query( "DROP TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1214 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1215 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1216 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1219 public function provideBuildSubstring() {
1220 yield
[ 'someField', 1, 2, 'SUBSTRING(someField FROM 1 FOR 2)' ];
1221 yield
[ 'someField', 1, null, 'SUBSTRING(someField FROM 1)' ];
1225 * @covers Wikimedia\Rdbms\Database::buildSubstring
1226 * @dataProvider provideBuildSubstring
1228 public function testBuildSubstring( $input, $start, $length, $expected ) {
1229 $output = $this->database
->buildSubstring( $input, $start, $length );
1230 $this->assertSame( $expected, $output );
1233 public function provideBuildSubstring_invalidParams() {
1243 * @covers Wikimedia\Rdbms\Database::buildSubstring
1244 * @covers Wikimedia\Rdbms\Database::assertBuildSubstringParams
1245 * @dataProvider provideBuildSubstring_invalidParams
1247 public function testBuildSubstring_invalidParams( $start, $length ) {
1248 $this->setExpectedException( InvalidArgumentException
::class );
1249 $this->database
->buildSubstring( 'foo', $start, $length );
1253 * @covers \Wikimedia\Rdbms\Database::buildIntegerCast
1255 public function testBuildIntegerCast() {
1256 $output = $this->database
->buildIntegerCast( 'fieldName' );
1257 $this->assertSame( 'CAST( fieldName AS INTEGER )', $output );