创建 PostgreSQL 服务器

使用适用于 Visual Studio Code 的 PostgreSQL 扩展，无需离开编辑器即可创建新的 PostgreSQL 服务器。 可以启动用于开发和测试的本地 Docker 容器、为生产工作负荷预配完全托管的Azure Database for PostgreSQL灵活服务器，或者为大规模方案创建 Azure HorizonDB （预览版）群集。

先决条件

• 已安装该扩展的 Visual Studio Code。
• 对于本地 Docker 服务器：已安装Docker Desktop，并且 Docker 守护进程正在运行。 通过在终端中运行 docker info 来验证。
• 对于Azure服务器：具有活动订阅的Azure帐户。 如果你没有帐户，请免费创建一个。
• 对于 Azure HorizonDB（预览版）群集：拥有有效订阅并可访问 Azure HorizonDB（预览版）的 Azure 帐户。

打开“创建新服务器”中心

1. 在 PostgreSQL 活动栏容器中，找到 “连接” 树。

2. 选择连接树顶部的“创建新服务器”按钮，或从命令面板运行pgsql.createNewServer。

   还可以右键单击 “连接 ”树中的服务器组，然后选择“ 创建新服务器”。

新建 PostgreSQL 服务器中心将在新的编辑器选项卡中打开。它提供三个选项：

选择与方案匹配的卡片。

使用 Docker 创建本地服务器

Docker 容器提供在计算机上运行的轻型隔离 PostgreSQL 实例。 使用此选项进行本地开发、原型制作，或在需要时使用可释放的数据库环境。

步骤 1：查看简介

选择 创建本地 Docker PostgreSQL Server 卡片后，该扩展会显示一个标题为 在 VS Code 中无缝使用运行于 Docker 上的 PostgreSQL Server！ 的落地页。 页面突出显示关键功能：

• One-Click 服务器创建：在几秒钟内启动 PostgreSQL 服务器，无需手动设置。
• 完全自动化安装：扩展在独立环境中拉取、配置和运行 PostgreSQL。
• 简单管理：随时启动、停止或删除 PostgreSQL 容器。

选择 “开始” 以继续。

步骤 2：通过先决条件检查

该扩展检查 Docker 是否已安装并运行。 “检查先决条件”屏幕显示每个检查的状态：

• 检查是否已安装 Docker：验证 Docker CLI 在 PATH 上是否可用。
• 检查 Docker 是否在后台运行：确认 Docker 守护程序处于活动状态。

如果检查失败，请按照屏幕上的链接安装或启动 Docker，然后返回到此页面。 扩展会自动重新运行检查。

步骤 3：配置连接

先决条件通过后，将显示 “设置连接 ”窗体。 填写以下字段：

选择 “高级选项” 以展开其他设置：

步骤 4：创建和连接

选择“ 创建 ”以开始预配。 该扩展：

1. 拉取 postgres Docker 映像（如果尚未缓存）。
2. 使用指定的设置创建并启动容器。
3. 等待 PostgreSQL 准备就绪（使用 pg_isready）。
4. 创建连接配置文件并自动连接。

容器初始化时将显示标题为 “创建本地 Docker 服务器...” 的进度指示器。 容器准备就绪后，服务器会显示在 “连接” 树中，你可以立即开始查询。

创建 Azure Database for PostgreSQL 灵活服务器

Azure Database for PostgreSQL灵活服务器是一种完全托管的数据库服务，可提供高可用性、自动备份和智能性能优化。 该扩展将引导你完成多步骤向导，以便直接从Visual Studio Code预配新服务器。

步骤 1：查看简介

选择“创建Azure Database for PostgreSQL灵活服务器实例卡”后，登录页将描述服务功能：

• 无缝Azure集成：使用Entra ID身份验证支持直接在Visual Studio Code中预配服务器。
• 灵活的计算和存储：从预配置的计算层和存储选项中进行选择。
• 简化的服务器管理：在不离开编辑器的情况下管理生命周期、性能和配置。
• 专为开发人员打造：专注于您的应用程序，基础设施则由 Azure 负责。

选择 “开始” 以继续。 （可选）选择 “不要再次显示此 内容”以在将来跳过此页面。

步骤 2：登录到Azure

该扩展将打开一个登录页，其中包含消息：“使用Entra ID登录到Azure帐户，以创建Azure Database for PostgreSQL灵活服务器实例。

• 如果已有Azure帐户登录到 Visual Studio Code，则扩展会自动使用这些凭据。
• 如果有多个Azure帐户或租户，请使用帐户切换器和租户选择器来选择正确的标识。

