مشاركة عبر

بداية سريعة: بناء التطبيق Cassandra مع SDK Node.js وAzure Cosmos DB

  • مقالة

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

في هذا التشغيل السريع، يمكنك إنشاء Azure Cosmos DB لحساب Apache Cassandra، واستخدام تطبيق Cassandra Node.js المستنسخ من GitHub لإنشاء قاعدة بيانات وحاوية Cassandra. Azure Cosmos DB عبارة عن خدمة قاعدة بيانات متعددة النماذج تتيح لك إنشاء قواعد بيانات المستندات والجدول والقيمة الرئيسية والرسم البياني والاستعلام عنها بسرعة مع إمكانات التوزيع العام والقياس الأفقي.

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

إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ. بدلاً من ذلك، يمكنك تجربة Azure Cosmos DB مجاناً دون اشتراك Azure، مجاناً دون التزامات.

بالإضافة إلى ذلك، أنت بحاجة إلى:

أنشئ «حساب قاعدة البيانات».

قبل أن تتمكن من إنشاء قاعدة بيانات المستندات، تحتاج إلى إنشاء حساب Cassandra باستخدام Azure Cosmos DB.

  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.

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

استنساخ واجهة برمجة تطبيقات لتطبيق Cassandra من GitHub، وتعيين سلسلة الاتصال، وتشغيلها.

  1. افتح نافذة "موجه الأوامر". أنشئ مجلدًا جديدًا باسم git-samples. ثم أغلق النافذة.

    md "C:\git-samples"

  2. افتح نافذة طرفية git، مثل git bash. استخدم الأمر cd للتغيير إلى المجلد الجديد لتثبيت التطبيق النموذجي.

    cd "C:\git-samples"

  3. قم بتشغيل الأمر التالي لاستنساخ مستودع النموذج. يقوم هذا الأمر بإنشاء نسخة من نموذج التطبيق على جهاز الكمبيوتر الخاص بك.

    git clone https://github.com/Azure-Samples/azure-cosmos-db-cassandra-nodejs-getting-started.git

  4. قم بتثبيت تبعيات Node.js مع npm.

    npm install

مراجعة الرمز

هذه الخطوة اختيارية. إذا كنت مهتمًا بمعرفة كيفية إنشاء التعليمات البرمجية لموارد قاعدة البيانات، فإنه يمكنك مراجعة الأجزاء التالية. يتم أخذ جميع المقتطفات من ملف uprofile.js في المجلد C:\git-samples\azure-cosmos-db-cassandra-nodejs-getting-started. وإلا، فانتقل إلى Update your connection string.

  • تم تعيين قيم اسم المستخدم وكلمة المرور باستخدام صفحة سلسلة الاتصال في مدخل Microsoft Azure.

    let authProvider = new cassandra.auth.PlainTextAuthProvider(
    config.username,
    config.password
);

  • clientتتم تهيئة مع معلومات نقطة الاتصال. يتم استرداد نقطة الاتصال من مدخل Microsoft Azure.

    let client = new cassandra.Client({
    contactPoints: [`${config.contactPoint}:10350`],
    authProvider: authProvider,
    localDataCenter: config.localDataCenter,
    sslOptions: {
        secureProtocol: "TLSv1_2_method"
    },
});

  • client يتصل ب Azure Cosmos DB ل Apache Cassandra.

    client.connect();

  • يتم إنشاء مفتاح جديد.

    var query =
    `CREATE KEYSPACE IF NOT EXISTS ${config.keySpace} WITH replication = {'class': 'NetworkTopologyStrategy', 'datacenter' : '1' }`;
await client.execute(query);

  • يتم إنشاء جدول جديد.

    query =
    `CREATE TABLE IF NOT EXISTS ${config.keySpace}.user (user_id int PRIMARY KEY, user_name text, user_bcity text)`;
