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`...

neondatabase310,776+ تثبيتموثوق

نبذة

**أولا**: استخدم مهارة `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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في البيانات والتحليلات.

كل بدائل Neon Postgres ←
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
سجل Hyperframes
حوالي 450 كتلة ومكون HyperFrames جاهزة مثبتة كمصدر قابل للتحرير - انتقالات، تراكبات، عناوين، نصوص حركية، تسميات توضيحية، رسوم بيانية، تراكبات خرائط، ث…1,218,043+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Microsoft Foundry
بناء ونشر وتقييم وتحسين وضبط وإدارة وكلاء ونماذج وموارد Microsoft Foundry من البداية إلى النهاية. يستخدم من أجل: foundry, azd ai agent, azd provision/…702,909+
skillclaude_appclaude_codeclaude_api
npx skills add google/agents-cli
مراقبة واجهة سطر الأوامر لوكلاء Google
تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تكوين التسجيل"، "إضافة قابلية المراقبة"، "تصحيح أخطاء حركة المرور في الإنتا…568,165+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Azure Kusto
استعلام وتحليل البيانات في Azure Data Explorer (Kusto/ADX) باستخدام KQL لتحليلات السجلات، القياس عن بعد، وتحليل السلاسل الزمنية. متى: استعلامات KQL، ا…552,598+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
تخزين Azure
خدمات Azure Storage بما في ذلك Blob Storage وFile Shares وQueue Storage وTable Storage وData Lake. يجيب على الأسئلة المتعلقة بمستويات الوصول للتخزين (…546,701+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الساحر
أنشئ معالج bash تفاعليا يرشد المستخدم البشري عبر خطوات لا يمكن إلا له تنفيذها. استخدمه عند توفير البنية التحتية، أو إعداد بيانات الاعتماد أو أسرار CI،…424,988+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في البيانات والتحليلات