如何在我的 flask-sqlalchemy 应用程序中使用 Heroku Postgres？

Question

现在我有一个应用程序可以将用户数据写入一个名为 users.sql 的数据库文件中。但是，我通过 github 将其推送到 heroku 并且数据没有保留。如果某个时间过去了，heroku 将休眠，并且在检测到另一个登录时必须重新部署所有文件。我听说我可以将 heroku postgres 添加为 heroku 的插件，但我不确定如何将它与我当前的代码集成。我该怎么做才能设置它？

Answer 1

我在尝试将我的应用程序连接到 Postgres 时偶然发现了您的问题，并且对缺乏明确的说明感到非常沮丧。因此，这是我努力克服的所有错误的分步过程（因为这就是教程让你喘不过气来的地方，而他们却在不知不觉中打雷......）

TL;DR

• 安装 Postgres
• 安装 Heroku CLI
• 安装 psycopg2 或 psycopg2-binary 和 gunicorn
• 在 Heroku 中使用 Postgres 数据库创建一个应用程序，并将数据库 url 保存为 SQLALCHEMY_DATABASE_URI
• 创建 Procfile、requirements.txt 和 runtime.txt
• 推送到 Github 并将 repo 连接到 Heroku
• 部署分支
• from app import db db.create_all()

我使用 WSL，所以我的答案中的所有命令行语法都是 Bash，我正在使用 Windows 10。

我的部分工作来自Traversy Media 的 youtube tutorial。这是他使用的Github repo（我绝对建议最初使用基本应用程序，而不是为带有额外包的复杂应用程序中出现的错误而苦苦挣扎）。

开始之前

• Create an account 在 Heroku 中并安装 Heroku CLI
• Download and install PostgreSQL（这也会给你 pgAdmin 4）
• fork 并克隆 Github repo，并检查它是否运行正常（如果您没有使用自己的应用程序）

预赛

• 创建一个虚拟环境并安装所有软件包。确保您拥有psycopg2和gunicorn

 ERROR: Failed building wheel for psycopg2-binary

无论出于何种原因，psycopg 拒绝在我的系统上安装。您可以改用 pip3 install psycopg2-binary 来解决这个问题 - 就我们的要求而言，这没有区别。

连接到 Postgres

从开始菜单打开 pgAdmin 4。如果您是第一次登录或退出，这可能会提示您输入密码。

could not connect to server: Connection refused (0x0000274D/10061) Is the 
server running on host "127.0.0.1" and accepting TCP/IP connections on port 5432?

使用sudo service postgresql status检查PostgreSQL服务器是否 在跑。如果是，请尝试停止并启动它。如果不是，请开始 它。

sudo service postgresql start

sudo service postgresql stop

在左侧面板中，右键单击Databases，然后单击创建 > 数据库...。输入您的数据库名称（本教程使用“lexus”）并保存。

在app.py（或您进行数据库配置的任何地方）找到该行

if ENV == 'dev':
    ...
    app.config['SQLALCHEMY_DATABASE_URI'] = ''

并将数据库连接字符串放在引号内。语法是

postgresql://[username]:[password]@[host name]/[db name]

# [username] - Right-click on your server in pgAdmin (probably a variation of `PostgreSQL 13`). Go to the Connection tab and check the Username field.

# [password] - The root password you set the first time you logged in to pgAdmin.

# [host name] - In the same place as your username, in the Host name/address field.

# [db name] - The name you entered when creating your database.

在我的例子中，连接字符串是：

app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://postgres:123456@localhost/lexus'

进入python控制台，创建数据库：

>>> from app import db
>>> db.create_all()

如果您在这方面没有出错，请认为自己是自切片面包以来最幸运的人。在 pgAdmin 中转到 Databases > [your db name] > Schemas > Tables 以检查它们是否已创建。

ImportError: cannot import name 'db' from 'app' (unknown location)

db 不在您的应用程序中的app 中。找到它在哪里 定义并从那里导入。

(psycopg2.OperationalError) FATAL:  password authentication failed for user "postgres"

您使用了错误的密码。我发现这令人困惑 因为不清楚是否需要使用主密码（ 您在第一次登录 pgAdmin 时设置的）或 您要连接的数据库的密码。这是这里需要的主密码。 在命令行中输入psql -h 127.0.0.1 postgres (psql -h [ip address] [username]) - 验证的密码是连接字符串所需的密码。

(psycopg2.OperationalError) FATAL:  database "lexus" does not exist

您可能连接到错误的数据库，使用了错误的 用户名，或者您的数据库尚未创建。检查您的连接字符串和 pgAdmin 以确认详细信息正确。

db.create_all() seemed to work, but I have no tables in pgAdmin!

如果您的数据库模型存储在单独的文件中，请导入它们 在 db 初始化后进入 app.py。它应该是这样的：

app = Flask(__name__)
...
db = SQLAlchemy(app)
...
from app.models import *

向 Postgres 发送数据

运行应用程序并通过表单提交一些数据（或在表格中创建一些数据）。在 pgAdmin 中，右键单击刚刚创建的表并刷新，然后右键单击并查看/编辑数据。

Could not send data to server: Socket is not connected (0x00002749/10057) could not send SSL negotiation packet: Socket is not connected (0x00002749/10057)