步骤 3：配置服务器设置

身份验证后，该扩展会显示一个按分区组织的配置窗体。 进行选择时，右侧的“成本估算”面板会进行更新。

项目详细信息

Basics

Authentication

窗体显示 “管理员访问 ”部分。 必须至少启用一个身份验证方法。

选择 “创建 PostgreSQL 用户和密码”时，请提供以下内容：

成本估算

窗体右侧的 “估计成本 ”面板按月定价细分：

• 计算：基于所选 SKU 和 vCore 数量。
• 存储：基于所选存储层。
• 备份：包括备份成本。
• 带宽：跨区域的出站数据传输会产生额外费用;入站传输是免费的。

该面板显示“估计总计”和“Azure定价计算器”的链接，以获取详细的定价。

步骤 4：接受条款并部署

在表单底部：

1. 选中 “我确认创建此服务器可能会产生费用 ”复选框。
2. 查看链接 的使用条款 和 隐私策略。
3. 选择“ 创建 ”以开始预配。

该扩展导航到跟踪部署的每个阶段的进度页：

部署摘要显示所选 的服务器名称、 订阅、 资源组、 区域和 配置 。

在部署期间，可以继续在Visual Studio Code中工作。 如果关闭进度页，部署也会在后台运行。

完成所有阶段后，标头将更新为 已成功创建的服务器！ 并显示消息：“PostgreSQL 灵活服务器已准备就绪。该扩展会自动为新服务器创建连接配置文件。 选择 “完成 ”以关闭进度页。

跟踪Azure部署

PostgreSQL 活动栏中的“Azure部署”视图显示所有正在进行的和已完成Azure服务器部署。 每个条目显示服务器名称、部署状态和时间戳。

右键单击部署以访问以下操作：

使用视图工具栏中的 “删除已完成” 按钮清除列表中所有已完成的部署。

创建Azure HorizonDB （预览版）群集

Azure HorizonDB（预览版）是Azure中云原生且高度可缩放的 PostgreSQL 群集。 该扩展将引导你完成多步骤向导来预配新群集。

步骤 1：查看简介

选择“创建Azure HorizonDB 实例卡”后，登陆页将描述服务功能：

• Cloud-Native 体系结构：针对高吞吐量优化的云原生 PostgreSQL 群集。
• 弹性缩放：将计算从 2 缩放到 128 个 vCore。
• 内置管理：从Visual Studio Code管理生命周期和配置。
• 面向开发者：专注于您的应用程序，基础结构由 Azure 负责。

选择 “开始” 以继续。 （可选）选择 “不要再次显示此 内容”以在将来跳过此页面。

步骤 2：登录到Azure

该扩展将打开登录页。 如果已有Azure帐户登录到 Visual Studio Code，则扩展会自动使用这些凭据。 如果有多个Azure帐户或租户，请使用帐户切换器和租户选择器来选择正确的标识。

步骤 3：配置群集设置

身份验证后，该扩展会显示一个按分区组织的配置窗体。

项目详细信息

群集详细信息

计算配置

使用 vCore 滑块选择群集的计算容量。 可用选项范围为 2 到 128 个 vCore。 内存会按每个 vCore 8 GiB的比例自动扩展。

Authentication

AI 功能

AI 功能部分允许启用内置 AI 模型管理功能。 选中“ 启用 AI 功能 ”复选框以选择加入。 启用 AI 功能后，群集会预配模型管理支持 pgvector和 pg_diskann 扩展。

步骤 4：接受条款并部署

在表单底部：

1. 选中“群集附加条款”复选框。
2. 如果已启用 AI 功能和 AI 补充术语复选框可见，请选择它。
3. 查看链接 的使用条款 和 隐私策略。
4. 选择“ 创建 ”以开始预配。 如果窗体不完整，请将鼠标悬停在禁用的 “创建 ”按钮上，以查看哪些字段仍然需要值。

该扩展导航到跟踪部署的每个阶段的进度页。 部署摘要会显示你所选的群集名称、订阅、资源组和配置（vCore 数和内存）。

完成所有阶段后，扩展将为新群集创建连接配置文件。 选择 “完成 ”以关闭进度页。

验证服务器

创建服务器后（Docker 或 Azure）：

1. 展开“连接”树下的服务器节点。
2. 确认列出了默认数据库（postgres 以及 Docker 中指定的任何数据库）。
3. 右键单击数据库并选择“ 新建查询 ”以打开查询编辑器。
4. 运行测试查询，例如 SELECT version(); 验证连接。

相关内容

• 连接和标识
• Azure服务器管理
• 服务器仪表板
• 设置参考