Yii learning (3)--Query Builder, yiibuilder_PHP tutorial

Yii learning (3)--Query Builder, yiibuilder

Original address: http://www.yiiframework.com/doc/guide/1.1 /en/database.query-builder

However, the original text is in English. Yii’s official website did not translate this chapter, so I tried to translate it myself. In many places, I will write according to my own understanding, and may not necessarily translate it completely according to the original text. . .

Yii’s query builder provides an object-oriented way to write SQL statements. It allows developers to specify various parts of a SQL statement using class methods and properties. Then, assembled into a valid SQL statement, which can be further executed by calling the description method of the DAO data access object. The following shows a typical use of the query builder to create a select statement :

<span>$user</span> = Yii::app()->db-><span>createCommand()
    </span>->select('id, username, profile'<span>)
    </span>->from('tbl_user u'<span>)
    </span>-><span>join</span>('tbl_profile p', 'u.id=p.user_id'<span>)
    </span>->where('id=:id', <span>array</span>(':id'=><span>$id</span><span>))
    </span>->queryRow();

When you need to assemble a program of SQL statements in your application, or based on some conditional logic, it is best to use the query builder. The main benefits of using the Query Builder include :

It can create complex SQL statement programming.
It will self-reference table names and column names to prevent conflicts with SQL reserved words and special characters.
It can also quote parameter values ​​and use parameter binding, which helps reduce the risk of SQL injection attacks.
It provides a level of database abstraction that simplifies the cost of migrating to different database platforms.
It does not force the use of query builder. In fact, if your query is simple, it is easier and faster to write SQL statements directly.

Note: The Query Builder cannot be used to modify existing queries specified as SQL statements.

For example , The following code will not work :

<span>$command</span> = Yii::app()->db->createCommand('SELECT * FROM tbl_user'<span>);
</span><span>//</span><span> the following line will NOT append WHERE clause to the above SQL</span>
<span>$command</span>->where('id=:id', <span>array</span>(':id'=><span>$id</span>));

In other words

, do not mix normal SQL and query generators . 1. Preparing Query Builder

Yii's query builder

is provided from CDbCommand the main database Query class, DescriptionData access object.

Get started with the

Query Builder , We created the CDbCommand A new instance,

<span>$command</span> = Yii::app()->db->createCommand();

We use

Yii::app()->db to get the database connection , and then call CDbConnection::createCommand() Create the required command instance.

Please note that putting the entire SQL statement into createcommand() is called a data access object, and we need to set it to empty.

This is because we will be adding the SQL statement using Query Builder in the explanation below >Methods of each part. 2. Building Data

Retrieval Queries (Building Data Retrieval Queries)

Data retrieval query refers to selecting SQL statements.

The query builder provides a set of methods to build the various parts of a SELECT statement. Since all of these methods return an instance of CDbCommand , we can use method chaining Call them , as shown, in the example at the beginning of this section .

• select(): 指定查询的选择部分 specifies the SELECT part of the query
• selectDistinct(): 指定查询不重复的选择部分 specifies the SELECT part of the query and turns on the DISTINCT flag
• from(): 指定查询的FROM specifies the FROM part of the query
• where(): 指定查询的WHERE specifies the WHERE part of the query
• andWhere(): 用and的方式添加到WHERE的条件中 appends condition to the WHERE part of the query with AND operator
• orWhere(): 用or的方式添加到WHERE的条件中 appends condition to the WHERE part of the query with OR operator
• join(): 添加一个内部联接的查询片段 appends an inner join query fragment
• leftJoin(): 追加一个左外连接查询片段 appends a left outer join query fragment
• rightJoin(): 追加一个右外部联接查询片段 appends a right outer join query fragment
• crossJoin(): 追加一个交叉连接查询片段 appends a cross join query fragment
• naturalJoin(): 追加一个自然连接查询片段 appends a natural join query fragment
• group(): 指定查询的GROUP BY specifies the GROUP BY part of the query
• having(): 指定查询的HAVING specifies the HAVING part of the query
• order(): 指定查询的ORDER BY specifies the ORDER BY part of the query
• limit(): 指定查询的LIMIT specifies the LIMIT part of the query
• offset(): 指定查询的OFFSET specifies the OFFSET part of the query
• union(): 添加查询的UNION appends a UNION query fragment

