Azure Cosmos DB'de bölümleri birleştirme (önizleme)

ŞUNLAR IÇIN GEÇERLIDIR: NoSQL MongoDB

Bölümleri Azure Cosmos DB'de birleştirme (önizleme), kapsayıcınız için kullanılan fiziksel bölüm sayısını azaltmanıza olanak tanır. Birleştirme ile aktarım hızı (bölüm başına ru/sn sayısı düşük) veya depolama alanı (bölüm başına düşük depolama alanına sahip) parçalanmış kapsayıcıların fiziksel bölümleri yeniden işlenebilir. Kapsayıcının aktarım hızının ölçeği artırıldıysa ve ölçeğin yeniden küçültülmesi gerekiyorsa birleştirme, aktarım hızı parçalanma sorunlarını çözmeye yardımcı olabilir. Aynı miktarda sağlanan RU/sn için daha az fiziksel bölüm olması, her fiziksel bölümün genel RU/sn'den daha fazlasını aldığı anlamına gelir. Bir kapsayıcıdan büyük miktarda veri kaldırılırsa ve bölüm başına RU/sn düşükse, bölümlerin en aza indirilmesi hız sınırlama olasılığını azaltır. Birleştirme, kullanılmayan veya boş bölümleri temizlemeye ve depolama parçalanma sorunlarını etkili bir şekilde çözmeye yardımcı olabilir.

Başlarken

Bölüm birleştirmeyi kullanmaya başlamak için Azure Cosmos DB hesabınızdaki Özellikler sayfasına gidin. Bölüm birleştirme (önizleme) özelliğini seçin ve etkinleştirin.

Özelliği etkinleştirmeden önce Azure Cosmos DB hesaplarınızın tüm önizleme uygunluk ölçütlerini karşıladığını doğrulayın. Özelliği etkinleştirdikten sonra etkin olması 15-20 dakika sürer.

Azure Cosmos DB hesabının önizleme için uygun olup olmadığını denetlemek için Azure portalında yerleşik uygunluk denetleyicisini kullanabilirsiniz. Azure portalındaki Azure Cosmos DB hesabına genel bakış sayfasında Sorunları tanılama ve çözme ->Aktarım Hızı ve Ölçeklendirme ->Bölüm Birleştirme bölümüne gidin. Bölüm birleştirme önizlemesi için uygunluğu denetle tanılamasını çalıştırın.

Birleştirilecek kapsayıcıları tanımlama

Bu koşulların her ikisini de karşılayan kapsayıcılar, bölümlerin birleştirilmesinden büyük olasılıkla yararlanır:

• Koşul 1: Fiziksel bölüm başına geçerli RU/sn 3000 RU/sn'dir <
• Koşul 2: Fiziksel bölüm başına GB cinsinden geçerli ortalama depolama alanı 20 GB'tır <

Koşul 1 genellikle daha önce RU/sn ölçeğini artırdığınızda (genellikle veri alımı için) ve şimdi kararlı durumda ölçeği küçültmek istediğinizde oluşur. Koşul 2 genellikle büyük miktarda veriyi sildiğinizde/TTL'de kullanıldığında oluşur ve kullanılmayan bölümler bırakılır.

Koşul 1

Fiziksel bölüm başına geçerli RU/sn değerini belirlemek için Cosmos hesabınızdan Ölçümler'e gidin. Fiziksel Bölüm Aktarım Hızı ölçümünü seçin ve veritabanınıza ve kapsayıcınıza filtreleyin. PhysicalPartitionId ile bölmeyi uygulayın.

Otomatik ölçeklendirme kullanan kapsayıcılar için bu ölçüm, her fiziksel bölümde şu anda sağlanan maksimum RU/sn değerini gösterir. El ile aktarım hızı kullanan kapsayıcılar için bu ölçüm, her fiziksel bölümde el ile RU/sn'yi gösterir.

Aşağıdaki örnekte, 5000 RU/sn (500 - 5000 RU/sn arasında ölçeklendirilir) ile sağlanan bir otomatik ölçeklendirme kapsayıcımız vardır. Beş fiziksel bölüme ve her fiziksel bölümde 1000 RU/sn vardır.

Koşul 2

Fiziksel bölüm başına geçerli ortalama depolama alanını belirlemek için önce kapsayıcının genel depolama alanını (veri + dizin) bulun.

İçgörüler>Depolama>Verileri ve Dizin Kullanımı'na gidin. Toplam depolama alanı, veri ve dizin kullanımının toplamıdır. Aşağıdaki örnekte kapsayıcının toplam 74 GB depolama alanı vardır.

Ardından, toplam fiziksel bölüm sayısını bulun. Bu ölçüm, Koşul 1'de gördüğümüz PhysicalPartitionThroughput grafiğindeki benzersiz PhysicalPartitionId sayısıdır. Örneğimizde beş fiziksel bölümümüz vardır.

Son olarak, hesaplayın: TOPLAM DEPOLAMA GB/fiziksel bölüm sayısı. Örneğimizde, fiziksel bölüm başına ortalama (74 GB / beş fiziksel bölüm) = 14,8 GB var.

