Skip to main content
A consulta RESTORE aceita configurações na cláusula SETTINGS que controlam quais categorias de objetos são lidas de um backup. Esta página documenta as configurações que determinam o que é restaurado: dados de tabelas, entidades de acesso e funções definidas pelo usuário.

structure_only

Tipo: Bool. Padrão: false. Quando definido como true, apenas consultas CREATE são lidas do backup, sem o conteúdo dos objetos restaurados. É um atalho prático que define como false os valores padrão efetivos das três configurações de categoria abaixo:
  • restore_table_data
  • restore_access_entities
  • restore_functions

restore_table_data

Tipo: Bool. Opcional; se não for definido, o padrão será !structure_only (ou seja, true a menos que structure_only esteja definido). Define se os dados das tabelas devem ser restaurados. Quando definido explicitamente, substitui structure_only: defina como true para restaurar os dados das tabelas mesmo quando structure_only=true, ou como false para ignorar os dados das tabelas mesmo quando structure_only não estiver definido.

restore_access_entities

Tipo: Bool. Opcional; se não for definido, o padrão será !structure_only. Indica se as entidades de acesso — usuários, funções, perfis de configurações, políticas de linha e cotas — devem ser restauradas. Quando definido explicitamente, substitui structure_only.

restore_functions

Tipo: Bool. Opcional; quando não definido, o padrão é !structure_only. Define se as funções definidas pelo usuário devem ser restauradas. Quando definido explicitamente, substitui structure_only.

Comportamento efetivo

Cada categoria é restaurada quando a configuração correspondente é true. Quando uma configuração de categoria não é especificada, seu valor é derivado de structure_only: todas as três são true por padrão e todas se tornam false quando structure_only=true. Isso é totalmente compatível com versões anteriores: uma consulta RESTORE que não define nenhuma das novas configurações se comporta exatamente como antes.

Exemplos

Restaure as definições das tabelas e as entidades de acesso, mas não os dados das tabelas — por exemplo, para configurar um ambiente de testes ou reproduzir consultas sem copiar os dados:
Restaure apenas os dados da tabela, sem recriar entidades de acesso nem funções definidas pelo usuário:
Restaure tudo, exceto as funções definidas pelo usuário:
Última modificação em 17 de agosto de 2026