AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Tipos de variables HFSQL
  • 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:
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
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.
Ejemplo
// 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.
denominarTipo utilizadoEfecto
CompresiónConstante de tipo IntegerSe 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.
ConIndexbooleano
  • 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.
descriptionCadena de caracteresdescription associated con el respaldo.
Esta propiedad es opcional.
La copia de seguridad description corresponde a una cadena vacía ("") de Default.
DestinoCadena de caracteresDestino 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%%"
drogadictaCadena de caracteresUsuario que ha creado la copia de seguridad.
Esta propiedad es de solo lectura.
Fuente (*)Cadena de caracteresFiltro 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.
HabilitadobooleanoSe 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.
IdentificadorIntegroIdentificador de la copia de seguridad.
Esta propiedad es de solo lectura.
LimitNumberBackupsIntegroNú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".
ProcedimientoAntesCadena de caracteresNombre 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ésCadena de caracteresNombre 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ónCompletaVariable de tipo hSchedulingCaracterísticas de una programación completa. Esta Property debe ser necesariamente especificada.
ProgramaciónDiferencialVariable de tipo hSchedulingCaracterí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.
ProgressBarNombre del controlNombre 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ésCadena de caracteresURL 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):
  1. 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).
  2. Ejecutar el "Before Procedure".
  3. Copia de seguridad.
  4. Ejecutar el "After Procedure".
  5. 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 Archivo1Hace una copia de seguridad de copy de <Nombre del archivo1> que se encuentra en <Nombre de la base de datos>
    sistemaHace 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 Archivo1Hace una copia de seguridad de copy de <Nombre del archivo1> que se encuentra en <Nombre de la base de datos>
    sistemaHace 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:
    hBackupCanceled2Copia de seguridad cancelada
    hBackupCompleted1Copia de seguridad completada
    hBackupError3Error durante la copia de seguridad
    hBackupInProgress0Creando copia de seguridad
  • <Mensaje de error>: Mensaje de error (si existe) en formato de string.

Funciones que utilizan variables hBackupDescription:

HAddScheduledBackupAgrega la programación de una copia de seguridad completa (con o sin copia de seguridad diferencial) en el servidor definido por la conexión.
HBackupRealiza 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.
HListScheduledBackupLista las copias de seguridad completas y diferenciales que se programaron en un servidor HFSQL Client/Server.
HModifyScheduledBackupModifica una copia de seguridad programada.
Versión mínima requerida
  • Versión 14
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/01/2023

Señalar un error o enviar una sugerencia | Ayuda local