dtexec yardımcı programı
dtexecKomut istemi yardımcı programını yapılandırmak ve çalıştırmak için kullanılan SQL Server Integration Servicespaketleri. dtexecYarar sağlar tüm paket yapılandırma ve çalıştırma özelliklerine, parametreler, bağlantıları, özellikleri, değişkenler, günlük ve ilerleme göstergeleri gibi. dtexecPaketleri bu kaynaklardan yüklemek yarar sağlar: Integration Servicesserver, .ispac proje dosyası, bir Microsoft SQL Serververitabanı, SSIShizmet ve dosya sistemi.
Kullandığınızda dtexecpaketleri çalıştırmak için Integration Servicesserver dtexecçağrıları catalog.create_execution (SSISDB veritabanı), catalog.set_execution_parameter_value (SSISDB veritabanı)ve catalog.start_execution (SSISDB veritabanı)yürütmesini oluşturmak için parametre değerlerini ayarlamak ve yürütme başlangıç. Tüm yürütme günlükleri ilgili görüşlerini veya standart raporları kullanılabilir kullanarak sunucudan görülebilir SQL Server Management Studio. Raporlar hakkında daha fazla bilgi için bkz: Integration Services Server işlemleri raporları.
Aşağıdaki örneği üzerinde bir paketi yürütme olduğunu Integration Servicessunucu.
DTExec /ISSERVER "\SSISDB\folderB\Integration Services Project17\Package.dtsx" /SERVER "." /Envreference 2 /Par "$Project::ProjectParameter(Int32)";1 /Par "Parameter(Int32)";21 /Par "CM.sqlcldb2.SSIS_repro.InitialCatalog";ssisdb /Par "$ServerOption::SYNCHRONIZED(Boolean)";True
DTExec /ISSERVER "\SSISDB\folderB\Integration Services Project17\Package.dtsx" /SERVER "." /Envreference 2 /Par "$Project::ProjectParameter(Int32)";1 /Par "Parameter(Int32)";21 /Par "CM.sqlcldb2.SSIS_repro.InitialCatalog";ssisdb /Par "$ServerOption::SYNCHRONIZED(Boolean)";True
Kullandığınızda dtexec.ispac proje dosyasından bir paketi çalıştırmak için ilgili seçenekler şunlardır: /Proj [ect] ve proje yolu ve paket akış adı belirtmek için kullanılan /Pack [yaş]. Dönüştürdüğünüzde bir proje için proje dağıtım modeli çalıştırarak Tümleştirme Hizmetleri proje Dönüştürme Sihirbazı'nı dan SQL Server Management Studio, .ispac projec dosya sihirbaz oluşturur. Daha fazla bilgi için, bkz. Dönüştürmek ve projeler dağıtma.
[!NOT]
Sürümünü kullandığınızda dtexecprogramı ile gelir SQL Server 2012 Integration Services (SSIS)çalıştırmak için bir SQL Server 2005 Integration Services (SSIS)ya da bir SQL Server 2008 Integration Services (SSIS)paket Integration Servicesgeçici olarak paket için yükseltme SQL Server 2012 Integration Services (SSIS). Ancak, sen cant'kullanma dtexecbunlar kaydetmek için yardımcı programı yükseltilmiş değişiklikler. Kalıcı bir paket için yükseltme hakkında daha fazla bilgi için SQL Server 2012 Integration Services (SSIS)bakın Tümleştirme Hizmetleri paketleri yükseltme.
Bu konuda aşağıdaki bölümler bulunur:
64 Bit bilgisayarlarda yükleme ilgili önemli noktalar
Yürütme aşamaları
Geri döndürülen çıkış kodlarını
Sözdizimi kuralları
Xp_cmdshell gelen dtexec kullanma
Sözdizimi
Parametreler
Açıklamalar
Örnekler
64 Bit bilgisayarlarda yükleme ilgili önemli noktalar
64-Bit bilgisayarda, Integration Servicesbir 64-bit sürümünü yükler dtexecyardımcı (dtexec.exe). Eğer sen-si olmak-e belirli paketleri 32-bit modunda çalıştırmak, 32-bit sürümünü yüklemek olacaktır dtexecyarar. 32-Bit sürümünü yüklemek için dtexecprogramı, ya da istemci araçları seçmelisiniz veya SQL Server Veri Akışı Araçları (SSDT)Kurulum sırasında.
Varsayılan olarak, 64-bit bilgisayara olan hem 64 bit ve 32-bit sürümleri bir Integration Servicesyüklü komut istemi yardımcı programı komut isteminde 32-bit sürümünü çalıştırmak. 32-Bit sürümü 32-bit sürümü için dizin yolu önce 64-bit sürümü için dizin yolunu path ortam değişkeninde göründüğünden çalışır. (Genellikle, 32-bit dizin yolu <drive>: \Program Files (x 86) \Microsoft SQL Server\110\DTS\Binn, 64-bit dizin yolu ise <drive>: \Program Files\Microsoft SQL Server\110\DTS\Binn.)
[!NOT]
Eğer yardımcı programını çalıştırmak için SQL Server Agent'ı kullanıyorsanız, SQL Server Agent otomatik olarak yardımcı programı 64-bit sürümünü kullanır. SQL Server Agent kayıt, path ortam değişkeni değil, yardımcı programı doğru yürütülebilir dosyayı bulmak için kullanır.
Komut istemi yardımcı programı 64-bit sürümünü çalıştırmak emin olmak için aşağıdaki eylemlerden birini alabilir:
Bir komut istemi penceresi açın, yardımcı programı 64-bit sürümünü içeren dizini değiştirin (<drive>: \Program Files\Microsoft SQL Server\110\DTS\Binn), ve sonra o konumdan yardımcı programı çalıştırın.
Tam yolunu girerek yardımcı programı komut isteminde çalıştırın (<drive>: \Program Files\Microsoft SQL Server\110\DTS\Binn) yardımcı programı 64-bit sürümüne.
Kalıcı olarak 64 bitlik yolunu girerek yol ortam değişkeni yollarında sırasını değiştirmek (<drive>: \Program Files\Microsoft SQL Server\110\DTS\Binn) 32-bit yoldan önce (<drive>: \ Program files (x 86) \Microsoft SQL Server\110\DTS\Binn) değişken.
Kullanma hakkında daha fazla bilgi için Integration Services64-bit bir bilgisayarda görmek 64-bit Considerations for Integration Services.
Yürütme aşamaları
Yardımcı programı gibi yürütülür, bu gelirleri üzerinden dört aşama vardır. Aşamaları aşağıdaki gibidir:
Aşama kaynak komutu: komut istemi seçeneklerini ve belirtilmiş olan argümanlar listesini okur. Eğer tüm sonraki aşama atlanan bir **/?**ya /HELPseçenek varıldığında.
Paket yükü aşama: tarafından belirtilen paketi /SQL, /FILE, ya /DTSseçenek yüklendi.
Yapılandırma aşama: Seçenekler aşağıdaki sırayla işlenir:
Paketi bayrakları, değişkenler ve özellikleri ayarlama seçenekleri.
Paket sürümü doğrulayın ve oluşturma seçenekleri.
Raporlama gibi yardımcı programını çalıştırma davranışını yapılandırma seçenekleri.
Doğrulama ve yürütme aşama: paketi çalıştırın veya olmadan çalışan eğer doğrulanmış /VALIDATEseçeneği belirtildi.
Geri döndürülen çıkış kodlarını
Dtexec yardımcı programını geri döndürülen çıkış kodlarını
Bir paket çalıştırdığında, dtexecçıkış kodu döndürebilir. Çıkış kodunu hangi değeri sonra koşullu deyimleri ya da bir toplu iş dosyasında dallanma mantığı test edilebilir errorlevel değişkeni doldurmak için kullanılır. Değerler aşağıdaki tabloda listelenmektedir, dtexecyarar çıkarken ayarlayabilirsiniz.
Değer |
Açıklama |
|---|---|
0 |
Başarıyla yürütülen paketi. |
1 |
Paket başarısız oldu. |
3 |
Paketi, kullanıcı tarafından iptal edildi. |
4 |
Hizmet programı istenen paketi bulamadı. Paket bulunamadı. |
5 |
Hizmet programı istenen paketi yükleyemedi. Paketi yüklenemedi. |
6 |
Yardımcı programı, komut satırında sözdizimsel veya anlamsal hataların bir iç hatayla karşılaştı. |
Sözdizimi kuralları
Programı sözdizimi kuralları
Tüm seçenekler, eğik çizgi (/) ya da eksi işareti (-) ile başlamalıdır. Burada gösterilen seçenekleri bir eğik çizgi (/) işareti ile başlar, ama eksi işaretini (-) yerine.
Boşluk içeriyorsa bir bağımsız değişken tırnak içine alınmalıdır. Bağımsız değişken tırnak içine alınmamış, bağımsız değişkeni boşluk içeremez.
İki katına tırnak tırnak içinde dize içine kaçan tek tırnak işaretleri temsil eder.
Seçenekleri ve bağımsız değişkenleri parolaları dışında duyarlı değildir.
Xp_cmdshell gelen dtexec kullanma
Xp_cmdshell gelen dtexec kullanma
Sen-ebilmek koşmak dtexec dan xp_cmdshellistemi. Aşağıdaki örnek, UpsertData.dtsx adlı bir paketi çalıştırın ve dönüş kodunu yoksaymak gösterilmiştir:
EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
Aşağıdaki örnek, aynı paketi çalıştırın ve döndürülen kodu yakalamak gösterilmiştir:
DECLARE @returncode int
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
DECLARE @returncode int
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'
.gif "Önemli not") Önemli |
|---|
De Microsoft SQL Server, xp_cmdshellseçeneği varsayılan olarak yeni yüklemeler devre dışı. Seçenek çalıştırılarak etkinleştirilebilir sp_configuresistem saklı yordamını. Daha fazla bilgi için, bkz. xp_cmdshell Sunucu Yapılandırma Seçeneği. |
Sözdizimi
dtexec /option [value] [/option [value]]...
dtexec /option [value] [/option [value]]...
Parametreler
Seçenek |
Açıklama |
|---|---|
/?[option_name] |
(İsteğe bağlı). Komut istemi seçeneklerini görüntüler veya görüntüler Yardım için belirtilen option_nameve programı kapatır. If you specify bir option_namebağımsız dtexecbaşlar SQL ServerBooks Online ve görüntüler dtexec Utilitykonu. |
/Ca[llerInfo] |
(İsteğe bağlı). Bir paketi yürütme için ek bilgileri belirtir. SQL Server Agent'ı kullanarak bir paketi çalıştırdığınızda, aracı paketi yürütme SQL Server Agent tarafından çağrılır belirtmek için bu bağımsız değişkeni ayarlar. Bu parametre yoksayılır ne zaman dtexecyardımcı programı komut satırından çalıştırılır. |
/CheckF[ile] filespec |
(İsteğe bağlı). Ayarlar CheckpointFileNameözellik paketi için yol ve dosya spemandcified filespec. Paketi yeniden başlatıldığında bu dosya kullanılır. Bu seçenek belirtilen ve değer dosya adı verilir CheckpointFileNameiçin paketi boş bir dizeye ayarlanır. Bu seçenek belirtilmezse, paket değerler korunur. |
/CheckP[ointing]{on\off} |
(İsteğe bağlı). Paket paketi yürütme sırasında denetim noktaları kullanıp kullanmayacağını belirten değeri ayarlar. Değeri onbaşarısız paketi yeniden çalıştırılması belirtir. Başarısız paketi çalıştırın, çalışma zamanı altyapısı hata noktası paketinden yeniden denetim noktası dosyası kullanır. Varsayılan değer, seçenek değeri ilan edilir olduğunu. Paketi yürütme değeri tarih ayarlanır ve denetim noktası dosyası bulunamadı başarısız olur. Bu seçenek belirtilmezse, pakette değere korunur. Daha fazla bilgi için, bkz. Paket denetim noktaları kullanarak yeniden başlatın.. /CheckPointing onDtexec seçeneği ayarı için eşdeğer SaveCheckpointsözelliği true olarak paketi ve CheckpointUsageözelliği her zaman için. |
/Com[mandFile] filespec |
(İsteğe bağlı). Komutu kaynak aşamasında yardımcı programı, dosya belirtilen olduğunu belirtir filespecise eof dosya bulunana kadar açılan seçeneklerini dosyadan okunur. filespecEk içeren metin dosyası olan dtexeckomut seçenekleri. filespecPaketi yürütme ile ilişkilendirmek için komut dosyasının yolu ve dosya adı değişkeni belirtir. |
/Conf[igFile] filespec |
(İsteğe bağlı). Değerleri ayıklamak için bir yapılandırma dosyasını belirtir. Bu seçeneği kullanarak, bir çalışma yapılandırmasını yapılandırma paketi tasarım zamanında belirtildi farklı ayarlayabilirsiniz. Bir xml yapılandırma dosyasında farklı yapılandırma ayarlarını depolamak ve ardından önce paketi yürütme ayarlarını kullanarak yük /ConfigFileseçeneği. Sen-ebilmek kullanma /ConfigFilezamanında, tasarım zamanında belirtmedi ek yapılandırmaları yüklemek için seçeneği. Ancak, sen cant'kullanma /ConfigFileda tasarım sırasında belirtilen Değiştir yapılandırılan değerler seçeneği. Bkz: Paket yapılandırmalarını nasıl uygulandığını anlamak için Paketi yapılandırmalarıve SQL Server 2012 Integration Services özellikleri davranışı değişiklikleri. |
/Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]…] |
(İsteğe bağlı). Belirtilen adı veya GUID ile bağlantı Yöneticisi paketi bulunur ve bir bağlantı dizesini belirtir belirtir. Bu seçenek, her iki parametre belirtilmesini gerektirir: Bağlantı Yöneticisi adı veya GUID de sağlanmalıdır id_or_namebağımsız ve geçerli bir bağlantı dizesine belirtilmelidir connection_stringdeğişkeni. Daha fazla bilgi için, bkz. Tümleştirme Hizmetleri bağlantıları. Çalışma zamanında, sen-ebilmek kullanma /Connectionpaketi yapılandırmaları tasarım sırasında belirtilen konum dışında bir konuma yüklemek için seçeneği. Bu yapılandırma değerlerini sonra başlangıçta belirtilmiş değerleri değiştirin. Ancak sen-ebilmek kullanma /Connectiongibi sadece yapılandırmaları için seçenek SQL Serverbir bağlantı Yöneticisi'ni kullanın yapılandırmalar. Bkz: Paket yapılandırmalarını nasıl uygulandığını anlamak için Paketi yapılandırmalarıve SQL Server 2012 Integration Services özellikleri davranışı değişiklikleri. |
/Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...] |
(İsteğe bağlı). Görüntüler, paketi yürütme sırasında günlük girdilerini konsola belirtildi. Bu seçenek belirtilmezse, günlük girdisi yoktu konsolda görüntülenir. Seçenek görüntülenmesini sınırlamak parametreleri belirtilirse, her günlük girdisi görüntüler. Konsolda görüntülenen girişleri sınırlamak için sütunları kullanarak göstermek için belirleyebileceğiniz displayoptionsparametre ve günlük giriş türlerini kullanarak sınırı list_optionsparametresi. displayoptionsDeğerler aşağıdaki gibidir:
list_optionsDeğerler aşağıdaki gibidir:
Birden fazla kullanırsanız /ConsoleLogaynı komut istemi seçenekleri, onlar etkileşim şöyle:
Çeşitli örnekleri için /ConsoleLogseçeneği, bakın Açıklamalar bölüm. |
/D[ts] package_path |
(İsteğe bağlı). Paket SSIS paket deposundan yükler. package_pathBağımsız değişkeni göreli yolunu belirtir SSISpaket, SSIS paketi depo kökte başlayan ve adını içeren SSISpaket. Yol veya dosya adı belirtilen package_pathbağımsız değişkeni boşluk içeriyorsa, tırnak koymak gerekir package_pathdeğişkeni. /DTSSeçeneği ile birlikte kullanılamaz /Fileya /SQLseçeneği. Birden fazla seçenek belirtilmezse, dtexecbaşarısız. |
/De[crypt] password |
(İsteğe bağlı). Parola şifreleme paketi yüklediğinizde, kullanılan şifre çözme parola ayarlar. |
/Dumperror code |
(İsteğe bağlı) Paketi çalışırken bir veya daha fazla belirli olaylar gerçekleştiğinde hata ayıklama dökümü dosyaları, .mdmp ve .tmp, oluşturur. error codeBağımsız değişkeni olay türünü belirtir — hata, uyarı veya bilgi — sistem hata ayıklama dökümü dosyaları oluşturmak için tetik. Birden çok olay kodlarını belirtmek için her biri ayrı error codebağımsız değişkeni tarafından bir noktalı virgül (;). Varsayılan olarak, Integration Serviceshata ayıklama dökümü dosyaları klasöründe saklar <drive>: \Program Files\Microsoft SQL Server\110\Shared\ErrorDumps. .gif "Not") Not
Hata ayıklama dökümü dosyaları önemli bilgiler içerebilir.Dosyalara erişimi sınırlamak için bir erişim denetimi listesi (acl) kullanın veya dosyaları sınırlı erişimi olan bir klasöre kopyalayın.Örneğin, hata ayıklama dosyaları Microsoft Destek Hizmetleri göndermeden önce hassas veya gizli bilgileri kaldırmak önerilir.
Bu seçenek tamamına uygulamak için paketler dtexecyarar ishal, eklemek a DumpOnCodesreg_sz değerini HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath kayıt defteri anahtarına. Veri değeri DumpOnCodeshata kodunu veya kodlarını oluşturmak için sistem tetikleyecek hata ayıklama dökümü dosyaları belirtir. Birden çok hata kodları bir noktalı virgülle (;) ayrılmış. Eğer bir DumpOnCodeskayıt defteri anahtarına değer ve kullanmak /Dumpseçeneği, sistem her iki ayarları temel alarak hata ayıklama dökümü dosyaları oluşturur. Hata ayıklama dökümü dosyaları hakkında daha fazla bilgi için bkz: Generating Dump Files for Package Execution_old. |
/DumpOnError |
(İsteğe bağlı) Paketi çalışırken herhangi bir hata oluştuğunda hata ayıklama dökümü dosyaları, .mdmp ve .tmp, oluşturur. Varsayılan olarak, Integration Serviceshata ayıklama dökümü dosyaları klasöründe saklar <drive>: \Program Files\Microsoft SQL Server\110\Shared\ErrorDumps klasörüne. Not
Hata ayıklama dökümü dosyaları önemli bilgiler içerebilir.Dosyalara erişimi sınırlamak için bir erişim denetimi listesi (acl) kullanın veya dosyaları sınırlı erişimi olan bir klasöre kopyalayın.Örneğin, hata ayıklama dosyaları Microsoft Destek Hizmetleri göndermeden önce hassas veya gizli bilgileri kaldırmak önerilir.
Bu seçenek tamamına uygulamak için paketler dtexecyardımcı programını çalıştırır, eklemek a DumpOnErrorreg_dword değerini HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath kayıt defteri anahtarına. Değeri DumpOnErrorreg_dword değerini belirler mi /DumpOnErrorseçeneği ile kullanılması gerekiyor dtexecyarar:
Hata ayıklama dökümü dosyaları hakkında daha fazla bilgi için bkz: Generating Dump Files for Package Execution_old. |
/Env[Reference] environment reference ID |
(İsteğe bağlı). İçin dağıtılan bir paket paketi yürütme tarafından kullanılan çevre referans (kimlik) belirtir Integration Servicessunucu. Değişkenlere bağlama için yapılandırılmış parametrelerini ortamında içerdiği değişkenlerin değerlerini kullanır. Kullandığınız /Env[Reference]seçeneği ile birlikte /ISServerve /Serverseçenekleri. Bu parametre, SQL Server Agent tarafından kullanılır. |
/F[ile] filespec |
(İsteğe bağlı). Dosya sistemi kaydedilmiş bir paketi yükler. filespecDeğişkeni, paketin yolunu ve dosya adını belirtir. Bir evrensel adlandırma kuralı (unc) yolu veya yerel yol olarak yolunu belirtebilirsiniz. Yol veya dosya adı belirtilen filespecbağımsız değişkeni boşluk içeriyorsa, tırnak koymak gerekir filespecdeğişkeni. /FileSeçeneği ile birlikte kullanılamaz /DTSya /SQLseçeneği. Birden fazla seçenek belirtilmezse, dtexecbaşarısız. |
/H[elp] [option_name] |
(İsteğe bağlı). Veya görüntüler seçenekler için yardım görüntüler Yardım için belirtilen option_nameve programı kapatır. If you specify bir option_namebağımsız dtexecbaşlar SQL ServerBooks Online ve görüntüler dtexec Utilitykonu. |
/ISServer packagepath |
(İsteğe bağlı). Tümleştirme Hizmetleri sunucusuna dağıtıldığı bir paketi çalıştırır. PackagePathBağımsız değişkeni için dağıtılan paketin tam yolunu ve dosya adını belirtir Integration Servicessunucu. Yol veya dosya adı belirtilen PackagePathbağımsız değişkeni boşluk içeriyorsa, tırnak koymak gerekir PackagePathdeğişkeni. Paket biçimi aşağıdaki gibidir: Kullandığınız /Serverseçeneği ile birlikte /ISSERVERseçeneği. Yalnızca Windows kimlik doğrulaması paketi SSIS sunucu üzerinde çalıştırmak mümkündür. Geçerli Windows kullanıcı paketi erişmek için kullanılır. / Server seçeneği atlanırsa, varsayılan yerel örneği SQL Servervarsayılır. /ISSERVERSeçeneği ile birlikte kullanılamaz /DTS, /SQLya /Fileseçeneği. Birden fazla seçenek belirtilirse, dtexec başarısız olur. Bu parametre, SQL Server Agent tarafından kullanılır. |
/L[ogger] classid_orprogid;configstring |
(İsteğe bağlı). Yürütme ile ilişkilendiren bir veya daha fazla günlük sağlayıcıları bir SSISpaket. classid_orprogidParametresi günlük sağlayıcısını belirtir ve bir sınıf olarak GUID belirtilebilir. configstringGünlük sağlayıcısını yapılandırmak için kullanılan dizedir. Aşağıdaki liste, kullanılabilir günlük sağlayıcıları gösterir:
|
/M[axConcurrent] concurrent_executables |
(İsteğe bağlı). Paket aynı anda çalıştırabilirsiniz çalıştırılabilir dosya sayısını belirtir. Belirtilen değer, negatif olmayan bir tamsayı ya da -1 olmalıdır. -1 Değeri anlamına SSISeşzamanlı olarak çalıan yürütülebilirlerin yürütme paketi artı iki bilgisayar üzerinde toplam sayısına eşit olan bir üst sınır sayısı sağlayacak. |
/Pack[age] PackageName |
(İsteğe bağlı). Yürütülen paketi belirtir. Bu parametre, öncelikle paketi çalıştırdığınızda kullanılır Visual Studio. |
/P[assword] password |
(İsteğe bağlı). Tarafından korunan bir paket alınmasını sağlayan SQL Serverkimlik. Bu seçenek ile birlikte kullanılan /Userseçeneği. Eğer /Passwordseçeneği belirtilmemişse ve /Userseçeneği kullanıldığında, boş bir parola kullanılır. passwordDeğeri kote. .gif "Güvenlik notu") Güvenlik Notu
Mümkünse Windows Kimlik Doğrulaması kullanın.
|
/Par[ameter][$ Paket:: | $Projesi:: | $ServerOption::] parameter_name[(data_type)]; literal_value |
(İsteğe bağlı). Parametre değerlerini belirtir. Birden çok /Parameterseçenekler belirtilebilir. Veri türleri, dizeleri olarak clr TypeCodes vardır. Bir dize olmayan parametre için veri türü parametre adını aşağıdaki parantez içinde belirtilir. Bir paketi parametresi, proje parametresi ve bir sunucu seçeneği parametre sırasıyla belirtmek için $paket, $proje ve $ServerOption önekleri kullanın. Bağlantı Yöneticisi parametre cm önekiyle başlar. Varsayılan parametre türü paketidir. Aşağıdaki örnekte, KaynakSunucu Bağlantı Yöneticisi InitialCatalog özelliği ayarı ssisdb. Bir paketi yürütme ve proje parametresi (myparam) ve paket parametresi (anotherparam) tamsayı değeri 12 myvalue sağlayan bir örnek aşağıdadır. Dtexec /isserver “SSISDB\MyFolder\MyProject\MyPackage.dtsx” /server “.” /parameter $Project::myparam;myvalue /parameter anotherparam(int32);12 |
/Proj[ect] ProjectFile |
(İsteğe bağlı). Yürütülen paketi almak için proje belirtir. ProjectFileBağımsız değişkeni .ispac dosya adını belirler. Bu parametre, öncelikle paketi çalıştırdığınızda kullanılır Visual Studio. |
/Rem comment |
(İsteğe bağlı). Yorum komut isteminde veya komut dosyaları içerir. İsteğe bağlı bir değişkendir. Değeri comment, tırnak içine alınmalıdır, ya da beyaz boşluk içeren bir dizedir. Hiçbir bağımsız değişken belirtilmezse, boş bir satır eklenir. commentdeğerleri aşama kaynak komutu sırasında atılır. |
/Rep[orting] level [;event_guid_or_name[;event_guid_or_name[...]] |
(İsteğe bağlı). Ne tür rapor iletileri belirtir. Mevcut raporlama seçenekleri için levelşunlardır: N hiçbir raporlama. E hataları rapor edilmektedir. W uyarılarını bildirilir. Ben bilgilendirme iletileri bildirilir. C özel etkinlikler bildirdi. D veri akışı görev olayları rapor edilmektedir. P ilerleme bildirdi. V ayrıntılı raporlama. v ve n bağımsız değişkenleri için başka bağımsız değişkenler dışlar; onlar yalnız belirtilmelidir. Eğer /Reportingsonra Varsayılan düzeyi seçeneği belirtilen e (hatalar), w (uyarılar), ve p (devam ediyor). Tüm etkinlikler biçiminde "yy/AA/GG: ss", zaman damgası ve GUID veya kolay adı varsa ile öncesinde. İsteğe bağlı bir parametre event_guid_or_namegünlüğü sağlayıcıları için özel durumlar listesi. İstisna, aksi takdirde oturum değil günlüğe kaydedilen olayları belirtir. Olay genellikle varsayılan olarak günlüğe bir olay dışlamak gerekmez |
/Res[tart] {deny | force | ifPossible} |
(İsteğe bağlı). Yeni bir değer belirtir CheckpointUsageözellik paketi. Parametrelerin anlamları aşağıdaki gibidir: DenyAyarlar CheckpointUsageözelliği DTSCU_NEVER. ForceAyarlar CheckpointUsageözelliği DTSCU_ALWAYS. ifPossibleAyarlar CheckpointUsageözelliği DTSCU_IFEXISTS. Varsayılan değeri forceherhangi bir değer belirtilmemişse kullanılır. |
/Set [$ Duyarlı::]propertyPath;value |
(İsteğe bağlı). Bir parametre, değişken, özelliği, konteyner, günlük sağlayıcı, Foreach numaralayıcı veya bağlantı içinde bir paket yapılandırması geçersiz kılar. Bu seçenek kullanıldığında, /Setdeğişiklikleri propertyPathbağımsız değişkeni belirtilen değere. Birden çok /Setseçenekler belirtilebilir. Kullanmaya ek olarak /Setseçeneği ile /F[ile]seçeneğini de kullanabilirsiniz /Setseçeneği ile /ISServerseçeneğini ya da /Projectseçeneği. Kullandığınızda /Setile /Project, /Setparametre değerlerini ayarlar. Kullandığınızda /Setile /ISServer, /Setözellik geçersiz kılmalarının ayarlar. Ayrıca kullandığınızda /Setile /ISServer, mülk üzerinde hassas değerlendirilmelidir belirtmek için isteğe bağlı $hassas öneki kullanabilirsiniz Integration Servicessunucu. Değerini belirlemek için propertyPathpaketi Yapılandırma Sihirbazı'nı çalıştırarak. Seçtiğiniz öğeler için yollar üzerinde son görüntülenir Sihirbazı Tamamlanıyor sayfa ve kopyalanıp yapıştırılabilir. Sadece bu amaç için sihirbaz kullandıysanız, yolları kopyaladıktan sonra Sihirbazı iptal edebilirsiniz. Dosya sistemi kaydedilmiş bir paketi yürütme ve yeni bir değer için bir değişken sağlayan bir örnek şudur: dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue Dosya ve ayar paketi ve Proje parametreleri .ispac projeden bir paketi çalıştıran ve aşağıdaki örnek. /Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1 Sen-ebilmek kullanma /Sethangi paketi yapılandırmaları yüklenir konumu değiştirmek için seçenek. Ancak, sen cant'kullanma /Settasarım zamanında bir yapılandırma tarafından belirtilen değeri geçersiz kılmak için seçeneği. Bkz: Paket yapılandırmalarını nasıl uygulandığını anlamak için Paketi yapılandırmalarıve SQL Server 2012 Integration Services özellikleri davranışı değişiklikleri. |
/Ser[ver] server |
(İsteğe bağlı). Ne zaman /SQLya /DTSseçeneği belirtilirse, bu seçenek paketi almak için sunucudan belirtir. Atlarsanız /Serverseçeneği ve /SQLya /DTSseçeneği belirtilirse, paketi yürütme çalıştı ve yerel sunucuya karşı. server_instanceDeğeri kote. /Ser[ver]Seçenek gerekli ne zaman /ISServerseçeneği belirtilmişse. |
/SQ[L] package_path |
Depolanan bir paketi yükler SQL Server, msdbveritabanı. Saklanan paketler msdbveritabanı, eski paketi dağıtım modeli kullanılarak dağıtılan. İçin dağıtılan paketleri çalıştırmak için Integration Servicesserver kullanımı projesi dağıtım modeli kullanarak /ISServerseçeneği. Proje ve paketi dağıtım modelleri hakkında daha fazla bilgi için bkz: Projeler ve paketlerin dağıtımı. package_pathBağımsız paketi almak için adını belirtir. Klasör yolu varsa, onlar ile ters eğik çizgi ("\") sonlandırılır. package_pathDeğeri teklif. Yol veya dosya adı belirtilen package_pathbağımsız değişkeni boşluk içeriyorsa, tırnak koymak gerekir package_pathdeğişkeni. Sen-ebilmek kullanma /User, /Password, ve /Serverile birlikte seçenekleri /SQLseçeneği. Atlarsanız /Userseçeneği, Windows kimlik doğrulaması paketi erişmek için kullanılır. Eğer sen kullanma /Userseçeneği, /Userbelirtilen oturum açma adı ile ilişkili SQL Serverkimlik. /PasswordSeçeneği yalnızca birlikte kullanılırsa /Userseçeneği. Eğer sen kullanma /Passwordseçeneği, paketi erişim sağlanan kullanıcı adı ve parola bilgileri ile. Atlarsanız /Passwordseçeneği, boş bir parola kullanılır. Güvenlik Notu
Mümkünse Windows Kimlik Doğrulaması kullanın.
Eğer /Serverseçeneği belirtilmemişse, varsayılan yerel örneği SQL Servervarsayılır. /SQLSeçeneği ile birlikte kullanılamaz /DTSya /Fileseçeneği. Birden fazla seçenek belirtilmezse, dtexecbaşarısız. |
/Su[m] |
(İsteğe bağlı). Sonraki bileşeni tarafından alınan satır sayısını içeren artan bir sayaç gösterir. |
/U[ser] user_name |
(İsteğe bağlı). Tarafından korunan bir paket alınmasını sağlayan SQL Serverkimlik. Bu seçenek kullanılır yalnızca /SQLseçeneği belirtilmişse. user_nameDeğeri teklif. Güvenlik Notu
Mümkünse Windows Kimlik Doğrulaması kullanın.
|
/Va[lidate] |
(İsteğe bağlı). Paketi yürütme sonrasında validatation aşamasında, aslında paketi çalıştırmadan durur. Doğrulama sırasında kullanım /WarnAsErrorseçenek neden dtexecbir uyarı olarak hata; tedavi doğrulama sırasında uyarı oluşursa, bu nedenle paket başarısız olur. |
/VerifyB[uild] major[;minor[;build]] |
(İsteğe bağlı). Bir paketi doğrulama aşamasında belirtilmiş yapı numaraları karşı yapı numarasını doğrular major, minor, ve buildargümanları. Uyuşmazlık ortaya çıkarsa, paket yürütmez. Uzun tamsayıları değerlerdir. Bağımsız değişken değeri için üç formları biri olabilir majorher zaman gereklidir:
|
/VerifyP[ackageID] packageID |
(İsteğe bağlı). Belirtilen değeri karşılaştırarak yürütülecek paketi GUID doğrular package_iddeğişkeni. |
/VerifyS[igned] |
(İsteğe bağlı). Neden Integration Servicespaketi dijital imzasını kontrol. Paket imzalanmamışsa veya imza geçersiz paket başarısız olur. Daha fazla bilgi için, bkz. Dijital imzalarla paketleri kaynak belirle. Önemli
Paketi imzayı denetlemek için yapılandırıldığında Integration Servicesyalnızca dijital imza varsa, geçerli ve güvenilir bir kaynaktan geldiğinden denetler.Integration ServicesPaket değiştirilmiş olup olmadığını denetlemez.
Not
İsteğe bağlı BlockedSignatureStateskayıt defteri değeri sayısal imza seçeneğini daha kısıtlayıcı olan ayar kümesine belirtebilirsiniz SQL Server Veri Akışı Araçları (SSDT)ya da dtexeckomut satırından.Bu durumda, daha kısıtlayıcı olan kayıt defteri ayarını, diğer ayarları geçersiz kılar.
|
/VerifyV[ersionID] versionID |
(İsteğe bağlı). Belirtilen değeri karşılaştırarak yürütülecek bir paket GUID sürümünü doğrular version_idbağımsız paketi doğrulama aşaması sırasında. |
/VLog[Filespec] |
(İsteğe bağlı). Tüm Tümleştirme Hizmetleri paketi olayları paketi tasarlarken etkin olan günlük sağlayıcıları için yazıyor. Tümleştirme Hizmetleri günlük sağlayıcı metin dosyaları için etkinleştirmek ve olayları belirtilen metin dosyasına yazmak için bir yol ve dosya adı dahil Filespecparametresi. Değil eklerseniz, Filespecparametresi, Tümleştirme Hizmetleri metin dosyaları için günlük sağlayıcı etkinleştirme. Tümleştirme Hizmetleri yalnızca paket tasarlarken etkin olan günlük sağlayıcıları için günlük olayları yazacak. |
/W[arnAsError] |
(İsteğe bağlı). Uyarı hata olarak düşünün için paketi neden olur; Bu nedenle, bir uyarı doğrulama sırasında oluşursa paketi başarısız olur. Hiçbir uyarı doğrulama sırasında oluşursa ve /Validateseçenek belirtilmezse, paket yürütülür. |
/X86 |
(İsteğe bağlı). Neden SQL ServerPaketi 32-bit modunda 64-bit bir bilgisayarda çalıştırmak için ajan. Bu seçeneği ayarlamak SQL ServerAşağıdaki koşullar doğru olduğunda Aracısı:
Bu seçenek için belirlediğiniz da bir SQL ServerAracısı iş adımı kullanarak saklı yordamlar veya program aracılığıyla iş oluşturmak için SQL Server Management Objects (smo). Bu seçenek yalnızca tarafından kullanılan SQL Serverajan. Eğer sen koşmak bu seçenek yoksayılır dtexechizmet programı komut isteminde. |
Açıklamalar
Komut seçeneklerini belirtmek sipariş paket içinde yürütür biçimini etkileyebilir:
Seçenek, komut satırına karşılaşılan sırayla işlenir. Komut dosyaları gibi komut satırında karşılaşılan okumak. Komut dosyası komutları da onlar karşılaştı sırayla işlenir.
Aynı seçeneği, parametre veya değişken aynı komut satırı deyimi içinde birden çok kez görünüyorsa, seçeneği son örneği önceliklidir.
/Setve /ConfigFileseçenekleri, onlar karşılaştı sırayla işlenir.
Örnekler
Aşağıdaki örnek, nasıl kullanılacağını gösterir dtexecyapılandırmak ve çalıştırmak için komut istemi yardımcı programını SQL Server Integration Servicespaketleri.
Çalışan paketleri
Yürütülecek bir SSISpaket kaydedilen SQL ServerWindows kimlik doğrulaması kullanarak aşağıdaki kodu:
dtexec /sq pkgOne /ser productionServer
dtexec /sq pkgOne /ser productionServer
Yürütülecek bir SSISpaket kaydedilen dosya sistem klasörünün SSIS paketi depo, şu kodu kullanın:
dtexec /dts "\File System\MyPackage"
dtexec /dts "\File System\MyPackage"
Windows kimlik doğrulaması kullanır ve kaydedilmiş bir paketi doğrulamak için SQL Serverpaketi yürütme olmadan şu kodu kullanın:
dtexec /sq pkgOne /ser productionServer /va
dtexec /sq pkgOne /ser productionServer /va
Yürütülecek bir SSISDosya sistemi kaydedilmiş bir paket kullanın aşağıdaki kodu:
dtexec /f "c:\pkgOne.dtsx"
dtexec /f "c:\pkgOne.dtsx"
Yürütülecek bir SSISPaket dosya sistemi kaydedilmiş ve günlük seçeneklerini belirleme, şu kodu kullanın:
dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"
dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"
Windows kimlik doğrulaması kullanır ve varsayılan yerel örneğine kaydedilen bir paketi çalıştırmak için SQL Serverve onu yürütülmeden önce sürümü doğrulayın, şu kodu kullanın:
dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}
dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}
Yürütülecek bir SSISDosya sistemi kaydedilmiş ve yapılandırılmış paket dışarıdan, şu kodu kullanın:
dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"
dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"
[!NOT]
package_pathYa filespec/ SQL, / DTS veya FILE seçenekleri bağımsız gerekir içine tırnak yol veya dosya adı boşluk içeriyorsa. Bağımsız değişken tırnak içine alınmamış, bağımsız değişkeni boşluk içeremez.
Günlüğe kaydetme seçeneği
Eğer üç günlük giriş türlerini a, b ve c, şu ConsoleLogseçeneği olmadan bir parametre tüm üç günlük türleri ile tüm alanları görüntüler:
/CONSOLELOG
/CONSOLELOG
Aşağıdaki seçenek görüntüler tüm günlük türleri, ama sadece adı ve ileti sütunlar:
/CONSOLELOG NM
/CONSOLELOG NM
Tüm sütunları aşağıdaki seçenek görüntüler, ancak yalnızca günlük girdisi a: yazın
/CONSOLELOG I;LogEntryTypeA
/CONSOLELOG I;LogEntryTypeA
Aşağıdaki seçenek, sadece günlük giriş a tipi, sütun adı ve ileti görüntüler:
/CONSOLELOG NM;I;LogEntryTypeA
/CONSOLELOG NM;I;LogEntryTypeA
Aşağıdaki seçenek günlük giriş türlerini a ve b: günlük girdilerini görüntüler
/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB
/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB
Çoklu kullanarak aynı sonuçları elde edebilirsiniz ConsoleLogseçenekleri:
/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB
/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB
Eğer ConsoleLogseçenek komutu parametresiz kullanıldığında, tüm alanlar görüntülenir. Dahil bir list_optionsparametresi nedenleri şu şekilde görüntüler yalnızca oturum girişi tip A, tüm alanları:
/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG
/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG
Aşağıdaki girdi türü olduğunu a: oturum dışında tüm günlük girdilerini görüntüler, günlük giriş türlerini b ve c: görüntüler
/CONSOLELOG E;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA
Aşağıdaki örnek, birden fazla kullanarak aynı sonuçları elde ConsoleLogseçenekleri ve tek bir dışlama:
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA
Aşağıdaki örnek, bir günlük dosyası türü de eklenen ve dışlanan listeleri bulunduğunda dışlanır çünkü hiçbir günlük iletileri görüntüler.
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA
set seçenek
Aşağıdaki örnek, nasıl kullanılacağını gösterir /SETkomut satırından paketi başlattığınızda herhangi bir paket özelliği ya da değişken değerlerini değiştirmenizi sağlar seçeneği.
/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue
/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue
Proje seçeneği
Aşağıdaki örnek, nasıl kullanılacağını gösterir /Projectve /Packageseçeneği.
/Project c:\project.ispac /Package Package1.dtsx
/Project c:\project.ispac /Package Package1.dtsx
Aşağıdaki örnek, nasıl kullanılacağını gösterir /Projectve /Packageseçenekleri ve paketi ve proje parametrelerini.
/Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1
/Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1
ISServer seçeneği
Aşağıdaki örnek, nasıl kullanılacağını gösterir /ISServerseçeneği.
dtexec /isserver "\SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "."
dtexec /isserver "\SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "."
Aşağıdaki örnek, nasıl kullanılacağını gösterir /ISServerseçeneğini ve proje ve Bağlantı Yöneticisi parametrelerini ayarlamak.
/Server localhost /ISServer “\SSISDB\MyFolder\Integration Services Project1\Package.dtsx” /Par "$Project::ProjectParameter(Int32)";1 /Par "CM.SourceServer.InitialCatalog";SourceDB
/Server localhost /ISServer “\SSISDB\MyFolder\Integration Services Project1\Package.dtsx” /Par "$Project::ProjectParameter(Int32)";1 /Par "CM.SourceServer.InitialCatalog";SourceDB
ilişkili Görevler
Yapılandırma ve paketleri çalıştırmak için dtExec kullanma