تمرين - قم بتوصيل Azure Storage Explorer بـ Azure Cosmos DB وData Lake

مكتمل

لا يقتصر Azure Storage Explorer فقط على حسابات التخزين. يمكنك أيضًا استخدامه للتحقق من البيانات وتنزيلها من Azure Cosmos DB أو Azure Data Lake.

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

هنا، ستتعلم كيفية إنشاء اتصال جديد من Storage Explorer إلى Azure Cosmos DB، وإنشاء قاعدة بيانات، وملئها بالمحتوى. أخيرًا، سترى كيفية الاتصال بحساب Azure Data Lake Storage Gen2 وإنشاء حاوية وتحميل البيانات فيها.

ملاحظة

تم إهمال تكامل Azure Cosmos DB مع Storage Explorer. لن تتم إزالة أي وظيفة موجودة لمدة سنة واحدة على الأقل من هذا الإصدار. عليك استخدام ⁧⁩مدخل Azure⁧⁩أو تطبيق⁧ سطح المكتب Azure Portal⁧⁩ أو تطبيق ⁧⁩⁩Azure Cosmos explorer⁦⁧ ⁩بدلاً من ذلك. تحتوي الخيارات البديلة على العديد من الميزات الجديدة غير المعتمدة حاليًا في Storage Explorer.

قم بإنشاء حساب Cosmos DB

تحتاج إلى إنشاء حساب قبل استخدام Storage Explorer للاتصال بقاعـدة بيانات Azure Cosmos DB بسلسلة اتصال.

  1. من Azure Cloud Shell، قم بتشغيل هذا الأمر:

    export NAME=cosmos$RANDOM
    az cosmosdb create \
        --name $NAME \
        --kind GlobalDocumentDB \
        --resource-group <rgn>[sandbox resource group name]</rgn>
    

    يستغرق تشغيل هذا الأمر بضع دقائق.

  2. عند انتهاء الأمر، سترى إخراج منظم JSON مع تفاصيل حساب Cosmos DB. لاحظ قيمة ⁧⁩اسم⁧⁩ الحساب للاستخدام في خطوة لاحقة.

احصل على سلسلة اتصال قاعدة بيانات Cosmos DB

بعد ذلك، احصل على المفتاح الرئيسي الأساسي لحساب Cosmos DB الخاص بك. ستستخدم هذا المفتاح لتوصيل Storage Explorer بـ Azure Cosmos DB.

  1. في Cloud Shell، استخدم الأمر التالي:

    az cosmosdb keys list \
        --name $NAME \
        --resource-group <rgn>[Sandbox resource group]</rgn> \
        --type connection-strings
    

    يُرجع الأمر استجابة مماثلة لـ JSON:

        {
      "connectionStrings": [
        {
          "connectionString": "AccountEndpoint=https://cosmos10632.documents.azure.com:443/;AccountKey=iEMq9yqfmjvrm1yGjbMdhebv6cv6FSFr5C2qAZSHzXmAQTBmP5vvyjdR7kdR3sV054JvAS2HREdYkRXT3xuHmA==;",
          "description": "Primary SQL Connection String"
        },
        {
          "connectionString": "AccountEndpoint=https://cosmos10632.documents.azure.com:443/;AccountKey=igsE0P0EJtq68X374aDXvbVS7d3ELcebxxGLMs42uSyjNpAXbnSsVT5zviC3lgre5eYmzXzcC6YqxtodNHCwAA==;",
          "description": "Secondary SQL Connection String"
        },
        {
          "connectionString": "AccountEndpoint=https://cosmos10632.documents.azure.com:443/;AccountKey=iskqlnpSh9w9Vndzj8acic5KpFXot7oapHxu53HKowKtLwokpXwT2upimu2hytc8KDQ45tM2jgVWzeR1q1SOGQ==;",
          "description": "Primary Read-Only SQL Connection String"
        },
        {
          "connectionString": "AccountEndpoint=https://cosmos10632.documents.azure.com:443/;AccountKey=bngJ453xU0otnkMALdbuTnKGFzL4NX4ppCEWPu5tOdmWRkipelwHa7bIf35E4VIyzvt5VLWwRRpI6Rja9bkePA==;",
          "description": "Secondary Read-Only SQL Connection String"
        }
      ]
    }
    

    دوّن ملاحظة عن ⁧⁩سلسلة اتصال SQL الأساسية⁧⁩ لأنك ستحتاجها بعد ذلك.

الاتصال بقاعدة بيانات Azure Cosmos DB باستخدام سلسلة اتصال

