Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna informações de coluna por um único procedimento armazenado ou função definida pelo usuário no ambiente atual.
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
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 as informações do catálogo. name é nvarchar(390), com um padrão %, que significa todas as tabelas do banco de dados atual. Há suporte para a correspondência do padrão curinga.[ @procedure_owner =] 'owner'
É o nome do proprietário do procedimento. owneré nvarchar(384), com um padrão NULL. Há suporte para a correspondência do padrão 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 NULL. Vários produtos de DBMS dão suporte à nomenclatura de três partes de 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, usada quando apenas uma coluna de informações de catálogo é desejada. column_name é nvarchar(384), com um padrão NULL. Se column_name for omitido, 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 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. Os valores válidos são 0 (correspondência de padrão desativada) e 1 (correspondência de padrão ativada). fUsePattern é bit, com um padrão 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 da vírgula 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. O SQL Server não retorna um valor para essa 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. As regras ISO são seguidas 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.