Командний рядок для виконання утиліт BDE

Цей розділ описує параметри командного рядка Database Tour, специфічні для утиліт BDE. Цей тип командного рядка може використовуватися лише в Database Tour Pro. Він вимагає встановленого BDE.

Увага

  • BDE - застаріла технологія. Рекомендується використовувати її лише для підтримки старих рішень.
  • BDE заснована на 32-бітній архітектурі. Отже, вам необхідно використовувати 32-бітну версію Database Tour для роботи з BDE.

Див. також загальні правила написання командних рядків.

Ви можете почати з такого простого прикладу:

dbtour.exe /BDEUtils /DB=MyAlias /TableName=order.db /pack /RenameTo=orders.db

Тут ви упаковуєте вашу таблицю order.db і перейменовуєте її в orders.db.

Не хочете писати параметри вручну? Дивіться наступний розділ і легко створіть командний рядок за допомогою графічного інтерфейсу Database Tour.

Або продовжуйте читати, щоб дізнатися про всі перемикачі та параметри.

Побудова командного рядка в кілька кліків

Використання

Опції командного рядка та їх опис

Приклади

Побудова командного рядка в кілька кліків

Досвідчені користувачі можуть побудувати потрібну командний рядок вручну, використовуючи специфікацію нижче.

Але якщо ви початківець або хочете швидко побудувати командний рядок без занурення в деталі, використовуйте конструктор командних рядків Database Tour.

Використання

Класичний формат командного рядка

Командний рядок складається з усіх потрібних параметрів:

dbtour.exe /Parameter1 /Parameter2 /... /ParameterN

Скорочений формат командного рядка

Цей формат більш гнучкий, оскільки дозволяє тримати всі параметри в окремому файлі операцій. Командний рядок складається з параметра /ActionFile (що вказує шлях до файла операцій) та необов'язкового параметра /silent:

dbtour.exe [/silent] /ActionFile=ActionFileName

Параметри командного рядка та їх опис

Головна команда

/OpenDB

Вказує програмі на необхідність виконати утиліти BDE. Обов'язковий параметр для цього типу командного рядка.

Керуючі параметри

/silent

Запуск програми в так званому "тихому" режимі, без будь-яких вікон. При використанні опції /ActionFile ключ /silent повинен бути поза файлом параметрів. Database Tour повертає код виходу 0 в разу успішного відпрацювання, 1 в разі некоректного командного рядка і 2 у випадку помилок виконання. Увага! В цьому режимі немає запиту підтвердження на перезапис існуючих файлів та інших попереджень.

/ActionFile=Value

Ім'я файла операцій, який включає параметри командного рядка (один параметр на рядок). Рядки, що починаються на крапку з комою, вважаються коментарем і ігноруються програмою. Допускаються пусті рядки. При використанні цього параметру в командному рядку не повинно бути інших параметрів, окрім ключа /silent. Якщо назва файлу містить пробіли, візьміть весь параметр в лапки. Див. приклад.

З'єднання з базою даних

/UseParadoxPasswords=Value

Розділений крапкою з комою список паролів для таблиць Paradox (якщо планується виконувати дії з захищеними паролем таблицями Paradox).

/DB=Value

Назву бази даних (та, в якій необхідно виконати утиліти BDE). Це може бути назва файлу, назва теки, назва джерела даних ODBC або назва аліасу BDE. Якщо назва містить пробіли, візьміть весь параметр в лапки.

/DBInterface=Value

Інтерфейс для роботи з базами даних (движок баз даних), що буде використовуватися для відкриття бази даних. Можливі значення: BDE.

/DBKind=Value

Вид бази даних. Можливі значення: FOLDER, FILE, DSN. Якщо не вказано, програма спробує визначити це автоматично.

Замість використання цього параметра можливо використовувати префікс, що вказує тип бази даних (файл, тека, DSN), в параметрі /DB. Префікс повинен братися в квадратні дужки <>. Можливі значення: <FILE>, <FOLDER>, <DSN>. Рекомендується брати весь параметр в лапки у таких випадках.

/DBDriver=Value

Драйвер бази даних. Приклади можливих значень: ACCESS, DBASE, INTERBASE, FIREBIRD, ORACLE, SQL SERVER і т.д. Якщо не вказано, програма спробує визначити це автоматично. Якщо назва драйвера містить пробіли, візьміть весь параметр в лапки.

