Partilhar via

Método getProcedureColumns (SQLServerDatabaseMetaData)

Baixar driver JDBC

Recupera uma descrição dos parâmetros do procedimento armazenado e das colunas de resultados.

Sintaxe

  
public java.sql.ResultSet getProcedureColumns(java.lang.String sCatalog,  
                                              java.lang.String sSchema,  
                                              java.lang.String proc,  
                                              java.lang.String col)

Parâmetros

sCatalog

Uma String que contém o nome do catálogo. Atribuir um valor nulo a este parâmetro indica que o nome do catálogo não precisa de ser usado.

sSchema

Uma String que contém o nome do esquema, padrão. Fornecer um nulo a este parâmetro indica que o nome do esquema não precisa de ser usado.

proc

Uma String que contém o padrão do nome do procedimento.

Col

Uma cadeia que contém o padrão de nome da coluna. Fornecer um valor nulo a este parâmetro retorna uma linha para cada coluna.

Valor de retorno

Um objeto SQLServerResultSet .

Exceptions

SQLServerException

Observações

Este método getProcedureColumns é especificado pelo método getProcedureColumns na interface java.sql.DatabaseMetaData.

O conjunto de resultados devolvido pelo método getProcedureColumns conterá a seguinte informação:

Nome Tipo Description
PROCEDURE_CAT String O nome da base de dados onde reside o procedimento armazenado especificado.
PROCEDURE_SCHEM String O esquema do procedimento armazenado.
PROCEDURE_NAME String O nome do procedimento armazenado.
COLUMN_NAME String O nome da coluna.
COLUMN_TYPE Short O tipo da coluna. Pode ser um dos seguintes valores:

ProcedureColumnDesconhecido (0)

ProcedimentoColuna Em (1)

procedureColumnInOut (2)

procedureColumn Out (4)

procedureColumnReturn (5)

procedimentoColunResultado (3)
DATA_TYPE smallint O tipo de dados SQL do java.sql.Types.
TYPE_NAME String O nome do tipo de dados.
PRECISION int O número total de dígitos significativos.
LENGTH int O comprimento dos dados em bytes.
ESCALA Short O número de dígitos à direita do ponto decimal.
RADIX Short A base para tipos numéricos.
ANULÁVEL Short Indica se a coluna pode conter um valor nulo. Pode ser um dos seguintes valores:

procedureNoNulls (0)

procedimentoAnulável (1)

procedureNullableDesconhecido (2)
COMENTÁRIOS String A descrição da coluna de procedimentos.



Nota: O SQL Server não devolve um valor para esta coluna.
COLUMN_DEF String O valor padrão da coluna.
SQL_DATA_TYPE smallint Esta coluna é igual à coluna DATA_TYPE , exceto pelos tipos de dados data-hora e intervalo ISO.
SQL_DATETIME_SUB smallint O subcódigo do intervaloISO de data-hora se o valor de SQL_DATA_TYPE for SQL_DATETIME ou SQL_INTERVAL. Para tipos de dados que não sejam data-hora e intervalo ISO, esta coluna é NULL.
CHAR_OCTET_LENGTH int O número máximo de bytes na coluna.
ORDINAL_POSITION int O índice da coluna dentro da tabela.
IS_NULLABLE String Indica se a coluna permite valores nulos.
SS_TYPE_CATALOG_NAME String O nome do catálogo que contém o tipo definido pelo utilizador (UTT).
SS_TYPE_SCHEMA_NAME String O nome do esquema que contém o tipo definido pelo utilizador (UDT).
SS_UDT_CATALOG_NAME String O nome totalmente qualificado tipo definido pelo utilizador (UDT).
SS_UDT_SCHEMA_NAME String O nome do catálogo onde é definido o nome da coleção de esquemas XML. Se o nome do catálogo não for encontrado, esta variável contém uma cadeia vazia.
SS_UDT_ASSEMBLY_TYPE_NAME String O nome do esquema onde é definido um nome de coleção de esquemas XML. Se o nome do esquema não for encontrado, esta é uma cadeia vazia.
SS_XML_SCHEMACOLLECTION_CATALOG_NAME String O nome de uma coleção de esquemas XML. Se o nome não for encontrado, esta é uma cadeia vazia.
SS_XML_SCHEMACOLLECTION_SCHEMA_NAME String O nome do catálogo que contém o tipo definido pelo utilizador (UTT).
SS_XML_SCHEMACOLLECTION_NAME String O nome do esquema que contém o tipo definido pelo utilizador (UDT).
SS_DATA_TYPE tinyint O tipo de dado SQL Server utilizado por procedimentos armazenados estendidos.



Nota: Para mais informações sobre os tipos de dados devolvidos pelo SQL Server, consulte "Tipos de Dados (Transact-SQL)" no SQL Server Books Online.

Observação

Para mais informações sobre os dados devolvidos pelo método getProcedureColumns, consulte "sp_sproc_columns (Transact-SQL)" no SQL Server Books Online.

Example

O exemplo seguinte demonstra como usar o método getProcedureColumns para devolver informações sobre o procedimento armazenado uspGetBillOfMaterials na base de dados de exemplo AdventureWorks2025.

public static void executeGetProcedureColumns(Connection con) {  
   try {  
      DatabaseMetaData dbmd = con.getMetaData();  
      ResultSet rs = dbmd.getProcedureColumns(null, null, "uspGetBillOfMaterials", null);  
      ResultSetMetaData rsmd = rs.getMetaData();  
  
      // Display the result set data.  
      int cols = rsmd.getColumnCount();  
      while(rs.next()) {  
         for (int i = 1; i <= cols; i++) {  
            System.out.println(rs.getString(i));  
         }  
      }  
      rs.close();  
   }   
  
   catch (Exception e) {  
      e.printStackTrace();  
   }  
}

Ver também

Membros SQLServerDatabaseMetaData
SQLServerDatabaseMetaData Class

  • Last updated on