3 use Wikimedia\Rdbms\LikeMatch
;
6 * Test the parts of the Database abstract class that deal
7 * with creating SQL text.
9 class DatabaseSQLTest
extends PHPUnit\Framework\TestCase
{
11 use MediaWikiCoversValidator
;
13 /** @var DatabaseTestHelper */
16 protected function setUp() {
18 $this->database
= new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => true ] );
21 protected function assertLastSql( $sqlText ) {
24 $this->database
->getLastSqls()
28 protected function assertLastSqlDb( $sqlText, DatabaseTestHelper
$db ) {
29 $this->assertEquals( $sqlText, $db->getLastSqls() );
33 * @dataProvider provideSelect
34 * @covers Wikimedia\Rdbms\Database::select
35 * @covers Wikimedia\Rdbms\Database::selectSQLText
36 * @covers Wikimedia\Rdbms\Database::tableNamesWithIndexClauseOrJOIN
37 * @covers Wikimedia\Rdbms\Database::useIndexClause
38 * @covers Wikimedia\Rdbms\Database::ignoreIndexClause
39 * @covers Wikimedia\Rdbms\Database::makeSelectOptions
40 * @covers Wikimedia\Rdbms\Database::makeOrderBy
41 * @covers Wikimedia\Rdbms\Database::makeGroupByWithHaving
43 public function testSelect( $sql, $sqlText ) {
44 $this->database
->select(
47 isset( $sql['conds'] ) ?
$sql['conds'] : [],
49 isset( $sql['options'] ) ?
$sql['options'] : [],
50 isset( $sql['join_conds'] ) ?
$sql['join_conds'] : []
52 $this->assertLastSql( $sqlText );
55 public static function provideSelect() {
60 'fields' => [ 'field', 'alias' => 'field2' ],
61 'conds' => [ 'alias' => 'text' ],
63 "SELECT field,field2 AS alias " .
65 "WHERE alias = 'text'"
69 // 'tables' with space prepended indicates pre-escaped table name
70 'tables' => ' table LEFT JOIN table2',
71 'fields' => [ 'field' ],
72 'conds' => [ 'field' => 'text' ],
74 "SELECT field FROM table LEFT JOIN table2 WHERE field = 'text'"
78 // Empty 'tables' is allowed
80 'fields' => [ 'SPECIAL_QUERY()' ],
82 "SELECT SPECIAL_QUERY()"
87 'fields' => [ 'field', 'alias' => 'field2' ],
88 'conds' => [ 'alias' => 'text' ],
89 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
91 "SELECT field,field2 AS alias " .
93 "WHERE alias = 'text' " .
99 'tables' => [ 'table', 't2' => 'table2' ],
100 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
101 'conds' => [ 'alias' => 'text' ],
102 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
103 'join_conds' => [ 't2' => [
104 'LEFT JOIN', 'tid = t2.id'
107 "SELECT tid,field,field2 AS alias,t2.id " .
108 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
109 "WHERE alias = 'text' " .
115 'tables' => [ 'table', 't2' => 'table2' ],
116 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
117 'conds' => [ 'alias' => 'text' ],
118 'options' => [ 'LIMIT' => 1, 'GROUP BY' => 'field', 'HAVING' => 'COUNT(*) > 1' ],
119 'join_conds' => [ 't2' => [
120 'LEFT JOIN', 'tid = t2.id'
123 "SELECT tid,field,field2 AS alias,t2.id " .
124 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
125 "WHERE alias = 'text' " .
126 "GROUP BY field HAVING COUNT(*) > 1 " .
131 'tables' => [ 'table', 't2' => 'table2' ],
132 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
133 'conds' => [ 'alias' => 'text' ],
136 'GROUP BY' => [ 'field', 'field2' ],
137 'HAVING' => [ 'COUNT(*) > 1', 'field' => 1 ]
139 'join_conds' => [ 't2' => [
140 'LEFT JOIN', 'tid = t2.id'
143 "SELECT tid,field,field2 AS alias,t2.id " .
144 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
145 "WHERE alias = 'text' " .
146 "GROUP BY field,field2 HAVING (COUNT(*) > 1) AND field = '1' " .
151 'tables' => [ 'table' ],
152 'fields' => [ 'alias' => 'field' ],
153 'conds' => [ 'alias' => [ 1, 2, 3, 4 ] ],
155 "SELECT field AS alias " .
157 "WHERE alias IN ('1','2','3','4')"
162 'fields' => [ 'field' ],
163 'options' => [ 'USE INDEX' => [ 'table' => 'X' ] ],
166 "SELECT field FROM table"
171 'fields' => [ 'field' ],
172 'options' => [ 'IGNORE INDEX' => [ 'table' => 'X' ] ],
175 "SELECT field FROM table"
180 'fields' => [ 'field' ],
181 'options' => [ 'DISTINCT', 'LOCK IN SHARE MODE' ],
183 "SELECT DISTINCT field FROM table LOCK IN SHARE MODE"
188 'fields' => [ 'field' ],
189 'options' => [ 'EXPLAIN' => true ],
191 'EXPLAIN SELECT field FROM table'
196 'fields' => [ 'field' ],
197 'options' => [ 'FOR UPDATE' ],
199 "SELECT field FROM table FOR UPDATE"
205 * @dataProvider provideUpdate
206 * @covers Wikimedia\Rdbms\Database::update
207 * @covers Wikimedia\Rdbms\Database::makeUpdateOptions
208 * @covers Wikimedia\Rdbms\Database::makeUpdateOptionsArray
210 public function testUpdate( $sql, $sqlText ) {
211 $this->database
->update(
216 isset( $sql['options'] ) ?
$sql['options'] : []
218 $this->assertLastSql( $sqlText );
221 public static function provideUpdate() {
226 'values' => [ 'field' => 'text', 'field2' => 'text2' ],
227 'conds' => [ 'alias' => 'text' ],
230 "SET field = 'text'" .
231 ",field2 = 'text2' " .
232 "WHERE alias = 'text'"
237 'values' => [ 'field = other', 'field2' => 'text2' ],
238 'conds' => [ 'id' => '1' ],
241 "SET field = other" .
242 ",field2 = 'text2' " .
248 'values' => [ 'field = other', 'field2' => 'text2' ],
252 "SET field = other" .
259 * @dataProvider provideDelete
260 * @covers Wikimedia\Rdbms\Database::delete
262 public function testDelete( $sql, $sqlText ) {
263 $this->database
->delete(
268 $this->assertLastSql( $sqlText );
271 public static function provideDelete() {
276 'conds' => [ 'alias' => 'text' ],
278 "DELETE FROM table " .
279 "WHERE alias = 'text'"
292 * @dataProvider provideUpsert
293 * @covers Wikimedia\Rdbms\Database::upsert
295 public function testUpsert( $sql, $sqlText ) {
296 $this->database
->upsert(
299 $sql['uniqueIndexes'],
303 $this->assertLastSql( $sqlText );
306 public static function provideUpsert() {
310 'table' => 'upsert_table',
311 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
312 'uniqueIndexes' => [ 'field' ],
313 'set' => [ 'field' => 'set' ],
316 "UPDATE upsert_table " .
317 "SET field = 'set' " .
318 "WHERE ((field = 'text')); " .
319 "INSERT IGNORE INTO upsert_table " .
321 "VALUES ('text','text2'); " .
328 * @dataProvider provideDeleteJoin
329 * @covers Wikimedia\Rdbms\Database::deleteJoin
331 public function testDeleteJoin( $sql, $sqlText ) {
332 $this->database
->deleteJoin(
340 $this->assertLastSql( $sqlText );
343 public static function provideDeleteJoin() {
347 'delTable' => 'table',
348 'joinTable' => 'table_join',
350 'joinVar' => 'field_join',
351 'conds' => [ 'alias' => 'text' ],
353 "DELETE FROM table " .
355 "SELECT field_join FROM table_join WHERE alias = 'text'" .
360 'delTable' => 'table',
361 'joinTable' => 'table_join',
363 'joinVar' => 'field_join',
366 "DELETE FROM table " .
368 "SELECT field_join FROM table_join " .
375 * @dataProvider provideInsert
376 * @covers Wikimedia\Rdbms\Database::insert
377 * @covers Wikimedia\Rdbms\Database::makeInsertOptions
379 public function testInsert( $sql, $sqlText ) {
380 $this->database
->insert(
384 isset( $sql['options'] ) ?
$sql['options'] : []
386 $this->assertLastSql( $sqlText );
389 public static function provideInsert() {
394 'rows' => [ 'field' => 'text', 'field2' => 2 ],
396 "INSERT INTO table " .
398 "VALUES ('text','2')"
403 'rows' => [ 'field' => 'text', 'field2' => 2 ],
404 'options' => 'IGNORE',
406 "INSERT IGNORE INTO table " .
408 "VALUES ('text','2')"
414 [ 'field' => 'text', 'field2' => 2 ],
415 [ 'field' => 'multi', 'field2' => 3 ],
417 'options' => 'IGNORE',
419 "INSERT IGNORE INTO table " .
429 * @dataProvider provideInsertSelect
430 * @covers Wikimedia\Rdbms\Database::insertSelect
431 * @covers Wikimedia\Rdbms\Database::nativeInsertSelect
433 public function testInsertSelect( $sql, $sqlTextNative, $sqlSelect, $sqlInsert ) {
434 $this->database
->insertSelect(
440 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
441 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
442 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
444 $this->assertLastSql( $sqlTextNative );
446 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
447 $dbWeb->forceNextResult( [
448 array_flip( array_keys( $sql['varMap'] ) )
450 $dbWeb->insertSelect(
456 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
457 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
458 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
460 $this->assertLastSqlDb( implode( '; ', [ $sqlSelect, 'BEGIN', $sqlInsert, 'COMMIT' ] ), $dbWeb );
463 public static function provideInsertSelect() {
467 'destTable' => 'insert_table',
468 'srcTable' => 'select_table',
469 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
472 "INSERT INTO insert_table " .
473 "(field_insert,field) " .
474 "SELECT field_select,field2 " .
475 "FROM select_table WHERE *",
476 "SELECT field_select AS field_insert,field2 AS field " .
477 "FROM select_table WHERE * FOR UPDATE",
478 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
482 'destTable' => 'insert_table',
483 'srcTable' => 'select_table',
484 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
485 'conds' => [ 'field' => 2 ],
487 "INSERT INTO insert_table " .
488 "(field_insert,field) " .
489 "SELECT field_select,field2 " .
490 "FROM select_table " .
492 "SELECT field_select AS field_insert,field2 AS field FROM " .
493 "select_table WHERE field = '2' FOR UPDATE",
494 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
498 'destTable' => 'insert_table',
499 'srcTable' => 'select_table',
500 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
501 'conds' => [ 'field' => 2 ],
502 'insertOptions' => 'IGNORE',
503 'selectOptions' => [ 'ORDER BY' => 'field' ],
505 "INSERT IGNORE INTO insert_table " .
506 "(field_insert,field) " .
507 "SELECT field_select,field2 " .
508 "FROM select_table " .
509 "WHERE field = '2' " .
511 "SELECT field_select AS field_insert,field2 AS field " .
512 "FROM select_table WHERE field = '2' ORDER BY field FOR UPDATE",
513 "INSERT IGNORE INTO insert_table (field_insert,field) VALUES ('0','1')"
517 'destTable' => 'insert_table',
518 'srcTable' => [ 'select_table1', 'select_table2' ],
519 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
520 'conds' => [ 'field' => 2 ],
521 'insertOptions' => [ 'NO_AUTO_COLUMNS' ],
522 'selectOptions' => [ 'ORDER BY' => 'field', 'FORCE INDEX' => [ 'select_table1' => 'index1' ] ],
523 'selectJoinConds' => [
524 'select_table2' => [ 'LEFT JOIN', [ 'select_table1.foo = select_table2.bar' ] ],
527 "INSERT INTO insert_table " .
528 "(field_insert,field) " .
529 "SELECT field_select,field2 " .
530 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
531 "WHERE field = '2' " .
533 "SELECT field_select AS field_insert,field2 AS field " .
534 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
535 "WHERE field = '2' ORDER BY field FOR UPDATE",
536 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
541 public function testInsertSelectBatching() {
542 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
544 for ( $i = 0; $i <= 25000; $i++
) {
545 $rows[] = [ 'field' => $i ];
547 $dbWeb->forceNextResult( $rows );
548 $dbWeb->insertSelect(
551 [ 'field' => 'field2' ],
555 $this->assertLastSqlDb( implode( '; ', [
556 'SELECT field2 AS field FROM select_table WHERE * FOR UPDATE',
558 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 0, 9999 ) ) . "')",
559 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 10000, 19999 ) ) . "')",
560 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 20000, 25000 ) ) . "')",
566 * @dataProvider provideReplace
567 * @covers Wikimedia\Rdbms\Database::replace
569 public function testReplace( $sql, $sqlText ) {
570 $this->database
->replace(
572 $sql['uniqueIndexes'],
576 $this->assertLastSql( $sqlText );
579 public static function provideReplace() {
583 'table' => 'replace_table',
584 'uniqueIndexes' => [ 'field' ],
585 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
587 "BEGIN; DELETE FROM replace_table " .
588 "WHERE (field = 'text'); " .
589 "INSERT INTO replace_table " .
591 "VALUES ('text','text2'); COMMIT"
595 'table' => 'module_deps',
596 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
598 'md_module' => 'module',
603 "BEGIN; DELETE FROM module_deps " .
604 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
605 "INSERT INTO module_deps " .
606 "(md_module,md_skin,md_deps) " .
607 "VALUES ('module','skin','deps'); COMMIT"
611 'table' => 'module_deps',
612 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
615 'md_module' => 'module',
619 'md_module' => 'module2',
620 'md_skin' => 'skin2',
621 'md_deps' => 'deps2',
625 "BEGIN; DELETE FROM module_deps " .
626 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
627 "INSERT INTO module_deps " .
628 "(md_module,md_skin,md_deps) " .
629 "VALUES ('module','skin','deps'); " .
630 "DELETE FROM module_deps " .
631 "WHERE (md_module = 'module2' AND md_skin = 'skin2'); " .
632 "INSERT INTO module_deps " .
633 "(md_module,md_skin,md_deps) " .
634 "VALUES ('module2','skin2','deps2'); COMMIT"
638 'table' => 'module_deps',
639 'uniqueIndexes' => [ 'md_module', 'md_skin' ],
642 'md_module' => 'module',
646 'md_module' => 'module2',
647 'md_skin' => 'skin2',
648 'md_deps' => 'deps2',
652 "BEGIN; DELETE FROM module_deps " .
653 "WHERE (md_module = 'module') OR (md_skin = 'skin'); " .
654 "INSERT INTO module_deps " .
655 "(md_module,md_skin,md_deps) " .
656 "VALUES ('module','skin','deps'); " .
657 "DELETE FROM module_deps " .
658 "WHERE (md_module = 'module2') OR (md_skin = 'skin2'); " .
659 "INSERT INTO module_deps " .
660 "(md_module,md_skin,md_deps) " .
661 "VALUES ('module2','skin2','deps2'); COMMIT"
665 'table' => 'module_deps',
666 'uniqueIndexes' => [],
668 'md_module' => 'module',
673 "BEGIN; INSERT INTO module_deps " .
674 "(md_module,md_skin,md_deps) " .
675 "VALUES ('module','skin','deps'); COMMIT"
681 * @dataProvider provideNativeReplace
682 * @covers Wikimedia\Rdbms\Database::nativeReplace
684 public function testNativeReplace( $sql, $sqlText ) {
685 $this->database
->nativeReplace(
690 $this->assertLastSql( $sqlText );
693 public static function provideNativeReplace() {
697 'table' => 'replace_table',
698 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
700 "REPLACE INTO replace_table " .
702 "VALUES ('text','text2')"
708 * @dataProvider provideConditional
709 * @covers Wikimedia\Rdbms\Database::conditional
711 public function testConditional( $sql, $sqlText ) {
712 $this->assertEquals( trim( $this->database
->conditional(
719 public static function provideConditional() {
723 'conds' => [ 'field' => 'text' ],
727 "(CASE WHEN field = 'text' THEN 1 ELSE NULL END)"
731 'conds' => [ 'field' => 'text', 'field2' => 'anothertext' ],
735 "(CASE WHEN field = 'text' AND field2 = 'anothertext' THEN 1 ELSE NULL END)"
739 'conds' => 'field=1',
743 "(CASE WHEN field=1 THEN 1 ELSE NULL END)"
749 * @dataProvider provideBuildConcat
750 * @covers Wikimedia\Rdbms\Database::buildConcat
752 public function testBuildConcat( $stringList, $sqlText ) {
753 $this->assertEquals( trim( $this->database
->buildConcat(
758 public static function provideBuildConcat() {
761 [ 'field', 'field2' ],
762 "CONCAT(field,field2)"
765 [ "'test'", 'field2' ],
766 "CONCAT('test',field2)"
772 * @dataProvider provideBuildLike
773 * @covers Wikimedia\Rdbms\Database::buildLike
774 * @covers Wikimedia\Rdbms\Database::escapeLikeInternal
776 public function testBuildLike( $array, $sqlText ) {
777 $this->assertEquals( trim( $this->database
->buildLike(
782 public static function provideBuildLike() {
786 "LIKE 'text' ESCAPE '`'"
789 [ 'text', new LikeMatch( '%' ) ],
790 "LIKE 'text%' ESCAPE '`'"
793 [ 'text', new LikeMatch( '%' ), 'text2' ],
794 "LIKE 'text%text2' ESCAPE '`'"
797 [ 'text', new LikeMatch( '_' ) ],
798 "LIKE 'text_' ESCAPE '`'"
802 "LIKE 'more`_text' ESCAPE '`'"
805 [ 'C:\\Windows\\', new LikeMatch( '%' ) ],
806 "LIKE 'C:\\Windows\\%' ESCAPE '`'"
809 [ 'accent`_test`', new LikeMatch( '%' ) ],
810 "LIKE 'accent```_test``%' ESCAPE '`'"
816 * @dataProvider provideUnionQueries
817 * @covers Wikimedia\Rdbms\Database::unionQueries
819 public function testUnionQueries( $sql, $sqlText ) {
820 $this->assertEquals( trim( $this->database
->unionQueries(
826 public static function provideUnionQueries() {
830 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
833 "(RAW SQL) UNION ALL (RAW2SQL)"
837 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
840 "(RAW SQL) UNION (RAW2SQL)"
844 'sqls' => [ 'RAW SQL', 'RAW2SQL', 'RAW3SQL' ],
847 "(RAW SQL) UNION (RAW2SQL) UNION (RAW3SQL)"
853 * @dataProvider provideUnionConditionPermutations
854 * @covers Wikimedia\Rdbms\Database::unionConditionPermutations
856 public function testUnionConditionPermutations( $params, $expect ) {
857 if ( isset( $params['unionSupportsOrderAndLimit'] ) ) {
858 $this->database
->setUnionSupportsOrderAndLimit( $params['unionSupportsOrderAndLimit'] );
861 $sql = trim( $this->database
->unionConditionPermutations(
864 $params['permute_conds'],
865 isset( $params['extra_conds'] ) ?
$params['extra_conds'] : '',
867 isset( $params['options'] ) ?
$params['options'] : [],
868 isset( $params['join_conds'] ) ?
$params['join_conds'] : []
870 $this->assertEquals( $expect, $sql );
873 public static function provideUnionConditionPermutations() {
874 // phpcs:disable Generic.Files.LineLength
878 'table' => [ 'table1', 'table2' ],
879 'vars' => [ 'field1', 'alias' => 'field2' ],
881 'field3' => [ 1, 2, 3 ],
882 'duplicates' => [ 4, 5, 4 ],
886 'extra_conds' => 'table2.bar > 23',
888 'ORDER BY' => [ 'field1', 'alias' ],
889 'INNER ORDER BY' => [ 'field1', 'field2' ],
893 'table2' => [ 'JOIN', 'table1.foo_id = table2.foo_id' ],
896 "(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 " .
897 "(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 " .
898 "(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 " .
899 "(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 " .
900 "(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 " .
901 "(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 ) " .
902 "ORDER BY field1,alias LIMIT 100"
907 'vars' => [ 'foo_id' ],
909 'bar' => [ 1, 2, 3 ],
911 'extra_conds' => [ 'baz' => null ],
914 'ORDER BY' => [ 'foo_id' ],
918 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
919 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
920 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) " .
921 "ORDER BY foo_id LIMIT 25"
926 'vars' => [ 'foo_id' ],
928 'bar' => [ 1, 2, 3 ],
930 'extra_conds' => [ 'baz' => null ],
933 'ORDER BY' => [ 'foo_id' ],
936 'unionSupportsOrderAndLimit' => false,
938 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ) UNION " .
939 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ) UNION " .
940 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ) " .
941 "ORDER BY foo_id LIMIT 25"
946 'vars' => [ 'foo_id' ],
947 'permute_conds' => [],
948 'extra_conds' => [ 'baz' => null ],
950 'ORDER BY' => [ 'foo_id' ],
954 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
959 'vars' => [ 'foo_id' ],
963 'extra_conds' => [ 'baz' => null ],
965 'ORDER BY' => [ 'foo_id' ],
969 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
974 'vars' => [ 'foo_id' ],
979 'ORDER BY' => [ 'foo_id' ],
984 "SELECT foo_id FROM foo WHERE bar = '1' ORDER BY foo_id LIMIT 150,25"
989 'vars' => [ 'foo_id' ],
990 'permute_conds' => [],
991 'extra_conds' => [ 'baz' => null ],
993 'ORDER BY' => [ 'foo_id' ],
996 'INNER ORDER BY' => [ 'bar_id' ],
999 "(SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY bar_id LIMIT 175 ) ORDER BY foo_id LIMIT 150,25"
1004 'vars' => [ 'foo_id' ],
1005 'permute_conds' => [],
1006 'extra_conds' => [ 'baz' => null ],
1008 'ORDER BY' => [ 'foo_id' ],
1011 'INNER ORDER BY' => [ 'bar_id' ],
1013 'unionSupportsOrderAndLimit' => false,
1015 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 150,25"
1022 * @covers Wikimedia\Rdbms\Database::commit
1023 * @covers Wikimedia\Rdbms\Database::doCommit
1025 public function testTransactionCommit() {
1026 $this->database
->begin( __METHOD__
);
1027 $this->database
->commit( __METHOD__
);
1028 $this->assertLastSql( 'BEGIN; COMMIT' );
1032 * @covers Wikimedia\Rdbms\Database::rollback
1033 * @covers Wikimedia\Rdbms\Database::doRollback
1035 public function testTransactionRollback() {
1036 $this->database
->begin( __METHOD__
);
1037 $this->database
->rollback( __METHOD__
);
1038 $this->assertLastSql( 'BEGIN; ROLLBACK' );
1042 * @covers Wikimedia\Rdbms\Database::dropTable
1044 public function testDropTable() {
1045 $this->database
->setExistingTables( [ 'table' ] );
1046 $this->database
->dropTable( 'table', __METHOD__
);
1047 $this->assertLastSql( 'DROP TABLE table CASCADE' );
1051 * @covers Wikimedia\Rdbms\Database::dropTable
1053 public function testDropNonExistingTable() {
1055 $this->database
->dropTable( 'non_existing', __METHOD__
)
1060 * @dataProvider provideMakeList
1061 * @covers Wikimedia\Rdbms\Database::makeList
1063 public function testMakeList( $list, $mode, $sqlText ) {
1064 $this->assertEquals( trim( $this->database
->makeList(
1069 public static function provideMakeList() {
1072 [ 'value', 'value2' ],
1077 [ 'field', 'field2' ],
1082 [ 'field' => 'value', 'field2' => 'value2' ],
1084 "field = 'value' AND field2 = 'value2'"
1087 [ 'field' => null, "field2 != 'value2'" ],
1089 "field IS NULL AND (field2 != 'value2')"
1092 [ 'field' => [ 'value', null, 'value2' ], 'field2' => 'value2' ],
1094 "(field IN ('value','value2') OR field IS NULL) AND field2 = 'value2'"
1097 [ 'field' => [ null ], 'field2' => null ],
1099 "field IS NULL AND field2 IS NULL"
1102 [ 'field' => 'value', 'field2' => 'value2' ],
1104 "field = 'value' OR field2 = 'value2'"
1107 [ 'field' => 'value', 'field2' => null ],
1109 "field = 'value' OR field2 IS NULL"
1112 [ 'field' => [ 'value', 'value2' ], 'field2' => [ 'value' ] ],
1114 "field IN ('value','value2') OR field2 = 'value'"
1117 [ 'field' => [ null, 'value', null, 'value2' ], "field2 != 'value2'" ],
1119 "(field IN ('value','value2') OR field IS NULL) OR (field2 != 'value2')"
1122 [ 'field' => 'value', 'field2' => 'value2' ],
1124 "field = 'value',field2 = 'value2'"
1127 [ 'field' => 'value', 'field2' => null ],
1129 "field = 'value',field2 = NULL"
1132 [ 'field' => 'value', "field2 != 'value2'" ],
1134 "field = 'value',field2 != 'value2'"
1140 * @covers Wikimedia\Rdbms\Database::registerTempTableOperation
1142 public function testSessionTempTables() {
1143 $temp1 = $this->database
->tableName( 'tmp_table_1' );
1144 $temp2 = $this->database
->tableName( 'tmp_table_2' );
1145 $temp3 = $this->database
->tableName( 'tmp_table_3' );
1147 $this->database
->query( "CREATE TEMPORARY TABLE $temp1 LIKE orig_tbl", __METHOD__
);
1148 $this->database
->query( "CREATE TEMPORARY TABLE $temp2 LIKE orig_tbl", __METHOD__
);
1149 $this->database
->query( "CREATE TEMPORARY TABLE $temp3 LIKE orig_tbl", __METHOD__
);
1151 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1152 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1153 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1155 $this->database
->dropTable( 'tmp_table_1', __METHOD__
);
1156 $this->database
->dropTable( 'tmp_table_2', __METHOD__
);
1157 $this->database
->dropTable( 'tmp_table_3', __METHOD__
);
1159 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1160 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1161 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1163 $this->database
->query( "CREATE TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1164 $this->database
->query( "CREATE TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1165 $this->database
->query( "CREATE TEMPORARY TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1167 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1168 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1169 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1171 $this->database
->query( "DROP TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1172 $this->database
->query( "DROP TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1173 $this->database
->query( "DROP TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1175 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1176 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1177 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );