skill
Neon Postgres
أدلة وأفضل الممارسات للعمل مع Lakebase Postgres على Neon: الاتصالات، المجمعة مقابل المباشرة، ترحيلات المخطط (schema migrations)، التفريع (branching) (بما في ذلك سير عمل المخطط فقط، إعادة الضبط من الأصل، والفرع لكل طلب سحب)، التحجيم التلقائي (autoscaling)، التحجيم إلى الصفر (scale-to-zero)، الاستعادة الفورية، النسخ المتماثلة للقراءة (read replicas)، قوائم السماح ل IP، النسخ المتماثل المنطقي (logical replication)، تحسين الخروج (egress optimization)، و Lakebase Search. تستخدم عندما يكون العمل عبارة عن DATABASE_URL موجودة، SQL، مخطط (schema)، فحص (inspect)، أو بحث (search). الواجهات الخلفية الجديدة (backends)، المصادقة (Auth)، الملفات، الدوال (Functions)، واستدعاءات LLM تذهب إلى الأصل `neon`...
نبذة
**أولا**: استخدم مهارة `neon` الأصلية للحصول على نظرة عامة عن Neon، والبدء في استخدام Neon، وأفضل ممارسات تطوير Neon، والمزيد.
إذا لم تكن مهارة `neon` مثبتة، فاحضرها من https://neon.com/docs/ai/skills/neon/SKILL.md أو قم بتثبيتها باستخدام:
```bash neon skills -s neon -y ```
# Lakebase Postgres
Lakebase Postgres هي قاعدة البيانات في صميم Neon. تعمل على بنية Lakebase — OLTP مبنية مباشرة على تخزين الكائنات السحابي — والتي تفصل التخزين عن الحوسبة لتقديم التوسع التلقائي، والتفرع، والاستعادة الفورية، والتوسع إلى الصفر. إنها متوافقة تماما مع Postgres وتعمل مع أي لغة أو إطار عمل أو ORM يدعم Postgres.
إنها نفس قاعدة البيانات سواء وصلت إليها عبر Neon أو عبر Databricks؛ وتغطي هذه المهارة مسار الوصول عبر Neon.
تسجيل الدخول، والمستخدمون، والجلسات، و`@neon/auth` تنتمي إلى `neon-auth`.
الاستعلامات المباشرة، وواجهات المستخدم التفاعلية، والبيانات في الوقت الفعلي تنتمي إلى `neon-realtime`.
## سير عمل الإعداد
### 1. حدد المؤسسة والمشروع
إذا تم توفير `DATABASE_URL` بالفعل (عبر الموجه، أو البيئة، أو المستودع) أو كان ملف `.neon` يشير إلى مشروع، فاستخدمه. لا تسرد المؤسسات أو تنشئ مشروعا ثانيا لعمل المخطط.
وإلا، استخدم CLI (افتراضي) أو خادم MCP لسرد المؤسسات والمشاريع. دع المستخدم يختار مشروعا موجودا أو ينشئ مشروعا جديدا.
### 2. احصل على سلسلة الاتصال
إذا تم توفير `DATABASE_URL` بالفعل، فاستخدمه. لا تجلب آخر عبر CLI أو MCP.
وإلا، استخدم CLI (افتراضي)، أو `neon env pull`، أو خادم MCP للحصول على سلسلة الاتصال. قم بتخزينها في `.env` ك `DATABASE_URL`. اقرأ الملف أولا قبل تعديله، لتجنب الكتابة فوق القيم الموجودة.
#### متى تستخدم الاتصالات المجمعة مقابل الاتصالات المباشرة
| حالة الاستخدام | نوع الاتصال | | ---------------------------------------- | ---------------- | | تطبيقات الويب، الدوال بلا خادم | مجمع (-pooler) | | ترحيلات المخطط | مباشر | | pg_dump / pg_restore | مباشر | | النسخ المتماثل المنطقي | مباشر | | التحليلات طويلة الأمد مع الجداول المؤقتة | مباشر | | مهام الإدارة التي تتطلب SET أو حالة الجلسة | مباشر | | LISTEN / NOTIFY | مباشر |
### 3. اختر طريقة الاتصال والمشغل
حافظ على ORM والمشغل الحاليين. لعمل مخطط TypeScript الجديد بدون خيار محدد، Drizzle هو اقتراح: https://neon.com/docs/guides/drizzle.md. ارجع إلى دليل طرق الاتصال لاختيار المشغل الصحيح بناء على كيفية تعامل وقت التشغيل مع التعليمات البرمجية الخاصة بك: https://neon.com/docs/connect/choose-connection.md.
ملاحظات المشغل:
- على Vercel، استخدم `node-postgres` (`npm install pg`) مع Vercel Fluid compute و `import { attachDatabasePool } from "@vercel/functions";` - على Cloudflare، استخدم `node-postgres` مع Cloudflare Hyperdrive - على Neon Functions، استخدم `node-postgres`، حيث أن الدوال طويلة الأمد وتعيد استخدام المجمع عبر الطلبات. - استخدم مشغل `@neondatabase/serverless` لبيئات بلا خادم والحافة (على سبيل المثال، عند استخدام Netlify) — نقل HTTP للاستعلامات الفردية، و WebSocket لدعم المعاملات. الرابط: https://neon.com/docs/serverless/serverless-driver.md
### 4. إعداد المخطط
إدارة المخططات والترحيلات كتعليمات برمجية. تجنب تشغيل ترحيلات المخطط المخصصة ضد قاعدة البيانات الخاصة بك، لأنها يصعب إدارتها.
إذا كنت تستخدم ORM، فاتبع أفضل ممارسات ORM لإدارة المخططات والترحيلات. على سبيل المثال، إذا كنت تستخدم Drizzle، فاستخدم Drizzle فقط لإدارة المخطط والترحيل ما لم يطلب منك خلاف ذلك.
## التفرع
استخدم هذا عندما يخطط المستخدم لبيئات معزولة، أو اختبار ترحيل المخطط، أو عمليات النشر التجريبية، أو أتمتة دورة حياة الفرع.
النقاط الرئيسية:
- الفروع فورية، ونسخ عند الكتابة (لا يوجد نسخ كامل للبيانات). - لكل فرع نقطة نهاية حوسبة خاصة به. - استخدم Neon CLI أو خادم MCP لإنشاء الفروع وفحصها ومقارنتها.
الرابط: https://neon.com/docs/introduction/branching.md
للحصول على سير عمل إنشاء الفروع المفصل (الفروع العادية مقابل الفروع المخصصة للمخطط فقط، إعادة التعيين من الأصل، اختيار CLI/MCP، وأنماط CI/CD)، اقرأ [سير عمل التفرع](references/branching.md).
## الترحيلات
اختبر الترحيل على فرع من الإنتاج، مقابل بيانات شبيهة بالإنتاج، قبل تطبيقه على الإنتاج.
استخدم سلسلة اتصال **مباشرة (غير مجمعة)** عند تشغيل الترحيل، وليس سلسلة مجمعة. `neon connection-string` ترجع السلسلة المباشرة افتراضيا؛ تأكد من أن اسم المضيف لا يتضمن اللاحقة `-pooler`.
## تحسين الخروج (Egress Optimization)
استخدم هذا عندما يبلغ المستخدم عن فواتير قاعدة بيانات عالية، أو نقل شبكة غير متوقع، أو ارتفاعات في الخروج، أو جلب زائد للاستعلامات، أو يرغب في مراجعة كفاءة التكلفة لأنماط استعلام قاعدة البيانات.
قبل تعديل التعليمات البرمجية، اقرأ [تحسين الخروج](references/egress-optimization.md). قم بتدقيق جميع الأنماط الخمسة: الأعمدة غير المستخدمة، والترقيم المفقود، والقراءات الثابتة المتكررة، والتجميع من جانب التطبيق، وتكرار JOIN. لا تتوقف بعد إصلاح `SELECT *`.
اعمل في
التثبيت
شغل هذا الأمر
npx skills add neondatabase/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add neondatabase/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/neon-postgres` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة Neon Postgres؟
أدلة وأفضل الممارسات للعمل مع Lakebase Postgres على Neon: الاتصالات، المجمعة مقابل المباشرة، ترحيلات المخطط (schema migrations)، التفريع (branching) (بما في ذلك سير عمل المخطط فقط، إعادة الضبط من الأصل، والفرع لكل طلب سحب)، التحجيم التلقائي (autoscaling)، التحجيم إلى الصفر (scale-to-zero)، الاستعادة الفورية، النسخ المتماثلة للقراءة (read replicas)، قوائم السماح ل IP، النسخ المتماثل المنطقي (logical replication)، تحس…
كيف أثبت Neon Postgres؟
شغل هذا الأمر في الطرفية:
npx skills add neondatabase/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل Neon Postgres؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور Neon Postgres؟
طورها neondatabase.
هل Neon Postgres مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add heygen-com/hyperframes
npx skills add microsoft/azure-skills
npx skills add google/agents-cli
npx skills add microsoft/azure-skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى