버전 관리

drizzle-seed는 정적 및 동적 데이터에 대한 출력을 관리하기 위해 버전 관리를 사용합니다. 진정한 결정론을 보장하려면 동일한 seed 번호를 사용할 때 값이 변경되지 않도록 해야 합니다. 정적 데이터 소스 또는 동적 데이터 생성 로직이 변경되면 버전이 업데이트되어 이전 버전을 유지할지 최신 버전을 사용할지 선택할 수 있습니다.

필요한 경우 이전 버전으로 결정론적 출력을 유지하면서 추가 생성기와 같은 새로운 기능을 위해 최신 drizzle-seed 버전으로 업그레이드할 수 있습니다. 이는 새로운 기능에 액세스하는 동시에 기존의 결정론적 데이터에 의존해야 할 때 특히 유용합니다.

await seed(db, schema, { version: '2' });

히스토리

api version	npm version	Changed generators
`v1`	`0.1.1`
`v2 (LTS)`	`0.2.1`	`string()`, `interval({ isUnique: true })`

내부 작동 방식은?

이것은 실제 API 변경이 아니며, drizzle-seed 버전 관리를 진행하는 방법의 예시일 뿐입니다.

예를 들어, lastName 생성기가 변경되고 이 생성기의 새 버전인 V2가 사용 가능해졌습니다.

나중에 firstName 생성기가 변경되어 이 생성기의 V3 버전이 사용 가능해졌습니다.

	`V1`	`V2`	`V3(latest)`
LastNameGen	`LastNameGenV1`	`LastNameGenV2`
FirstNameGen	`FirstNameGenV1`		`FirstNameGenV3`

버전 3의 `firstName` 생성기와 버전 2의 `lastName` 생성기를 사용합니다

await seed(db, schema);

최신 생성기 버전을 즉시 사용할 준비가 되지 않은 경우 사용할 최대 버전을 지정할 수 있습니다

버전 1의 `firstName` 생성기와 버전 2의 `lastName` 생성기를 사용합니다

await seed(db, schema, { version: '2' });

버전 1의 `firstName` 생성기와 버전 1의 `lastName` 생성기를 사용합니다.

await seed(db, schema, { version: '1' });

버전 2

고유 `interval` 생성기가 변경되었습니다

업그레이드 이유

이전 버전의 생성기는 1 minute 60 seconds 및 2 minutes 0 seconds와 같은 간격을 생성할 수 있으며 이를 별개의 간격으로 취급했습니다. 그러나 1 minute 60 seconds 간격이 PostgreSQL 데이터베이스에 삽입되면 자동으로 2 minutes 0 seconds로 변환됩니다. 결과적으로 이후 고유 컬럼에 2 minutes 0 seconds 간격을 삽입하려고 하면 오류가 발생합니다

테이블에 interval 타입의 고유 컬럼이 포함된 경우 영향을 받습니다:

PostgreSQL

import { drizzle } from "drizzle-orm/node-postgres";
import { pgTable, interval } from "drizzle-orm/pg-core";
import { seed } from "drizzle-seed";

const intervals = pgTable("intervals", {
    interval: interval().unique()
});

async function main() {
  const db = drizzle(process.env.DATABASE_URL!);

  await seed(db, { intervals });
}

main();

아래 스크립트에 표시된 대로 시딩 스크립트에서 고유 interval 생성기를 사용하는 경우 영향을 받습니다:

PostgreSQL

MySQL

SQLite

import { drizzle } from "drizzle-orm/node-postgres";
import { pgTable, interval, char, varchar, text } from "drizzle-orm/pg-core";
import { seed } from "drizzle-seed";

const intervals = pgTable("intervals", {
    interval: interval().unique(),
    interval1: interval(),
    interval2: char({ length: 256 }).unique(),
    interval3: char({ length: 256 }),
    interval4: varchar().unique(),
    interval5: varchar(),
    interval6: text().unique(),
    interval7: text(),
});

async function main() {
  const db = drizzle(process.env.DATABASE_URL!);

  await seed(db, { intervals }).refine((f) => ({
    intervals: {
        columns: {
            interval: f.interval({ isUnique: true }),
            interval1: f.interval({ isUnique: true }),
            interval2: f.interval({ isUnique: true }),
            interval3: f.interval({ isUnique: true }),
            interval4: f.interval({ isUnique: true }),
            interval5: f.interval({ isUnique: true }),
            interval6: f.interval({ isUnique: true }),
            interval7: f.interval({ isUnique: true }),
        }
    }
  }));
}

main();

