بدء استخدام Azure Blob Storage وGo

• NET.
• Java
• JavaScript
• TypeScript
• Python
• ذهب

توضح هذه المقالة كيفية الاتصال ب Azure Blob Storage باستخدام وحدة عميل Azure Blob Storage ل Go. بمجرد الاتصال، تستطيع التعليمة البرمجية الخاصة بك العمل على الحاويات وميزات خدمة الكائنات الثنائية كبيرة الحجم.

حزمة التعليمات البرمجية | المصدر لمكتبة الوثائق المرجعية | لواجهة برمجة التطبيقات (pkg.go.dev)

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

• اشتراك Azure - إنشاء اشتراك مجاني
• حساب تخزين Azure - إنشاء حساب تخزين
• Go 1.18+

إعداد مشروعك

يرشدك هذا القسم خلال إعداد مشروع للعمل مع وحدة عميل Azure Blob Storage ل Go.

من GOPATH، قم بتثبيت الوحدة النمطية azblob باستخدام الأمر التالي:

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

للمصادقة باستخدام معرف Microsoft Entra (مستحسن)، قم بتثبيت الوحدة النمطية azidentity باستخدام الأمر التالي:

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

ثم افتح ملف التعليمات البرمجية وأضف مسارات الاستيراد الضرورية. في هذا المثال، نضيف ما يلي إلى ملف .go :

import (
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

معلومات الوحدة النمطية لعميل Blob:

• azblob: يحتوي على الطرق التي يمكنك استخدامها للعمل على الخدمة والحاويات والكائنات الثنائية كبيرة الحجم.

تخويل الوصول والاتصال ب Blob Storage

لتوصيل تطبيق ب Blob Storage، قم بإنشاء كائن عميل باستخدام azblob. NewClient. هذا الكائن هو نقطة البداية للتفاعل مع موارد البيانات على مستوى حساب التخزين. يمكنك استخدامه للعمل على حساب التخزين وحاوياته.

لمعرفة المزيد حول إنشاء كائنات العميل وإدارتها، بما في ذلك أفضل الممارسات، راجع إنشاء كائنات العميل التي تتفاعل مع موارد البيانات وإدارتها.

يمكنك تخويل كائن عميل باستخدام رمز تخويل Microsoft Entra (مستحسن) أو مفتاح وصول حساب أو توقيع وصول مشترك (SAS).

معرف Microsoft Entra (مستحسن)

للتخويل باستخدام معرف Microsoft Entra، تحتاج إلى استخدام أساس أمان. توفر المقالات التالية إرشادات حول سيناريوهات المصادقة المختلفة:

• المصادقة في بيئات التطوير
• المصادقة في التطبيقات المستضافة على Azure
• المصادقة مع كيان الخدمة

تخويل الوصول باستخدام DefaultAzureCredential

طريقة سهلة وآمنة لتخويل الوصول والاتصال ب Blob Storage هي الحصول على رمز OAuth المميز عن طريق إنشاء مثيل DefaultAzureCredential . يمكنك بعد ذلك استخدام بيانات الاعتماد هذه لإنشاء كائن العميل باستخدام azblob. NewClient.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

رمز SAS المميز

لاستخدام رمز توقيع وصول مشترك (SAS)، ألحق الرمز المميز بسلسلة عنوان URL للحساب وأنشئ كائن العميل باستخدام azblob. NewClientWithNoCredential.

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

إشعار

بالنسبة للسيناريوهات التي يتم فيها استخدام توقيعات الوصول المشترك (SAS)، توصي Microsoft باستخدام SAS لتفويض المستخدم. يتم تأمين SAS لتفويض المستخدم باستخدام بيانات اعتماد Microsoft Entra بدلا من مفتاح الحساب. لمعرفة المزيد من المعلومات حول مفاتيح SAS، راجع منح وصول محدود إلى البيانات باستخدام توقيعات الوصول المشتركة (SAS).

مفتاح الحساب

لاستخدام مفتاح مشترك لحساب تخزين، قم بتوفير المفتاح كسلسلة وتهيئة كائن عميل باستخدام azblob. NewClientWithSharedKeyCredential.

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

    client, err := azblob.NewClientWithSharedKeyCredential(accountURL, credential, nil)
    handleError(err)

    return client
}

يمكنك أيضا إنشاء كائن عميل باستخدام سلسلة الاتصال.

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

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

هام

يجب استخدام مفتاح الوصول إلى الحساب بحذر. إذا فقدت مفتاح الوصول إلى حسابك أو تم وضعه عن طريق الخطأ في موقع غير آمن، فقد تصبح خدمتك عرضة للخطر. يمكن لأي شخص لديه مفتاح الوصول تخويل الطلبات مقابل حساب التخزين، ولديه حق الوصول إلى جميع البيانات بشكل فعال. DefaultAzureCredential يوفر ميزات وفوائد أمان محسنة وهو النهج الموصى به لإدارة التخويل لخدمات Azure.

إنشاء التطبيق الخاص بك

أثناء إنشاء تطبيقات للعمل مع موارد البيانات في Azure Blob Storage، تتفاعل التعليمات البرمجية الخاصة بك بشكل أساسي مع ثلاثة أنواع من الموارد: حسابات التخزين والحاويات والكائنات الثنائية كبيرة الحجم. لمعرفة المزيد حول أنواع الموارد هذه، وكيفية ارتباطها ببعضها البعض، وكيفية تفاعل التطبيقات مع الموارد، راجع فهم كيفية تفاعل التطبيقات مع موارد بيانات Blob Storage.

توضح لك الدلائل التالية كيفية العمل مع موارد البيانات وتنفيذ إجراءات محددة باستخدام وحدة عميل Azure Blob Storage ل Go:

الدليل:	‏‏الوصف
إنشاء حاوية	إنشاء حاويات.
حذف الحاويات واستعادتها	احذف الحاويات، وإذا تم تمكين الحذف المبدئي، فقم باستعادة الحاويات المحذوفة.
قوائم الحاويات	سرد الحاويات في الحساب وكذلك الخيارات المختلفة المتاحة لتخصيص قائمة.
إدارة الخصائص وبيانات التعريف (الحاويات)	إدارة خصائص الحاوية وبيانات التعريف.
تحميل الكائنات الثنائية كبيرة الحجم	تعرف على كيفية تحميل الكائنات الثنائية الكبيرة باستخدام السلاسل ودفق البيانات ومسارات الملفات والطرق الأخرى.
تنزيل كائنات تخزين البيانات الثنائية الكبيرة	قم بتنزيل الكائنات الثنائية الكبيرة باستخدام السلاسل وتدفق البيانات ومسارات الملفات.
سرد الكيانات الثنائية كبيرة الحجم	سرد الكائنات الثنائية الكبيرة بطرق مختلفة.
حذف الكائنات الثنائية كبيرة الحجم واستعادتها	احذف الكائنات الثنائية الكبيرة، وإذا تم تمكين الحذف المبدئي، فقم باستعادة الكائنات المحذوفة.
البحث عن الكائنات الثنائية كبيرة الحجم باستخدام العلامات	قم بتعيين العلامات واستردادها، واستخدم العلامات للعثور على الكائنات الثنائية كبيرة الحجم.
إدارة الخصائص وبيانات التعريف (الكائنات الثنائية كبيرة الحجم)	إدارة خصائص الحاوية وبيانات التعريف.

إشعار

تهدف نماذج التعليمات البرمجية في هذا الدليل إلى مساعدتك في البدء في Azure Blob Storage وGo. يجب تعديل معالجة Context الأخطاء والقيم لتلبية احتياجات التطبيق الخاص بك.