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.

Icona di collegamento a un argomentoConvenzioni 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.

  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 oggetto

    Proprietario

    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.

    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.

  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.

    Proprietario

    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.

      Tipo

      nvarchar(128)

      Tipo di dati della colonna.

      Computed

      varchar(35)

      Indica se i valori della colonna sono calcolati (Yes o No).

      Lunghezza

      int

      Lunghezza della colonna in byte.

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

      Scala

      char(5)

      Scala della colonna.

      Ammette valori Null

      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.

      Regole di confronto

      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

      Identità

      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.

      Non applicare in processi di replica

      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.

    • 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. SET_NULL e SET_DEFAULT vengono visualizzati come No action.

      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. SET_NULL e SET_DEFAULT vengono visualizzati come No action.

      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.

      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

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 colonna Person della tabella Person.

USE AdventureWorks2008R2;
GO
EXEC sp_help 'Person.Person';
GO