|
|
|
|
- Propiedades WLanguage que se pueden utilizar con el tipo hBackupDescription
- Límite del número de copias de seguridad (LimitNumberBackups Property)
- Parámetros del Procedure almacenado llamados ANTES de la copia de seguridad
- Parámetros del Procedure almacenado llamados DESPUÉS de la copia de seguridad
- Funciones que utilizan variables hBackupDescription:
hBackupDescription (Tipo de Variable)
Disponible solo con este tipo de conexión
El tipo hBackupDescription se utiliza para describir mediante programación una copia de seguridad HFSQL Client/Server. Esta copia de seguridad se puede realizar inmediatamente o se puede programar. Las características de esta copia de seguridad pueden definirse y modificarse mediante diferentes Propiedades de WLanguage. Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
// Describe an immediate backup Backup_Doc is hBackupDescription Backup_Doc.Description = "Doc Backup" Backup_Doc.WithIndex = True Backup_Doc.ProgressBar = "PROGBAR_MyProgressBar" Backup_Doc.Destination = "Doc/Backup" Backup_Doc.Source = "Doc/*" Backup_Doc.ProcedureBefore = "mydatabase:DocCol.Check" Backup_Doc.ProcedureAfter = "mydatabase:DocCol.CheckBackup" Backup_Doc.LimitNumberBackups = 5 // Save backup HBackup(MyConnection, Backup_Doc)
// Create a scheduled backup every 5 minutes // with a differential backup every minute hBck is hBackupDescription hBck.Enabled = True hBck.WithIndex = True hBck.Description = "Scheduled backup every N minutes " + ... " with a differential backup every minute on the database " + ... cnt.Database + " created on "+ DateToString(DateSys(), maskDateSystem) + ... " at " + TimeToString(TimeSys(), "HH:MM:SS:CC") hBck.Destination = "Backup_"+ cnt.Database hBck.LimitNumberBackups = 2 hBck.Source = cnt.Database hBck.SchedulingFull.Month = "*" hBck.SchedulingFull.DayOfMonth = "*" // Define the scheduling dtServerDateTime is DateTime = HInfoServer(cnt, hInfoDate) dtServerDateTime.Minute++ hBck.SchedulingFull.Hour = dtServerDateTime.Hour hBck.SchedulingFull.Minute = dtServerDateTime.Minute hBck.SchedulingFull.DayOfWeek = "*" hBck.SchedulingFull.DayOfMonthOrDayOfWeek = False hBck.SchedulingDifferential.Month = "*" hBck.SchedulingDifferential.DayOfMonth = "*" hBck.SchedulingDifferential.Hour = "*" hBck.SchedulingDifferential.Minute = "*" hBck.SchedulingDifferential.DayOfWeek = "*" hBck.SchedulingDifferential.DayOfMonthOrDayOfWeek = False // Add the scheduled backup IF HAddScheduledBackup(cnt, hBck) = False THEN Error("Failure creating the scheduled backup", HErrorInfo(hErrFullDetails)) RETURN END
Observaciones Propiedades WLanguage que se pueden utilizar con el tipo hBackupDescription Las siguientes propiedades pueden utilizarse para manipular una variable de tipo hBackupDescription. | | | denominar | Tipo utilizado | Efecto |
---|
Compresión | Constante de tipo Integer | Se utiliza para comprimir (o no) el resultado de la copia de seguridad. Esta Property puede corresponder a una de las siguientes constantes:- zipFormatNone: Sin compresión.
- zipFormatZIP: Compresión en formato Zip.
| ConIndex | booleano | - True si se debe realizar la copia de seguridad de los índices,
- False en caso contrario.
Esta propiedad es opcional. Por Default, se hace la copia de seguridad copy de los índices. | description | Cadena de caracteres | description associated con el respaldo. Esta propiedad es opcional. La copia de seguridad description corresponde a una cadena vacía ("") de Default. | Destino | Cadena de caracteres | Destino de la copia de seguridad (nombre y destino de la copia de seguridad). La copia de seguridad se realizará en el servidor, en una ubicación definida por este nombre. Si este nombre corresponde a un ruta relativo, la copia de seguridad se colocará en el subdirectorio "Backup" del servidor HFSQL. Para especificar:- el directorio del servicio Manta, utilice la cadena de caracteres "%%EXE%%".
- el año, utilice la cadena de caracteres "%%YEAR%%" (2008, por ejemplo).
- el mes en 2 dígitos, utilice la cadena de caracteres "%%MONTH%%" (03 por ejemplo).
- el día, utilice la cadena de caracteres "%%DAY%%%".
- la hora, utilice la cadena de caracteres "%%HOUR%%".
- los minutos, utilice la cadena de caracteres "%%MINUTE%%".
Ejemplos: - Para almacenar la copia de seguridad en un directorio que se corresponda con el año, el día y la hora en el subdirectorio "Backup", utilice:
// Store backup in 2021_21_13 Backup_Doc.Destination="%%YEAR%%_%%DAY%%_%%HOUR%%"
- Para guardar la copia de seguridad en un directorio "Doc/Backup" al mismo nivel que el directorio del servicio Manta, utilice:
Backup_Doc.Destination="%%EXE%%/Doc/Backup/%%YEAR%%"
| drogadicta | Cadena de caracteres | Usuario que ha creado la copia de seguridad. Esta propiedad es de solo lectura. | Fuente (*) | Cadena de caracteres | Filtro usado para definir los datos a respaldar. Los valores posibles son:- *: Hace una copia de seguridad copy de todas las bases de datos del servidor, los registros, las bases de datos del sistema (usuarios, grupos, derechos).
- Nombre de la base de datos/*: Hace una copia de seguridad de toda la base de datos de copy: archivos, enlaces, procedimientos almacenados, disparadores.
- Nombre de la base de datos/Nombre del archivo1: Hace una copia de seguridad de copy de <Nombre del archivo1> que se encuentra en <Nombre de la base de datos>
- Nombre de la base de datos 1/Nombre del archivo1 + TAB + Nombre de la base de datos 2/Nombre del archivo2 + ...: Lista de elementos a respaldar. El separador puede ser la tabulación (TAB) o el punto y coma (";").
- sistema: Hace una copia de seguridad copy de las bases de datos del sistema (usuarios, grupos, derechos).
Esta Property debe ser necesariamente especificada. | Habilitado | booleano | Se utiliza para administrar la activación de una copia de seguridad programada: - True si la planificación de la copia de seguridad está activa: la copia de seguridad se realiza de acuerdo con la programación.
- False si la planificación de la copia de seguridad no está activa: no se realiza la copia de seguridad.
| Identificador | Integro | Identificador de la copia de seguridad. Esta propiedad es de solo lectura. | LimitNumberBackups | Integro | Número máximo de copias de seguridad del mismo tipo a realizar. No hay límite si este número corresponde a 0. Si el número de copias de seguridad excede el valor límite, algunas copias de seguridad anteriores se eliminarán del servidor.. Para obtener más información, consulte "Modo de funcionamiento del límite respecto al número de copias de seguridad". | ProcedimientoAntes | Cadena de caracteres | Nombre del Procedure almacenado utilizado antes de la ejecución de la copia de seguridad. El nombre Procedure tiene el siguiente formato: <Nombre de la base de datos>:<Nombre del conjunto de Procedure s>.<Nombre del Procedure almacenado>.
Esta propiedad es opcional. No se ejecuta ninguna Procedure si esta Property no está definida.
Para obtener más información, consulte "Parámetros de la Procedure almacenada llamada ANTES de la copia de seguridad". | ProcedimientoDespués | Cadena de caracteres | Nombre del Procedure almacenado utilizado después de la ejecución de la copia de seguridad. El nombre Procedure tiene el siguiente formato: <Nombre de la base de datos>:<Nombre del conjunto de Procedure s>.<Nombre del Procedure almacenado>.
Esta propiedad es opcional. No se ejecuta ninguna Procedure si esta Property no está definida.
Para obtener más información, consulte "Parámetros de la Procedure almacenada llamada DESPUÉS de la copia de seguridad". | ProgramaciónCompleta | Variable de tipo hScheduling | Características de una programación completa. Esta Property debe ser necesariamente especificada. | ProgramaciónDiferencial | Variable de tipo hScheduling | Características de una programación diferencial. Tiene la capacidad de definir tanto una programación completa como una programación diferencial.. No se puede realizar ninguna programación de diferencias por sí sola.. Esta propiedad es opcional. | ProgressBar | Nombre del control | Nombre de la control Barra de progreso utilizada en la ventana para ver el progreso del paso de inicialización de la copia de seguridad (y no el progreso de la copia de seguridad)..
Property opcional disponible sólo en WINDEV. | WebhookDespués | Cadena de caracteres | URL de un servicio REST que se activará después de la copia de seguridad y el Procedure especificado con el Procedure After Procedure (si existe). Una solicitud de Post se realizará en el URL proporcionado. El URL recibe un contenido de "aplicación/JSON" correspondiente a la información de la copia de seguridad. Por ejemplo: { "identifier": "283", "destination": "c:\backup\283\mybackup.zip", "state": "completed" } donde: - El"identificador" corresponde al identificador de la copia de seguridad.
- "destino" corresponde al destino de la copia de seguridad.
- el"estado" corresponde al estado de la copia de seguridad. Hay diferentes estados: "completado", "cancelado" o "error".
|
Las propiedades seguidas de (*) son obligatorias. Límite del número de copias de seguridad (LimitNumberBackups Property) Cuando se define el límite del número de copias de seguridad (LimitNumberBackups diferente de 0): - Antes de la copia de seguridad: Buscar las copias de seguridad anteriores similares (misma fuente y mismo destino). Si estas copias de seguridad son erróneas, los archivos de la copia de seguridad se borrarán del disco (pero la copia de seguridad permanecerá en el historial de copias de seguridad).
- Ejecutar el "Before Procedure".
- Copia de seguridad.
- Ejecutar el "After Procedure".
- Si el número de copias de seguridad similares (misma fuente y mismo destino) realizadas correctamente es mayor que el valor límite, el servidor eliminará algunas de estas copias de seguridad y las eliminará del historial.. Esta eliminación comienza desde la copia de seguridad más antigua hasta que el número de copias de seguridad es igual al valor solicitado.
Observación: Este Property puede ser usado para implementar un sistema de respaldo específico. Por ejemplo: - Una copia de seguridad diaria mientras se almacenan las últimas 7 copias de seguridad.
- Una copia de seguridad semanal mientras se almacenan las últimas 4 copias de seguridad.
- Una copia de seguridad mensual mientras se almacenan las últimas 6 copias de seguridad.
Parámetros del Procedure almacenado llamados ANTES de la copia de seguridad El Procedure almacenado llamado ANTES de la copia de seguridad puede tomar parámetros. Este procedimiento tiene el siguiente formato: PROCEDURE <Procedure name>(<Data to back up>, ... <Backup destination>, <Description>) Estos parámetros son opcionales. Le permitirán a manipular las siguientes indicaciones en el código del Procedure almacenado: - <Datos para respaldar>'STRIMEULD: Cadena de caracteres correspondiente a la información a respaldar. Corresponde a la propiedad Source. Los valores posibles son los siguientes:
| | * | Hace una copia de seguridad copy de todas las bases de datos del servidor, los registros, las bases de datos del sistema (usuarios, grupos, derechos). | Nombre de la base de datos1/Nombre Archivo1 + TAB + Nombre de la base de datos 2/Nombre Archivo2 +... | Lista de elementos a respaldar. El separador puede ser la tabulación (TAB) o el punto y coma (";"). | Nombre de la base de datos/* | Hace una copia de seguridad de toda la base de datos de copy: archivos, enlaces, procedimientos almacenados, disparadores. | Nombre de la base de datos/Nombre Archivo1 | Hace una copia de seguridad de copy de <Nombre del archivo1> que se encuentra en <Nombre de la base de datos> | sistema | Hace una copia de seguridad copy de las bases de datos del sistema (usuarios, grupos, derechos). |
- <Destino de la copia de seguridad>'HTRIMEULCHTRIMEULTRIMEULB: Nombre y destino de la copia de seguridad. Corresponde a la propiedad Destination. La copia de seguridad se realizará en el servidor, en una ubicación definida por este nombre. Si este nombre corresponde a un ruta relativo, la copia de seguridad se colocará en el subdirectorio "Backup" del servidor HFSQL. Para especificar:
- el directorio del servicio Manta, utilice la cadena de caracteres "%%EXE%%".
- el año, utilice la cadena de caracteres "%%YEAR%%" (2008, por ejemplo).
- el mes en 2 dígitos, utilice la cadena de caracteres "%%MONTH%%" (03 por ejemplo).
- el día, utilice la cadena de caracteres "%%DAY%%%".
- la hora, utilice la cadena de caracteres "%%HOUR%%".
- los minutos, utilice la cadena de caracteres "%%MINUTE%%".
- <description>: Copia de seguridad de description. Corresponde al description Property.
Parámetros del Procedure almacenado llamados DESPUÉS de la copia de seguridad El Procedure almacenado llamado DESPUÉS de la copia de seguridad puede tomar parámetros. Este procedimiento tiene el siguiente formato: PROCEDURE <Procedure name>(<Data to back up>, <Backup destination>, ... <Description>, <Status>, <Error message>) Estos parámetros son opcionales. Le permitirán a manipular las siguientes indicaciones en el código del Procedure almacenado: - <Datos para respaldar>'STRIMEULD: Cadena de caracteres correspondiente a la información a respaldar. Corresponde a la propiedad Source. Los valores posibles son los siguientes:
| | * | Hace una copia de seguridad copy de todas las bases de datos del servidor, los registros, las bases de datos del sistema (usuarios, grupos, derechos). | Nombre de la base de datos1/Nombre Archivo1 + TAB + Nombre de la base de datos 2/Nombre Archivo2 +... | Lista de elementos a respaldar. El separador puede ser la tabulación (TAB) o el punto y coma (";"). | Nombre de la base de datos/* | Hace una copia de seguridad de toda la base de datos de copy: archivos, enlaces, procedimientos almacenados, disparadores. | Nombre de la base de datos/Nombre Archivo1 | Hace una copia de seguridad de copy de <Nombre del archivo1> que se encuentra en <Nombre de la base de datos> | sistema | Hace una copia de seguridad copy de las bases de datos del sistema (usuarios, grupos, derechos). |
- <Destino de la copia de seguridad>'HTRIMEULCHTRIMEULTRIMEULB: Nombre y destino de la copia de seguridad. Corresponde a la propiedad Destination. La copia de seguridad se realizará en el servidor, en una ubicación definida por este nombre. Si este nombre corresponde a un ruta relativo, la copia de seguridad se colocará en el subdirectorio "Backup" del servidor HFSQL. Para especificar:
- el directorio del servicio Manta, utilice la cadena de caracteres "%%EXE%%".
- el año, utilice la cadena de caracteres "%%YEAR%%" (2008, por ejemplo).
- el mes en 2 dígitos, utilice la cadena de caracteres "%%MONTH%%" (03 por ejemplo).
- el día, utilice la cadena de caracteres "%%DAY%%%".
- la hora, utilice la cadena de caracteres "%%HOUR%%".
- los minutos, utilice la cadena de caracteres "%%MINUTE%%".
- <description>: Copia de seguridad de description. Corresponde al description Property.
- Estado> <Estado: integer (o constante Integer) usado para averiguar el estado de la copia de seguridad:
| | | hBackupCanceled | 2 | Copia de seguridad cancelada | hBackupCompleted | 1 | Copia de seguridad completada | hBackupError | 3 | Error durante la copia de seguridad | hBackupInProgress | 0 | Creando copia de seguridad |
- <Mensaje de error>: Mensaje de error (si existe) en formato de string.
Funciones que utilizan variables hBackupDescription: | | HAddScheduledBackup | Agrega la programación de una copia de seguridad completa (con o sin copia de seguridad diferencial) en el servidor definido por la conexión. | HBackup | Realiza una copia de seguridad del contenido de un servidor HFSQL: todas las bases de datos del servidor, una o más bases de datos, uno o más archivos de datos. | HListScheduledBackup | Lista las copias de seguridad completas y diferenciales que se programaron en un servidor HFSQL Client/Server. | HModifyScheduledBackup | Modifica una copia de seguridad programada. |
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|