Sdílet prostřednictvím


sp_help (Transact-SQL)

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL databáze v Microsoft Fabric

Hlásí informace o databázovém objektu (jakýkoli objekt uvedený v pohledu sys.sysobjects kompatibility), uživatelem definovaném datovém typu nebo datovém typu.

Transact-SQL konvence syntaxe

Syntaxe

sp_help [ [ @objname = ] N'objname' ]
[ ; ]

Arguments

[ @objname = ] N'objname'

Název libovolného objektu, v sys.sysobjects nebo jakéhokoliv uživatelem definovaného datového typu v tabulce sys.systypes . @objname je nvarchar(776), s výchozím hodnotou NULL. Názvy databází nejsou přijatelné. Mohou být vymezeny názvy dvou nebo tří částí, například Person.AddressType nebo [Person].[AddressType].

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Výsledné množiny, které se vrátí, závisí na tom, zda je @name specifikováno, kdy je specifikováno a o jaký objekt v databázi se jedná.

  1. Pokud sp_help je vykonána bez argumentů, vrátí se souhrnné informace o objektech všech typů, které existují v aktuální databázi.

    Název sloupce Datový typ Description
    Name nvarchar(128) Název objektu
    Owner nvarchar(128) Vlastník objektu (Princip databáze, který vlastní objekt. Výchozí je vlastník schématu, které obsahuje objekt.)
    Object_type nvarchar(31) Typ objektu
  2. Pokud je @name datový typ SQL Serveru nebo uživatelem definovaný datový typ, sp_help vrátí tuto výslednou sadu.

    Název sloupce Datový typ Description
    Type_name nvarchar(128) Název datového typu.
    Storage_type nvarchar(128) Typ názvu SQL Serveru.
    Length smallint Fyzická délka datového typu (v bajtech).
    Prec int Přesnost (celkový počet číslic).
    Scale int Počet číslic napravo od desetinného čísla.
    Nullable Varchar(35) Označuje, zda NULL jsou hodnoty povoleny: Yes nebo No.
    Default_name nvarchar(128) Název výchozího zařízení je vázán na tento typ.

    NULL = Není omezeno žádné výchozí nastavení.
    Rule_name nvarchar(128) Název pravidla vázaného na tento typ.

    NULL = Není omezeno žádné výchozí nastavení.
    Collation sysname Třídění datového typu. NULL pro datové typy mimo znaky.
  3. Pokud je @name jakýkoli objekt databáze jiný než datový typ, vrací sp_help tuto množinu výsledků a také další množiny výsledků na základě typu určeného objektu.

    Název sloupce Datový typ Description
    Name nvarchar(128) Název tabulky
    Owner nvarchar(128) Majitel stolu
    Type nvarchar(31) Typ tabulky
    Created_datetime datetime Vytvořená tabulka dat

    V závislosti na specifikovaném objektu databáze vrací sp_help další sady výsledků.

    Pokud je @name systémová tabulka, uživatelská tabulka nebo pohled sp_help , vrátí následující množiny výsledků. Nicméně výsledná sada, která popisuje, kde se datový soubor nachází ve skupině souborů, se pro zobrazení nevrátí.

    • Následující množina výsledků se také vrací u sloupcových objektů:

      Název sloupce Datový typ Description
      Column_name nvarchar(128) Název sloupce
      Type nvarchar(128) Datový typ sloupce
      Computed Varchar(35) Označuje, zda jsou hodnoty ve sloupci vypočteny: Yes nebo No.
      Length int Délka sloupce v bajtech.

      Poznámka: Pokud je datový typ sloupce typ s velkou hodnotou (varchar(max),nvarchar(max),varbinary(max) nebo xml), hodnota se zobrazí jako -1.
      Prec char(5) Přesnost sloupce.
      Scale char(5) Stupová škála.
      Nullable Varchar(35) Označuje, zda NULL jsou ve sloupci povoleny hodnoty: Yes nebo No.
      TrimTrailingBlanks Varchar(35) Ořízněte zadní prázdné náboje. Vrací Yes nebo No.
      FixedLenNullInSource Varchar(35) Tento parametr je zastaralý a je zachován kvůli zpětné kompatibilitě skriptů.
      Collation sysname Zařazení sloupku. NULL pro datové typy bez znaků.
    • Následující množina výsledků je také vrácena na sloupcích identity:

      Název sloupce Datový typ Description
      Identity nvarchar(128) Název sloupce, jehož datový typ je deklarován jako identita.
      Seed číselný Počáteční hodnota pro sloupec identity.
      Increment číselný Přírůstek pro použití pro hodnoty v tomto sloupci.
      Not For Replication int IDENTITY vlastnost není vynucena, když replikační přihlášení, například sqlrepl, vkládá data do tabulky:

      1 = Pravda
      0 = Nepravda
    • Následující množina výsledků se také vrací ve sloupcích:

      Název sloupce Datový typ Description
      RowGuidCol sysname Název sloupce globálního jedinečného identifikátoru.
    • Následující množina výsledků je také vrácena ve skupinách souborů:

      Název sloupce Datový typ Description
      Data_located_on_filegroup nvarchar(128) Souborová skupina, Primaryve které se data nacházejí: , Secondary, nebo Transaction Log.
    • Následující množina výsledků se také vrací na indexech:

      Název sloupce Datový typ Description
      index_name sysname Název indexu.
      Index_description Varchar(210) Popis indexu.
      index_keys nvarchar(2078) Názvy sloupců, na kterých je index postaven. Návraty NULL pro paměťově optimalizované indexy columnstore.
    • Následující množina výsledků je také vrácena na omezení:

      Název sloupce Datový typ Description
      constraint_type nvarchar(146) Typ omezení.
      constraint_name nvarchar(128) Název omezení.
      delete_action nvarchar(9) Označuje, zda je DELETE akce akcí , NO_ACTIONCASCADE, SET_NULL, SET_DEFAULT, nebo N/A.

      Platí pouze pro omezení CIZÍHO KLÍČE.
      update_action nvarchar(9) Označuje, zda je UPDATE akce akcí , NO_ACTIONCASCADE, SET_NULL, SET_DEFAULT, nebo N/A.

      Platí pouze pro FOREIGN KEY omezení.
      status_enabled varchar(8) Označuje, zda je omezení povoleno: Enabled, Disabled, nebo N/A.

      Platí pouze pro CHECK a FOREIGN KEY omezení.
      status_for_replication varchar(19) Označuje, zda je omezení určeno pro replikaci.

      Platí pouze pro CHECK a FOREIGN KEY omezení.
      constraint_keys nvarchar(2078) Názvy sloupců, které tvoří omezení, nebo v případě výchozích nastavení a pravidel textu, který definuje výchozí nebo pravidlo.
    • Následující množina výsledků se také vrací při odkazujících objektech:

      Název sloupce Datový typ Description
      Table is referenced by nvarchar(516) Identifikuje další databázové objekty, které odkazují na tabulku.
    • Následující množina výsledků je také vrácena u uložených procedur, funkcí nebo rozšířených uložených procedur.

      Název sloupce Datový typ Description
      Parameter_name nvarchar(128) Název parametru uložené procedury.
      Type nvarchar(128) Typ dat parametru uložené procedury.
      Length smallint Maximální fyzická délka paměti, v bajtech.
      Prec int Přesnost nebo celkový počet číslic.
      Scale int Počet číslic napravo od desetinné čárky.
      Param_order smallint Pořadí parametrů.

