sp_sproc_columns (Transact-SQL)
Retorna informações de coluna de um único procedimento armazenado ou função definida pelo usuário no ambiente atual.
.gif "Ícone de vínculo de tópico")
Sintaxe
sp_sproc_columns [[@procedure_name = ] 'name']
[ , [@procedure_owner = ] 'owner']
[ , [@procedure_qualifier = ] 'qualifier']
[ , [@column_name = ] 'column_name']
[ , [@ODBCVer = ] 'ODBCVer']
[ , [@fUsePattern = ] 'fUsePattern']
Argumentos
[ @procedure_name = ] 'name'
É o nome do procedimento usado para retornar informações de catálogo. name é nvarchar(390), com um padrão de %, o que significa todas as tabelas no banco de dados atual. Há suporte para a correspondência do padrão de caractere curinga.[ @procedure_owner =] 'owner'
É o nome do proprietário do procedimento. owneré nvarchar(384), com um padrão de NULL. Há suporte para a correspondência do padrão de caractere curinga. Se owner não for especificado, serão aplicadas as regras de visibilidade de procedimento padrão do DBMS subjacente.Se o usuário atual possuir um procedimento com o nome especificado, serão retornadas informações sobre esse procedimento. Se owner não estiver especificado e o usuário atual não possuir um procedimento com o nome especificado, sp_sproc_columns procurará um procedimento com o nome especificado que seja de propriedade do proprietário do banco de dados. Se o procedimento existir, serão retornadas informações sobre suas colunas.
[ @procedure_qualifier =] 'qualifier'
É o nome do qualificador do procedimento. qualifier é sysname, com um padrão de NULL. Diversos produtos de DBMS dão suporte à 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, representa o nome do servidor do ambiente de banco de dados da tabela.[ @column_name =] 'column_name'
É uma única coluna, usado quando se deseja apenas uma coluna de informações de catálogo. column_name é nvarchar(384), com um padrão de NULL. Se column_name for omitido, todas as colunas serão retornadas. Há suporte para a correspondência do padrão de caractere curinga. Para interoperabilidade máxima, o cliente de gateway deve pressupor correspondência apenas do padrão ISO (curingas com % e _).[ @ODBCVer =] 'ODBCVer'
É a versão de ODBC que está sendo utilizada. ODBCVer é int, com um padrão de 2 que indica ODBC versão 2.0. Para obter mais informações sobre a diferença entre ODBC versão 2.0 e ODBC versão 3.0, consulte a especificação SQLProcedureColumns para ODBC versão 3.0[ @fUsePattern =] 'fUsePattern'
Determina se os caracteres sublinhado (_), porcentagem (%) e colchetes ([ ]) são interpretados como curingas. São valores válidos 0 (correspondência de padrão desativada) e 1 (correspondência de padrão ativada). fUsePattern é bit, com um padrão de 1.
Valores de código de retorno
Nenhum
Conjuntos 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 de 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 este tipo de dados não puder ser mapeado para um tipo ISO, o valor será NULL. O nome do tipo de dados nativo é retornado na coluna TYPE_NAME. |
TYPE_NAME |
sysname |
Representação em cadeia de caracteres do tipo de dados. É o nome do tipo de dados como apresentado pelo DBMS subjacente. |
PRECISION |
int |
Número de dígitos significativos. O valor de retorno da coluna PRECISION está em base 10. |
LENGTH |
int |
Tamanho da transferência dos dados. |
SCALE |
smallint |
Número de dígitos à direita do ponto decimal. |
RADIX |
smallint |
É a base para tipos numéricos. |
NULLABLE |
smallint |
Especifica possibilidade de nulidade: 1 = O tipo de dados pode ser criado permitindo valores nulos. 0 = Não são permitidos valores nulos. |
REMARKS |
varchar(254) |
Descrição da coluna de procedimento. 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 campo TYPE do descritor. Esta coluna é igual à coluna DATA_TYPE, com exceção dos tipos de dados datetime e intervalo ISO. Esta coluna sempre retorna um valor. |
SQL_DATETIME_SUB |
smallint |
O subcódigo datetime de intervalo ISO, se o valor de SQL_DATA_TYPE for SQL_DATETIME ou SQL_INTERVAL. Para tipos de dados diferentes de datetime e intervalo ISO, este campo é NULL. |
CHAR_OCTET_LENGTH |
int |
Tamanho máximo em bytes de uma coluna de tipo de dados character ou binary. Para todos os outros tipos de dados, esta coluna retorna NULL. |
ORDINAL_POSITION |
int |
Posição ordinal da coluna na tabela. A primeira coluna na tabela é 1. Esta coluna sempre retorna um valor. |
IS_NULLABLE |
varchar(254) |
Possibilidade de nulidade da coluna na tabela. São seguidas regras de ISO para determinar a possibilidade de nulidade. Um DBMS com conformidade de ISO não pode retornar uma cadeia de caracteres vazia. Exibe YES, se a coluna puder incluir NULLS, e NO, se a coluna não puder incluir NULLS. 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 coluna NULLABLE. |
SS_DATA_TYPE |
tinyint |
Tipo de dados 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_NAMEe a ordem em que os parâmetros aparecem na definição de procedimento.
Permissões
Requer a permissão SELECT no esquema.
Consulte também