بدء استخدام Azure Blob Storage وGo
توضح هذه المقالة كيفية الاتصال ب Azure Blob Storage باستخدام وحدة عميل Azure Blob Storage ل Go. بمجرد الاتصال، استخدم أدلة المطور لمعرفة كيفية عمل التعليمات البرمجية الخاصة بك على الحاويات والكائنات الثنائية كبيرة الحجم وميزات خدمة 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، تحتاج إلى استخدام أساس أمان. توفر المقالات التالية إرشادات حول سيناريوهات المصادقة المختلفة:
تخويل الوصول باستخدام 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
}
بناء تطبيقك
أثناء إنشاء تطبيقات للعمل مع موارد البيانات في Azure Blob Storage، تتفاعل التعليمات البرمجية الخاصة بك بشكل أساسي مع ثلاثة أنواع من الموارد: حسابات التخزين والحاويات والكائنات الثنائية كبيرة الحجم. لمعرفة المزيد حول أنواع الموارد هذه، وكيفية ارتباطها ببعضها البعض، وكيفية تفاعل التطبيقات مع الموارد، راجع فهم كيفية تفاعل التطبيقات مع موارد بيانات Blob Storage.
توضح لك الدلائل التالية كيفية الوصول إلى البيانات وتنفيذ إجراءات محددة باستخدام وحدة عميل Azure Blob Storage ل Go:
الدليل: | الوصف |
---|---|
تكوين نهج إعادة المحاولة | تنفيذ نهج إعادة المحاولة لعمليات العميل. |
نسخ الكائنات الثنائية كبيرة الحجم | انسخ كائن ثنائي كبير الحجم من موقع إلى آخر. |
إنشاء حاوية | إنشاء حاويات. |
حذف الكائنات الثنائية كبيرة الحجم واستعادتها | احذف الكائنات الثنائية الكبيرة، وإذا تم تمكين الحذف المبدئي، فقم باستعادة الكائنات المحذوفة. |
حذف الحاويات واستعادتها | احذف الحاويات، وإذا تم تمكين الحذف المبدئي، فقم باستعادة الحاويات المحذوفة. |
تنزيل كائنات تخزين البيانات الثنائية الكبيرة | قم بتنزيل الكائنات الثنائية الكبيرة باستخدام السلاسل وتدفق البيانات ومسارات الملفات. |
البحث عن الكائنات الثنائية كبيرة الحجم باستخدام العلامات | قم بتعيين العلامات واستردادها، واستخدم العلامات للعثور على الكائنات الثنائية كبيرة الحجم. |
سرد الكيانات الثنائية كبيرة الحجم | سرد الكائنات الثنائية الكبيرة بطرق مختلفة. |
قوائم الحاويات | سرد الحاويات في الحساب وكذلك الخيارات المختلفة المتاحة لتخصيص قائمة. |
إدارة الخصائص وبيانات التعريف (الكائنات الثنائية كبيرة الحجم) | إدارة خصائص الحاوية وبيانات التعريف. |
إدارة الخصائص وبيانات التعريف (الحاويات) | إدارة خصائص الحاوية وبيانات التعريف. |
تحميل الكائنات الثنائية كبيرة الحجم | تعرف على كيفية تحميل الكائنات الثنائية الكبيرة باستخدام السلاسل ودفق البيانات ومسارات الملفات والطرق الأخرى. |
إشعار
تهدف نماذج التعليمات البرمجية في هذا الدليل إلى مساعدتك في البدء في Azure Blob Storage وGo. يجب تعديل معالجة Context
الأخطاء والقيم لتلبية احتياجات التطبيق الخاص بك.