Azure Cosmos DB'de kapsayıcı kopyalama işleri (önizleme)

ŞUNLAR IÇIN GEÇERLIDIR: Nosql MongoDB Cassandra

Kapsayıcı kopyalama işlerini kullanarak Azure Cosmos DB hesabı içinde çevrimdışı kapsayıcı kopyalama gerçekleştirebilirsiniz.

Aşağıdaki senaryolardan herhangi birini gerçekleştirmek istiyorsanız Azure Cosmos DB hesabınızdaki verileri kopyalamanız gerekebilir:

Kapsayıcı kopyalama işleri Azure CLI komutları kullanılarak oluşturulabilir ve yönetilebilir.

Başlarken

Başlamak için Azure portalında ilgili önizleme özelliğine kaydolun.

Azure Cosmos DB hesapları arasında kapsayıcı kopyalama

NoSQL API

NoSQL API hesapları için Azure Cosmos DB'de hesaplar arası çevrimdışı kapsayıcı kopyalamayı kullanmaya başlamak için Azure portalındaki Önizleme Özellikleri'nde Hesaplar arası çevrimdışı kapsayıcı kopyası (NoSQL) önizleme özelliği bayrağına kaydolun. Kayıt tamamlandıktan sonra önizleme, abonelikteki tüm NoSQL API hesapları için geçerli olur.

Azure Cosmos DB hesabı içinde kapsayıcı kopyalama

NoSQL ve Cassandra API

NoSQL ve Cassandra API hesapları için hesap içi çevrimdışı kapsayıcı kopyalamayı kullanmaya başlamak için Azure portalındaki Önizleme Özellikleri'nde hesap içi çevrimdışı kapsayıcı kopyası (Cassandra & NoSQL) önizleme özelliği bayrağına kaydolun. Kayıt tamamlandığında önizleme, abonelikteki tüm Cassandra ve NoSQL hesapları için API için geçerlidir.

MongoDB için API

MongoDB hesapları için Azure Cosmos DB'nin hesap içi çevrimdışı kapsayıcı kopyasını kullanmaya başlamak için Azure portalındaki Önizleme Özellikleri'nde hesap içi çevrimdışı koleksiyon kopyası (MongoDB) önizleme özelliği bayrağına kaydolun. Kayıt tamamlandıktan sonra önizleme, abonelikteki tüm MongoDB için API hesapları için geçerli olur.

Kapsayıcının verilerini kopyalama

  1. Kullanmak istediğiniz ayarları (bölüm anahtarı, aktarım hızı ayrıntı düzeyi, istek birimleri, benzersiz anahtar vb.) kullanarak hedef Azure Cosmos DB kapsayıcısını oluşturun.
  2. Uygulama örneklerini veya ona bağlanan istemcileri duraklatarak kaynak kapsayıcıdaki işlemleri durdurun.
  3. Kapsayıcı kopyalama işini oluşturun.
  4. Kapsayıcı kopyalama işinin ilerleme durumunu izleyin ve tamamlanana kadar bekleyin.
  5. Uygulamayı veya istemciyi hedeflenen kaynak veya hedef kapsayıcı kopyasına uygun şekilde işaret ederek işlemleri sürdürebilirsiniz.

Kapsayıcı kopyalama nasıl çalışır?

Kapsayıcı kopyalama işleri, kaynak kapsayıcının artımlı değişiklik akışı günlüğünü kullanarak çevrimdışı veri kopyalama gerçekleştirir.

  1. Platform, hedef Azure Cosmos DB hesabı için sunucu tarafı işlem örnekleri ayırır.
  2. Bu örnekler, hesap içinde bir veya daha fazla kapsayıcı kopyalama işi oluşturulduğunda ayrılır.
  3. Kapsayıcı kopyalama işleri bu örneklerde çalışır.
  4. Tek bir iş her zaman tüm örneklerde yürütülür.
  5. Örnekler, aynı hesapta çalışan tüm kapsayıcı kopyalama işleri tarafından paylaşılır.
  6. Platform, 15 dakikadan uzun süre boşta kalan örnekleri serbest bırakabilir.

Dekont

Şu anda yalnızca çevrimdışı kapsayıcı kopyalama işlerini destekliyoruz. Kapsayıcı kopyalamaya başlamadan önce kaynak kapsayıcıda herhangi bir işlem gerçekleştirmeyi durdurmanızı kesinlikle öneririz. Kopyalama işini başlattıktan sonra kaynak kapsayıcıda yapılan öğe silme işlemleri ve güncelleştirmeleri yakalanamayabilir. Kapsayıcı işi devam ederken kaynak kapsayıcıda işlemler gerçekleştirmeye devam ederseniz, hedef kapsayıcıda yinelenen veya eksik verileriniz olabilir.

Kapsayıcı kopyalama işinin hızını etkileyen faktörler

Kapsayıcı kopyalama işinin ilerleme hızı şu faktörlere göre belirlenir:

  • Kaynak kapsayıcı veya veritabanı aktarım hızı ayarı.

  • Hedef kapsayıcı veya veritabanı aktarım hızı ayarı.

    Bahşiş

    Hedef kapsayıcı aktarım hızını kaynak kapsayıcının aktarım hızının en az iki katı olarak ayarlayın.

  • Veri aktarımını gerçekleştirmek için Azure Cosmos DB hesabına ayrılan sunucu tarafı işlem örnekleri.

    Önemli

    Varsayılan SKU, hesap başına iki adet 4 vCPU 16 GB sunucu tarafı örneği sunar.

Sınırlamalar

Önizleme uygunluk ölçütleri

