Rust 連線 PostgreSQL 資料庫

這次，我們使用 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 函式裡依次呼叫這些函式，並把查詢結果列印出來：

 

結果如下：

 

 

全部程式碼如下： 

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(())
}