Foreach Döngü Kapsayıcısı

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Integration Runtime

Foreach Döngüsü kapsayıcısı, bir pakette yinelenen bir denetim akışı tanımlar. Döngü uygulaması, programlama dillerindeki Foreach döngü yapısına benzer. Bir pakette döngü, Foreach numaralandırıcısı kullanılarak etkinleştirilir. Foreach Döngüsü kapsayıcısı, belirtilen bir numaralandırıcının her üyesi için denetim akışını yineler.

SQL Server Integration Services aşağıdaki numaralandırıcı türlerini sağlar:

• Tablolardaki satırları numaralandırmak için Foreach ADO numaralandırıcısı. Örneğin, ADO kayıt kümesindeki satırları alabilirsiniz.

  Recordset hedefi, verileri Nesne veri türündeki bir paket değişkeninde depolanan bir kayıt kümesinde belleğe kaydeder. Kayıt kümesinin bir satırını aynı anda işlemek için genellikle Foreach ADO numaralandırıcısı ile bir Foreach Döngüsü kapsayıcısı kullanırsınız. Foreach ADO numaralandırıcısı için belirtilen değişken Nesne veri türünde olmalıdır. Kayıt Kümesi hedefi hakkında daha fazla bilgi için bkz. Kayıt Kümesi Hedefikullanma .

• Foreach ADO.NET Şema Satır Kümesi numaralandırıcısı, bir veri kaynağı hakkındaki şema bilgilerini numaralandırır. Örneğin, AdventureWorks2025 SQL Server veritabanındaki tabloların listesini listeleyebilir ve alabilirsiniz.

• Bir klasördeki dosyaları listelemek için Foreach Dosya numaralandırıcısı. Dizinleyici alt klasörlerde gezinebilir. Örneğin, Windows klasöründe ve alt klasörlerinde *.log dosya adı uzantısına sahip tüm dosyaları okuyabilirsiniz. Dosyaların alınacağı sıranın belirtilemeyeceğini unutmayın.

• Belirtilen bir değişkendeki numaralandırılabilir nesneyi listelemek için Foreach From Variable numaralandırıcısı kullanılır. Numaralandırılabilir nesne bir dizi, ADO.NET DataTable, Integration Services numaralandırıcısı vb. olabilir. Örneğin, sunucuların adını içeren bir dizinin değerlerini numaralandırabilirsiniz.

• Koleksiyonları numaralandırmak için Foreach Item numaralandırıcısı. Örneğin, İşlem Yürütme görevinin kullandığı çalıştırılabilir dosyaların ve çalışma dizinlerinin adlarını sıralayabilirsiniz.

• Xml Yol Dili (XPath) ifadesinin sonuç kümesini numaralandırmak için Foreach Nodelist numaralandırıcısı. Örneğin, bu ifade klasik dönemdeki tüm yazarların listesini numaralandırır ve alır: /authors/author[@period='classical'].

• SQL Server Yönetim Nesneleri (SMO) nesnelerini listelemek için Foreach SMO numaralandırıcısı. Örneğin, bir SQL Server veritabanındaki görünümleri listeleyebilirsiniz.

• Belirtilen HDFS konumunda HDFS dosyalarını listelemek için Foreach HDFS Dosya Numaralandırıcısı.

• Azure Depolama'daki bir blob kapsayıcısında blobları listelemek için Foreach Azure Blob numaralandırıcısı.

• Azure Data Lake Store'da bir dizindeki dosyaları listelemek için Foreach ADLS Dosya numaralandırıcısı.

• Azure Data Lake Store 2. Nesil'de bir dizindeki dosyaları listelemek için Foreach Data Lake Storage 2. Nesil Dosya numaralandırıcısı.

Aşağıdaki diyagramda, Dosya Sistemi görevine sahip bir Foreach Döngüsü kapsayıcısı gösterilmektedir. Foreach döngüsü Foreach Dosya numaralandırıcısını kullanır ve Dosya Sistemi görevi bir dosyayı kopyalamak için yapılandırılır. Numaralandırıcının belirttiği klasör dört dosya içeriyorsa, döngü dört kez yineler ve dört dosya kopyalar.

Paket nesnesinin özelliğini numaralandırıcı koleksiyon değeriyle güncelleştirmek için değişkenlerin ve özellik ifadelerinin birleşimini kullanabilirsiniz. Önce koleksiyon değerini kullanıcı tanımlı bir değişkene eşler ve ardından değişkeni kullanan özelliğine bir özellik ifadesi uygularsınız. Örneğin, Foreach Dosya numaralandırıcısının koleksiyon değeri MyFile adlı bir değişkene eşlenir ve daha sonra değişken, Posta Gönder görevinin Subject özelliği için özellik ifadesinde kullanılır. Paket çalıştırıldığında, Subject özelliği döngü her yinelendiğinde dosyanın adıyla güncelleştirilir. Daha fazla bilgi için bkz. Packages'da Özellik İfadelerini Kullanma.

Numaralandırıcı koleksiyonu değerine eşlenen değişkenler ifadelerde ve betiklerde de kullanılabilir.

Foreach Döngüsü kapsayıcısı birden çok görev ve kapsayıcı içerebilir, ancak yalnızca bir tür numaralandırıcı kullanabilir. Foreach Döngüsü kapsayıcısı birden çok görev içeriyorsa, numaralandırıcı koleksiyonu değerini her görevin birden çok özelliğiyle eşleyebilirsiniz.

Paket denetim akışının bir alt kümesi için bir işlem tanımlamak üzere Foreach Döngüsü kapsayıcısı üzerinde bir işlem özniteliği ayarlayabilirsiniz. Bu şekilde, işlemleri paket düzeyi yerine Foreach Döngüsü düzeyinde yönetebilirsiniz. Örneğin, foreach döngüsü kapsayıcısı bir yıldız şemasındaki boyutları ve olgu tablolarını güncelleştiren bir denetim akışını yinelerse, tüm olgu tablolarının başarıyla güncelleştirildiğinden veya hiçbirinin güncelleştirilmediğinden emin olmak için bir işlem yapılandırabilirsiniz. Daha fazla bilgi için bkz. Integration Services Transactions.

