Kopyalama etkinliğinde NoSQL için Azure Cosmos DB'yi yapılandırma

Bu makalede, NoSQL için Azure Cosmos DB'den ve Azure Cosmos DB'ye veri kopyalamak için veri işlem hattında kopyalama etkinliğinin nasıl kullanılacağı özetlenmiştir.

Desteklenen yapılandırma

Kopyalama etkinliğinin altındaki her sekmenin yapılandırması için sırasıyla aşağıdaki bölümlere gidin.

Genel

Genel ayarlar sekmesini yapılandırmak için Genel ayarlar kılavuzuna bakın.

Source

Aşağıdaki özellikler, kopyalama etkinliğinin Kaynak sekmesinin altında NoSQL için Azure Cosmos DB için desteklenir.

Screenshot showing source tab.

Aşağıdaki üç özellik gereklidir:

  • Veri deposu türü: Dış'ı seçin.
  • Bağlan ion: Bağlantı listesinden NoSQL için Azure Cosmos DB bağlantısı seçin. Bağlantı yoksa, Yeni'yi seçerek yeni bir NoSQL için Azure Cosmos DB bağlantısı oluşturun.
  • Kapsayıcı: Kullanmak istediğiniz kapsayıcıyı seçin. Kapsayıcı adını el ile girmek için Düzenle'yi seçin.

Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:

  • Sorguyu kullan: Kullanım sorgunuz olarak Tablo veya Sorgu'yu seçebilirsiniz. Aşağıdaki listede her ayarın yapılandırması açıklanmaktadır.

    • Tablo: Tablo'da belirttiğiniz tablodan verileri okur.

    • Sorgu: Verileri okumak için Azure Cosmos DB sorgusunu belirtir.

      Screenshot showing query.

  • Sayfa boyutu: Sorgu sonucunun sayfa başına belge sayısı. Varsayılan değer "-1"dir ve bu da hizmet tarafı dinamik sayfa boyutunun 1000'e kadar kullanılması anlamına gelir.

  • Tarih saat algılama: Belgelerdeki dize değerlerinden datetime algılanıp algılanmayacağı. İzin verilen değerler şunlardır: true (varsayılan), false.

  • Tercih edilen bölgeler: Azure Cosmos DB'den veri alınırken bağlanılması gereken bölgelerin tercih edilen listesi. Yeni'yi seçtikten sonra açılan listeden tercih edilen bir bölgeyi seçin.

    Screenshot showing preferred regions.

  • Ek sütunlar: Kaynak dosyaların göreli yolunu veya statik değerini depolamak için ek veri sütunları ekleyin. İfade, ikincisi için desteklenir. Daha fazla bilgi için Kopyalama sırasında ek sütun ekleme bölümüne gidin.

    Screenshot showing additional columns.

Hedef

Aşağıdaki özellikler, kopyalama etkinliğinin Hedef sekmesinin altında NoSQL için Azure Cosmos DB için desteklenir.

Screenshot showing destination tab.

Aşağıdaki üç özellik gereklidir:

  • Veri deposu türü: Dış'ı seçin.
  • Bağlan ion: Bağlantı listesinden NoSQL için Azure Cosmos DB bağlantısı seçin.
  • Kapsayıcı: Kopyalamak istediğiniz dosyayı seçmek için Gözat'ı seçin veya yolu el ile doldurun.

Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:

  • Yazma davranışı: Hedef, dosya tabanlı bir veri deposundaki dosyalar olduğunda yazma davranışını tanımlar. Açılan listeden Dinamik içerik ekle, Ekle veya Yukarı Ekle'yi seçebilirsiniz.

    • Dinamik içerik ekleme: Dinamik içerik ekle bölmesini açın. Bu, desteklenen sistem değişkenlerinden, etkinlik çıkışından, işlevlerden ve kullanıcı tarafından belirtilen değişkenlerden veya parametrelerden ifadeler oluşturabileceğiniz ifade oluşturucusunu açar. İfade dili hakkında bilgi için İfadeler ve işlevler'e gidin.

    • Ekle: Kaynak verilerinizde eklemeler varsa bu seçeneği belirleyin.

    • Upsert: Upsert'in davranışı, aynı kimlikte bir belge zaten varsa belgeyi değiştirmektir; aksi takdirde, belgeyi ekleyin.

      Screenshot showing write behavior.

  • Toplu iş yazma zaman aşımı: Toplu ekleme işleminin zaman aşımına uğramadan önce tamamlanması için bekleme süresi. İzin verilen değerler şeklindedir Timespan. Örnek olarak 00:30:00 (30 dakika) gösteriliyor.

  • Toplu iş boyutu yazma: Toplu iş başına SQL tablosuna eklenecek satır sayısını belirtin. İzin verilen değer bir tamsayıdır (satır sayısı). Varsayılan olarak, hizmet satır boyutuna göre uygun toplu iş boyutunu dinamik olarak belirler.

  • En fazla eşzamanlı bağlantı: Etkinlik çalıştırması sırasında veri deposuna kurulan eş zamanlı bağlantıların üst sınırı. Yalnızca eşzamanlı bağlantıları sınırlamak istediğinizde bir değer belirtin.

  • Performans ölçümleri analizini devre dışı bırakma: Bu ayar, kopyalama performansı iyileştirme ve öneriler için DTU, DWU, RU gibi ölçümlerin toplanmasını denetler. Bu davranışla ilgileniyorsanız bu özelliği kapatın.

