sp_help (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Relata informações sobre um objeto de banco de dados (qualquer objeto listado na exibição de compatibilidade sys.sysobjects ), um tipo de dados definido pelo usuário ou um tipo de dados.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_help [ [ @objname = ] 'name' ]  

Argumentos

[ @objname = ] 'name' É o nome de qualquer objeto, em sysobjects ou qualquer tipo de dados definido pelo usuário na tabela systypes . name é nvarchar(776), com um padrão de NULL. Nomes de banco de dados não são aceitáveis. Nomes de duas ou três partes podem ser delimitados, como 'Person.AddressType' ou '[Person]. [AddressType]'.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Os conjuntos de resultados retornados dependem se o nome é especificado, quando é especificado e qual objeto de banco de dados ele é.

  1. Se sp_help for executado sem argumentos, as informações resumidas de objetos de todos os tipos existentes no banco de dados atual serão retornadas.

    Nome da coluna Tipo de dados Descrição
    Nome nvarchar(128) Nome do objeto
    Proprietário nvarchar(128) Proprietário do objeto (esta é a entidade de segurança do banco de dados que possui o objeto . O padrão é o proprietário do esquema que contém o objeto .)
    Object_type nvarchar(31) Tipo de Objeto
  2. Se name for um tipo de dados SQL Server ou um tipo de dados definido pelo usuário, sp_help retornará esse conjunto de resultados.

    Nome da coluna Tipo de dados Descrição
    Type_name nvarchar(128) Nome do tipo de dados.
    Storage_type nvarchar(128) SQL Server nome do tipo.
    Comprimento smallint O comprimento físico do tipo de dados (em bytes).
    Prec int Precisão (número total de dígitos).
    Escala int Número de dígitos à direita da casa decimal.
    Permite valor nulo varchar(35) Indica se valores NULL são permitidos: Sim ou Não.
    Default_name nvarchar(128) Nome de uma associação padrão para esse tipo.

    NULL = Nenhum padrão é associado.
    Rule_name nvarchar(128) Nome de uma associação de regra para esse tipo.

    NULL = Nenhum padrão é associado.
    Ordenação sysname Ordenação do tipo de dados. NULL para tipos de dados de não caracteres.
  3. Se name for qualquer objeto de banco de dados diferente de um tipo de dados, sp_help retornará esse conjunto de resultados e também conjuntos de resultados adicionais, com base no tipo de objeto especificado.

    Nome da coluna Tipo de dados Descrição
    Nome nvarchar(128) Nome da tabela
    Proprietário nvarchar(128) Proprietário da tabela
    Tipo nvarchar(31) Tipo de tabela
    Created_datetime datetime Tabela de data criada

    Dependendo do objeto de banco de dados especificado, sp_help retorna conjuntos de resultados adicionais.

    Se name for uma tabela do sistema, uma tabela de usuário ou uma exibição, sp_help retornará os conjuntos de resultados a seguir. Entretanto, o conjunto de resultados que descreve onde o arquivo de dados está localizado em um grupo de arquivos não é retornado para uma exibição.

    • Conjunto de resultados adicionais retornado em objetos de coluna:

      Nome da coluna Tipo de dados Descrição
      Column_name nvarchar(128) Nome da coluna.
      Tipo nvarchar(128) Tipo de dados da coluna.
      Calculado varchar(35) Indica se os valores na coluna são computados: Sim ou Não.
      Comprimento int Comprimento da coluna em bytes.

      Observação: se o tipo de dados da coluna for um tipo de valor grande (varchar(max), nvarchar(max), varbinary(max)ou xml), o valor será exibido como -1.
      Prec char(5) Precisão da coluna.
      Escala char(5) Escala de coluna.
      Permite valor nulo varchar(35) Indica se valores NULL são permitidos na coluna: Sim ou Não.
      TrimTrailingBlanks varchar(35) Exclui os espaços em branco à direita. Retorna Sim ou Não.
      FixedLenNullInSource varchar(35) Somente para compatibilidade com versões anteriores.
      Ordenação sysname Ordenação da coluna. NULL para tipos de dados não gráficos.
    • Conjunto de resultados adicionais retornado em colunas de identidade:

      Nome da coluna Tipo de dados Descrição
      Identidade nvarchar(128) Nome da coluna cujo tipo de dados é declarado como identidade.
      Semente numeric O valor inicial para a coluna de identidade.
      Incremento numeric Incremento a ser usado para obter valores nesta coluna.
      Não para replicação int A propriedade IDENTITY não é imposta quando um logon de replicação, como sqlrepl, insere dados na tabela:

      1 = True

      0 = False
    • Conjunto de resultados adicionais retornado em colunas:

      Nome da coluna Tipo de dados Descrição
      Rowguidcol sysname Nome da coluna de identificador exclusivo global.
    • Conjunto de resultados adicionais retornado em grupos de arquivos:

      Nome da coluna Tipo de dados Descrição
      Data_located_on_filegroup nvarchar(128) Grupo de arquivos no qual os dados estão localizados: Primário, Secundário ou Log de Transações.
    • Conjunto de resultados adicionais retornado em índices:

      Nome da coluna Tipo de dados Descrição
      index_name sysname Nome do índice.
      Index_description varchar(210) Descrição do índice.
      index_keys nvarchar(2078) Nomes de coluna nas quais o índice é criado. Retorna NULL para índices columnstore xVelocity de memória otimizada.
    • Conjunto de resultados adicionais retornado em restrições:

      Nome da coluna Tipo de dados Descrição
      constraint_type nvarchar(146) Tipo de restrição.
      constraint_name nvarchar(128) Nome da restrição.
      delete_action nvarchar(9) Indica se a ação DELETE é: NO_ACTION, CASCADE, SET_NULL, SET_DEFAULT ou N/A.

      Aplicável somente para restrições FOREIGN KEY.
      update_action nvarchar(9) Indica se a ação UPDATE é: NO_ACTION, CASCADE, SET_NULL, SET_DEFAULT ou N/A.

      Aplicável somente para restrições FOREIGN KEY.
      status_enabled varchar(8) Indica se a restrição está habilitada: Habilitado, Desabilitado ou N/A.

      Aplicável somente para restrições CHECK e FOREIGN KEY.
      status_for_replication varchar(19) Indica se a restrição é para replicação.

      Aplicável somente para restrições CHECK e FOREIGN KEY.
      constraint_keys nvarchar(2078) Os nomes das colunas que compõem a restrição ou, no caso de padrões e regras, do texto que define o padrão ou a regra.
    • Conjunto de resultados adicionais retornado em objetos de referência:

      Nome da coluna Tipo de dados Descrição
      A tabela é referenciada por nvarchar(516) Identifica outros objetos de banco de dados que referenciam a tabela.
    • Conjunto de resultados adicionais retornado em procedimentos armazenados, funções ou procedimentos armazenados estendidos.

      Nome da coluna Tipo de dados Descrição
      Parameter_name nvarchar(128) Nome de parâmetro de procedimento armazenado.
      Tipo nvarchar(128) Tipo de dados do parâmetro de procedimento armazenado.
      Comprimento smallint Comprimento máximo de armazenamento físico, em bytes.
      Prec int Precisão ou número total de dígitos.
      Escala int Número de dígitos à direita da vírgula decimal.
      Param_order smallint Ordem do parâmetro.

Comentários

O procedimento sp_help procura apenas um objeto no banco de dados atual.

Quando name não é especificado, sp_help lista nomes de objeto, proprietários e tipos de objeto para todos os objetos no banco de dados atual. sp_helptrigger fornece informações sobre gatilhos.

sp_help expõe apenas colunas de índice orderable; Portanto, ele não expõe informações sobre índices XML ou índices espaciais.

Permissões

Requer associação à função pública . O usuário deve ter pelo menos uma permissão no objname. Para exibir as chaves de restrição de coluna, padrões ou regras, você deve ter a permissão VIEW DEFINITION na tabela.

Exemplos

a. Retornando informações sobre todos os objetos

O exemplo a seguir lista informações sobre cada objeto no banco de dados master.

USE master;  
GO  
EXEC sp_help;  
GO  

B. Retornando informações sobre um único objeto

O exemplo a seguir exibe informações sobre a tabela Person.

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

Consulte Também

Procedimentos armazenados do Mecanismo de Banco de Dados (Transact-SQL)
sp_helpindex (Transact-SQL)
sp_helprotect (Transact-SQL)
sp_helpserver (Transact-SQL)
sp_helptrigger (Transact-SQL)
sp_helpuser (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
sys.sysobjects (Transact-SQL)