في هذا التشغيل السريع، ستنشئ قاعدة بيانات صغيرة نموذجية وتنشرها، ثم ستصل إليها من واجهة أمامية تستخدم React.
المتطلبات الأساسية
لإكمال هذا التشغيل السريع، ستحتاج إلى ما يلي:
- بيئة Node.js مع NPM
- حساب Google
برنامج تعليمي
| برنامج تعليمي | |
|---|---|
1. إعداد مشروعكأنشئ دليلاً جديدًا وأضِف إليه مشروع Firebase. عند المطالبة، حدِّد الخيارات التالية:
|
|
2. مراجعة أمثلة على تعريفات GraphQLفي SQL Connect، يمكنك تحديد جميع مخططات قاعدة البيانات وعملياتها باستخدام GraphQL. عند إعداد مشروعك، أنشأ Firebase CLI بعض تعريفات الأمثلة لمساعدتك على البدء. |
dataconnect/schema/schema.gql (مقتطف)
type Movie @table { title: String! imageUrl: String! genre: String } type MovieMetadata @table { movie: Movie! @unique rating: Float releaseYear: Int description: String } query ListMovies @auth(level: PUBLIC) { movies { id title imageUrl genre } } |
3- نشر المخططات والعملياتعند إجراء تغييرات على مخططات قاعدة البيانات أو طلبات البحث أو عمليات التعديل، عليك نشرها حتى يتم تطبيق التغييرات على قاعدة البيانات. |
|
4. تعبئة قاعدة البيانات ببيانات نموذجيةستمنحك بيانات البداية هذه شيئًا يمكنك الاطّلاع عليه عند اختبار نموذج التطبيق. يُرجى العِلم بأنّك في هذه الخطوة ستنفّذ رمز GraphQL عشوائيًا، وهو أمر مسموح به للمهام الإدارية. |
|
5- إنشاء حزمة تطوير برامج (SDK) لعميل JavaScriptيستخدم هذا الأمر تعريفات GraphQL لإنشاء مكتبة JavaScript خاصة بقاعدة البيانات، وتتضمّن تعريفات الأنواع. يمكنك استخدام هذه المكتبة في تطبيق العميل لتنفيذ جميع عمليات قاعدة البيانات. يمكنك إنشاء مكتبات لأنظمة أساسية متعددة، بما في ذلك Kotlin لنظام Android وSwift لنظام iOS وFlutter، وذلك عن طريق إضافة تعريفات إلى |
export interface ListMoviesData { movies: ({ id: UUIDString; title: string; imageUrl: string; genre?: string | null; } & Movie_Key)[]; } export function useListMovies( options?: useDataConnectQueryOptions&<ListMoviesData> ): UseDataConnectQueryResult&<ListMoviesData, undefined>; |
6. إعداد تطبيق ويبنفِّذ هذه الأوامر لإضافة تطبيق ويب جديد إلى مشروع Firebase. |
|
7. كتابة نموذج لبرنامج Reactاستبدِل محتوى لاحظ أنّ التطبيق يكمل عملية الوصول اللازمة إلى قاعدة البيانات باستخدام دالة من حزمة SDK التي تم إنشاؤها. يستخدم حزمة تطوير البرامج (SDK) التي تم إنشاؤها لتطبيق React مكتبة TanStack Query للتعامل مع إدارة الحالة. |
import { initializeApp } from 'firebase/app'; import firebaseConfig from './firebase-config.json'; import { QueryClient, QueryClientProvider } from '@tanstack/react-query'; import { useListMovies } from '@dataconnect/generated/react'; import './App.css'; const app = initializeApp(firebaseConfig); const queryClient = new QueryClient(); function App() { return ( <QueryClientProvider client={queryClient}> <Movies /> </QueryClientProvider> ); } function Movies() { const { isLoading, data } = useListMovies(); if (isLoading) { return <h1>...</h1> } return ( <> {data?.movies.map( movie => <h1 key={movie.id}>{movie.title}</h1> )} </> ); } export default App; |
8. تجربة تطبيق الويبابدأ تشغيل خادم التطوير لمشاهدة مثال التطبيق أثناء عمله. |
|
الخطوات التالية
جرِّب إضافة SQL Connect VS Code
عند التطوير باستخدام SQL Connect، ننصحك بشدة باستخدام إضافة SQL Connect في Visual Studio Code. حتى إذا لم تكن تستخدم Visual Studio Code كبيئة التطوير الأساسية، يوفّر لك هذا الامتداد العديد من الميزات التي تجعل عملية تطوير المخططات والعمليات أكثر ملاءمة:
- خادم لغة GraphQL يوفّر عمليات التحقّق من البنية واقتراحات الإكمال التلقائي الخاصة بـ SQL Connect
- أزرار CodeLens بجانب الرمز البرمجي تتيح لك قراءة البيانات وكتابتها من ملفات تعريف المخطط وتنفيذ طلبات البحث وعمليات التعديل من تعريفات العمليات.
- الحفاظ على مزامنة حِزم SDK التي تم إنشاؤها تلقائيًا مع تعريفات GraphQL
- إعداد مبسّط للمحاكي المحلي
- نشر مبسّط للإصدار العلني
استخدام محاكي SQL Connect للتطوير المحلي
على الرغم من أنّ هذا البرنامج التعليمي قد أوضح لك كيفية نشر مخططات SQL Connect وعملياته مباشرةً، من المحتمل أنّك لن تريد إجراء تغييرات على قاعدة بياناتك النشطة أثناء تطوير تطبيقك. بدلاً من ذلك، يمكنك إعداد محاكي SQL Connect وإجراء عملية التطوير عليه بدلاً من قاعدة البيانات النشطة. يُعدّ المحاكي نسخة محلية من PGlite تتصرف بشكل مشابه لنسخة PostgreSQL مباشرة على Cloud SQL.
التعرّف على كيفية كتابة المخططات والعمليات لتطبيقك
عند تطوير تطبيقات باستخدام SQL Connect، يُعد تصميم المخططات والعمليات من أولى مهام التطوير وأهمها التي ستُكملها.
- Gemini في وحدة تحكّم Firebase هو أداة مستندة إلى الذكاء الاصطناعي يمكنها إنشاء مخططات SQL Connect من وصف بلغة طبيعية لتطبيقك. يمكن أن تساعدك هذه الأداة في البدء بسرعة كبيرة، خاصةً إذا لم يسبق لك العمل مع قواعد البيانات العلائقية.
- يمكنك بدلاً من ذلك كتابة مخططات قاعدة البيانات والاستعلامات والتعديلات مباشرةً باستخدام GraphQL. ابدأ بالاطّلاع على الإرشادات في صفحة تصميم مخططات SQL Connect، ثم انتقِل إلى الصفحات التالية للتعرّف على كيفية كتابة العمليات.