在下面，我们将解释如何使用这些查询生成器方法。为简单起见，我们假设底层数据库是MySQL。注意：如果你使用的是其他数据库，表/列/值引用的例子可能是不同的。

select()

<span>function</span> select(<span>$columns</span>='*')

该select()方法指定一个查询的选择部分。$columns参数指定要选择的列，它可以是一个字符串，用逗号分隔列，或者一个数组的列名称。列的名称可以包含表的前缀和 / 或列别名。该方法将自动引用列名，除非一列包含一些括号（这意味着这个列是一个DB的表达式）。

下面是一些例子：

<span>//</span><span> SELECT *</span>
<span>select()
</span><span>//</span><span> SELECT `id`, `username`</span>
select('id, username'<span>)
</span><span>//</span><span> SELECT `tbl_user`.`id`, `username` AS `name`</span>
select('tbl_user.id, username as name'<span>)
</span><span>//</span><span> SELECT `id`, `username`</span>
select(<span>array</span>('id', 'username'<span>))
</span><span>//</span><span> SELECT `id`, count(*) as num</span>
select(<span>array</span>('id', 'count(*) as num'))

selectDistinct()

<span>function</span> selectDistinct(<span>$columns</span>)

selectdistinct()方法类似于select()，除了它打开了 DISTINCT 的标志。例如，selectdistinct（'id，用户名”）会产生以下SQL：

<span>SELECT</span> <span>DISTINCT</span> `id`, `username`

from()

<span>function</span> from(<span>$tables</span>)

from()方法指定来了一个查询的FROM部分。 $tables 参数指定表的选择。这可以是一个字符串，用逗号分隔的表的名称，或表名数组。表的名称可以包含架构前缀（例如公共。tbl_user）和/或表的别名（e.g.tbl_user U）。该方法将自动引用表的名称，除非它包含一些括号（即表是一个给定的子查询或DB的表达式）。

下面是一些例子：

<span>//</span><span> FROM `tbl_user`</span>
from('tbl_user'<span>)
</span><span>//</span><span> FROM `tbl_user` `u`, `public`.`tbl_profile` `p`</span>
from('tbl_user u, public.tbl_profile p'<span>)
</span><span>//</span><span> FROM `tbl_user`, `tbl_profile`</span>
from(<span>array</span>('tbl_user', 'tbl_profile'<span>))
</span><span>//</span><span> FROM `tbl_user`, (select * from tbl_profile) p</span>
from(<span>array</span>('tbl_user', '(select * from tbl_profile) p'))

where()

<span>function</span> where(<span>$conditions</span>, <span>$params</span>=<span>array</span>())

where()方法指定查询的WHERE。$conditions 参数指定查询条件的同时，$params 指定参数绑定到整个查询。$conditions参数可以是一个字符串（例如id = 1）或一个数组中的格式：

<span class="hl-reserved">array</span><span class="hl-brackets">(</span><span class="hl-identifier">operator</span><span class="hl-code">, </span><span class="hl-identifier">operand1</span><span class="hl-code">, </span><span class="hl-identifier">operand2</span><span class="hl-code">, ...</span><span class="hl-brackets">)</span>

operator 可以是以下的任何一个：

• and: operands 应该使用 and 连接在一起。例如， array('and', 'id=1', 'id=2') 将产生 id=1 AND id=2 。如果一个操作数是一个数组，它将使用这里描述的相同规则转换成一个字符串。例如，array('and', 'type=1', array('or', 'id=1', 'id=2')) 将生成 type=1 AND (id=1 OR id=2)。

• or: 类似 and 操作，除了operands 是使用 OR 连接的。

• in: operand 1 应是一个列或 DB 表达式，而 operand 2 是代表值的范围的数组，列或 DB 表达式应在这个数组的范围内。例如，array('in', 'id', array(1,2,3)) 将生成 id IN (1,2,3)。

• not in: 类似 in 操作，除了用 NOT IN 代替 IN 去生成SQL。

• like: operand 1 应是一个列或 DB 表达式，而 operand 2 是代表值的范围的数组，列或 DB 表达式应在这个数组的范围内。例如，array('like', 'name', '%tester%') 会生成 name LIKE '%tester%'。当规定值的范围为一个数组时，多个 LIKE 生成SQL时会用 AND 连接。例如，array('like', 'name', array('%test%', '%sample%')) 会生成 name LIKE '%test%' AND name LIKE '%sample%'。

