1. 概览
在本 Codelab 中,我们将演示一种简单易行的方法来设置 AlloyDB。

构建内容
在此过程中,您将通过一键式安装创建 AlloyDB 实例和集群,并且您还将学习如何在未来的项目中快速设置它们。
要求
2. 准备工作
创建项目
- 在 Google Cloud 控制台的项目选择器页面上,选择或创建一个 Google Cloud 项目。
- 确保您的 Cloud 项目已启用结算功能。了解如何 检查项目是否已启用结算功能。
- 您将使用 Cloud Shell,它是在 Google Cloud 中运行的命令行环境。点击 Google Cloud 控制台顶部的激活 Cloud Shell 。

- 连接到 Cloud Shell 后,您可以使用以下命令检查自己是否已通过身份验证,以及项目是否已设置为您的项目 ID:
gcloud auth list
- 在 Cloud Shell 中运行以下命令,以确认 gcloud 命令了解您的项目。
gcloud config list project
- 如果项目未设置,请使用以下命令进行设置:
gcloud config set project <YOUR_PROJECT_ID>
- 启用必需的 API:点击 链接 并启用 API。
或者,您也可以使用 gcloud 命令来执行此操作。如需了解 gcloud 命令和用法,请参阅 文档。
3. 为何要将 AlloyDB 用于您的商家数据和 AI?
AlloyDB for PostgreSQL 不仅仅是另一项托管式 Postgres 服务。它是为 AI 时代设计的引擎的根本性现代化。与标准数据库相比,它之所以独树一帜,原因如下:
- 混合事务和分析处理 (HTAP)
大多数数据库都会强制您将数据移至数据仓库以进行分析。AlloyDB 具有内置的列式引擎 ,可自动将相关数据保留在内存中的列存储区中。这使得分析查询的速度比标准 PostgreSQL 快至 100 倍 ,让您无需复杂的 ETL 管道即可对运营数据运行实时商业智能。
- 原生 AI 集成:
AlloyDB 弥合了数据与生成式 AI 之间的差距。借助 google_ml_integration 扩展程序,您可以直接在 SQL 查询中调用 Vertex AI 模型(例如 Gemini)。这意味着您可以将情感分析、翻译或实体提取作为标准数据库事务执行,从而确保数据安全并最大限度地减少延迟。
- 卓越的向量搜索:
虽然标准 PostgreSQL 使用 pgvector,但 AlloyDB 通过 Google 研究 开发的 ScaNN 索引 (可扩容最近邻)对其进行了增强。与其他 Postgres 产品中提供的标准 HNSW 索引相比,这可提供明显更快的向量相似度搜索和更高的召回率。它使您能够以原生方式构建高性能 RAG(检索增强生成)应用。
- 大规模性能:
AlloyDB 的事务处理性能比标准 PostgreSQL 快至 4 倍 。它将计算与存储分离,使两者可以独立扩缩。存储层是智能的,可处理预写式日志 (WAL) 处理,以从主实例中分流工作。
- 企业级可用性:
它提供 99.99% 的正常运行时间 SLA,包含维护。这种与 PostgreSQL 兼容的数据库的可靠性级别是通过云原生架构实现的,该架构可确保快速故障恢复和存储持久性。
4. AlloyDB 设置
在本实验中,我们将使用 AlloyDB 作为测试数据的数据库。它使用 集群来保存所有资源,例如数据库和日志。 每个集群都有一个 主实例,用于提供对数据的接入点。表将保存实际数据。
让我们创建一个 AlloyDB 集群、实例和表,以便加载测试数据集。
- 点击该按钮,或将以下链接复制到您已登录 Google Cloud 控制台用户的浏览器中。
点击上述按钮的替代方法(推荐):
# 1. Clone the repository
git clone https://github.com/GoogleCloudPlatform/devrel-demos.git
# 2. Navigate to the project directory
cd devrel-demos/infrastructure/easy-alloydb-setup
- 此步骤完成后,代码库将克隆到本地 Cloud Shell 编辑器,您将能够从项目文件夹中运行以下命令(请务必确保您位于项目目录中):
sh run.sh
- 现在,使用界面(点击终端中的链接或点击终端中的“在网页上预览”链接)。
- 输入项目 ID、集群和实例名称的详细信息,即可开始使用。
- 在日志滚动时,去喝杯咖啡,您可以在此处了解其在后台执行此操作的方式。
5. 设置图示

6. 清理
此试用实验完成后,请务必删除 AlloyDB 集群和实例。
它应清理集群及其实例。
7. 恭喜
一切就绪!
开始使用 AlloyDB 快速轻松地设置数据!