Eşleme

Eşleme sekmesi yapılandırması için Eşleme sekmesinin altında Eşlemelerinizi yapılandırma bölümüne gidin.

Ayarlar

Ayarlar sekmesi yapılandırması için Ayarlar sekmesinin altında Diğer ayarlarınızı yapılandırma'ya gidin.

Tablo özeti

Aşağıdaki tablolar, NoSQL için Azure Cosmos DB'deki kopyalama etkinliği hakkında daha fazla bilgi içerir.

Kaynak tablosu

Veri Akışı Adı Açıklama Değer Zorunlu JSON betik özelliği
Veri deposu türü Veri deposu türünüz. Harici Yes /
Bağlantı Kaynak veri deposuyla bağlantınız. <bağlantınız> Yes bağlantı
Kapsayıcı Kaynak verilerinizin kapsayıcısı. <kaynağınızın kapsayıcısı> Yes Kapsayıcı
fileName
Sorguyu kullanma Kullanım sorgunuz olarak Tablo veya Sorgu'yu seçebilirsiniz. Tablo
Sorgu
Hayır Tür
Sayfa boyutu Sorgu sonucunun sayfa başına belge sayısı. Varsayılan değer "-1"dir ve bu da hizmet tarafı dinamik sayfa boyutunun 1000'e kadar kullanılması anlamına gelir. <Sayfanızın boyutu> Hayır Pagesize
Tarih saat silme Kaynak veri deposundaki dosyalar hedef depoya taşındıktan hemen sonra silinir. Dosya silme işlemi dosya başınadır, bu nedenle kopyalama etkinliği başarısız olduğunda bazı dosyaların hedefe kopyalandığını ve bazıları hala kaynak depodayken kaynaktan silindiğini unutmayın. Seçili veya seçimi kaldır Hayır detectDatetime
Tercih edilen bölgeler Azure Cosmos DB'den veri alınırken bağlanılması gereken bölgelerin tercih edilen listesi. Yeni'yi seçtikten sonra açılan listeden tercih edilen bir bölgeyi seçin. <tercih ettiğiniz bölgeler> Hayır preferredRegions
Ek sütunlar Kaynak dosyaların göreli yolunu veya statik değerini depolamak için ek veri sütunları ekleyin. İfade, ikincisi için desteklenir. Daha fazla bilgi için Kopyalama sırasında ek sütun ekleme bölümüne gidin. <en fazla eşzamanlı bağlantı> Hayır additionalColumns

Hedef tablo

Veri Akışı Adı Açıklama Değer Zorunlu JSON betik özelliği
Veri deposu türü Veri deposu türünüz. Harici Yes /
Bağlantı Hedef veri deposuna bağlantınız. <bağlantınız> Yes bağlantı
Kapsayıcı Hedef verilerinizin kapsayıcısı. <kaynak kapsayıcısı> Yes Kapsayıcı
fileName
Yazma davranışı Azure Cosmos DB'ye veri yazmayı açıklar. İzin verilen değerler: insert ve upsert. upsert'in davranışı, aynı kimlikte bir belge zaten varsa belgeyi değiştirmektir; aksi takdirde, belgeyi ekleyin. Dinamik içerik ekleme
Insert
Upsert
Hayır writeBehavior
Toplu iş yazma zaman aşımı Zaman aşımına uğramadan önce toplu ekleme işleminin tamamlanması için bekleme süresi. İzin verilen değerler Zaman Aralığı'dır. Örnek olarak 00:30:00 (30 dakika) gösteriliyor. timespan Hayır writeBatchTimeout
Toplu iş boyutu yazma Toplu iş başına SQL tablosuna eklenecek satır sayısı. İzin verilen değer tamsayıdır (satır sayısı). Varsayılan olarak, hizmet satır boyutuna göre uygun toplu iş boyutunu dinamik olarak belirler. <satır sayısı >
(tamsayı)
Hayır writeBatchSize
En fazla eşzamanlı bağlantı Etkinlik çalıştırması sırasında veri deposuna kurulan eş zamanlı bağlantıların üst sınırı. Yalnızca eşzamanlı bağlantıları sınırlamak istediğinizde bir değer belirtin. <en fazla eşzamanlı bağlantı> Hayır maxConcurrent Bağlan ions
Performans ölçümleri analizini devre dışı bırakma Bu ayar, kopyalama performansı iyileştirme ve öneriler için DTU, DWU, RU gibi ölçümlerin toplanmasını denetler. Bu davranışla ilgileniyorsanız bu özelliği kapatın. Seçili veya seçimi kaldır Hayır disableMetricsCollection