توفير معدل نقل قياسي (يدوي) في حاوية Azure Cosmos - واجهة برمجة تطبيقات SQL

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

ينطبق على: واجهة برمجة تطبيقات SQL

تشرح هذه المقالة كيفية توفير معدل النقل قياسية (يدوية) على حاوية في Azure Cosmos DB SQL API. يمكنك توفير سرعة النقل في حاوية واحدة، أو توفير سرعة النقل في قاعدة بيانات ومشاركتها بين الحاويات داخل قاعدة البيانات. يمكنك توفير سرعة النقل على حاوية باستخدام بوابة Microsoft Azure أو Azure CLI أو Azure Cosmos DB SDK.

إذا كنت تستخدم واجهة برمجة تطبيقات مختلفة، فراجع مقالات API لـ MongoDBو Cassandra APIو Gremlin API لتوفير معدل النقل.

مدخل Azure

1. تسجيل الدخول إلى ⁧⁩مدخل Azure⁧⁩.

2. أنشئ حساب Azure Cosmos جديداً، أو حدد حساب Azure Cosmos موجود.

3. افتح جزء مستكشف البيانات وحدد حاوية جديدة. بعد ذلك، قدم التفاصيل التالية:

   • حدد ما إذا كنت تقوم بإنشاء قاعدة بيانات جديدة أو باستخدام قاعدة بيانات موجودة.
   • أدخل معرف الحاوية.
   • أدخل قيمة مفتاح القسم (على سبيل المثال، /ItemID).
   • حدد معدل النقل مقياس تلقائي أو يدوي وأدخل معدل نقل الحاوية المطلوب (على سبيل المثال، 1000 RU / ثانية). أدخل معدل النقل الذي تريد توفيره (على سبيل المثال، 1000 RU).
   • حدد "OK".

   

Azure CLI أو PowerShell

لإنشاء حاوية بسعة نقل مخصصة، انظر،

• إنشاء حاوية باستخدام Azure CLI
• إنشاء حاوية باستخدام PowerShell

.NET SDK

ملاحظة

استخدم Cosmos SDKs لواجهة برمجة تطبيقات SQL لتوفير سرعة نقل لجميع واجهات برمجة تطبيقات Cosmos DB، باستثناء Cassandra وMongoDB API.

NET SDK. الإصدار 2

// Create a container with a partition key and provision throughput of 400 RU/s
DocumentCollection myCollection = new DocumentCollection();
myCollection.Id = "myContainerName";
myCollection.PartitionKey.Paths.Add("/myPartitionKey");

await client.CreateDocumentCollectionAsync(
    UriFactory.CreateDatabaseUri("myDatabaseName"),
    myCollection,
    new RequestOptions { OfferThroughput = 400 });

.NET SDK إصدار 3

// Create a container with a partition key and provision throughput of 1000 RU/s
string containerName = "myContainerName";
string partitionKeyPath = "/myPartitionKey";

await this.cosmosClient.GetDatabase("myDatabase").CreateContainerAsync(
    id: containerName,
    partitionKeyPath: partitionKeyPath,
    throughput: 1000);

JavaScript SDK

// Create a new Client
const client = new CosmosClient({ endpoint, key });

// Create a database
const { database } = await client.databases.createIfNotExists({ id: "databaseId" });

// Create a container with the specified throughput
const { resource } = await database.containers.createIfNotExists({
id: "containerId",
throughput: 1000
});

// To update an existing container or databases throughput, you need to user the offers API
// Get all the offers
const { resources: offers } = await client.offers.readAll().fetchAll();

// Find the offer associated with your container or the database
const offer = offers.find((_offer) => _offer.offerResourceId === resource._rid);

// Change the throughput value
offer.content.offerThroughput = 2000;

// Replace the offer.
await client.offer(offer.id).replace(offer);

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

راجع المقالات التالية للتعرف على توفير معدل النقل في Azure Cosmos DB:

• كيفية توفير معدل النقل قياسية (يدوية) في قاعدة البيانات
• كيفية توفير معدل نقل البيانات بالمقياس التلقائي في قاعدة بيانات
• طلب الوحدات معدل النقل في Azure Cosmos DB