Aracılığıyla paylaş

ADO.NET bağlantı yöneticisi

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

ADO.NET bağlantı yöneticisi, bir paketin .NET sağlayıcısı kullanarak veri kaynaklarına erişmesini sağlar. Genellikle bu bağlantı yöneticisini Microsoft SQL Server gibi veri kaynaklarına erişmek için kullanırsınız. Yönetilen kodda yazılmış özel görevlerde OLE DB ve XML aracılığıyla kullanıma sunulan veri kaynaklarına C# gibi bir dil kullanarak da erişebilirsiniz.

Bir pakete ADO.NET bağlantı yöneticisi eklediğinizde, SQL Server Integration Services çalışma zamanında ADO.NET bağlantı olarak çözümlenen bir bağlantı yöneticisi oluşturur. Bağlantı yöneticisi özelliklerini ayarlar ve bağlantı yöneticisini paket üzerindeki Connections koleksiyonuna ekler.

ConnectionManagerType Bağlantı yöneticisinin özelliği olarak ADO.NETayarlanır. değeri ConnectionManagerType , bağlantı yöneticisinin kullandığı .NET sağlayıcısının adını içerecek şekilde nitelenmiş.

Uyarı

Microsoft Entra Id daha önce Azure Active Directory (Azure AD) olarak biliniyordu.

ADO.NET bağlantı yöneticisi sorunlarını giderme

ADO.NET bağlantı yöneticisinin dış veri sağlayıcılarına yaptığı çağrıları günlüğe kaydedebilirsiniz. Ardından, ADO.NET bağlantı yöneticisinin dış veri kaynaklarına yaptığı bağlantıların sorunlarını giderebilirsiniz. ADO.NET bağlantı yöneticisinin 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ı.

bir ADO.NET bağlantı yöneticisi tarafından okunurken, belirli SQL Server tarih veri türlerinin verileri aşağıdaki tabloda gösterilen sonuçları oluşturur.

SQL Server veri türü Sonuç
time, datetimeoffset Paket parametreli SQL komutları kullanmadığı sürece paket başarısız olur. Parametreli SQL komutlarını kullanmak için paketinizde SQL Görevini Yürüt'ünüzü kullanın. Daha fazla bilgi için bkz. SQL Görevini Yürütme ve SQL Görevini Yürütme.
datetime2 ADO.NET bağlantı yöneticisi milisaniye değerini keser.

Uyarı

SQL Server veri türleri ve Integration Services veri türleriyle nasıl eşleneceği hakkında daha fazla bilgi için bkz. Veri türleri ve Integration Services Veri Türleri.

ADO.NET bağlantı yöneticisi yapılandırması

Özellikleri SSIS Designer aracılığıyla veya program aracılığıyla ayarlayabilirsiniz.

  • Seçili .NET sağlayıcısının gereksinimlerini karşılamak için yapılandırılmış belirli bir bağlantı dizesi sağlayın.

  • Sağlayıcıya bağlı olarak, bağlanacak veri kaynağının adını ekleyin.

  • Seçilen sağlayıcı için uygun güvenlik kimlik bilgilerini sağlayın.

  • Bağlantı yöneticisinden oluşturulan bağlantının çalışma zamanında tutulup tutulmayacağını belirtin.

ADO.NET bağlantı yöneticisinin yapılandırma seçeneklerinin çoğu, bağlantı yöneticisinin kullandığı .NET sağlayıcısına bağlıdır.

Bir bağlantı yöneticisini program aracılığıyla yapılandırma hakkında bilgi için bkz ConnectionManager . ve Program Aracılığıyla Bağlantı Ekleme.

ADO.NET bağlantı yöneticisini yapılandırma

.NET Framework veri sağlayıcısı kullanılarak erişilebilen bir veri kaynağına bağlantı eklemek için ADO.NET Bağlantı Yöneticisini Yapılandır iletişim kutusunu kullanın. Örneğin, bu sağlayıcılardan biri SqlClient sağlayıcısıdır. Bağlantı yöneticisi mevcut bir bağlantıyı kullanabilir veya yeni bir bağlantı oluşturabilirsiniz.

ADO.NET bağlantı yöneticisi hakkında daha fazla bilgi edinmek için bkz. ADO.NET Bağlantı Yöneticisi.

