3 use Wikimedia\Rdbms\LikeMatch
;
4 use Wikimedia\Rdbms\Database
;
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|Database */
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 * @covers Wikimedia\Rdbms\Subquery
245 * @dataProvider provideSelectRowCount
249 public function testSelectRowCount( $sql, $sqlText ) {
250 $this->database
->selectRowCount(
253 isset( $sql['conds'] ) ?
$sql['conds'] : [],
255 isset( $sql['options'] ) ?
$sql['options'] : [],
256 isset( $sql['join_conds'] ) ?
$sql['join_conds'] : []
258 $this->assertLastSql( $sqlText );
261 public static function provideSelectRowCount() {
267 'conds' => [ 'field' => 'text' ],
269 "SELECT COUNT(*) AS rowcount FROM " .
270 "(SELECT 1 FROM table WHERE field = 'text' ) tmp_count"
275 'field' => [ 'column' ],
276 'conds' => [ 'field' => 'text' ],
278 "SELECT COUNT(*) AS rowcount FROM " .
279 "(SELECT 1 FROM table WHERE field = 'text' AND (column IS NOT NULL) ) tmp_count"
284 'field' => [ 'alias' => 'column' ],
285 'conds' => [ 'field' => 'text' ],
287 "SELECT COUNT(*) AS rowcount FROM " .
288 "(SELECT 1 FROM table WHERE field = 'text' AND (column IS NOT NULL) ) tmp_count"
293 'field' => [ 'alias' => 'column' ],
296 "SELECT COUNT(*) AS rowcount FROM " .
297 "(SELECT 1 FROM table WHERE (column IS NOT NULL) ) tmp_count"
302 'field' => [ 'alias' => 'column' ],
305 "SELECT COUNT(*) AS rowcount FROM " .
306 "(SELECT 1 FROM table WHERE (column IS NOT NULL) ) tmp_count"
311 'field' => [ 'alias' => 'column' ],
314 "SELECT COUNT(*) AS rowcount FROM " .
315 "(SELECT 1 FROM table WHERE (column IS NOT NULL) ) tmp_count"
320 'field' => [ 'alias' => 'column' ],
323 "SELECT COUNT(*) AS rowcount FROM " .
324 "(SELECT 1 FROM table WHERE (1) AND (column IS NOT NULL) ) tmp_count"
329 'field' => [ 'alias' => 'column' ],
332 "SELECT COUNT(*) AS rowcount FROM " .
333 "(SELECT 1 FROM table WHERE (0) AND (column IS NOT NULL) ) tmp_count"
339 * @dataProvider provideUpdate
340 * @covers Wikimedia\Rdbms\Database::update
341 * @covers Wikimedia\Rdbms\Database::makeUpdateOptions
342 * @covers Wikimedia\Rdbms\Database::makeUpdateOptionsArray
344 public function testUpdate( $sql, $sqlText ) {
345 $this->database
->update(
350 isset( $sql['options'] ) ?
$sql['options'] : []
352 $this->assertLastSql( $sqlText );
355 public static function provideUpdate() {
360 'values' => [ 'field' => 'text', 'field2' => 'text2' ],
361 'conds' => [ 'alias' => 'text' ],
364 "SET field = 'text'" .
365 ",field2 = 'text2' " .
366 "WHERE alias = 'text'"
371 'values' => [ 'field = other', 'field2' => 'text2' ],
372 'conds' => [ 'id' => '1' ],
375 "SET field = other" .
376 ",field2 = 'text2' " .
382 'values' => [ 'field = other', 'field2' => 'text2' ],
386 "SET field = other" .
393 * @dataProvider provideDelete
394 * @covers Wikimedia\Rdbms\Database::delete
396 public function testDelete( $sql, $sqlText ) {
397 $this->database
->delete(
402 $this->assertLastSql( $sqlText );
405 public static function provideDelete() {
410 'conds' => [ 'alias' => 'text' ],
412 "DELETE FROM table " .
413 "WHERE alias = 'text'"
426 * @dataProvider provideUpsert
427 * @covers Wikimedia\Rdbms\Database::upsert
429 public function testUpsert( $sql, $sqlText ) {
430 $this->database
->upsert(
433 $sql['uniqueIndexes'],
437 $this->assertLastSql( $sqlText );
440 public static function provideUpsert() {
444 'table' => 'upsert_table',
445 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
446 'uniqueIndexes' => [ 'field' ],
447 'set' => [ 'field' => 'set' ],
450 "UPDATE upsert_table " .
451 "SET field = 'set' " .
452 "WHERE ((field = 'text')); " .
453 "INSERT IGNORE INTO upsert_table " .
455 "VALUES ('text','text2'); " .
462 * @dataProvider provideDeleteJoin
463 * @covers Wikimedia\Rdbms\Database::deleteJoin
465 public function testDeleteJoin( $sql, $sqlText ) {
466 $this->database
->deleteJoin(
474 $this->assertLastSql( $sqlText );
477 public static function provideDeleteJoin() {
481 'delTable' => 'table',
482 'joinTable' => 'table_join',
484 'joinVar' => 'field_join',
485 'conds' => [ 'alias' => 'text' ],
487 "DELETE FROM table " .
489 "SELECT field_join FROM table_join WHERE alias = 'text'" .
494 'delTable' => 'table',
495 'joinTable' => 'table_join',
497 'joinVar' => 'field_join',
500 "DELETE FROM table " .
502 "SELECT field_join FROM table_join " .
509 * @dataProvider provideInsert
510 * @covers Wikimedia\Rdbms\Database::insert
511 * @covers Wikimedia\Rdbms\Database::makeInsertOptions
513 public function testInsert( $sql, $sqlText ) {
514 $this->database
->insert(
518 isset( $sql['options'] ) ?
$sql['options'] : []
520 $this->assertLastSql( $sqlText );
523 public static function provideInsert() {
528 'rows' => [ 'field' => 'text', 'field2' => 2 ],
530 "INSERT INTO table " .
532 "VALUES ('text','2')"
537 'rows' => [ 'field' => 'text', 'field2' => 2 ],
538 'options' => 'IGNORE',
540 "INSERT IGNORE INTO table " .
542 "VALUES ('text','2')"
548 [ 'field' => 'text', 'field2' => 2 ],
549 [ 'field' => 'multi', 'field2' => 3 ],
551 'options' => 'IGNORE',
553 "INSERT IGNORE INTO table " .
563 * @dataProvider provideInsertSelect
564 * @covers Wikimedia\Rdbms\Database::insertSelect
565 * @covers Wikimedia\Rdbms\Database::nativeInsertSelect
567 public function testInsertSelect( $sql, $sqlTextNative, $sqlSelect, $sqlInsert ) {
568 $this->database
->insertSelect(
574 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
575 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
576 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
578 $this->assertLastSql( $sqlTextNative );
580 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
581 $dbWeb->forceNextResult( [
582 array_flip( array_keys( $sql['varMap'] ) )
584 $dbWeb->insertSelect(
590 isset( $sql['insertOptions'] ) ?
$sql['insertOptions'] : [],
591 isset( $sql['selectOptions'] ) ?
$sql['selectOptions'] : [],
592 isset( $sql['selectJoinConds'] ) ?
$sql['selectJoinConds'] : []
594 $this->assertLastSqlDb( implode( '; ', [ $sqlSelect, 'BEGIN', $sqlInsert, 'COMMIT' ] ), $dbWeb );
597 public static function provideInsertSelect() {
601 'destTable' => 'insert_table',
602 'srcTable' => 'select_table',
603 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
606 "INSERT INTO insert_table " .
607 "(field_insert,field) " .
608 "SELECT field_select,field2 " .
609 "FROM select_table WHERE *",
610 "SELECT field_select AS field_insert,field2 AS field " .
611 "FROM select_table WHERE * FOR UPDATE",
612 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
616 'destTable' => 'insert_table',
617 'srcTable' => 'select_table',
618 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
619 'conds' => [ 'field' => 2 ],
621 "INSERT INTO insert_table " .
622 "(field_insert,field) " .
623 "SELECT field_select,field2 " .
624 "FROM select_table " .
626 "SELECT field_select AS field_insert,field2 AS field FROM " .
627 "select_table WHERE field = '2' FOR UPDATE",
628 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
632 'destTable' => 'insert_table',
633 'srcTable' => 'select_table',
634 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
635 'conds' => [ 'field' => 2 ],
636 'insertOptions' => 'IGNORE',
637 'selectOptions' => [ 'ORDER BY' => 'field' ],
639 "INSERT IGNORE INTO insert_table " .
640 "(field_insert,field) " .
641 "SELECT field_select,field2 " .
642 "FROM select_table " .
643 "WHERE field = '2' " .
645 "SELECT field_select AS field_insert,field2 AS field " .
646 "FROM select_table WHERE field = '2' ORDER BY field FOR UPDATE",
647 "INSERT IGNORE INTO insert_table (field_insert,field) VALUES ('0','1')"
651 'destTable' => 'insert_table',
652 'srcTable' => [ 'select_table1', 'select_table2' ],
653 'varMap' => [ 'field_insert' => 'field_select', 'field' => 'field2' ],
654 'conds' => [ 'field' => 2 ],
655 'insertOptions' => [ 'NO_AUTO_COLUMNS' ],
656 'selectOptions' => [ 'ORDER BY' => 'field', 'FORCE INDEX' => [ 'select_table1' => 'index1' ] ],
657 'selectJoinConds' => [
658 'select_table2' => [ 'LEFT JOIN', [ 'select_table1.foo = select_table2.bar' ] ],
661 "INSERT INTO insert_table " .
662 "(field_insert,field) " .
663 "SELECT field_select,field2 " .
664 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
665 "WHERE field = '2' " .
667 "SELECT field_select AS field_insert,field2 AS field " .
668 "FROM select_table1 LEFT JOIN select_table2 ON ((select_table1.foo = select_table2.bar)) " .
669 "WHERE field = '2' ORDER BY field FOR UPDATE",
670 "INSERT INTO insert_table (field_insert,field) VALUES ('0','1')"
675 public function testInsertSelectBatching() {
676 $dbWeb = new DatabaseTestHelper( __CLASS__
, [ 'cliMode' => false ] );
678 for ( $i = 0; $i <= 25000; $i++
) {
679 $rows[] = [ 'field' => $i ];
681 $dbWeb->forceNextResult( $rows );
682 $dbWeb->insertSelect(
685 [ 'field' => 'field2' ],
689 $this->assertLastSqlDb( implode( '; ', [
690 'SELECT field2 AS field FROM select_table WHERE * FOR UPDATE',
692 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 0, 9999 ) ) . "')",
693 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 10000, 19999 ) ) . "')",
694 "INSERT INTO insert_table (field) VALUES ('" . implode( "'),('", range( 20000, 25000 ) ) . "')",
700 * @dataProvider provideReplace
701 * @covers Wikimedia\Rdbms\Database::replace
703 public function testReplace( $sql, $sqlText ) {
704 $this->database
->replace(
706 $sql['uniqueIndexes'],
710 $this->assertLastSql( $sqlText );
713 public static function provideReplace() {
717 'table' => 'replace_table',
718 'uniqueIndexes' => [ 'field' ],
719 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
721 "BEGIN; DELETE FROM replace_table " .
722 "WHERE (field = 'text'); " .
723 "INSERT INTO replace_table " .
725 "VALUES ('text','text2'); COMMIT"
729 'table' => 'module_deps',
730 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
732 'md_module' => 'module',
737 "BEGIN; DELETE FROM module_deps " .
738 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
739 "INSERT INTO module_deps " .
740 "(md_module,md_skin,md_deps) " .
741 "VALUES ('module','skin','deps'); COMMIT"
745 'table' => 'module_deps',
746 'uniqueIndexes' => [ [ 'md_module', 'md_skin' ] ],
749 'md_module' => 'module',
753 'md_module' => 'module2',
754 'md_skin' => 'skin2',
755 'md_deps' => 'deps2',
759 "BEGIN; DELETE FROM module_deps " .
760 "WHERE (md_module = 'module' AND md_skin = 'skin'); " .
761 "INSERT INTO module_deps " .
762 "(md_module,md_skin,md_deps) " .
763 "VALUES ('module','skin','deps'); " .
764 "DELETE FROM module_deps " .
765 "WHERE (md_module = 'module2' AND md_skin = 'skin2'); " .
766 "INSERT INTO module_deps " .
767 "(md_module,md_skin,md_deps) " .
768 "VALUES ('module2','skin2','deps2'); COMMIT"
772 'table' => 'module_deps',
773 'uniqueIndexes' => [ 'md_module', 'md_skin' ],
776 'md_module' => 'module',
780 'md_module' => 'module2',
781 'md_skin' => 'skin2',
782 'md_deps' => 'deps2',
786 "BEGIN; DELETE FROM module_deps " .
787 "WHERE (md_module = 'module') OR (md_skin = 'skin'); " .
788 "INSERT INTO module_deps " .
789 "(md_module,md_skin,md_deps) " .
790 "VALUES ('module','skin','deps'); " .
791 "DELETE FROM module_deps " .
792 "WHERE (md_module = 'module2') OR (md_skin = 'skin2'); " .
793 "INSERT INTO module_deps " .
794 "(md_module,md_skin,md_deps) " .
795 "VALUES ('module2','skin2','deps2'); COMMIT"
799 'table' => 'module_deps',
800 'uniqueIndexes' => [],
802 'md_module' => 'module',
807 "BEGIN; INSERT INTO module_deps " .
808 "(md_module,md_skin,md_deps) " .
809 "VALUES ('module','skin','deps'); COMMIT"
815 * @dataProvider provideNativeReplace
816 * @covers Wikimedia\Rdbms\Database::nativeReplace
818 public function testNativeReplace( $sql, $sqlText ) {
819 $this->database
->nativeReplace(
824 $this->assertLastSql( $sqlText );
827 public static function provideNativeReplace() {
831 'table' => 'replace_table',
832 'rows' => [ 'field' => 'text', 'field2' => 'text2' ],
834 "REPLACE INTO replace_table " .
836 "VALUES ('text','text2')"
842 * @dataProvider provideConditional
843 * @covers Wikimedia\Rdbms\Database::conditional
845 public function testConditional( $sql, $sqlText ) {
846 $this->assertEquals( trim( $this->database
->conditional(
853 public static function provideConditional() {
857 'conds' => [ 'field' => 'text' ],
861 "(CASE WHEN field = 'text' THEN 1 ELSE NULL END)"
865 'conds' => [ 'field' => 'text', 'field2' => 'anothertext' ],
869 "(CASE WHEN field = 'text' AND field2 = 'anothertext' THEN 1 ELSE NULL END)"
873 'conds' => 'field=1',
877 "(CASE WHEN field=1 THEN 1 ELSE NULL END)"
883 * @dataProvider provideBuildConcat
884 * @covers Wikimedia\Rdbms\Database::buildConcat
886 public function testBuildConcat( $stringList, $sqlText ) {
887 $this->assertEquals( trim( $this->database
->buildConcat(
892 public static function provideBuildConcat() {
895 [ 'field', 'field2' ],
896 "CONCAT(field,field2)"
899 [ "'test'", 'field2' ],
900 "CONCAT('test',field2)"
906 * @dataProvider provideBuildLike
907 * @covers Wikimedia\Rdbms\Database::buildLike
908 * @covers Wikimedia\Rdbms\Database::escapeLikeInternal
910 public function testBuildLike( $array, $sqlText ) {
911 $this->assertEquals( trim( $this->database
->buildLike(
916 public static function provideBuildLike() {
920 "LIKE 'text' ESCAPE '`'"
923 [ 'text', new LikeMatch( '%' ) ],
924 "LIKE 'text%' ESCAPE '`'"
927 [ 'text', new LikeMatch( '%' ), 'text2' ],
928 "LIKE 'text%text2' ESCAPE '`'"
931 [ 'text', new LikeMatch( '_' ) ],
932 "LIKE 'text_' ESCAPE '`'"
936 "LIKE 'more`_text' ESCAPE '`'"
939 [ 'C:\\Windows\\', new LikeMatch( '%' ) ],
940 "LIKE 'C:\\Windows\\%' ESCAPE '`'"
943 [ 'accent`_test`', new LikeMatch( '%' ) ],
944 "LIKE 'accent```_test``%' ESCAPE '`'"
950 * @dataProvider provideUnionQueries
951 * @covers Wikimedia\Rdbms\Database::unionQueries
953 public function testUnionQueries( $sql, $sqlText ) {
954 $this->assertEquals( trim( $this->database
->unionQueries(
960 public static function provideUnionQueries() {
964 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
967 "(RAW SQL) UNION ALL (RAW2SQL)"
971 'sqls' => [ 'RAW SQL', 'RAW2SQL' ],
974 "(RAW SQL) UNION (RAW2SQL)"
978 'sqls' => [ 'RAW SQL', 'RAW2SQL', 'RAW3SQL' ],
981 "(RAW SQL) UNION (RAW2SQL) UNION (RAW3SQL)"
987 * @dataProvider provideUnionConditionPermutations
988 * @covers Wikimedia\Rdbms\Database::unionConditionPermutations
990 public function testUnionConditionPermutations( $params, $expect ) {
991 if ( isset( $params['unionSupportsOrderAndLimit'] ) ) {
992 $this->database
->setUnionSupportsOrderAndLimit( $params['unionSupportsOrderAndLimit'] );
995 $sql = trim( $this->database
->unionConditionPermutations(
998 $params['permute_conds'],
999 isset( $params['extra_conds'] ) ?
$params['extra_conds'] : '',
1001 isset( $params['options'] ) ?
$params['options'] : [],
1002 isset( $params['join_conds'] ) ?
$params['join_conds'] : []
1004 $this->assertEquals( $expect, $sql );
1007 public static function provideUnionConditionPermutations() {
1008 // phpcs:disable Generic.Files.LineLength
1012 'table' => [ 'table1', 'table2' ],
1013 'vars' => [ 'field1', 'alias' => 'field2' ],
1014 'permute_conds' => [
1015 'field3' => [ 1, 2, 3 ],
1016 'duplicates' => [ 4, 5, 4 ],
1020 'extra_conds' => 'table2.bar > 23',
1022 'ORDER BY' => [ 'field1', 'alias' ],
1023 'INNER ORDER BY' => [ 'field1', 'field2' ],
1027 'table2' => [ 'JOIN', 'table1.foo_id = table2.foo_id' ],
1030 "(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 " .
1031 "(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 " .
1032 "(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 " .
1033 "(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 " .
1034 "(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 " .
1035 "(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 ) " .
1036 "ORDER BY field1,alias LIMIT 100"
1041 'vars' => [ 'foo_id' ],
1042 'permute_conds' => [
1043 'bar' => [ 1, 2, 3 ],
1045 'extra_conds' => [ 'baz' => null ],
1048 'ORDER BY' => [ 'foo_id' ],
1052 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
1053 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) UNION " .
1054 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ORDER BY foo_id LIMIT 25 ) " .
1055 "ORDER BY foo_id LIMIT 25"
1060 'vars' => [ 'foo_id' ],
1061 'permute_conds' => [
1062 'bar' => [ 1, 2, 3 ],
1064 'extra_conds' => [ 'baz' => null ],
1067 'ORDER BY' => [ 'foo_id' ],
1070 'unionSupportsOrderAndLimit' => false,
1072 "(SELECT foo_id FROM foo WHERE bar = '1' AND baz IS NULL ) UNION " .
1073 "(SELECT foo_id FROM foo WHERE bar = '2' AND baz IS NULL ) UNION " .
1074 "(SELECT foo_id FROM foo WHERE bar = '3' AND baz IS NULL ) " .
1075 "ORDER BY foo_id LIMIT 25"
1080 'vars' => [ 'foo_id' ],
1081 'permute_conds' => [],
1082 'extra_conds' => [ 'baz' => null ],
1084 'ORDER BY' => [ 'foo_id' ],
1088 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
1093 'vars' => [ 'foo_id' ],
1094 'permute_conds' => [
1097 'extra_conds' => [ 'baz' => null ],
1099 'ORDER BY' => [ 'foo_id' ],
1103 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 25"
1108 'vars' => [ 'foo_id' ],
1109 'permute_conds' => [
1113 'ORDER BY' => [ 'foo_id' ],
1118 "SELECT foo_id FROM foo WHERE bar = '1' ORDER BY foo_id LIMIT 150,25"
1123 'vars' => [ 'foo_id' ],
1124 'permute_conds' => [],
1125 'extra_conds' => [ 'baz' => null ],
1127 'ORDER BY' => [ 'foo_id' ],
1130 'INNER ORDER BY' => [ 'bar_id' ],
1133 "(SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY bar_id LIMIT 175 ) ORDER BY foo_id LIMIT 150,25"
1138 'vars' => [ 'foo_id' ],
1139 'permute_conds' => [],
1140 'extra_conds' => [ 'baz' => null ],
1142 'ORDER BY' => [ 'foo_id' ],
1145 'INNER ORDER BY' => [ 'bar_id' ],
1147 'unionSupportsOrderAndLimit' => false,
1149 "SELECT foo_id FROM foo WHERE baz IS NULL ORDER BY foo_id LIMIT 150,25"
1156 * @covers Wikimedia\Rdbms\Database::commit
1157 * @covers Wikimedia\Rdbms\Database::doCommit
1159 public function testTransactionCommit() {
1160 $this->database
->begin( __METHOD__
);
1161 $this->database
->commit( __METHOD__
);
1162 $this->assertLastSql( 'BEGIN; COMMIT' );
1166 * @covers Wikimedia\Rdbms\Database::rollback
1167 * @covers Wikimedia\Rdbms\Database::doRollback
1169 public function testTransactionRollback() {
1170 $this->database
->begin( __METHOD__
);
1171 $this->database
->rollback( __METHOD__
);
1172 $this->assertLastSql( 'BEGIN; ROLLBACK' );
1176 * @covers Wikimedia\Rdbms\Database::dropTable
1178 public function testDropTable() {
1179 $this->database
->setExistingTables( [ 'table' ] );
1180 $this->database
->dropTable( 'table', __METHOD__
);
1181 $this->assertLastSql( 'DROP TABLE table CASCADE' );
1185 * @covers Wikimedia\Rdbms\Database::dropTable
1187 public function testDropNonExistingTable() {
1189 $this->database
->dropTable( 'non_existing', __METHOD__
)
1194 * @dataProvider provideMakeList
1195 * @covers Wikimedia\Rdbms\Database::makeList
1197 public function testMakeList( $list, $mode, $sqlText ) {
1198 $this->assertEquals( trim( $this->database
->makeList(
1203 public static function provideMakeList() {
1206 [ 'value', 'value2' ],
1211 [ 'field', 'field2' ],
1216 [ 'field' => 'value', 'field2' => 'value2' ],
1218 "field = 'value' AND field2 = 'value2'"
1221 [ 'field' => null, "field2 != 'value2'" ],
1223 "field IS NULL AND (field2 != 'value2')"
1226 [ 'field' => [ 'value', null, 'value2' ], 'field2' => 'value2' ],
1228 "(field IN ('value','value2') OR field IS NULL) AND field2 = 'value2'"
1231 [ 'field' => [ null ], 'field2' => null ],
1233 "field IS NULL AND field2 IS NULL"
1236 [ 'field' => 'value', 'field2' => 'value2' ],
1238 "field = 'value' OR field2 = 'value2'"
1241 [ 'field' => 'value', 'field2' => null ],
1243 "field = 'value' OR field2 IS NULL"
1246 [ 'field' => [ 'value', 'value2' ], 'field2' => [ 'value' ] ],
1248 "field IN ('value','value2') OR field2 = 'value'"
1251 [ 'field' => [ null, 'value', null, 'value2' ], "field2 != 'value2'" ],
1253 "(field IN ('value','value2') OR field IS NULL) OR (field2 != 'value2')"
1256 [ 'field' => 'value', 'field2' => 'value2' ],
1258 "field = 'value',field2 = 'value2'"
1261 [ 'field' => 'value', 'field2' => null ],
1263 "field = 'value',field2 = NULL"
1266 [ 'field' => 'value', "field2 != 'value2'" ],
1268 "field = 'value',field2 != 'value2'"
1274 * @covers Wikimedia\Rdbms\Database::registerTempTableOperation
1276 public function testSessionTempTables() {
1277 $temp1 = $this->database
->tableName( 'tmp_table_1' );
1278 $temp2 = $this->database
->tableName( 'tmp_table_2' );
1279 $temp3 = $this->database
->tableName( 'tmp_table_3' );
1281 $this->database
->query( "CREATE TEMPORARY TABLE $temp1 LIKE orig_tbl", __METHOD__
);
1282 $this->database
->query( "CREATE TEMPORARY TABLE $temp2 LIKE orig_tbl", __METHOD__
);
1283 $this->database
->query( "CREATE TEMPORARY TABLE $temp3 LIKE orig_tbl", __METHOD__
);
1285 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1286 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1287 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1289 $this->database
->dropTable( 'tmp_table_1', __METHOD__
);
1290 $this->database
->dropTable( 'tmp_table_2', __METHOD__
);
1291 $this->database
->dropTable( 'tmp_table_3', __METHOD__
);
1293 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1294 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1295 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1297 $this->database
->query( "CREATE TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1298 $this->database
->query( "CREATE TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1299 $this->database
->query( "CREATE TEMPORARY TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1301 $this->assertTrue( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1302 $this->assertTrue( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1303 $this->assertTrue( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1305 $this->database
->query( "DROP TEMPORARY TABLE tmp_table_1 LIKE orig_tbl", __METHOD__
);
1306 $this->database
->query( "DROP TEMPORARY TABLE 'tmp_table_2' LIKE orig_tbl", __METHOD__
);
1307 $this->database
->query( "DROP TABLE `tmp_table_3` LIKE orig_tbl", __METHOD__
);
1309 $this->assertFalse( $this->database
->tableExists( "tmp_table_1", __METHOD__
) );
1310 $this->assertFalse( $this->database
->tableExists( "tmp_table_2", __METHOD__
) );
1311 $this->assertFalse( $this->database
->tableExists( "tmp_table_3", __METHOD__
) );
1314 public function provideBuildSubstring() {
1315 yield
[ 'someField', 1, 2, 'SUBSTRING(someField FROM 1 FOR 2)' ];
1316 yield
[ 'someField', 1, null, 'SUBSTRING(someField FROM 1)' ];
1320 * @covers Wikimedia\Rdbms\Database::buildSubstring
1321 * @dataProvider provideBuildSubstring
1323 public function testBuildSubstring( $input, $start, $length, $expected ) {
1324 $output = $this->database
->buildSubstring( $input, $start, $length );
1325 $this->assertSame( $expected, $output );
1328 public function provideBuildSubstring_invalidParams() {
1338 * @covers Wikimedia\Rdbms\Database::buildSubstring
1339 * @covers Wikimedia\Rdbms\Database::assertBuildSubstringParams
1340 * @dataProvider provideBuildSubstring_invalidParams
1342 public function testBuildSubstring_invalidParams( $start, $length ) {
1343 $this->setExpectedException( InvalidArgumentException
::class );
1344 $this->database
->buildSubstring( 'foo', $start, $length );
1348 * @covers \Wikimedia\Rdbms\Database::buildIntegerCast
1350 public function testBuildIntegerCast() {
1351 $output = $this->database
->buildIntegerCast( 'fieldName' );
1352 $this->assertSame( 'CAST( fieldName AS INTEGER )', $output );