Delen via

sp_help (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric

Rapporteert informatie over een databaseobject (elk object dat in de sys.sysobjects compatibiliteitsweergave wordt vermeld), een door de gebruiker gedefinieerd datatype of een datatype.

Transact-SQL syntaxis-conventies

Syntaxis

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

Arguments

[ @objname = ] N'objname'

De naam van elk object, in sys.sysobjects of een door de gebruiker gedefinieerd datatype in de sys.systypes tabel. @objname is nvarchar(776), met een standaard van NULL. Databasenamen zijn niet acceptabel. Twee of drie partijnamen kunnen worden afgebakend, zoals Person.AddressType of [Person].[AddressType].

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

De resultaatsets die worden teruggegeven hangen af van of @name is gespecificeerd, wanneer het wordt gespecificeerd en welk databaseobject het is.

  1. Als sp_help wordt uitgevoerd zonder argumenten, wordt samenvattende informatie teruggegeven van objecten van alle typen die in de huidige database bestaan.

    Kolomnaam Gegevenstype Description
    Name nvarchar(128) Objectnaam
    Owner nvarchar(128) Object eigenaar (De databaseprincipal die het object bezit. Standaard is de eigenaar van het schema dat het object bevat.)
    Object_type Nvarchar(31) Objectsoort

  2. Als @name een SQL Server-datatype of door de gebruiker gedefinieerd datatype is, sp_help geeft deze resultaatset terug.

    Kolomnaam Gegevenstype Description
    Type_name nvarchar(128) Datatypenaam.
    Storage_type nvarchar(128) SQL Server-typenaam.
    Length smallint Fysieke lengte van het datatype (in bytes).
    Prec int Precisie (totaal aantal cijfers).
    Scale int Aantal cijfers rechts van het decimaal.
    Nullable Varchar(35) Geeft aan of NULL waarden zijn toegestaan: Yes of No.
    Default_name nvarchar(128) Naam van een standaardbound voor dit type.

    NULL = Geen standaard is gebonden.
    Rule_name nvarchar(128) Naam van een regel die aan dit type gebonden is.

    NULL = Geen standaard is gebonden.
    Collation sysname Verzameling van het datatype. NULL voor niet-karakter datatypes.

  3. Als @name een ander databaseobject is dan een datatype, sp_help geeft dit deze resultaatset en ook aanvullende resultaatsets terug, gebaseerd op het type object.

    Kolomnaam Gegevenstype Description
    Name nvarchar(128) Tabelnaam
    Owner nvarchar(128) Tafeleigenaar
    Type Nvarchar(31) Tabeltype
    Created_datetime datetime Datumtabel aangemaakt

    Afhankelijk van het gespecificeerde databaseobject, sp_help levert extra resultaatsets op.

    Als @name een systeemtabel, gebruikerstabel of weergave is, sp_help geeft het de volgende resultaatsets terug. De resultaatset die beschrijft waar het databestand zich bevindt in een bestandsgroep wordt echter niet teruggegeven voor een weergave.

    • De volgende resultaatset wordt ook teruggegeven op kolomobjecten:

      Kolomnaam Gegevenstype Description
      Column_name nvarchar(128) Kolomnaam.
      Type nvarchar(128) Kolomgegevenstype.
      Computed Varchar(35) Geeft aan of de waarden in de kolom worden berekend: Yes of No.
      Length int Kolomlengte in bytes.

      Notitie: Als het kolomdatatype een groot waardetype is (varchar(max),nvarchar(max),varbinary(max) of xml), wordt de waarde weergegeven als -1.
      Prec char(5) Kolomprecisie.
      Scale char(5) Kolomschaal.
      Nullable Varchar(35) Geeft aan of NULL waarden zijn toegestaan in de kolom: Yes of No.
      TrimTrailingBlanks Varchar(35) Knip de achterliggende blanks af. Retourneert Yes of No.
      FixedLenNullInSource Varchar(35) Deze parameter is verouderd en wordt behouden voor achterwaartse compatibiliteit van scripts.
      Collation sysname Samenstelling van de kolom. NULL voor niet-karakter datatypes.

    • De volgende resultaatset wordt ook teruggegeven op identiteitskolommen:

      Kolomnaam Gegevenstype Description
      Identity nvarchar(128) Kolomnaam waarvan het datatype als identiteit is verklaard.
      Seed numeriek Startwaarde voor de identiteitskolom.
      Increment numeriek Verhoog het gebruik voor waarden in deze kolom.
      Not For Replication int IDENTITY Eigenschap wordt niet afgedwongen wanneer een replicatielogin, zoals SQLREPL, gegevens in de tabel invoegt:

      1 = Waar
      0 = Onwaar

    • De volgende resultaatset wordt ook teruggegeven op kolommen:

      Kolomnaam Gegevenstype Description
      RowGuidCol sysname Naam van de kolom globale unieke identificatie.

    • De volgende resultaatset wordt ook teruggegeven op filegroups:

      Kolomnaam Gegevenstype Description
      Data_located_on_filegroup nvarchar(128) Bestandsgroep waarin de gegevens zich bevinden: Primary, Secondary, of Transaction Log.

    • De volgende resultaatset wordt ook teruggegeven op indexen:

      Kolomnaam Gegevenstype Description
      index_name sysname Index naam.
      Index_description Varchar(210) Beschrijving van de index.
      index_keys Nvarchar(2078) Kolomnamen waarop de index is gebouwd. Retourneert NULL voor geheugengeoptimaliseerde kolomopslagindexen.

    • De volgende resultaatset wordt ook teruggegeven op constraints:

      Kolomnaam Gegevenstype Description
      constraint_type Nvarchar(146) Soort beperking.
      constraint_name nvarchar(128) Naam van de beperking.
      delete_action Nvarchar(9) Geeft aan of de DELETE actie een van NO_ACTION, CASCADE, SET_NULL, , SET_DEFAULTof N/Ais.

      Alleen van toepassing op FOREIGN KEY-beperkingen.
      update_action Nvarchar(9) Geeft aan of de UPDATE actie een van NO_ACTION, CASCADE, SET_NULL, , SET_DEFAULTof N/Ais.

      Alleen van toepassing op FOREIGN KEY beperkingen.
      status_enabled varchar(8) Geeft aan of de beperking is ingeschakeld: Enabled, Disabled, of N/A.

      Alleen van toepassing op CHECK en beperkingen FOREIGN KEY .
      status_for_replication varchar(19) Geeft aan of de beperking voor replicatie is.

      Alleen van toepassing op CHECK en beperkingen FOREIGN KEY .
      constraint_keys Nvarchar(2078) Namen van de kolommen die de beperking vormen of, in het geval van standaardregels en regels, de tekst die de standaard of regel definieert.

    • De volgende resultaatset wordt ook teruggegeven bij referentieobjecten:

      Kolomnaam Gegevenstype Description
      Table is referenced by Nvarchar(516) Identificeert andere databaseobjecten die naar de tabel verwijzen.

    • De volgende resultaatset wordt ook teruggegeven op opgeslagen procedures, functies of uitgebreide opgeslagen procedures.

      Kolomnaam Gegevenstype Description
      Parameter_name nvarchar(128) Naam van de opgeslagen procedureparameter.
      Type nvarchar(128) Gegevenstype van de parameter van de opgeslagen procedure.
      Length smallint Maximale fysieke opslaglengte, in bytes.
      Prec int Precisie of totaal aantal cijfers.
      Scale int Aantal cijfers rechts van het decimale punt.
      Param_order smallint Volgorde van de parameter.

Opmerkingen

De sp_help procedure zoekt alleen naar een object in de huidige database.

Wanneer @name niet is gespecificeerd, sp_help worden objectnamen, eigenaren en objecttypes vermeld voor alle objecten in de huidige database. sp_helptrigger Geeft informatie over triggers.

sp_help stelt alleen ordenbare indexkolommen bloot; daarom geeft het geen informatie over XML-indexen of ruimtelijke indexen.

Permissions

Vereist lidmaatschap van de openbare rol. De gebruiker moet minstens één toestemming hebben op @objname. Om kolombeperkingssleutels, standaardinstellingen of regels te bekijken, moet je toestemming hebben VIEW DEFINITION voor de tabel.

Voorbeelden

De codevoorbeelden in dit artikel gebruiken de AdventureWorks2025 of AdventureWorksDW2025 voorbeelddatabase die u kunt downloaden van de startpagina van Microsoft SQL Server Samples en Community Projects .

Eén. Retourinformatie over alle objecten

Het volgende voorbeeld geeft informatie over elk object in de master database weer.

USE master;
GO

EXECUTE sp_help;
GO

B. Retourinformatie over één enkel object

Het volgende voorbeeld toont informatie over de Person.Person tabel.

USE AdventureWorks2022;
GO

EXECUTE sp_help 'Person.Person';
GO

Verwante inhoud

  • Last updated on