• not like: 类似 like 的操作，除了用 NOT LIKE 代替 LIKE 去生成SQL。

• or like: 类似 like 的操作，除了多个 like 生成 SQL 时用OR连接。

• or not like: 类似 not like 的操作，除了多个 like 生成 SQL 时用OR连接。

下面是一些例子，使用的地方：

<span>//</span><span> WHERE id=1 or id=2</span>
where('id=1 or id=2'<span>)
</span><span>//</span><span> WHERE id=:id1 or id=:id2</span>
where('id=:id1 or id=:id2', <span>array</span>(':id1'=>1, ':id2'=>2<span>))
</span><span>//</span><span> WHERE id=1 OR id=2</span>
where(<span>array</span>('or', 'id=1', 'id=2'<span>))
</span><span>//</span><span> WHERE id=1 AND (type=2 OR type=3)</span>
where(<span>array</span>('and', 'id=1', <span>array</span>('or', 'type=2', 'type=3'<span>)))
</span><span>//</span><span> WHERE `id` IN (1, 2)</span>
where(<span>array</span>('in', 'id', <span>array</span>(1, 2<span>))
</span><span>//</span><span> WHERE `id` NOT IN (1, 2)</span>
where(<span>array</span>('not in', 'id', <span>array</span>(1,2<span>)))
</span><span>//</span><span> WHERE `name` LIKE '%Qiang%'</span>
where(<span>array</span>('like', 'name', '%Qiang%'<span>))
</span><span>//</span><span> WHERE `name` LIKE '%Qiang' AND `name` LIKE '%Xue'</span>
where(<span>array</span>('like', 'name', <span>array</span>('%Qiang', '%Xue'<span>)))
</span><span>//</span><span> WHERE `name` LIKE '%Qiang' OR `name` LIKE '%Xue'</span>
where(<span>array</span>('or like', 'name', <span>array</span>('%Qiang', '%Xue'<span>)))
</span><span>//</span><span> WHERE `name` NOT LIKE '%Qiang%'</span>
where(<span>array</span>('not like', 'name', '%Qiang%'<span>))
</span><span>//</span><span> WHERE `name` NOT LIKE '%Qiang%' OR `name` NOT LIKE '%Xue%'</span>
where(<span>array</span>('or not like', 'name', <span>array</span>('%Qiang%', '%Xue%')))

请注意，当操作者含有like时，我们必须明确指定的通配符（如%和_）的模式。如果参数是从用户的输入，我们也应该使用下面的代码转义特殊字符，以防止他们被当作通配符：

<span>$keyword</span>=<span>$_GET</span>['q'<span>];
</span><span>//</span><span> escape % and _ characters</span>
<span>$keyword</span>=<span>strtr</span>(<span>$keyword</span>, <span>array</span>('%'=>'\%', '_'=>'\_'<span>));
</span><span>$command</span>->where(<span>array</span>('like', 'title', '%'.<span>$keyword</span>.'%'));

andWhere()

<span>function</span> andWhere(<span>$conditions</span>, <span>$params</span>=<span>array</span>())

用 and 的方式添加到WHERE的条件中。此方法的行为几乎是 where() 相同，除了它只是添加条件不能取代它。在 where() 文档中有该方法参数的详细信息。

orWhere()

<span>function</span> orWhere(<span>$conditions</span>, <span>$params</span>=<span>array</span>())

用 or 的方式添加到WHERE的条件中。此方法的行为几乎是 where() 相同，除了它只是添加条件不能取代它。在 where() 文档中有该方法参数的详细信息。

order()

<span>function</span> order(<span>$columns</span>)

order() 方法指定查询的ORDER BY部分。$columns 参数指定列进行排序，这可以是一个包含用逗号分隔列和order的方向（ASC 或 DESC）的字符串，或者一个列和order的方向的数组。列名称可以包含表前缀。该方法将自动引用列名，除非一列包含一些括号（即给出一个 DB 表达式）。

下面是一些例子：

<span>//</span><span> ORDER BY `name`, `id` DESC</span>
order('name, id desc'<span>)
</span><span>//</span><span> ORDER BY `tbl_profile`.`name`, `id` DESC</span>
order(<span>array</span>('tbl_profile.name', 'id desc'))

limit() and offset()

<span>function</span> limit(<span>$limit</span>, <span>$offset</span>=<span>null</span><span>)
</span><span>function</span> offset(<span>$offset</span>)

limit()和offset()方法指定查询的 LIMIT 和 OFFSET 部分。请注意，某些DBMS不支持 LIMIT 和 OFFSET 语法。在这种情况下，查询生成器将改写整个SQL语句来模拟 LIMIT 和 OFFSET 的功能。

下面是一些例子：

<span>//</span><span> LIMIT 10    取前10条</span>
limit(10<span>)
</span><span>//</span><span> LIMIT 10 OFFSET 20    取到第21~30条</span>
limit(10, 20<span>)
</span><span>//</span><span> OFFSET 20    去掉前20条后剩下的数据</span>
offset(20)

join() and its variants

<span>function</span> <span>join</span>(<span>$table</span>, <span>$conditions</span>, <span>$params</span>=<span>array</span><span>())
</span><span>function</span> leftJoin(<span>$table</span>, <span>$conditions</span>, <span>$params</span>=<span>array</span><span>())
</span><span>function</span> rightJoin(<span>$table</span>, <span>$conditions</span>, <span>$params</span>=<span>array</span><span>())
</span><span>function</span> crossJoin(<span>$table</span><span>)
</span><span>function</span> naturalJoin(<span>$table</span>)

join()方法及其变种指定如何与其他表连接，使用内部联接，左外连接，右外部联接，交叉连接，或自然连接。 $table 参数指定要加入哪个表。表名可以包含数据库的前缀和 / 或别名。该方法将引用表名，除非它包含一个插入语，即一个DB表达式或子查询。 $conditions 参数指定连接条件。它的语法与where() 相同。$params 参数指定绑定到整个查询的参数。

值得注意的是，它不像其他的查询生成器方法，每次调用一个join方法都会追加到SQL中。

下面是一些例子：

<span>//</span><span> JOIN `tbl_profile` ON user_id=id</span>
<span>join</span>('tbl_profile', 'user_id=id'<span>)
</span><span>//</span><span> LEFT JOIN `pub`.`tbl_profile` `p` ON p.user_id=id AND type=1</span>
leftJoin('pub.tbl_profile p', 'p.user_id=id AND type=:type', <span>array</span>(':type'=>1))

group()

<span>function</span> group(<span>$columns</span>)

group() 方法指定查询的GROUP BY。 $columns 参数指定列进行分组，它可以是一个用逗号分隔的列的字符串，或者一个列的数组。列名称可以包含表前缀。该方法将自动引用列名，除非一列包含一些括号（即是一个 DB 表达式）。

下面是一些例子：

<span>//</span><span> GROUP BY `name`, `id`</span>
group('name, id'<span>)
</span><span>//</span><span> GROUP BY `tbl_profile`.`name`, `id`</span>
group(<span>array</span>('tbl_profile.name', 'id'))

having()

<span>function</span> having(<span>$conditions</span>, <span>$params</span>=<span>array</span>())

having() 方法指定查询的 HAVING。它的使用方式与 where() 相同。

下面是一些例子：

<span>//</span><span> HAVING id=1 or id=2</span>
having('id=1 or id=2'<span>)
</span><span>//</span><span> HAVING id=1 OR id=2</span>
having(<span>array</span>('or', 'id=1', 'id=2'))

union()

<span>function</span> union(<span>$sql</span>)

union() 方法指定查询 UNION。它使用UNION操作附加到现有的SQL上。调用union()多次将现有的SQL附加多个表。

下面是一些例子：

<span>//</span><span> UNION (select * from tbl_profile)</span>
union('select * from tbl_profile')

执行查询（Executing Queries）

调用上面查询生成器的方法来建立一个查询后，我们可以调用DAO方法数据访问对象执行查询。例如，我们可以调用 CDbCommand::queryRow() 获得连续的结果，或者使用 CDbCommand::queryAll() 立刻得到所有行。

例子：

<span>$users</span> = Yii::app()->db-><span>createCommand()
    </span>->select('*'<span>)
    </span>->from('tbl_user'<span>)
    </span>->queryAll();

检索表（Retrieving SQLs）

除了执行查询生成器的查询，我们也可以获取相应的SQL语句。这可以通过调用 CDbCommand::getText() 获得。

<span>$sql</span> = Yii::app()->db-><span>createCommand()
    </span>->select('*'<span>)
    </span>->from('tbl_user'<span>)
    </span>->text;

如果有任何参数必须绑定到查询的，他们可以通过 CDbCommand::params 的属性绑定。

建立查询的替代语法（Alternative Syntax for Building Queries）

有时，使用方法链来建立一个查询可能不是最佳的选择。Yii的查询生成器允许使用对简单象属性赋值的方式去建立查询。特别是，每个查询生成器的方法都有一个具有相同名称的属性。给属性赋值相当于调用相应的方法。例如，下面两个语句是等价的，假设$command 代表 CDbCommand 对象：

<span>$command</span>->select(<span>array</span>('id', 'username'<span>));
</span><span>$command</span>->select = <span>array</span>('id', 'username');

此外， CDbConnection::createCommand() 方法可以把一个数组作为参数。数组中的键值对将被用来初始化创建的 CDbCommand 实例的属性。这意味着，我们可以使用下面的代码来建立一个查询：

<span>$row</span> = Yii::app()->db->createCommand(<span>array</span><span>(
    </span>'select' => <span>array</span>('id', 'username'),
    'from' => 'tbl_user',
    'where' => 'id=:id',
    'params' => <span>array</span>(':id'=>1),<span>
))</span>->queryRow();

建立多个查询（Building Multiple Queries）

一个 CDbCommand 实例可以重复使用多次建立几个查询。建立一个新的查询之前，需要调用 CDbCommand::reset() 方法以清理前面的查询。例子：

<span>$command</span> = Yii::app()->db-><span>createCommand();
</span><span>$users</span> = <span>$command</span>->select('*')->from('tbl_users')-><span>queryAll();
</span><span>$command</span>-><span>reset</span>();  <span>//</span><span> clean up the previous query</span>
<span>$posts</span> = <span>$command</span>->select('*')->from('tbl_posts')->queryAll();

3. 建立数据操作查询（Building Data Manipulation Queries)

