Skill materialize-postgres-create
✓ VérifiéCréez une matérialisation PostgreSQL pour diffuser les données des collections Estuary vers des tables PostgreSQL en utilisant flowctl.
- Étoiles GitHub
- 7
- Fichiers
- 1
- Dernier commit
- 4 nov. 2026
- Licence
- Apache-2.0
- Outils autorisés
- —
Que fait la skill materialize-postgres-create ?
Créez une matérialisation PostgreSQL pour diffuser les données des collections Estuary vers des tables PostgreSQL en utilisant flowctl.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill materialize-postgres-create
Cette SKILL permet de configurer PostgreSQL comme destination pour les données capturées depuis les collections Estuary. Elle guide les développeurs à travers tout le processus de création d'une matérialisation via flowctl afin de diffuser les données vers divers environnements PostgreSQL, notamment RDS, Aurora, Cloud SQL, Supabase, AlloyDB et Neon. L'agent gère le flux de travail, de la collecte des besoins spécifiques (chemins réseau, besoins SSL) à la génération du fichier de configuration flow.yaml nécessaire.
Lorsqu'un agent charge cette SKILL, il agit comme un assistant technique qui récupère la documentation officielle du connecteur via WebFetch et interroge le registre des connecteurs pour s'assurer que le tag d'image correct est utilisé. Il aide les utilisateurs à accomplir des tâches de configuration complexes telles que la configuration de tunnels SSH, la gestion des hard deletes ou l'activation des delta updates pour les journaux d'événements. La SKILL fournit également des avertissements spécifiques concernant les gestionnaires de pool de connexions comme PgBouncer ou PgCat, qui sont incompatibles avec les exigences de session du connecteur. Une fois la configuration prête, l'agent aide à publier la spécification et à vérifier le statut via les commandes flowctl.
Ce qu'un agent peut faire avec
- 1Configurer une destination PostgresMettre en place une matérialisation pour diffuser les données des collections Estuary vers une base de données PostgreSQL spécifique.
- 2Éviter les erreurs de gestionnaire de pool de connexionsIdentifier si un utilisateur tente d'utiliser un gestionnaire de pool de connexions comme Supabase ou Neon qui empêcherait le fonctionnement du connecteur.
- 3Générer un fichier de configuration de fluxConstruire un fichier flow.yaml valide contenant l'endpoint, l'image du connecteur et les bindings nécessaires pour la matérialisation.
- 4Dépanner les problèmes de connexion et de permissionsRésoudre les erreurs courantes telles que les timeouts de connexion, les échecs d'authentification ou les refus de permissions sur les schémas.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill materialize-postgres-create
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill materialize-postgres-create dans Plugin
/plugin marketplace add estuary/agent-skills /plugin install estuary-materializations@estuary
Installer la skill materialize-postgres-create dans Claude Code
~/.claude/skills/materialize-postgres-create/SKILL.md
$ npx degit estuary/agent-skills/skills/materialize-postgres-create ~/.claude/skills/materialize-postgres-createInstaller la skill materialize-postgres-create dans Claude Code (project)
.claude/skills/materialize-postgres-create/SKILL.md
$ npx degit estuary/agent-skills/skills/materialize-postgres-create .claude/skills/materialize-postgres-createInstaller la skill materialize-postgres-create dans Codex
~/.agents/skills/materialize-postgres-create/SKILL.md
$ npx degit estuary/agent-skills/skills/materialize-postgres-create ~/.agents/skills/materialize-postgres-createInstaller la skill materialize-postgres-create dans Gemini CLI
~/.gemini/skills/materialize-postgres-create/SKILL.md
$ npx degit estuary/agent-skills/skills/materialize-postgres-create ~/.gemini/skills/materialize-postgres-createInstaller la skill materialize-postgres-create dans Claude.ai
npx degit estuary/agent-skills/skills/materialize-postgres-create materialize-postgres-create && zip -r materialize-postgres-create.zip materialize-postgres-create # claude.ai → Customize → Skills → + → Create skill → Upload a skill → materialize-postgres-create.zip
Vérifications automatisées
Exécuté le 16 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessibleestuary/agent-skills/skills/materialize-postgres-create is public and reachablegithub.com/estuary/agent-skills/tree/HEAD/skills/materialize ↗Réussi
- Licence open source (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-11-04github.com/estuary/agent-skills/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/estuary/agent-skills/blob/HEAD/skills/materialize ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/estuary/agent-skills/blob/HEAD/skills/materialize ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 194 linesgithub.com/estuary/agent-skills/blob/HEAD/skills/materialize ↗Réussi
SKILL.md
Voir sur GitHubCreate PostgreSQL Materialization
Create a PostgreSQL materialization using flowctl to stream data from Estuary collections into PostgreSQL tables.
Applies to: materialize-postgres (all variants: vanilla, RDS, Aurora, Cloud SQL, Supabase, AlloyDB, Neon)
Step 0: Load Connector Documentation
Before proceeding, fetch the official connector docs for prerequisites, config reference, and setup instructions.
Load the docs page: https://docs.estuary.dev/reference/Connectors/materialization-connectors/PostgreSQL/
Use WebFetch to load this page. It covers:
- Prerequisites (user creation, permissions, schema setup)
- Full config property reference
- SSH tunnel configuration
- SSL configuration
- Advanced options (delta updates, hard deletes, sync schedule)
Search Kapa for tribal knowledge (if the Estuary MCP is configured):
Search kapa ai knowledge sources for "materialize postgres common issues"
If Kapa MCP is not configured, the user can set it up: https://docs.estuary.dev/features/mcp-integration/
This skill provides the flowctl workflow and troubleshooting that docs don't cover.
Step 1: Gather Requirements
Before writing any YAML, ask the user:
- Postgres variant? — Vanilla, RDS, Aurora, Cloud SQL, Supabase, AlloyDB
- Network path? — Direct connection (cloud-hosted with IP allowlist), SSH tunnel (private network/on-prem), or ngrok (local dev).
Connection poolers are NOT supported. If the user mentions Supabase, Neon, PgBouncer, or PgCat, warn them immediately:
- The connector uses session-level temporary tables and prepared statements that break with pooled connections.
- Supabase: Must use the Direct connection (
db.xxx.supabase.co:5432), not the pooler (xxx.pooler.supabase.com:6543). - Neon: Must use the non-pooler endpoint — remove
-poolerfrom the hostname.
- Non-default data plane? — Most users use the default. Ask if they need a non-default data plane.
- Target database and schema? — Database name, schema (default:
public) - Source collections? — Which Estuary collections to materialize
- SSL required? — Some cloud providers require SSL connections
- Hard deletes? — Off by default. Without it, deleted rows stay in the destination marked with
_meta/op: 'd'. Enable to physically remove them. - Delta updates? — Off by default. Switches from one-row-per-key (standard merge) to append-only. Use for event logs or history tables.
- Sync schedule? — Controls how often batches are written to the destination (default: 30 minutes,
0sfor real-time). Affects latency and destination compute cost.
Step 2: Find the Correct Connector Version
Always use the latest numbered version tag. Query the connector registry:
flowctl raw get --table connector_tags \
--query 'documentation_url=eq.https://go.estuary.dev/materialize-postgres' \
--query 'select=image_tag,documentation_url' \
--output yaml
Use the returned image_tag — never hardcode a version.
Step 3: Help User Complete Prerequisites
Walk the user through prerequisites from the docs loaded in Step 0:
- Database user — Create a user with write permissions on the target schema
- Schema permissions — USAGE and CREATE on target schema
- Table permissions — SELECT, INSERT, UPDATE, DELETE if materializing to existing tables
- Network access — Firewall rules or SSH tunnel configured
Refer to the docs page for exact SQL commands and cloud-specific instructions.
Step 4: Create the Spec File
Build flow.yaml using the config reference from the docs. Minimal required config:
materializations:
<TENANT>/<PATH>/materialize-postgres:
endpoint:
connector:
image: ghcr.io/estuary/materialize-postgres:<VERSION>
config:
address: "<HOST>:5432"
database: "<DATABASE>"
user: "<USERNAME>"
password: "<PASSWORD>"
schema: "<SCHEMA>"
bindings:
- source: <TENANT>/<collection-path>
resource:
table: "<TABLE_NAME>"
For SSH tunnel or SSL, add the appropriate config block — see docs for full reference.
Step 5: Publish
flowctl catalog publish --source flow.yaml --auto-approve
Step 6: Verify
# Check status
flowctl catalog status <TENANT>/<PATH>/materialize-postgres
# View logs
flowctl logs --task <TENANT>/<PATH>/materialize-postgres --since 5m | jq -c '{ts, message}'
Status progression:
PENDING— Normal for ~30 seconds during shard assignmentBACKFILLING— Initial data sync from collectionOK— Running normally with real-time updates
Troubleshooting
"connection refused" or timeout
Cause: Database not reachable from Estuary cloud
Fix:
- Verify firewall allows Estuary IP addresses (see docs)
- Check security groups (AWS) or firewall rules (GCP)
- Use SSH tunnel for private databases
- For local testing:
ngrok tcp 5432
"password authentication failed"
Cause: Incorrect credentials or user doesn't exist
Fix:
- Verify username and password
- Check user exists:
SELECT * FROM pg_user WHERE usename = '<user>'; - Verify user can connect from external hosts (check
pg_hba.conf)
"permission denied for schema"
Cause: User lacks permissions on target schema
Fix: Grant USAGE and CREATE on the target schema — see docs for SQL.
"relation already exists" or schema conflicts
Cause: Table already exists with incompatible schema
Fix:
- Drop and recreate the table
- Use a different table name
- Ensure collection schema matches existing table
Materialization stuck in PENDING
Wait 30-60 seconds — this is normal during shard assignment. If still stuck:
flowctl logs --task <TENANT>/<PATH>/materialize-postgres --since 5m | jq 'select(.level == "error")'
SSL connection errors
Cause: SSL mode mismatch or certificate issues
Fix:
- Try
sslmode: "require"first - For AWS RDS, SSL is usually required — use
verify-caorverify-full - For self-signed certs, use
requiremode - See docs for full SSL configuration options
SSH tunnel connection failures
Cause: SSH configuration issues
Fix:
- Verify bastion is reachable:
ssh -p 22 user@bastion - Check private key format (must be OpenSSH format)
- Verify bastion can reach database:
nc -zv db-host 5432 - See SSH tunnel troubleshooting docs
Related Skills
connector-disable-enable— Pause/restart existing materializationsconnector-delete-recreate— Nuclear option for stuck materializationsestuary-logs— Deep log analysisestuary-catalog-status— Status checking
Fichiers de cette skill
1Questions sur la skill materialize-postgres-create
Comment installer la skill materialize-postgres-create dans Claude Code ?
Exécutez npx degit estuary/agent-skills/skills/materialize-postgres-create ~/.claude/skills/materialize-postgres-create. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill materialize-postgres-create ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Puis-je utiliser des gestionnaires de pool de connexions comme PgBouncer ou le pooler de Supabase avec ce connecteur ?
Non, les gestionnaires de pool de connexions ne sont pas pris en charge car le connecteur utilise des tables temporaires au niveau de la session et des requêtes préparées qui ne fonctionnent pas avec les connexions mutualisées.
Comment gérer les lignes supprimées dans la table de destination ?
Par défaut, les lignes supprimées restent dans la destination avec un indicateur de métadonnées. Vous devez activer les « hard deletes » pour les supprimer physiquement.
Comment diffuser les données sous forme de journal d'événements en mode append-only plutôt qu'en mode merge standard ?
Vous pouvez activer les « delta updates » pour passer d'un mode une ligne par clé à un mode append-only.