1. 概要
この Codelab では、AlloyDB を設定する簡単でシンプルな方法を説明します。

作成するアプリの概要
この一環として、ワンクリック インストールで AlloyDB インスタンスとクラスタを作成します。また、今後のプロジェクトで迅速に設定する方法も学びます。
要件
2. 始める前に
プロジェクトを作成する
- Google Cloud コンソールのプロジェクト選択ページで、Google Cloud プロジェクトを選択または作成します。
- Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。
- Google Cloud 上で動作するコマンドライン環境の Cloud Shell を使用します。Google Cloud コンソールの上部にある [Cloud Shell をアクティブにする] をクリックします。
![[Cloud Shell をアクティブにする] ボタンの画像](https://codelabs.developers.google.com/static/quick-alloydb-setup/img/91567e2f55467574.png?hl=ja)
- 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. ビジネスデータと AI に AlloyDB を選ぶ理由
AlloyDB for PostgreSQL は、単なるマネージド Postgres サービスではありません。これは、AI 時代に向けて設計されたエンジンの根本的なモダナイゼーションです。標準的なデータベースと比較して、スタンドアロンである理由は次のとおりです。
- ハイブリッド トランザクション処理と分析処理(HTAP)
ほとんどのデータベースでは、分析のためにデータをデータ ウェアハウスに移動する必要があります。AlloyDB には、関連データをカラムストアのメモリ内に自動的に保持するカラム型エンジンが組み込まれています。これにより、分析クエリは標準の PostgreSQL よりも最大 100 倍高速になり、複雑な ETL パイプラインを使用せずに運用データに対してリアルタイムのビジネス インテリジェンスを実行できます。
- ネイティブ AI 統合:
AlloyDB は、データと生成 AI のギャップを埋めます。google_ml_integration 拡張機能を使用すると、SQL クエリ内で Vertex AI モデル(Gemini など)を直接呼び出すことができます。つまり、感情分析、翻訳、エンティティ抽出を標準のデータベース トランザクションとして実行できるため、データ セキュリティを確保し、レイテンシを最小限に抑えることができます。
- 優れたベクトル検索:
標準の PostgreSQL は pgvector を使用しますが、AlloyDB は Google Research が開発した ScaNN インデックス(スケーラブルな最近傍)で pgvector を大幅に強化します。これにより、他の Postgres サービスで提供されている標準の HNSW インデックスと比較して、ベクトル類似性検索が大幅に高速化され、大規模な再現率が向上します。これにより、高性能な RAG(検索拡張生成)アプリケーションをネイティブに構築できます。
- 大規模なパフォーマンス:
AlloyDB は、標準の PostgreSQL と比べて最大 4 倍高速のトランザクション パフォーマンスを提供します。コンピューティングとストレージが分離されているため、それぞれを個別にスケーリングできます。ストレージ レイヤはインテリジェントで、Write-Ahead Logging(WAL)処理を処理して、プライマリ インスタンスから作業をオフロードします。
- Enterprise の可用性:
メンテナンスを含めて、稼働時間 99.99% の SLA を提供します。PostgreSQL 互換データベースのこのレベルの信頼性は、迅速な障害復旧とストレージの耐久性を確保するクラウドネイティブ アーキテクチャによって実現されています。
4. AlloyDB の設定
このラボでは、テストデータのデータベースとして AlloyDB を使用します。クラスタを使用して、データベースやログなどのすべてのリソースを保持します。各クラスタには、データへのアクセス ポイントを提供するプライマリ インスタンスがあります。テーブルには実際のデータが格納されます。
テスト データセットを読み込む AlloyDB クラスタ、インスタンス、テーブルを作成しましょう。
- ボタンをクリックするか、以下のリンクを Google Cloud コンソールのユーザーがログインしているブラウザにコピーします。
- この手順が完了すると、リポジトリがローカルの Cloud Shell エディタにクローンされ、プロジェクト フォルダから次のコマンドを実行できるようになります(プロジェクト ディレクトリにいることを確認することが重要です)。
sh run.sh
- UI を使用します(ターミナルのリンクをクリックするか、ターミナルの [ウェブでプレビュー] リンクをクリックします)。
- プロジェクト ID、クラスタ名、インスタンス名の詳細を入力して、開始します。
- ログがスクロールしている間にコーヒーを飲んで、裏で何が行われているかについてはこちらをご覧ください。
5. セットアップの図解

6. クリーンアップ
このトライアルラボが完了したら、alloyDB クラスタとインスタンスを削除することを忘れないでください。
クラスタとそのインスタンスをクリーンアップする必要があります。
7. 完了
これで準備完了です。