إدارة خصائص الكائن الثنائي كبير الحجم وبيانات التعريف باستخدام JavaScript

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

بالإضافة إلى البيانات التي تحتوي عليها، تدعم الكائنات ثنائية الحجم خصائص النظام وبيانات التعريف المعرفة من قبل المستخدم. توضح هذه المقالة كيفية إدارة خصائص النظام وبيانات التعريف المعرفة من قبل المستخدم باستخدام مكتبة عميل تخزين Azure لـ JavaScript.

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

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

نبذة عن الخصائص وبيانات التعريف

• خصائص النظام: توجد خصائص النظام على كل مورد تخزين Blob. يمكن قراءة بعضها أو تعيينها، بينما البعض الآخر للقراءة فقط. تحت الأغلفة، تتوافق بعض خصائص النظام مع بعض عناوين HTTP القياسية المعينة. تحتفظ مكتبة عميل تخزين Azure Storage لـ JavaScript بهذه الخصائص لك.

• بيانات التعريف المحددة مسبقًا من المستخدم: تتكون بيانات التعريف المحددة مسبقًا من المستخدم من زوج واحد أو أكثر من أزواج قيمة الاسم التي تحددها لمورد تخزين Blob. يمكنك استخدام بيانات التعريف لتخزين قيم إضافية مع المورد. قيم بيانات التعريف هي لأغراضك فقط، ولا تؤثر على كيفية تصرف المورد.

  أزواج اسم/قيمة بيانات التعريف هي رؤوس HTTP صالحة ويجب أن تلتزم بجميع القيود التي تحكم رؤوس HTTP. لمزيد من المعلومات حول متطلبات تسمية بيانات التعريف، راجع أسماء بيانات التعريف.

إشعار

أيضاً توفر علامات فهرسة الكائنات الثنائية كبيرة الحجم القدرة على تخزين سمات المفاتيح/القيم المُعرّفة من قِبل المستخدم جنباً إلى جنب مع مورد مساحة تخزين Azure Blob. بينما تتشابه علامات فهرسة الكائنات الثنائية كبيرة الحجم مع بيانات التعريف، فهي تختلف في أنه تتم فهرستها تلقائياً وتصبح قابلة للبحث بواسطة الخدمة الأصلية للكائنات الثنائية كبيرة الحجم. لا يمكن فهرسة بيانات التعريف والاستعلام عنها إلا إذا كنت تستخدم خدمة منفصلة، مثل Azure Search.

للتعرّف على المزيد حول هذه الميزة، راجع إدارة البيانات والعثور عليها على مساحة تخزين Azure Blob باستخدام فهرس كائنات ثنائية كبيرة الحجم (معاينة).

تعيين الخصائص واستردادها

لتعيين خصائص على كائن ثنائي كبير الحجم، استخدم الأسلوب التالي:

• BlobClient.setHTTPHeaders

يعيّن مثال التعليمات البرمجية التالي خصائص النظام blobContentType و blobContentLanguage على كائن ثنائي كبير الحجم.

يتم مسح أي خصائص لم يتم تعيينها صراحة. يحصل مثال التعليمات البرمجية التالي أولا على الخصائص الموجودة على الكائن الثنائي كبير الحجم، ثم يستخدمها لتعبئة العناوين التي لا يتم تحديثها.

JavaScript

async function setHTTPHeaders(blobClient, headers) {
  
  // Get existing properties
  const properties = await blobClient.getProperties();

  // Set the blobContentType and blobContentLanguage headers
  // Populate the remaining headers from the existing properties
  blobHeaders = {
    blobContentType: 'text/plain',
    blobContentLanguage: 'en-us',
    blobContentEncoding: properties.contentEncoding,
    blobCacheControl: properties.cacheControl,
    blobContentDisposition: properties.contentDisposition,
    blobContentMD5: properties.contentMD5
  },

  await blobClient.setHTTPHeaders(blobHeaders);
}

TypeScript

async function setHTTPHeaders(
  blobClient: BlobClient
): Promise<void> {

  // Get existing properties
  const properties = await blobClient.getProperties();

  // Set the blobContentType and blobContentLanguage headers
  // Populate the remaining headers from the existing properties
  const blobHeaders: BlobHTTPHeaders = {
    blobContentType: 'text/plain',
    blobContentLanguage: 'en-us',
    blobContentEncoding: properties.contentEncoding,
    blobCacheControl: properties.cacheControl,
    blobContentDisposition: properties.contentDisposition,
    blobContentMD5: properties.contentMD5
  };

  await blobClient.setHTTPHeaders(blobHeaders);
}

