H3.3. Comandos para administrar la base de datos

Inicialización de la base de datos

Durante la inicialización, la base de datos debe estar ausente o vacía.

drwcsd [<claves>] initdb [<clave_licencia>|- [<script_sql>|- [<archivo_ini>|- [<contraseña> [<lua-script>|-]]]]] — inicialización de base de datos.

<clave_licencia> — ruta a la clave de licencia Dr.Web agent.key. Si no se especifica la clave de licencia, deberá agregarla más tarde desde el Centro de Сontrol u obtenerla a través de la comunicación entre servidores desde el Servidor vecino.

<sql_script> — ruta de acceso al script sql para inicializar la estructura física de la base de datos.

<ini_archivo> — archivo preformado en el formato drweb32.ini, que establecerá la configuración inicial de los componentes del software Dr.Web (para el grupo Everyone).

<contraseña> — contraseña inicial del administrador del Servidor (nombre admin). Por defecto root.

<lua-script> — ruta al script lua para inicializar la base de datos (relleno de la base de datos con valores predeterminados).

Significado especial "-" (menos) significa no usar este parámetro.

El signo menos puede omitirse si faltan los siguientes parámetros.

Establecimiento de los parámetros de inicialización de la base de datos

Cuando se utiliza la base de datos incorporada, los parámetros de inicialización se pueden configurar a través de un archivo externo. Para hacer esto, use el comando:

drwcsd.exe initdbex <response-file>

<response-file> — el archivo en el que se escriben los parámetros de inicialización de la base de datos, línea por línea, en el mismo orden que los parámetros del comando initdb.

Formato de archivo:

<nombre_completo_archivo_clave_licencia>

<nombre_completo_archivo_sql_script>

<nombre_completo_ini_archivo>

<contraseña_administrador>

Al usar un archivo response en Windows, es posible usar cualquier carácter en la contraseña de administrador.

Las líneas de cola que siguen el parámetro necesario en un caso particular son opcionales. Si la cadena es "-" (un signo menos), se utiliza el valor predeterminado (como en initdb).

Actualización de la base de datos

drwcsd [<claves>] updatedb <script> — realizar manipulaciones con la base de datos (por ejemplo, actualizar al cambiar la versión) ejecutando script SQL o LUA desde el archivo especificado.

Actualización de la versión de la base de datos

drwcsd upgradedb [<directorio>] — iniciar el Servidor para actualizar la estructura de la base de datos al cambiar a una nueva versión desde el directorio especificado (consulte el directorio update-db) o mediante los scripts internos.

Exportación de la base de datos

a)drwcsd exportdb <archivo> —exportación de la base de datos al archivo especificado.

Ejemplo para SO Windows:

C:\Program Files\DrWeb Server\bin\drwcsd.exe -home="C:\Program Files\DrWeb Server" -var-root="C:\Program Files\DrWeb Server\var" -verbosity=all exportdb "C:\Program Files\DrWeb Server\esbase.es"

En los SO de la familia UNIX la acción se realiza en nombre del usuario drwcs:drwcs al directorio $DRWCS_VAR (además del SO FreeBSD, que por defecto guarda el archivo en el directorio desde el cual se ejecuta el script; si especifica la ruta explícitamente, el directorio debe poder escribirse para el <usuario>:<grupo>, que se crearon durante la instalación, por defecto — drwcs:drwcs).

b)drwcsd xmlexportdb <xml-archivo> — exportación de la base de datos al archivo especificado xml.

Si especifica la extensión del archivo gz, luego, durante la exportación, el archivo de la base de datos se empaquetará en el archivo gzip.

Si no se especifica una extensión o se especifica una extensión que no sea gz, entonces el archivo de exportación no se archivará.

Ejemplo para SO Windows:

Para exportar la base de datos a un archivo xml sin compresión:

"C:\Program Files\DrWeb Server\bin\drwcsd.exe" "-home=C:\Program Files\DrWeb Server" "-bin-root=C:\Program Files\DrWeb Server" "-var-root=C:\Program Files\DrWeb Server\var" -verbosity=ALL -rotate=10,10m -log=export.log xmlexportdb database.db

Para exportar la base de datos a un archivo xml archivado al:

"C:\Program Files\DrWeb Server\bin\drwcsd.exe" "-home=C:\Program Files\DrWeb Server" "-bin-root=C:\Program Files\DrWeb Server" "-var-root=C:\Program Files\DrWeb Server\var" -verbosity=ALL -rotate=10,10m -log=export.log xmlexportdb database.gz

