Aracılığıyla paylaş


ADO NET Kaynağı

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Entegrasyon Çalışma Zamanı

ADO NET kaynağı bir .NET sağlayıcısından veri tüketir ve verileri veri akışı için kullanılabilir hale getirir.

Microsoft Azure SQL Veritabanı'na bağlanmak için ADO NET kaynağını kullanabilirsiniz. OLE DB kullanarak SQL Veritabanı'na bağlanma desteklenmez. SQL Veritabanı hakkında daha fazla bilgi için bkz. Genel Yönergeler ve Sınırlamalar (Azure SQL Veritabanı).

Veri Türü Desteği

Kaynak, belirli bir Integration Services veri türüyle eşleşmeyen tüm veri türlerini DT_NTEXT Integration Services veri türüne dönüştürür. Bu dönüştürme, veri türü System.Object olsa bile gerçekleşir.

DT_NTEXT veri türünü DT_WSTR veri türüne veya DT_WSTR veri türünü DT_NTEXT veri türüne değiştirebilirsiniz. ADO NET kaynağının Gelişmiş Düzenleyici iletişim kutusunda DataType özelliğini ayarlayarak veri türlerini değiştirirsiniz. Daha fazla bilgi için bkz. Ortak Özellikler.

DT_NTEXT veri türü, ADO NET kaynağından sonra veri dönüştürme kullanılarak DT_BYTES veya DT_STR veri türüne de dönüştürülebilir. Daha fazla bilgi için bkz. Veri Dönüştürme Dönüşümü.

Integration Services'da tarih veri türleri, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 ve DT_DBTIMESTAMPOFFSET, SQL Server'daki belirli tarih veri türleriyle eşler. SQL Server'ın kullandığı tarih veri türlerini Integration Services tarafından kullanılanlara dönüştürmek için ADO NET kaynağını yapılandırabilirsiniz. ADO NET kaynağını bu tarih veri türlerini dönüştürecek şekilde yapılandırmak için, ADO.NET bağlantı yöneticisinin Tür Sistemi Sürümü özelliğini En Son olarak ayarlayın. (Tür Sistemi Sürümü özelliği, Bağlantı Yöneticisi iletişim kutusunun Tümü sayfasındadır. Bağlantı Yöneticisi iletişim kutusunu açmak için, ADO.NET bağlantı yöneticisine sağ tıklayın ve ardından Düzenle'ye tıklayın.)

Uyarı

ADO.NET bağlantı yöneticisinin Tür Sistemi Sürümü özelliği SQL Server 2005 olarak ayarlandıysa, sistem SQL Server tarih veri türlerini DT_WSTR dönüştürür.

ADO.NET bağlantı yöneticisi sağlayıcıyı SQL Server (SqlClient) için .NET Veri Sağlayıcısı olarak belirttiğinde sistem, kullanıcı tanımlı veri türlerini (UDF) Integration Services ikili büyük nesnelerine (BLOB) dönüştürür. Sistem, UDT veri türünü dönüştürdüğünde aşağıdaki kuralları uygular:

  • Veriler büyük olmayan bir UDT ise sistem verileri DT_BYTES dönüştürür.

  • Veriler büyük olmayan bir UDT ise ve veritabanındaki sütunun Length özelliği -1 veya 8.000 bayttan büyük bir değere ayarlanırsa, sistem verileri DT_IMAGE dönüştürür.

  • Veriler büyük bir UDT ise sistem verileri DT_IMAGE dönüştürür.

    Uyarı

    ADO NET kaynağı hata çıkışını kullanacak şekilde yapılandırılmamışsa, sistem verileri 8.000 baytlık öbekler halinde DT_IMAGE sütununa akışla aktarır. ADO NET kaynağı hata çıkışını kullanacak şekilde yapılandırılmışsa, sistem bayt dizisinin tamamını DT_IMAGE sütununa geçirir. Bileşenleri hata çıktısını kullanacak şekilde yapılandırma hakkında daha fazla bilgi için bkz. Verilerde Hata İşleme.

Integration Services veri türleri, desteklenen veri türü dönüştürmeleri ve SQL Server dahil olmak üzere belirli veritabanları arasında veri türü eşlemesi hakkında daha fazla bilgi için bkz. Integration Services Veri Türleri.

Integration Services veri türlerini yönetilen veri türleriyle eşleme hakkında bilgi için bkz. Veri Akışında Veri Türleriyle Çalışma.

ADO NET Kaynağı Sorunlarını Giderme

ADO NET kaynağının dış veri sağlayıcılarına yaptığı çağrıları günlüğe kaydedebilirsiniz. ADO NET kaynağının gerçekleştirdiği dış veri kaynaklarından veri yükleme sorunlarını gidermek için bu günlük özelliğini kullanabilirsiniz. ADO NET kaynağının dış veri sağlayıcılarına yaptığı çağrıları günlüğe kaydetmek için paket günlüğünü etkinleştirin ve paket düzeyinde Tanılama olayını seçin. Daha fazla bilgi için bkz. Paket Yürütme için Sorun Giderme Araçları.

ADO NET Kaynak Yapılandırması

Sonuç kümesini tanımlayan SQL deyimini sağlayarak ADO NET kaynağını yapılandırabilirsiniz. Örneğin, veritabanına bağlanan AdventureWorks2025 ve SQL deyimini SELECT * FROM Production.Product kullanan bir ADO NET kaynağı , Production.Product tablosundaki tüm satırları ayıklar ve veri kümesini aşağı akış bileşenine sağlar.

Uyarı

Geçici bir tablodan sonuç döndüren saklı yordamı çağırmak için SQL deyimi kullandığınızda, sonuç kümesi için meta verileri tanımlamak için WITH RESULT SETS seçeneğini kullanın.