import { binary, char, mysqlTable, text, varbinary, varchar } from 'drizzle-orm/mysql-core';
import { drizzle } from 'drizzle-orm/mysql2';
import { seed } from "drizzle-seed";

const intervals = mysqlTable('intervals', {
	interval1: char({ length: 255 }).unique(),
	interval2: char({ length: 255 }),
	interval3: varchar({ length: 255 }).unique(),
	interval4: varchar({ length: 255 }),
	interval5: binary({ length: 255 }).unique(),
	interval6: binary({ length: 255 }),
	interval7: varbinary({ length: 255 }).unique(),
	interval8: varbinary({ length: 255 }),
	interval9: text(),
});

async function main() {
	const db = drizzle(process.env.DATABASE_URL!);

	await seed(db, { intervals }, { version: '2' }).refine((f) => ({
		intervals: {
			columns: {
				interval: f.interval({ isUnique: true }),
				interval1: f.interval({ isUnique: true }),
				interval2: f.interval({ isUnique: true }),
				interval3: f.interval({ isUnique: true }),
				interval4: f.interval({ isUnique: true }),
				interval5: f.interval({ isUnique: true }),
				interval6: f.interval({ isUnique: true }),
				interval7: f.interval({ isUnique: true }),
				interval8: f.interval({ isUnique: true }),
				interval9: f.interval({ isUnique: true }),
			},
		},
	}));
}

main();

import { blob, sqliteTable, text } from 'drizzle-orm/sqlite-core';
import { drizzle } from 'drizzle-orm/better-sqlite3';
import { seed } from 'drizzle-seed';

const intervals = sqliteTable('intervals', {
	interval1: text().unique(),
	interval2: text(),
	interval3: blob().unique(),
	interval4: blob(),
});

async function main() {
	const db = drizzle(process.env.DATABASE_URL!);

	await seed(db, { intervals }).refine((f) => ({
		intervals: {
			columns: {
				interval1: f.interval({ isUnique: true }),
				interval2: f.interval({ isUnique: true }),
				interval3: f.interval({ isUnique: true }),
				interval4: f.interval({ isUnique: true }),
			},
		},
	}));
}

main();

`string` 생성기가 변경되었습니다: 고유하지 않은 생성기와 고유 생성기 모두

업그레이드 이유

텍스트 컬럼의 길이(예: varchar(20))를 기반으로 고유 문자열을 생성할 수 있는 기능

최대 길이 매개변수가 있는 텍스트 유형의 컬럼이나 텍스트 유형의 고유 컬럼이 테이블에 포함된 경우 영향을 받습니다:

PostgreSQL

MySQL

SQLite

import { drizzle } from "drizzle-orm/node-postgres";
import { pgTable, char, varchar, text } from "drizzle-orm/pg-core";
import { seed } from "drizzle-seed";

const strings = pgTable("strings", {
    string2: char({ length: 256 }).unique(),
    string3: char({ length: 256 }),
    string4: varchar().unique(),
    string5: varchar({ length: 256 }).unique(),
    string6: varchar({ length: 256 }),
    string7: text().unique(),
});

async function main() {
  const db = drizzle(process.env.DATABASE_URL!);

  await seed(db, { strings });
}

main();

import { binary, char, mysqlTable, varbinary, varchar } from 'drizzle-orm/mysql-core';
import { drizzle } from 'drizzle-orm/mysql2';
import { seed } from "drizzle-seed";

const strings = mysqlTable('strings', {
	string1: char({ length: 255 }).unique(),
	string2: char({ length: 255 }),
	string3: varchar({ length: 255 }).unique(),
	string4: varchar({ length: 255 }),
	string5: binary({ length: 255 }).unique(),
	string6: binary({ length: 255 }),
	string7: varbinary({ length: 255 }).unique(),
	string8: varbinary({ length: 255 }),
});

async function main() {
	const db = drizzle(process.env.DATABASE_URL!);

	await seed(db, { strings });
}

main();

import { drizzle } from 'drizzle-orm/better-sqlite3';
import { blob, sqliteTable, text } from 'drizzle-orm/sqlite-core';
import { seed } from "drizzle-seed";

const strings = sqliteTable('strings', {
	string1: text().unique(),
	string2: text({ length: 256 }),
	string3: text({ length: 256 }).unique(),
	string4: blob().unique(),
});

async function main() {
  const db = drizzle(process.env.DATABASE_URL!);

  await seed(db, { strings });
}

main();

아래 스크립트에 표시된 대로 시딩 스크립트에서 string 생성기를 사용하는 경우 영향을 받습니다:

PostgreSQL

MySQL

SQLite

