neon-postgres

Навык Neon Postgres объясняет работу с PostgreSQL в архитектуре Neon, которую источник описывает через Lakebase Postgres. Он предназначен для задач настройки проекта, выбора способа подключения и эксплуатации базы в приложениях и coding-agent workflows. В начале предлагается выбрать организацию и проект через CLI или MCP, проверить связанный файл .neon, а строку подключения хранить в DATABASE_URL. Это даёт понятную последовательность: сначала определить нужный проект и ветку, затем выбрать соединение и драйвер под режим работы, а после этого перейти к схеме и операциям базы. Ключевая практическая часть — различие pooled и direct connections. Пул соединений рекомендуется для web-приложений, serverless-функций и bursty-нагрузки; прямое подключение — для миграций, pg_dump/pg_restore, логической репликации, долгих аналитических операций с временными таблицами и задач, которым нужен session state. В источнике отдельно упомянут PgBouncer и вариант с суффиксом -pooler в имени хоста. Для драйверов рассматриваются ORM и несколько окружений: Drizzle как ORM, node-postgres для Vercel Fluid compute и Cloudflare Hyperdrive, @neondatabase/serverless для serverless- и edge-сценариев. Конкретный выбор зависит от runtime и характера транзакций, поэтому навык не сводит все подключения к одному универсальному рецепту. Навык охватывает ветвление Neon для изолированной разработки, preview и тестирования миграций; autoscaling для автоматического изменения вычислительных ресурсов; scale-to-zero для снижения затрат простаивающих вычислений; instant restore и Time Travel для восстановления из исторической точки; read replicas для чтения с независимым масштабированием compute; IP allow lists для ограничения сетевого доступа; и logical replication для CDC и обмена данными с внешними системами. Для каждого направления исходный документ указывает, когда оно уместно, и отсылает к отдельным страницам документации. Рабочие сценарии включают создание Neon-проекта, безопасный выбор DATABASE_URL для web или миграций, настройку branching перед изменением схемы, подготовку чтения через replica, разбор холодного старта после scale-to-zero и проектирование репликации. При этом источник прямо предлагает сначала использовать родительский skill neon для общего обзора и предупреждает, что отдельные задачи могут потребовать дополнительных skills, например для веток. Не следует воспринимать этот материал как автоматическую миграцию или гарантию производительности: схему, права, секреты, лимиты и режим соединения нужно проверить в конкретном проекте до применения команд.