Numaralandırıcı Türleri

Numaralandırıcılar yapılandırılabilir ve numaralandırıcıya bağlı olarak farklı bilgiler sağlamanız gerekir.

Aşağıdaki tabloda, her numaralandırıcı türünün gerektirdiği bilgiler özetlemektedir.

Numaralayıcı	Yapılandırma gereksinimleri
Foreach ADO	ADO nesne kaynağı değişkenini ve numaralandırıcı modunu belirtin. Değişkenin Nesne veri türünde olması gerekir.
Foreach ADO.NET Şema Satır Kümesi	Bir veritabanına bağlantıyı ve numaralandırılacak şemayı belirtin.
Foreach Dosyası	Numaralandırılacak klasörü ve dosyaları, alınan dosyaların dosya adının biçimini ve alt klasörler arasında geçiş yapılıp yapılmayacağını belirtin.
Bir Değişkenden Foreach	Numaralandırılacak nesneleri içeren değişkeni belirtin.
Foreach Öğesi	Foreach Item koleksiyonundaki sütunları ve sütun veri türlerini içeren öğeleri tanımlayın.
Foreach Nodelist	XML belgesinin kaynağını belirtin ve XPath işlemini yapılandırın.
Foreach SMO	Bir veritabanı bağlantısını ve numaralandırılacak SMO nesnelerini belirtin.
Foreach HDFS Dosya Numaralandırıcısı	Numaralandırılacak klasörü ve dosyaları, alınan dosyaların dosya adının biçimini ve alt klasörler arasında geçiş yapılıp yapılmayacağını belirtin.
Foreach Azure Blobu	Numaralandırılacak blobları içeren Azure Blob Depolama kapsayıcısını belirtin.
Foreach ADLS Dosyası	Numaralandırılacak dosyaları içeren Azure Data Lake Store dizinini belirtin.
Foreach Data Lake Storage 2. Nesil Dosyası	Numaralandırılacak dosyaları içeren Azure Data Lake Storage 2. Nesil dizinini ve diğer seçenekleri belirtin.

Foreach Döngüsü kapsayıcısı ile denetim akışına numaralandırma ekleme

Integration Services, bir paketin denetim akışındaki dosyaları ve nesneleri numaralandıran bir döngü yapısı eklemeyi kolaylaştıran bir denetim akışı öğesi olan Foreach Döngüsü kapsayıcısını içerir. Daha fazla bilgi için bkz. Foreach Döngü Kapsayıcısı.

Foreach Döngüsü kapsayıcısı hiçbir işlev sağlamaz; yalnızca yinelenebilir denetim akışını oluşturduğunuz, bir numaralandırıcı türü belirttiğiniz ve numaralandırıcıyı yapılandırdığınız yapıyı sağlar. Kapsayıcı işlevselliği sağlamak için Foreach Döngüsü kapsayıcısına en az bir görev eklemeniz gerekir. Daha fazla bilgi için bkz. Entegrasyon Hizmetleri Görevleri.

Foreach Döngüsü kapsayıcısı, birden çok görevin ve diğer kapsayıcıların bulunduğu bir denetim akışını içerebilir. Görevleri ve kapsayıcıları Foreach Döngüsü kapsayıcısına eklemek, görevleri ve kapsayıcıları paket yerine Foreach Döngüsü kapsayıcısına sürüklemeniz dışında, bunları bir pakete eklemeye benzer. Foreach Döngüsü kapsayıcısı birden fazla görev veya kapsayıcı içeriyorsa, bunları bir pakette yaptığınız gibi öncelik kısıtlamalarını kullanarak bağlayabilirsiniz. Daha fazla bilgi için bkz. Öncelik Kısıtlamaları.

Foreach Döngüsü kapsayıcısını ekleyin ve yapılandırın

1. Foreach Döngü kapsayıcısını pakete ekleyin. Daha fazla bilgi için bkz. Denetim Akışında Görev veya Kapsayıcı Ekleme veya Silme.

2. Foreach Döngüsü kapsayıcısına görevler ve kapsayıcılar ekleyin. Daha fazla bilgi için bkz. Denetim Akışında Görev veya Kapsayıcı Ekleme veya Silme.

3. Öncelik kısıtlamalarını kullanarak Foreach Döngüsü kapsayıcısında görevleri ve kapsayıcıları bağlayın. Daha fazla bilgi için bkz. Varsayılan Öncelik Kısıtlaması Kullanarak Görevleri ve Kapsayıcıları Bağlama.

4. Foreach Döngüsü kapsayıcısını yapılandırın.

Foreach Döngü Kapsayıcısını Yapılandırma

Bu yordamda, numaralandırıcı ve kapsayıcı düzeylerindeki özellik ifadeleri de dahil olmak üzere foreach Döngüsü kapsayıcısının nasıl yapılandırıldığı açıklanır.

1. SQL Server Veri Araçları'nda (SSDT), istediğiniz paketi içeren Integration Services projesini açın.

2. Denetim Akışı sekmesine tıklayın ve Foreach Döngüsü'ne çift tıklayın.

3. foreach Döngü Düzenleyicisi iletişim kutusunda, Genel 'e tıklayın ve isteğe bağlı olarak Foreach Döngüsünün adını ve açıklamasını değiştirin.

4. Koleksiyon 'e tıklayın ve Numaralandırıcı listesinden bir numaralandırıcı türü seçin.

