Azure özellikli dtexec yardımcı programıyla SQL Server Integration Services paketlerini çalıştırma

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede Azure özellikli dtexec (AzureDTExec) komut istemi yardımcı programı açıklanmaktadır. Sql Server Integration Services (SSIS) paketlerini Azure Data Factory'deki Azure-SSIS Integration Runtime (IR) üzerinde çalıştırmak için kullanılır.

Geleneksel dtexec yardımcı programı SQL Server ile birlikte gelir. Daha fazla bilgi için bkz . dtexec yardımcı programı. Şirket içinde SSIS paketlerini çalıştırmak için genellikle ActiveBatch ve Control-M gibi üçüncü taraf düzenleyiciler veya zamanlayıcılar tarafından çağrılır.

Modern AzureDTExec yardımcı programı bir SQL Server Management Studio (SSMS) aracıyla birlikte gelir. Azure'da SSIS paketlerini çalıştırmak için üçüncü taraf düzenleyiciler veya zamanlayıcılar tarafından da çağrılabilir. SSIS paketlerinizin buluta kaldırılmasını ve kaydırılmasını veya geçişini kolaylaştırır. Geçiş sonrasında, günlük işlemlerinizde üçüncü taraf düzenleyicileri veya zamanlayıcıları kullanmaya devam etmek istiyorsanız, artık dtexec yerine AzureDTExec'i çağırabilir.

AzureDTExec, paketlerinizi Data Factory işlem hatlarında SSIS Paketi etkinliklerini yürüt olarak çalıştırır. Daha fazla bilgi için bkz . SSIS paketlerini Azure Data Factory etkinlikleri olarak çalıştırma.

AzureDTExec, SSMS aracılığıyla, veri fabrikanızda işlem hatları oluşturan bir Microsoft Entra uygulaması kullanacak şekilde yapılandırılabilir. Ayrıca dosya sistemlerine, dosya paylaşımlarına veya paketlerinizi depoladığınız Azure Dosyalar erişecek şekilde yapılandırılabilir. Çağırma seçenekleri için verdiğiniz değerlere bağlı olarak AzureDTExec, içinde SSIS Paketini Yürüt etkinliği olan benzersiz bir Data Factory işlem hattı oluşturur ve çalıştırır. AzureDTExec'i seçenekleri için aynı değerlerle çağırmak, mevcut işlem hattını yeniden çalıştırır.

Önkoşullar

AzureDTExec'i kullanmak için SSMS'nin 18.3 veya sonraki bir sürümü olan en son sürümünü indirin ve yükleyin. Bu web sitesinden indirin.

AzureDTExec yardımcı programını yapılandırma

SSMS'yi yerel makinenize yüklemek AzureDTExec'i de yükler. Ayarlarını yapılandırmak için SSMS'yi Yönetici olarak çalıştır seçeneğiyle başlatın. Ardından Araçlar>Azure'a Geçir Azure>özellikli DTExec'i yapılandır'ı seçin.

Bu eylem, AzureDTExec.settings dosyasına yazabilmesi için yönetici ayrıcalıklarıyla açılması gereken bir AzureDTExecConfig penceresi açar. SSMS'yi yönetici olarak çalıştırmadıysanız bir Kullanıcı Hesabı Denetimi (UAC) penceresi açılır. Ayrıcalıklarınızı yükseltmek için yönetici parolanızı girin.

AzureDTExecConfig penceresinde yapılandırma ayarlarınızı aşağıdaki gibi girin:

