flash手机网站制作,淮南网络推广公司,店铺推广引流的方法,移动网站自助制作前些天发现了一个巨牛的人工智能学习网站#xff0c;通俗易懂#xff0c;风趣幽默#xff0c;忍不住分享一下给大家。点击跳转到网站。
简介
pgAdmin 是一个针对 PostgreSQL 及其相关数据库管理系统的开源管理和开发平台。它使用 Python 和 jQuery 编写#xff0c;支持 P…前些天发现了一个巨牛的人工智能学习网站通俗易懂风趣幽默忍不住分享一下给大家。点击跳转到网站。
简介
pgAdmin 是一个针对 PostgreSQL 及其相关数据库管理系统的开源管理和开发平台。它使用 Python 和 jQuery 编写支持 PostgreSQL 中的所有功能。您可以使用 pgAdmin 从编写基本的 SQL 查询到监视数据库和配置高级数据库架构等各种操作。
在本教程中我们将演示如何在 Ubuntu 18.04 服务器上安装和配置最新版本的 pgAdmin通过 Web 浏览器访问 pgAdmin并将其连接到服务器上的 PostgreSQL 数据库。
先决条件
要完成本教程您需要
运行 Ubuntu 18.04 的服务器。该服务器应具有一个具有 sudo 权限的非 root 用户并配置了 ufw 防火墙。如果需要帮助设置请参考我们的《Ubuntu 18.04 初始服务器设置指南》。已安装并配置 Nginx 作为 http://unix:/tmp/pgadmin4.sock 的反向代理按照《如何在 Ubuntu 22.04 上配置 Nginx 作为反向代理》中的第 1 和 2 步进行设置。在服务器上安装了 PostgreSQL。您可以按照我们的《如何在 Ubuntu 18.04 上安装和使用 PostgreSQL》指南进行设置。在按照该指南操作时务必创建一个新角色和数据库因为您需要这两者来连接 pgAdmin 到您的 PostgreSQL 实例。在服务器上安装了 Python 3 和 venv。请按照《如何在 Ubuntu 18.04 服务器上安装 Python 3 并设置编程环境》安装这些工具并设置虚拟环境。
步骤 1 — 安装 pgAdmin 及其依赖项
截至本文撰写时pgAdmin 的最新版本是 pgAdmin 4而通过官方 Ubuntu 软件仓库提供的最新版本是 pgAdmin 3。尽管 pgAdmin 3 不再受支持项目维护人员建议安装 pgAdmin 4。在本步骤中我们将介绍在虚拟环境中安装最新版本的 pgAdmin 4正如项目开发团队建议的并使用 apt 安装其依赖项的过程。
首先如果您最近没有更新过服务器的软件包索引请更新
sudo apt update接下来安装以下依赖项。这些包括 libgmp3-dev一个多精度算术库libpq-dev其中包括与 PostgreSQL 后端通信的头文件和静态库
sudo apt install libgmp3-dev libpq-dev然后创建一些目录用于存储 pgAdmin 的会话数据、存储数据和日志
sudo mkdir -p /var/lib/pgadmin4/sessions
sudo mkdir /var/lib/pgadmin4/storage
sudo mkdir /var/log/pgadmin4接下来将这些目录的所有权更改为您的非 root 用户和组。这是必要的因为当前这些目录的所有者是您的 root 用户但我们将从您的非 root 用户拥有的虚拟环境中安装 pgAdmin并且安装过程中会在这些目录中创建一些文件。但在安装完成后我们将把所有权更改为 www-data 用户和组以便可以提供给 Web
sudo chown -R sammy:sammy /var/lib/pgadmin4
sudo chown -R sammy:sammy /var/log/pgadmin4接下来打开您的虚拟环境。转到您的编程环境所在的目录并激活它。按照先决条件 Python 3 教程的命名约定我们将转到 environments 目录并激活 my_env 环境
cd environments/
source my_env/bin/activate激活虚拟环境后最好确保您的系统上安装了最新版本的 pip。默认 Ubuntu 18.04 软件仓库中提供的 pip 版本是 9.0.1而最新版本是 21.0.1。如果您按照先决条件 Python 安装教程中的步骤安装了 python3-pip 包但尚未将其升级到最新版本那么在下一步配置 pgAdmin 时将会遇到问题。
要将 pip 升级到最新版本请运行以下命令
python -m pip install -U pip接下来将 pgAdmin 4 源代码下载到您的计算机上。要找到最新版本的源代码请转到 pgAdmin 4Python Wheel下载页面。单击最新版本本文撰写时为 v6.10然后在下一页单击pip的链接。从文件浏览器页面复制以 .whl 结尾的文件链接这是 Python 发行版中使用的标准构建包格式。然后返回到您的终端并运行以下 wget 命令确保用您从 PostgreSQL 网站复制的链接替换以将 .whl 文件下载到您的服务器
wget https://ftp.postgresql.org/pub/pgadmin/pgadmin4/v6.10/pip/pgadmin4-6.10-py3-none-any.whl接下来使用以下命令安装 wheel 包这是 wheel 打包标准的参考实现。作为 Python 库该包用作构建 wheel 的扩展并包括用于处理 .whl 文件的命令行工具
python -m pip install wheel然后使用以下命令安装 pgAdmin 4 包
python -m pip install pgadmin4-6.10-py3-none-any.whl接下来安装 Gunicorn这是一个 Python WSGI 服务器将在本教程后面与 Nginx 一起用于提供 pgadmin Web 接口
python -m pip install gunicorn这样就完成了安装 pgAdmin 及其依赖项。但在将其连接到数据库之前您需要对程序的配置进行一些更改。
步骤 2 — 配置 pgAdmin 4
虽然 pgAdmin 已经安装在您的服务器上但仍然有一些步骤需要进行以确保它具有所需的权限和配置以便正确提供 Web 接口。
pgAdmin 的主配置文件 config.py 在任何其他配置文件之前被读取。它的内容可以用作进一步配置设置的参考点这些设置可以在 pgAdmin 的其他配置文件中指定但为了避免意外错误您不应该直接编辑 config.py 文件。我们将向一个新文件添加一些配置更改命名为 config_local.py该文件将在主配置文件之后被读取。
现在使用您喜欢的文本编辑器创建此文件。在这里我们将使用 nano
nano my_env/lib/python3.10/site-packages/pgadmin4/config_local.py在您的编辑器中添加以下内容
LOG_FILE /var/log/pgadmin4/pgadmin4.log
SQLITE_PATH /var/lib/pgadmin4/pgadmin4.db
SESSION_DB_PATH /var/lib/pgadmin4/sessions
STORAGE_DIR /var/lib/pgadmin4/storage
SERVER_MODE True这里是这五个指令的作用
LOG_FILE定义了 pgAdmin 日志将存储的文件。SQLITE_PATHpgAdmin 将用户相关数据存储在一个 SQLite 数据库中该指令将 pgAdmin 软件指向此配置数据库。由于此文件位于持久目录 /var/lib/pgadmin4/ 下因此在升级后不会丢失用户数据。SESSION_DB_PATH指定用于存储会话数据的目录。STORAGE_DIR定义了 pgAdmin 将存储其他数据如备份和安全证书的位置。SERVER_MODE将此指令设置为 True 告诉 pgAdmin 以服务器模式运行而不是桌面模式。
请注意每个文件路径都指向您在步骤 1 中创建的目录。
添加这些行后保存并关闭文件。如果您使用的是 nano请按 CTRL X然后按 Y最后按 ENTER。
配置完成后运行 pgAdmin 设置脚本以设置您的登录凭据
python my_env/lib/python3.10/site-packages/pgadmin4/setup.py运行此命令后您将看到一个提示询问您的电子邮件地址和密码。这将作为您以后访问 pgAdmin 时的登录凭据因此请务必记住或记下您在此输入的内容
. . .
输入用于初始 pgAdmin 用户帐户的电子邮件地址和密码电子邮件地址sammyexample.com
密码
重新输入密码至此pgAdmin 已经完全配置好。但是该程序尚未从您的服务器上提供服务因此无法访问。为了解决这个问题我们将配置 Gunicorn 和 Nginx 来提供 pgAdmin以便您可以通过 Web 浏览器访问其用户界面。
步骤 3 — 启动 Gunicorn 并配置 Nginx
您将使用 Gunicorn 作为 Web 应用程序来提供 pgAdmin。但是作为应用程序服务器Gunicorn 只能在本地访问无法通过互联网访问。为了使其可以远程访问您需要使用 Nginx 作为反向代理。
完成设置 Nginx 作为反向代理的先决条件后您的 Nginx 配置文件将包含以下内容
server {listen 80;listen [::]:80;server_name your_domain www.your_domain;location / {proxy_pass http://unix:/tmp/pgadmin4.sock;include proxy_params;}
}这个反向代理配置使您的 Gunicorn 服务器可以在本地浏览器中访问。使用以下命令启动您的 Gunicorn 服务器与 pgAdmin 应用程序
gunicorn --bind unix:/tmp/pgadmin4.sock --workers1 --threads25 --chdir ~/environments/my_env/lib/python3.10/site-packages/pgadmin4 pgAdmin4:app[2022-08-29 00:19:11 0000] [7134] [INFO] Starting gunicorn 20.1.0
[2022-08-29 00:19:11 0000] [7134] [INFO] Listening at: unix:/tmp/pgadmin4.sock (7134)
[2022-08-29 00:19:11 0000] [7134] [INFO] Using worker: gthread
[2022-08-29 00:19:11 0000] [7135] [INFO] Booting worker with pid: 7135通过 Gunicorn 作为应用程序服务器并通过您的 Nginx 反向代理进行访问您现在可以在 Web 浏览器中访问 pgAdmin 了。
步骤 4 — 访问 pgAdmin
在本地机器上打开你喜欢的网络浏览器然后输入你服务器的 IP 地址
http://your_server_ip输入后会出现一个类似下面的登录界面
!pgAdmin 登录界面
输入在第 2 步中定义的登录凭据然后你将进入 pgAdmin 欢迎界面
!pgAdmin 欢迎页面
现在你已经确认可以访问 pgAdmin 界面剩下的就是将 pgAdmin 连接到你的 PostgreSQL 数据库。不过在这之前你需要对你的 PostgreSQL 超级用户进行一些微小的配置。
步骤 5 — 配置你的 PostgreSQL 用户
如果你按照先决条件 PostgreSQL 教程进行了操作那么你应该已经在服务器上安装了 PostgreSQL并设置了一个新的超级用户角色和数据库。
在 PostgreSQL 中默认情况下你使用“身份验证协议”或“ident”身份验证方法来认证数据库用户。这意味着 PostgreSQL 会获取客户端的 Ubuntu 用户名并将其用作允许的数据库用户名。在许多情况下这可以提供更高的安全性但也可能在你希望外部程序如 pgAdmin连接到你的数据库时出现问题。为了解决这个问题我们将为这个 PostgreSQL 角色设置一个密码这样 pgAdmin 就可以连接到你的数据库了。
从你的终端以超级用户角色打开 PostgreSQL 提示符
sudo -u sammy psql在 PostgreSQL 提示符下更新用户配置设置一个你选择的强密码
ALTER USER sammy PASSWORD password;然后退出 PostgreSQL 提示符
\q接下来回到你的浏览器中的 pgAdmin 4 界面找到左侧的 Browser 菜单。右键单击 Servers 以打开上下文菜单将鼠标悬停在 Create 上然后单击 Server…。
!创建服务器上下文菜单
这将在你的浏览器中弹出一个窗口在其中你将输入有关你的服务器、角色和数据库的信息。
在 General 选项卡中输入此服务器的名称。这可以是任何你喜欢的名称但最好是一些描述性的内容。在我们的示例中服务器的名称是 Sammy-server-1。
!创建服务器 - General 选项卡
接下来点击 Connection 选项卡。在 Host name/address 字段中输入 localhost。Port 应该默认设置为 5432这对于这个设置来说是有效的因为这是 PostgreSQL 使用的默认端口。
在 Maintenance database 字段中输入你想要连接的数据库的名称。请注意这个数据库必须已经在你的服务器上创建好。然后在 Username 和 Password 字段中分别输入你之前配置的 PostgreSQL 用户名和密码。
!创建服务器 - Connection 选项卡
其他选项卡中的空字段是可选的只有在你有特定设置需要时才需要填写它们。点击 Save 按钮数据库将出现在 Browser 菜单下的 Servers 中。
你已成功将 pgAdmin4 连接到你的 PostgreSQL 数据库。你可以在 pgAdmin 仪表板上执行几乎任何你在 PostgreSQL 提示符上可以执行的操作。为了说明这一点我们将通过 Web 界面创建一个示例表并向其中填充一些示例数据。
步骤 6 — 在 pgAdmin 仪表板中创建表
从 pgAdmin 仪表板中找到窗口左侧的 Browser 菜单。单击 Servers (1) 旁边的加号以展开其中的树形菜单。接下来单击上一步中添加的服务器在我们的示例中为 Sammy-server-1左侧的加号然后展开 Databases、你添加的数据库的名称在我们的示例中为 sammy然后展开 Schemas (1)。你应该会看到如下所示的树形菜单
!展开的 Browser 树形菜单
右键单击 Tables然后将鼠标悬停在 Create 上单击 Table…。
!创建表上下文菜单
这将打开一个 Create-Table 窗口。在这个窗口的 General 选项卡下为表输入一个名称。这可以是任何你喜欢的名称但为了简单起见我们将其称为 table-01。
!创建表 - General 选项卡
然后转到 Columns 选项卡并单击窗口右上角的加号以添加一些列。在添加列时你需要为其指定一个 Name 和一个 Data type如果数据类型要求你可能还需要选择一个 Length。
此外官方的 PostgreSQL 文档指出向表添加主键通常是最佳实践。主键 是一个约束指示可以用作表中行的特殊标识符的特定列或列集。这不是必需的但如果你想将一个或多个列设置为主键可以将右侧的开关从 No 切换到 Yes。
点击 Save 按钮以创建表。
!创建表 - 打开主键的 Columns 选项卡
到目前为止你已经创建了一个表并向其中添加了一些列。不过这些列还没有包含任何数据。要向新表添加数据右键单击 Browser 菜单中表的名称将鼠标悬停在 Scripts 上然后单击 INSERT Script。
!INSERT 脚本上下文菜单
这将在仪表板上打开一个新面板。在顶部你将看到一个部分填充的 INSERT 语句其中包含适当的表和列名称。请用一些虚拟数据替换问号?确保你添加的数据与你为每列选择的数据类型相匹配。请注意你还可以通过在新的括号组中添加每行来添加多行数据每组括号之间用逗号分隔如下例所示。
如果愿意可以用以下示例 INSERT 语句替换部分填充的 INSERT 脚本
INSERT INTO public.table-01(col1, col2, col3)VALUES (Juneau, 14, 337), (Bismark, 90, 2334), (Lansing, 51, 556);!示例 INSERT 语句
点击侧向三角形图标▶以执行 INSERT 语句。请注意在较旧版本的 pgAdmin 中执行图标是一个闪电图标⚡。
要查看表和其中的所有数据再次右键单击 Browser 菜单中你的表的名称将鼠标悬停在 View/Edit Data 上然后选择 All Rows。
!查看/编辑数据所有行上下文菜单
这将在仪表板上打开另一个新面板在下面的 Data Output 选项卡中你可以查看表中保存的所有数据。
!查看数据 - 示例数据输出
到此为止你已成功通过 pgAdmin Web 界面创建了一个表并向其中填充了一些数据。当然这只是你可以使用 pgAdmin 创建表的一种方法。例如你也可以使用 SQL 而不是本步骤中描述的基于 GUI 的方法来创建和填充表。
结论
在本指南中您学习了如何从 Python 虚拟环境安装 pgAdmin 4配置它使用 Gunicorn 和 Nginx 将其提供给 Web并且如何将其连接到 PostgreSQL 数据库。此外本指南还介绍了一种用于创建和填充表的方法但 pgAdmin 不仅仅可以用于创建和编辑表格。
要了解如何充分利用 pgAdmin 的所有功能我们鼓励您查阅该项目的文档。您也可以通过我们社区关于 PostgreSQL 的教程了解更多信息。