5. Bir numaralandırıcı belirtin ve numaralandırıcı seçeneklerini aşağıdaki gibi ayarlayın:

   • Foreach Dosya numaralandırıcısını kullanmak için, numaralandırılacak dosyaları içeren klasörü sağlayın, dosya adı ve türü için bir filtre belirtin ve tam dosya adının döndürülip döndürülmeyeceğini belirtin. Ayrıca, daha fazla dosya için alt klasörlerde yineleme yapılıp yapılmayacağını belirtin.

   • Foreach Öğesi numaralandırıcısını kullanmak için Sütunlaröğesine tıklayın ve For Each Item Columns için iletişim kutusunda sütun eklemek amacıyla 'Ekle' düğmesine tıklayın. Her sütun için Veri Türü listesinden bir veri türü seçin ve tamamtıklayın.

     Sütunlara değerler yazın veya listelerden değerleri seçin.

     Not

     Yeni satır eklemek için, yazdığınız hücrenin dışında herhangi bir yere tıklayın.

     Not

     Bir değer sütun veri türüyle uyumlu değilse, metin vurgulanır.

   • Foreach ADO numaralandırıcısını kullanmak için var olan bir değişkeni seçin veya ADO nesne kaynağı değişkeni listesindeki Yeni değişken 'e tıklayarak numaralandırılacak ADO nesnesinin adını içeren değişkeni belirtin ve bir numaralandırma modu seçeneği belirleyin.

     Yeni bir değişken oluşturuyorsanız Değişken Ekle iletişim kutusunda değişken özelliklerini ayarlayın.

   • Foreach ADO.NET Şema Satır Kümesi numaralandırıcısını kullanmak için var olan bir ADO.NET bağlantısını seçin veya Bağlantı listesinde Yeni bağlantı tıklayın ve ardından bir şema seçin.

     İsteğe bağlı olarak, Kısıtlama Ayarla tıklayın ve şema kısıtlamalarını seçin, kısıtlama değerini içeren değişkeni seçin veya kısıtlama değerini yazın ve Tamamtıklayın.

   • Foreach From Variable numaralandırıcısını kullanmak için Değişken listesinden bir değişken seçin.

   • Foreach NodeList numaralandırıcısını kullanmak için DocumentSourceType'a tıklayın, listeden kaynak türünü seçin ve ardından DocumentSource'a tıklayın. DocumentSourceType için seçilen değere bağlı olarak, listeden bir değişken veya dosya bağlantısı seçin, yeni bir değişken veya dosya bağlantısı oluşturun ya da Belge Kaynağı DüzenleyicisiXML kaynağını yazın.

     Ardından EnumerationType'a tıklayın ve listeden bir numaralandırma türü seçin. EnumerationType Gezgin, Düğüm veya NodeTextise, OuterXPathStringSourceType'a tıklayın, kaynak türünü seçin ve ardından OuterXPathString'e tıklayın. OuterXPathStringSourceType için ayarlanan değere bağlı olarak, listeden bir değişken veya dosya bağlantısı seçin, yeni bir değişken veya dosya bağlantısı oluşturun veya dış XML Yol Dili (XPath) ifadesi için dizeyi yazın.

     EnumerationType ElementCollectionise, yukarıda açıklandığı gibi OuterXPathStringSourceType ve OuterXPathString'i ayarlayın. Ardından InnerElementType'a tıklayın, iç öğeler için bir numaralandırma türü seçin ve ardından InnerXPathStringSourceType'a tıklayın. InnerXPathStringSourceType için ayarlanan değere bağlı olarak bir değişken veya dosya bağlantısı seçin, yeni bir değişken veya dosya bağlantısı oluşturun ya da iç XPath ifadesinin dizesini yazın.

   • Foreach SMO numaralandırıcısını kullanmak için var olan bir ADO.NET bağlantısını seçin veya Bağlantı listesinde Yeni bağlantı 'e tıklayın ve sonra kullanılacak dizeyi yazın veya Gözatöğesine tıklayın. Gözatseçeneklerine tıkladığınızda, SMO Numaralandırmasını Seç iletişim kutusunda numaralandırılacak nesne türünü ve numaralandırma türünü seçin ve OKseçeneğine tıklayın.

6. İsteğe bağlı olarak, özellik değerlerini güncelleştiren ifadeler oluşturmak için Koleksiyonu sayfasındaki İfadeler metin kutusundaki gözat düğmesine (...) tıklayın. Daha fazla bilgi için bkz. Özellik İfadesi Ekleme veya Değiştirme.

   Not

   Özellik listesinde listelenen özellikler numaralandırıcıya göre değişir.

7. İsteğe bağlı olarak, nesne özelliklerini koleksiyon değerine eşlemek için Değişken Eşlemeleri tıklayın ve ardından aşağıdaki işlemleri yapın:

   1. Değişkenler listesinde bir değişken seçin veya Yeni Değişken'tıklayarak yeni bir değişken oluşturun.

   2. Yeni bir değişken eklerseniz değişken özelliklerini Değişken Ekle iletişim kutusunda ayarlayın ve Tamam'atıklayın.

   3. Her Öğe İçin numaralandırıcısını kullanırsanız, Dizin listesindeki dizin değerini güncelleştirebilirsiniz.

      Not

      Dizin değeri, öğedeki hangi sütunun değişkenle eşlendiği gösterir. Yalnızca Her Öğe İçin numaralandırıcısı 0 dışında bir dizin değeri kullanabilir.

8. İsteğe bağlı olarak, İfadeler'ne tıklayın ve İfadeler sayfasında Foreach Döngüsü kapsayıcısının özellikleri için özellik ifadeleri oluşturun. Daha fazla bilgi için bkz. Özellik İfadesi Ekleme veya Değiştirme.

9. Tamamtıklayın.

Genel Sayfa - Foreach Döngü Düzenleyicisi

Foreach Döngü Düzenleyicisi iletişim kutusunun Genel sayfasını kullanarak bir koleksiyondaki her üye için bir iş akışını yinelemek için belirtilen bir numaralandırıcıyı kullanan foreach Döngüsü kapsayıcısını adlandırın ve tanımlayın.

Seçenekler

Adı
Foreach Döngüsü kapsayıcısı için benzersiz bir ad sağlayın. Bu ad, görev simgesinde ve günlüklerde etiket olarak kullanılır.

Not

Nesne adları bir paket içinde benzersiz olmalıdır.

Açıklama
Foreach Döngüsü kapsayıcısının açıklamasını yazın.

Koleksiyon Sayfası - Foreach Döngü Düzenleyicisi

Numaralandırıcı türünü belirtmek ve numaralandırıcıyı yapılandırmak için Foreach Döngü Düzenleyicisi iletişim kutusunun Koleksiyonu sayfasını kullanın.

