توفير معدل نقل قياسي (يدوي) على حاوية Azure Cosmos DB - API ل NoSQL

ينطبق على: NoSQL

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

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

مدخل Azure

1. قم بتسجيل الدخول إلى بوابة Azure.

2. إنشاء حساب Azure Cosmos DB جديد، أو تحديد حساب Azure Cosmos DB موجود.

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

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

   

Azure CLI أو PowerShell

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

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

.NET SDK

إشعار

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

.NET عدة تطوير البرامج إصدار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