以编程方式修改的表的结构。
语法
ALTER TABLE TableName1
ADD | ALTER [COLUMN] FieldName1
FieldType [(nFieldWidth [, nPrecision])]
[NULL | NOT NULL]
[CHECK lExpression1 [ERROR cMessageText1]]
[DEFAULT eExpression1]
[PRIMARY KEY | UNIQUE]
[REFERENCES TableName2 [TAG TagName1]]
[NOCPTRANS]
- Or -
ALTER TABLE TableName1
ALTER [COLUMN] FieldName2
[NULL | NOT NULL]
[SET DEFAULT eExpression2]
[SET CHECK lExpression2 [ERROR cMessageText2]]
[DROP DEFAULT]
[DROP CHECK]
- Or -
ALTER TABLE TableName1
[DROP [COLUMN] FieldName3]
[SET CHECK lExpression3 [ERROR cMessageText3]]
[DROP CHECK]
[ADD PRIMARY KEY eExpression3 TAG TagName2]
[DROP PRIMARY KEY]
[ADD UNIQUE eExpression4 [TAG TagName3]]
[DROP UNIQUE TAG TagName4]
[ADD FOREIGN KEY [eExpression5] TAG TagName4
REFERENCES TableName2 [TAG TagName5]]
[DROP FOREIGN KEY TAG TagName6 [SAVE]]
[RENAME COLUMN FieldName4 TO FieldName5]
[NOVALIDATE]
参数
TableName1
指定修改其结构的表的名称。
添加 [COLUMN] FieldName1
指定要添加的字段的名称。
ALTER [COLUMN] FieldName1
指定要修改现有字段的名称。
FieldType [( nFieldWidth [, nPrecision]])
为新的或修改字段中指定的字段类型、 字段宽度和字段精度 (数字的小数位数)。
FieldType是指示该字段的一个单一字母数据类型。 某些字段数据类型需要您指定nFieldWidth或nPrecision和 / 或。
nFieldWidth并nPrecision忽略 D、 G、 我、 L、 M、 P、 T 和 Y 的类型。 默认情况下nPrecision为零 (没有小数位),如果nPrecision则不包含 B、 F 或 N 类型。
NULL | NOT NULL
允许或阻止的字段中的 null 值。
如果省略 NULL 和 NOT NULL,NULL 设置的当前设置确定字段中是否允许 null 值。 但是,如果你省略 NULL 和 NOT NULL 并且包括在主键或唯一的子句,忽略 SET NULL 的当前设置,该字段不是默认情况下为 NULL。
检查lExpression1
指定字段的验证规则。 lExpression1必须计算为逻辑表达式,而且可以是用户定义函数或存储的过程。 只要附加一个空记录,检查验证规则。 如果验证规则不允许空字段值在追加的记录中,将生成错误。
错误cMessageText1
指定当字段验证规则将生成错误时显示错误消息。
默认eExpression1
指定字段的默认值。 数据类型eExpression1必须为该字段的数据类型相同。
PRIMARY KEY
创建主索引标记。 索引标记与该字段具有相同的名称。
UNIQUE
创建具有相同名称的字段的候选索引标记。
Note:
候选索引 (包括用于 ALTER TABLE 或 CREATE TABLE 中的 ANSI 兼容性的唯一选项创建) 不同于创建索引命令中使用的唯一选项的索引。 创建索引命令中使用 UNIQUE 索引允许重复的索引键;候选索引不允许有重复的索引键。
在主键或候选索引使用的字段中不允许 null 值和重复的记录。
如果使用添加列创建一个新字段,Visual FoxPro 将不会生成错误,如果创建主键或候选索引支持 null 值的字段。 但是,Visual FoxPro 将生成错误,如果你尝试使用主键或候选索引的字段中输入空值或重复值。
如果您正在修改现有字段,并且或者候选索引表达式组成的表中的字段,Visual FoxPro 会检查以查看它们是否包含 null 值或重复的记录的字段。 如果是这样,Visual FoxPro 生成错误,并不更改表。
引用TableName2标记TagName1
指定与之建立持久关系的父表。 标记TagName1指定关系所基于的父表的索引标记。 索引的标记名称可包含最多 10 个字符。
NOCPTRANS
可以防止转换到字符和备注字段的不同代码页。 如果表转换为另一个代码页,将不转换为其指定 NOCPTRANS 的字段。 可以仅为字符和备注字段指定 NOCPTRANS。
以下示例创建名为 mytable,其中包含两个字符字段和两个备注字段的表。 第二个字符字段、 char2 和第二个备注字段,memo2,包括 NOCPTRANS 以防止转换。
CREATE TABLE mytable (char1 C(10), char2 C(10) NOCPTRANS,;
memo1 M, memo2 M NOCPTRANS)
ALTER [COLUMN] FieldName2
指定要修改现有字段的名称。
设置默认值eExpression2
指定现有字段的新默认值。 数据类型eExpression2必须为该字段的数据类型相同。
集检查lExpression2
指定的新的验证规则的现有字段。 lExpression2计算结果必须为逻辑表达式,可能是用户定义函数或存储的过程。
错误cMessageText2
指定当字段验证规则将生成错误时显示错误消息。 仅当浏览或编辑窗口中更改数据时,会显示消息。
DROP DEFAULT
删除现有字段的默认值。
删除检查
删除现有字段的验证规则。
拖放 [COLUMN] FieldName3
指定要从表中删除的字段。 从表中删除字段还会删除该字段的默认值设置和字段验证规则。
如果索引键或触发器表达式引用该字段,这些表达式无效时将删除的字段。 在这种情况下,将删除的字段但无效索引键或触发器表达式将在运行时生成错误时将不会生成错误。
集检查lExpression3
指定表验证规则。 lExpression3计算结果必须为逻辑表达式,可能是用户定义函数或存储的过程。
错误cMessageText3
指定的错误消息显示时表验证规则将生成错误。 仅当浏览或编辑窗口中更改数据时,会显示消息。
删除检查
删除表的验证规则。
添加主键eExpression3标记TagName2
向表中添加主索引。 eExpression3指定主索引键表达式,并TagName2指定主索引标记的名称。 索引的标记名称可包含最多 10 个字符。 如果标记TagName2省略和eExpression3是单个字段中,主索引标记中指定的字段作为具有相同的名称eExpression3。
删除主键
删除主索引和相应索引的标记。 因为一个表只能有一个主键,不需要指定为主键的名称。 删除主索引也会删除任何基于主键的永久关系。
添加 UNIQUE eExpression4[标记TagName3]
向表中添加一个候选项的索引。 eExpression4指定候选索引键的表达式,并TagName3指定候选索引标记的名称。 索引的标记名称可包含最多 10 个字符。 如果省略标记TagName3 ; 如果eExpression4是单个字段,候选索引标记中指定的字段作为具有相同的名称eExpression4。
删除唯一标记TagName4
删除候选索引和相应索引的标记。 因为一个表可以包含多个候选键,必须指定候选索引标记的名称。
添加外键 [ eExpression5] 标记TagName4
向表中添加外 (非主键) 索引。 eExpression5指定外索引键表达式,并TagName4指定外索引标记的名称。 索引的标记名称可包含最多 10 个字符。
引用TableName2[标记TagName5]
指定与之建立持久关系的父表。 包含标记TagName5建立基于现有索引标记为父表的关系。 索引的标记名称可包含最多 10 个字符。 如果省略标记TagName5,使用父表的主索引标记建立关系。
删除外键标记TagName6[保存]
删除其索引标记是外键TagName6。 如果省略保存,从结构化索引中删除索引标记。 包含保存防止删除从结构化索引的索引标记。
重命名列FieldName4TO FieldName5
可以更改表中字段的名称。 FieldName4指定重命名字段的名称。 FieldName5指定字段的新名称。
Caution:
重命名表的字段,因为索引表达式、 字段和表验证规则、 命令和函数可能引用原始字段名称时应格外小心。
NOVALIDATE
指定 Visual FoxPro 允许要对表; 的结构进行更改这些更改可能会违反表中的数据的完整性。 默认情况下,Visual FoxPro 阻止进行更改违反的表中的数据完整性的 ALTER TABLE。 包括 NOVALIDATE 重写此默认行为。
备注
ALTER TABLE 可以用于修改尚未添加到数据库的表的结构。 但是,如果包括默认、 外键、 主键、 引用,或修改可用的表时设置子句 Visual FoxPro 将生成错误。
ALTER TABLE 可能会重新生成表创建一个新的表头和将记录追加到表标头。 例如,更改字段的类型或宽度,这种情况可能会导致要重新生成的表。
重新生成表后,字段验证规则执行的任何更改其类型或宽度的字段。 如果更改类型或表中的任何字段的宽度,则执行表规则。
如果修改字段或表的表的已记录的验证规则,Visual FoxPro 测试对现有数据的新字段或表验证规则,并发出上第一个匹配项的字段或表的验证规则或触发器冲突的警告。
如果您修改的表是在数据库中,ALTER TABLE-SQL 需要独占使用的数据库。 若要打开用于独占使用的数据库,请打开数据库中包括排他。
请参阅
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