数据操作查询是指SQL语句插入，更新和删除数据库表中的数据。对应于这些查询，查询生成器分别提供了插入，更新和删除的方法。不同于上面介绍 SELECT 的查询方法，这些数据操作查询方法将建立一个完整的SQL语句，并立即执行。

• insert(): 将行插入到表
• update(): 更新表中的数据
• delete(): 从表中删除数据

下面描述了这些数据操作查询方法。

insert()

<span>function</span> insert(<span>$table</span>, <span>$columns</span>)

insert()方法的建立和执行一条 INSERT SQL 语句。 $table 参数指定要插入的表，而键值对数组 $columns 指定要插入的列的值。该方法将转义表名，并且将与绑定参数结合使用。

下面是一个例子：

<span>//</span><span> build and execute the following SQL:
// INSERT INTO `tbl_user` (`name`, `email`) VALUES (:name, :email)</span>
<span>$command</span>->insert('tbl_user', <span>array</span><span>(
    </span>'name'=>'Tester',
    'email'=>'tester@example.com',<span>
));</span>

update()

<span>function</span> update(<span>$table</span>, <span>$columns</span>, <span>$conditions</span>='', <span>$params</span>=<span>array</span>())

update()方法的建立和执行一个SQL更新语句。 $table 参数指定要更新的表； $columns 是键值对的数组，用于指定要更新的列值的；$conditions 和 $params 像where()一样，指定 UPDATE 语句中的 WHERE 子句。该方法将转义表名，并且将与要更新的值的参数结合使用。