لاسترداد الخصائص على كائن ثنائي كبير الحجم، استخدم الأسلوب التالي:

• الحصول على خصائص

يحصل مثال التعليمات البرمجية التالي على خصائص نظام كائن ثنائي كبير الحجم ويعرض بعض القيم:

JavaScript

async function getProperties(blobClient) {

  const properties = await blobClient.getProperties();
  
  console.log(`blobType: ${properties.blobType}`);
  console.log(`contentType: ${properties.contentType}`);
  console.log(`contentLength: ${properties.contentLength}`);
  console.log(`lastModified: ${properties.lastModified}`);
}

TypeScript

async function getProperties(
  blobClient: BlobClient
): Promise<void> {
  
  const propertiesResponse: BlobGetPropertiesResponse =
    await blobClient.getProperties();

  console.log(`blobType: ${propertiesResponse.blobType}`);
  console.log(`contentType: ${propertiesResponse.contentType}`);
  console.log(`contentLength: ${propertiesResponse.contentLength}`);
  console.log(`lastModified: ${propertiesResponse.lastModified}`);
}

تعيين بيانات التعريف واستردادها

يمكنك تحديد بيانات التعريف كزوج واحد أو أكثر من أزواج قيمة الاسم على مورد النقطة أو الحاوية. لتعيين بيانات التعريف، أرسل كائن بيانات التعريف الذي يحتوي على أزواج قيمة الاسم باستخدام الأسلوب التالي:

• BlobClient.setMetadata

يعين مثال التعليمات البرمجية التالي بيانات التعريف على كائن ثنائي كبير الحجم:

JavaScript

async function setBlobMetadata(blobClient, metadata) {
  
  metadata = {
    docType: 'text',
    category: 'reference'
  };

  await blobClient.setMetadata(metadata);
}

TypeScript

async function setBlobMetadata(
  blobClient: BlobClient
): Promise<void> {

  const metadata: Metadata = {
    docType: 'text',
    category: 'reference'
  };

  await blobClient.setMetadata(metadata);
}

لاسترداد بيانات التعريف، قم باستدعاء أسلوب getProperties على الكائن الثنائي كبير الحجم لملء مجموعة بيانات التعريف، ثم اقرأ القيم من خاصية بيانات التعريف. يسترد getProperties الأسلوب خصائص الكائن الثنائي كبير الحجم وبيانات التعريف عن طريق استدعاء كل من Get Blob Properties العملية والعملية Get Blob Metadata .

الموارد

لمعرفة المزيد حول كيفية إدارة خصائص النظام وبيانات التعريف المعرفة من قبل المستخدم باستخدام مكتبة عميل Azure Blob Storage ل JavaScript، راجع الموارد التالية.

نماذج التعليمات البرمجية

• عرض نماذج التعليمات البرمجية JavaScript وTypeScript من هذه المقالة (GitHub)

عمليات واجهة برمجة تطبيقات REST

يحتوي Azure SDK ل JavaScript على مكتبات تستند إلى واجهة برمجة تطبيقات AZURE REST، ما يسمح لك بالتفاعل مع عمليات REST API من خلال نماذج JavaScript المألوفة. تستخدم أساليب مكتبة العميل لإدارة خصائص النظام وبيانات التعريف المعرفة من قبل المستخدم عمليات REST API التالية:

• تعيين خصائص Blob (REST API)
• الحصول على خصائص Blob (REST API)
• تعيين بيانات تعريف Blob (REST API)
• الحصول على بيانات تعريف Blob (REST API)

موارد مكتبة العميل

• الوثائق المرجعية لمكتبة العميل
• التعليمات البرمجية لمصدر مكتبة عميل
• الحزمة (npm)

المحتوى ذو الصلة

• هذه المقالة هي جزء من دليل مطور Blob Storage ل JavaScript/TypeScript. لمعرفة المزيد، راجع القائمة الكاملة لمقالات دليل المطور في إنشاء تطبيق JavaScript/TypeScript.