mirror of
https://github.com/actix/examples
synced 2024-11-28 00:12:57 +01:00
4dae76da27
Update .env var syntax to use underscores instead of dots, which cause an error difficult to debug if you are not familiar with Confik.
90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
# async_pg example
|
|
|
|
## This example illustrates
|
|
|
|
- `tokio_postgres`
|
|
- use of `tokio_pg_mapper` for postgres data mapping
|
|
- `deadpool_postgres` for connection pooling
|
|
- `dotenv` + `config` for configuration
|
|
|
|
## Instructions
|
|
|
|
### NOTE:
|
|
|
|
You may need to ensure that you are running the commands with the correct SQL user.
|
|
On many Linux distributions you may prefix the shell commands with `sudo -u postgres`
|
|
|
|
1. Create database user
|
|
|
|
```shell
|
|
createuser -P test_user
|
|
```
|
|
|
|
Enter a password of your choice. The following instructions assume you used `testing` as password.
|
|
|
|
This step is **optional** and you can also use an existing database user for that. Just make sure to replace `test_user` by the database user of your choice in the following steps and change the `.env` file containing the configuration accordingly.
|
|
|
|
An alternative using SQL:
|
|
```sql
|
|
CREATE USER test_user WITH PASSWORD 'testing';
|
|
```
|
|
|
|
2. Create database
|
|
|
|
```shell
|
|
createdb -O test_user testing_db
|
|
```
|
|
|
|
An alternative using SQL:
|
|
```sql
|
|
CREATE DATABASE testing_db OWNER test_user;
|
|
```
|
|
|
|
3. Initialize database
|
|
|
|
```shell
|
|
psql -f sql/schema.sql testing_db
|
|
```
|
|
|
|
This step can be repeated and clears the database as it drops and recreates the schema `testing` which is used within the database.
|
|
|
|
4. Grant privileges to new user
|
|
|
|
```sql
|
|
GRANT ALL PRIVILEGES ON SCHEMA testing TO test_user;
|
|
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA testing TO test_user;
|
|
GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA testing TO test_user;
|
|
```
|
|
|
|
5. Create `.env` file:
|
|
|
|
```ini
|
|
SERVER_ADDR=127.0.0.1:8080
|
|
PG__USER=test_user
|
|
PG__PASSWORD=testing
|
|
PG__HOST=127.0.0.1
|
|
PG__PORT=5432
|
|
PG__DBNAME=testing_db
|
|
PG__POOL_MAX_SIZE=16
|
|
```
|
|
|
|
6. Run the server:
|
|
|
|
```shell
|
|
cargo run
|
|
```
|
|
|
|
7. Using a different terminal send an HTTP POST request to the running server:
|
|
|
|
```shell
|
|
echo '{"email": "ferris@thecrab.com", "first_name": "ferris", "last_name": "crab", "username": "ferreal"}' | http -f --json --print h POST http://127.0.0.1:8080/users
|
|
```
|
|
|
|
**...or using curl...**
|
|
|
|
```shell
|
|
curl -i -d '{"email": "ferris@thecrab.com", "first_name": "ferris", "last_name": "crab", "username": "ferreal"}' -H 'Content-Type: application/json' http://127.0.0.1:8080/users
|
|
```
|
|
|
|
A unique constraint exists for username, so sending this request twice will return an internal server error (HTTP 500).
|