Seçenekler

Seçenek Açıklama
Veri bağlantıları Listeden mevcut bir ADO.NET veri bağlantısı seçin.
Veri bağlantısı özellikleri Seçili ADO.NET veri bağlantısı için özellikleri ve değerleri görüntüleyin.
Yeni Bağlantı Yöneticisi iletişim kutusunu kullanarak ADO.NET veri bağlantısı oluşturun.
Silmek Bir bağlantı seçin ve sil'i seçerek bağlantıyı silin.

Microsoft SqlClient Veri Sağlayıcısı'nı kullanma

Microsoft SqlClient Veri Sağlayıcısı, SQL Server 2025 (17.x) ve sonraki sürümlerde desteklenir. SQL Server 2022 (16.x) ve önceki sürümler için, msi veya Microsoft Entra ID tabanlı kimlik doğrulaması gerekiyorsa Oledb Bağlantı Yöneticisi'ni kullanın.

Paket tasarımı için SQL Server Integration Services Projeleri 2022 veya üzerini kullanın.

Microsoft Entra kimlik doğrulama modlarını yapılandırma yönergeleri için bkz. Microsoft Entra kimlik doğrulaması ve SqlClient ile Azure SQL'e bağlanma.

Azure kaynaklarının kimlik doğrulaması için yönetilen kimlikler

Azure Data Factory'de (ADF)Azure-SSIS tümleştirme çalışma zamanında (IR) SSIS paketlerini çalıştırırken, Azure SQL Veritabanı'na veya SQL Yönetilen Örneği'ne erişmek için ADF'nizin yönetilen kimliğiyle Microsoft Entra kimlik doğrulamasını kullanabilirsiniz. Azure-SSIS IR'niz bu yönetilen kimliği kullanarak veritabanınızdan veya veritabanınıza verilere erişebilir ve bunları kopyalayabilir.

Uyarı

Kullanıcı tarafından atanan yönetilen kimlikle kimlik doğrulaması yaptığınızda, SSIS tümleştirme çalışma zamanının aynı kimlikle etkinleştirilmesi gerekir. Daha fazla bilgi için bkz. Azure-SSIS tümleştirme çalışma zamanı için Microsoft Entra kimlik doğrulamasını etkinleştirme.

ADF'nizin yönetilen kimliğini kullanarak Azure SQL Veritabanı'na erişmesini sağlamak için şu adımları izleyin:

  1. Henüz yapmadıysanız Azure portal aracılığıyla Azure SQL Veritabanı'nda mantıksal sunucunuz için bir Microsoft Entra yöneticisi sağlayın. Microsoft Entra yöneticisi bir kullanıcı veya grup olabilir. Bir grubu yönetici olarak atarsanız ve ADF'nizin yönetilen kimliği bu grubun bir üyesiyse, 2. ve 3. adımları atlayabilirsiniz. Yöneticinin mantıksal sunucunuza tam erişimi vardır.

  2. ADF'nize atanan yönetilen kimliği temsil eden bir bağımsız veritabanı kullanıcısı oluşturun. SQL Server Management Studio (SSMS) kullanarak, en az ALTER ANY USER iznine sahip bir Microsoft Entra kullanıcısı ile veri kopyalamak istediğiniz veya kopyalayacağınız veritabanına bağlanın. Aşağıdaki T-SQL deyimini çalıştırın:

    CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;

    ADF'niz için sistem tarafından atanan yönetilen kimliği kullanıyorsanız, yönetilen kimlik adınız ADF adınızdır. ADF'niz için kullanıcı tarafından atanan bir yönetilen kimlik kullanıyorsanız yönetilen kimlik adınız yönetilen kimliğin adıdır.

  3. Normalde SQL kullanıcıları için yaptığınız gibi, ADF'niz için yönetilen kimliğe gerekli izinleri verin. Veritabanı düzeyindeki roller bölümüne uygun roller için bakın. Aşağıdaki T-SQL deyimini çalıştırın. Diğer seçenekler için bu makaleye bakın.

    EXECUTE sp_addrolemember [role name], [your managed identity name];