Kapsayıcımız, 1 ve 2 koşullarına bağlı olarak bölümlerin birleştirilmesinden yararlanabilir.

Fiziksel bölümleri birleştirme

PowerShell'de bayrak -WhatIf geçirildiğinde Azure Cosmos DB bir simülasyon çalıştırır ve birleştirme işleminin beklenen sonucunu döndürür. Birleştirmenin kendisi çalışmasa da bu sonuç döndürülür. Bayrağı geçirilmediğinde, birleştirme kaynağa karşı yürütülür. İşlem tamamlandığında, komut birleştirme sonrasında fiziksel bölüm başına geçerli depolama miktarını KB cinsinden çıkış olarak oluşturur.

$parameters = @{
    Name = "Az.CosmosDB"
    AllowPrerelease = $true
    Force = $true
}
Install-Module @parameters

az extension add \
    --name cosmosdb-preview

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    AccountName = "<cosmos-account-name>"
    DatabaseName = "<cosmos-database-name>"
    Name = "<cosmos-container-name>"
    WhatIf = $true
}
Invoke-AzCosmosDBSqlContainerMerge @parameters

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    AccountName = "<cosmos-account-name>"
    DatabaseName = "<cosmos-database-name>"
    Name = "<cosmos-container-name>"
}
Invoke-AzCosmosDBSqlContainerMerge @parameters

az cosmosdb sql container merge \
    --resource-group '<resource-group-name>' \
    --account-name '<cosmos-account-name>' \
    --database-name '<cosmos-database-name>' \
    --name '<cosmos-container-name>'

az cosmosdb sql database merge `
    --resource-group "<resource-group-name>" `         
    --name "<database-name>"  `
    --account-name "<cosmos-db-account-name>" 

databaseId=$(az cosmosdb sql database show `
    --resource-group "<resource-group-name>" `
    --name "<database-name>" `
    --account-name "<cosmos-db-account-name>" `
    --query "id" `
    --output "tsv"
)

endpoint="https://management.azure.com$databaseId/partitionMerge?api-version=2023-11-15-preview"

