Diesel ORM 安装和配置指南

柳诚跃Lorena

于 2024-09-13 22:17:43 发布

阅读量477

点赞数 5

本文链接：https://blog.csdn.net/gitblog_09572/article/details/142230274

版权

Diesel ORM 安装和配置指南

diesel diesel-rs/diesel: 是一个基于 Rust 的 ORM 库，支持 PostgreSQL 和 SQLite 数据库。适合对 Rust、数据库开发以及想要使用 Rust ORM 的开发者。项目地址: https://gitcode.com/gh_mirrors/di/diesel

1. 项目基础介绍和主要编程语言

项目介绍

Diesel 是一个安全、可扩展的 Rust 语言的 ORM（对象关系映射）和查询构建器。它旨在消除数据库交互的样板代码，并在不牺牲性能的情况下消除运行时错误。Diesel 充分利用了 Rust 的类型系统，创建了一个低开销的查询构建器，使得数据库操作“感觉像 Rust”。

主要编程语言

Diesel 主要使用 Rust 编程语言开发。

2. 项目使用的关键技术和框架

关键技术

Rust: 作为主要的编程语言，提供高性能和内存安全。
ORM: 对象关系映射，简化数据库操作。
Query Builder: 构建复杂的 SQL 查询。

支持的数据库

Diesel 支持以下数据库：

PostgreSQL
MySQL
SQLite

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

安装 Rust: 如果你还没有安装 Rust，可以通过以下命令安装：
```
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
安装数据库: 根据你的需求安装相应的数据库（PostgreSQL、MySQL 或 SQLite）。

详细安装步骤

1. 创建一个新的 Rust 项目

首先，创建一个新的 Rust 项目：

cargo new my_diesel_app
cd my_diesel_app

2. 添加 Diesel 依赖

在 Cargo.toml 文件中添加 Diesel 依赖：

[dependencies]
diesel = { version = "2.0.0", features = ["postgres"] } # 根据需要选择 postgres, mysql 或 sqlite
dotenvy = "0.15.0"

3. 配置环境变量

在项目根目录下创建一个 .env 文件，并添加数据库连接信息：

DATABASE_URL=postgres://username:password@localhost/diesel_test

4. 安装 Diesel CLI

安装 Diesel CLI 工具，用于管理数据库迁移：

cargo install diesel_cli --no-default-features --features postgres

5. 初始化 Diesel

在项目根目录下运行以下命令，初始化 Diesel：

diesel setup

6. 创建数据库迁移

创建一个新的数据库迁移文件：

diesel migration generate create_users

在生成的迁移文件中编写 SQL 语句，例如：

-- migrations/2023-10-01-000000_create_users/up.sql
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR NOT NULL,
    email VARCHAR NOT NULL
);

-- migrations/2023-10-01-000000_create_users/down.sql
DROP TABLE users;

7. 运行数据库迁移

运行迁移以创建表：

diesel migration run

8. 编写 Rust 代码

在 src/main.rs 中编写 Rust 代码，使用 Diesel 进行数据库操作：

#[macro_use]
extern crate diesel;
extern crate dotenvy;

use diesel::prelude::*;
use diesel::pg::PgConnection;
use dotenvy::dotenv;
use std::env;

fn establish_connection() -> PgConnection {
    dotenv().ok();

    let database_url = env::var("DATABASE_URL").expect("DATABASE_URL must be set");
    PgConnection::establish(&database_url).expect(&format!("Error connecting to {}", database_url))
}

fn main() {
    let connection = establish_connection();
    println!("Connected to the database!");
}