Цей розділ описує параметри командного рядка Database Tour, специфічні для відкриття баз даних та виконання деяких додаткових задач в них. Цей тип командного рядка може використовуватися лише в Database Tour Pro.
Див. також загальні правила написання командних рядків.
Ви можете почати з такого простого прикладу:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=dBase /DBKind=FOLDER "/DB=c:\MyData" "/TableName=customer.dbf"
Тут ви ви відкриваєте базу даних c:\MyData (тобто теку з файлами DBF) за допомогою інтерфейсу ADO, і потім відкриваєте таблицю customer.dbf з цієї бази даних.
Не хочете писати параметри вручну? Дивіться наступний розділ нижче і легко створіть командний рядок за допомогою графічного інтерфейсу Database Tour.
Або продовжуйте читати, щоб дізнатися про всі перемикачі та параметри.
Побудова командного рядка в кілька кліків
Використання
Опції командного рядка та їх опис
Приклади
Досвідчені користувачі можуть побудувати потрібну командний рядок вручну, використовуючи специфікацію нижче.
Але якщо ви початківець або хочете швидко побудувати командний рядок без занурення в деталі, використовуйте конструктор командних рядків Database Tour.
Класичний формат командного рядка
Командний рядок складається з усіх потрібних параметрів:
dbtour.exe /Parameter1 /Parameter2 /... /ParameterN
Скорочений формат командного рядка
Цей формат більш гнучкий, оскільки дозволяє тримати всі параметри в окремому файлі операцій. Командний рядок складається з параметра /ActionFile (що вказує шлях до файла операцій) та необов'язкового параметра /silent:
dbtour.exe [/silent] /ActionFile=ActionFileName
/OpenDB
Вказує програмі на необхідність відкрити певну базу даних і (опціонально) виконати деякі дії в ній.
/silent
Запуск програми в так званому "тихому" режимі, без будь-яких вікон. При використанні опції /ActionFile ключ /silent повинен бути поза файлом параметрів. Database Tour повертає код виходу 0 в разу успішного відпрацювання, 1 в разі некоректного командного рядка і 2 у випадку помилок виконання.
/ActionFile=Value
Ім'я
файла операцій, який включає параметри командного рядка (один параметр на рядок). Рядки, що починаються на крапку з комою, вважаються коментарем і ігноруються програмою. Допускаються пусті рядки. При використанні цього параметру в командному рядку не повинно бути інших параметрів, окрім ключа
/silent. Якщо назва файлу містить пробіли, візьміть весь параметр в лапки. Див.
приклад.
/UseParadoxPasswords=Value
Розділений крапкою з комою список паролів для таблиць Paradox (якщо планується виконувати дії з захищеними паролем таблицями Paradox). Може використовуватися лише разом з параметром /DBInterface=BDE.
/DB=Value
Назва бази даних, яку потрібно відкрити. Це може бути назва файлу, назва теки, назва джерела даних ODBC, назва аліасу BDE або рядок підключення ADO. Якщо назва містить пробіли, візьміть весь параметр в лапки. Якщо назва бази є рядком підключення ADO з лапками всередині, потрібно використовувати
скорочений формат командного рядка.
/DBInterface=Value
Інтерфейс для роботи з базами даних (движок баз даних), що буде використовуватися для відкриття бази даних. Можливі значення: ADO, FD, INTERBASE, BDE. Значення по замовчанню: ADO.
/DBKind=Value
Вид бази даних. Можливі значення: FOLDER, FILE, DSN, CONSTR; останній варіант можна використовувати лише для підключень ADO. Якщо не вказано, програма спробує визначити це автоматично.
Замість використання цього параметра можливо використовувати префікс, що вказує тип бази даних (файл, тека, DSN, рядок підключення), в параметрі /DB. Префікс повинен братися в квадратні дужки <>. Можливі значення: <FILE>, <FOLDER>, <DSN>, <CONSTR>. Рекомендується брати весь параметр в лапки у таких випадках. Див. приклад 9.
/DBDriver=Value
Драйвер (тип) бази даних. Приклади можливих значень: ACCESS, DBASE, INTERBASE, FIREBIRD, ORACLE, SQL SERVER і т.д. Якщо не вказано, програма спробує визначити це автоматично. Якщо назва драйвера містить пробіли, візьміть весь параметр в лапки.
/DBUserName=Value
Ім'я користувача бази даних. Якщо ім'я користувача містить пробіли, візьміть весь параметр в лапки.
/DBPassword=Value
Пароль бази даних. Якщо пароль містить пробіли, візьміть весь параметр в лапки.
/Server=Value
Адреса сервера для баз даних типу DB2, SQL Server, Advantage, Informix, Interbase, Firebird, MySQL, PostgreSQL, SQL Anywhere. Може використовуватися лише разом з параметром /DBInterface=FD.
/Port=Value
Порт TCP/IP, який слухає сервер DB2, Advantage, PostgreSQL, MySQL, Interbase або Firebird. Може використовуватися лише разом з параметром /DBInterface=FD.
/Protocol=Value
Протокол, що використовується для з'єднання з базою даних типу DB2, Firebird або Interbase. Може використовуватися лише разом з параметром /DBInterface=FD.
/OSAuthentication
Використовувати аутентифікацію ОС замість аутентифікації бази даних. Може використовуватися лише разом з параметром /DBInterface=FD.
/AutenticationMode=Value
Режим аутентифікації для бази даних Oracle. Можливі значення: Normal, SysDBA, SysOper і т.д. Більше інформації шукайте в документації Oracle. Може використовуватися лише разом з параметром /DBInterface=FD.
/VendorLibrary=Value
Шлях до клієнтської бібліотеки постачальника бази даних. Може використовуватися лише разом з параметром /DBInterface=FD.
/VendorHomepath=Value
Шлях до клієнтської домашньої директорії постачальника бази даних. Може використовуватися лише разом з параметром /DBInterface=FD.
/SystemDB=Value
Шлях до файлу системної бази даних для баз даних Access. Може використовуватися лише разом з параметром /DBInterface=FD.
/StringFormat=Value
Формат рядків для баз даних Access або SQLite. Можливі значення: Choose, Unicode, ANSI. Може використовуватися лише разом з параметром /DBInterface=FD.
/Charset=Value
Набір символів для баз даних Oracle, PostgreSQL, Informix, MySQL, Interbase, Firebird. Приклад: UTF8. Може використовуватися лише разом з параметром /DBInterface=FD.
/SharedCache=Value
Використовувати спільний кеш для баз даних SQLite чи ні. Можливі значення: False, True. Може використовуватися лише разом з параметром /DBInterface=FD.
/BlockingMode=Value
Режим блокування для баз даних SQLite. Можливі значення: Exclusive, Normal. Може використовуватися лише разом з параметром /DBInterface=FD.
/ReadOnly
Відкрити базу даних Access в режимі тільки читання. Може використовуватися лише разом з параметром /DBInterface=FD.
/TableName=Value
Ім'я таблиці для відкриття. Якщо цей параметр опущено, а база даних є файлом, програма спробує його витягти з /DB. Цей параметр не повинен використовуватися з ключем /silent. Якщо ім'я містить пробіли, візьміть весь параметр в лапки.
/SQLFile=Value
Ім'я файла, з якого потрібно завантажити текст SQL. Файл може містити багато виразів SQL; в такому разі різні вирази повинні бути розділені за допомогою /SQLStatementSeparator. Запит SQL з файлу буде виконаний лише якщо вказано ключ /ExecuteQuery. Цей параметр не повинен використовуватися з ключем /silent. Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.
/ExecuteQuery
Виконати код SQL з файлу, вказаного параметром /SQLFile.
/PrimaryDataset=Value
Якщо в командному рядку присутні одночасно параметри /TableName та /SQLFile, програма відкриє дві сторінки (закладки): одну для таблиці, іншу для запита. Даний ключ вказує програмі, яка з закладок повинна бути активною. Можливі значення: Table, Query.
/SQLStatementSeparator=SQLStatementSeparator
Розділювач (термінатор) виразів SQL для випадків, коли /SQLFile містить більше, ніж один вираз SQL. Це може бути будь-який символ або код символу з префіксом #. Є також наперед визначені розділювачі:
sqlplus, зазвичай використовується утилітою Oracle SQL Plus та іншими Oracle-орієнтованими інструментами та утилітами; це похила риска (/) на окремому рядку між двома виразами;
mssqlgo, зазвичай використовується інструментами SQL Server; це слово GO на окремому рядку між двома виразами.
Значення по замовчанню: крапка з комою (;).
/SQLParamNames=Value
Може використовуватися у випадках, коли
/SQLFile містить параметризований(і) запит(и) SQL. Текст SQL параметризованого запиту містить параметри для динамічної підстановки; кожен параметр починається з двокрапки, наприклад, :ITEMID, :PAYDATE і т.д. Обробка параметрів здійснюється на рівні движка бази даних або на рівні бази даних (для серверних баз даних). Використовуйте цей параметр для вказання списку імен параметрів SQL, які повинні бути автоматично замінені перед виконанням запиту. Цей список має складатися з імен параметрів (двокрапка тут повинна бути опущена), розділених комбінацією символів
%#%. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з параметрами
/SQLParamValues та
/SQLParamTypes. Див.
приклади.
/SQLParamValues=Value
Список значень параметрів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLParamNames. Для передачі значення null value потрібно писати NULL (у верхньому регістрі). Якщо параметр містить пробіли, він повинен братися в лапки.
/SQLParamTypes=Value
Список типів параметрів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLParamNames. Допустимі типи: Boolean, Currency, Date, DateTime, Float, Integer, SmallInt, String, Time, Word. Параметр не повинен містити пробілів.
/SQLMacroNames=Value
Список макросів SQL. Може використовуватися у випадках, коли
/SQLFile містить запит(и) SQL з макросами. Текст SQL таких запитів містить макроси для динамічної підстановки; кожен макрос починається з << і закінчується на >>, наприклад, <<ITEMID>>, <<PAYDATE>> і т.д.; на відміну від параметрів, макрос не має типу і завжди вставляється як текст. Використовуйте цей параметр для вказання списку імен макросів, які повинні бути автоматично замінені перед виконанням запиту. Цей список повинен містити список імен макросів (розділювачі << та >> тут повинні бути опущені; імена макросів мають складатися лише з букв та цифр), розділених комбінацією символів
%#%. Макроси обробляються перед обробкою параметрів SQL, тому можна використовувати макроси всередині параметрів SQL. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з параметром
/SQLMacroValues. Див.
приклади.
/SQLMacroValues=Value
Список значень макросів SQL, розділених комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /SQLMacroNames. Якщо параметр містить пробіли, він повинен братися в лапки.
/ReportVarNames=Value
Список глобальних
змінних звіту, чиї початкові значення повинні бути перезаписані. Якщо в списку більше одного елемента, то їх потрібно розділяти комбінацією символів
%#%. Якщо параметр містить пробіли, він повинен братися в лапки. Цей параметр повинен використовуватися разом з ключем
/ReportPreview.
/ReportVarValues=Value
Список початкових значень для глобальних змінних звіту. Якщо в списку більше одного елемента, то їх потрібно розділяти комбінацією символів %#%. Кількість елементів у списку та їх позиції повинні співпадати з параметром /ReportVarNames. Якщо параметр містить пробіли, він повинен братися в лапки.
/ClDefsFile=Value
Ім'я
файла з налаштуваннями колонок. Налаштування колонок будуть застосовані лише до закладки з активним набором даних (див. опис
/PrimaryDataset). Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.
/ReportTemplateFile=Value
Ім'я файла з шаблоном
звіту. В цьому контексті визначення бази даних і набору даних з шаблону звіту будуть проігноровані, а шаблон звіту буде застосовано до відкритого активного набору даних (див. опис
/PrimaryDataset). Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.
/NoReportBuilder
Не відкривати
конструктор звітів після завантаження
/ReportTemplateFile (пол замовчанню конструктор звітів
відкривається при завантаженні шаблона звіту).
/ReportPreview
Відкрити попередній перегляд звіту після завантаження /ReportTemplateFile.
/LogFile=Value
Ім'я файла для запису журналу операцій. Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.
/AppendLog
Журнал операцій повинен записуватися в кінець файла із збереженням попереднього вмісту файла. Якщо цей ключ опущено, існуючий журнал операцій буде перезаписано.
/OpenLog
Відкрити файл журналу після завершення. Повинен застосовуватися разом з параметром /LogFile.
/CloseWhenDone
Автоматично закрити програму після успішного виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.
/CloseOnError
Автоматично закритися у випадку помилки виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.
/minimize
Запуск програми в мінімізованому вікні. Вікно відновлюється до нормального стану у випадку помилки або після закінчення виконання (якщо опція /CloseWhenDone не використовується). Ця опція ігнорується в "тихому" режимі, коли програма працює без жодних вікон.
Відкриття бази даних Microsoft Access і завантаження текста SQL з файлу:
dbtour.exe /opendb "/DB=c:\my db\stores.mdb" "/SQLFile=c:\my db\TodaysPayments.sql"
Відкриття бази даних DBF на основі фізичної теки і відкриття таблиці в ній:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=dBase /DBKind=FOLDER "/DB=c:\MyData" "/TableName=customer.dbf"
Відкриття бази даних Oracle на основі джерела даних ODBC, завантаження скрипта SQL і відкриття таблиці з цієї бази:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=Oracle /DBKind=DSN "/DB=MyOraDSN" "/TableName=myschema.address_data" /SQLFile=d:\MyScripts\CopyData.sql /PrimaryDataset=Table
Відкриття бази даних Oracle на основі рядка підключення, виконання в ній скрипта SQL і закриття по закінченню:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=Oracle /DBKind=CONSTR "/DB=Provider=OraOLEDB.Oracle;Data Source=MyOracleDB;User Id=myUsername;Password=myPassword;" /DBUserName=JohnM /DBPassword=qazwsx78 /SQLFile=d:\MyScripts\CopyData.sql /ExecuteQuery /CloseWhenDone
Відкриття бази даних Interbase, виконання в ній скрипта SQL і закриття по закінченню:
dbtour.exe /opendb /DBInterface=INTERBASE /DBDriver=INTERBASE /DBKind=FILE "/DB=MyServerName:D:\CommonData\News.gdb" /DBUserName=JohnM /DBPassword=qazwsx78 /SQLFile=d:\MyScripts\CheckData.sql /ExecuteQuery /CloseWhenDone
Відкриття бази даних Interbase через ADO, відкриття запиту SQL в ній і завантаження шаблона звіту:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=INTERBASE /DBKind=FILE "/DB=MyServerName:D:\CommonData\News.gdb" /DBUserName=JohnM /DBPassword=qazwsx78 /SQLFile=d:\MyScripts\LastIncome.sql /ExecuteQuery /ReportTemplateFile=d:\MyReports\LastIncome.dtt
Відкриття таблиці Paradox і завантаження визначень колонок для неї:
dbtour.exe /opendb /DBInterface=BDE /DBDriver=Paradox /DBKind=FOLDER "/DB=c:\MyData" "/TableName=orders.db" "/ColDefsFile=c:\MyData\orders.dcl
Відкриття бази даних MySQL на основі рядка підключення:
dbtour.exe /opendb /DBInterface=ADO /DBDriver=MySQL /DBKind=CONSTR "/DBUserName=StacyO" "/DB=Provider=MySQLProv;Data Source=mydb;User Id=myUsername;Password=myPassword;"
Відкриття бази даних Oracle на основі джерела даних ODBC, завантаження і виконання скрипта SQL в ній і закриття по закінченню. У випадку помилки програма закривається. Журнал виконання зберігається в файл. Все повинно робитися в тихому режимі.
dbtour.exe /silent /opendb /DBInterface=ADO /DBDriver=Oracle "/DB=<DSN>MyOraDSN" /DBUserName=Bohdan2000 /DBPassword=tobein2010 /SQLFile=d:\MyScripts\UpdateProducts.sql /ExecuteQuery /SQLParamNames=PDate%#%PProdCategory%#%PProdChannel /SQLParamTypes=Date%#%Integer%#%String /SQLParamValues=2014-02-02%#%12%#%Direct /CloseWhenDone /CloseOnError /LogFile=d:\out\logs\UpdateProducts.log
Те саме, що і в попередньому, але з використанням файлу операцій:
dbtour.exe /silent "/ActionFile=c:\DBTourStartParameters.txt"
Вміст файлу c:\DBTourStartParameters.txt повинен бути приблизно таким:
/opendb
/SrcDBInterface=ADO
/DBDriver=Oracle
/DB=<DSN>MyOraDSN
/DBUserName=Bohdan2000
/DBPassword=tobein2010
/SQLFile=d:\MyScripts\UpdateProducts.sql
/ExecuteQuery
/SQLParamNames=PDate%#%PProdCategory%#%PProdChannel
/SQLParamTypes=Date%#%Integer%#%String
/SQLParamValues=2014-02-02%#%12%#%Direct
/CloseWhenDone
/CloseOnError
/LogFile=d:\out\logs\UpdateProducts.log
