特定のセットアップデータに依存するテストを実行したい場合、テストランナーから直接データベースを操作する構成が手軽です。
JestなどJavascriptプロジェクトでは、node-postgres を利用できます。
node-postgresはnpm install --save-dev pgでインストールできます。
node-postgresのリファレンス
に沿って、DBに接続しSQLを発行します。
Jest用ボイラープレート
JestのbeforeAll(), AfterALl()を利用して、接続・解放を行うコード例は以下のとおりです。
テストデータを一時的に投入するケースを想定して、TRUNCATEを追加してあります。
const { Client } = require('pg');
let client;
beforeAll(async () => {
client = new Client({
host: 'localhost',
user: 'postgres',
password: 'dbpassword',
database: 'some_db'
});
await client.connect();
await client.query('TRUNCATE some_table');
});
afterAll(async () => {
await client.query('TRUNCATE some_table');
await client.end();
});
DBのリクエストは非同期であるため、async/awaitを適切に記述する必要があります。
jestのbeforeAll()は非同期コードの動作が不安定で、実行時間の長いコードを詰め込むとタイムアウトのエラーが起きやすくなります。
Asynchronous beforeEach / beforeAll? #1256
に議論がありますが、再現性がなく決定打なきまま打ち切られています。
beforeAll()では接続処理程度にとどめ、データ追加のクエリは、beforeEach()に分割すると多少安定するようです。
また、各テストケース内でも実行はできるのですが、INSERTが反映されないケースを確認しており、これは切り分けが難しいコードになりがちです。更新処理についてはbeforeEach()に集約した方が安全です。
用途
サーバーサイドnodeのプロジェクトに限らず、フロントエンドのプロジェクトであってもSQLを直接操作できます。
テストケースはクライアント側で制御するため、クライアントのテストコードから直接DB操作した方が対応が明確になるような場合に便利です。
データセットアップのほか、クライアント投稿後のDBデータをSELECTしてDBデータを検証することも可能です。
⁋ 2021/06/24↻ 2021/08/01
sqldef は RDBMS のスキーマを config に沿って更新する CLI ツールです。
先行実装 ridgepole の Go クローンと言えます。
Web フレームワークで標準的なマイグ …
PostgreSQLの COPY コマンドは、テーブルデータをCSVファイルなどの形式でインポート／エクスポートする機能です。
COPYと\copyがあり、COPYはサーバー側、\copyはpsqlク …
PostgreSQLはリファレンスが非常に充実していますが、サポートする機能が多彩であるため個別のケースの挙動が自明ではないことがあります。
ストアド関数は複雑なケースを扱うことが多く、挙動の観察が重 …
PostgreSQLのパーティショニングはバージョンアップごとに強化されてきています。
アプリケーションに合わせてデータアクセスを局所化できれば、データが成長しても性能を維持しやすくなります。
パーテ …
複数行を一括でINSERTする際、配列を利用できます。配列型のカラムではなく、複数行を投入する方法です。
PostgreSQLにはunnest()という関数があり、配列を行に変換できます。
たとえば、 …
DBMSにはユニークインデックスがあり、重複レコードをINSERTしようとするとエラーで保護する機能があります。
そして最低限、主キーはユニークです。
テストなどの場合、主キーも含めて同じデータをセッ …
ネストしたテーブル設計では、1:Nの構造になるレコードが頻発します。
その場合の素朴なSQLは以下のような記述になるでしょう。
SELECT categories.name, …
ストアドプロシージャ、ストアドファンクションは、DBに登録(stored)する関数で、PostgreSQLの標準機能を利用する場合、PL/pgSQLで書きます。
ストアドプロシージャの使いどころ スト …
RustでDB接続するcrate(Rustパッケージ)にはいくつかのプロダクトがありますが、非同期処理を重視した非ORマッパーのcrateとしては、tokio-postgresを使えます。
接続 …
PostgreSQlのロジカルレプリケーションは、ALTER PUBLICATION / ALTER SUBSCRIPTIONを利用して、運用開始後にテーブル追加などの変更を行えます。
（セットアップ …
PostgreSQLのアップグレードには、公式ツール pg_upgrade を利用できます。
ただし、pg_upgradeを実行する前提に以下の条件があり、 公式コンテナイメージ では実行できません。 …
ロジカルレプリケーション機能を利用すると、テーブル単位でレプリケーション構成をとれます。
一般的なRead/Writeスプリット構成のほか、アプリケーションフレームワークから見て単一DB内に外部マスタ …
レコード数の多いアプリケーションの場合、データベースの一部を切り出して取得したいケースがあります。
このような場合、一度バックアップ用のミニテーブルを作成する手順が手軽です。
PostgreSQLのバ …
PostgreSQLやMySQLなどのデータベースのバックアップ＆リストアにはいくつか方法がありますが、SQL形式の論理バックアップを取得する方法が一般的です。
とくに、DBMSを別のサーバーに構築し …
kubernetesでシステム構築する際に、意外に難しいのがデータベースの構築やバックアップ＆リストアです。
DBインスタンスのコンテナを立てることじたいは簡単なのですが、論理バックアップでデータを移 …
EN contents
sqldef is a CLI tool to maintain RDBMS schema along with corresponding configs.
It is a ridgepole …
While PL/pgSQL has LOOP flow for recursive operations, SQL or psql doesn’t have one.
If you want to …
DBMS has the unique index feature that protects against INSERTing duplicate records, and at a …