下面是一个例子：

<span>//</span><span> build and execute the following SQL:
// UPDATE `tbl_user` SET `name`=:name WHERE id=:id</span>
<span>$command</span>->update('tbl_user', <span>array</span><span>(
    </span>'name'=>'Tester',<span>
)</span>, 'id=:id', <span>array</span>(':id'=>1));

delete()

<span>function</span> delete(<span>$table</span>, <span>$conditions</span>='', <span>$params</span>=<span>array</span>())

delete()方法的建立和执行一个SQL删除语句。 $table 参数指定要删除数据的表；$conditions 和$params像where()一样，指定 DELETE 语句中的 WHERE 子句。该方法将正确转义表名。

下面是一个例子：

<span>//</span><span> build and execute the following SQL:
// DELETE FROM `tbl_user` WHERE id=:id</span>
<span>$command</span>->delete('tbl_user', 'id=:id', <span>array</span>(':id'=>1));

4. 建立架构操作查询（Building Schema Manipulation Queries）

除了正常的数据检索和操作查询，查询生成器提供了一套用于可以操纵数据库的构建和执行SQL查询的方法。它支持以下操作：

• createTable(): 创建一个表
• renameTable(): 重命名表
• dropTable(): 删除一个表
• truncateTable(): 截断一个表，即删除表中的所有数据但不删除表本身
• addColumn(): 给表添加列
• renameColumn(): 重命名表中的列
• alterColumn(): 改变一个表的列
• addForeignKey(): 添加一个外键（自1.1.6可用）
• dropForeignKey(): 删除一个外键（自1.1.6可用）
• dropColumn(): 删除一个表的列
• createIndex(): 创建一个索引
• dropIndex(): 删除一个索引