Ejemplo para SO de la familia UNIX:

Para exportar la base de datos a un archivo xml sin compresión:

/etc/init.d/drwcsd xmlexportdb /es/database.db

Para exportar la base de datos a un archivo xml archivado al:

/etc/init.d/drwcsd xmlexportdb /es/database.gz

Importación de la base de datos

a)drwcsd importdb <archivo> — importación de la base de datos desde el archivo especificado (el contenido anterior de la base de datos se borra).

b)drwcsd upimportdb <archivo> [<directorio>] — importación y actualización de la base de datos obtenida durante la exportación desde el Servidor de versiones anteriores (se borran los contenidos anteriores de la base de datos). También puede especificar la ruta al directorio con scripts para actualizar la estructura de la base de datos al cambiar a una nueva versión (similar al comando upgradedb).

c)drwcsd xmlimportdb <xml-archivo> — importación de la base de datos del archivo xml especificado.

d)drwcsd xmlupimportdb <xml-archvo> [<directorio>] —importación y actualización de la base de datos obtenida durante la exportación xml desde el Servidor de versiones anteriores. También puede especificar la ruta al directorio con scripts para actualizar la estructura de la base de datos al cambiar a una nueva versión (similar al comando upgradedb).

e)drwcsd xmlimportdbnh <xml-archivo> — importación de la base de datos del archivo xml especificado sin tener en cuenta el caché. Se puede usar, por ejemplo, si el archivo xml de la base de datos se editó manualmente, y el caché del archivo grabado automáticamente durante la exportación se volvió irrelevante.

Antes de usar los comandos upimportdb y xmlupimportdb es necesario realizar una copia de reserva de la base de datos.

Cualquier problema durante la ejecución de estos comandos puede provocar la eliminación de toda la información de la base de datos.

 

El uso de los comandos upimportdb y xmlupimportdb para importar con la actualización de la versión de la base de datos solo es posible dentro de un DBMS.

Vaciado de memoria de exportación de la base de datos

drwcsd [<claves>] dumpimportdb <archivo_base_datos> [<archivo_SQL> [<filtro_tablas>]] — escribir la información detallada sobre la base de datos integrada o externa en el archivo de historial del servidor o el archivo SQL.

Importación y exportación de la base de datos cuando al ejecutar el comando dumpimportdb no se realizan.

<archivo_base_datos> — archivo de exportación de la base de datos, cuya información se registrará en el historial del Servidor o en el <archivo_SQL>. Se puede obtener un archivo de exportación usando el comando exportdb; también es posible usar el archivo obtenido haciendo una copia de reserva de la base de datos. El archivo XML obtenido con el comando xmlexportdb no se acepta.

<archivo_SQL> — archivo para registrar todas las solicitudes SQL que se ejecutarán si la base de datos se importa desde el archivo especificado en el <archivo_base_datos>. Si no se especifica el archivo SQL, se escribe en el historial del Servidor (en forma de una lista de tablas y sus campos). Si se especifica el archivo, luego solo en el archivo SQL.

<filtro_tablas> — lista de tablas de la base de datos, cuya información se mostrará en el <archivo_SQL>. La lista de tablas debe especificarse con una coma. Los nombres deben coincidir con los nombres de las tablas en la base de datos. Por ejemplo: admins,groups,stations. El filtro de tablas solo es válido cuando salen sus datos a un archivo SQL. Si no se especifica una lista de tablas, se muestran todas las tablas.

Verificación de la base de datos

drwcsd verifydb — inicie el Servidor para comprobar la base de datos. Para escribir información sobre los resultados en el archivo de registro, ingrese el comando con la tecla -log. Los detalles sobre el uso de esta clave se describen en la p. H3.8. Descripción de las claves.

Aceleración de la base de datos

drwcsd [<claves>] speedupdb — ejecutar comandos VACUUM, CLUSTER, ANALYZE para acelerar el trabajo con la base de datos.

Restauración de la base de datos

drwcsd repairdb — realizar la recuperación de la imagen dañada de la base de datos incorporada SQLite3 o tablas de la base de datos externa corruptas MySQL.

Recuperación de SQLite3 también se puede realizar automáticamente cuando se inicia el Servidor, si en la configuración de la base de datos SQLite3 en el Centro de Control está marcada la casilla Restaurar automáticamente imagen dañada (vea el Manual de administrador, p. Restauración de la base de datos).

Borrar base de datos

drwcsd cleandb — limpiar la base de datos del Servidor, eliminar todas tablas.