import { drizzle } from "drizzle-orm/node-postgres";
import { pgTable, char, varchar, text } from "drizzle-orm/pg-core";
import { seed } from "drizzle-seed";

const strings = pgTable("strings", {
    string1: char({ length: 256 }).unique(),
    string2: char({ length: 256 }),
    string3: char({ length: 256 }),
    string4: varchar(),
    string5: varchar().unique(),
    string6: varchar({ length: 256 }).unique(),
    string7: varchar({ length: 256 }),
    string8: varchar({ length: 256 }),
    string9: text().unique(),
    string10: text(),
});

async function main() {
  const db = drizzle(process.env.DATABASE_URL!);

  await seed(db, { strings }).refine((f) => ({
    strings: {
        columns: {
            string1: f.string({ isUnique: true }),
            string2: f.string(),
            string3: f.string({ isUnique: true }),
            string4: f.string({ isUnique: true }),
            string5: f.string({ isUnique: true }),
            string6: f.string({ isUnique: true }),
            string7: f.string(),
            string8: f.string({ isUnique: true }),
            string9: f.string({ isUnique: true }),
            string10: f.string({ isUnique: true }),
        }
    }
  }));
}

main();

import { binary, char, mysqlTable, text, varbinary, varchar } from 'drizzle-orm/mysql-core';
import { drizzle } from 'drizzle-orm/mysql2';
import { seed } from "drizzle-seed";

const strings = mysqlTable('strings', {
	string1: char({ length: 255 }).unique(),
	string2: char({ length: 255 }),
	string3: char({ length: 255 }),
	string4: varchar({ length: 255 }).unique(),
	string5: varchar({ length: 255 }),
	string6: varchar({ length: 255 }),
	string7: binary({ length: 255 }).unique(),
	string8: binary({ length: 255 }),
	string9: binary({ length: 255 }),
	string10: varbinary({ length: 255 }).unique(),
	string11: varbinary({ length: 255 }),
	string12: varbinary({ length: 255 }),
	string13: text(),
});

async function main() {
	const db = drizzle(process.env.DATABASE_URL!);

	await seed(db, { strings }).refine((f) => ({
		strings: {
			columns: {
				string1: f.string({ isUnique: true }),
				string2: f.string({ isUnique: true }),
				string3: f.string(),
				string4: f.string({ isUnique: true }),
				string5: f.string({ isUnique: true }),
				string6: f.string(),
				string7: f.string({ isUnique: true }),
				string8: f.string({ isUnique: true }),
				string9: f.string(),
				string10: f.string({ isUnique: true }),
				string11: f.string({ isUnique: true }),
				string12: f.string(),
				string13: f.string({ isUnique: true }),
			},
		},
	}));
}

main();

import { blob, sqliteTable, text } from 'drizzle-orm/sqlite-core';
import { drizzle } from 'drizzle-orm/better-sqlite3';
import { seed } from "drizzle-seed";

const strings = sqliteTable("strings", {
    string1: text().unique(),
	string2: text(),
	string3: text({ length: 256 }).unique(),
	string4: text({ length: 256 }),
	string5: text({ length: 256 }),
	string6: blob().unique(),
	string7: blob(),
});

async function main() {
	const db = drizzle(process.env.DATABASE_URL!);

	await seed(db, { strings }).refine((f) => ({
		strings: {
			columns: {
				string1: f.string({ isUnique: true }),
				string2: f.string({ isUnique: true }),
				string3: f.string({ isUnique: true }),
				string4: f.string({ isUnique: true }),
				string5: f.string(),
				string6: f.string({ isUnique: true }),
				string7: f.string({ isUnique: true }),
			},
		},
	}));
}

main();

버전 관리

히스토리

버전 3의 firstName 생성기와 버전 2의 lastName 생성기를 사용합니다

버전 1의 firstName 생성기와 버전 2의 lastName 생성기를 사용합니다

버전 1의 firstName 생성기와 버전 1의 lastName 생성기를 사용합니다.

버전 2

고유 interval 생성기가 변경되었습니다

string 생성기가 변경되었습니다: 고유하지 않은 생성기와 고유 생성기 모두

버전 3의 `firstName` 생성기와 버전 2의 `lastName` 생성기를 사용합니다

버전 1의 `firstName` 생성기와 버전 2의 `lastName` 생성기를 사용합니다

버전 1의 `firstName` 생성기와 버전 1의 `lastName` 생성기를 사용합니다.

고유 `interval` 생성기가 변경되었습니다

`string` 생성기가 변경되었습니다: 고유하지 않은 생성기와 고유 생성기 모두