az rest `
    --method "POST" `
    --url $endpoint `
    --body "{}"

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    AccountName = "<cosmos-account-name>"
    DatabaseName = "<cosmos-database-name>"
    Name = "<cosmos-container-name>"
    WhatIf = $true
}

Invoke-AzCosmosDBMongoDBCollectionMerge @parameters

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    AccountName = "<cosmos-account-name>"
    DatabaseName = "<cosmos-database-name>"
    Name = "<cosmos-container-name>"
}
Invoke-AzCosmosDBMongoDBCollectionMerge @parameters

az cosmosdb mongodb collection merge \
    --resource-group '<resource-group-name>' \
    --account-name '<cosmos-account-name>' \
    --database-name '<cosmos-database-name>' \
    --name '<cosmos-collection-name>'

Paylaşılan aktarım hızı veritabanları için kullanarak birleştirmeyi az cosmosdb mongodb database mergebaşlatın.

az cosmosdb mongodb database merge \
	--account-name '<cosmos-account-name>'                               
	--name '<cosmos-database-name>'                                
	--resource-group '<resource-group-name>'

Birleştirme işlemlerini izleme

Bölüm birleştirme uzun süre çalışan bir işlemdir ve tamamlanmasının ne kadar süreceğine ilişkin SLA yoktur. Süre, kapsayıcıdaki veri miktarına ve fiziksel bölümlerin sayısına bağlıdır. Birleştirme işleminin tamamlanması için en az 5-6 saat izin vermek önerilir.

Kapsayıcınızda bölüm birleştirme çalışırken, kapsayıcı ayarlarını (TTL, dizin oluşturma ilkesi, benzersiz anahtarlar vb.) değiştirirseniz devam eden birleştirme işlemi iptal edilir. Birleştirme çalışırken RU/sn değerini artırırsanız devam eden birleştirme işlemi iptal edilir ve kapsayıcınızın RU/sn değeri yeni değerinizle güncelleştirilir. İstenen RU/sn'ye bağlı olarak, ölçeği artırma işleminiz anlık olabilir veya daha uzun sürebilir. Birleştirme çalışırken RU/sn'nizi azaltırsanız, RU/sn yeni RU/sn'ye anında güncelleştirilir. Devam eden birleştirme işlemi, birleştirme tetiklendiği sırada ayarlanan RU/sn temelinde aynı hedef bölüm sayısıyla devam edecektir. En iyi uygulama olarak, kapsayıcı veya aktarım hızı ayarlarınızı değiştirmeden önce birleştirme işlemi tamamlanana kadar beklemeniz önerilir.

Etkinlik Günlüğü'nü gözden geçirip MongoDB koleksiyonunun fiziksel bölümlerini birleştirme veya SQL kapsayıcısının fiziksel bölümlerini birleştirme olayları için filtre uygulayın.

Sınırlamalar

Şu anda birleştirme özelliğinin sınırlamaları aşağıdadır.

Önizleme uygunluk ölçütleri

Önizlemeye kaydolmak için Azure Cosmos DB hesabınızın aşağıdaki tüm ölçütleri karşılaması gerekir:

• Azure Cosmos DB hesabınız NoSQL için API veya =3.6 sürümüne >sahip MongoDB kullanır.
• Azure Cosmos DB hesabınız sağlanan aktarım hızını (el ile veya otomatik ölçeklendirme) kullanıyor. Birleştirme sunucusuz hesaplar için geçerli değildir.
• Azure Cosmos DB hesabınız tek yazma bölgesi hesabıdır (birleştirme şu anda çok bölgeli yazma hesapları için desteklenmemektedir).
• Azure Cosmos DB hesabınız aşağıdaki özelliklerden hiçbirini kullanmaz:
  • Belirli bir noktaya geri yükleme
  • Müşteri tarafından yönetilen anahtarlar
  • Analiz deposu
• NoSQL için API kullanıyorsanız, uygulamanızın Azure Cosmos DB .NET v3 SDK'sını (sürüm 3.27.0 veya üzeri) veya Java v4 SDK'sını (sürüm 4.42.0 veya üzeri) kullanması gerekir. Hesabınızda birleştirme önizlemesi etkinleştirildiğinde, hesap .NET/Java SDK'ları veya eski .NET/Java SDK sürümlerinden gönderilen istekleri kabul etmez.
  • MongoDB için API ile özelliği kullanmak için SDK veya sürücü gereksinimi yoktur.
• Azure Cosmos DB hesabınız şu anda desteklenmeyen bağlayıcıları kullanmaz:
  • Azure Data Factory
  • Azure Stream Analytics
  • Logic Apps
  • Azure İşlevleri uzantısı <= 3.x (Azure İşlevleri uzantısı 4.0 ve üzeri desteklenir)
  • Azure Search
  • Azure Cosmos DB Spark bağlayıcısı < 4.18.0
  • .NET v3 SDK'sı = v3.27.0 veya Java v4 SDK'sı >= 4.42.0 olmayan bir Azure Cosmos DB SDK'sı >bağımlılığı olan herhangi bir üçüncü taraf kitaplığı veya aracı

Hesap kaynakları ve yapılandırma

• Birleştirme yalnızca NoSQL ve MongoDB hesapları için API için kullanılabilir. MongoDB hesapları için API için MongoDB hesabı sürümü 3.6 veya üzeri olmalıdır.
• Birleştirme yalnızca tek bölgeli yazma hesapları için kullanılabilir. Çok bölgeli yazma hesabı desteği kullanılamaz.
• Birleştirme işlevini kullanan hesaplar da bu özellikleri kullanamaz (bu özellikler birleştirme özellikli bir hesaba eklenirse, hesap kaynakları birleştiremez):
  • Belirli bir noktaya geri yükleme
  • Müşteri tarafından yönetilen anahtarlar
  • Analiz deposu
• Bir kapsayıcı birleştirildikten sonra, değişiklik akışını başlangıç zamanıyla okumak mümkün değildir. Bu özellik için destek gelecek için planlanıyor.

SDK gereksinimleri (yalnızca NoSQL için API)

Birleştirme özelliğinin etkinleştirildiği hesaplar yalnızca .NET v3 SDK veya Java v4 SDK'sının en son sürümünü kullandığınızda desteklenir. Özellik hesabınızda etkinleştirildiğinde (birleştirmeyi çalıştırıp çalıştırmadığınızdan bağımsız olarak), yalnızca hesabı kullanarak desteklenen SDK'yi kullanmanız gerekir. Diğer SDK'lardan veya önceki sürümlerden gönderilen istekler kabul edilir. Desteklenen SDK'yı kullandığınız sürece, birleştirme işlemi devam ederken uygulamanız çalışmaya devam edebilir.

Desteklenen SDK'nın en son sürümünü bulun:

Gelecekte diğer SDK'lar için destek planlanıyor.

Desteklenmeyen bağlayıcılar

Önizlemeye kaydolduysanız aşağıdaki bağlayıcılar başarısız olur.

• Azure Data Factory ¹
• Azure Stream Analytics ¹
• Logic Apps ¹
• Azure İşlevleri uzantısı <= 3.x (Azure İşlevleri uzantısı 4.0 ve üzeri desteklenir) ¹
• Azure Search ¹
• Azure Cosmos DB Spark bağlayıcısı < 4.18.0
• .NET v3 SDK'sı = v3.27.0 veya Java v4 SDK'sı >= 4.42.0 olmayan bir Azure Cosmos DB SDK'sı >bağımlılığı olan herhangi bir üçüncü taraf kitaplığı veya aracı

¹ Gelecekte bu bağlayıcılar için destek planlanıyor.

Sonraki adımlar

• Azure Cosmos DB ile Azure CLI kullanma hakkında daha fazla bilgi edinin.
• Azure Cosmos DB ile Azure PowerShell kullanma hakkında daha fazla bilgi edinin.
• Azure Cosmos DB'de bölümleme hakkında daha fazla bilgi edinin.