Foreach Döngüsü kapsayıcısı ve nasıl yapılandıracağınızı öğrenmek için bkz. Foreach Döngü Kapsayıcısı ve Bir Foreach Döngüsü Kapsayıcısını Yapılandırma.

Statik Seçenekler

Numaralandırıcı
Listeden numaralandırıcı türünü seçin. Bu özellik aşağıdaki tabloda listelenen seçeneklere sahiptir:

Değer	Açıklama
Foreach Dosya Numaralandırıcısı	Dosyaları numaralandır. Bu değerin seçilmesi, Foreach Dosya Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach Öğe Numaralandırıcısı	Bir öğedeki değerleri numaralandır. Bu değerin seçilmesi, Foreach Öğe Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach ADO Numaralandırıcısı	Tablolardaki tabloları veya satırları numaralandır. Bu değerin seçilmesi, Foreach ADO Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach ADO.NET Şema Kümesi Satır Numaralandırıcısı	Şemayı numaralandır. Bu değerin seçilmesi, Foreach ADO.NET Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Değişken Numaralandırıcısından Foreach	Değişkendeki değeri numaralandırın. Bu değerin seçilmesi, Değişken Numaralandırıcısından Foreachbölümündeki dinamik seçenekleri görüntüler.
Foreach Nodelist Numaralandırıcısı	XML belgesindeki düğümleri numaralandır. Bu değerin seçilmesi, Foreach Nodelist Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach SMO Numaralandırıcısı	SMO nesnesini numaralandır. Bu değerin seçilmesi, Foreach SMO Numaralandırıcıbölümündeki dinamik seçenekleri görüntüler.
Foreach HDFS Dosya Sıralayıcısı	Belirtilen HDFS konumunda HDFS dosyalarını numaralandırın. Bu değerin seçilmesi, Foreach HDFS Dosya Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach Azure Blob Numaralandırıcısı	Belirtilen blob konumunda blob dosyalarını numaralandırın. Bu değerin seçilmesi, Foreach Azure Blob Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
Foreach ADLS Dosya Numaralandırıcısı	Belirtilen Data Lake Store dizinindeki dosyaları numaralandırın. Bu değerin seçilmesi, Foreach ADLS Dosya Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.
foreach Data Lake Storage 2. Nesil Dosya Numaralandırıcısı	Belirtilen Data Lake Storage 2. Nesil dizinindeki dosyaları numaralandırın. Bu değerin seçilmesi, Foreach Data Lake Storage 2. Nesil Dosya Numaralandırıcısıbölümündeki dinamik seçenekleri görüntüler.

İfadeler
Var olan özellik ifadelerinin listesini görüntülemek için İfadeler tıklayın veya genişletin. (...) üç nokta düğmesine tıklayarak numaralandırıcı özelliği için özellik ifadesi ekleyin veya var olan bir özellik ifadesini düzenleyin ve değerlendirin.

İlgili Konular:Integration Services (SSIS) İfadeleri, Özellik İfadeleri Düzenleyicisi, İfade Oluşturucusu

Numaralandırıcı Dinamik Seçenekleri

Numaralandırıcı = Foreach Dosya Numaralandırıcısı

Foreach Dosya numaralandırıcısını kullanarak bir klasördeki dosyaları numaralandırırsınız. Örneğin, Foreach Döngüsü bir SQL Yürütme görevi içeriyorsa, Foreach Dosyası numaralandırıcısını kullanarak SQL Yürütme görevinin çalıştırabileceği SQL deyimlerini içeren dosyaları numaralandırabilirsiniz. Numaralandırıcı, alt klasörleri içerecek şekilde yapılandırılabilir.

Foreach Dosya numaralandırıcısının listelediği klasörlerin ve alt klasörlerin içeriği döngü yürütülürken değişebilir çünkü döngüdeki dış işlemler veya görevler döngü yürütülürken dosyaları ekler, yeniden adlandırır veya siler. Bu değişiklikler birkaç beklenmeyen duruma neden olabilir:

• Dosyalar silinirse, Foreach Döngüsündeki bir görevin eylemleri, sonraki görevler tarafından kullanılan dosyalardan farklı bir dosya kümesini etkileyebilir.

• Dosyalar yeniden adlandırılırsa ve dış işlem yeniden adlandırılan dosyaların yerini alacak dosyaları otomatik olarak eklerse, Foreach Döngüsündeki görevlerin eylemleri aynı dosyaları iki kez etkileyebilir.

• Dosyalar eklenirse Foreach Döngüsünün hangi dosyalar için etkilendiğini belirlemek zor olabilir.

Klasör
Numaralandırmak için kök klasörün yolunu belirtin.

Gözat
Kök klasörü bulmak için gözatın.

Dosyaları
Numaralandırılacak dosyaları belirtin.

Not

Koleksiyona eklenecek dosyaları belirtmek için joker karakterleri (*) kullanın. Örneğin, "abc" içeren adlara sahip dosyaları eklemek için şu filtreyi kullanın: *abc*.

Bir dosya adı uzantısı belirttiğinizde, numaralandırıcı ek karakterlerin eklendiği aynı uzantıya sahip dosyaları da döndürür. (Bu, geriye dönük uyumluluk için 8,3 dosya adlarını da karşılaştıran işletim sistemindeki dir komutuyla aynı davranıştır.) Numaralandırıcının bu davranışı beklenmeyen sonuçlara neden olabilir. Örneğin, yalnızca Excel 2003 dosyalarını listelemek istiyorsanız ve "*.xls" belirtmişseniz. Ancak, bu dosyalar ".xlsx" uzantısına sahip olduğundan, numaralandırıcı Excel 2007 dosyalarını da döndürür.

Koleksiyon sayfasında, İfadeler bölümünü genişleterek, FileSpec özelliğini seçip ardından üç nokta düğmesine (...) tıklayarak ifadeyi ekleyerek koleksiyona eklenecek dosyaları belirtmek için bir ifade kullanabilirsiniz.

Tam nitelikli
Dosya adlarının tam nitelikli yolunu almak için seçin. Dosyalar seçeneğinde joker karakterler belirtilirse, döndürülen tam yollar filtreyle eşleşir.

Sadece İsmi
Yalnızca dosya adlarını almak için seçin. Dosyalar seçeneğinde joker karakterler belirtilirse, döndürülen dosya adları filtreyle eşleşirse.

Ad ve uzantı
Dosya adlarını ve dosya adı uzantılarını almak için seçeneği seçin. Dosyalar seçeneğinde joker karakterler belirtilirse, döndürülen dosyaların adı ve uzantısı filtreyle eşleşebilir.

Alt Klasörleri Dolaş
Numaralandırmaya alt klasörleri dahil etmek için seçin.

Numaralandırıcı = Foreach Öğe Numaralandırıcısı

Bir koleksiyondaki öğeleri numaralandırmak için Foreach Öğesi numaralandırıcısını kullanırsınız. Sütun ve sütun değerlerini belirterek koleksiyondaki öğeleri tanımlarsınız. Satırdaki sütunlar bir öğe tanımlar. Örneğin, bir İşlemi Yürüt görevinin çalıştırdığı yürütülebilir dosyaları ve görevin kullandığı çalışma dizinini belirten bir öğenin biri yürütülebilir dosya adlarını, diğeri de çalışma dizinini listeleyen iki sütunu vardır. Satır sayısı, döngünün kaç kez yineleneceğini belirler. Tabloda 10 satır varsa döngü 10 kez yineler.

İşlemi Yürüt görevinin özelliklerini güncelleştirmek için, sütunun dizinini kullanarak değişkenleri öğe sütunlarıyla eşlersiniz. Numaralandırıcı öğesinde tanımlanan ilk sütunda 0 dizin değeri, ikinci sütun 1 vb. bulunur. Değişken değerleri, döngünün her yinelemesiyle güncelleştirilir. İşlem Yürütme Görevi'nin Yürütülebilir ve WorkingDirectory özellikleri, bu değişkenleri kullanan özellik ifadeleri ile güncellenebilir.

Her Bir Öge koleksiyonundaki öğeleri tanımlayın
Tablodaki her sütun için bir değer sağlayın.

Not

Satır sütunlarına değer girdikten sonra tabloya otomatik olarak yeni bir satır eklenir.

Not

Sağlanan değerler sütun veri türüyle uyumlu değilse, metin kırmızı renklidir.

Sütun veri türü
Etkin sütunun veri türünü listeler.

Kaldır
Öğeyi seçin ve ardından listeden kaldırmak için kaldır'a tıklayın.

Sütunları
Öğedeki sütunların veri türünü yapılandırmak için tıklatın.

İlgili Konular: Her öğe için sütunlar iletişim kutusu kullanıcı arabirimi referansı

Numaralandırıcı = Foreach ADO Numaralandırıcısı

Bir değişkende depolanan ADO veya ADO.NET nesnesindeki satırları veya tabloları numaralandırmak için Foreach ADO numaralandırıcısını kullanırsınız. Örneğin, Foreach Döngüsü bir değişkene veri kümesi yazan bir Betik görevi içeriyorsa, foreach ADO numaralandırıcısını kullanarak veri kümesindeki satırları numaralandırabilirsiniz. Değişken bir ADO.NET veri kümesi içeriyorsa, numaralandırıcı birden çok tablodaki satırları numaralandıracak veya tabloları numaralandıracak şekilde yapılandırılabilir.

ADO nesne kaynağı değişken
Listeden kullanıcı tanımlı bir değişken seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

Not

Değişken Nesne veri türüne sahip olmalıdır, aksi takdirde bir hata oluşur.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle

İlk tablodaki satırlar
İlk tablodaki yalnızca satırları listelemek için seçin.

Tüm tablolardaki satırları (yalnızca veri kümesi ADO.NET)
Tüm tablolardaki satırları numaralandırmak için seçin. Bu seçenek yalnızca numaralandıracak nesnelerin tümü aynı ADO.NET veri kümesinin üyesiyse kullanılabilir.

Tüm tablolar (yalnızca ADO.NET veri kümesi)
Yalnızca tabloları listelemek için seçin.

Numaralandırıcı = Foreach ADO.NET Şema Satır Kümesi Numaralandırıcısı

Foreach ADO.NET Schema Rowset numaralandırıcısını kullanarak belirtilen veri kaynağı için bir şema numaralandırırsınız. Örneğin, Foreach Döngüsü bir SQL Yürüt görevi içeriyorsa, AdventureWorks veritabanındaki sütunlar gibi şemaları listelemek için Foreach ADO.NET Schema Rowset numaralandırıcısını ve şema izinlerini almak için SQL'i Yürüt görevini kullanabilirsiniz.

Bağlantı
Listeden bir ADO.NET bağlantı yöneticisi seçin veya yeni bir ADO.NET bağlantı yöneticisi oluşturmak için Yeni bağlantı... tıklayın.

Önemli

ADO.NET bağlantı yöneticisi OLE DB için bir .NET sağlayıcısı kullanmalıdır. SQL Server'a bağlanılıyorsa, kullanılması önerilen sağlayıcı, Bağlantı Yöneticisi iletişim kutusunun OleDb için .Net Sağlayıcıları bölümünde listelenen SQL Server Yerel İstemcisi'dir.

İlgili Konular:ADO Bağlantı YöneticisiADO.NET Bağlantı Yöneticisi' Yapılandırma

Şema
Numaralandıracak şemayı seçin.

kısıtlamaları ayarlama
İlgili Konular: Şema Kısıtlamaları iletişim kutusu; ADO.NET bağlantı yöneticisini yapılandırma; ve Integration Services (SSIS) değişkenleriyle ve Değişken Ekle iletişim kutusuyla çalışma.

Numaralandırıcı = Değişken Numaralandırıcısından Foreach

Belirtilen değişkende numaralandırılabilir nesneleri numaralandırmak için Foreach From Değişken numaralandırıcısını kullanırsınız. Örneğin, Foreach Döngüsü sorguyu çalıştıran ve sonucu bir değişkende depolayan bir EXECUTE SQL görevi içeriyorsa, sorgu sonuçlarını listelemek için Foreach From Variable numaralandırıcısını kullanabilirsiniz.

değişken
Listeden bir değişken seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle

Numaralandırıcı = Foreach NodeList Numaralandırıcısı

Bir XML dosyasına XPath ifadesi uygulanmasından kaynaklanan XML düğümleri kümesini listelemek için Foreach Nodelist numaralandırıcısını kullanırsınız. Örneğin, Foreach Döngüsü bir Betik görevi içeriyorsa, Xml dosyasından Betik görevine XPath ifade ölçütlerini karşılayan bir değer geçirmek için Foreach NodeList numaralandırıcısını kullanabilirsiniz.

XML dosyasına uygulanan XPath ifadesi, OuterXPathString özelliğinde depolanan dış XPath işlemidir. XPath numaralandırma türü ElementCollectionolarak ayarlanırsa, Foreach NodeList numaralandırıcısı bir öğe koleksiyonuna InnerXPathString özelliğinde depolanan bir iç XPath ifadesi uygulayabilir.

XML belgeleri ve verileriyle çalışma hakkında daha fazla bilgi edinmek için MSDN Kitaplığı'ndaki ".NET Framework'nde XML Kullanma " bölümüne bakın.

BelgeKaynakTürü
XML belgesinin kaynak türünü seçin. Bu özellik aşağıdaki tabloda listelenen seçeneklere sahiptir:

Değer	Açıklama
Doğrudan giriş	Kaynağı bir XML belgesi olarak ayarlayın.
dosya bağlantısı	XML belgesini içeren bir dosya seçin.
değişken	Kaynağı XML belgesini içeren bir değişken olarak ayarlayın.

Belge Kaynağı
DocumentSourceType, Direct inputolarak ayarlandıysa, XML kodunu sağlayın veya XML sağlamak için Belge Kaynağı Düzenleyicisi iletişim kutusunu kullanarak üç nokta (…) düğmesine tıklayın.

DocumentSourceTypeDosya bağlantısıolarak ayarlandıysa, bir Dosya bağlantısı yöneticisi seçin veya yeni bir bağlantı yöneticisi oluşturmak için <Yeni bağlantı...> tıklayın.

İlgili Konular:Dosya Bağlantı YöneticisiDosya Bağlantı Yöneticisi Düzenleyicisi

DocumentSourceType Değişkenolarak ayarlandıysa, var olan bir değişkeni seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle.

NumaralandırmaTürü
Listeden bir numaralandırma türü seçin. Bu özellik aşağıdaki tabloda listelenen seçeneklere sahiptir:

Değer	Açıklama
Navigatör	XPathNavigator kullanarak numaralandırın.
Düğümü	XPath işlemi tarafından döndürülen düğümleri numaralandır.
NodeText	XPath işlemi tarafından döndürülen metin düğümlerini numaralandır.
ElementCollection	XPath işlemi tarafından döndürülen öğe düğümlerini numaralandırır.

OuterXPathStringSourceType
XPath dizesinin kaynak türünü seçin. Bu özellik aşağıdaki tabloda listelenen seçeneklere sahiptir:

Değer	Açıklama
Doğrudan giriş	Kaynağı bir XML belgesi olarak ayarlayın.
dosya bağlantısı	XML belgesini içeren bir dosya seçin.
değişken	Kaynağı XML belgesini içeren bir değişken olarak ayarlayın.

OuterXPathString
OuterXPathStringSourceTypeDoğrudan girişolarak ayarlandığında, XPath dizesini girin.

OuterXPathStringSourceTypeDosya bağlantısıolarak ayarlandıysa, bir Dosya bağlantısı yöneticisi seçin veya Yeni bağlantı <...>'e tıklayarak yeni bir bağlantı yöneticisi oluşturun.

İlgili Konular:Dosya Bağlantı YöneticisiDosya Bağlantı Yöneticisi Düzenleyicisi

OuterXPathStringSourceType Değişkenolarak ayarlandıysa, var olan bir değişkeni seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle.

İçElemanTürü
EnumerationTypeElementCollectionolarak ayarlandıysa, listedeki iç öğe türünü seçin.

InnerXPathStringSourceType
İç XPath dizesinin kaynak türünü seçin. Bu özellik aşağıdaki tabloda listelenen seçeneklere sahiptir:

Değer	Açıklama
Doğrudan giriş	Kaynağı bir XML belgesi olarak ayarlayın.
dosya bağlantısı	XML belgesini içeren bir dosya seçin.
değişken	Kaynağı XML belgesini içeren bir değişken olarak ayarlayın.

InnerXPathString
Eğer InnerXPathStringSourceTypeDoğrudan Girişolarak ayarlandıysa, XPath dizesini sağlayın.

InnerXPathStringSourceType Dosya bağlantısıolarak ayarlandıysa, bir Dosya bağlantısı yöneticisi seçin veya Yeni bağlantı... 'e tıklayarak yeni bir bağlantı yöneticisi oluşturun.

İlgili Konular:Dosya Bağlantı YöneticisiDosya Bağlantı Yöneticisi Düzenleyicisi

InnerXPathStringSourceTypedeğişkenolarak ayarlandıysa, var olan bir değişkeni seçin veya yeni bir değişken oluşturmak için<Yeni değişken...> tıklayın.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle.

Numaralandırıcı = Foreach SMO Numaralandırıcısı

SQL Server Yönetim Nesnesi (SMO) nesnelerini listelemek için Foreach SMO numaralandırıcısını kullanırsınız. Örneğin, Foreach Döngüsü bir SQL Yürüt görevi içeriyorsa, Foreach SMO numaralandırıcısını kullanarak AdventureWorks veritabanındaki tabloları numaralandırabilir ve her tablodaki satır sayısını sayan sorgular çalıştırabilirsiniz.

Bağlantı
Mevcut bir ADO.NET bağlantı yöneticisi seçin veya yeni bir bağlantı yöneticisi oluşturmak için Yeni bağlantı... tıklayın.