Azure SQL Yönetilen Örneği'ne erişmek için ADF'nize atanan yönetilen kimliği kullanmak için şu adımları izleyin:

  1. Henüz yapmadıysanız, Azure portalda Azure SQL Yönetilen Örneğiniz için bir Microsoft Entra yöneticisi sağlayın. Microsoft Entra yöneticisi bir kullanıcı veya grup olabilir. Bir grubu yönetici olarak atarsanız ve yönetilen kimliğiniz bu grubun bir üyesiyse, 2- 4 arası adımları atlayabilirsiniz. Yönetici, yönetilen örneğinize tam erişime sahiptir.

  2. ADF'nizin yönetilen kimliği için oturum açma bilgileri oluşturun. SSMS'de sysadmin izinlerine sahip bir hesap veya Microsoft Entra yöneticisi kullanarak yönetilen örneğine bağlanın. master Veritabanında aşağıdaki T-SQL deyimini çalıştırın:

    CREATE LOGIN [your managed identity name] FROM EXTERNAL PROVIDER;

    ADF'niz için sistem tarafından atanan yönetilen kimliği kullanıyorsanız, yönetilen kimlik adınız ADF adınızdır. ADF'niz için kullanıcı tarafından atanan bir yönetilen kimlik kullanıyorsanız yönetilen kimlik adınız yönetilen kimliğin adıdır.

  3. ADF'nizin yönetilen kimliğini temsil eden bir bağımsız veritabanı kullanıcısı oluşturun. SSMS kullanarak veri kopyalamak istediğiniz veritabanına bağlanın ve aşağıdaki T-SQL deyimini çalıştırın:

    CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;

  4. Normalde SQL kullanıcıları için yaptığınız gibi, ADF'niz için yönetilen kimliğe gerekli izinleri verin. Aşağıdaki T-SQL deyimini çalıştırın. Diğer seçenekler için bu makaleye bakın.

    ALTER ROLE [role name, for example, db_owner] ADD MEMBER [your managed identity name];

Son olarak, ADO.NET bağlantı yöneticisinde ADF'nizin yönetilen kimliğiyle Microsoft Entra kimlik doğrulamasını yapılandırabilirsiniz. Bunu yapmak için seçenekler şunlardır:

  • Tasarım zamanında yapılandırın. SSIS Tasarımcısı'nda ADO.NET bağlantı yöneticinize sağ tıklayın ve Özellikler'i seçin. özelliğini ConnectUsingManagedIdentity olarak Truegüncelleştirin.

    Uyarı

    Bağlantı yöneticisi özelliği ConnectUsingManagedIdentity , paketinizi SSIS Designer'da veya SQL Server'da çalıştırdığınızda geçerli olmaz ve bu da ADF'nizin yönetilen kimliğiyle Microsoft Entra kimlik doğrulamasının çalışmadığını gösterir.

  • Çalışma zamanında yapılandırın. Paketinizi SSMS veya ADF işlem hattı aracılığıyla çalıştırdığınızda, ADO.NET bağlantı yöneticisini bulun ve özelliğini ConnectUsingManagedIdentity olarak Truegüncelleştirin.

    Uyarı

    Azure-SSIS IR'de, ADO.NET bağlantı yöneticinizde önceden yapılandırılmış diğer tüm kimlik doğrulama yöntemleri (örneğin, tümleşik güvenlik ve parola), ADF'nizin yönetilen kimliğiyle Microsoft Entra kimlik doğrulaması kullanılırken geçersiz kılınıyor.

Microsoft Entra kimlik doğrulamasını mevcut paketlerinizde ADF'nizin yönetilen kimliğiyle yapılandırmak için tercih edilen yol, SSIS projenizi en az bir kez en son SSIS Designer ile yeniden oluşturmaktır. Yeni bağlantı yöneticisi özelliğinin ConnectUsingManagedIdentity projenizdeki tüm ADO.NET bağlantı yöneticilerine otomatik olarak eklenmesi için SSIS projenizi Azure-SSIS IR üzerinde çalışacak şekilde yeniden dağıtın. Alternatif olarak, \Package.Connections[{bağlantı yöneticinizin adı}].Properties[ConnectUsingManagedIdentity] özellik yolu ile çalışma zamanında atanan özellik geçersiz kılmalarını doğrudan kullanabilirsiniz.

İlgili içerik

  • Last updated on