integration-test

Integration tests use testserver, a fully functional CockroachDB server with all components in-memory and in the same process. They're SLOW to spin up (can add seconds per test case), so use them only when necessary.

Prefer sqlutils.MakeSQLRunner over raw database connections in most cases. It provides automatic error handling (fails the test on error), cleaner syntax, and helper methods for common operations.

Use sqlDB.DB when you need direct error handling rather than automatic test failure:

使用 CockroachDB 测试服务器编写集成测试的指南，包括何时使用它们以及如何使用 sqlutils。 来源：cockroachdb/cockroach。