أمثلة Azure Cosmos DB.NET v 3 SDK (Microsoft.Azure.Cosmos) لواجهة برمجة تطبيقات SQL
ينطبق على: 
واجهة برمجة تطبيقات SQL
يتضمن مستودع azure-cosmos-dotnet-v3 GitHub أحدث نماذج حلول Microsoft .NET. يمكنك استخدام هذه الحلول لتنفيذ CRUD (إنشاء وقراءة وتحديث وحذف) والعمليات الشائعة الأخرى على موارد Azure Cosmos DB.
إذا كنت على دراية بالإصدار السابق من .NET SDK، فقد تكون معتادًا على مجموعة المصطلحات والمستندات. نظرًا لأن Azure Cosmos DB يدعم العديد من نماذج واجهة برمجة التطبيقات، فإن الإصدار 3.0 من .NET SDK يستخدم المصطلحات العامة الحاوية والعنصر. يمكن أن تكون الحاوية عبارة عن مجموعة أو رسم بياني أو جدول. يمكن للعنصر أن يكون مستندًا أو حافة/رأسًا أو صفًا، وهو المحتوى الموجود داخل الحاوية. توفر هذه المقالة:
- روابط إلى المهام في كل من ملفات مثال المشروع C#.
- روابط إلى المحتوى المرجعي API ذات الصلة.
المتطلبات الأساسية
أحدث إصدار Visual Studio مع أحمال عمل تطوير Azure. يمكنك البدء باستخدام بيئة التطوير المتكامل IDE المجانيةلمجتمع Visual Studio. بادر بتمكين حمل عمل تطوير Azure أثناء إعداد Visual Studio.
اشتراك Azure أو حساب تجريبي مجاني في Azure Cosmos DB.
- إذا لم يكن لديك اشتراك Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
تنشيط مزايا المشتركين Visual Studio. يمنحك اشتراك Visual Studio أرصدة كل شهر، والتي يمكنك استخدامها لخدمات Azure المدفوعة.
-
يمكنك تجربة Azure Cosmos DB مجانًا، دون اشتراك Azure، ودون الحاجة إلى أي التزام. بدلاً من ذلك، يمكنك إنشاء حساب Azure Cosmos DB مجاني ، مع أول 400 RU/s و 5GB من التخزين مجانًا. يمكنك أيضًا استخدام محاكي Azure Cosmos DB مع عنوان URL المستخدم
https://localhost:8081. لاستخدام المفتاح مع المحاكي، راجع مصادقة الطلبات.
ملاحظة
العينات قائمة بذاتها ويتم إعدادها وتنظيفها ذاتيًا. كل تكرار فواتير اشتراكك لمدة ساعة واحدة من الاستخدام في مستوى الأداء الحاوية الخاصة بك.
أمثلة قاعدة البيانات
يوضح أسلوب RunDatabaseDemo لنموذج مشروع DatabaseManagement طريقة تنفيذ المهام التالية. للتعرف على قواعد بيانات Azure Cosmos DB قبل تشغيل العينات التالية، راجع العمل مع قواعد البيانات والحاويات والعناصر.
أمثلة الحاوية
يوضح أسلوب RunContainerDemo من مشروع ContainerManagement النموذجي كيفية القيام بالمهام التالية. للتعرف على حاويات Azure Cosmos DB قبل تشغيل العينات التالية، راجع العمل مع قواعد البيانات والحاويات والعناصر.
أمثلة على الأصناف
يوضح أسلوب RunItemsDemo من مشروع ItemManagement النموذجي كيفية القيام بالمهام التالية. للتعرف على عناصر Azure Cosmos DB قبل تشغيل العينات التالية، راجع العمل مع قواعد البيانات والحاويات والعناصر.
فهرسة الأمثلة
يوضح أسلوب RunIndexDemoلنموذج مشروع IndexManagementطريقة تنفيذ المهام التالية. للتعرّف على الفهرسة في Azure Cosmos DB قبل تشغيل النماذج التالية، راجع سياسات الفهرس، وأنواع الفهرس، ومسارات الفهرس.
أمثلة الاستعلام
يوضح أسلوب RunDemoAsync لنموذج مشروع Queries طريقة تنفيذ المهام التالية باستخدام قواعد لغة استعلام SQL، ومقدم LINQ مع الاستعلام، و Lambda. للتعرّف على مرجع استعلام SQL في خدمة Azure Cosmos DB قبل تشغيل النماذج التالية، راجع نماذج استعلامات SQL لخدمة Azure Cosmos DB.
أمثلة لموجز التغييرات
يوضح أسلوب RunBasicChangeFeed من مشروع ChangeFeed النموذجي كيفية القيام بالمهام التالية. وللتعرّف على موجز التغييرات في خدمة Azure Cosmos DB قبل تشغيل النماذج التالية، راجع قراءة موجز التغييرات في Azure Cosmos DB ومعالج موجز التغيير.
أمثلة برمجة من جانب الخادم
يوضح أسلوب RunDemoAsync لنموذج مشروع ServerSideScripts طريقة تنفيذ المهام التالية. للتعرّف على البرمجة من جانب الخادم في خدمة Azure Cosmos DB قبل تشغيل النماذج التالية، راجعالإجراءات المخزّنة والمشغّلات والوظائف المعرّفة بواسطة المستخدم.
| المهمة | مرجع واجهة برمجة التطبيقات |
|---|---|
| إنشاء إجراء مخزّن | Scripts.CreateStoredProcedureAsync |
| قم بتنفيذ إجراء مخزن | Scripts.ExecuteStoredProcedureAsync |
| حذف إجراء مخزّن | Scripts.DeleteStoredProcedureAsync |
تسلسل مخصص
يعرض مشروع عينة SystemTextJson كيفية استخدام مسلسل مخصص عند تهيئة عنصر CosmosClient جديد. تتضمن العينة أيضًا فئة CosmosSerializer مخصصة، والتي تستخدم System.Text.Json للتسلسل وإزالة التسلسل.
الخطوات التالية
هل تحاول القيام بتخطيط السعة للترحيل إلى Azure Cosmos DB؟ يمكنك استخدام معلومات حول مجموعة قاعدة البيانات الموجودة لتخطيط السعة.
إذا كان كل ما تعرفه هو عدد vCores والخوادم في مجموعة قاعدة البيانات الحالية، فاقرأ عن تقدير وحدات الطلب باستخدام vCores أو vCPUs.
إذا كنت تعرف معدلات الطلب النموذجية لحجم عمل قاعدة البيانات الحالية، فاقرأ عن تقدير وحدات الطلب باستخدام مخطط سعة Azure Cosmos DB .