Info: 虽然在不同的数据库管理系统中SQL语句操作数据库的模式有很大的不同，但查询生成器试图提供一个统一的接口，用于构建这些查询。这简化了数据库迁移从一个数据库管理系统到另一个任务。

抽象数据类型 Abstract Data Types

查询生成器中引入了一组可以在定义表的列中使用抽象数据类型。与物理数据类型不同，物理数据类型有具体独特的DBMS而且在不同的DBMS中有很大的不同，抽象数据类型都是独立的DBMS。当抽象数据类型在定义表的列中使用时，查询生成器将其转换成相应的物理数据类型。

下面的抽象数据类型由查询生成器的支持。

• pk: 一个通用的主键类型，将被转换成 int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY for MySQL;
• string: 字符串类型，将被转换成 varchar(255) for MySQL;
• text: 文本型（长字符串），将被转换成 text for MySQL;
• integer: 整数类型，将被转换成 int(11) for MySQL;
• float: 浮点数类型，将被转换成 float for MySQL;
• decimal: 十进制数类型，将被转换成 decimal for MySQL;
• datetime: datetime类型，将被转换成 datetime for MySQL;
• timestamp: 时间戳类型，将被转换成 timestamp for MySQL;
• time: 时间类型，将被转换成 time for MySQL;
• date: 日期类型，将被转换成 date for MySQL;
• binary: 二进制数据类型，将被转换成 blob for MySQL;
• boolean: 布尔类型，将被转换成 tinyint(1) for MySQL;
• money: 金钱/货币型，将被转换成 decimal(19,4) for MySQL. 自1.1.8版本开始此类型可以使用。

createTable()

<span>function</span> createTable(<span>$table</span>, <span>$columns</span>, <span>$options</span>=<span>null</span>)

createTable() 方法构建和执行一条创建表的SQL语句。$table 参数指定要创建的表的名称。 $columns 参数指定在新表中的列。他们必须被指定为名称类型的键值对(e.g. 'username'=>'string')。 $options 参数指定应附加到生成的SQL上的任何额外的SQL片段。查询生成器将正确的引用的表名以及列名。

当指定一个列的定义时，可以使用如上所述的抽象数据类型。查询生成器会根据当前使用的数据库管理系统的抽象数据类型转换成相应的物理数据类型。例如，string 类型将被转换为MySQL的 varchar(255)。

一个列定义还可以包含非抽象数据类型或规格。他们将没有任何改变的被放置在生成的SQL中。例如，point 不是一个抽象数据类型，如果用在列定义，它会出现在生成的SQL中，而且 string NOT NULL将被转换varchar(255) NOT NULL（即只有抽象类型的字符串转换）。

下面是一个例子，显示了如何创建一个表：

<span>//</span><span> CREATE TABLE `tbl_user` (
//     `id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,
//     `username` varchar(255) NOT NULL,
//     `location` point
// ) ENGINE=InnoDB</span>
createTable('tbl_user', <span>array</span><span>(
    </span>'id' => 'pk',
    'username' => 'string NOT NULL',
    'location' => 'point',<span>
)</span>, 'ENGINE=InnoDB')

renameTable()

<span>function</span> renameTable(<span>$table</span>, <span>$newName</span>)

