FarelDB 关系数据库命令 数据库操作类(database) 之 Update
用于修改二维表中指定的某1列或多列数据。可修改二维表中符合where条件的0行或多行数据;
语法
update [数据库名.]二维表名 set 列名1=值1,列名2=值2,…n [where where条件子句] |
---|
特别提醒:请注意 SQLUpdate 语句中的 where条件子句!
where条件子句规定哪条记录或者哪些记录需要更新。如果您省略了 where 关键字和where条件子句,则所有的记录都将被更新修改!
下面是一个更新student表数据的例子。
返回值
成功返回大于0的操作影响数 ,失败则返回 错误原因 。
命令实例
打开一个命令行窗口,启动FarelDB服务端,再打开一个命令行窗口,启动FarelDB客户端,输入以下命令:
//更新student表中奖学金为2000元,条件是成绩大于500 并且年龄在40到60岁之间的数据记录
FarelDb 10.7.6.209:6800 >update studentDB.Student set Scholarship=2000 where (score >500) and (age >40 and age <60)
success, affected count: 4
API 说明
函数原型
FarelDbRes* query(std::string Command) |
---|
输入参数说明
输入参数 | 描述 | 可选 |
---|---|---|
Command | 符合语法的命令字符串 | 否 |
返回参数说明
调用成功返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbRes->errorInfos.size() | 0 | 调用成功,无错误信息 |
调用异常返回
返回参数 | 值 | 含义 |
---|---|---|
FarelDbRes->errorInfos.size() | 大于0 | 调用失败,errorInfos对象数组包含1个或多个错误信息 |
FarelDbRes->errorInfos[0]->resCode | 大于0的数值 | 调用失败,返回错误代码 |
FarelDbRes->errorInfos[0]->resInfo | 非空字符串 | 调用失败,返回错误信息字符串 |
返回数据获取方法
FarelDbRes* query(std::string Command)接口调用成功后,接口将根据不同种类的Sql语句返回不同的结果,具体不同Sql语句返回结果的获取方法,请参考下面的样例代码。
样例代码
#include <iostream>
#include <functional>
#include <memory>
#include "fareldb_connection.h"
using namespace std;
using namespace fareldb_connection;
int main(int argc,char *argv[])
{
//创建连接
FarelDbConnection conn;
//连接
std::tuple<int, string> resConn = conn.connect("127.0.0.1", 6800, "root", "root");
//连接失败
if (0 != get<0>(resConn))
{
printf("连接失败,错误代码:%d : 错误信息:%s\n", get<0>(resConn), get<1>(resConn).c_str());
return;
}
//连接成功,可以开始进行后续操作
string Command = u8"update studentDB.student set ID=1,Name='Tom',Age=20,Gender=0,Enrollment_Date=0,Score=200.3,Scholarship=2000.2,Note='come from AMD' where ID=0";
//执行命令'Alex',19,1, 1598889600000,98.12,1000.1,'Come from New England region '
std::shared_ptr<FarelDbRes> res(conn.query(Command));
//判断执行命令返回是否失败
if (res->errorInfos.size() > 0)
{
printf("%s 调用失败,错误代码:%d ; 错误信息: %s \n\n", Command.c_str(), res->errorInfos[0]->resCode, res->errorInfos[0]->resInfo.c_str());
return;
}
printf("%s 调用成功 \n\n", Command.c_str());
}
补充说明
1. where条件子句说明:
1). 支持等值条件 where 条件列=值 语句
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID = 1;
success, affected count: 1
2). 支持多值条件 where 条件列 in (值1,值2,…n) 语句
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID in (1,2,3) and (name in ('Alix','Tom'));
success, affected count: 3
3). 支持多个条件间的逻辑条件 and 和 or 语句
and运算符用于将两个或多个条件组合起来,只有当所有条件都满足时,结果才为真。Or运算符用于将两个或多个条件组合起来,只要有一个条件满足,结果就为真。
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where (ID = 1) and (score >450 or score < 500)
success, affected count: 1
4). 支持单个条件的逻辑条件 :
a) 不等于: < >
b) 大于 : >
c) 小于 : <
d)大于等于: >=
e)小于等于: <=
f) 不等于: ! =
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID <> 1
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score > 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score < 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score >= 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where score <= 300
success, affected count: 1
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where ID != 1
success, affected count: 1
逻辑条件优先级:逻辑运算的优先级只是决定了表达式的结合次序,而不是运算顺序,因此请对复杂的逻辑运算需要用括号对表达式进行显示组合。例如:
//查询 成绩大于500 并且年龄在40到60岁之间的数据集
FarelDb 10.7.6.209:6800 >delete from studentDB.Student where (score >500) and (age >40 or age <60)
success, affected count: 1
2. 语法符号说明:
- 方括号 [ ]
方括号 ( [ ] ) 表示里面的元素(参数、值或信息)是可选的。 您可以选择一个或多个条目,也可以不选。 不要将方括号本身也输入到命令行中。 - 尖括号 < >
尖括号 ( < > ) 表示里面的元素(参数、值或信息)是必需的。 您需要用相应的信息来替换尖括号里面的文本。 不要将尖括号本身也输入到命令行中。 - [ ,…n ] 表示前面的项可重复 n 次。每一项由逗号分隔。
- [ …n ] 表示前面的项可重复 n 次。每一项由空格分隔。
- | (竖线) 分隔括号或大括号内的语法项目。只能选择一个项目。