Uyarı

Saklı yordamı yürütmek için SQL deyimi kullanırsanız ve paket aşağıdaki hatayla başarısız olursa, exec deyiminden önce SET FMTONLY OFF deyimini ekleyerek hatayı çözebilirsiniz.

Sütun <column_name> veri kaynağında mevcut değildir.

ADO NET kaynağı, bir veri kaynağına bağlanmak için bir ADO.NET bağlantı yöneticisi kullanır ve bağlantı yöneticisi .NET sağlayıcısını belirtir. Daha fazla bilgi için bkz. ADO.NET Bağlantı Yöneticisi.

ADO NET kaynağında bir normal çıkış ve bir hata çıkışı vardır.

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

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 bkz. Veri Akışı Bileşeninin Özelliklerini Ayarlama.

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

Kaynak için ADO.NET bağlantı yöneticisini seçmek için ADO NET Kaynak Düzenleyicisi iletişim kutusunun Bağlantı Yöneticisi sayfasını kullanın. Bu sayfa ayrıca veritabanından bir tablo veya görünüm seçmenize de olanak tanır.

ADO NET kaynağı hakkında daha fazla bilgi edinmek için bkz. ADO NET Kaynağı.

Bağlantı Yöneticisi sayfasını açmak için

  1. SQL Server Veri Araçları'nda (SSDT), ADO NET kaynağına sahip Integration Services paketini açın.

  2. Veri Akışı sekmesinde ADO NET kaynağına çift tıklayın.

  3. ADO NET Kaynak Düzenleyicisi'ndeBağlantı Yöneticisi'ne tıklayın.

Statik Seçenekler

ADO.NET bağlantı yöneticisi
Listeden mevcut bir bağlantı yöneticisini seçin veya Yeni'ye tıklayarak yeni bir bağlantı oluşturun.

Yeni
ADO.NET Bağlantı Yöneticisini Yapılandır iletişim kutusunu kullanarak yeni bir bağlantı yöneticisi oluşturun.

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

Seçenek Açıklama
Tablo veya görünüm ADO.NET veri kaynağındaki bir tablodan veya görünümden veri alın.
SQL komutu SQL sorgusu kullanarak ADO.NET veri kaynağından veri alın.

Önizleme
Veri Görünümü iletişim kutusunu kullanarak sonuçların önizlemesini görüntüleyin. Önizleme en fazla 200 satır görüntüleyebilir.

Uyarı

Verileri önİzlerken, CLR kullanıcı tanımlı türe sahip sütunlar veri içermez. Bunun yerine değer <görüntülenemeyecek> kadar büyük veya System.Byte[] görüntüleniyor. İlki, veri kaynağına ADO.NET sağlayıcısı kullanılarak erişildiğinde, ikincisi SQL Server Yerel İstemci sağlayıcısı kullanılırken görüntülenir.

Veri Erişim Modu Dinamik Seçenekleri

Veri erişim modu = Tablo veya görünüm

Tablonun veya görünümün adı
Veri kaynağında bulunanlar listesinden tablo veya görünümün adını seçin.

Veri erişim modu = SQL komutu

SQL komut metni
SQL sorgusunun metnini girin, Sorgu Oluştur'a tıklayarak sorguyu derleyin veya Gözat'a tıklayarak sorgu metnini içeren dosyayı bulun.

Sorgu oluştur
SQL sorgusunu görsel olarak oluşturmak için Sorgu Oluşturucusu iletişim kutusunu kullanın.

Gözat
iletişim kutusunu kullanarak SQL sorgusunun metnini içeren dosyayı bulun.

ADO NET Kaynak Düzenleyicisi (Sütunlar Sayfası)

Bir çıkış sütununu her dış (kaynak) sütuna eşlemek için ADO NET Kaynak Düzenleyicisi iletişim kutusunun Sütunlar sayfasını kullanın.

ADO NET kaynağı hakkında daha fazla bilgi edinmek için bkz. ADO NET Kaynağı.

Sütunlar Sayfasını Açma

  1. SQL Server Veri Araçları'nda (SSDT), ADO NET kaynağına sahip Integration Services paketini açın.

  2. Veri Akışı sekmesinde ADO NET kaynağına çift tıklayın.

  3. ADO NET Kaynak Düzenleyicisi'ndeSütunlar'a tıklayı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ı, bu kaynaktan veri kullanan bileşenleri yapılandırırken göreceğiniz sırayla görüntüleyin.

Çı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.

ADO NET Kaynak Düzenleyicisi (Hata Çıktı Sayfası)

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

ADO NET kaynağı hakkında daha fazla bilgi edinmek için bkz. ADO NET Kaynağı.

Hata Çıktısı sayfasını açmak için

  1. SQL Server Veri Araçları'nda (SSDT), ADO NET kaynağına sahip Integration Services paketini açın.

  2. Veri Akışı sekmesinde ADO NET kaynağına çift tıklayın.

  3. ADO NET Kaynak Düzenleyicisi'ndeHata Çıkışı'na tıklayın.

Seçenekler

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

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

Hata
Bir hata oluştuğunda ne olacağını belirtin: hatayı yoksayın, satırı yeniden yönlendirin ya da bileşeni başarısız kılın.

İlgili Konular:Veride Hata İşleme

Kısaltma
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 sorun ya da kesinti meydana geldiğinde tüm seçili hücrelerle ilgili ne yapılacağını belirtin: hatayı yoksayın, satırı yeniden yönlendirin veya bileşeni başarısız yapın.

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

Ayrıca Bkz.

DataReader Hedefi
ADO NET Hedefi
Veri Akışı