执行SQL - ExecuteSql
函数简介
执行指定的SQL语句,通常用于执行更新(UPDATE)、插入(INSERT)或删除(DELETE)操作。返回操作结果。
函数原型
int ExecuteSql(long ola, const long db, string sql);
参数定义
ola
(长整型数): OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。db
(长整型数): 数据库连接句柄,由 OpenDatabase 接口生成。sql
(字符串): 要执行的SQL语句。
返回值
- 返回值:操作结果。成功返回
1
,失败返回0
。
示例
SDK
C#
using System;
using OLA.ServiceCenter.PlugFactory;
namespace OLADemo
{
internal class Program
{
static OLAPlugServer OLAServer;
static void Main(string[] args)
{
OLAServer = new OLAPlugServer();
var regResult = OLAServer.Reg(
OLAServer.UserCode,
OLAServer.SoftCode,
OLAServer.FeatureList
);
OLAServer.CreateCOLAPlugInterFace();
long db = OLAServer.OpenDatabase("OLAPlugDemo.db", "olaplug");
Console.WriteLine($"OpenDatabase 返回:{db}");
// 执行SQL语句(插入操作)
string sql = "INSERT INTO MyTable (Column1, Column2) VALUES ('Value1', 'Value2')";
int result = OLAServer.ExecuteSql(db, sql);
if (result == 1)
{
Console.WriteLine("SQL执行成功。");
}
else
{
Console.WriteLine("SQL执行失败。");
}
}
}
}
Python
from OLAPlugServer import OLAPlugServer
# 实例化
OLAServer = OLAPlugServer()
# 注册
OLAServer.Reg(OLAServer.UserCode, OLAServer.SoftCode, OLAServer.FeatureList)
# 创建OLAPlug对象
OLAServer.CreateCOLAPlugInterFace()
# 打开数据库
db = OLAServer.OpenDatabase('OLAPlug.db', 'OLAPlug')
print(f"openDatabaseResult={db}")
# 执行SQL语句(插入操作)
sql = "INSERT INTO MyTable (Column1, Column2) VALUES ('Value1', 'Value2')"
result = OLAServer.ExecuteSql(db, sql)
if result == 1:
print("SQL执行成功。")
else:
print("SQL执行失败。")
原生方式
Python
import os
import sys
from ctypes import *
# 1. 加载dll
# 此处路径为插件所在路径,请根据实际情况修改。
# 32位python使用x86版本,64位python使用x64版本
if sys.maxsize > 2**32:
olaplug_dll = WinDLL(os.path.abspath(os.path.join(os.getcwd(), 'OLAPlug_x64.dll')))
else:
olaplug_dll = WinDLL(os.path.abspath(os.path.join(os.getcwd(), 'OLAPlug_x86.dll')))
# 2. 注册到后台
UserCode = "c38e200f116d4fa8bd0deb45ccb523ea"
SoftCode = "701bc92ba84642c68845e7a06c10fd99"
FeatureList = "OLA|OLAPlus"
olaplug_dll.Reg.argtypes = [c_char_p, c_char_p, c_char_p]
olaplug_dll.Reg.restype = c_int32
result = olaplug_dll.Reg(UserCode.encode('utf-8'), SoftCode.encode('utf-8'), FeatureList.encode('utf-8'))
print(f'注册结果返回: {result}')
# 3. 创建ola对象
olaplug_dll.CreateCOLAPlugInterFace.restype = c_void_p
ola_obj = olaplug_dll.CreateCOLAPlugInterFace()
# 4. 打开数据库
olaplug_dll.OpenDatabase.argtypes = [c_void_p, c_char_p, c_char_p]
olaplug_dll.OpenDatabase.restype = c_void_p
db = olaplug_dll.OpenDatabase(ola_obj, "OLAPlugDemo.db".encode('utf-8'), "olaplug".encode('utf-8'))
print(f"openDatabaseResult={db}")
# 5. 执行SQL语句(插入操作)
sql = "INSERT INTO MyTable (Column1, Column2) VALUES ('Value1', 'Value2')"
olaplug_dll.ExecuteSql.argtypes = [c_void_p, c_void_p, c_char_p]
olaplug_dll.ExecuteSql.restype = c_int32
result = olaplug_dll.ExecuteSql(ola_obj, db, sql.encode('utf-8'))
if result == 1:
print("SQL执行成功。")
else:
print("SQL执行失败。")
注意事项
- 该函数适用于执行不返回结果集的SQL语句,如
INSERT
、UPDATE
、DELETE
等。 - 如果SQL语句执行失败,函数将返回
0
,可以通过 GetDatabaseError 函数获取详细的错误信息。 - 确保传入的SQL语句语法正确,且表名和列名存在,否则可能导致执行失败。