مشاركة عبر

إنشاء جدول في Azure Cosmos DB للجدول باستخدام .NET

  • مقالة

ينطبق على: جدول

الجداول في Azure Cosmos DB للجدول هي وحدات إدارة لعناصر متعددة. قبل أن تتمكن من إنشاء العناصر أو إدارتها، يجب عليك أولاً إنشاء جدول.

تسمية جدول

في قاعدة بيانات Azure Cosmos، يكون الجدول مشابهًا لجدول في قاعدة بيانات ارتباطية.

إشعار

باستخدام واجهة برمجة التطبيقات لحسابات الجدول، عند إنشاء الجدول الأول، يتم إنشاء قاعدة بيانات افتراضية تلقائيا في حساب Azure Cosmos DB الخاص بك.

فيما يلي بعض القواعد السريعة عند تسمية جدول:

  • احتفظ بأسماء الجداول بين 3 و63 حرفًا
  • يمكن أن تحتوي أسماء الجداول فقط على أحرف صغيرة أو أرقام أو حرف الشرطة (-).
  • يجب أن تبدأ أسماء الجداول بحرف صغير أو رقم.

إنشاء جدول

لإنشاء جدول، قم باستدعاء إحدى الطرق التالية:

قم بإنشاء جدول بشكل غير متزامن

ينشئ المثال التالي جدولاً بشكل غير متزامن:

// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
    tableName: "adventureworks-1"
);

await tableClient1.CreateAsync();

TableCient.CreateAsyncستطرح الطريقة استثناءً إذا كانت قاعدة البيانات بالاسم نفسه موجودة بالفعل.

قم بإنشاء جدول بشكل غير متزامن إذا لم يكن موجودًا بالفعل

يقوم المثال التالي بإنشاء جدول بشكل غير متزامن فقط إذا لم يكن موجودًا بالفعل على الحساب:

// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
    tableName: "adventureworks-2"
);

await tableClient2.CreateIfNotExistsAsync();

ستقوم TableClient.CreateIfNotExistsAsync الطريقة بإنشاء جدول جديد فقط إذا لم يكن موجودًا بالفعل. هذا الأسلوب مفيد لتجنب الأخطاء إذا قمت بتشغيل نفس التعليمة البرمجية عدة مرات.

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

الآن بعد أن قمت بإنشاء جدول، استخدم الدليل التالي لإنشاء العناصر.

إنشاء عنصر