backstage 이해 - database

[hellices]

backstage의 backend는 knex 기반으로 database와 연결

knex can be used as an SQL query builder in both Node.JS and the browser, limited to WebSQL's constraints (like the inability to drop tables or read schemas)

ORM 동작을 수행하는데, 브라우저에서도 사용이 가능 ?!?!
backstage에서는 backend(nodejs)에서만 실핸한다.

접속 가능한 db는 pg(postgresql), sqlite3, mysql ,oracle 등.
각각의 db client를 설치해주어야 한다.

schema builder로 DML 수행

knex.schema.createTable('users', function (table) {
  table.increments();
  table.string('name');
  table.timestamps();
})

query builder

마치 spring jpa의 querydsl처럼 query builder가 존재하여 아래와 같이 사용할 수 있음.
다만, 일부 기능은 postgresql만 호환된다.

knex({ a: 'table', b: 'table' })
  .select({
    aTitle: 'a.title',
    bTitle: 'b.title'
  })
  .whereRaw('?? = ??', ['a.column_1', 'b.column_2'])

트랜잭션 다루기

• knex의 transaction api와 javascript의 promise를 조합해서 사용

// Simple read skew example
const isolationLevel = 'read committed';
const trx = await knex.transaction({isolationLevel});
const result1 = await trx(tableName).select();
await knex(tableName).insert({ id: 1, value: 1 });
const result2 = await trx(tableName).select();
await trx.commit();
// result1 may or may not deep equal result2 depending on isolation level

batch mode

chunk size를 주어 배치성으로 insert해준다.
그 외 timestamp, uuid 등 유틸 제공

const rows = [{/*...*/}, {/*...*/}];
const chunkSize = 30;
knex.batchInsert('TableName', rows, chunkSize)
  .returning('id')
  .then(function(ids) { /*...*/ })
  .catch(function(error) { /*...*/ });

knex.transaction(function(tr) {
  return knex.batchInsert('TableName', rows, chunkSize)
    .transacting(tr)
  })
  .then(function() { /*...*/ })
  .catch(function(error) { /*...*/ });

wrapped query

• sql의 sub-query나 in-line view도 가능

// Simple read skew example
const isolationLevel = 'read committed';
const trx = await knex.transaction({isolationLevel});
const result1 = await trx(tableName).select();
await knex(tableName).insert({ id: 1, value: 1 });
const result2 = await trx(tableName).select();
await trx.commit();
// result1 may or may not deep equal result2 depending on isolation level

migration

스키마 변경점을 reverse engineering으로 코드화시켜 마이그레이션을 하는 기능으로 보임. django에도 비슷한 기능이 있던걸로...

• 테스트 서버에서 제작한 뒤 운영으로 이관하는데 좋아보이는데, 우리회사에서 사용이 될지는...
• public(github)에서 사내(gitlab)로 이관할 때 사용이 가능할지도?