getColumns メソッド (SQLServerDatabaseMetaData)

指定されたカタログで使用できるテーブル列の記述を取得します。

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

パラメーター

catalog

カタログ名を含む String です。

schema

スキーマ名のパターンを含む String です。

table

テーブル名のパターンを含む String です。

col

列名のパターンを含む String です。

戻り値

SQLServerResultSet オブジェクトです。

例外

SQLServerException

解説

getColumns メソッドは、java.sql.DatabaseMetaData インターフェイスの getColumns メソッドで規定されています。

getColumns メソッドによって返される結果セットには、次の情報が含まれます。

名前	種類	説明
TABLE_CAT	String	カタログ名です。
TABLE_SCHEM	String	テーブル スキーマ名です。
TABLE_NAME	String	テーブル名です。
COLUMN_NAME	String	列名です。
DATA_TYPE	short	java.sql.Types の SQL データ型です。
TYPE_NAME	String	データ型の名前です。
COLUMN_SIZE	int	列の完全桁数です。
BUFFER_LENGTH	int	JDBC ドライバーではサポートされていません。
DECIMAL_DIGITS	int	列の小数点以下の桁数です。
NUM_PREC_RADIX	int	列の基数です。
NULLABLE	int	列が null を許容するかどうかを示します。次のいずれかの値を指定します。 columnNoNulls (0) columnNullable (1) columnNullableUnknown (2)
REMARKS	String	列に関連付けられているコメントです。 メモ : SQL Server は、この列に対して常に "null" を返します。
COLUMN_DEF	String	列の既定値です。
SQL_DATA_TYPE	int	JDBC ドライバーではサポートされていません。
SQL_DATETIME_SUB	int	JDBC ドライバーではサポートされていません。
CHAR_OCTET_LENGTH	int	列の最大バイト数です。
ORDINAL_POSITION	int	テーブル内の列のインデックスです。
IS_NULLABLE	String	列で null 値が許容されるかどうかを示します。

メモ :
getColumns メソッドによって返されるデータの詳細については、SQL Server オンライン ブックの「sp_columns (Transact-SQL)」を参照してください。

例

次の例では、getColumns メソッドを使用して、SQL Server 2005 AdventureWorks サンプル データベースにある Person.Contact テーブルの FirstName 列の情報を返す方法を示します。

public static void executeGetColumns(Connection con) {
   try {
      DatabaseMetaData dbmd = con.getMetaData();
      ResultSet rs = dbmd.getColumns("AdventureWorks", "Person", "Contact", "FirstName");
      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();
   }
}

参照

関連項目

SQLServerDatabaseMetaData クラス

概念

SQLServerDatabaseMetaData のメソッド
SQLServerDatabaseMetaData のメンバー