Skip to main content
La consulta RESTORE admite opciones en su cláusula SETTINGS que controlan qué categorías de objetos se leen desde una copia de seguridad. Esta página documenta las opciones que determinan qué se restaura: datos de tablas, entidades de acceso y funciones definidas por el usuario.

​
structure_only

Tipo: Bool. Valor predeterminado: false. Cuando se establece en true, solo se leen de la copia de seguridad las consultas CREATE, no el contenido de los objetos restaurados. Es un atajo práctico que establece en false los valores predeterminados efectivos de las tres opciones de categoría siguientes:
  • restore_table_data
  • restore_access_entities
  • restore_functions

​
restore_table_data

Tipo: Bool. Opcional; si no se establece, el valor predeterminado es !structure_only (es decir, true a menos que se establezca structure_only). Indica si se deben restaurar los datos de las tablas. Cuando se establece explícitamente, sobrescribe structure_only: establézcalo en true para restaurar los datos de las tablas incluso si structure_only=true, o en false para omitirlos incluso si no se establece structure_only.

​
restore_access_entities

Tipo: Bool. Opcional; si no se establece, el valor predeterminado es !structure_only. Indica si se deben restaurar las entidades de acceso: usuarios, roles, perfiles de configuración, políticas de fila y cuotas. Si se establece explícitamente, sobrescribe structure_only.

​
restore_functions

Tipo: Bool. Opcional; si no se establece, su valor predeterminado es !structure_only. Indica si se deben restaurar las funciones definidas por el usuario. Cuando se establece explícitamente, sobrescribe structure_only.

​
Comportamiento efectivo

Cada categoría se restaura cuando su configuración correspondiente es true. Cuando no se especifica la configuración de una categoría, su valor se deriva de structure_only: las tres son true de forma predeterminada y las tres pasan a ser false cuando structure_only=true. Esto es totalmente compatible con versiones anteriores: una consulta RESTORE que no establece ninguna de las nuevas configuraciones se comporta exactamente como antes.

​
Ejemplos

Restaure las definiciones de las tablas y las entidades de acceso, pero no los datos de las tablas; por ejemplo, para configurar un entorno de pruebas o reproducir consultas sin copiar los datos:
Restaure únicamente los datos de la tabla, sin volver a crear las entidades de acceso ni las funciones definidas por el usuario:
Restaure todo excepto las funciones definidas por el usuario:
Última modificación el 17 de agosto de 2026