renameTable() 方法创建和执行一条重命名表名的SQL语句。 $table 参数指定要重命名的表的名称。 $newName 参数指定表的新名称。查询生成器将正确引用的表名。

下面是一个示例，演示了如何重命名表：

<span>//</span><span> RENAME TABLE `tbl_users` TO `tbl_user`</span>
renameTable('tbl_users', 'tbl_user')

dropTable()

<span>function</span> dropTable(<span>$table</span>)

dropTable() 方法创建和执行一条删除表的SQL语句。在$table 参数指定要删除的表的名称。查询生成器会正确地引用的表名。

下面是一个示例展示如何删除一个表：

<span>//</span><span> DROP TABLE `tbl_user`</span>
dropTable('tbl_user')

truncateTable()

<span>function</span> truncateTable(<span>$table</span>)

truncateTable() 方法建立和执行一条清空表数据的SQL语句。 $table 参数指定清空的表名。查询生成器会正确地引用的表名。

下面是一个示例显示如何清空表：

<span>//</span><span> TRUNCATE TABLE `tbl_user`</span>
truncateTable('tbl_user')

addColumn()

<span>function</span> addColumn(<span>$table</span>, <span>$column</span>, <span>$type</span>)

addColumn() 方法创建并执行一条添加一个表的新列的SQL语句。 $table 参数指定新列将被添加到的表的名称。 $column 参数指定新列的名称。 $type 指定新列的定义。列定义中可以包含抽象数据类型，如 "createTable"小节中的描述。查询生成器将正确的引用的表名以及列名。

下面是一个示例，演示如何添加一个表的列：

<span>//</span><span> ALTER TABLE `tbl_user` ADD `email` varchar(255) NOT NULL</span>
addColumn('tbl_user', 'email', 'string NOT NULL')

dropColumn()

<span>function</span> dropColumn(<span>$table</span>, <span>$column</span>)

dropColumn() 方法创建和执行一条删除表列的SQL语句。 $table 参数指定要被删除的列所属的表名。 $column 参数指定要被删除的列名。查询生成器将正确地引用的表名以及列名。

下面是一个示例展示如何删除一个表列：

<span>//</span><span> ALTER TABLE `tbl_user` DROP COLUMN `location`</span>
dropColumn('tbl_user', 'location')

renameColumn()

<span>function</span> renameColumn(<span>$table</span>, <span>$name</span>, <span>$newName</span>)

renameColumn() 方法创建和执行一条重命名列的SQL语句。 $table 参数指定要重命名的列所属的表的名称。 $name 参数指定的旧列名。 $newName 指定新的列名。查询生成器将正确地引用的表名以及列名。

下面是一个示例，展示了如何重命名表列：

<span>//</span><span> ALTER TABLE `tbl_users` CHANGE `name` `username` varchar(255) NOT NULL</span>
renameColumn('tbl_user', 'name', 'username')

alterColumn()

<span>function</span> alterColumn(<span>$table</span>, <span>$column</span>, <span>$type</span>)

alterColumn() 方法创建和执行一条修改表列的SQL语句。 $table 参数指定要被改变的列所属的表的名称。 $column 参数指定被改变的列的名称。$type 指定列的新定义。列定义中可以包含抽象数据类型，如 "createTable"小节中的描述。查询生成器将正确的引用的表名以及列名。

下面是一个示例，展示了如何更改一个表列：

<span>//</span><span> ALTER TABLE `tbl_user` CHANGE `username` `username` varchar(255) NOT NULL</span>
alterColumn('tbl_user', 'username', 'string NOT NULL')

addForeignKey()

<span>function</span> addForeignKey(<span>$name</span>, <span>$table</span>, <span>$columns</span>,
    <span>$refTable</span>, <span>$refColumns</span>, <span>$delete</span>=<span>null</span>, <span>$update</span>=<span>null</span>)

addForeignKey() 方法创建和执行一条添加一个外键约束SQL语句。 $name 参数指定外键的名称。 $table 和 $columns 参数指定外键的表名和列名。如果有多个列，他们应该用逗号字符分隔。 $refTable 和 $refColumns 参数指定表名和列名的外键引用。 $delete 和 $update 参数指定 SQL语句中的 ON DELETE 和ON UPDATE选项。大多数的DBMS都支持这些选项：RESTRICT, CASCADE, NO ACTION, SET DEFAULT, SET NULL. 。查询生成器会正确地引用表名，索引名和列名。

