Exporter (0) Imprimer
Développer tout

sp_tableoption (Base de données SQL Azure)

Cette rubrique est obsolète. La version actualisée est disponible à la page Référence SQL 14 Transact-SQL.

ImportantImportant
Cette rubrique n'est pas tenue à jour. Pour obtenir la version actuelle, consultez sp_tableoption.

Définit les valeurs d'option des tables définies par l'utilisateur. La procédure sp_tableoption peut être utilisée pour contrôler le comportement dans la ligne des tables comportant des colonnes varchar(max), nvarchar(max), varbinary(max), xml, text, ntext ou image.

Conventions de syntaxe (Base de données SQL Azure)

sp_tableoption [ @TableNamePattern = ] 'table' 
     , [ @OptionName = ] 'option_name' 
     ,[ @OptionValue =] 'value'

[ @TableNamePattern =] 'table'
Spécifie le nom qualifié ou non d'une table de base de données définie par l'utilisateur. Si un nom complet de table (incluant un nom de base de données) est fourni, le nom de base de données doit être celui de la base de données active. Vous ne pouvez pas définir simultanément les options des tables pour plusieurs tables. table est de type nvarchar(776), et n'a pas de valeur par défaut.

[ @OptionName = ] 'option_name'
Spécifie un nom d'option de table. option_name est de type varchar(35) et n'a pas de valeur par défaut égale à NULL. option_name peut prendre l'une des valeurs suivantes.

 

Valeur Description

table lock on bulk load

Désactivée (valeur par défaut), oblige le processus de chargement en masse effectué sur les tables définies par l'utilisateur à obtenir des verrous de lignes. Activée, oblige le processus de chargement en masse effectué sur les tables définies par l'utilisateur à obtenir un verrou de mise à jour en bloc.

insert row lock

Non pris en charge.

text in row

Si la valeur est OFF ou 0 (désactivé, valeur par défaut), le comportement en cours n'est pas modifié, et la ligne ne contient pas d'objet BLOB.

Lorsqu'elle est spécifiée et que la valeur de @OptionValue est ON (activé) ou une valeur de type entier comprise entre 24 et 7 000, les nouvelles chaînes text, ntext ou image sont stockées directement dans la ligne de données. Tous les objets BLOB existants (données text, ntext ou image) sont convertis au format text in row lors de la mise à jour de la valeur de l'objet BLOB.

large value types out of row

1 = Les colonnes varchar(max), nvarchar(max), varbinary(max) et xml de la table sont stockées hors de la ligne, avec un pointeur de 16 octets vers la racine.

0 = Les valeurs varchar(max), nvarchar(max), varbinary(max) et xml sont stockées directement dans la ligne de données, jusqu'à une limite de 8 000 octets et tant que la valeur peut être contenue dans l'enregistrement. Si la valeur ne tient pas dans l'enregistrement, un pointeur est stocké dans la ligne et le reste est stocké hors de la ligne dans l'espace de stockage LOB. 0 est la valeur par défaut.

format de stockage vardecimal

Non pris en charge.

[ @OptionValue =] 'value'
Spécifie si option_name est activé (TRUE, ON ou 1) ou désactivé (FALSE, OFF ou 0). Le paramètre value est de type varchar(12), sans valeur par défaut. Le paramètre value ne tient pas compte de la casse.

Pour l'option text in row, les valeurs d'option valides sont 0, ON, OFF ou un entier compris entre 24 et 7 000. Lorsque value a la valeur ON, la limite a comme valeur par défaut 256 octets.

Pour plus d'informations sur les arguments et la procédure stockée système sp_tableoption, consultez sp_tableoption dans la Documentation en ligne de SQL Server.

Renvoie 0 en cas de réussite ou un numéro d'erreur en cas d'échec.

L'exécution de sp_tableoption nécessite l'autorisation ALTER sur la table.

Pour examiner les valeurs d'option pour une table spécifique, interrogez l'affichage catalogue sys.tables.

En cas d'utilisation d'une option vardecimal storage format non prise en charge, le message d'erreur suivant est renvoyé : « 40512 : fonctionnalité abandonnée. Le format de stockage VarDecimal n'est pas pris en charge dans cette version de SQL Server ». De même, l'erreur « 15600 : Paramètre ou option non valide pour la procédure 'sys.sp_tableoption' » se produit en cas d'utilisation du nom d'option insert row lock.

Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft