Condividi tramite


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

  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

    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

  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

    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)

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)