下面是一个示例，演示如何添加一个外键约束：

<span>//</span><span> ALTER TABLE `tbl_profile` ADD CONSTRAINT `fk_profile_user_id`
// FOREIGN KEY (`user_id`) REFERENCES `tbl_user` (`id`)
// ON DELETE CASCADE ON UPDATE CASCADE</span>
addForeignKey('fk_profile_user_id', 'tbl_profile', 'user_id',
    'tbl_user', 'id', 'CASCADE', 'CASCADE')

dropForeignKey()

<span>function</span> dropForeignKey(<span>$name</span>, <span>$table</span>)

dropForeignKey() 方法创建和执行一条删除一个外键约束的SQL语句。 $name 参数指定的要删除的外键约束的名称。 $table 参数指定外键所属的表的名称。查询生成器将正确地引用的表名以及约束名称。

下面是一个示例，显示了如何删除外键约束：

<span>//</span><span> ALTER TABLE `tbl_profile` DROP FOREIGN KEY `fk_profile_user_id`</span>
dropForeignKey('fk_profile_user_id', 'tbl_profile')

createIndex()

<span>function</span> createIndex(<span>$name</span>, <span>$table</span>, <span>$column</span>, <span>$unique</span>=<span>false</span>)

createIndex() 方法构建和执行一条创建索引的SQL语句。 $name 参数指定要创建的索引的名称。$table 参数指定索引所属的表的名称。$column 参数指定要索引的列的名称。 $unique 参数指定是否创建一个唯一索引。如果索引由多个列，则必须用逗号将它们隔开。查询生成器会正确地引用表名，索引名和列名。

下面是一个示例，显示了如何创建索引：

<span>//</span><span> CREATE INDEX `idx_username` ON `tbl_user` (`username`)</span>
createIndex('idx_username', 'tbl_user', 'username')

dropIndex()

<span>function</span> dropIndex(<span>$name</span>, <span>$table</span>)

dropIndex() 方法创建和执行一条删除索引的SQL语句。 $name 参数指定要删除的索引的名称。$table 参数指定索引所属的表的名称。查询生成器将正确地引用的表名以及索引名称。

下面是一个示例，显示了如何删除索引：

<span>//</span><span> DROP INDEX `idx_username` ON `tbl_user`</span>
dropIndex('idx_username', 'tbl_user')

 

终于翻译完了~~~
如有错误或看不懂的地方，欢迎留言~~    

怎启动报表生成器 (Report Builder 30)

ClickOnce 版本可用于本机模式或 SharePoint 集成模式下安装的 Reporting Services。
注意Report Builder 3.0 不能安装在基于 Itanium 64 的计算机中。这适用于 Report Builder 3.0 的 ClickOnce 和独立版本。
若要在本机模式下启动报表生成器 ClickOnce，您可单击报表管理器中的
“报表生成器”
按钮，也可以使用指定的 URL。
若要在 SharePoint 集成模式下启动报表生成器，请单击
“新建文档”菜单上的“报表生成器报表”选项。
还可以使用报表生成器的 ClickOnce 版本来在已发布到 SharePoint 的 PowerPivot for Excel 工作簿上创建报表。有关将报表生成器用于 PowerPivot 的详细信息，请参阅 technet.microsoft.com 上的
Create a Reporting Services Report with PowerPivot Data
（使用 PowerPivot 数据创建 Reporting Services 报表）。
在本地计算机上，从“开始”菜单启动报表生成器独立版本。与 ClickOnce 版本（从报表管理器或 SharePoint 库启动）相比，您或管理员必须直接在您的计算机上安装报表生成器，然后您才能使用该工具。在安装 SQL Server 2008 R2 时未安装独立版本；您必须单独下载并安装它。有关详细信息，请参阅
 

yii查询find

字符串需要加引号。
额，你去yii中文网站加群，在群里面问，知道的回答效率有点低。
 

http://www.bkjia.com/PHPjc/828049.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/828049.htmlTechArticleYii的学习(3)--查询生成器 (Query Builder)，yiibuilder 原文地址： http://www.yiiframework.com/doc/guide/1.1/en/database.query-builder 不过原文是英文的，Yii的官...