اقرأ باللغة الإنجليزية

مشاركة عبر

كيفية استخدام Spring Data API ل Apache Cassandra مع Azure Cosmos DB ل Apache Cassandra

  • مقالة

ينطبق على: كاساندرا

توضح هذه المقالة إنشاء نموذج تطبيق يستخدم Spring Data لتخزين المعلومات واستردادها باستخدام Azure Cosmos DB ل Apache Cassandra.

المتطلبات الأساسية

المتطلبات الأساسية التالية مطلوبة لاستكمال الخطوات المذكورة في هذه المقالة:

  • اشتراك Azure; إذا لم يكن لديك اشتراك Azure بالفعل، يمكنك تنشيط ميزات المشترك في MSDN خاصتك أو الاشتراك في حساب Azure مجاني.
  • مجموعة تطوير Java معتمدة (JDK). لمزيد من المعلومات عن مجموعات تطوير Java (JDKs) المتاحة للاستخدام عند التطوير على Azure، راجع دعم Java على Azure وAzure Stack.
  • Apache Maven الإصدار 3.0 أو أحدث.
  • برنامج Curl أو أداة HTTP شبيهة لاختبار الأداء الوظيفي.
  • عميل Git.

ملاحظة

تنفذ العينات المذكورة أدناه ملحقات مخصصة للحصول على تجربة أفضل عند استخدام Azure Cosmos DB ل Apache Cassandra. وهي تتضمن النهج التي تم تخصيصها لإعادة المحاولة وموازنة التحميل، بالإضافة إلى تنفيذ إعدادات الاتصال الموصى بها. للاستكشاف الأكثر شمولا لكيفية استخدام النهج المخصصة، راجع عينات Java للإصدار 3والإصدار 4.

