sp_sproc_columns (Transact-SQL)
Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Ponto de extremidade de SQL no Microsoft FabricWarehouse no Microsoft Fabric
Retorna informações de coluna por um único procedimento armazenado ou função definida pelo usuário no ambiente atual.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_sproc_columns
[ [ @procedure_name = ] N'procedure_name' ]
[ , [ @procedure_owner = ] N'procedure_owner' ]
[ , [ @procedure_qualifier = ] N'procedure_qualifier' ]
[ , [ @column_name = ] N'column_name' ]
[ , [ @ODBCVer = ] ODBCVer ]
[ , [ @fUsePattern = ] fUsePattern ]
[ ; ]
Argumentos
@procedure_name [ = ] N'procedure_name'
O nome do procedimento usado para retornar informações do catálogo. @procedure_name é nvarchar(390), com um padrão de , que significa todas as tabelas no banco de %
dados atual. Há suporte para a correspondência do padrão curinga.
@procedure_owner [ = ] N'procedure_owner'
O nome do proprietário do procedimento. @procedure_owner é nvarchar(384), com um padrão de NULL
. Há suporte para a correspondência do padrão curinga. Se @procedure_owner não for especificado, as regras de visibilidade de procedimento padrão do sistema de gerenciamento de banco de dados (DBMS) subjacente serão aplicadas.
Se o usuário atual possuir um procedimento com o nome especificado, serão retornadas informações sobre esse procedimento. Se @procedure_owner não for especificado e o usuário atual não possuir um procedimento com o nome especificado, sp_sproc_columns
procure um procedimento com o nome especificado que pertence ao proprietário do banco de dados. Se o procedimento existir, serão retornadas informações sobre suas colunas.
@procedure_qualifier [ = ] N'procedure_qualifier'
O nome do qualificador de procedimento. @procedure_qualifier é sysname, com um padrão de NULL
. Vários produtos DBMS suportam nomenclatura de três partes para tabelas (<qualifier>.<owner>.<name>
). No SQL Server, esse parâmetro representa o nome do banco de dados. Em alguns produtos, ele representa o nome do servidor do ambiente de banco de dados da tabela.
@column_name [ = ] N'column_name'
Uma única coluna e é usada quando apenas uma coluna de informações do catálogo é desejada. @column_name é nvarchar(384), com um padrão de NULL
. Se @column_name for omitida, todas as colunas serão retornadas. Há suporte para a correspondência do padrão curinga. Para obter a interoperabilidade máxima, o cliente de gateway deve pressupor correspondência apenas do padrão ISO (curingas com % e _).
@ODBCVer [ = ] ODBCVer
A versão do ODBC que está sendo usada. @ODBCVer é int, com um padrão de 2
, que indica ODBC versão 2.0. Para obter mais informações sobre as diferenças entre ODBC versão 2.0 e ODBC versão 3.0, consulte a especificação ODBC SQLProcedureColumns
para ODBC versão 3.0.
@fUsePattern [ = ] fUsePattern
Determina se os caracteres de sublinhado (_
), porcentagem (%
) e colchete ([
e ]
) são interpretados como caracteres curinga. @fUsePattern é bit, com um padrão de 1
. Os valores válidos são 0
(a correspondência de padrão está desativada) e 1
(a correspondência de padrão está ativada).
Valores do código de retorno
Nenhum.
Conjunto de resultados
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
PROCEDURE_QUALIFIER |
sysname | Nome do qualificador de procedimento. Esta coluna pode ser NULL . |
PROCEDURE_OWNER |
sysname | Nome do proprietário do procedimento. Esta coluna sempre retorna um valor. |
PROCEDURE_NAME |
Nvarchar(134) | Nome do procedimento. Esta coluna sempre retorna um valor. |
COLUMN_NAME |
sysname | Nome da coluna para cada coluna do TABLE_NAME retornado. Esta coluna sempre retorna um valor. |
COLUMN_TYPE |
smallint | Este campo sempre retorna um valor: 0 = SQL_PARAM_TYPE_UNKNOWN 1 = SQL_PARAM_TYPE_INPUT 2 = SQL_PARAM_TYPE_OUTPUT 3 = SQL_RESULT_COL 4 = SQL_PARAM_OUTPUT 5 = SQL_RETURN_VALUE |
DATA_TYPE |
smallint | Código de inteiro para um tipo de dados de ODBC. Se esse tipo de dados não puder ser mapeado para um tipo ISO, o valor será NULL . O nome do TYPE_NAME tipo de dados nativo é retornado na coluna. |
TYPE_NAME |
sysname | Representação em cadeia de caracteres do tipo de dados. Esse valor é o nome do tipo de dados conforme apresentado pelo DBMS subjacente. |
PRECISION |
int | Número de dígitos significativos. O valor de retorno para a PRECISION coluna está na base 10. |
LENGTH |
int | Tamanho da transferência dos dados. |
SCALE |
smallint | Número de dígitos à direita da vírgula decimal. |
RADIX |
smallint | A base para tipos numéricos. |
NULLABLE |
smallint | Especifica a anulabilidade:1 = O tipo de dados pode ser criado permitindo valores nulos.0 = Valores nulos não são permitidos. |
REMARKS |
varchar(254) | Descrição da coluna de procedimento. O SQL Server não retorna um valor para esta coluna. |
COLUMN_DEF |
nvarchar(4000) | Valor padrão da coluna. |
SQL_DATA_TYPE |
smallint | Valor do tipo de dados SQL como ele aparece no TYPE campo do descritor. Essa coluna é igual à DATA_TYPE coluna, exceto para os tipos de dados datetime e intervalo ISO. Esta coluna sempre retorna um valor. |
SQL_DATETIME_SUB |
smallint | O subcódigo de intervalo ISO datetime se o valor de SQL_DATA_TYPE for SQL_DATETIME ou SQL_INTERVAL . Para tipos de dados diferentes de datetime e intervalo ISO, esse campo é NULL . |
CHAR_OCTET_LENGTH |
int | Comprimento máximo em bytes de um caractere ou coluna de tipo de dados binário . Para todos os outros tipos de dados, esta coluna retorna um NULL arquivo . |
ORDINAL_POSITION |
int | Posição ordinal da coluna na tabela. A primeira coluna da tabela é 1 . Esta coluna sempre retorna um valor. |
IS_NULLABLE |
varchar(254) | Possibilidade de nulidade da coluna na tabela. As regras ISO são seguidas para determinar a possibilidade de nulidade. Um DBMS compatível com ISO não pode retornar uma cadeia de caracteres vazia. Exibe YES se a coluna pode incluir nulos e NO se a coluna não pode incluir nulos.Esta coluna retorna uma cadeia de caracteres de comprimento zero se a possibilidade de nulidade for desconhecida. O valor retornado para esta coluna é diferente do valor retornado para a NULLABLE coluna. |
SS_DATA_TYPE |
tinyint | Tipo de dados do SQL Server usados por procedimentos armazenados estendidos. Para obter mais informações, consulte Tipos de dados (Transact-SQL). |
Comentários
sp_sproc_columns
é equivalente a SQLProcedureColumns
em ODBC. Os resultados retornados são ordenados por PROCEDURE_QUALIFIER
, PROCEDURE_OWNER
, PROCEDURE_NAME
e a ordem em que os parâmetros aparecem na definição do procedimento.
Permissões
Requer a permissão SELECT
no esquema.
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de