Цей розділ описує параметри командного рядка Database Tour, специфічні для групових операцій з даними в текстових полях. Цей тип командного рядка може використовуватися лише в Database Tour Pro.
Див. також більш детальну інформацію щодо специфічних операцій з даними в текстових полях.
Див. також загальні правила написання командних рядків.
Ви можете почати з такого простого прикладу:
dbtour.exe /FieldUtils /CloseWhenDone /CloseOnError /DBInterface=ADO /DBDriver=ACCESS /DB=c:\MyData\Genealogy.mdb /TableName=Client /fields=LastName;FirstName /trim
Тут ви відкриваєте вашу базу даних Genealogy.mdb типу MS Access і відсікаєте ведучі та кінцеві пробіли і керуючі символи в полях LastName та FirstName таблиці Client. Після виконання програма автоматично закривається.
Не хочете писати параметри вручну? Дивіться наступний розділ нижче і легко створіть командний рядок за допомогою графічного інтерфейсу Database Tour.
Або продовжуйте читати, щоб дізнатися про всі перемикачі та параметри.
Побудова командного рядка в кілька кліків
Використання
Опції командного рядка та їх опис
Приклади
Досвідчені користувачі можуть побудувати потрібну командний рядок вручну, використовуючи специфікацію нижче.
Але якщо ви початківець або хочете швидко побудувати командний рядок без занурення в деталі, використовуйте конструктор командних рядків Database Tour.
Класичний формат командного рядка
Командний рядок складається з усіх потрібних параметрів:
dbtour.exe /Parameter1 /Parameter2 /... /ParameterN
Скорочений формат командного рядка
Цей формат більш гнучкий, оскільки дозволяє тримати всі параметри в окремому файлі операцій. Командний рядок складається з параметра /ActionFile (що вказує шлях до файла операцій) та необов'язкового параметра /silent:
dbtour.exe [/silent] /ActionFile=ActionFileName
/TextUtils
Вказує програмі на необхідність виконати групові операції з текстовими полями.
/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>. Рекомендується брати весь параметр в лапки у таких випадках.
/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.
/TableName=Value
Ім'я таблиці, для якої повинні бути виконані операції з текстовими даними. Якщо ім'я містить пробіли, візьміть весь параметр в лапки.
/trim
Вказує програмі відсікти ведучі та кінцеві пробіли та керучі символи з даних полів таблиці, визначеної параметром /TableName.
/capitalize
Вказує програмі конвертувати перший символ кожного слова до верхнього регістру в даних полів таблиці, визначеної параметром /TableName.
/FirstToUpper
Вказує програмі конвертувати перший символ до верхнього регістру в даних полів таблиці, визначеної параметром /TableName.
/ToUpper
Вказує програмі конвертувати до верхнього регістру дані полів таблиці, визначеної параметром /TableName.
/ToLower
Вказує програмі конвертувати до нижнього регістру дані полів таблиці, визначеної параметром /TableName.
/ReplaceText=Value
Вказує фрагмент тексту, який повинен бути замінений у даних полів таблиці, визначеної параметром /TableName. Зауважте, що заміна текстових фрагментів робиться після всіх інших дій, вказаних у командному рядку, крім додвання префікса та суфікса. Якщо текст містить пробіли, візьміть весь параметр в лапки.
/ReplaceWith=Value
Вказує текст для заімни. Якщо текст містить пробіли, візьміть весь параметр в лапки. Якщо цей параметр опущено, то в якості текста для заміни береться пустий рядок (тобто всі текстові фрагменти, визначені параметром /ReplaceText, будуть замінені пустими рядками, або, простіше кажучи, будуть вилучені).
/ReplaceIgnoreCase
При використання цього ключа при пошуку тексту для заміни не буде враховуватися регістр символів.
/AddPrefix=Value
Вказує префікс, що має бути доданий до тексту у даних полів таблиці, визначеної параметром /TableName. Зауважте, що додавання префікса та суфікса робиться після всіх інших дій, вказаних у командному рядку.
/AddSuffix=Value
Вказує суфікс, що має бути доданий до тексту у даних полів таблиці, визначеної параметром /TableName. Зауважте, що додавання префікса та суфікса робиться після всіх інших дій, вказаних у командному рядку.
/fields=Value
Вказує імена полів, в яких потрібно виконувати вказані в командному рядку операції. Імена повинні бути розділені крапкою з комою. Якщо імена містять пробіли, візьміть весь параметр в лапки. Якщо цей параметр опущено, будуть опрацьовані всі текстові поля.
/LogFile=Value
Ім'я файла для запису журналу операцій. Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.
/AppendLog
Журнал операцій повинен записуватися в кінець файла із збереженням попереднього вмісту файла. Якщо цей ключ опущено, існуючий журнал операцій буде перезаписано.
/OpenLog
Відкрити файл журналу після завершення. Повинен застосовуватися разом з параметром /LogFile.
/CloseWhenDone
Автоматично закрити програму після успішного виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.
/CloseOnError
Автоматично закритися у випадку помилки виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.
/minimize
Запуск програми в мінімізованому вікні. Вікно відновлюється до нормального стану у випадку помилки або після закінчення виконання (якщо опція /CloseWhenDone не використовується). Ця опція ігнорується в "тихому" режимі, коли програма працює без жодних вікон.
Відсікання ведучих та кінцевих пробілів та керуючих символів в текстових полях таблиці dBase:
dbtour.exe /FieldUtils /CloseWhenDone /CloseOnError /DBInterface=ADO /DBDriver=dBase /DB=c:\MyDBFFolder /TableName=customer /trim /fields=LastName;FirstName
Тут за допомогою движка ADO відкривається база даних c:\MyDBFFolder (тека з файлами DBF) і робиться відсікання ведучих та кінцевих пробілів та керуючих символів в полях LastName та FirstName таблиці customer. Після виконання програма автоматично закривається.
Заміна тексту в таблиці Access:
dbtour.exe /FieldUtils /CloseWhenDone /CloseOnError /DBInterface=ADO /DBDriver=ACCESS /DB=c:\MyData\Genealogy.mdb /TableName=ADDR /fields=Address1 "/ReplaceText=Mark Tweine street," "/ReplaceText=Mark Tweine str.," /ReplaceIgnoreCase
Тут відкривається база даних Genealogy.mdb типу MS Access і робиться заміна тексту в полі Address1 таблиці ADDR. Після виконання програма автоматично закривається.
Те саме, що і в попередньому, але з використанням файла операцій:
dbtour.exe "/ActionFile=C:\DBTourStartParameters.txt"
Вміст файла c:\DBTourStartParameters.txt повинен бути приблизно таким:
/FieldUtils
/fields=Address1
/ReplaceText=Mark Tweine street,
/ReplaceWith=Mark Tweine str.,
/ReplaceIgnoreCase
/DBInterface=ADO
/DBDriver=Access
/DB=c:\MyData\Genealogy.mdb
/TableName=ADDR