/DBUserName=Value

Ім'я користувача бази даних. Якщо ім'я користувача містить пробіли, візьміть весь параметр в лапки.

/DBPassword=Value

Пароль бази даних. Якщо пароль містить пробіли, візьміть весь параметр в лапки.

Основні параметри утиліт BDE

/TableName=Value

Ім'я таблиці, над якою повинні бути виконані утиліти BDE. Якщо ім'я містить пробіли, візьміть весь параметр в лапки.

/pack

Упакувати таблицю Paradox або dBase, визначену параметром /TableName.

/RegenerateIndexes

Перегенерувати індекси для таблиці Paradox або dBase, визначеної параметром /TableName.

/SetPassword=Value

Пароль, яким потрібно захистити таблицю Paradox, визначену параметром /TableName.

/PhysicallySortBy=Value

Назва поля, по якому необхідно відсортувати фізично таблицю Paradox або dBase, визначену параметром /TableName. Індексовані таблиці Paradox не можуть бути фізично пересортовані. Якщо назва поля містить пробіли, візьміть весь параметр в лапки.

/SortDescending

Фізичне сортування, визначене параметром /PhysicallySortBy, повинно робитися в зворотному порядку.

/SortSensitive

Фізичне сортування, визначене параметром /PhysicallySortBy, повинно робитися з урахуванням регістру символів.

/RenameTo=Value

Нове ім'я для таблиці Paradox, dBase або текстової, вказаної параметром /TableName. Якщо ім'я містить пробіли, візьміть весь параметр в лапки.

/DuplicateAs=Value

Ім'я для нової копії таблиці, вказаної параметром /TableName. Якщо таблиця є локальною (Paradox, dBase, FoxPro або текстова), всі пов'язані файли також дублюються. Якщо ім'я містить пробіли, візьміть весь параметр в лапки.

/ChangeLangDriverTo=Value

Новий мовний драйвер для таблиці Paradox або dBase, визначеної параметром /TableName.

Логування

/LogFile=Value

Вказує ім'я файла для запису журналу операцій. Якщо ім'я файла містить пробіли, візьміть весь параметр в лапки.

/AppendLog

Вказує, що журнал операцій повинен записуватися в кінець файла із збереженням попереднього вмісту файла. Якщо цей ключ опущено, існуючий журнал операцій буде повністю перезаписано.

/OpenLog

Вказує програмі відкрити файл журналу після завершення. Повинен застосовуватися разом з параметром /LogFile.

Поведінкові ключі

/CloseWhenDone

Вказує програмі автоматично закритися після успішного виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.

/CloseOnError

Вказує програмі автоматично закритися у випадку помилок виконання. Ця опція ігнорується в "тихому" режимі, коли програма автоматично закривається в будь-якому разі.

/minimize

Програма запускається в мінімізованому вікні. Вікно відновлюється до нормального стану у випадку помилки або після закінчення виконання (якщо опція /CloseWhenDone не використовується). Ця опція ігнорується в "тихому" режимі, коли програма працює без жодних вікон.

Приклади

  • Упакування і фізичне сортування таблиці dBase:

    dbtour.exe /BDEUtils /CloseWhenDone /CloseOnError /DB=c:\MyDBFFolder /TableName=customer.dbf /pack /PhysicallySortBy=CustNo

    Тут упаковується таблиця customer.dbf, вона фізично сортується за полем CustNo, після чого завершується робота.

  • Упакування, захист паролем та перейменування таблиці Paradox:

    dbtour.exe /BDEUtils /DB=MyAlias /TableName=order.db /pack /SetPassword=*REMOVE* /RenameTo=orders.db

    Тут упаковується таблиця order.db, видаляється її пароль і вона перейменовується в orders.db.

  • Те саме, що і в попередньому, але з використанням файла операцій:

    dbtour.exe "/ActionFile=C:\My Portfolio\DBTourStartParameters.txt"

    Вміст файла c:\My Portfolio\DBTourStartParameters.txt повинен бути приблизно таким:

    ;action
    /BDEUtils
    ;options
    /pack
    /SetPassword=*REMOVE*
    /RenameTo=orders.db
    ;target definition
    /DB=MyAlias
    /TableName=order.db