Kopyalama etkinliğinde Azure Dosyalar yapılandırma
Bu makalede, Veri işlem hattındaki kopyalama etkinliğini kullanarak verileri Azure Dosyalar'den ve Azure Dosyalar kopyalamak için nasıl kullanılacağı açıklanmıştır.
Desteklenen biçim
Azure Dosyalar aşağıdaki dosya biçimlerini destekler. Biçim tabanlı ayarlar için her makaleye bakın.
- Avro biçimi
- İkili biçim
- Sınırlandırılmış metin biçimi
- Excel biçimi
- JSON biçimi
- ORC biçimi
- Parquet biçimi
- XML biçimi
Desteklenen yapılandırma
Kopyalama etkinliği 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.
Kaynak
Kopyalama etkinliğinin Kaynak sekmesindeki Azure Dosyalar için aşağıdaki özellikler desteklenir.
Aşağıdaki özellikler gereklidir:
Veri deposu türü: Dış'ı seçin.
Bağlan ion: Bağlantı listesinden Azure Dosyalar bir bağlantı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Azure Dosyalar bağlantısı oluşturun.
Dosya yolu türü: Dosya yolu, Önek, Joker karakter dosya yolu, Dosya yolu türünüz olarak dosya listesi'ni seçebilirsiniz. Her ayarın yapılandırması şöyledir:
Dosya yolu: Bu türü seçerseniz, veriler belirtilen klasör/dosya yolundan kopyalanabilir.
Ön ek: Kaynak dosyaları filtrelemek için belirtilen dosya paylaşımının altındaki dosya adının ön eki. Adı ile
fileshare_in_connection/this_prefix
başlayan dosyalar seçilir. Azure Dosyalar için hizmet tarafı filtresini kullanır ve bu da joker karakter filtresine göre daha iyi performans sağlar.Joker karakter dosya yolu: Kaynak klasörleri veya dosyaları filtrelemek için joker karakterler içeren klasörü veya dosya yolunu belirtin.
İzin verilen joker karakterler şunlardır
*
(sıfır veya daha fazla karakterle eşleşir) ve?
(sıfır veya tek karakterle eşleşir). Klasör adınızın içinde joker karakter veya bu kaçış karakteri varsa kaçış için kullanın^
. Daha fazla örnek için Klasör ve dosya filtresi örnekleri'ne gidin.Joker klasör yolu: Kaynak klasörleri filtrelemek için joker karakterler içeren klasör yolunu belirtin.
Joker dosya adı: Kaynak dosyaları filtrelemek için yapılandırılan klasör/joker klasör yolunun altında joker karakterler içeren dosya adını belirtin.
Dosya listesi: Kopyalanacak belirli bir dosya kümesini gösterir. Dosya yolu listesinde, kopyalamak istediğiniz dosyaların listesini içeren bir metin dosyası girin veya her dosyanın göreli yolu olan satır başına bir dosyaya göz atın.
Bu seçeneği kullanırken dosya adı belirtmeyin. Daha fazla örnek için Dosya listesi örnekleri'ne gidin.
Klasör yolu: Bir klasörün yolunu belirtin. Bu gereklidir.
Dosya listesinin yolu: Kopyalamak istediğiniz dosyaların listesini içeren metin dosyasının yolunu belirtin.
Özyinelemeli olarak: Verilerin alt klasörlerden mi yoksa yalnızca belirtilen klasörden mi özyinelemeli olarak okunacağını belirtin. Özyinelemeli olarak seçildiğinde ve hedef dosya tabanlı bir depo olduğunda, hedefte boş bir klasör veya alt klasör kopyalanıp oluşturulmaz. Bu özellik varsayılan olarak seçilidir ve Dosya listesinin yolunu yapılandırdığınızda uygulanmaz.
Dosya biçimi: Açılan listeden uygulanan dosya biçimini seçin. Dosya biçimini yapılandırmak için Ayarlar seçin. Farklı dosya biçimlerinin ayarları için ayrıntılı bilgi için Desteklenen biçimdeki makalelere bakın.
Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:
Son değiştirme tarihine göre filtrele: Dosyalar, son değiştirme tarihlerine göre filtrelenir. Bu özellik, dosya yolu türünüzü Dosya listesi olarak yapılandırdığınızda geçerli değildir.
Başlangıç saati (UTC): Son değiştirme süreleri yapılandırılan saatten büyük veya buna eşitse dosyalar seçilir.
Bitiş saati (UTC): Son değiştirme süreleri yapılandırılan saatten kısaysa dosyalar seçilir.
Başlangıç saati (UTC) tarih saat değerine sahipse ancak Bitiş saati (UTC) NULL olduğunda, son değiştirilen özniteliği tarih saat değerinden büyük veya buna eşit olan dosyaların seçileceği anlamına gelir. Bitiş saati (UTC) tarih saat değerine sahipse ancak Başlangıç saati (UTC) NULL olduğunda, son değiştirilen özniteliği tarih saat değerinden küçük olan dosyaların seçileceği anlamına gelir. Özellikler NULL olabilir; başka bir deyişle verilere hiçbir dosya özniteliği filtresi uygulanmaz.
Bölüm bulmayı etkinleştir: Bölümlerin dosya yolundan ayrıştırılıp ayrıştırılmayacağını ve ek kaynak sütunlar olarak eklenip eklenmeyeceğini belirtin. Varsayılan olarak seçili değildir ve ikili dosya biçimini kullandığınızda desteklenmez.
Bölüm kök yolu: Bölüm bulma etkinleştirildiğinde, bölümlenmiş klasörleri veri sütunları olarak okumak için mutlak kök yolu belirtin.
Belirtilmezse, varsayılan olarak,
- Kaynakta dosya yolu veya dosya listesi kullandığınızda, bölüm kök yolu yapılandırdığınız yoldur.
- Joker karakter klasör filtresi kullandığınızda, bölüm kök yolu ilk joker karakterden önceki alt yoldur.
Örneğin, yolu olarak
root/folder/year=2020/month=08/day=27
yapılandırdığınız varsayılır:- Bölüm kök yolunu olarak
root/folder/year=2020
belirtirseniz kopyalama etkinliği, dosyaların içindeki sütunlara ek olarak sırasıyla "08" ve "27" değerine sahip iki sütun daha oluşturur. - Bölüm kök yolu belirtilmezse ek sütun oluşturulmaz.
En fazla eşzamanlı bağlantı: Bu özellik, etkinlik çalıştırması sırasında veri deposuna kurulan eş zamanlı bağlantıların üst sınırını gösterir. Yalnızca eşzamanlı bağlantıları sınırlamak istediğinizde bir değer belirtin.
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.
Hedef
Kopyalama etkinliğinin Hedef sekmesindeki Azure Dosyalar için aşağıdaki özellikler desteklenir.
Aşağıdaki özellikler gereklidir:
- Veri deposu türü: Dış'ı seçin.
- Bağlan ion: Bağlantı listesinden bir Azure Dosyalar bağlantısı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Azure Dosyalar bağlantısı oluşturun.
- Dosya yolu: Yolu el ile kopyalamak veya doldurmak istediğiniz dosyayı seçmek için Gözat'ı seçin.
- Dosya biçimi: Açılan listeden uygulanan dosya biçimini seçin. Dosya biçimini yapılandırmak için Ayarlar seçin. Farklı dosya biçimlerinin ayarları için ayrıntılı bilgi için Desteklenen biçimdeki makalelere bakın.
Gelişmiş'in altında aşağıdaki alanları belirtebilirsiniz:
Kopyalama davranışı: Kaynak dosya tabanlı bir veri deposundaki dosyalar olduğunda kopyalama davranışını tanımlar. Açılan listeden bir davranış seçebilirsiniz.
- Düzleştirme hiyerarşisi: Kaynak klasördeki tüm dosyalar hedef klasörün ilk düzeyindedir. Hedef dosyalar otomatik olarak oluşturulan adlara sahiptir.
- Dosyaları birleştirme: Kaynak klasördeki tüm dosyaları tek bir dosyayla birleştirir. Dosya adı belirtilirse, birleştirilmiş dosya adı belirtilen addır. Aksi takdirde, otomatik olarak oluşturulan bir dosya adıdır.
- Hiyerarşiyi koru: Hedef klasördeki dosya hiyerarşisini korur. Kaynak dosyanın kaynak klasöre göreli yolu, hedef dosyanın hedef klasöre göreli yolu ile aynıdır.
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.
Dosya başına en fazla satır: Bir klasöre veri yazarken, birden çok dosyaya yazmayı seçebilir ve dosya başına en fazla satır sayısını belirtebilirsiniz. Dosya başına yazmak istediğiniz en fazla satırı belirtin.
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. Dosya biçiminiz olarak İkili'yi seçerseniz eşleme desteklenmez.
Ayarlar
Ayarlar sekme yapılandırması için ayarlar sekmesinin altındaki diğer ayarlarınızı yapılandırma bölümüne bakın.
Tablo özeti
Aşağıdaki tablolar Azure Dosyalar kopyalama etkinliği hakkında daha fazla bilgi içerir.
Kaynak bilgileri
Hedef bilgileri
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ı |
Dosya yolu | Hedef dosyanın klasör/dosya yolu. | < klasör/dosya yolu > | Yes | / |
Dizin | Belirtilen demetin altındaki klasörün yolu. | <klasör adınız> | Hayır | klasör yolu |
Dosya adı | Belirtilen demet ve klasör yolunun altındaki dosya adı. | <dosya adınız> | Hayır | fileName |
Kopyalama davranışı | Kaynak dosya tabanlı bir veri deposundaki dosyalar olduğunda kopyalama davranışını tanımlar. | • Düzleştirme hiyerarşisi • Dosyaları birleştirme • Hiyerarşiyi koru |
Hayır | copyBehavior: • FlattenHierarchy • MergeFiles • PreserveHierarchy |
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 |
Dosya başına en fazla satır | Bir klasöre veri yazarken, birden çok dosyaya yazmayı ve dosya başına en fazla satır sayısını belirtmeyi seçebilirsiniz. Dosya başına yazmak istediğiniz en fazla satırı belirtin. | < dosya başına en fazla satırınız > | Hayır | maxRowsPerFile |
İlgili içerik
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin