可以操作pgsql、mysql、mssql、sqlite
异步的,性能应该不错,具体使用有几个坑
除了sqlx库,还有对于具体数据库的库,比如postgres库
演示以pgsql为例,更新时间2024.1.6
官方github: sqlx github
rust官方文档:rust sqlx库文档
一、项目配置
1.添加依赖
cargo.toml的[dependencies]
sqlx依赖tokio的异步运行时,或者async-std的运行时,所以要加上
sqlx = { version = "0.7.3",features = ["postgres", "runtime-async-std"] }# 下面二选一了tokio = {version = "1.35.1",features = ["full"]}async-std = { version = "1.12.0" }
2.引入模块
根据需要引入,通常
use sqlx;
3.函数运行时
#[tokio::main]fn xxx(){}
二、数据库连接和sql操作
更多的操作看官方文档。
以pgsql为例,mysql等其他数据库需要调整函数
1.数据库连接(连接池)
sqlx库自带连接池,这样可以省去在数据库外再布置连接池
这里封装成函数使用,作为一个pub函数,调用的函数用运行时即可,注意修改数据库账号密码
/// pgsql连接pub async fn pgsql_conn() -> sqlx::Pool<Postgres> {returnPgPoolOptions::new().max_connections(10).connect("postgres://username:password@192.168.x.x:5432/datebase_name").await.unwrap();}
注意:如果是默认的,账号名密码和数据库都是postgres
调用时(注意是异步的)
let pg_conn=crate::xxx::pgsql_conn().await;
2.执行sql
封装好的函数,执行sql(适用于pgsql)
/// pgsql的sql执行/// @param database_conn 数据库连接/// @param sql 执行的sqlpub async fn pgsql_sql_execute(database_conn: sqlx::PgPool,sql:&str) -> Vec<sqlx::postgres::PgRow> {return sqlx::query(&sql).fetch_all(&database_conn).await.unwrap();}
调用时(注意xxx改为自己的目录)
let pg_conn=crate::xxx::pgsql_conn().await;let sql="select * from xxx limit 10";let reses=crate::xxx::pgsql_sql_execute(pg_conn,sql).await;// 迭代每行,假设这个表有一个"id"的字段for res in reses{let column: i32 = res.get("id");println!("{}",column);}
三、错误及解决
1.either the runtime-async-std
or runtime-tokio
feature must be enabled
这个问题出在sqlx的依赖(当初这个迷惑了一段时间),同时需要
在crago的[dependencies]里面:
或者
同时需要函数的异步运行时
当然,有好几个可以用,可以参考github的说明,有多个运行时可以选取