Kapsayıcı kopyalama işleri, aşağıdaki özelliklerin etkinleştirildiği hesaplarla çalışmaz. Kapsayıcı kopyalama işlerini çalıştırmadan önce şu özellikleri devre dışı bırakın:

Hesap yapılandırmaları

Yaşam Süresi (TTL) ayarı hedef kapsayıcıda ayarlanmamıştır. Sonuç olarak, kaynak kapsayıcıda bir belgenin süresi dolmadıysa, hedef kapsayıcıda geri sayımını yeniden başlatır.

SSS

Kapsayıcı kopyalama işleri için hizmet düzeyi sözleşmesi var mı?

Kapsayıcı kopyalama işleri şu anda en iyi çaba temelinde desteklenmektedir. İşlerin tamamlanması için gereken süre boyunca herhangi bir hizmet düzeyi sözleşmesi (SLA) garantisi sağlamayız.

Bir hesapta birden çok kapsayıcı kopyalama işi oluşturabilir miyim?

Evet, aynı hesap içinde birden çok iş oluşturabilirsiniz. İşler art arda çalışır. Bir hesapta oluşturulan tüm işleri listeleyebilir ve bunların ilerleme durumunu izleyebilirsiniz.

Azure Cosmos DB hesabındaki veritabanının tamamını kopyalayabilir miyim?

Veritabanındaki her kapsayıcı için bir iş oluşturmanız gerekir.

Birden çok bölgeye sahip bir Azure Cosmos DB hesabım var. Kapsayıcı kopyalama işi hangi bölgede çalıştırılacak?

Kapsayıcı kopyalama işi yazma bölgesinde çalışır. Çok bölgeli yazma işlemleriyle yapılandırılmış bir hesapta, iş yazma bölgeleri listesindeki bölgelerden birinde çalışır.

Hesabın yazma bölgesi değiştiğinde kapsayıcı kopyalama işlerine ne olur?

Hesabın yazma bölgesi, nadir bir bölge kesintisi senaryosunda veya el ile yük devretme nedeniyle değişebilir. Bu senaryoda, hesap içinde oluşturulan tamamlanmamış kapsayıcı kopyalama işleri başarısız olur. Bu başarısız işleri yeniden oluşturmanız gerekir. Yeniden oluşturulan işler yeni (geçerli) yazma bölgesinde çalışır.

Desteklenen bölgeler

Kapsayıcı kopyalama şu anda aşağıdaki bölgelerde desteklenmektedir:

Kuzey ve Güney Amerika Avrupa ve Afrika Asya Pasifik
Güney Brezilya Orta Fransa Orta Avustralya
Orta Kanada Güney Fransa Orta Avustralya 2
Doğu Kanada Kuzey Almanya Doğu Avustralya
Central US Orta Batı Almanya Orta Hindistan
Orta ABD EUAP Kuzey Avrupa Doğu Japonya
Doğu ABD Norveç Doğu Güney Kore - Orta
Doğu ABD 2 Norveç Batı Güneydoğu Asya
Doğu ABD 2 EUAP İsviçre Kuzey BAE Orta
Orta Kuzey ABD Batı İsviçre Batı Hindistan
Orta Güney ABD Güney Birleşik Krallık Doğu Asya
Orta Batı ABD Batı Birleşik Krallık Malezya Güney
Batı ABD Batı Avrupa Batı Japonya
Batı ABD 2 Orta İsrail Güneydoğu Avustralya
Desteklenmez Güney Afrika Kuzey Desteklenmez

Bilinen ve yaygın sorunlar

  • Hata - Sahip kaynağı yok.

    İş oluşturma işlemi başarısız olursa ve Sahip kaynağı yok (hata kodu 404) hatasını görüntülerse, hedef kapsayıcı henüz oluşturulmamıştır veya işi oluşturmak için kullanılan kapsayıcı adı gerçek bir kapsayıcı adıyla eşleşmez.

    genel bakış bölümünde belirtildiği gibi işi çalıştırmadan önce hedef kapsayıcının oluşturulduğundan emin olun ve işteki kapsayıcı adının gerçek bir kapsayıcı adıyla eşleştiğinden emin olun.

    "code": "404",
    "message": "Response status code does not indicate success: NotFound (404); Substatus: 1003; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: (Message: {\"Errors\":[\"Owner resource does not exist\"]
    
  • Hata - İstek yetkisiz.

    İstek başarısız olursa ve Yetkisiz (hata kodu 401) hatasını görüntülerse yerel yetkilendirme devre dışı bırakılmış olabilir. Yerel yetkilendirmeyi etkinleştirmeyi öğrenin.

    Kapsayıcı kopyalama işleri kimlik doğrulaması için birincil anahtarları kullanır. Yerel yetkilendirme devre dışı bırakılırsa, iş oluşturma işlemi başarısız olur. Kapsayıcı kopyalama işlerinin çalışması için yerel yetkilendirme etkinleştirilmelidir.

    "code": "401",
    "message": " Response status code does not indicate success: Unauthorized (401); Substatus: 5202; ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx; Reason: Local Authorization is disabled. Use an AAD token to authorize all requests."
    
  • Hata - İş için kaynaklar alınıyorken hata oluştu.

    Bu hata, iç sunucu sorunları nedeniyle oluşabilir. Bu sorunu çözmek için Azure portalında Yeni Destek İsteği açarak Microsoft Desteği başvurun. Sorun Türü için Veri Geçişi'ne tıklayın. Sorun alt türü için Hesap içi kapsayıcı kopyalama'yı seçin.

    "code": "500"
    "message": "Error while getting resources for job, StatusCode: 500, SubStatusCode: 0, OperationId:  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, ActivityId: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    

Sonraki adımlar