İlgili Konular: ADO.NET Bağlantı Yöneticisi, ADO.NET Bağlantı Yöneticisi Yapılandırma

Numaralandırma
Numaralandırılacak SMO nesnesini belirtin.

Gözat
SMO numaralandırmasını seçin.

İlgili Konular: SMO Numaralandırma Seçim İletişim Kutusu

Numaralandırıcı = Foreach HDFS Dosya Numaralandırıcısı

Foreach HDFS Dosya Numaralandırıcısı, bir SSIS paketinin belirtilen HDFS konumundaKI HDFS dosyalarını listelemesini sağlar. Her HDFS dosyasının adı bir değişkende depolanabilir ve Foreach Döngü Kapsayıcısı içindeki görevlerde kullanılabilir.

Hadoop Bağlantı Yöneticisi
Mevcut bir Hadoop Bağlantı Yöneticisi belirtin veya HDFS dosyalarının barındırıldığı yeri gösteren yeni bir tane oluşturun. Daha fazla bilgi için bkz. hadoop Bağlantı Yöneticisi.

dizin yolu
Numaralandırılacak HDFS dosyalarını içeren HDFS dizininin adını belirtin.

Dosya adı filtresi
Belirli bir ad desenine sahip dosyaları seçmek için bir ad filtresi belirtin. Örneğin, MySheet*.xls* MySheet001.xls ve MySheetABC.xlsxgibi dosyaları içerir.

Dosya adını alma
SSIS tarafından alınan dosya adı türünü belirtin.

• Tam niteleyici ad, dizin yolunu ve dosya adını içeren tam ad anlamına gelir.

• Yalnızca ad , dosya adının yol olmadan alınması anlamına gelir.

Alt klasörleri incele
Alt klasörlerde yinelemeli olarak döngü yapılıp yapılmayacağını belirtin.

Düzenleyicinin Değişken Eşlemeleri sayfasında, numaralandırılmış HDFS dosyasının adını depolamak için bir değişken seçin veya oluşturun.

Numaralandırıcı = Foreach Azure Blob Numaralandırıcısı

Azure Blob Numaralandırıcısı bir SSIS paketinin belirtilen blob konumunda blob dosyalarını listelemesini sağlar. Numaralandırılmış blob dosyasının adını bir değişkende depolayabilir ve Foreach Döngü Kapsayıcısı içindeki görevlerde kullanabilirsiniz.

Azure Blob Numaralandırıcısı, SQL Server 2016 (13.x) için Azure için SQL Server Integration Services (SSIS) Özellik Paketi'nin bir bileşenidir. Özellik Paketi'ni indirin.

Azure depolama bağlantı yöneticisi
Mevcut bir Azure Depolama Bağlantı Yöneticisi'ni seçin veya Azure Depolama Hesabına başvuran yeni bir tane oluşturun.

İlgili Konular: Azure Depolama Bağlantı Yöneticisi.

Blob kapsayıcı adı
Numaralandırılacak blob dosyalarını içeren blob kapsayıcısının adını belirtin.

Blob dizini
Numaralandırılacak blob dosyalarını içeren blob dizinini belirtin. Blob dizini sanal hiyerarşik bir yapıdır.

Özyinelemeli olarak ara
Alt dizinler içinde özyinelemeli arama yapılıp yapılmayacağını belirtin.

blob adı filtresi
Belirli bir ad desenine sahip dosyaları listelemek için bir ad filtresi belirtin. Örneğin, MySheet*.xls\* MySheet001.xls ve MySheetABC.xlsxgibi dosyaları içerir.

Blob zaman aralığı -dan/-a filtresi
Bir zaman aralığı filtresi belirtin. TimeRangeFrom'den sonra ve TimeRangeTo'den önce değiştirilen dosyalar numaralandırılır.

Numaralandırıcı = Foreach ADLS Dosya Numaralandırıcısı

ADLS Dosya Numaralandırıcısı, SSIS paketinin Azure Data Lake Store'da dosyaları listelemesini sağlar. Numaralandırılmış dosyanın tam yolunu (eğik çizgi ile başlayan - /) bir değişkende depolayabilir ve dosya yolunu Foreach Döngü Kapsayıcısı içindeki görevlerde kullanabilirsiniz.

AzureDataLakeConnection
Azure Data Lake bağlantı yöneticisini belirtir veya bir Azure Data Lake Storage (ADLS) hesabına atıfta bulunan yeni bir bağlantı oluşturur.

AzureDataLakeDirectory
Numaralandırılacak dosyaları içeren ADLS dizinini belirtir.

Dosya Adı Deseni
Bir dosya adı filtresi belirtir. Yalnızca adları belirtilen desenle eşleşen dosyalar numaralandırılır. Joker karakterler * ve ? desteklenir.

ÖzyinelemeliAra
Belirtilen dizinde özyinelemeli olarak arama yapılıp yapılmayacağını belirtir.

Numaralandırıcı = Foreach Data Lake Storage 2. Nesil Dosya Numaralandırıcısı

foreach Data Lake Storage 2. Nesil Dosya Numaralandırıcısı , SSIS paketinin Azure Data Lake Storage 2. Nesil'de dosyaları listelemesini sağlar.

AzureStorageConnection
Mevcut bir Azure Depolama Bağlantı Yöneticisi'ni belirtir veya Data Lake Storage 2. Nesil hizmetine başvuran yeni bir bağlantı oluşturur.

KlasörDizini
dosyaları numaralandıracak klasörün yolunu belirtir.

ÖzyinelemeliAra
Belirtilen klasör içinde özyinelemeli olarak arama yapılıp yapılmayacağını belirtir.

Hizmet Sorumlusu İzin Yapılandırması Üzerine Notlar

