v1.0
98%
Benchmarks
Extension
Studio
Studio Package
Gateway
Drizzle Run
Our goodies!
Our Primary backer
PlanetScale
Our Cloud Partner
Railway
Lokalise
Replit
Sentry
Sevalla
Clerk
Warp
Turso
🚀 Drizzle is giving you 10% off Turso Scaler and Pro for 1 Year 🚀
Payload
Xata
Neon
SQLite Cloud
Upstash
Sponsor

统计行数

本指南假定您已熟悉：

要统计表中的所有行，你可以使用 count() 函数，或者像下面这样使用 sql 操作符：

index.ts
schema.ts
import { count, sql } from 'drizzle-orm';
import { products } from './schema';

const db = drizzle(...);

await db.select({ count: count() }).from(products);

// 在底层，count() 函数会在运行时将其结果转换为 number。
await db.select({ count: sql`count(*)`.mapWith(Number) }).from(products);
// 结果类型
type Result = {
  count: number;
}[];
select count(*) from products;

要统计指定列中包含非 NULL 值的行，可以在 count() 函数中传入一列：

await db.select({ count: count(products.discount) }).from(products);
// 结果类型
type Result = {
  count: number;
}[];
select count("discount") from products;

在 SQLite 中，count() 的返回结果是 integer。

import { sql } from 'drizzle-orm';

await db.select({ count: sql<number>`count(*)` }).from(products);
await db.select({ count: sql<number>`count(${products.discount})` }).from(products);
select count(*) from products;
select count("discount") from products;
IMPORTANT

通过指定 sql<number>，你是在告诉 Drizzle 该字段的预期类型是 number。
如果你指定错误（例如，对一个实际上会返回 number 的字段使用 sql<string>），运行时的值将与预期类型不匹配。 Drizzle 无法根据提供的类型泛型执行任何类型转换，因为这些信息在运行时不可用。

如果你需要对返回值应用运行时转换，可以使用 .mapWith() 方法。

要统计满足某个条件的行，可以使用 .where() 方法：

import { count, gt } from 'drizzle-orm';

await db
  .select({ count: count() })
  .from(products)
  .where(gt(products.price, 100));
select count(*) from products where price > 100

下面是如何将 count() 函数与连接和聚合一起使用：

index.ts
schema.ts
import { count, eq } from 'drizzle-orm';
import { countries, cities } from './schema';

// 统计每个国家的城市数量
await db
  .select({
    country: countries.name,
    citiesCount: count(cities.id),
  })
  .from(countries)
  .leftJoin(cities, eq(countries.id, cities.countryId))
  .groupBy(countries.id)
  .orderBy(countries.name);
select countries.name, count("cities"."id") from countries
  left join cities on countries.id = cities.country_id
  group by countries.id
  order by countries.name;