sp_help (Transact-SQL)

Data aggiornamento: 17 luglio 2006

Restituisce informazioni su un oggetto di database (gli oggetti elencati nella vista di compatibilità sys.sysobjects), un tipo di dati definito dall'utente oppure un tipo di dati di SQL Server 2005.

Importante:
Questa funzionalità è stata modificata rispetto alle versioni precedenti di SQL Server. Per ulteriori informazioni, vedere Differenze di funzionamento delle funzionalità del Motore di database in SQL Server 2005.

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.

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

   • 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 è attivato. 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. A differenza di quanto avviene in SQL Server 2000, in SQL Server 2005 le espressioni SQL vengono decodificate e archiviate nei metadati del catalogo. La semantica dell'espressione decodificata è equivalente al testo originale, tuttavia non è garantito che la sintassi venga mantenuta. Gli spazi vuoti, ad esempio, vengono eliminati dall'espressione decodificata. Per ulteriori informazioni, vedere Differenze di funzionamento delle funzionalità del Motore di database in SQL Server 2005.

   • 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.

Autorizzazioni

È richiesta l'appartenenza al ruolo public.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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 Contact.

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

Vedere anche

Riferimento

Stored procedure del Motore di database (Transact-SQL)
sp_helpgroup (Transact-SQL)
sp_helpindex (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helpserver (Transact-SQL)
sp_helptrigger (Transact-SQL)
sp_helpuser (Transact-SQL)
Stored procedure di sistema (Transact-SQL)
sys.sysobjects (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche