* `sql_app/__init__.py`：这是一个空文件。

* `sql_app/database.py`：

```Python
{!../../../docs_src/sql_databases/sql_app/database.py!}
```

* `sql_app/models.py`:

```Python
{!../../../docs_src/sql_databases/sql_app/models.py!}
```

* `sql_app/schemas.py`:

=== "Python 3.10+"

    ```Python
    {!> ../../../docs_src/sql_databases/sql_app_py310/schemas.py!}
    ```

## 🗄 🗄 🦲

🔜, 🚫 💸 🙋 🎂, 🕴 🗄:

```Python hl_lines="3-5"
{!../../../docs_src/nosql_databases/tutorial001.py!}
```

## 🔬 📉 ⚙️ "📄 🆎"

👥 🔜 ⚙️ ⚫️ ⏪ 🔧 🏑 `type` 👆 📄.

👉 🚫 ✔ 🗄, ✋️ 👍 💡 👈 🔜 ℹ 👆 ⏮️.

```Python hl_lines="9"
{!../../../docs_src/nosql_databases/tutorial001.py!}
```

## 🚮 🔢 🤚 `Bucket`

**🗄**, 🥡 ⚒ 📄, 👈 💪 🎏 🆎.

👫 🛎 🌐 🔗 🎏 🈸.

* `sql_app/__init__.py`: 🛁 📁.

* `sql_app/database.py`:

```Python
{!../../../docs_src/sql_databases/sql_app/database.py!}
```

* `sql_app/models.py`:

```Python
{!../../../docs_src/sql_databases/sql_app/models.py!}
```

* `sql_app/schemas.py`:

=== "🐍 3️⃣.6️⃣ & 🔛"

    ```Python
    {!> ../../../docs_src/sql_databases/sql_app/schemas.py!}
    ```

Let's refer to the file `sql_app/database.py`.

### Import the SQLAlchemy parts

```Python hl_lines="1-3"
{!../../../docs_src/sql_databases/sql_app/database.py!}
```

### Create a database URL for SQLAlchemy

```Python hl_lines="5-6"
{!../../../docs_src/sql_databases/sql_app/database.py!}
```

In this example, we are "connecting" to a SQLite database (opening a file with the SQLite database).

リレーショナルデータベースの世界でいう"database"(データベースサーバではなく特定のdatabase)と類似しています。

**MongoDB** で例えると"collection"と似た概念です。

次のコードでは主に `Bucket` を利用してCouchbaseを操作します。

この関数では以下の処理を行います:

* **Couchbase** クラスタ(1台の場合もあるでしょう)に接続
    * タイムアウトのデフォルト値を設定
* クラスタで認証を取得
* `Bucket` インスタンスを取得
    * タイムアウトのデフォルト値を設定
* 作成した`Bucket`インスタンスを返却

```Python hl_lines="12-21"
{!../../../docs_src/nosql_databases/tutorial001.py!}
```

* ✍ `DATABASE_URL`.
* ✍ `database` 🎚.

```Python hl_lines="3  9  12"
{!../../../docs_src/async_sql_databases/tutorial001.py!}
```

!!! tip
    🚥 👆 🔗 🎏 💽 (✅ ✳), 👆 🔜 💪 🔀 `DATABASE_URL`.

## ✍ 🏓

👉 💼, 👥 🏗 🏓 🎏 🐍 📁, ✋️ 🏭, 👆 🔜 🎲 💚 ✍ 👫 ⏮️ ⚗, 🛠️ ⏮️ 🛠️, ♒️.

📥, 👉 📄 🔜 🏃 🔗, ▶️️ ⏭ ▶️ 👆 **FastAPI** 🈸.

* ✍ `engine`.
* ✍ 🌐 🏓 ⚪️➡️ `metadata` 🎚.

```Python hl_lines="25-28"

* `sql_app/__init__.py`: is an empty file.

* `sql_app/database.py`:

```Python
{!../../../docs_src/sql_databases_peewee/sql_app/database.py!}
```

* `sql_app/models.py`:

```Python
{!../../../docs_src/sql_databases_peewee/sql_app/models.py!}
```

* `sql_app/schemas.py`:

```Python
{!../../../docs_src/sql_databases_peewee/sql_app/schemas.py!}
```

* `sql_app/crud.py`:

    test_db = Path("./test.db")
    if test_db.is_file():  # pragma: nocover
        test_db.unlink()
    # Import while creating the client to create the DB after starting the test session
    from docs_src.sql_databases.sql_app.tests import test_sql_app

    # Ensure import side effects are re-executed
    importlib.reload(test_sql_app)
    test_sql_app.test_create_user()
    if test_db.is_file():  # pragma: nocover

They are generally all related to the same application.

The analogy in the relational database world would be a "database" (a specific database, not the database server).

The analogy in **MongoDB** would be a "collection".

In the code, a `Bucket` represents the main entrypoint of communication with the database.

This utility function will:

* Connect to a **Couchbase** cluster (that might be a single machine).

* 创建 `DATABASE_URL`
* 创建 `database`

```Python hl_lines="3  9  12"
{!../../../docs_src/async_sql_databases/tutorial001.py!}
```

!!! tip "提示"

    连接 PostgreSQL 等数据库时，需要修改 `DATABASE_URL`。

## 创建表

本例中，使用 Python 文件创建表，但在生产环境中，应使用集成迁移等功能的 Alembic 创建表。

本例在启动 **FastAPI** 应用前，直接执行这些操作。

* 创建 `engine`
* 使用 `metadata` 对象创建所有表

```Python hl_lines="25-28"