sp_help (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.

1. 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
   Name	nvarchar(128)	Nome dell'oggetto.
   Owner	nvarchar(128)	Proprietario dell'oggetto.
   Object_type	nvarchar(31)	Tipo di oggetto.

2. 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.
   Nullable	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.

3. 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
   Name	nvarchar(128)	Nome della tabella.
   Owner	nvarchar(128)	Proprietario della tabella.
   Type	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 della colonna.
     Type	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 supportati 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 creato l'indice.

   • 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'operazione DELETE è No Action, CASCADE o N/A. Valido solo per i vincoli FOREIGN KEY.
     update_action	nvarchar(9)	Indica se l'operazione UPDATE è No Action, CASCADE 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 del 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.
     Type	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

USE master;
GO
EXEC sp_help;
GO

B. Restituzione di informazioni su un solo oggetto

USE AdventureWorks;
GO
EXEC sp_help 'Person.Contact';
GO

Vedere anche

Riferimento