데이터베이스 레코드의 의미 체계 버전 관리
의미 체계 버전 관리는 데이터베이스의 레코드를 필터링하고 정렬할 때 복잡성을 초래합니다. 데이터베이스는 원래 의미 체계 버전을 이해하지 못하기 때문에 버전 구성 요소를 데이터베이스의 별도 열로 추출할 필요가 있습니다. 이 프로세스를 더 쉽게 만들기 위해 SemanticVersionable 모듈이 도입되었습니다.
설정 지침
SemanticVersionable을 사용하려면 먼저 필수 열을 테이블에 추가하는 데이터베이스 마이그레이션을 생성해야 합니다. 필수 열은 semver_major
, semver_minor
, semver_patch
, semver_prerelease
입니다. 버전에 v
접두사를 추가하려면 semver_prefixed
열을 포함할 수 있습니다. 예제 마이그레이션은 다음과 같습니다:
class AddVersionPartsToModelVersions < Gitlab::Database::Migration[2.2]
enable_lock_retries!
milestone '16.9'
def up
add_column :ml_model_versions, :semver_major, :integer
add_column :ml_model_versions, :semver_minor, :integer
add_column :ml_model_versions, :semver_patch, :integer
add_column :ml_model_versions, :semver_prerelease, :text
add_column :ml_model_versions, :semver_prefixed, :boolean, default: false
end
def down
remove_column :ml_model_versions, :semver_major, :integer
remove_column :ml_model_versions, :semver_minor, :integer
remove_column :ml_model_versions, :semver_patch, :integer
remove_column :ml_model_versions, :semver_prerelease, :text
remove_column :ml_model_versions, :semver_prefixed, :boolean
end
end
열이 데이터베이스에 추가되면, 모델에 포함시켜 모듈을 활성화할 수 있습니다. 예를 들면:
module Ml
class ModelVersion < ApplicationRecord
include SemanticVersionable
...
end
end
모듈은 기본적으로 의미 체계 버전을 검증하도록 구성되어 있습니다.
정렬
이 Concern은 의미 체계 버전으로 정렬하기 위한 두 개의 스코프를 제공합니다:
scope :order_by_semantic_version_desc, -> { order(semver_major: :desc, semver_minor: :desc, semver_patch: :desc)}
scope :order_by_semantic_version_asc, -> { order(semver_major: :asc, semver_minor: :asc, semver_patch: :asc)}
필터링 및 검색
TBD