3 use Wikimedia\Rdbms\LikeMatch
;
6 * Test the abstract database layer
7 * This is a non DBMS depending test.
9 class DatabaseSQLTest
extends MediaWikiTestCase
{
10 /** @var DatabaseTestHelper */
13 protected function setUp() {
15 $this->database
= new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => true ] );
18 protected function assertLastSql( $sqlText ) {
21 $this->database
->getLastSqls()
25 protected function assertLastSqlDb( $sqlText, $db ) {
26 $this->assertEquals( $sqlText, $db->getLastSqls() );
30 * @dataProvider provideSelect
31 * @covers Database::select
33 public function testSelect( $sql, $sqlText ) {
34 $this->database
->select(
37 isset( $sql['conds'] ) ?
$sql['conds'] : [],
39 isset( $sql['options'] ) ?
$sql['options'] : [],
40 isset( $sql['join_conds'] ) ?
$sql['join_conds'] : []
42 $this->assertLastSql( $sqlText );
45 public static function provideSelect() {
50 'fields' => [ 'field', 'alias' => 'field2' ],
51 'conds' => [ 'alias' => 'text' ],
53 "SELECT field,field2 AS alias " .
55 "WHERE alias = 'text'"
60 'fields' => [ 'field', 'alias' => 'field2' ],
61 'conds' => [ 'alias' => 'text' ],
62 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
64 "SELECT field,field2 AS alias " .
66 "WHERE alias = 'text' " .
72 'tables' => [ 'table', 't2' => 'table2' ],
73 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
74 'conds' => [ 'alias' => 'text' ],
75 'options' => [ 'LIMIT' => 1, 'ORDER BY' => 'field' ],
76 'join_conds' => [ 't2' => [
77 'LEFT JOIN', 'tid = t2.id'
80 "SELECT tid,field,field2 AS alias,t2.id " .
81 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
82 "WHERE alias = 'text' " .
88 'tables' => [ 'table', 't2' => 'table2' ],
89 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
90 'conds' => [ 'alias' => 'text' ],
91 'options' => [ 'LIMIT' => 1, 'GROUP BY' => 'field', 'HAVING' => 'COUNT(*) > 1' ],
92 'join_conds' => [ 't2' => [
93 'LEFT JOIN', 'tid = t2.id'
96 "SELECT tid,field,field2 AS alias,t2.id " .
97 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
98 "WHERE alias = 'text' " .
99 "GROUP BY field HAVING COUNT(*) > 1 " .
104 'tables' => [ 'table', 't2' => 'table2' ],
105 'fields' => [ 'tid', 'field', 'alias' => 'field2', 't2.id' ],
106 'conds' => [ 'alias' => 'text' ],
109 'GROUP BY' => [ 'field', 'field2' ],
110 'HAVING' => [ 'COUNT(*) > 1', 'field' => 1 ]
112 'join_conds' => [ 't2' => [
113 'LEFT JOIN', 'tid = t2.id'
116 "SELECT tid,field,field2 AS alias,t2.id " .
117 "FROM table LEFT JOIN table2 t2 ON ((tid = t2.id)) " .
118 "WHERE alias = 'text' " .
119 "GROUP BY field,field2 HAVING (COUNT(*) > 1) AND field = '1' " .
124 'tables' => [ 'table' ],
125 'fields' => [ 'alias' => 'field' ],
126 'conds' => [ 'alias' => [ 1, 2, 3, 4 ] ],
128 "SELECT field AS alias " .
130 "WHERE alias IN ('1','2','3','4')"
136 * @dataProvider provideUpdate
137 * @covers Database::update
139 public function testUpdate( $sql, $sqlText ) {
140 $this->database
->update(
145 isset( $sql['options'] ) ?
$sql['options'] : []
147 $this->assertLastSql( $sqlText );
150 public static function provideUpdate() {
155 'values' => [ 'field' => 'text', 'field2' => 'text2' ],
156 'conds' => [ 'alias' => 'text' ],
159 "SET field = 'text'" .
160 ",field2 = 'text2' " .
161 "WHERE alias = 'text'"
166 'values' => [ 'field = other', 'field2' => 'text2' ],
167 'conds' => [ 'id' => '1' ],
170 "SET field = other" .
171 ",field2 = 'text2' " .
177 'values' => [ 'field = other', 'field2' => 'text2' ],
181 "SET field = other" .
188 * @dataProvider provideDelete
189 * @covers Database::delete
191 public function testDelete( $sql, $sqlText ) {
192 $this->database
->delete(
197 $this->assertLastSql( $sqlText );
200 public static function provideDelete() {
205 'conds' => [ 'alias' => 'text' ],
207 "DELETE FROM table " .
208 "WHERE alias = 'text'"
221 * @dataProvider provideUpsert
222 * @covers Database::upsert
224 public function testUpsert( $sql, $sqlText ) {
225 $this->database
->upsert(
228 $sql['uniqueIndexes'],
232 $this->assertLastSql( $sqlText );
235 public static function provideUpsert() {
239 'table' => 'upsert_table',
240 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
241 'uniqueIndexes' => [ 'field' ],
242 'set' => [ 'field' => 'set' ],
245 "UPDATE upsert_table " .
246 "SET field = 'set' " .
247 "WHERE ((field = 'text')); " .
248 "INSERT IGNORE INTO upsert_table " .
250 "VALUES ('text','text2'); " .
257 * @dataProvider provideDeleteJoin
258 * @covers Database::deleteJoin
260 public function testDeleteJoin( $sql, $sqlText ) {
261 $this->database
->deleteJoin(
269 $this->assertLastSql( $sqlText );
272 public static function provideDeleteJoin() {
276 'delTable' => 'table',
277 'joinTable' => 'table_join',
279 'joinVar' => 'field_join',
280 'conds' => [ 'alias' => 'text' ],
282 "DELETE FROM table " .
284 "SELECT field_join FROM table_join WHERE alias = 'text'" .
289 'delTable' => 'table',
290 'joinTable' => 'table_join',
292 'joinVar' => 'field_join',
295 "DELETE FROM table " .
297 "SELECT field_join FROM table_join " .
304 * @dataProvider provideInsert
305 * @covers Database::insert
307 public function testInsert( $sql, $sqlText ) {
308 $this->database
->insert(
312 isset( $sql['options'] ) ?
$sql['options'] : []
314 $this->assertLastSql( $sqlText );
317 public static function provideInsert() {
322 'rows' => [ 'field' => 'text', 'field2' => 2 ],
324 "INSERT INTO table " .
326 "VALUES ('text','2')"
331 'rows' => [ 'field' => 'text', 'field2' => 2 ],
332 'options' => 'IGNORE',
334 "INSERT IGNORE INTO table " .
336 "VALUES ('text','2')"
342 [ 'field' => 'text', 'field2' => 2 ],
343 [ 'field' => 'multi', 'field2' => 3 ],
345 'options' => 'IGNORE',
347 "INSERT IGNORE INTO table " .
357 * @dataProvider provideInsertSelect
358 * @covers Database::insertSelect
360 public function testInsertSelect( $sql, $sqlTextNative, $sqlSelect, $sqlInsert ) {
361 $this->database
->insertSelect(
367 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
368 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
369 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
371 $this->assertLastSql( $sqlTextNative );
373 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
374 $dbWeb->forceNextResult( [
375 array_flip( array_keys( $sql['varMap'] ) )
377 $dbWeb->insertSelect(
383 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
384 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
385 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
387 $this->assertLastSqlDb( implode( '; ', [ $sqlSelect, $sqlInsert ] ), $dbWeb );
390 public static function provideInsertSelect() {
394 'destTable' => 'insert_table',
395 'srcTable' => 'select_table',
396 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
399 "INSERT INTO insert_table " .
400 "(field_insert,field) " .
401 "SELECT field_select,field2 " .
402 "FROM select_table WHERE *",
403 "SELECT field_select AS field_insert,field2 AS field " .
404 "FROM select_table WHERE * FOR UPDATE",
405 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
409 'destTable' => 'insert_table',
410 'srcTable' => 'select_table',
411 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
412 'conds' => [ 'field' => 2 ],
414 "INSERT INTO insert_table " .
415 "(field_insert,field) " .
416 "SELECT field_select,field2 " .
417 "FROM select_table " .
419 "SELECT field_select AS field_insert,field2 AS field FROM " .
420 "select_table WHERE field = '2' FOR UPDATE",
421 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
425 'destTable' => 'insert_table',
426 'srcTable' => 'select_table',
427 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
428 'conds' => [ 'field' => 2 ],
429 'insertOptions' => 'IGNORE',
430 'selectOptions' => [ 'ORDER BY' => 'field' ],
432 "INSERT IGNORE INTO insert_table " .
433 "(field_insert,field) " .
434 "SELECT field_select,field2 " .
435 "FROM select_table " .
436 "WHERE field = '2' " .
438 "SELECT field_select AS field_insert,field2 AS field " .
439 "FROM select_table WHERE field = '2' ORDER BY field FOR UPDATE",
440 "INSERT IGNORE INTO insert_table (field_insert,field) VALUES ('0','1')"
444 'destTable' => 'insert_table',
445 'srcTable' => [ 'select_table1', 'select_table2' ],
446 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
447 'conds' => [ 'field' => 2 ],
448 'selectOptions' => [ 'ORDER BY' => 'field', 'FORCE INDEX' => [ 'select_table1' => 'index1' ] ],
449 'selectJoinConds' => [
450 'select_table2' => [ 'LEFT JOIN', [ 'select_table1.foo = select_table2.bar' ] ],
453 "INSERT INTO insert_table " .
454 "(field_insert,field) " .
455 "SELECT field_select,field2 " .
456 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
457 "WHERE field = '2' " .
459 "SELECT field_select AS field_insert,field2 AS field " .
460 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
461 "WHERE field = '2' ORDER BY field FOR UPDATE",
462 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
468 * @dataProvider provideReplace
469 * @covers Database::replace
471 public function testReplace( $sql, $sqlText ) {
472 $this->database
->replace(
474 $sql['uniqueIndexes'],
478 $this->assertLastSql( $sqlText );
481 public static function provideReplace() {
485 'table' => 'replace_table',
486 'uniqueIndexes' => [ 'field' ],
487 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
489 "DELETE FROM replace_table " .
490 "WHERE ( field='text' ); " .
491 "INSERT INTO replace_table " .
493 "VALUES ('text','text2')"
497 'table' => 'module_deps',
498 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
500 'md_module' => 'module',
505 "DELETE FROM module_deps " .
506 "WHERE ( md_module='module' AND md_skin='skin' ); " .
507 "INSERT INTO module_deps " .
508 "(md_module,md_skin,md_deps) " .
509 "VALUES ('module','skin','deps')"
513 'table' => 'module_deps',
514 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
517 'md_module' => 'module',
521 'md_module' => 'module2',
522 'md_skin' => 'skin2',
523 'md_deps' => 'deps2',
527 "DELETE FROM module_deps " .
528 "WHERE ( md_module='module' AND md_skin='skin' ); " .
529 "INSERT INTO module_deps " .
530 "(md_module,md_skin,md_deps) " .
531 "VALUES ('module','skin','deps'); " .
532 "DELETE FROM module_deps " .
533 "WHERE ( md_module='module2' AND md_skin='skin2' ); " .
534 "INSERT INTO module_deps " .
535 "(md_module,md_skin,md_deps) " .
536 "VALUES ('module2','skin2','deps2')"
540 'table' => 'module_deps',
541 'uniqueIndexes' => [ 'md_module', 'md_skin' ],
544 'md_module' => 'module',
548 'md_module' => 'module2',
549 'md_skin' => 'skin2',
550 'md_deps' => 'deps2',
554 "DELETE FROM module_deps " .
555 "WHERE ( md_module='module' ) OR ( md_skin='skin' ); " .
556 "INSERT INTO module_deps " .
557 "(md_module,md_skin,md_deps) " .
558 "VALUES ('module','skin','deps'); " .
559 "DELETE FROM module_deps " .
560 "WHERE ( md_module='module2' ) OR ( md_skin='skin2' ); " .
561 "INSERT INTO module_deps " .
562 "(md_module,md_skin,md_deps) " .
563 "VALUES ('module2','skin2','deps2')"
567 'table' => 'module_deps',
568 'uniqueIndexes' => [],
570 'md_module' => 'module',
575 "INSERT INTO module_deps " .
576 "(md_module,md_skin,md_deps) " .
577 "VALUES ('module','skin','deps')"
583 * @dataProvider provideNativeReplace
584 * @covers Database::nativeReplace
586 public function testNativeReplace( $sql, $sqlText ) {
587 $this->database
->nativeReplace(
592 $this->assertLastSql( $sqlText );
595 public static function provideNativeReplace() {
599 'table' => 'replace_table',
600 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
602 "REPLACE INTO replace_table " .
604 "VALUES ('text','text2')"
610 * @dataProvider provideConditional
611 * @covers Database::conditional
613 public function testConditional( $sql, $sqlText ) {
614 $this->assertEquals( trim( $this->database
->conditional(
621 public static function provideConditional() {
625 'conds' => [ 'field' => 'text' ],
629 "(CASE WHEN field = 'text' THEN 1 ELSE NULL END)"
633 'conds' => [ 'field' => 'text', 'field2' => 'anothertext' ],
637 "(CASE WHEN field = 'text' AND field2 = 'anothertext' THEN 1 ELSE NULL END)"
641 'conds' => 'field=1',
645 "(CASE WHEN field=1 THEN 1 ELSE NULL END)"
651 * @dataProvider provideBuildConcat
652 * @covers Database::buildConcat
654 public function testBuildConcat( $stringList, $sqlText ) {
655 $this->assertEquals( trim( $this->database
->buildConcat(
660 public static function provideBuildConcat() {
663 [ 'field', 'field2' ],
664 "CONCAT(field,field2)"
667 [ "'test'", 'field2' ],
668 "CONCAT('test',field2)"
674 * @dataProvider provideBuildLike
675 * @covers Database::buildLike
677 public function testBuildLike( $array, $sqlText ) {
678 $this->assertEquals( trim( $this->database
->buildLike(
683 public static function provideBuildLike() {
687 "LIKE 'text' ESCAPE '`'"
690 [ 'text', new LikeMatch( '%' ) ],
691 "LIKE 'text%' ESCAPE '`'"
694 [ 'text', new LikeMatch( '%' ), 'text2' ],
695 "LIKE 'text%text2' ESCAPE '`'"
698 [ 'text', new LikeMatch( '_' ) ],
699 "LIKE 'text_' ESCAPE '`'"
703 "LIKE 'more`_text' ESCAPE '`'"
706 [ 'C:\\Windows\\', new LikeMatch( '%' ) ],
707 "LIKE 'C:\\Windows\\%' ESCAPE '`'"
710 [ 'accent`_test`', new LikeMatch( '%' ) ],
711 "LIKE 'accent```_test``%' ESCAPE '`'"
717 * @dataProvider provideUnionQueries
718 * @covers Database::unionQueries
720 public function testUnionQueries( $sql, $sqlText ) {
721 $this->assertEquals( trim( $this->database
->unionQueries(
727 public static function provideUnionQueries() {
731 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
734 "(RAW SQL) UNION ALL (RAW2SQL)"
738 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
741 "(RAW SQL) UNION (RAW2SQL)"
745 'sqls' => [ 'RAW SQL', 'RAW2SQL', 'RAW3SQL' ],
748 "(RAW SQL) UNION (RAW2SQL) UNION (RAW3SQL)"
754 * @covers Database::commit
756 public function testTransactionCommit() {
757 $this->database
->begin( __METHOD__
);
758 $this->database
->commit( __METHOD__
);
759 $this->assertLastSql( 'BEGIN; COMMIT' );
763 * @covers Database::rollback
765 public function testTransactionRollback() {
766 $this->database
->begin( __METHOD__
);
767 $this->database
->rollback( __METHOD__
);
768 $this->assertLastSql( 'BEGIN; ROLLBACK' );
772 * @covers Database::dropTable
774 public function testDropTable() {
775 $this->database
->setExistingTables( [ 'table' ] );
776 $this->database
->dropTable( 'table', __METHOD__
);
777 $this->assertLastSql( 'DROP TABLE table CASCADE' );
781 * @covers Database::dropTable
783 public function testDropNonExistingTable() {
785 $this->database
->dropTable( 'non_existing', __METHOD__
)
790 * @dataProvider provideMakeList
791 * @covers Database::makeList
793 public function testMakeList( $list, $mode, $sqlText ) {
794 $this->assertEquals( trim( $this->database
->makeList(
799 public static function provideMakeList() {
802 [ 'value', 'value2' ],
807 [ 'field', 'field2' ],
812 [ 'field' => 'value', 'field2' => 'value2' ],
814 "field = 'value' AND field2 = 'value2'"
817 [ 'field' => null, "field2 != 'value2'" ],
819 "field IS NULL AND (field2 != 'value2')"
822 [ 'field' => [ 'value', null, 'value2' ], 'field2' => 'value2' ],
824 "(field IN ('value','value2') OR field IS NULL) AND field2 = 'value2'"
827 [ 'field' => [ null ], 'field2' => null ],
829 "field IS NULL AND field2 IS NULL"
832 [ 'field' => 'value', 'field2' => 'value2' ],
834 "field = 'value' OR field2 = 'value2'"
837 [ 'field' => 'value', 'field2' => null ],
839 "field = 'value' OR field2 IS NULL"
842 [ 'field' => [ 'value', 'value2' ], 'field2' => [ 'value' ] ],
844 "field IN ('value','value2') OR field2 = 'value'"
847 [ 'field' => [ null, 'value', null, 'value2' ], "field2 != 'value2'" ],
849 "(field IN ('value','value2') OR field IS NULL) OR (field2 != 'value2')"
852 [ 'field' => 'value', 'field2' => 'value2' ],
854 "field = 'value',field2 = 'value2'"
857 [ 'field' => 'value', 'field2' => null ],
859 "field = 'value',field2 = NULL"
862 [ 'field' => 'value', "field2 != 'value2'" ],
864 "field = 'value',field2 != 'value2'"
869 public function testSessionTempTables() {
870 $temp1 = $this->database
->tableName( 'tmp_table_1' );
871 $temp2 = $this->database
->tableName( 'tmp_table_2' );
872 $temp3 = $this->database
->tableName( 'tmp_table_3' );
874 $this->database
->query( "CREATE TEMPORARY TABLE $temp1 LIKE orig_tbl", __METHOD__
);
875 $this->database
->query( "CREATE TEMPORARY TABLE $temp2 LIKE orig_tbl", __METHOD__
);
876 $this->database
->query( "CREATE TEMPORARY TABLE $temp3 LIKE orig_tbl", __METHOD__
);
878 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
879 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
880 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
882 $this->database
->dropTable( 'tmp_table_1', __METHOD__
);
883 $this->database
->dropTable( 'tmp_table_2', __METHOD__
);
884 $this->database
->dropTable( 'tmp_table_3', __METHOD__
);
886 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
887 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
888 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
890 $this->database
->query( "CREATE TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
891 $this->database
->query( "CREATE TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
892 $this->database
->query( "CREATE TEMPORARY TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
894 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
895 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
896 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
898 $this->database
->query( "DROP TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
899 $this->database
->query( "DROP TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
900 $this->database
->query( "DROP TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
902 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
903 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
904 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );