diff --git a/docs/guide/db-query-builder.md b/docs/guide/db-query-builder.md index 1ee3ddfc1c..2ce5b8cd62 100644 --- a/docs/guide/db-query-builder.md +++ b/docs/guide/db-query-builder.md @@ -2,7 +2,7 @@ Query Builder ============= Built on top of [Database Access Objects](db-dao.md), query builder allows you to construct a SQL statement -in a programmatic and DBMS-agnostic way. Compared to writing raw SQLs, using query builder will help you write +in a programmatic and DBMS-agnostic way. Compared to writing raw SQL statements, using query builder will help you write more readable SQL-related code and generate more secure SQL statements. Using query builder usually involves two steps: @@ -61,7 +61,7 @@ $query->select(['id', 'email']); $query->select('id, email'); ``` -The column names being selected may include table prefixes and/or column aliases, like you do when writing raw SQLs. +The column names being selected may include table prefixes and/or column aliases, like you do when writing raw SQL statements. For example, ```php @@ -124,7 +124,7 @@ $query->from('user'); ``` You can specify the table(s) being selected from in either a string or an array. The table names may contain -schema prefixes and/or table aliases, like you do when writing raw SQLs. For example, +schema prefixes and/or table aliases, like you do when writing raw SQL statements. For example, ```php $query->from(['public.user u', 'public.post p']); @@ -353,7 +353,7 @@ In the above code, the array keys are column names while the array values are th The PHP constant `SORT_ASC` specifies ascending sort and `SORT_DESC` descending sort. If `ORDER BY` only involves simple column names, you can specify it using a string, just like you do when writing -raw SQLs. For example, +raw SQL statements. For example, ```php $query->orderBy('id ASC, name DESC'); @@ -380,7 +380,7 @@ $query->groupBy(['id', 'status']); ``` If `GROUP BY` only involves simple column names, you can specify it using a string, just like you do when writing -raw SQLs. For example, +raw SQL statements. For example, ```php $query->groupBy('id, status'); @@ -607,7 +607,7 @@ value which will be used as the index value for the current row. When working with large amounts of data, methods such as [[yii\db\Query::all()]] are not suitable because they require loading all data into the memory. To keep the memory requirement low, Yii -provides the so-called batch query support. A batch query makes uses of the data cursor and fetches +provides the so-called batch query support. A batch query makes use of the data cursor and fetches data in batches. Batch query can be used like the following: