Aracılığıyla paylaş

XML Kaynağı

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

XML kaynağı bir XML veri dosyasını okur ve kaynak çıktıdaki sütunları verilerle doldurur.

XML dosyalarındaki veriler genellikle hiyerarşik ilişkiler içerir. Örneğin, XML veri dosyası kataloglardaki katalogları ve öğeleri temsil edebilir. Verilerin veri akışına girebilmesi için önce XML veri dosyasındaki öğelerin ilişkisi belirlenmeli ve dosyadaki her öğe için bir çıkış oluşturulmalıdır.

Şemalar

XML kaynağı, XML verilerini yorumlamak için bir şema kullanır. XML kaynağı, XML verilerini tablo biçiminde çevirmek için XML Şema Tanımı (XSD) dosyasının veya satır içi şemaların kullanımını destekler. XML kaynağını XML Kaynak Düzenleyicisi iletişim kutusunu kullanarak yapılandırıyorsanız, kullanıcı arabirimi belirtilen XML veri dosyasından bir XSD oluşturabilir.

Not

DTD'ler desteklenmez.

Şemalar yalnızca tek bir ad alanını destekleyebilir; şema koleksiyonlarını desteklemez.

Not

XML kaynağı XML dosyasındaki verileri XSD'ye karşı doğrulamaz.

XML Kaynak Düzenleyicisi

XML dosyalarındaki veriler genellikle hiyerarşik ilişkiler içerir. XML Kaynak Düzenleyicisi iletişim kutusu, XML kaynak çıkışlarını oluşturmak için belirtilen şemayı kullanır. Bir XSD dosyası belirtebilir, satır içi şema kullanabilir veya belirtilen XML veri dosyasından bir XSD oluşturabilirsiniz. Şema tasarım zamanında kullanılabilir olmalıdır.

XML kaynağı, XML dosyalarındaki diğer öğeleri içeren her öğe için bir çıkış oluşturarak XML verilerinden tablosal yapılar oluşturur. Örneğin, XML verileri kataloglardaki katalogları ve öğeleri temsil ederse, XML kaynağı kataloglar için bir çıkış ve katalogların içerdiği her öğe türü için bir çıkış oluşturur. Her öğenin çıkışı, o öğenin öznitelikleri için çıkış sütunları içerir.

Çıkışlardaki verilerin hiyerarşik ilişkisi hakkında bilgi sağlamak için, XML kaynağı çıkışlara her alt öğe için üst öğeyi tanımlayan bir sütun ekler. Farklı öğe türlerine sahip kataloglar örneğini kullanarak, her öğenin ait olduğu kataloğu tanımlayan bir sütun değeri olacaktır.

XML kaynağı her öğe için bir çıkış oluşturur, ancak tüm çıkışları kullanmanız gerekmez. Kullanmak istemediğiniz herhangi bir çıkışı silebilir veya bir aşağı akış bileşenine bağlamayabilirsiniz.

XML kaynağı, adların belirsiz olduğundan emin olmak için çıkış adlarını da oluşturur. Bu adlar uzun olabilir ve çıkışları sizin için yararlı olacak şekilde tanımlamayabilir. Adları benzersiz kaldığı sürece çıkışları yeniden adlandırabilirsiniz. Veri türünü ve çıkış sütunlarının uzunluğunu da değiştirebilirsiniz.

Her çıkış için XML kaynağı bir hata çıkışı ekler. Varsayılan olarak hata çıktılarındaki sütunların uzunluğu 255 olan Unicode dize veri türü (DT_WSTR) vardır, ancak hata çıkışlarındaki sütunları, veri türünü ve uzunluğunu değiştirerek yapılandırabilirsiniz.

XML veri dosyası XSD'de olmayan öğeler içeriyorsa, bu öğeler yoksayılır ve bunlar için çıkış oluşturulmaz. Öte yandan, XML veri dosyasında XSD'de temsil edilen öğeler eksikse, çıkış null değerleri olan sütunlar içerir.

