Kopyalama etkinliğinde Azure Blob Depolama yapılandırma

Makale
05/23/2023

Bu makalede, veri işlem hattındaki kopyalama etkinliğini kullanarak verileri Azure Blob Depolama'den ve Azure Blob Depolama kopyalamak için nasıl kullanılacağı açıklanmıştır.

Önemli

Microsoft Fabric şu anda ÖNİzLEME aşamasındadır. Bu bilgiler, yayımlanmadan önce önemli ölçüde değiştirilebilen bir yayın öncesi ürünle ilgilidir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez. Azure'da hizmetin Azure Data Factory belgelerine bakın.

Desteklenen biçim

Azure Blob Depolama 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
Kaynak
Hedef
Eşleme
Ayarlar

Genel

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

Kaynak

Kopyalama etkinliğinin Kaynak sekmesindeki Azure Blob Depolama için aşağıdaki özellikler desteklenir.

Aşağıdaki özellikler gereklidir:

Veri deposu türü: Dış'ı seçin.
Bağlantı: Bağlantı listesinden bir Azure Blob Depolama bağlantısı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Azure Blob Depolama bağlantısı oluşturun.
Dosya yolu: Kopyalamak istediğiniz dosyayı seçmek için Gözat'ı seçin veya yolu el ile doldurun.
Dosya ayarları: Dosya biçimini yapılandırmak için Dosya ayarları'nı 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:

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ı:
- Dosya yolu: Bu türü seçerseniz, veriler daha önce belirtilen kapsayıcıdan veya klasör/dosya yolundan kopyalanabilir.
- Ön ek: Kaynak blobları filtrelemek için yapılandırılan belirtilen kapsayıcının altındaki blob adı için ön ek. Adları ile container/this_prefix başlayan bloblar seçilir. Blob depolama için hizmet tarafı filtresini kullanır.
  
  Ön Ek'i kullandığınızda ve hiyerarşiyi koruyarak dosya tabanlı bir hedefe kopyalamayı seçtiğinizde, ön ekteki son "/" sonrasındaki alt yol korunur. Örneğin, bir kaynağınız container/folder/subfolder/file.txtvar ve ön eki olarak folder/subyapılandırdığınızda, korunan dosya yolu şeklindedir subfolder/file.txt.
