PGVector sur Cloud SQL pour GCP

La configuration manuelle du cloud peut parfois être chronophage et source d'incohérences—une étape de configuration manquée peut entraîner un comportement inattendu ou des problèmes de sécurité. Lors de la construction d'une application de recherche vectorielle, d'un système RAG, ou d'un moteur de recommandation sémantique pour la production, avoir une approche d'infrastructure fiable aux côtés de votre code applicatif peut être bénéfique.

Beaucoup d'entre nous ont expérimenté la satisfaction initiale de configurer des ressources via la Console Google Cloud, pour ensuite avoir du mal à recréer cet environnement ou partager la configuration exacte avec des collègues. Sans contrôle de version ni documentation, reproduire les environnements de manière cohérente peut être difficile.

Nous avons constaté que combiner Terraform pour la définition de l'infrastructure avec des Makefiles pour la simplification des opérations peut aider à résoudre certains défis courants. Cette approche vous permet de définir votre environnement cloud comme du code et potentiellement automatiser les déploiements.

En transformant votre stack de base de données vectorielle en code, vous obtenez :

Architecture complète montrant la structure du repository, le workflow et les ressources GCP

Prêt à construire quelque chose de cool ? Mettons les mains dans le cambouis avec une configuration PostgreSQL complète qui intègre les extensions pgvector. Plus d'étapes manuelles ni de configurations oubliées—juste de l'infrastructure pure et reproductible.

.
├── 📄 Makefile                # Interface principale pour toutes les opérations
├── 📁 terraform-sql/          # Configuration Terraform pour Cloud SQL
│   ├── 📁 environments/       # Configurations spécifiques par environnement
│   │   ├── 📁 dev/            # Environnement de développement
│   │   ├── 📁 preprod/        # Environnement de pré-production
│   │   └── 📁 prod/           # Environnement de production
│   └── 📁 modules/            # Modules Terraform réutilisables
│       ├── 📁 project/        # Configuration projet GCP
│       ├── 📁 sql/            # Configuration instance Cloud SQL
│       └── 📁 vpc/            # Configuration réseau
└── 📁 how_to_tutorials/       # Applications et démos exemples
    └── 📁 semantic_demo/      # Démo recherche sémantique

La configuration modulaire dans terraform-sql automatise les éléments suivants :

Le repository implémente différentes configurations de sécurité pour chaque environnement :

Vous pouvez déployer et gérer toute votre infrastructure de recherche vectorielle avec des commandes simples :

Une fois votre infrastructure déployée, configurez l'extension vectorielle avec une seule commande :

CREATE EXTENSION IF NOT EXISTS vector;

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name TEXT NOT NULL,
    description TEXT,
    embedding VECTOR(1536)
);

CREATE INDEX ON products USING ivfflat (embedding vector_cosine_ops) WITH (lists = 100);

Cette infrastructure peut supporter diverses applications basées sur les vecteurs :

Différences entre Environnements

Étapes de Déploiement