Método getColumns (SQLServerDatabaseMetaData)

Baixar driver JDBC

Recupera uma descrição das colunas da tabela disponíveis no catálogo especificado.

Sintaxe

  
public java.sql.ResultSet getColumns(java.lang.String catalog,  
                                     java.lang.String schema,  
                                     java.lang.String table,  
                                     java.lang.String col)  

Parâmetros

catálogo

Uma String que contém o nome do catálogo.

schema

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

table

Uma String que contém o padrão de nomes da tabela.

Col

Uma cadeia que contém o padrão de nome da coluna.

Valor de retorno

Um objeto SQLServerResultSet .

Exceptions

SQLServerException

Observações

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

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

(1) Esta coluna não estará presente se estiver a ligar-se ao SQL Server 2005 (9.x).

No Driver JDBC 3.0 do Microsoft SQL Server, verá as seguintes alterações de comportamento em relação às versões anteriores do driver JDBC:

A coluna DATA_TYPE apresenta as seguintes alterações:

A coluna COLUMN_SIZE apresenta as seguintes alterações:

A coluna BUFFER_LENGTH apresenta a seguinte alteração:

A coluna TYPE_NAME apresenta as seguintes alterações:

A coluna DECIMAL_DIGITS apresenta as seguintes alterações:

A coluna SQL_DATA_TYPE apresenta as seguintes alterações:

Example

O exemplo seguinte demonstra como usar o método getColumns para devolver informação para a tabela Person.Contact na base de dados de exemplo AdventureWorks2025.

import java.sql.*;  
public class c1 {  
   public static void main(String[] args) {  
      String connectionUrl = "jdbc:sqlserver://localhost:1433;encrypt=true;databaseName=AdventureWorks;integratedsecurity=true";  
  
      Connection con = null;  
      Statement stmt = null;  
      ResultSet rs = null;  
  
      try {  
         Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");  
         con = DriverManager.getConnection(connectionUrl);  
         DatabaseMetaData dbmd = con.getMetaData();  
         rs = dbmd.getColumns("AdventureWorks", "Person", "Contact", "FirstName");  
  
         ResultSet r = dbmd.getColumns(null, null, "Contact", null);  
         ResultSetMetaData rm = r.getMetaData();   
         int noofcols = rm.getColumnCount();  
  
         if (r.next())  
            for (int i = 0 ; i < noofcols ; i++ )  
            System.out.println(rm.getColumnName( i + 1 ) + ": \t\t" + r.getString( i + 1 ));  
      }  
  
      catch (Exception e) {}  
      finally {}  
   }  
}  

Ver também

SQLServerDatabaseMetaData Methods
Membros SQLServerDatabaseMetaData
SQLServerDatabaseMetaData Class