- Joker karakter dosya yolu: Kaynak klasörlerinizi veya dosyalarınızı filtrelemek için verilen blob kapsayıcınızın altında joker karakterler içeren klasörü veya dosya yolunu belirtin.
  
  İzin verilen joker karakterler ( * 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 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 verilen kapsayıcınızın altında joker karakterler içeren klasör yolunu belirtin.
  
  Joker karakter dosya adı: Kaynak dosyaları filtrelemek için, belirli bir kapsayıcı ve klasör yolunun (veya 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 dosyaya göreli yol olan satır başına bir dosya girin veya bu dosyaya göz atın.
  
  Bu seçeneği kullanırken dosya adı belirtmeyin. Daha fazla örnek için Dosya listesi örnekleri'ne gidin.
Özyinelemeli olarak: Bu onay kutusu seçiliyse, giriş klasöründeki ve alt klasörlerindeki tüm dosyalar özyinelemeli olarak işlenir. Onay kutusunun seçimini kaldırırsanız, yalnızca seçili klasördekiler işlenir. Bu ayar, tek bir dosya seçildiğinde devre dışı bırakılır.
Tamamlandıktan sonra dosyaları sil: Bu onay kutusu seçiliyse, ikili dosyalar hedef depoya başarıyla taşındıktan sonra kaynak depodan 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 kaynaktan silindiğini, diğerlerinin ise kaynak depoda kaldığını fark edeceksiniz.

Not

Bu özellik yalnızca ikili dosya kopyalama senaryosunda geçerlidir.
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.

Hedef

Kopyalama etkinliğinin Hedef sekmesindeki Azure Blob Depolama için aşağıdaki özellikler desteklenir.

Aşağıdaki özellikler gereklidir:

Veri deposu türü:Dış'ı seçin.
Bağlantı: Bağlantı listesinden bir Azure Blob Depolama bağlantısı seçin. Bağlantı yoksa Yeni'yi seçerek yeni bir Azure Blob Depolama 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 ayarları: Dosya biçimini yapılandırmak için Dosya ayarları'nı 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 Dinamik içerik ekle, Yok, DüztenHierarchy veya Hiyerarşiyi koru'yı seçebilirsiniz.
- Dinamik içerik ekleme: Özellik değeri için bir ifade belirtmek için Dinamik içerik ekle'yi seçin. Bu seçim, 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.
- Hiçbiri: Herhangi bir kopyalama davranışı kullanmamak için bu seçimi seçin.
- 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.
- 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 olan göreli yoluyla 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.
Blok boyutu (MB):Blok boyutunu blok bloblarına veri yazmak için kullanılan megabayt cinsinden belirtin. Daha fazla bilgi için Blok blobları hakkında bölümüne gidin.
Meta veriler: Hedefe kopyalarken özel meta veriler ayarlayın. Dizi altındaki metadata her nesne fazladan bir sütunu temsil eder. name meta veri anahtarı adını tanımlar ve value değeri ise bu anahtarın veri değerini gösterir. Öznitelikleri koru özelliği kullanılırsa, belirtilen meta veriler kaynak dosya meta verileriyle birlikte/üzerine yazılır.

İzin verilen veri değerleri şunlardır:
- $$LASTMODIFIED: ayrılmış değişken, kaynak dosyaların son değiştirme zamanının depolandığı gösterir. Yalnızca ikili biçimi olan dosya tabanlı kaynağa uygulayın.
- Expression
- Statik değer

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 sekmesi 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 Blob Depolama kopyalama etkinliği hakkında daha fazla bilgi içerir.

Kaynak bilgileri

Adı	Açıklama	Değer	Gerekli	JSON betik özelliği
Veri deposu türü	Veri deposu türünüz.	Dış	Yes	/
Bağlantı	Kaynak veri deposuyla bağlantınız.	<bağlantınız>	Yes	bağlantı
Dosya yolu	Kaynak verilerinizin dosya yolu.	<kaynağınızın dosya yolu>	Yes	kapsayıcı fileName
Dosya yolu türü	Kullanmak istediğiniz dosya yolu türü.	• Dosya yolu •Önek • Joker klasör yolu, Joker karakter dosya adı • Dosya listesi	Hayır	•Önek • wildcardFolderPath, wildcardFileName • fileListPath
Yinelemeli olarak	Giriş klasöründeki ve alt klasörlerindeki tüm dosyaları özyinelemeli olarak veya yalnızca seçili klasördeki dosyaları işleyin. Bu ayar, tek bir dosya seçildiğinde devre dışı bırakılır.	Seçili veya seçimi kaldır	Hayır	Özyinelemeli
Tamamlandıktan sonra dosyaları silme	Kaynak veri deposundaki dosyalar, hedef depoya taşındıktan hemen sonra silinir. Dosya silme işlemi dosya başına yapılır, bu nedenle kopyalama etkinliği başarısız olduğunda bazı dosyaların hedefe kopyalandığını ve kaynaktan silindiğini, bazılarının ise hala kaynak depoda olduğunu fark edersiniz.	Seçili veya seçimi kaldır	Hayır	deleteFilesAfterCompletion
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.	<maksimum eşzamanlı bağlantı>	Hayır	maxConcurrentConnections

Hedef bilgileri

Adı	Açıklama	Değer	Gerekli	JSON betik özelliği
Veri deposu türü	Veri deposu türünüz.	Dış	Yes	/
Bağlantı	Hedef veri deposuyla bağlantınız.	<bağlantınız>	Yes	bağlantı
Dosya yolu	Hedef verilerinizin dosya yolu.	Kaynağın dosya yolu	Yes	kapsayıcı fileName
Kopyalama davranışı	Depolama gibi bir dosya sisteminden diğerine (örneğin, bir blob depolamadan diğerine) dosya kopyalama davranışını tanımlar.	•Hiçbiri • Dinamik içerik ekleme • Düzleştirme hiyerarşisi • Hiyerarşiyi koru	Hayır	copyBehavior
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.	<maksimum eşzamanlı bağlantı>	Hayır	maxConcurrentConnections
Blok boyutu (MB)	Azure Blob Depolama'a veri yazarken blok boyutunu MB olarak belirtin. İzin verilen değer 4 MB ile 100 MB arasındadır.	<blok boyutu>	Hayır	blockSizeInMB
Meta veri	Hedefe kopyalarken özel meta verileri ayarlayın.	• `$$LASTMODIFIED` •Ifa -de • Statik değer	Hayır	meta veriler