إنشاء Azure Cosmos DB لحساب Apache Cassandra

  1. من قائمة مدخل Azure أو الصفحة الرئيسية، حدد Create a resource.

  2. في الصفحة جديد، ابحث عن Azure Cosmos DB وحدده.

  3. في صفحة Azure Cosmos DB ، حدد Create.

  4. في صفحة API ، حدد Create ضمن قسم Cassandra .

    تحدد واجهة API نوع الحساب المقرر إنشاؤه. يوفر Azure Cosmos DB خمس واجهات برمجة تطبيقات: NoSQL لقواعد بيانات المستندات، وGremlin لقواعد بيانات الرسم البياني، وMongoDB لقواعد بيانات المستندات، وAzure Table، وCassandra. يجب إنشاء حساب منفصل لكل API.

    حدد Cassandra، لأنه في هذا التشغيل السريع تقوم بإنشاء جدول يعمل مع واجهة برمجة التطبيقات ل Cassandra.

    تعرف على المزيد حول واجهة برمجة التطبيقات ل Cassandra.

  5. في صفحة إنشاء حساب Azure Cosmos DB، أدخل الإعدادات الأساسية لحساب Azure Cosmos DB الجديد.

    الإعداد قيمة ‏‏الوصف
    الاشتراك اشتراكك حدد اشتراك Azure الذي تريد استخدامه لحساب Azure Cosmos DB هذا.
    مجموعة الموارد إنشاء و الجديدة في

    ثم أدخل نفس اسم الحساب    		 حدد إنشاء جديد. ثم أدخل اسم مجموعة موارد جديدة لحسابك. للبساطة، استخدم نفس اسم حساب Azure Cosmos DB.
    اسم الحساب أدخل اسماً فريداً أدخل اسماً فريداً لتعريف حساب Azure Cosmos DB الخاص بك. سيكون حساب URI الخاص بك cassandra.cosmos.azure.com وسيُلحق باسم حسابك الفريد.

    لا يمكن أن يستخدم اسم الحساب سوى الأحرف الصغيرة والأرقام والواصلات (-)، ويجب أن يتراوح طولها بين 3 و31 حرفًا.
    الموقع المنطقة الأقرب إلى مستخدميك حدد موقعًا جغرافيًّا لاستضافة حساب Azure Cosmos DB. استخدم الموقع الأقرب إلى المستخدمين لمنحهم أسرع وصول إلى البيانات.
    وضع السعة معدل النقل المقدم أو بلا خادم حدد "Provisioned throughput" لإنشاء حساب في وضع معدل النقل المتوفر. حدد Serverless لإنشاء حساب في وضع دون خادم.
    تطبيق خصم طبقة Azure Cosmos DB المجاني تطبيق أو عدم تطبيق مع Azure Cosmos DB الطبقة الحرة، سوف تحصل على أول 1000 RU / ثانية و25 غيغابايت من التخزين مجانًا في حساب. تعرف على المزيد حول الطبقة المجانية.
    ضع حدُا لمعدل نقل الحساب حدد للحد من معدل نقل الحساب وهذا مفيد إذا كنت تريد تحديد إجمالي معدل نقل الحساب إلى قيمة معينة.

    ملاحظة

    يمكنك الحصول على حساب طبقةAzure Cosmos DB مجانية واحدة لكل اشتراك Azure ويجب عليك الاشتراك عند إنشاء الحساب. إذا لم تشاهد خيار تطبيق خصم الطبقة المجانية، فهذا يعني أنه تم تمكين حساب آخر في الاشتراك بالفعل مع طبقة مجانية.

    صفحة الحساب الجديدة ل Azure Cosmos DB ل Apache Cassandra

  6. في علامة تبويب Global Distributionكوّن التفاصيل التالية. يمكنك ترك القيم الافتراضية لغرض هذه البداية السريعة:

    الإعداد قيمة ‏‏الوصف
    التكرار الجغرافي تعطيل تمكين التوزيع العمومي على حسابك أو تعطيله عن طريق إقران منطقتك بمنطقة زوج. يمكنك إضافة المزيد من المناطق إلى حسابك لاحقًا.
    كتابات متعددة المناطق تعطيل تتيح لك إمكانية الكتابة متعددة المناطق الاستفادة من الإنتاجية المقدمة لقواعد البيانات والحاويات الخاصة بك في جميع أنحاء العالم.
    مجموعات التوافر تعطيل مناطق التوفر هي مواقع معزولة داخل منطقة Azure. تتكون كل منطقة من مركز بيانات واحد أو أكثر مزود بمصدر طاقة وتبريد وشبكات مستقلة.

    ملاحظة

    الخيارات التالية غير متوفرة إذا قمت بتحديد دون خادمباعتبارهاوضع السعة:

    • تطبيق خصم من الدرجة المجانية
    • Geo-redundancy
    • كتابات متعددة المناطق

  7. اختياريًا يمكنك تكوين تفاصيل إضافية في علامات التبويب التالية:

  8. حدد "Review + create".

  9. راجع الإعدادات، ثم حدد Create. يستغرق إنشاء جهاز ظاهر بضع دقائق. انتظر حتى يتم عرض صفحة المدخل، اكتمل النشر.

    لقطة شاشة لجزء إشعارات بوابة Azure

  10. حدد الانتقال إلى المورد للانتقال إلى صفحة حساب Azure Cosmos DB.

تكوين نموذج التطبيق

يكون الإجراء التالي تطبيق الاختبار.

  1. افتح أمر shell أمر وانسخ أي من الأمثلة التالية:

    لبرنامج مشغل Java الإصدار 3 وإصدار Spring الموافق:

    shell 
    git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure-extension-v3.git

    لبرنامج مشغل Java الإصدار 4 وإصدار Spring الموافق:

    shell 
    git clone https://github.com/Azure-Samples/spring-data-cassandra-on-azure-extension-v4.git

    ملاحظة

    على الرغم من أن الاستخدام الموضح أدناه مطابق لكل من Java الإصدار 3 و نماذج الإصدار 4 أعلاه، إلا أن الطريقة التي تم تنفيذها بها لتضمين نهج إعادة المحاولة وموازنة التحميل المخصصة مغايرة. نوصي بمراجعة التعليمات البرمجية لفهم كيفية تنفيذ نُهج مخصصة إذا كنت تقوم بإجراء تغييرات على تطبيق Spring Java موجود بالفعل.

  2. تحديد موقع ملف application.properties في دليل الموارد للمشروع عينة أو إنشاء الملف إذا لم يكن موجودًا بالفعل.

  3. افتح ملف application.properties في محرر نص وإضافة أو تكوين الأسطر التالية في الملف واستبدال قيم نموذج مع القيم المناسبة من قبل:

    YAML 
    spring.data.cassandra.contact-points=<Account Name>.cassandra.cosmos.azure.com
