16.6.10 버전 및 호환성

Machbase 8.7.0 버전의 하위 호환성, 업그레이드 주의사항, 지원 OS/플랫폼 정리입니다.

8.7.0 버전 하위 호환성

클라이언트 드라이버 호환

• 8.7.0 서버에 8.5 클라이언트 드라이버를 사용하면 일부 신규 기능이 동작하지 않을 수 있습니다.
• 구버전 서버 또는 드라이버 조합에서는 Nullable 메타데이터가 기존 값이나 판정 불가 값으로 반환될 수 있습니다. 이 값에 의존하는 애플리케이션은 서버와 SDK를 모두 8.7.0으로 업그레이드하십시오.
• CAST의 모든 대상 타입과 길이·정밀도 옵션을 사용하는 SQL은 8.7.0 서버에서 지원됩니다. 같은 cardinality의 숫자 ARRAY 전체를 CAST(array_expression AS TYPE[N])로 변환하는 문법도 이 버전부터 사용할 수 있습니다. Cluster Edition에서는 모든 cluster node를 CAST와 ARRAY를 지원하는 동일 버전으로 구성해야 합니다. 자세한 문법과 변환 규칙은 CAST 함수를 참고하십시오.
• 8.7.0 서버는 CREATE INDEX IF NOT EXISTS를 지원합니다. 같은 database와 owner에 동일한 index name이 있으면 기존 정의를 유지하고 성공하므로, 반복 배포 후 실제 index mapping을 확인해야 합니다. 구버전 서버에서는 이 문법을 사용할 수 없습니다. 자세한 계약은 INDEX 문법을 참고하십시오.
• 8.7.0 Standard Edition 서버는 TAG data UPDATE의 NAME과 BASETIME 조건 값에 positional 또는 named bind parameter를 사용할 수 있습니다. 구버전 서버에서는 같은 prepared UPDATE가 ERR-02190으로 거부될 수 있습니다. 조건 형태와 SDK API는 TAG data UPDATE bind를 참고하십시오.
• 8.7.0 서버의 BASE DISTANCE TAG 통계 뷰는 축 컬럼을 *_DISTANCE 이름과 원본 DOUBLE, LONG, ULONG 타입으로 제공합니다. 기존 *_TIME 이름은 alias로 제공되지 않으며, 기존 테이블도 서버 재시작 후 새 스키마를 사용합니다. BASE TIME TAG의 *_TIME DATETIME 스키마는 유지됩니다. 애플리케이션 SQL과 result mapping은 TAG별 통계 뷰의 변환표에 따라 변경하십시오.
• 8.7.0의 Standard Edition에서는 SELECT/JOIN 계획 개선으로 테이블 스캔 순서와 정렬하지 않은 결과의 반환 순서가 구버전과 달라질 수 있습니다. 결과 순서가 필요하면 ORDER BY를 사용하고, 업그레이드 후에는 SELECT/JOIN 옵티마이저의 절차에 따라 결과와 실행 계획을 함께 확인하십시오.
• 8.7.0 JDBC 드라이버는 다중 호스트 URL에서 연결 단계의 I/O 오류가 발생하면 다음 호스트로 연결을 시도합니다. 구버전 드라이버가 첫 호스트의 일부 socket 오류에서 연결을 종료하는 환경에서는 8.7.0 JDBC 드라이버로 교체하고 다중 호스트 연결의 URL과 timeout 설정을 확인하십시오.
• Machbase DBMS 8.7.0은 고정 길이 숫자 ARRAY와 선택 컬럼 Append를 지원합니다. ARRAY를 사용하는 애플리케이션은 DBMS 8.7.0 서버와 해당 기능이 포함된 SDK 빌드를 함께 사용하고, Cluster Edition은 모든 노드를 함께 업그레이드하십시오. 자세한 SQL과 API는 숫자 ARRAY 타입과 Sparse ARRAY와 선택 컬럼 Append API를 참고하십시오.
• ARRAY 컬럼은 Standard Edition의 LOG, VOLATILE, LOOKUP, TRANSACTION, TAG METADATA와 Cluster Edition의 LOG 테이블에서 ADD COLUMN과 DROP COLUMN을 지원합니다. 테이블별 기존 row의 DEFAULT 적용 차이는 DDL 문법을 확인하십시오.
• ARRAY의 공개 position은 0-based입니다. 초기 1-based ARRAY SQL, sparse 객체와 indexed Append target을 사용한 코드는 각 위치를 1씩 낮춰야 합니다. 저장된 ARRAY 데이터와 dense ARRAY 요소 순서에는 변경이 없으므로 데이터 마이그레이션은 필요하지 않습니다.
• 서버와 SDK의 버전 조합에 따른 기능 차이는 서버와 SDK 호환성을 참고하십시오.

