这次,我们使用 postgres 这个 crate 来连接和操作 PostgreSQL 数据库。
创建好项目后,在 cargo.toml 里添加 postgres 的依赖:
首先,导入相关的类型,并创建一个 Person struct:
再创建 create_db 函数,用来创建数据库和表,它返回一个 Result,里面可能是 Client 或错误:
注意,Client::connect() 函数所接受的连接字符串可以是两种形式的:
- Key-Value 形式。例如:Client::connect("host=localhost user=postgres", NoTls)?; 具体的 key 需要查阅官方文档。
- URL 形式。本例中使用的是 URL 形式。
一个相对完整的数据库连接字符串 URL 格式是:
postgres://username[:password]@host[:port][/database],其中 password、port、database 都是可选的。所以上面代码中做了相应的判断处理。
Client::connect() 函数的第二个参数用的是 NoTls,为了简单起见,这里我们不使用 TLS。
第 30、32 行,使用 Client 的 execute 方法先删除数据表(如果存在的话),然后再创建 person 表。
最后返回 Client。
接下来,创建 insert_data 函数,来插入一些数据:
注意该函数的参数 Client 必须是 mut 的。
再创建一个查询数据的函数:
这里,我们直接对 Client 的 query 方法返回的结果进行遍历,最后方法返回一个 Vec。
最后,在 main 函数里依次调用这些函数,并把查询结果打印出来:
结果如下:
全部代码如下:
代码语言:javascript复制use postgres::{error::Error, Client, NoTls};
#[derive(Debug)]
struct Person {
id: i32,
name: String,
data: Option<Vec<u8>>,
}
fn create_db() -> Result<Client, Error> {
let username = "postgres";
let password = "postgres";
let host = "localhost";
let port = "5432";
let database = "rust2021";
let conn_str = &format!(
"postgres://{}{}{}@{}{}{}{}{}",
username,
if password.is_empty() { "" } else { ":" },
password,
host,
if port.is_empty() { "" } else { ":" },
port,
if database.is_empty() { "" } else { "/" },
database
);
let mut client = Client::connect(conn_str, NoTls)?;
let _ = client.execute("DROP TABLE person", &[]);
client.execute(
"CREATE TABLE person (
id SERIAL PRIMARY KEY,
name TEXT NOT NULL,
data BYTEA
)",
&[],
)?;
Ok(client)
}
fn insert_data(client: &mut Client) -> Result<(), Error> {
let p1 = Person {
id: 1,
name: "Dave".to_string(),
data: None,
};
let p2 = Person {
id: 2,
name: "Nick".to_string(),
data: None,
};
client.execute(
"INSERT INTO person (id, name, data)
VALUES ($1, $2, $3),
($4, $5, $6)",
&[&p1.id, &p1.name, &p1.data, &p2.id, &p2.name, &p2.data],
)?;
Ok(())
}
fn get_data(client: &mut Client) -> Result<Vec<Person>, Error> {
let mut persons = Vec::new();
for row in client.query("SELECT id, name, data FROM person", &[])? {
persons.push(Person {
id: row.get(0),
name: row.get(1),
data: row.get(2),
});
}
Ok(persons)
}
fn main() -> Result<(), Error> {
let mut client = create_db()?;
insert_data(&mut client)?;
let persons = get_data(&mut client)?;
for p in persons {
println!("Person: {:?}", p);
}
Ok(())
}