1. 断开并重新连接服务器（右键单击服务器并单击断开服务器，然后单击连接服务器）并再次刷新表。
2. 如果这不起作用，请右键单击服务器并单击属性，转到连接选项卡并将主机名/地址从 localhost 到 127.0.0.1。然后重复第 1 步。

创建 Heroku 应用

由于我更喜欢​​直接在 Github 而不是 CLI 中使用 Heroku，所以我在这里没有使用 git init，但请注意，如果您的代码还不是 Github 存储库，则需要使用它。

在命令行中：

heroku login # If you have the Heroku CLI installed correctly, this will open a tab in the browser and log you in to Heroku.

heroku create unique-app-name # (replace `unique-app-name` with your own name). This creates an app on the Heroku server, and it's the place your code is cloned to so that it can be run. Check that it has appeared in your [Heroku dashboard](https://dashboard.heroku.com/).

heroku addons:create heroku-postgresql:hobby-dev -a unique-app-name # This creates an empty postgres database for your app. Heroku uses its own database, not your pgAdmin database.

heroku config -a unique-app-name # The url you set earlier as the `SQLALCHEMY_DATABASE_URI` points to the database you created in pgAdmin, but since your app is now going to be using Heroku's database you need a new url. Copy the DATABASE_URL that is returned. 

返回之前设置app.config['SQLALCHEMY_DATABASE_URI'] 的代码，在else 块中插入新的url。它应该或多或少像这样：

if ENV == 'dev':
    app.config['SQLALCHEMY_DATABASE_URI'] = 'postgresql://postgres:123456@localhost/lexus'
else:
    app.config['SQLALCHEMY_DATABASE_URI'] = 'postgres://urlyoujustgotfromherokuozftkndvkayeyc:691196bfb1b1ca8318b733935b10c97a19fd41@ec2-52-71-161-140.compute-1.amazonaws.com:5432/d3pofh2b55a2ct'

如果您正在使用本教程的 github 存储库，请设置 ENV = 'prod'，否则将配置设置为使用您想要的 heroku url。

如果您的项目文件中尚未包含以下文件，请将它们添加到您的根目录：

# Procfile
web: gunicorn app:app # The first `app` refers to the app.py and the second `app` refers to the app object, ie `app = Flask(__name__)`. Heroku needs this to know how to run your code.

# runtime.txt
python-3.8.5 # Find your python version by entering `python --version` or `python3 --version` in the command line.

# requirements.txt

# Create this by running `pip3 freeze > requirements.txt`. According to the [Heroku docs](https://devcenter.heroku.com/articles/python-runtimes)
# this must be done after changing runtime versions, so it's best to do it last.

将所有内容推送到 Github（同样，这是如果你已经在一个 repo 中，否则你将使用我没有关注的 Heroku CLI 进程）。

在 Heroku 上部署

单击您之前在Heroku dashboard 中创建的应用程序，然后转到“部署”选项卡。在部署方法选项中，单击 Github。连接您的 Github 帐户和存储库。

向下滚动到手动部署部分，然后选择您要部署的分支（或者如果这是唯一一个，则将其保留为主分支）。单击部署分支。

Requested runtime (python-3.7.2) is not available for this stack (heroku-20).
 !     Aborting.  More info: https://devcenter.heroku.com/articles/python-support
 !     Push rejected, failed to compile Python app.
 !     Push failed

看来python版本不对。检查runtime.txt 是否显示正确的python 版本。如果它 不是，更新它，删除并重新创建requirements.txt，推送到 Github 并再次点击 Deploy Branch。

创建 Heroku 数据库

回到命令行：

heroku run python3
>>> from app import db
>>> db.create_all()

要检查您的数据库，请输入

heroku pg:psql --app unique-app-name

如果您运行select * from tablename;，则不会返回任何内容，因为还没有任何数据。

单击 Heroku 中的“查看”按钮以打开您的应用。提交表单（或输入数据，无论您的应用如何运行），然后再次运行select * from tablename;，您将看到该行数据。

Answer 2

在你的 init.py 文件中，你可以设置你的 app.config['SQLALCHEMY_DATABASE_URI'] 变量，这样它会寻找一个 Heroku 会给你的应用程序（如果它在 heroku 上运行），或者如果它在本地运行，请使用本地数据库的配置。您可以这样实现：

app.config['SQLALCHEMY_DATABASE_URI'] = environ.get('DATABASE_URL') or "postgresql://postgres:password@localhost:5432/postgres"

用本地连接的连接详细信息替换 OR 之后的内容

如果您要使用 heroku，我建议考虑设置本地 postgres 数据库而不是 sql，但从技术上讲，您可以同时使用两者。您可能会遇到一些小问题，例如，我遇到了处理日期略有不同的问题。

Answer 3

首先让heroku从终端登录：

$ heroku login

现在使用以下命令为您的应用创建数据库：

$ heroku addons:create heroku-postgresql:hobby-dev --app app_name

现在，在创建数据库后，使用以下命令获取数据库的 URL：

$ heroku config --app app_name

现在您已经获得了数据库 URL，请将“app.py”文件中 app.config[‘SQLALCHEMY_DATABASE_URI’] 行的值替换为该数据库 URL：

app.config['SQLALCHEMY_DATABASE_URI'] = 'heroku_database_url'

最后将代码推送到heroku。