dtutil yardımcı programı (SSIS aracı)
The dtutil command prompt utility is used to manage SQL Server Integration Services packages.Yardımcı programı kopyalamak, taşımak, silmek veya paket var olup olmadığını doğrulayın.Bu eylemlerden herhangi üzerinde gerçekleştirilebilir SSIS üç konumlardan birinde depolanmış olan paket: a Microsoft SQL Server database, the SSIS Package Store, and the file system.paket depolama türü olarak tanımlanan /SQL, /FILE, ve /DTS seçenekleri.
Not
Dtutil tarafından gerçekleştirilen operasyonların birçoğu da görsel olarak gerçekleştirilebilir SQL Server Management Studio bağlı olduğunuzda için bir örnek , Integration Services.Daha fazla bilgi için bkz: Paketlerini yönetme.
Seçeneklerden herhangi bir sırada yazılabilir.Kanal ("|") bir karakter OR işleç ve olası değerler. göstermek için kullanılanTarafından sınırlanmış seçeneklerinden birini kullanın OR kanal.
Tüm seçenekler, eğik çizgi (/) ya da eksi işareti (-) ile başlamalıdır.Ancak, eğik çizgi işareti veya eksi işareti ve seçeneği için metin arasına bir boşluk ekleyin; Aksi durumda, komut başarısız olur.
Bağımsız değişkenler, ya da kapalı, tırnak işaretleri veya beyaz boşluk içeren dizeler olmalıdır.
Çift tırnak, tırnak içine alınmış dizeler içinde Kaçýrýlmýþ tek tırnak temsil eder.
Seçenekleri ve bağımsız değişkenleri, dışında parolalar, durum duyarlı değildir.
SSIS araçlarının 64 bit bilgisayarlarda yükleme hakkında önemli noktalar
64-Bit bilgisayarda Integration Services 64-bit sürüm yükler dtexec yardımcı (dtexec.exe) ve dtutil yardımcı programını (dtutil.exe).Bu 32-bit sürümleri yüklemeye Integration Services Araçlar, her iki istemci araçları seçmelisiniz veya Business Intelligence Development Studio sırasında Kur.
Varsayılan olarak, bir 64-bit bilgisayar olan her iki 64-bit ve 32-bit sürümleri bir Integration Services komut istemi yardımcı programı yüklü komut istemi. 32-bit sürüm çalıştırır32-Bit sürüm 32-bit sürüm için dizin yol önce 64 bit sürüm için dizin yolunu yol ortam değişkeninde göründüğü için çalışır.(Genellikle, 32-bit dizin yol. <sürücü>: \Program Files (x 86) \Microsoft SQL Server\100\DTS\Binn, 64-bit dizin yol olmakla <sürücü>: \Program Files\Microsoft sql Server\100\DTS\Binn.)
Not
Yardımcı programı çalıştırmak için sql Server Agent'ı kullanıyorsanız, sql Server Agent otomatik olarak yardımcı programı 64-bit sürüm kullanır.sql Server Agent yardımcı programının doğru yürütülebilir dosyayı bulmak için değil yol ortam değişkeni, kayıt defterini kullanır.
Komut istemi yardımcı programı 64-bit sürüm ç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 içeren dizini değiştirin ()<sürücü>: \Program Files\Microsoft sql Server\100\DTS\Binn), ve yardımcı program o konuma. çalıştırın
Tam yolunu girerek yardımcı programı komut istemi isteminde çalıştırın (<sürücü>: \Program Files\Microsoft sql Server\100\DTS\Binn) 64-bit sürüm yardımcı programı.
Kalıcı olarak 64 bit yol koyarak path ortam değişkeninde yolları sırasını değiştirme (<sürücü>: \Program Files\Microsoft sql Server\100\DTS\Binn) 32-bit yol önce (<sürücü>: \ Program Files (x 86) \Microsoft SQL Server\100\DTS\Binn) değişken.
Sözdizimi
dtutil /option [value] [/option [value]]...
Parametreler
Seçenek |
Açıklama |
|---|---|
/? |
Komut istemi seçeneklerini görüntüler. |
/c [opy] location;destinationPathandPackageName |
Kopyalama eylem belirtir bir SSIS paket.Bu parametrenin kullanılması gerekir ilk konumunu belirtmek paket kullanarak /FI, /sq, veya /dt seçeneği.Ardından, hedef konumun hedef paket adı belirtin.The destinationPathandPackageName argument specifies where the SSIS package is copied to.Hedef location olan SQL, DestUser, DestPassword ve DestServer bağımsız değişkenleri de belirtilmesi gerekir komut. Zaman Copy Eylem sırasında var olan bir paketi karşılaştığı hedef, dtutil paket silme işlemini onaylamanızı ister.The Y reply overwrites the package and the N reply ends the program.Ne zaman komut içeren Quiet bağımsız değişkeni, hiçbir istem görüntülenir ve varolan paket üzerine. |
/ Dec [rypt] password |
(İsteğe bağlı).Parola şifreleme ile paket yüklediğinizde, kullanılan şifre çözme parola ayarlar. |
/ Del [Sil] |
Tarafından belirtilen paket siler SQL, DTS veya FILE seçeneği.If dtutil cannot delete the package, the program ends. |
/ DestP [arolayı] password |
sql seçeneği ile bir hedef bağlanmak için kullanılan parolayı belirtir SQL Server örnek kullanarak SQL Server kimlik doğrulaması.Bir hata oluşturulur DESTPASSWORD içeren bir komut satırında belirtilen DTSUSER seçeneği. .gif "Not") Not
Mümkünse Windows Kimlik Doğrulaması kullanın..
|
/ DestS [unucu] server_instance |
Belirtir sunucu adı neden olan bir hedef için kaydedilmesi herhangi bir eylem ile kullanılan SQL Server.Yerel olmayan veya varsayılan olmayan bir sunucuya kaydederken tanımlamak için kullanılan bir SSIS paket.Belirtmek için bir hata olduğu DESTSERVER , yok bir eylem ile ilişkili bir komut satırında SQL Server.Eylemler gibi SIGN SQL, COPY SQL, veya MOVE SQL ile birleştirmek için uygun komutları seçenekleri olacakbu seçenek. A SQL Server örnek adı bir ters eğik çizgi ve örnek adı için ekleyerek belirtilebilir sunucu adı. |
/ DestU [ullanıcı] username |
İle kullanılacak kullanıcı adını belirtir SIGN SQL, COPY SQL, ve MOVE SQL bağlanmak için seçenekleri bir SQL Server kullanan örnek SQL Server kimlik doğrulaması.Belirtmek için bir hata olduğu DESTUSER de içeren bir komut satırı SIGN SQL, COPY SQL, veya MOVE SQL seçeneği. |
/ Döküm process ID |
(İsteğe bağlı) Belirtilen işlem ya da neden olan dtexec yardımcı programını veya dtsDebugHost.exe işlemini duraklatmak ve hata ayıklama oluşturmak için döküm dosyaları, .mdmp ve .tmp. Not
Kullanmak için /Döküm seçeneği, atanmalıdır hata ayıklama programları kullanıcı hakkı (SeDebugPrivilege).
Bulmak için process ID duraklatma, kullanin Windows Görev Yöneticisi yapmak istediğiniz işlem için Varsayılan olarak, Integration Services hata ayıklama depolar döküm klasöründeki dosyaları <sürücü>: \Program Files\Microsoft sql Server\100\Shared\Errordöküms. Hakkında daha fazla bilgi için dtexec yardımcı programını ve dtsDebugHost.exe işlemek için bkz: dtexec yardımcı programı (SSIS aracı) ve Oluşturma, dağıtma ve özel nesneler hata ayıklama. Hata ayıklama hakkında daha fazla bilgi için döküm dosyaları Bkz: Debug döküm dosyaları ile çalışma. Not
Debug 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.
|
/DT [S] filespec |
Belirleyen bir SSIS paket üzerinde işletilen bulunur SSIS Paket Deposu.The filespec argument must include the folder path, starting with the root of the SSIS Package Store.Varsayılan olarak, bir kök klasör adlarını yapılandırma dosyası olan "msdb" ve "Dosya sistemi." Boşluk içeren yollar tırnak işareti kullanarak sınırlanması gerekir. Aşağıdaki seçenekleri olarak aynı komut satırında dt [s] seçeneği belirtilirse, bir dtexec_dtexecerror döndürülür:
|
[Şifreli] /en {SQL | FILE}; Path;ProtectionLevel[;password] |
(İsteğe bağlı).Yüklenen paket belirtilen koruma düzey ve parolayla şifreler ve belirtilen konuma kaydeder Path.The ProtectionLevel determines whether a password is required.
ProtectionLevel Seçenekler: Düzey 0: Hassas bilgileri çıkartır. Düzey 1: Yerel kullanıcı kimlik bilgileri bilgilerini kullanarak duyarlı bilgileri şifrelenir. Düzey 2: Gerekli parola kullanarak duyarlı bilgileri şifrelenir. Düzey 3: Paket gerekli parola kullanılarak şifrelenir. Düzey 4: Yerel kullanıcı kimlik bilgileri bilgilerini kullanarak paket şifrelenir. Düzey 5 paket kullanır SQL Server Depolama şifreleme. |
/Ex [ists] |
(İsteğe bağlı).Used to determine whether a package exists.dtutil tries to locate the package specified by either the SQL, DTS or FILE options.If dtutil cannot locate the package specified, a DTEXEC_DTEXECERROR is returned. |
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName |
(İsteğe bağlı).Belirtilen ada sahip yeni bir klasör oluşturmak NewFolderName.Yeni klasörün konumu belirtilir ParentFolderPath. |
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] |
(İsteğe bağlı).Siler SQL Server veya SSIS klasörü adı belirtildi FolderName.Delete klasörünün konumu belirtilir ParentFolderPath. |
/ FDI [rectory] {SQL | DTS};FolderPath[;S] |
(İsteğe bağlı).Klasörleri ve klasör içinde paketler hem içeriği listeleri SSIS veya SQL Server.İsteğe bağlı FolderPath parametresi içeriği görüntülemek istediğiniz klasörü belirtir.İsteğe bağlı S parametresi belirtir istediğiniz alt öğesinde belirtilen klasörün içeriğini bir listesini görüntülemek FolderPath. |
/FE[xists ] {SQL | DTS};FolderPath |
(İsteğe bağlı).Belirtilen klasör üzerinde olup olmadığını doğrular SSIS veya SQL Server.The FolderPath parameter is the path and name of the folder to verify. |
/Fi [le] filespec |
Bu seçenek belirleyen bir SSIS işletilen paket bulunduğu dosya sistemi.The filespec value can be provided as either a Universal Naming Convention (UNC) path or local path. If the File option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:
|
/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] |
(İsteğe bağlı).Bir klasörü yeniden adlandırır, SSIS veya SQL Server.The ParentFolderPath is the location of the folder to rename.The OldFolderName is the current name of the folder, and NewFolderName is the new name to give the folder. |
/h [elp] option |
Gösteren kapsamlı Yardım metni görüntüler dtutil seçenekleri ve kullanımları açıklanmıştır.Seçenek bağımsız değişkeni isteğe bağlıdır.Bağımsız değişken varsa, Yardım metni belirtilen seçenek hakkında ayrıntılı bilgi içerir.Aşağıdaki örnek, tüm seçenekler için Yardım görüntüler. dtutil /H Aşağıdaki iki örnek, nasıl kullanılacağını göster /H belirli bir seçenek için genişletilmiş Yardım'ı görüntülemek için seçeneği /Q [uiet] Bu örnekte seçenek: dtutil /Help Quiet dtutil /H Q |
/I [DRegenerate] |
Paket için yeni bir GUID oluşturur ve paket kimliği güncelleştirmeleri özellik.Bir paketi kopyalandığında, paket kimliği aynı kalır; Bu nedenle, günlük dosyaları her iki paket için aynı GUID içeriyor.Bu eylem, orijinalden ayırt etmek için yeni kopyalanan paket için yeni bir GUID oluşturur. |
/M[ove] {SQL | File | DTS}; pathandname |
Bir taşıma belirtir eylem üzerinde bir SSIS paket.Bu parametre kullanmak için öncelikle konumunu paket kullanarak /FI, /sq, veya /dt seçeneği.Daha sonra belirttiğiniz Taşı eylem.Bu eylem, noktalı virgülle ayrılmış iki bağımsız değişken gerektirir:
Zaman Taşı eylem sırasında var olan paket karşılaştığı hedef, dtutil , paket üzerine yazmak istediğinizi onaylamanızı ister.The Y reply overwrites the package and the N reply ends the program.Ne zaman komut içeren QUIET seçenek, hiçbir istem görüntülenir ve varolan paket üzerine. |
/q [uiet] |
Komut ekleme yaparken görüntülenen onay istemleri durur COPY, MOVE, veya SIGN seçenek yürütüldüğünde.Belirtilen paketi hedef bilgisayarda zaten var veya belirtilen paketi ise aynı ada sahip bir paket imzalı, bu istemleri görüntülenir. |
/r [emark] text |
Komut satırı için bir açıklama ekler.Yorum bağımsız değişkeni isteğe bağlıdır.Yorum metin boşluk içeriyorsa, metni tırnak işaretleri içine alınmalıdır.Bir komut satırında birden fazla rem seçenekler içerebilir. |
/Si[gn] {SQL | File | DTS}; path; hash |
İşaretleri bir SSIS paket.Bu eylem, noktalı virgüllerle ayrılmış üç gerekli değişkenleri kullanır:
Daha fazla bilgi için bkz: Sayısal imzaları paketleri ile kullanma. .gif "Önemli not") Önemli
When configured to check the signature of the package, Integration Services only checks whether the digital signature is present, is valid, and is from a trusted source.Integration Services does not check whether the package has been changed.
|
/ SourceP [arolayı] password |
İle kullanılan parolayı belirtir SQL ve SOURCEUSER alınmasını etkinleştirmek için seçenekler bir SSIS üzerindeki bir veritabanında depolanan paket bir SQL Server kullanan örnek SQL Server kimlik doğrulaması.Belirtmek için bir hata olduğu SOURCEPASSWORD de içeren bir komut satırı SOURCEUSER seçeneği. Not
Mümkünse Windows Kimlik Doğrulaması kullanın.
|
/ Kaynakları [unucu] server_instance |
Belirtir sunucu adı ile kullanılan SQL alınmasını etkinleştirmek için seçenek bir SSIS paket içinde saklanan SQL Server.It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option. A SQL Server örnek adı bir ters eğik çizgi ve örnek adı için ekleyerek belirtilebilir sunucu adı. |
/ SourceU [ullanıcı] username |
İle kullanılacak kullanıcı adını belirtir SOURCESERVER alınmasını etkinleştirmek için seçenek bir SSIS paket saklanan SQL Server kullanarak SQL Server kimlik doğrulaması.Belirtmek için bir hata olduğu SOURCEUSER de içeren bir komut satırı SIGN SQL, COPY SQL, veya MOVE SQL seçeneği. Not
Mümkünse Windows Kimlik Doğrulaması kullanın.
|
/SQ [M] package_path |
Konumunu belirtir bir SSIS paket.Bu seçeneği, paket depolanır gösterir msdb veritabanı.The package_path argument specifies the path and name of the SSIS package.Klasör adlarını ters eğik çizgi ile biter. If the SQL option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:
If SOURCEUSERNAME is not included, Windows Authentication is used to access the package.SOURCEPASSWORD is allowed only if SOURCEUSER is present.If SOURCEPASSWORD is not included, a blank password is used. Önemli
Boş parola kullanmayın. Güçlü bir parola kullanın.
|
dtutil (SSIS aracı): Çıkış kodları
dtutil , sözdizimi hataları algılanır, değişkenler yanlış kullanılıyor veya seçenekleri geçersiz birleşimleri belirtilmiş uyarır Çıkış kodu ayarlar.Aksi takdirde, yardımcı program "işlemi başarıyla tamamlandı" bildirir.Aşağıdaki tablo değerleri listeler, dtutil yardımcı programını çıkarken ayarlayabilirsiniz.
Değer |
Açıklama |
|---|---|
0 |
Yardımcı programı başarıyla yürütüldü. |
1 |
Yardımcı programı başarısız oldu. |
4 |
Hizmet programı istenen paket bulamıyor. |
5 |
Hizmet programı istenen paket yüklenemiyor |
6 |
Sözdizimi veya anlamsal hatalar olduğundan komut satırı yardımcı programı çözümlenemiyor. |
Açıklamalar
Komut dosyaları veya yeniden yönlendirme'yi kullanamazsınız dtutil'i.
Komut satırı seçeneklerini sırası önemli değildir.
dtutil (SSIS aracı): Örnekler
Aşağıdaki örnekler komut satırı normal kullanım senaryoları ayrıntılı olarak açıklanmaktadır.
dtutil (SSIS aracı): Copy örnekleri
Depolanan paket kopyalamak için msdb bir yerel veritabanı örnek , SQL Server için SSIS paket deposu, Windows kimlik doğrulaması kullanarak, aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /COPY DTS;destFolder\destPackage
Paket dosya sistemi üzerindeki bir konumdan başka bir konuma kopyalayın ve kopyayı farklı bir ad vermek için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\myPackages\mypackage.dtsx /COPY FILE;c:\myTestPackages\mynewpackage.dtsx
Yerel dosya sisteminde bir paket kopyalamak için bir örnek , SQL Server başka bir bilgisayarda bulunan, aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\sourcepkg.dtsx /DestServer <servername> /COPY SQL;destpkgname
Çünkü /DestU[ser] ve /DestP[assword] seçenekleri kullanılmış değil, Windows kimlik doğrulaması kabul edilir.
Kopyalanır sonra bir paket için yeni bir kimlik oluşturmak için aşağıdaki sözdizimini kullanın:
dtutil /I /FILE copiedpkg.dtsx
Belirli bir klasördeki tüm paketleri için yeni bir kimlik oluşturmak için aşağıdaki sözdizimini kullanın:
for %%f in (C:\test\SSISPackages\*.dtsx) do dtutil.exe /I /FILE %%f
komut istemi istemine komutu yazarken tek bir yüzde işareti (%) kullanın.Komutu bir toplu iş dosyası içinde kullanıldığında, çift yüzde işareti (%) kullanın.
dtutil (SSIS aracı): Örnek silme
Depolanan paket silmek için msdb veritabanı üzerinde bir örnek , SQL Server , Windows kimlik doğrulaması kullanıyorsa, aşağıdaki sözdizimini kullanın:
dtutil /SQL delPackage /DELETE
Depolanan paket silmek için msdb veritabanı üzerinde bir örnek , SQL Server kullanan SQL Server kimlik doğrulaması, aşağıdaki sözdizimini kullanın:
dtutil /SQL delPackage /SOURCEUSER srcUserName /SOURCEPASSWORD #8nGs*w7F /DELETE
Not
Adlandırılmış bir sunucudan paket silmek için SOURCESERVER seçenek ve kendi bağımsız değişkeni.Yalnızca bir sunucu kullanarak belirtebileceğiniz SQL seçeneği.
İçinde SSIS paket depo depolanan paket silmek için aşağıdaki sözdizimini kullanın:
dtutil /DTS delPackage.dtsx /DELETE
Dosya sisteminde depolanan paket silmek için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\delPackage.dtsx /DELETE
dtutil (SSIS aracı): Örnekleri var
Bir paket içinde var olup olmadığını belirlemek için msdb bir yerel veritabanı örnek , SQL Server , Windows kimlik doğrulaması kullanıyorsa, aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /EXISTS
Bir paket içinde var olup olmadığını belirlemek için msdb bir yerel veritabanı örnek , SQL Server kullanan SQL Server kimlik doğrulaması, aşağıdaki sözdizimini kullanın:
dtutil SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD *hY$d56b /EXISTS
Not
Adlandırılmış bir sunucu üzerinde paket var olup olmadığını belirlemek için SOURCESERVER seçenek ve kendi bağımsız değişkeni.sql seçeneğini kullanarak yalnızca bir sunucu belirtebilirsiniz.
Bir paketi Yerel Paket deposunda var olup olmadığını belirlemek için aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /EXISTS
Yerel dosya sistemindeki paket var olup olmadığını belirlemek için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\srcPackage.dtsx /EXISTS
dtutil (SSIS aracı): Örnekler taşıma
İçin SSIS paketi depo depolanan bir paket taşımak için msdb bir yerel veritabanı örnek , SQL Server , Windows kimlik doğrulaması kullanıyorsa, aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /MOVE SQL;destPackage
Depolanan bir paket taşımak için msdb bir yerel veritabanı örnek , SQL Server kullanan SQL Server kimlik msdb başka bir yerel veritabanı örnek , SQL Server kullanan SQL Server kimlik doğrulaması, aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD $Hj45jhd@X /MOVE SQL;destPackage /DESTUSER destUserName /DESTPASSWORD !38dsFH@v
Not
paket adlandırılmış bir sunucudan diğerine taşımak için dahil SOURCES ve DESTS seçenek ve kendi bağımsız değişkenleri.Yalnızca kullanarak sunucuları belirtebilirsiniz SQL seçeneği.
İçinde SSIS paketi depo depolanan bir paket taşımak için aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /MOVE DTS;destPackage.dtsx
Dosya sisteminde depolanan bir paket taşımak için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\srcPackage.dtsx /MOVE FILE;c:\destPackage.dtsx
dtutil (SSIS aracı): Oturum örnekler
Depolanan paket imzalamak için bir SQL Server bir yerel veritabanı örnek , SQL Server , Windows kimlik doğrulaması kullanıyorsa, aşağıdaki sözdizimini kullanın:
dtutil /FILE srcPackage.dtsx /SIGN FILE;destpkg.dtsx;1767832648918a9d989fdac9819873a91f919
sertifika hakkında bilgi bulmak için kullanın CertMgr.Karma kodu görüntülenebilir CertMgr sertifika seçerek ve ardından tıklatarak yardımcı View özelliklerini görüntülemek için.The Details tab provides more information about the certificate.The Thumbprint property is used as the hash value, with spaces removed.
Not
Bu örnekte kullanılan karma gerçek karma değil.
CertMgr bölümünde daha fazla bilgi için bkz: imzalama ve Authenticode koduyla denetimi.
dtutil (SSIS aracı): Örnekleri şifrele
Aşağıdaki örnek, bir parola ile tam paket şifreleme kullanarak dosya tabanlı EncryptedPackage.dts için dosya tabanlı PackageToEncrypt.dtsx şifreler.Şifreleme için kullanılan parola EncPswd.
dtutil /FILE PackageToEncrypt.dtsx /ENCRYPT file;EncryptedPackage.dtsx;3;EncPswd
|
.gif "Integration Services simgesi (küçük)")
Integration Services ile güncel kalın