리스트 파티션
설명
파티션화 중인 테이블에 파티션 키 열을 추가합니다. 다음 제약 조건에 파티션 키를 포함합니다.
- 기본 키.
- 파티션화할 테이블을 참조하는 모든 외래 키.
- 모든 고유 제약 조건.
예제
단계 1 - 파티션 키 추가
파티션 키 열을 추가합니다. 예를 들어, 레일스 마이그레이션에서:
class AddPartitionNumberForPartitioning < Gitlab::Database::Migration[2.1]
enable_lock_retries!
TABLE_NAME = :table_name
COLUMN_NAME = :partition_id
DEFAULT_VALUE = 100
def change
add_column(TABLE_NAME, COLUMN_NAME, :bigint, default: 100)
end
end
단계 2 - 필요한 인덱스 생성
파티션 키 열을 포함하는 인덱스를 추가합니다. 예를 들어, 레일스 마이그레이션에서:
class PrepareIndexesForPartitioning < Gitlab::Database::Migration[2.1]
disable_ddl_transaction!
TABLE_NAME = :table_name
INDEX_NAME = :index_name
def up
add_concurrent_index(TABLE_NAME, [:id, :partition_id], unique: true, name: INDEX_NAME)
end
def down
remove_concurrent_index_by_name(TABLE_NAME, INDEX_NAME)
end
end
단계 3 - 고유 제약 조건 적용
파티션 키 열을 포함한 모든 고유 인덱스를 변경합니다. 이는 기본 키 인덱스를 포함합니다. 다음 예제는 레일스 마이그레이션에서:
class PrepareUniqueContraintForPartitioning < Gitlab::Database::Migration[2.1]
disable_ddl_transaction!
TABLE_NAME = :table_name
OLD_UNIQUE_INDEX_NAME = :index_name_unique
NEW_UNIQUE_INDEX_NAME = :new_index_name
def up
add_concurrent_index(TABLE_NAME, [:id, :partition_id], unique: true, name: NEW_UNIQUE_INDEX_NAME)
remove_concurrent_index_by_name(TABLE_NAME, OLD_UNIQUE_INDEX_NAME)
end
def down
add_concurrent_index(TABLE_NAME, :id, unique: true, name: OLD_UNIQUE_INDEX_NAME)
remove_concurrent_index_by_name(TABLE_NAME, NEW_UNIQUE_INDEX_NAME)
end
end
… (중략)
위와 같이 진행됨.
단계 7 - 외래 키를 상위 테이블로 재지정합니다
초기 파티션을 참조하는 테이블은 이제 상위 테이블을 가리키도록 업데이트해야 합니다. 이 변경을 하지 않으면 해당 테이블의 레코드는 초기 파티션에서 행을 찾지 못할 것입니다. 이는 이후 파티션에서 행을 찾을 때 초기 파티션에서 찾으려고 할 것이기 때문입니다.
단계:
- 분할된 테이블에 외래 키를 추가하고 비동기적으로 유효성을 검사하고, 예시를 참조하세요.
- GitLab.com에서 비동기 검증이 완료된 후 동기적으로 유효성을 검사합니다, 예시를 참조하세요.
- 예전 외래 키를 제거하고 새로운 외래 키를 예전 이름으로 변경하세요, 예시를 참조하세요.
단계 8 - 파티션을 횡단하여 ID 고유성 보장
모든 고유성 제약은 파티션 키를 포함해야 하므로, 파티션을 횡단하여 중복된 ID를 가질 수 있습니다. 이 문제를 해결하기 위해 ID 값은 데이터베이스만 설정하고, 시퀀스를 사용하여 생성합니다. 이는 시퀀스가 고유한 값을 생성할 것을 보장하기 때문입니다.
예시:
class EnsureIdUniquenessForPCiBuilds < Gitlab::Database::Migration[2.1]
include Gitlab::Database::PartitioningMigrationHelpers::UniquenessHelpers
enable_lock_retries!
TABLE_NAME = :p_ci_builds
SEQ_NAME = :ci_builds_id_seq
def up
ensure_unique_id(TABLE_NAME, seq: SEQ_NAME)
end
def down
revert_ensure_unique_id(TABLE_NAME, seq: SEQ_NAME)
end
end
단계 9 - 파티션된 테이블 분석 및 새 파티션 생성
autovacuum 데몬은 파티션된 테이블을 처리하지 않습니다. 따라서 테이블 계층구조의 통계를 최신 상태로 유지하기 위해 주기적으로 매뉴얼 ANALYZE
를 실행해야 합니다.
Ci::Partitionable
에 partitioned: true
옵션을 사용하여 구현된 모델은 기본적으로 매주 분석됩니다. 이를 활성화하고 새 파티션을 생성하려면 PostgreSQL 이니셜라이저에 모델을 등록해야 합니다.
단계 10 - 애플리케이션 업데이트하여 파티션된 테이블 사용
이제 상위 테이블이 준비되었으므로, 애플리케이션을 업데이트하여 사용할 수 있습니다:
class Model < ApplicationRecord
self.table_name = :partitioned_table
end
모델에 따라, 변경 관리 이슈를 사용하는 것이 더 안전할 수 있습니다.