8.7.0에서 제거된 기능

Machbase 8.7.0은 다음 기능과 인터페이스를 제공하지 않습니다. 제거된 설정, SQL, C API에는 호환 계층이 없으므로 업그레이드 전에 설정 파일, 운영 SQL, 애플리케이션을 변경해야 합니다.

다음 항목은 이름이 비슷하지만 계속 지원합니다.

업그레이드 전에 설정 파일 정리

다음 프로퍼티가 8.7.0의 machbase.conf에 남아 있으면 알 수 없는 프로퍼티로 처리되어 서버가 시작되지 않습니다. 바이너리를 교체하기 전에 모두 삭제합니다.

HTTP_AUTH
HTTP_ENABLE
HTTP_MAX_MEM
HTTP_PORT_NO
RS_CACHE_APPROXIMATE_RESULT_ENABLE
RS_CACHE_ENABLE
RS_CACHE_MAX_MEMORY_PER_QUERY
RS_CACHE_MAX_MEMORY_SIZE
RS_CACHE_MAX_RECORD_PER_QUERY
RS_CACHE_TIME_BOUND_MSEC
STREAM_THREAD_COUNT
STREAM_WAIT_MS

기존 STREAM 정의가 필요하면 8.5 서버를 중지하기 전에 V$STREAMS와 관련 SQL을 별도로 기록합니다. 8.7.0에서는 SYS_STREAM_STMTS, V$STREAMS, V$HTTP_STATUS, V$RS_CACHE_LIST, V$RS_CACHE_STAT이 등록되지 않습니다.

업그레이드 후 다음 쿼리의 결과가 각각 0인지 확인합니다.

SELECT COUNT(*) AS removed_property_count
FROM V$PROPERTY
WHERE NAME IN (
    'HTTP_AUTH', 'HTTP_ENABLE', 'HTTP_MAX_MEM', 'HTTP_PORT_NO',
    'RS_CACHE_APPROXIMATE_RESULT_ENABLE', 'RS_CACHE_ENABLE',
    'RS_CACHE_MAX_MEMORY_PER_QUERY', 'RS_CACHE_MAX_MEMORY_SIZE',
    'RS_CACHE_MAX_RECORD_PER_QUERY', 'RS_CACHE_TIME_BOUND_MSEC',
    'STREAM_THREAD_COUNT', 'STREAM_WAIT_MS'
);

SELECT COUNT(*) AS removed_table_count
FROM V$TABLES
WHERE NAME IN (
    'SYS_STREAM_STMTS', 'V$HTTP_STATUS', 'V$RS_CACHE_LIST',
    'V$RS_CACHE_STAT', 'V$STREAMS'
);

DDL 동시성 호환

Machbase 8.7.0은 Edition에 따라 DDL 동시 실행 정책이 다릅니다.

Standard Edition에서 같은 객체나 직접 관련된 객체의 DDL이 충돌하면 기본 설정에서는 ERR-02031: Resource busy (<object>)가 즉시 반환됩니다. 이전 버전의 대기 동작을 전제로 작성한 배포 스크립트는 업그레이드 후 다음 중 하나를 명시적으로 적용합니다.

• 배포 세션에서 ALTER SESSION SET DDL_LOCK_TIMEOUT = seconds로 제한된 대기 시간을 설정합니다.
• ERR-02031에만 제한된 재시도와 대기 간격을 적용합니다.
• 재시도 전에 객체 상태를 다시 확인하고 already exists, 권한, 문법 오류는 재시도하지 않습니다.

자세한 충돌 관계와 설정 방법은 DDL 동시성과 잠금을 참고하십시오.

백업 파일 호환성

업그레이드 정본

실행 순서, 지원 플랫폼과 사전 점검은 업그레이드를 참고하십시오. 이 페이지는 SQL·server·client 호환성 사실만 유지합니다.