Data Lake Storage 2. Nesil izni hem RBAC hem de ACL'leritarafından belirlenir. ACL'lerin uygulama kaydı için hizmet sorumlusunun Nesne Kimliği (OID) kullanılarak yapılandırıldığına dikkat edin. Bkz. Hizmet sorumlusu için ACL'leri nasıl doğru ayarlayabilirim? Bu, RBAC yapılandırmasıyla kullanılan Uygulama (istemci) kimliğinden farklıdır. Bir güvenlik sorumlusuna yerleşik bir rol veya özel bir rol aracılığıyla RBAC veri izinleri verildiğinde, bu izinler bir isteğin yetkilendirmesi üzerine önce değerlendirilir. İstenen işlem güvenlik sorumlusunun RBAC atamaları tarafından yetkilendirilmişse yetkilendirme hemen çözümlenir ve ek ACL denetimi yapılmaz. Alternatif olarak, güvenlik sorumlusunun RBAC ataması yoksa veya isteğin işlemi atanan izinle eşleşmiyorsa, güvenlik sorumlusunun istenen işlemi gerçekleştirme yetkisi olup olmadığını belirlemek için ACL denetimleri gerçekleştirilir. Numaralandırıcının çalışması için, kök dosya sisteminden başlayarak en az Yürütme izni ve hedef klasör için Okuma izni verin. Alternatif olarak, RBAC ile en azından Depolama Blobu Veri Okuyucusu rolünü verin. Ayrıntılar için bu makalesine bakın.

Değişken Eşleştirmeleri Sayfası - Foreach Döngü Düzenleyicisi

Değişkenleri koleksiyon değerine eşlemek için Foreach Döngü Düzenleyicisi iletişim kutusunun Değişken Eşlemeleri sayfasını kullanın. değişkeninin değeri, döngünün her yinelemesinde koleksiyon değerleriyle güncelleştirilir.

Basit ETL Paketi Oluşturma Öğreticisi adlı Microsoft SQL Server Integration Services öğreticisi, Foreach Döngüsü eklemenizi ve yapılandırmanızı öğreten bir ders içerir.

Seçenekler

değişken
Var olan bir değişkeni seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

Not

Bir değişkeni eşledikten sonra, Değişkeni listesine otomatik olarak yeni bir satır eklenir.

İlgili Konular: Integration Services (SSIS) DeğişkenleriDeğişken Ekle

Dizini
Foreach Öğesi numaralandırıcısını kullanıyorsanız, değişkenle eşlenmek üzere koleksiyon değerindeki sütunun dizinini belirtin. Diğer numaralandırıcı türleri için indeks salt okunur.

Not

Dizin 0 tabanlıdır.

Sil
Bir değişken seçin ve Silöğesine tıklayın.

Şema Kısıtlamaları iletişim kutusu (ADO.NET)

Şema kısıtlamalarını Foreach ADO.NET Şema Satır Kümesi numaralandırıcısına uygulanacak şekilde ayarlamak için Şema Kısıtlamaları iletişim kutusunu kullanın.

Seçenekler

Kısıtlamalar
Şemaya uygulanacak kısıtlamaları seçin.

değişken
Kısıtlamaları tanımlamak için bir değişken kullanın. Listeden bir değişken seçin veya yeni bir değişken oluşturmak için Yeni değişken... tıklayın.

İlgili Konular:Integration Services (SSIS) Değişkenleri, Değişken Ekle

Metin
Kısıtlamaları tanımlamak için metni sağlayın.

Her Öğe Sütunu için iletişim kutusu

Foreach Öğe numaralandırıcısının numaralandırmış olduğu öğelerdeki sütunları tanımlamak için Her Öğe Sütunu için iletişim kutusunu kullanın.

Seçenekler

Sütun
Sütunları listeler.

Veri Türü
Veri türünü seçin.

Ekle
Yeni bir sütun ekleyin.

Kaldır
Bir sütun seçin ve Kaldır'a tıklayın.

SMO Numaralandırma Seç iletişim kutusu

Listelemek ve numaralandırma türünü seçmek için belirtilen SQL Server örneğinde SQL Server Yönetim Nesneleri (SMO) nesnesini belirtmek için SMO Numaralandırma Seç iletişim kutusunu kullanın.

Seçenekler

Numaralandırma
Sunucuyu genişletin ve SMO nesnesini seçin.

Nesneler
Nesneler numaralandırma türünü kullanın.

Önceden Doldurma
Nesneler numaralandırma türüyle Önceden Doldurma seçeneğini kullanın.

Adları
Adlar numaralandırma türünü kullanın.

URN'leri
URL'ler numaralandırma türünü kullanın.

Konumları
Konumlar numaralandırma türünü kullanın. Bu seçenek yalnızca dosyalar için kullanılabilir.

Foreach Döngüsü kapsayıcılarıyla özellik ifadelerini kullanma

Paketler birden çok yürütülebilir dosyayı eşzamanlı olarak çalıştıracak şekilde yapılandırılabilir. Paket, özellik ifadelerini uygulayan bir Foreach Döngüsü kapsayıcısı içerdiğinde bu yapılandırma dikkatli kullanılmalıdır.

Foreach Döngüsü numaralandırıcılarının kullandığı bağlantı yöneticilerinin ConnectionString özelliğinin değerini ayarlamak için bir özellik ifadesi uygulamak genellikle yararlıdır. ConnectionString'in özellik ifadesi, numaralandırıcının koleksiyon değeriyle eşlenen bir değişken tarafından ayarlanır ve döngünün her yinelemesinde güncelleştirilir.

Döngüdeki görevlerin paralel yürütülmesinin belirlenemeyen zamanlamasının olumsuz sonuçlarını önlemek için paket, aynı anda yalnızca bir yürütülebilir dosya çalıştıracak şekilde yapılandırılmalıdır. Örneğin, bir paket birden çok görevi eşzamanlı olarak çalıştırabiliyorsa, klasördeki dosyaları numaralandıran, dosya adlarını alan ve sonra dosya adlarını tabloya eklemek için sql yürütme görevini kullanan bir Foreach Döngüsü kapsayıcısı, SQL Yürütme görevinin iki örneği aynı anda yazmayı denediğinde yazma çakışmalarına neden olabilir. Daha fazla bilgi için bkz. Packages'da Özellik İfadelerini Kullanma.

Ayrıca Bkz.

Denetim Akışı
Integration Services Kapsayıcıları