Poznámky

Procedura sp_help hledá objekt pouze v aktuální databázi.

Když @name není specifikován, zobrazí sp_help se názvy objektů, majitelé a typy objektů pro všechny objekty v aktuální databázi. sp_helptrigger poskytuje informace o spouštěčích.

sp_help zobrazuje pouze pořaditelné indexové sloupce; proto neposkytuje informace o XML indexech nebo prostorových indexech.

Povolení

Vyžaduje členství ve veřejné roli . Uživatel musí mít alespoň jedno oprávnění k @objname. Pro zobrazení sloupcových omezení, výchozích nastavení nebo pravidel musíte mít VIEW DEFINITION povolení k tabulce.

Examples

Ukázky kódu v tomto článku používají ukázkovou databázi AdventureWorks2025 nebo AdventureWorksDW2025, kterou si můžete stáhnout z domovské stránky Microsoft SQL Serveru pro ukázky a komunitní projekty .

A. Vraťte informace o všech objektech

Následující příklad uvádí master informace o každém objektu v databázi.

USE master;
GO

EXECUTE sp_help;
GO

B. Vrácení informací o jednom objektu

Následující příklad zobrazuje informace o tabulce Person.Person .

USE AdventureWorks2022;
GO

EXECUTE sp_help 'Person.Person';
GO