sp_helptext (Transact-SQL)
Affiche la définition d'une règle définie par l'utilisateur, d'une procédure stockée Transact-SQL par défaut et non chiffrée, d'une fonction Transact-SQL définie par l'utilisateur, d'un déclencheur, d'une colonne calculée, d'une contrainte CHECK, d'une vue ou d'un objet système tel qu'une procédure stockée système.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe de Transact-SQL
Syntaxe
sp_helptext [ @objname = ] 'name' [ , [ @columnname = ] computed_column_name ]
Arguments
- [ @objname = ] 'name'
Spécifie le nom qualifié ou non d'un objet défini étendu aux schémas par l'utilisateur. Les guillemets ne sont nécessaires que si un objet qualifié est spécifié. Si un nom qualifié complet (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. Cet objet doit exister dans la base de données active. name est du type nvarchar(776), sans valeur par défaut.
- [ @columnname = ] 'computed_column_name'
Nom de la colonne calculée pour laquelle il faut afficher les informations de définition. La table qui contient la colonne doit être spécifiée en tant que name. column_name est du type sysname, sans valeur par défaut.
Jeux de résultats
| Nom de colonne | Type de données | Description |
|---|---|---|
Text |
nvarchar(255) |
Définition de l'objet |
Notes
sp_helptext affiche la définition utilisée pour créer un objet dans plusieurs lignes. Chaque ligne contient 255 caractères de la définition Transact-SQL. Cette définition réside dans la colonne definition de l'affichage catalogue sys.sql_modules.
Autorisations
Nécessite une appartenance au rôle public. Les définitions de l'objet système sont visibles publiquement. La définition des objets utilisateur est visible par le propriétaire de l'objet ou les bénéficiaires de l'une des autorisations suivantes : ALTER, CONTROL, TAKE OWNERSHIP ou VIEW DEFINITION.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Exemples
A. Affichage de la définition d'un déclencheur
L'exemple suivant affiche la définition du déclencheur uBillOfMaterials dans la base de données AdventureWorks.
USE AdventureWorks;
GO
EXEC sp_helptext 'Production.uBillOfMaterials';
GO
B. Affichage de la définition d'une colonne calculée
L'exemple suivant affiche la définition de la colonne calculée TotalDue dans la table SalesOrderHeader de la base de données AdventureWorks.
USE AdventureWorks;
GO
sp_helptext @objname = N'AdventureWorks.Sales.SalesOrderHeader', @columnname = TotalDue ;
GO
Voici l'ensemble des résultats.
Text
--------------------------------------------
(isnull(([SubTotal]+[TaxAmt])+[Freight],(0)))
Voir aussi
Référence
Procédures stockées du moteur de base de données (Transact-SQL)
OBJECT_DEFINITION (Transact-SQL)
sp_help (Transact-SQL)
sys.sql_modules (Transact-SQL)
Procédures stockées système (Transact-SQL)