Veriler XML veri dosyasından ayıklandığında Integration Services veri türüne dönüştürülür. Ancak, kaynak bu veri türlerini desteklemediğinden XML kaynağı XML verilerini DT_TIME2 veya DT_DBTIMESTAMP2 veri türlerine dönüştüremez. Daha fazla bilgi için bkz. Integration Services Veri Türleri.

XSD veya satır içi şeması öğelerin veri türünü belirtebilir, ancak belirtmezse, XML Kaynak Düzenleyicisi iletişim kutusu, çıktıdaki öğeyi içeren sütuna Unicode dize veri türünü (DT_WSTR) atar ve sütun uzunluğunu 255 karakter olarak ayarlar.

Şema bir öğenin uzunluk üst sınırını belirtiyorsa çıkış sütununun uzunluğu bu değere ayarlanır. Maksimum uzunluk, öğesinin dönüştürüldüğü Integration Services veri türü tarafından desteklenen uzunluktan büyükse, veriler veri türünün uzunluk üst sınırına kadar kesilir. Örneğin, bir dizenin uzunluğu 5000 ise, DT_WSTR veri türünün uzunluk üst sınırı 4000 karakter olduğundan 4000 karaktere yuvarlanır; Benzer şekilde bayt verileri, DT_BYTES veri türünün maksimum uzunluğu olan 8000 karaktere kesilir. Şema en fazla uzunluk belirtmiyorsa, her iki veri türüne sahip sütunların varsayılan uzunluğu 255 olarak ayarlanır. XML kaynağındaki veri kesilmesi, diğer veri akışı bileşenlerindeki kesme işlemiyle aynı şekilde işlenir. Daha fazla bilgi için bkz. VeriHata İşleme.

Veri türünü ve sütun uzunluğunu değiştirebilirsiniz. Daha fazla bilgi için bkz. Integration Services Veri Türleri.

XML Kaynağının Yapılandırması

XML kaynağı üç farklı veri erişim modunu destekler. XML veri dosyasının dosya konumunu, dosya konumunu içeren değişkeni veya XML verilerini içeren değişkeni belirtebilirsiniz.

XML kaynağı, XMLData ve XMLSchemaDefinition paket yüklendiğinde özellik ifadeleri tarafından güncelleştirilebilecek özel özellikler içerir. Daha fazla bilgi için bkz. Integration Services (SSIS) İfadeleri, Paketlerde Özellik İfadelerini Kullanmave XML Kaynağı Özel Özellikleri.

XML kaynağı birden çok normal çıkışı ve birden çok hata çıkışını destekler.

SQL Server Integration Services, XML kaynağını yapılandırmaya yönelik XML Kaynak Düzenleyicisi iletişim kutusunu içerir. Bu iletişim kutusu SSIS Tasarımcısı'nda kullanılabilir.

SSIS Tasarımcısı aracılığıyla veya program aracılığıyla özellikleri ayarlayabilirsiniz.

Gelişmiş Düzenleyici iletişim kutusu, program aracılığıyla ayarlanabilen özellikleri yansıtır. Gelişmiş Düzenleyici iletişim kutusunda veya program aracılığıyla ayarlayabileceğiniz özellikler hakkında daha fazla bilgi için aşağıdaki konulardan birine tıklayın:

Özellikleri ayarlama hakkında daha fazla bilgi için aşağıdaki konulardan birine tıklayın:

XML Kaynak Düzenleyicisi (Bağlantı Yöneticisi Sayfası)

XML dosyasını ve XML verilerini dönüştüren XSD'yi belirtmek için XML Kaynak DüzenleyicisiBağlantı Yöneticisi sayfasını kullanın.

Statik Seçenekler

Veri erişim modu
Kaynaktan veri seçme yöntemini belirtin.

Değer Açıklama
XML dosyası konumu XML dosyasından veri alma.
Değişkenden XML dosyası Değişkende XML dosya adını belirtin.