• ApplicationId: Veri fabrikanızda işlem hatları oluşturmak için doğru izinlerle oluşturduğunuz Microsoft Entra uygulamasının benzersiz tanımlayıcısını girin. Daha fazla bilgi için bkz . Azure portalı aracılığıyla Microsoft Entra uygulaması ve hizmet sorumlusu oluşturma.
• AuthenticationKey: Microsoft Entra uygulamanızın kimlik doğrulama anahtarını girin.
• TenantId: Microsoft Entra uygulamanızın oluşturulduğu Microsoft Entra kiracısının benzersiz tanımlayıcısını girin.
• DataFactory: AzureDTExec'i çağırdığınızda sağlanan seçeneklerin değerlerine göre, içinde SSIS Paketi Yürütme etkinliği olan benzersiz işlem hatlarının oluşturulduğu veri fabrikanızın adını girin.
• IRName: AzureDTExec'i çağırdığınızda Evrensel Adlandırma Kuralı (UNC) yolunda belirtilen paketlerin çalıştırılacağı veri fabrikanızda Azure-SSIS IR'nin adını girin.
• PipelineNameHashStrLen: AzureDTExec'i çağırırken sağladığınız seçeneklerin değerlerinden oluşturulacak karma dizelerin uzunluğunu girin. Dizeler, Paketlerinizi Azure-SSIS IR üzerinde çalıştıran Data Factory işlem hatlarının benzersiz adlarını oluşturmak için kullanılır. Genellikle 32 karakter uzunluğunda olması yeterlidir.
• ResourceGroup: Veri fabrikanızın oluşturulduğu Azure kaynak grubunun adını girin.
• SubscriptionId: Veri fabrikanızın oluşturulduğu Azure aboneliğinin benzersiz tanımlayıcısını girin.
• LogAccessDomain: LogPath belirtildiğinde ve LogLevel null olmadığında gerekli olan günlük dosyalarını yazarken UNC yolundaki günlük klasörünüze erişmek için etki alanı kimlik bilgilerini girin.
• LogAccessPassword: LogPath belirtildiğinde ve LogLevel null olmadığında gerekli olan günlük dosyalarını yazarken UNC yolundaki günlük klasörünüze erişmek için parola kimlik bilgilerini girin.
• LogAccessUserName: LogPath belirtildiğinde ve LogLevel null olmadığında gerekli olan günlük dosyalarını yazarken UNC yolunda günlük klasörünüze erişmek için kullanıcı adı kimlik bilgilerini girin.
• LogLevel: Azure-SSIS IR'de paket yürütmeleriniz için önceden tanımlanmış null, Temel, Ayrıntılı veya Performans seçeneklerinden seçilen günlüğe kaydetme kapsamını girin.
• LogPath: Azure-SSIS IR üzerindeki paket yürütmelerinizdeki günlük dosyalarının yazıldığı günlük klasörünün UNC yolunu girin.
• PackageAccessDomain: AzureDTExec'i çağırdığınızda belirtilen UNC yolunda paketlerinize erişmek için etki alanı kimlik bilgilerini girin.
• PackageAccessPassword: AzureDTExec'i çağırdığınızda belirtilen UNC yolunda paketlerinize erişmek için parola kimlik bilgilerini girin.
• PackageAccessUserName: AzureDTExec'i çağırdığınızda belirtilen UNC yolunda paketlerinize erişmek için kullanıcı adı kimlik bilgilerini girin.

Paketlerinizi ve günlük dosyalarınızı şirket içi dosya sistemlerinde veya dosya paylaşımlarında depolamak için Azure-SSIS IR'nizi şirket içi ağınıza bağlı bir sanal ağa birleştirerek paketlerinizi getirmesini ve günlük dosyalarınızı yazabilmesini sağlayın. Daha fazla bilgi için bkz . Azure-SSIS IR'yi sanal ağa ekleme.

AzureDTExec.settings dosyasına yazılan hassas değerleri düz metin olarak göstermekten kaçınmak için bunları Base64 kodlama dizelerine kodlarız. AzureDTExec'i çağırdığınızda, base64 ile kodlanmış tüm dizelerin kodu özgün değerlerine geri döndürüler. Erişebilecek hesapları sınırlayarak AzureDTExec.settings dosyasının güvenliğini daha da sağlayabilirsiniz.

AzureDTExec yardımcı programını çağırma

Komut satırı isteminde AzureDTExec'i çağırabilir ve kullanım örneği senaryonuzda belirli seçenekler için ilgili değerleri sağlayabilirsiniz.

yardımcı programı adresinde {SSMS Folder}\Common7\IDE\CommonExtensions\Microsoft\SSIS\150\Binnyüklüdür. Her yerden çağrılabilmesi için 'PATH' ortam değişkenine yolunu ekleyebilirsiniz.

> cd "C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE\CommonExtensions\Microsoft\SSIS\150\Binn"
> AzureDTExec.exe  ^
  /F \\MyStorageAccount.file.core.windows.net\MyFileShare\MyPackage.dtsx  ^
  /Conf \\MyStorageAccount.file.core.windows.net\MyFileShare\MyConfig.dtsConfig  ^
  /Conn "MyConnectionManager;Data Source=MyDatabaseServer.database.windows.net;User ID=MyAdminUsername;Password=MyAdminPassword;Initial Catalog=MyDatabase"  ^
  /Set \package.variables[MyVariable].Value;MyValue  ^
  /De MyEncryptionPassword

