RESTORE accepte
des paramètres dans sa clause SETTINGS qui déterminent les catégories d’objets lues
depuis une sauvegarde. Cette page décrit les paramètres qui déterminent les éléments restaurés : les données des tables,
les entités d’accès et les fonctions définies par l’utilisateur.
structure_only
Bool. Par défaut : false.
Lorsqu’il est défini sur true, seules les requêtes CREATE sont lues depuis la sauvegarde, à l’exclusion du
contenu des objets restaurés. Il s’agit d’un raccourci pratique qui définit les
valeurs par défaut effectives des trois paramètres de catégorie ci-dessous à false :
restore_table_datarestore_access_entitiesrestore_functions
restore_table_data
Bool. Facultatif ; s’il n’est pas défini, sa valeur par défaut est !structure_only (c.-à-d. true
sauf si structure_only est défini).
Indique si les données des tables doivent être restaurées. Lorsqu’il est défini explicitement, il surcharge
structure_only : définissez-le sur true pour restaurer les données des tables même si
structure_only=true, ou sur false pour les ignorer même si structure_only
n’est pas défini.
restore_access_entities
Bool. Facultatif ; s’il n’est pas défini, sa valeur par défaut est !structure_only.
Indique s’il faut restaurer les entités d’accès — utilisateurs, rôles, profils de paramètres, politiques de lignes
et quotas. Lorsqu’il est défini explicitement, il surcharge structure_only.
restore_functions
Bool. Facultatif ; s’il n’est pas défini, sa valeur par défaut est !structure_only.
Indique si les fonctions définies par l’utilisateur doivent être restaurées. Lorsqu’il est défini explicitement, il surcharge
structure_only.
Comportement effectif
true. Lorsqu’un paramètre de catégorie
n’est pas spécifié, sa valeur est déterminée par structure_only : les trois sont
définis sur true par défaut et passent tous les trois à false lorsque structure_only=true.
Cette approche est entièrement rétrocompatible : une requête
RESTORE qui ne définit aucun des
nouveaux paramètres se comporte exactement comme auparavant.