데이터베이스 레코드의 의미 체계 버전 관리

의미 체계 버전 관리는 데이터베이스의 레코드를 필터링하고 정렬할 때 복잡성을 초래합니다. 데이터베이스는 원래 의미 체계 버전을 이해하지 못하기 때문에 버전 구성 요소를 데이터베이스의 별도 열로 추출할 필요가 있습니다. 이 프로세스를 더 쉽게 만들기 위해 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