sp_help (Transact-SQL)
Restituisce informazioni su un oggetto di database (tutti gli oggetti elencati nella vista di compatibilità sys.sysobjects), un tipo di dati definito dall'utente oppure un tipo di dati.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
sp_help [ [ @objname = ] 'name' ]
Argomenti
- [ @objname=] 'name'
Nome di un oggetto di sysobjects o di un tipo di dati definito dall'utente della tabella systypes. name è di tipo nvarchar(776) e il valore predefinito è NULL. I nomi di database non sono validi.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Set di risultati
I set di risultati restituiti variano a seconda che name sia stato specificato o meno e a seconda dell'eventuale tipo di oggetto di database specificato.
Se la stored procedure sp_help viene eseguita senza alcun argomento, vengono restituite le informazioni di riepilogo relative agli oggetti di qualsiasi tipo del database corrente.
Nome colonna
Tipo di dati
Descrizione
Nome
nvarchar(128)
Nome oggetto
Proprietario
nvarchar(128)
Proprietario dell'oggetto. Si tratta dell'entità di database proprietaria dell'oggetto. Corrispondente per impostazione predefinita al proprietario dello schema contenente l'oggetto.
Object_type
nvarchar(31)
Tipo di oggetto
Se il tipo di dati di name è uno dei tipi di dati di SQL Server o un tipo di dati definito dall'utente, la stored procedure sp_help restituisce il set di risultati seguente.
Nome colonna
Tipo di dati
Descrizione
Type_name
nvarchar(128)
Nome del tipo di dati.
Storage_type
nvarchar(128)
Nome del tipo di archiviazione di SQL Server.
Length
smallint
Lunghezza fisica del tipo di dati in byte.
Prec
int
Precisione, ovvero il numero totale di cifre.
Scale
int
Numero di cifre a destra del separatore decimale.
Ammette valori Null
varchar(35)
Indica se i valori NULL sono supportati. I possibili valori sono Yes o No.
Default_name
nvarchar(128)
Nome del valore predefinito associato al tipo di dati specificato.
NULL = Non è associato alcun valore predefinito.
Rule_name
nvarchar(128)
Nome di una regola associata al tipo di dati specificato.
NULL = Non è associata alcuna regola predefinita.
Collation
sysname
Regole di confronto per il tipo di dati. Per i tipi di dati non carattere, è NULL.
Se name corrisponde a un oggetto di database diverso da un tipo di dati, la stored procedure sp_help restituisce il set di risultati riportato di seguito, oltre a set di risultati aggiuntivi basati sul tipo di oggetto specificato.
Nome colonna
Tipo di dati
Descrizione
Nome
nvarchar(128)
Nome tabella
Proprietario
nvarchar(128)
Proprietario della tabella.
Tipo
nvarchar(31)
Tipo di tabella.
Created_datetime
datetime
Data di creazione della tabella.
A seconda dell'oggetto di database specificato, la stored procedure sp_help restituisce set di risultati aggiuntivi.
Se name è una tabella di sistema, una tabella utente o una vista, la stored procedure sp_help restituisce i set di risultati seguenti. Per le viste non viene tuttavia restituito il set di risultati relativo alla posizione del file di dati in un filegroup.
Set di risultati aggiuntivo restituito per gli oggetti colonna
Nome colonna
Tipo di dati
Descrizione
Column_name
nvarchar(128)
Nome colonna.
Tipo
nvarchar(128)
Tipo di dati della colonna.
Computed
varchar(35)
Indica se i valori della colonna sono calcolati (Yes o No).
Length
int
Lunghezza della colonna in byte.
[!NOTA]
Se il tipo di dati della colonna è un tipo per valori di grandi dimensioni (varchar(max), nvarchar(max), varbinary(max) o xml), il valore visualizzato sarà -1.
Prec
char(5)
Precisione della colonna.
Scale
char(5)
Scala della colonna.
Nullable
varchar(35)
Indica se nella colonna sono consentiti i valori Null. I possibili valori sono Yes o No.
TrimTrailingBlanks
varchar(35)
Specifica se gli spazi vuoti finali devono essere eliminati o meno. Restituisce Yes o No.
FixedLenNullInSource
varchar(35)
Disponibile per compatibilità con le versioni precedenti.
Collation
sysname
Regole di confronto della colonna. NULL per i tipi di dati non carattere.
Set di risultati aggiuntivo restituito per le colonne Identity
Nome colonna
Tipo di dati
Descrizione
Identity
nvarchar(128)
Nome della colonna il cui tipo di dati viene dichiarato come Identity.
Seed
numeric
Valore iniziale per la colonna Identity.
Increment
numeric
Incremento da utilizzare per i valori della colonna.
Not For Replication
int
La proprietà IDENTITY non viene applicata quando un account di accesso di replica, quale sqlrepl, inserisce dati nella tabella:
1 = True
0 = False
Set di risultati aggiuntivo restituito per le colonne
Nome colonna
Tipo di dati
Descrizione
RowGuidCol
sysname
Nome della colonna che include il valore GUID.
Set di risultati aggiuntivo restituito per i filegroup
Nome colonna
Tipo di dati
Descrizione
Data_located_on_filegroup
nvarchar(128)
Filegroup in cui si trovano i dati (primario, secondario o log delle transazioni).
Set di risultati aggiuntivo restituito per gli indici:
Nome colonna
Tipo di dati
Descrizione
index_name
sysname
Nome dell'indice.
Index_description
varchar(210)
Descrizione dell'indice.
index_keys
nvarchar(2078)
Nomi delle colonne in cui viene compilato l'indice. Restituisce NULL per gli indici columnstore ottimizzati in memoria xVelocity.
Set di risultati aggiuntivo restituito per i vincoli:
Nome colonna
Tipo di dati
Descrizione
constraint_type
nvarchar(146)
Tipo di vincolo.
constraint_name
nvarchar(128)
Nome del vincolo.
delete_action
nvarchar(9)
Indica se l'azione DELETE è NO_ACTION, CASCADE, SET_NULL, SET_DEFAULT o N/A.
Valido solo per i vincoli FOREIGN KEY.
update_action
nvarchar(9)
Indica se l'azione UPDATE è NO_ACTION, CASCADE, SET_NULL, SET_DEFAULT o N/A.
Valido solo per i vincoli FOREIGN KEY.
status_enabled
varchar(8)
Indica se il vincolo è abilitato. I possibili valori sono Enabled, Disabled o N/D.
Valido solo per i vincoli CHECK e FOREIGN KEY.
status_for_replication
varchar(19)
Indica se il vincolo è relativo alla replica.
Valido solo per i vincoli CHECK e FOREIGN KEY.
constraint_keys
nvarchar(2078)
Nomi delle colonne che formano il vincolo o, nel caso di valori predefiniti e regole, il testo che definisce il valore predefinito o la regola.
Set di risultati aggiuntivo restituito per gli oggetti di riferimento
Nome colonna
Tipo di dati
Descrizione
Table is referenced by
nvarchar(516)
Identifica gli oggetti di database che fanno riferimento alla tabella.
Set di risultati aggiuntivo restituito per stored procedure, funzioni o stored procedure estese
Nome colonna
Tipo di dati
Descrizione
Parameter_name
nvarchar(128)
Nome del parametro della stored procedure.
Tipo
nvarchar(128)
Tipo di dati del parametro della stored procedure.
Length
smallint
Capacità massima di archiviazione fisica in byte.
Prec
int
Precisione, ovvero il numero totale di cifre.
Scale
int
Numero di cifre a destra del separatore decimale.
Param_order
smallint
Ordine del parametro.
Osservazioni
La stored procedure sp_help esegue la ricerca di un oggetto solo nel database corrente.
Se name viene omesso, sp_help visualizza i nomi, i proprietari e i tipi di tutti gli oggetti del database corrente. sp_helptrigger restituisce informazioni sui trigger.
sp_help espone solo le colonne di indice ordinabili, pertanto non espone informazioni sugli indici XML o spaziali.
Autorizzazioni
È richiesta l'appartenenza al ruolo public. L'utente deve disporre di almeno un'autorizzazione per objname. Per visualizzare chiavi del vincolo di colonna, impostazioni predefinite o regole, è necessario disporre dell'autorizzazione VIEW DEFINITION per la tabella.
Esempi
A.Restituzione di informazioni su tutti gli oggetti
Nell'esempio seguente vengono elencate le informazioni su ogni oggetto incluso nel database master.
USE master;
GO
EXEC sp_help;
GO
B.Restituzione di informazioni su un solo oggetto
Nell'esempio seguente vengono visualizzate informazioni sulla tabella Person.
USE AdventureWorks2012;
GO
EXEC sp_help 'Person.Person';
GO
Vedere anche
Riferimento
Stored procedure del Motore di database (Transact-SQL)