بعد ذلك، قم بتوصيل Storage Explorer بقاعدة بيانات Azure Cosmos DB من خلال سلسلة اتصال.

  1. إذا لزم الأمر، فافتح Storage Explorer ثم اتصل بحساب Azure الخاص بك.

  2. في جزء ⁧⁩EXPLORER⁧⁩ قم بتوسيع ⁧⁩المحلية والمرفقة⁩.

    لقطة شاشة تعرض خيار حسابات Cosmos DB Accounts في شجرة الموارد المحلية والمرفقة

  3. سترى عنصر ⁧⁩Cosmos DB Accounts⁦⁧⁩. انقر بزر الماوس الأيمن فوقه وحدد ⁧⁩الاتصال بـ ⁩Cosmos DB⁧⁩.

    لقطة شاشة تعرض خيار الاتصال بـ ⁩Cosmos DB ⁦في القائمة المختصرة

  4. معالج الاتصال يحتاج سلسلة الاتصال إلى Azure Cosmos DB. نسخ ولصق ⁧⁩سلسلة اتصال SQL الأساسية⁧⁩ التي قمت بإنشائها سابقًا في مربع ⁧سلسلة ⁩الاتصال⁧⁩.

    لقطة شاشة تعرض معالج اتصال Azure Cosmos DB

  5. سترى الآن طريقة عرض ⁧⁩ملخص⁧⁩ تعرض تسمية ⁧⁩الحساب⁧⁩ واسمه ونقطة نهاية الحساب ومفتاح الحساب. تحقق من صحة هذه المعلومات، ثم حدد ⁧⁩اتصال⁧⁩. حدد ⁧⁩التالي⁧⁩.

  6. يظهر اتصال قاعدة بيانات Azure Cosmos DB في المجلد ⁧⁩حسابات Cosmos DB⁧⁩ مع العرض إلى اليمين.

أنت الآن متصل بحسابك في Cosmos DB.

قم بإنشاء قاعدة بيانات Cosmos DB

لقد قمت حتى الآن بإنشاء مثيل Azure Cosmos DB والاتصال به باستخدام Storage Explorer. ستستخدم الآن Storage Explorer لإنشاء قاعدة بيانات Cosmos DB.

  1. في الجزء ⁧⁩EXPLORER⁩ حدد حساب Cosmos DB الذي قمت بإنشائه سابقًا. انقر بزر الماوس الأيمن فوقه وحدد ⁧⁩إنشاء قاعدة بيانات⁧⁩.

    لقطة شاشة تعرض القائمة المختصرة لقاعدة بيانات Cosmos DB مع تحديد إنشاء قاعدة بيانات

  2. قم بتسمية قاعدة البيانات الخاصة بك باسم ⁧⁩المنتجات⁧ ⁩وحدد ⁧⁩إدخال⁧⁩.

    ⁩لقطة شاشة تعرض الحقل الذي يمكنك فيه تسمية قاعدة البيانات.⁧

لقد قمت الآن بإنشاء قاعدة بيانات تسمى ⁧⁩المنتجات⁧⁩ في قاعدة بيانات Azure Cosmos DB.

أنشئ مجموعة في قاعدة بيانات Cosmos DB

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

  1. انقر بزر الماوس الأيمن فوق قاعدة بيانات ⁧⁩المنتجات⁧⁩ وحدد ⁧⁩إنشاء مجموعة⁧⁩.

  2. بالنسبة ⁧⁩إلى معرف المجموعة⁧⁩، أدخل معرف ⁧⁩المناطق⁧⁩.

    لقطة شاشة تعرض لوحة إنشاء مجموعة ومربع معرف المجموعة

  3. بعد ذلك، حدد ما إذا كانت هذه المجموعة تحتوي على قدر محدود من مساحة التخزين أو ما إذا كانت ستزيد لتتناسب مع حجم المجموعة. خيار ثابت يمنحك الحد الأقصى لحجم المجموعة 10 غيغابايت.

  4. الحقل الأخير هو ⁧⁩معدل النقل⁧⁩. قبول الافتراضي 400.

  5. حدد⁧⁩موافق⁧⁩.

الآن ترى أنه تتم إضافة مجموعة المنطقة ضمن قاعدة بيانات ⁧⁩المنتجات⁧.⁩ يمكنك إضافة العديد من المجموعات كما تريد.

إنشاء المستندات في مجموعة قاعدة بيانات Cosmos DB

يمكن أن تحتوي المجموعة على العديد من العناصر. يمكنك استخدام Storage Explorer لإدارتها، بما في ذلك إنشاء مستندات جديدة في مجموعتك.

  1. في الجزء ⁧⁩EXPLORER⁩ قم بتوسيع مجموعة ⁧⁩المناطق⁩. حدد ⁧⁩المستندات⁧⁩.

  2. يمكنك الآن مشاهدة جزء مجموعة ⁧⁩المناطق⁩. من هنا، يمكنك إدارة البيانات في مجموعتك.

  3. لإضافة مستند، حدد ⁧⁩مستند جديد⁧⁩. يتوفر مستند جديد فارغ في الإطار أدناه.

    لقطة شاشة تعرض الزر «مستند جديد» ولوحة تحكم المستند

  4. استبدل محتوى الوثيقة بـ JSON:

    {
        "id": "66",
        "title": "How to create a new document",
        "rtime": "30 minutes",
        "_etag": "WFFta1FHgQEtttIE1aaa"
    }
    
  5. حدد ⁧⁩حفظ⁧⁩.

    لقطة شاشة تعرض الزر «حفظ»

يظهر المستند الجديد في جزء المعرف.

إنشاء حساب Data Lake Storage Gen2

دعونا ننظر الآن في الاتصال بحساب Data Lake Storage Gen2. قبل أن تتمكن من استخدام Storage Explorer لإدارة حساب Data Lake Storage Gen2 الخاص بك تحتاج إلى إنشاء حساب تخزين في Azure.

  1. في Cloud Shell، قم بتثبيت ملحق المعاينة لتمكين إنشاء حسابات Gen2، الموجودة حاليًا في المعاينة.

    az extension add --name storage-preview
    
  2. لإنشاء حساب تخزين Gen2، استخدم الأمر ⁧⁩إنشاء حساب تخزين az⁧⁩:

    az storage account create \
        --name dlstoragetest$RANDOM \
        --resource-group <rgn>[Sandbox resource group]</rgn> \
        --location westus2 \
        --sku Standard_LRS \
        --kind StorageV2 \
        --hns
    

ملاحظة

يرجى منح Storage Account عدة دقائق لإكماله.

الاتصال بحساب تخزين Data Lake Gen2

الآن بعد أن قمت بإنشاء حساب تخزين Gen2، يمكنك الاتصال به في Storage Explorer.

  1. في Storage ExplorerK في جزء ⁧⁩EXPLORER⁧⁩ حدد موقع ⁧⁩Concierge Subscription⁧⁩ وقم بتوسيعه لإظهار جميع حسابات التخزين.

  2. انقر بزر الماوس الأيمن فوق ⁧⁩حسابات التخزين⁧⁩ وحدد ⁧⁩الاتصال بمساحة تخزين Azure⁧⁩.

    لقطة شاشة تعرض خيار تخزين الاتصال بـ Azure

  3. إذا تمت مطالبتك، فقم بتسجيل الدخول باستخدام حساب Azure الخاص بك.

  4. عند نجاح الاتصال، سترى حساب التخزين ⁧⁩dlsstoragetest001 (ADLS Gen2)⁧⁩ المعروض تحت حسابات التخزين. سيكون لحسابك لاحقة رقم مختلفة.

    لقطة شاشة تعرض حساب Azure Data Lake Storage Gen2

إنشاء حاوية

جميع الحاويات في حساب تخزين Azure Data Lake Gen2 عبارة عن كائنات ثنائية كبيرة الحجم. لإنشاء حاوية جديدة:

  1. انقر بزر الماوس الأيمن فوق حساب التخزين ⁧⁩dlsstoragetest001⁧⁩ وحدد ⁧⁩إنشاء حاوية كائنات ثنائية كبيرة الحجم⁧⁩ من القائمة المختصرة.

    لقطة شاشة تعرض القائمة المختصرة لإضافة حاوية

  2. قم بتسمية الحاوية الجديدة ⁧⁩myfilesystem⁧⁩.

  3. عند إنشاء الحاوية، يظهر جزء الحاوية. هناك، يمكنك إدارة محتويات الحاوية.

    لقطة شاشة تعرض شريط التحكم في myfilesystem وعرضه

تحميل وعرض بيانات كائنات ثنائية كبيرة الحجم

مع إنشاء حاوية ⁧⁩myfilesystem⁧⁩ الجديدة يمكنك الآن تحميل الملفات أو المجلدات إليها.

  1. لتحميل ملف، حدد الخيار ⁧⁩تحميل⁧⁩ وحدد ⁧⁩تحميل الملفات⁧⁩.

    لقطة شاشة تعرض خيارات التحميل

  2. في مربع الحوار، استخدم علامة الحذف⁧⁩(...⁧⁩) لتحديد الملف الذي تريد تحميله.

  3. اختر الزر ⁧⁩تحميل⁧⁩.

  4. الملف متوفر إلى حاوية ⁧⁩myfilesystem⁩.

    لقطة شاشة تعرض الملف الذي تم تحميله

يمكنك تحميل أكبر عدد من الملفات التي تريدها إلى هذا المجلد. كما يمكنك إنشاء عدد غير محدود من المجلدات. يمكنك بعد ذلك تنظيم المحتوى وإدارته في مجلداتك، كما تفعل مع نظام الملفات.