src/man7/update.7

   1 .\\" auto-generated by docbook2man-spec $Revision: 1.1 $
   2 .TH "UPDATE" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
   3 .SH NAME
   4 UPDATE \- 更新一个表中的行
   5
   6 .SH SYNOPSIS
   7 .sp
   8 .nf
   9 UPDATE [ ONLY ] \fItable\fR SET \fIcolumn\fR = { \fIexpression\fR | DEFAULT } [, ...]
  10     [ FROM \fIfromlist\fR ]
  11     [ WHERE \fIcondition\fR ]
  12 .sp
  13 .fi
  14 .SH "DESCRIPTION 描述"
  15 .PP
  16 \fBUPDATE\fR 改变满足条件的所有行的声明了的列/字段的值。 只有要更改的列/字段需要在语句中出现，没有明确的 SET 的字段保持它们原来的数值。
  17 .PP
  18  缺省时，UPDATE 将更新所声明的表和所有子表的记录。 如果你希望只更新所声明的表，你应该使用 ONLY 子句。
  19 .PP
  20  要更改表，你必须对它有UPDATE 权限， 同样对 expression 或者 condition 条件里提到的任何表也要有SELECT权限。
  21 .SH "PARAMETERS 参数"
  22 .TP
  23 \fB\fItable\fB\fR
  24  现存表的名称（可以有模式修饰）。
  25 .TP
  26 \fB\fIcolumn\fB\fR
  27  表 table 中列/字段的名。
  28 .TP
  29 \fB\fIexpression\fB\fR
  30  赋予列/字段的一个有效的值或表达式。表达式可以使用表中这个或其它字段的旧数值。
  31 .TP
  32 \fBDEFAULT\fR
  33  把字段设置为它的缺省值（如果没有缺省表达式赋予它，那么就是 NULL）。
  34 .TP
  35 \fB\fIfromlist\fB\fR
  36  一个表达式的列表，允许来自其它表中的列/字段出现在 WHERE 条件里。
  37 .TP
  38 \fB\fIcondition\fB\fR
  39  一个表达式，返回 boolean 类型。只有这个表达式返回 true 的行被更新。
  40 .SH "OUTPUTS 输出"
  41 .PP
  42  成功完成后，UPDATE 命令返回形如
  43 .sp
  44 .nf
  45 UPDATE \fIcount\fR
  46 .sp
  47 .fi
  48  的命令标签。count 是更新的行数。 如果 count 是 0， 那么没有符合 condition 的行（这个不认为是错误）。
  49 .SH "EXAMPLES 例子"
  50 .PP
  51  把表 films 里的字段 kind 里的词 Drama 用Dramatic 代替：
  52 .sp
  53 .nf
  54 UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama';
  55 .sp
  56 .fi
  57 .PP
  58  调整表 weather 中的一行的温度记录并且把降水设置为缺省值：
  59 .sp
  60 .nf
  61 UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT
  62   WHERE city = 'San Francisco' AND date = '2003-07-03';
  63 .sp
  64 .fi
  65 .SH "COMPATIBILITY 兼容性"
  66 .PP
  67  这条命令遵循 SQL 标准。FROM 子句是 PostgreSQL 扩展。
  68 .SH "译者"
  69 .B Postgresql 中文网站
  70 .B 何伟平 <laser@pgsqldb.org>