await client.execute(query);

  • يتم إدراج الكيانات الرئيسية/القيمة.

    const arr = [
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (1, 'AdrianaS', 'Seattle')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (2, 'JiriK', 'Toronto')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (3, 'IvanH', 'Mumbai')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (4, 'IvanH', 'Seattle')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (5, 'IvanaV', 'Belgaum')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (6, 'LiliyaB', 'Seattle')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (7, 'JindrichH', 'Buenos Aires')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (8, 'AdrianaS', 'Seattle')`,
    `INSERT INTO  ${config.keySpace}.user (user_id, user_name , user_bcity) VALUES (9, 'JozefM', 'Seattle')`,
];
for (const element of arr) {
    await client.execute(element);
}

  • استعلم للحصول على جميع القيم الرئيسية.

    query = `SELECT * FROM ${config.keySpace}.user`;
const resultSelect = await client.execute(query);

for (const row of resultSelect.rows) {
    console.log(
        "Obtained row: %d | %s | %s ",
        row.user_id,
        row.user_name,
        row.user_bcity
    );
}

  • استعلم للحصول على قيمة مفتاح.

    query = `SELECT * FROM ${config.keySpace}.user where user_id=1`;
const resultSelectWhere = await client.execute(query);

for (const row of resultSelectWhere.rows) {
    console.log(
        "Obtained row: %d | %s | %s ",
        row.user_id,
        row.user_name,
        row.user_bcity
    );
}

  • اغلق الاتصال.

    client.shutdown();

تحديث سلسلة الاتصال

انتقل إلى مدخل Microsoft Azure للحصول على معلومات سلسلة الاتصال الخاصة بك وانسخها في التطبيق. تمكن سلسلة الاتصال تطبيقك من الاتصال بقاعدة البيانات المستضافة.

  1. في حسابك في Azure Cosmos DB في مدخل Azure، حدد سلسلة الاتصال.

  2. استخدم الزر على الجانب الأيمن من الشاشة لنسخ أعلى قيمة، نقطة الاتصال.

    لقطة شاشة توضح كيفية عرض ونسخ نقطة الاتصال واسم المستخدم وكلمة المرور من صفحة «سلسلة الاتصال».

  3. افتح ملف config.js.

  4. الصق قيمة CONTACT POINT من المدخل عبر CONTACT-POINT في السطر 9.

    يجب أن يبدو السطر 9 الآن مشابهاً لهذه القيمة:

    contactPoint: "cosmos-db-quickstarts.cassandra.cosmosdb.azure.com",

  5. انسخ قيمة USERNAME من المدخل والصقها فوق <FillMEIN> في السطر 2.

    يجب أن يبدو السطر 2 الآن مشابهاً لهذه القيمة:

    username: 'cosmos-db-quickstart',

  6. انسخ قيمة PASSWORD من المدخل والصقها فوق USERNAME في السطر 8.

    يجب أن يبدو السطر 8 الآن مشابهاً لهذه القيمة:

    password: '2Ggkr662ifxz2Mg==',

  7. استبدل REGION بمنطقة Azure التي أنشأت هذا المورد فيها.

  8. احفظ ملف config.js.

تشغيل تطبيق Node.js

  1. في نافذة bash Terminal، تأكد من أنك في نموذج الدليل الذي نسخته سابقاً:

    cd azure-cosmos-db-cassandra-nodejs-getting-started

  2. قم بتشغيل تطبيق العقدة الخاص بك:

    npm start

  3. تحقق من النتائج كما هو متوقع من سطر الأوامر.

    لقطة الشاشة توضح نافذة موجه الأوامر حيث يمكنك عرض المخرجات والتحقق منها.

    اضغط على Ctrl+C لإيقاف البرنامج وإغلاق نافذة وحدة التحكم.

  4. في مدخل Microsoft Azure، افتح Data Explorer للاستعلام عن هذه البيانات الجديدة، وتعديلها، والعمل عليها.

    لقطة شاشة توضح صفحة «مستكشف البيانات»، حيث يمكنك عرض البيانات.

مراجعة اتفاقيات مستوى الخدمة في مدخل Azure

يراقب مدخل Azure معدل نقل حساب Azure Cosmos DB والتخزين والتوافر وزمن الانتقال والاتساق. المخططات الخاصة بالمقاييس المقترنة بـ اتفاقية مستوى خدمة Azure Cosmos DB (SLA) تعرض قيمة اتفاقية مستوى الخدمة مقارنة بالأداء الفعلي. هذه المجموعة من المقاييس تجعل مراقبة اتفاقيات مستوى الخدمة الخاصة بك شفافة.

لمراجعة المقاييس واتفاقيات مستوى الخدمة:

  1. حدد Metrics في قائمة التنقل لحساب Azure Cosmos DB.

  2. حدد علامة تبويب مثل زمن الانتقال، وحدد إطارًا زمنيًا على اليسار. قارن الأسطر الفعلية واتفاقية مستوى الخدمة على المخططات.

    مجموعة مقاييس Azure Cosmos DB

  3. راجع المقاييس في علامات التبويب الأخرى.

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

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

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

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

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

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

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

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

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

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

استيراد بيانات Cassandra إلى Azure Cosmos DB