İlgili bilgiler: Paketlerde Değişkenleri Kullanma
Değişkenin XML verisi Değişkenden XML verilerini alma.

Satır içi şema kullanma
XML kaynak verilerinin yapısını ve verilerini tanımlayan ve doğrulayan XSD şemasını içerip içermediğini belirtin.

XSD konumu
XSD şema dosyasının yolunu ve dosya adını yazın veya Gözat'a tıklayarak dosyayı bulun.

Gözat
XSD şema dosyasını bulmak için Aç iletişim kutusunu kullanın.

XSD Oluştur
Otomatik olarak oluşturulan XSD şema dosyası için bir konum seçmek için Farklı Kaydet iletişim kutusunu kullanın. Düzenleyici şemayı XML verilerinin yapısından çıkartır.

Veri Erişim Modu Dinamik Seçenekleri

Veri erişim modu = XML dosya konumu

XML konumu
XML veri dosyasının yolunu ve dosya adını yazın veya "Gözat"a tıklayarak dosyayı bulun.

Gözat
XML veri dosyasını bulmak için Aç iletişim kutusunu kullanın.

Veri erişim modu = değişkenden XML dosyası

Değişken adı
XML dosyasının yolunu ve dosya adını içeren değişkeni seçin.

Veri erişim modu = değişkenden gelen XML verisi

Değişken adı
XML verilerini içeren değişkeni seçin.

XML Kaynak Düzenleyicisi (Sütunlar Sayfası)

Çıktı sütununu bir dış (kaynak) sütuna eşlemek için XML Kaynak Düzenleyicisi iletişim kutusunun Sütunlar düğümünü kullanın.

Seçenekler

Kullanılabilir Dış Sütunlar
Veri kaynağındaki kullanılabilir dış sütunların listesini görüntüleyin. Sütunları eklemek veya silmek için bu tabloyu kullanamazsınız.

Dış Sütun
Dış (kaynak) sütunları görevin okuyacağı sırayla görüntüleyin. Önce düzenleyicide görüntülenen tablodaki seçili sütunları temizleyip ardından listeden dış sütunları farklı bir sırada seçerek bu sırayı değiştirebilirsiniz.

Çıkış Sütunu
Her çıkış sütunu için benzersiz bir ad sağlayın. Varsayılan değer, seçili dış (kaynak) sütunun adıdır; ancak, herhangi bir benzersiz, açıklayıcı ad seçebilirsiniz. Sağlanan ad SSIS Tasarımcısı'nda görüntülenir.

XML Kaynak Düzenleyicisi (Hata Çıktı Sayfası)

Hata işleme seçeneklerini belirlemek ve hata çıktısı sütunlarında özellikleri ayarlamak için XML Kaynak Düzenleyicisi iletişim kutusunun Hata Çıktısı sayfasını kullanın.

Seçenekler

Giriş/Çıkış
Veri kaynağının adını görüntüleyin.

Sütun
XML Kaynak Düzenleyicisi iletişim kutusunun Bağlantı Yöneticisi sayfasında seçtiğiniz dış (kaynak) sütunları görüntüleyin.

Hatası
Bir hata oluştuğunda ne olacağını belirtin: hatayı yoksayın, satırı yeniden yönlendirin veya bileşenin başarısız olmasına izin verin.

İlgili Konular:Veri Hata İşleme

Kesme
Kesme meydana geldiğinde ne yapılacağını belirtin: hatayı dikkate almayın, satırı yeniden yönlendirin veya bileşenin başarısız olmasına izin verin.

Açıklama
Hatanın açıklamasını görüntüleyin.

Bu değeri seçili hücrelere ayarla
Bir hata veya kesme oluştuğunda tüm seçili hücrelere ne olacağını belirtin: hatayı yok sayın, satırı yeniden yönlendirin veya bileşenin başarısız olmasını sağlayın.

Uygula
Seçili hücrelere hata işleme seçeneğini uygulayın.

XML Kaynağını Kullanarak Veri Ayıklama

  • Last updated on