11.5.4 DatabaseMetaData

Connection.getMetaData()는 드라이버, 서버, 스키마 객체와 JDBC 기능 정보를 반환합니다. 결과 컬럼은 JDBC 표준 이름과 순서를 사용하므로 숫자 위치보다 컬럼 이름으로 읽는 것을 권장합니다.

import java.sql.DatabaseMetaData;

DatabaseMetaData metadata = connection.getMetaData();

System.out.println(metadata.getDriverName());
System.out.println(metadata.getDriverVersion());
System.out.println(metadata.getDatabaseProductName());
System.out.println(metadata.getDatabaseProductVersion());

테이블과 VIEW

try (ResultSet tables = metadata.getTables(
         null, null, "%", new String[] {"TABLE", "VIEW"})) {
    while (tables.next()) {
        System.out.printf("%s %s%n",
            tables.getString("TABLE_NAME"),
            tables.getString("TABLE_TYPE"));
    }
}

getTables()는 TABLE과 VIEW를 구분합니다. Machbase 세부 테이블 종류는 REMARKS에서 확인합니다. 애플리케이션은 특정 순번에 의존하지 말고 표준 컬럼 이름을 사용합니다.

컬럼

try (ResultSet columns = metadata.getColumns(
         null, null, "SENSOR_TX", "%")) {
    while (columns.next()) {
        System.out.printf(
            "%s %s size=%d nullable=%s%n",
            columns.getString("COLUMN_NAME"),
            columns.getString("TYPE_NAME"),
            columns.getInt("COLUMN_SIZE"),
            columns.getString("IS_NULLABLE"));
    }
}

NULLABLE은 숫자 상수, IS_NULLABLE은 YES, NO 또는 빈 문자열로 반환됩니다. LOOKUP과 VOLATILE 테이블의 PRIMARY KEY는 명시적인 NOT NULL 절이 없어도 columnNoNulls와 NO로 반환됩니다.

VARCHAR, DATETIME, BINARY, BLOB과 CLOB처럼 수치 속성이 적용되지 않는 컬럼의 DECIMAL_DIGITS와 NUM_PREC_RADIX는 SQL NULL입니다. getInt()의 0만 확인하지 말고 getObject() 또는 wasNull()로 NULL 여부를 확인합니다.

PRIMARY KEY와 인덱스

try (ResultSet keys = metadata.getPrimaryKeys(
         null, null, "SENSOR_TX")) {
    while (keys.next()) {
        System.out.printf("%s position=%d%n",
            keys.getString("COLUMN_NAME"),
            keys.getShort("KEY_SEQ"));
    }
}

try (ResultSet indexes = metadata.getIndexInfo(
         null, null, "SENSOR_TX", false, false)) {
    while (indexes.next()) {
        System.out.printf("%s %s%n",
            indexes.getString("INDEX_NAME"),
            indexes.getString("COLUMN_NAME"));
    }
}

PRIMARY KEY 여부를 ResultSetMetaData.isNullable() 값으로 추정하지 않습니다. getPrimaryKeys()와 getIndexInfo()를 사용합니다.

SELECT 결과의 직접 컬럼에 대한 PK 여부는 Machbase JDBC 확장인 MachResultSetMetaData.isPrimaryKey(column)으로 확인할 수 있습니다.

import com.machbase.jdbc.MachResultSetMetaData;

try (ResultSet result = statement.executeQuery(
         "SELECT ID, ID + 1 AS ID_EXPR FROM SENSOR_TX")) {
    MachResultSetMetaData resultMetadata =
        (MachResultSetMetaData) result.getMetaData();
    System.out.println(resultMetadata.isPrimaryKey(1)); // true 또는 false
    System.out.println(resultMetadata.isPrimaryKey(2)); // expression: false
}

getPrimaryKeys()는 테이블 카탈로그의 PK를 조회하고, isPrimaryKey()는 현재 SELECT 결과의 컬럼 메타데이터를 조회합니다. 이전 버전 서버 또는 SDK와 연결한 경우에는 결과 컬럼의 PK 플래그가 false로 반환될 수 있습니다.

스키마와 타입 정보

다음 메서드는 JDBC 표준 형태의 ResultSet을 반환합니다.

getSchemas(), getCatalogs(), getTableTypes()
getTypeInfo()
getTables(), getColumns()
getPrimaryKeys(), getIndexInfo()

지원하지 않는 선택적 메타데이터 조회는 null이나 비표준 ResultSet 대신 표준 컬럼을 가진 빈 ResultSet을 반환할 수 있습니다. 기능을 사용하기 전에 기능 메서드를 확인합니다.

if (metadata.supportsSavepoints()) {
    // 지원되는 환경에서만 savepoint를 사용합니다.
}

catalog

Connection.getCatalog()과 setCatalog()은 드라이버가 노출하는 현재 카탈로그 값을 관리합니다. 메타데이터 메서드의 카탈로그 인자는 이 값과 일치하는 요청을 필터링하는 데 사용합니다.

String initialCatalog = connection.getCatalog();
connection.setCatalog(initialCatalog);

커넥션 풀에서 논리 Connection을 반환하면 카탈로그는 URL에서 결정한 초기 값으로 복원됩니다. 이전 연결 대여 기간에서 얻은 DatabaseMetaData 객체는 다음 연결 대여 기간에서 재사용하지 않습니다.

지원 범위 확인

Machbase JDBC는 실제 지원 범위를 기능에 반영합니다. 예를 들어 트랜잭션 격리 수준, ResultSet 종류, savepoint, generated 키와 multiple open results 지원 여부를 다음과 같이 확인합니다.

System.out.println(metadata.supportsTransactions());
System.out.println(metadata.supportsTransactionIsolationLevel(
    Connection.TRANSACTION_SERIALIZABLE));
System.out.println(metadata.supportsResultSetType(
    ResultSet.TYPE_FORWARD_ONLY));
System.out.println(metadata.supportsSavepoints());
System.out.println(metadata.supportsGetGeneratedKeys());
System.out.println(metadata.supportsMultipleOpenResults());

Driver.jdbcCompliant()이 false인 것과 개별 JDBC API의 지원 여부는 별개입니다. 애플리케이션은 필요한 기능을 직접 확인합니다.

Standard Edition에서 ROWID를 지원하는 서버와 연결하면 supportsGetGeneratedKeys()는 true, getRowIdLifetime()은 ROWID_VALID_OTHER를 반환합니다. 지원하지 않는 서버 또는 Cluster Edition에서는 각각 false와 ROWID_UNSUPPORTED를 반환합니다. 사용 예제는 ROWID와 INSERT 결과 ID를 참고하십시오.

최근 업데이트 Sep 9, 2026

11.5.3 트랜잭션과 커넥션 풀 11.5.5 Append API