创建并连接到数据库
本页将引导您完成在 AlloyDB for PostgreSQL 上创建第一个数据库并连接到该数据库的流程。
本快速入门指南的最后部分提供了相关说明,可引导您清理此新数据库。页面最后列出了后续步骤,以便您详细了解如何将 AlloyDB 与自己的应用搭配使用。
准备工作
控制台
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
启用创建和连接到 AlloyDB for PostgreSQL 所需的 Cloud API。
在确认项目步骤中,点击下一步以确认要更改的项目的名称。
在启用 API 步骤中,点击启用以启用以下各项:
- AlloyDB API
- Compute Engine API
- Cloud Resource Manager API
- Service Networking API
如果您打算使用与 AlloyDB 位于同一 Google Cloud 项目中的 VPC 网络来配置与 AlloyDB 的网络连接,则必须使用 Service Networking API。
如果您打算使用位于其他 Google Cloud 项目中的 VPC 网络配置与 AlloyDB 的网络连接,则必须使用 Compute Engine API 和 Cloud Resource Manager API。
gcloud
创建 Google Cloud 项目或使用现有项目:
gcloud projects create PROJECT_ID --set-as-default # For an existing project gcloud config set project PROJECT_ID
替换以下内容:
PROJECT_ID
:项目的永久性标识符。
确保您的 Google Cloud 项目已启用结算功能。了解如何确认您的项目是否已启用结算功能。
启用 AlloyDB、Compute Engine 和 Resource Manager API:
gcloud services enable alloydb.googleapis.com gcloud services enable compute.googleapis.com gcloud services enable cloudresourcemanager.googleapis.com
如果您打算使用与 AlloyDB 位于同一 Google Cloud 项目中的 VPC 网络来配置与 AlloyDB 的网络连接,请在该项目中启用 Service Networking API。
gcloud services enable servicenetworking.googleapis.com
如果您打算使用位于其他 Google Cloud 项目中的 VPC 网络配置与 AlloyDB 的网络连接,请确认该项目中已启用 Compute Engine 和 Service Networking API,以便您在该项目中配置共享 VPC 和专用服务访问权限。
gcloud services list
创建集群及其主实例
注意:如果您计划使用专用网络,可以使用 Terraform 部署所选择的专用网络设置、AlloyDB 实例以及 Compute Engine 虚拟机等客户端。如需了解详情,请参阅 简化版云网络配置解决方案。
在 Google Cloud 控制台中,前往 Clusters 页面。
点击创建集群。
在集群 ID 中,输入
my-cluster
。输入密码。记下此密码,因为您将在本快速入门中使用它。
保留默认数据库版本。
选择
us-central1 (Iowa)
区域。选择默认网络。
如果您有专用访问权限连接,请继续执行下一步。否则,请点击设置关联,然后按照以下步骤操作:
在分配 IP 范围中,点击使用自动分配的 IP 范围。
点击继续,然后点击创建关联。
保留默认实例 ID
my-cluster-primary
。在可用区级可用性中,将单个可用区保留为所选选项。虽然我们不建议在生产环境中使用单可用区实例,但您可以在本快速入门中使用单可用区实例,以最大限度地降低费用。如需了解详情,请参阅使用基本实例降低费用。
选择
2 vCPU, 16 GB
机器类型。保留连接性和网络安全下的默认设置。
请勿在显示高级选项中进行更改。
点击创建集群。AlloyDB 可能需要几分钟才能创建集群并将其显示在主集群的概览页面上。
连接到您的实例并创建数据库
在 Google Cloud 控制台中,前往 Clusters 页面。
在资源名称列中,点击集群的名称
my-cluster
。在导航窗格中,点击 AlloyDB Studio。
在登录 AlloyDB Studio 页面中,按以下步骤操作:
选择
postgres
数据库。选择
postgres
用户。输入您在创建集群及其主实例中创建的密码。
点击身份验证。Explorer 窗格会显示
postgres
数据库中的对象列表。
如需创建数据库,请在 Editor 1 标签页中输入以下语句,然后点击 Run:
CREATE DATABASE guestbook;
当“结果”窗格中显示
Statement executed successfully
消息时,即表示数据库已创建。
连接到 guestbook
数据库
在 Google Cloud 控制台中,前往 Clusters 页面。
在资源名称列中,点击集群的名称
my-cluster
。在导航窗格中,点击 AlloyDB Studio。
在登录 AlloyDB Studio 页面中,按以下步骤操作:
选择
guestbook
数据库。选择
postgres
用户。输入您在创建集群及其主实例中创建的密码。
点击身份验证。Explorer 窗格会显示
guestbook
数据库中的对象列表。
验证数据库连接
请按照连接到
guestbook
数据库中的步骤操作。如需将示例数据插入到
guestbook
数据库中,请在 Editor 1 标签页中输入以下内容:CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255), entryID SERIAL PRIMARY KEY); INSERT INTO entries (guestName, content) values ('Alex', 'I got here!'); INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
点击运行。Results 窗格中的
Statement executed successfully
消息表示数据已插入数据库。如需从 Editor 1 标签页中移除文本,以便运行其他命令,请点击清除。
如需选择数据库中的所有条目,请在编辑器 1 标签页中输入以下查询:
SELECT * FROM entries;
点击运行。结果窗格中会显示类似以下内容的输出:
guestname | content | entryid --------------+-------------+--------- Alex | I got here! | 1 Kai | Me too! | 2
清理
为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用,请按照以下步骤操作。