sp_db_vardecimal_storage_format (Transact-SQL)

Syntaxe

sp_db_vardecimal_storage_format [ [ @dbname = ] 'database_name'] 
    [ , [ @vardecimal_storage_format = ] { 'ON' | 'OFF' } ] [;]

Arguments

• [ [ @dbname= ] 'database_name'
  Nom de la base de données dont le format de stockage doit être modifié. database_name est de type sysname et ne possède pas de valeur par défaut. Si le nom de la base de données est omis, l'état du format de stockage vardecimal de toutes les bases de données dans l'instance de SQL Server est retourné.

• [ @vardecimal_storage_format = ] {'ON'|'OFF'}
  Spécifie si le format de stockage vardecimal est activé. @vardecimal_storage_format peut prendre la valeur ON ou OFF (activé ou désactivé). Le paramètre est de type varchar(3), sans valeur par défaut. Si un nom de base de données est indiqué mais que @vardecimal_storage_format est omis, le paramètre actuel de la base de données spécifiée est retourné. Cet argument n'a aucun effet sur SQL Server 2008 ou les versions ultérieures.

Valeurs des codes de retour

0 (réussite) ou 1 (échec)

Ensembles de résultats

Si le format de stockage de la base de données ne peut pas être modifié, sp_db_vardecimal_storage_format retourne une erreur. Si la base de données est déjà dans l'état spécifié, la procédure stockée est sans effet.

Si l'argument @vardecimal_storage_format n'est pas fourni, retourne les colonnes Nom de la base de données et l'état vardecimal.

Notes

sp_db_vardecimal_storage_format retourne l'état vardecimal mais ne peut pas le modifier.

sp_db_vardecimal_storage_format échoue dans les circonstances suivantes :

• Il existe des utilisateurs actifs dans la base de données.

• La base de données est activée pour la mise en miroir.

• L'édition de SQL Server ne prend pas en charge le format de stockage vardecimal.

Pour qu'il soit possible de basculer l'état du format de stockage vardecimal à OFF, une base de données doit être configurée en mode de récupération simple. Lorsqu'une base de données est configurée en mode de récupération simple, la séquence de journaux de transactions consécutifs est rompue. Procédez à une sauvegarde de base de données complète une fois que vous avez défini l'état du format de stockage vardecimal à OFF.

Le passage de l'état à OFF échouera si des tables utilisent la compression de base de données vardecimal. Pour modifier le format de stockage d'une table, utilisez sp_tableoption. Pour déterminer quelles sont les tables d'une base de données qui utilisent le format de stockage vardecimal, utilisez la fonction OBJECTPROPERTY et recherchez la propriété TableHasVarDecimalStorageFormat, comme indiqué dans l'exemple suivant.

USE AdventureWorks ;
GO
SELECT name, object_id, type_desc
FROM sys.objects 
 WHERE OBJECTPROPERTY(object_id, 
   N'TableHasVarDecimalStorageFormat') = 1 ;
GO

Exemples

Le code ci-dessous autorise la compression dans la base de données AdventureWorks, confirme l'état, puis compresse les colonnes décimales et numériques de la table Sales.SalesOrderDetail.

USE master ;
GO

EXEC sp_db_vardecimal_storage_format 'AdventureWorks', 'ON' ;
GO

-- Check the vardecimal storage format state for
-- all databases in the instance.
EXEC sp_db_vardecimal_storage_format ;
GO

USE AdventureWorks ;
GO

EXEC sp_tableoption 'Sales.SalesOrderDetail', 'vardecimal storage format', 1 ;
GO

Voir aussi

Référence

Concepts