---
id: gh-alloydb-basics
name: "alloydb-basics"
url: https://skills.yangsir.net/skill/gh-alloydb-basics
author: google
domain: cloud-infra
tags: ["alloydb", "gcp", "database", "cloud-infrastructure", "postgresql"]
install_count: 13000
rating: 4.50 (120 reviews)
github: https://github.com/google/skills/tree/main/skills/cloud/alloydb-basics
---

# alloydb-basics

> AlloyDB Basics 技能提供 Google Cloud 上 AlloyDB for PostgreSQL 数据库的基础管理能力，包括集群和实例的创建与配置。它帮助开发者利用 AlloyDB 的高性能、高可用特性，并集成其AI功能（如向量搜索和AI函数），加速构建企业级AI应用，优化数据存储与处理效率。

**Stats**: 13,000 installs · 4.5/5 (120 reviews)

## Before / After 对比

### 数据库集群部署时间

**Before**:

手动设置和配置高可用 PostgreSQL 数据库集群，包括网络和安全，通常需要数小时甚至数天，且需要深厚的专业知识，导致部署延迟和潜在的配置错误。

**After**:

使用 AlloyDB Basics 这一托管服务，通过简单的命令即可在数分钟内完成集群和实例的创建，显著减少设置时间与运维开销，让开发者专注于应用逻辑而非基础设施。

| Metric | Before | After | Change |
|---|---|---|---|
| 部署时间 | 240分钟 | 10分钟 | -96% |

## Readme

# AlloyDB Basics

AlloyDB for PostgreSQL is a managed, PostgreSQL-compatible database service
designed for enterprise-grade performance and availability. It utilizes a
disaggregated compute and storage architecture to scale resources independently.
It also provides AlloyDB AI, a collection of features that includes AI-powered
search (vector, hybrid search, and AI functions), natural language capabilities,
conversational analytics, and inference features like forecasting and model
endpoint management to help developers build AI apps faster.

## Quick Start

1.  **Enable the AlloyDB API:**

    ```bash
    gcloud services enable alloydb.googleapis.com --quiet
    ```

2.  **Create a Cluster:**

    ```bash
    gcloud alloydb clusters create my-cluster --region=us-central1 \
        --password=my-password --network=my-vpc \
        --quiet
    ```

    *Note: For production, we recommend using IAM database authentication
    instead of passwords. If passwords must be used, use secure secret
    management (e.g., Secret Manager) instead of passing passwords in
    cleartext.*

3.  **Create a Primary Instance:**

    ```bash
    gcloud alloydb instances create my-primary --cluster=my-cluster \
        --region=us-central1 --instance-type=PRIMARY --cpu-count=2 \
        --quiet
    ```

## Reference Directory

-   [Core Concepts](references/core-concepts.md): Architecture, disaggregated
    storage, and performance features.

-   [CLI Usage](references/cli-usage.md): Essential `gcloud alloydb` commands
    for cluster and instance management.

-   [Client Libraries & Connectors](references/client-library-usage.md):
    Connecting to AlloyDB using Python, Java, Node.js, and Go.

-   [MCP Usage](references/mcp-usage.md): Using the AlloyDB remote MCP server
    and Gemini CLI extension.

-   [Infrastructure as Code](references/iac-usage.md): Terraform
    configuration and deployment examples.

-   [IAM & Security](references/iam-security.md): Predefined roles, service
    agents, and database authentication.

*If you need product information not found in these references, use the
    Developer Knowledge MCP server `search_documents` tool.*

---
*Source: https://skills.yangsir.net/skill/gh-alloydb-basics*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-alloydb-basics/markdown*