AzureDTExec'i çağırmak, dtexec çağırmaya benzer seçenekler sunar. Daha fazla bilgi için bkz . dtexec Yardımcı Programı. Şu anda desteklenen seçenekler şunlardır:

• /F[ile]: Dosya sisteminde, dosya paylaşımında veya Azure Dosyalar depolanan bir paketi yükler. Bu seçeneğin değeri olarak, dosya sistemi, dosya paylaşımı veya .dtsx uzantısıyla Azure Dosyalar paket dosyanızın UNC yolunu belirtebilirsiniz. Belirtilen UNC yolunda boşluk varsa, yolun tamamına tırnak işareti koyun.
• /Conf[igFile]: Değerlerin ayıklanması için bir yapılandırma dosyası belirtir. Bu seçeneği kullanarak, paketiniz için tasarım zamanında belirtilenden farklı bir çalışma zamanı yapılandırması ayarlayabilirsiniz. Farklı ayarları bir XML yapılandırma dosyasında depolayabilir ve paket yürütmeden önce yükleyebilirsiniz. Daha fazla bilgi için bkz . SSIS paket yapılandırmaları. Bu seçeneğin değerini belirtmek için dosya sistemi, dosya paylaşımı veya dtsConfig uzantısıyla Azure Dosyalar yapılandırma dosyanızın UNC yolunu kullanın. Belirtilen UNC yolunda boşluk varsa, yolun tamamına tırnak işareti koyun.
• /Conn[ection]: Paketinizdeki mevcut bağlantı yöneticileri için bağlantı dizesi belirtir. Bu seçeneği kullanarak, paketinizdeki mevcut bağlantı yöneticileri için tasarım zamanında belirtilenlerden farklı çalışma zamanı bağlantı dizesi ayarlayabilirsiniz. Bu seçeneğin değerini şu şekilde belirtin: connection_manager_name_or_id;connection_string [[;connection_manager_name_or_id;connection_string]...].
• /Set: Paketinizdeki parametrenin, değişkenin, özelliğin, kapsayıcının, günlük sağlayıcısının, Foreach numaralandırıcısının veya bağlantının yapılandırmasını geçersiz kılar. Bu seçenek birden çok kez belirtilebilir. Bu seçeneğin değerini şu şekilde belirtin: property_path;value. Örneğin, \package.variables[counter].Value;1 değişkenin counter değerini 1 olarak geçersiz kılar. Paketinizdeki değerini geçersiz kılmak istediğiniz öğelerin değerini property_path bulmak, kopyalamak ve yapıştırmak için Paket Yapılandırması sihirbazını kullanabilirsiniz. Daha fazla bilgi için bkz . Paket Yapılandırma sihirbazı.
• /De[crypt]: EncryptAllWithPassword EncryptSensitiveWithPassword/ koruma düzeyiyle yapılandırılan paketinizin şifre çözme parolasını ayarlar.

Not

AzureDTExec'i seçenekleri için yeni değerlerle çağırmak, /De[cript] seçeneği dışında yeni bir işlem hattı oluşturur.

İlgili içerik

AzureDTExec'i çağırdığınızda, içinde SSIS Paketi Yürüt etkinliği olan benzersiz işlem hatları oluşturulduktan ve çalıştırıldıktan sonra Data Factory portalında izlenebilirler. Data Factory kullanarak bunları ayarlamak/zamanlamak istiyorsanız, bunlara Data Factory tetikleyicileri de atayabilirsiniz. Daha fazla bilgi için bkz . SSIS paketlerini Data Factory etkinlikleri olarak çalıştırma.

Uyarı

Oluşturulan işlem hattının yalnızca AzureDTExec tarafından kullanılması beklenir. Özellikleri veya parametreleri gelecekte değişebilir, bu nedenle bunları başka bir amaçla değiştirmeyin veya yeniden kullanmayın. Değişiklikler AzureDTExec'i bozabilir. Böyle bir durumda işlem hattını silin. AzureDTExec, bir sonraki çağrılışında yeni bir işlem hattı oluşturur.