spring.data.cassandra.port=10350
spring.data.cassandra.username=<Account Name>
spring.data.cassandra.password=********

    المكان:

    المعلمة ‏‏الوصف‬
    spring.data.cassandra.contact-points تعين نقطة الاتصال بالطريقة المذكورة سابقًا في هذه المقالة.
    spring.data.cassandra.port تعين المنفذ بالطريقة المذكورة سابقًا في هذه المقالة.
    spring.data.cassandra.username تحديد اسم المستخدم الخاص بك بالطريقة المذكورة سابقًا في هذه المقالة.
    spring.data.cassandra.password تحديد كلمة المرور الأساسية بالطريقة المذكورة سابقًا في هذه المقالة.

  4. افتح ملف application.properties ثم قم بالحفظ.

حزم واختبار نفس التطبيق

استعرض الملفات للوصول إلى الدليل الذي يحتوي على ملف .pom لإنشاء واختبار التطبيق.

  1. بناء نموذج التطبيق مع Maven على سبيل المثال:

    shell 
    mvn clean package

  2. ابدأ تشغيل نموذج التطبيق; على سبيل المثال:

    shell 
    java -jar target/spring-data-cassandra-on-azure-0.1.0-SNAPSHOT.jar

  3. إنشاء سجلات جديدة باستخدام curl من موجه الأوامر كالأمثلة التالية:

    shell 
    curl -s -d "{\"name\":\"dog\",\"species\":\"canine\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets

curl -s -d "{\"name\":\"cat\",\"species\":\"feline\"}" -H "Content-Type: application/json" -X POST http://localhost:8080/pets

    يفترض أن يقوم التطبيق بإرجاع قيم كالتالي:

    shell 
    Added Pet{id=60fa8cb0-0423-11e9-9a70-39311962166b, name='dog', species='canine'}.

Added Pet{id=72c1c9e0-0423-11e9-9a70-39311962166b, name='cat', species='feline'}.

  4. استرداد كافة السجلات الموجودة باستخدام curl من موجه الأوامر كالأمثلة التالية:

    shell 
    curl -s http://localhost:8080/pets

    يفترض أن يقوم التطبيق بإرجاع قيم كالتالي:

    JSON 
    [{"id":"60fa8cb0-0423-11e9-9a70-39311962166b","name":"dog","species":"canine"},{"id":"72c1c9e0-0423-11e9-9a70-39311962166b","name":"cat","species":"feline"}]

تنظيف الموارد

عند الانتهاء من تطبيقك وحساب Azure Cosmos DB، يمكنك حذف موارد Azure التي أنشأتها حتى لا تتحمل المزيد من الرسوم. لحذف الموارد:

  1. في شريط البحث في مدخل Azure، ابحث عن مجموعات المواردوحددها.

  2. من القائمة، حدد مجموعة الموارد التي أنشأتها خلال هذا التشغيل السريع.

    تحديد مجموعة الموارد المطلوب حذفها

  3. في صفحة نظرة عامة على مجموعة الموارد، حدد حذف مجموعة الموارد.

    لا تحذف مجموعة الموارد

  4. في النافذة التالية، أدخل اسم مجموعة الموارد لحذفها، ثم حدد حذف.

الخطوات التالية

لمعرفة المزيد عن Spring وAzure، تابع إلى مركز وثائق Spring on Azure.

Spring on Azure

الموارد الإضافية

لمزيد من المعلومات حول استخدام Azure مع Java، انظرAzure لمطوري Javaوالعمل مع Azure DevOps و Java.