execute() — drizzle-orm Function Reference

Architecture documentation for the execute() function in session.ts from the drizzle-orm codebase.

Function typescript DrizzleORM DatabaseDrivers calls 1 called by 2

Entity Profile

DrizzleORM→ DatabaseDrivers→ execute() — drizzle-orm Function Reference

Dependency Diagram

graph TD
  afed55a9_87b6_c85c_1288_688d4915117f["execute()"]
  eff3d8ee_672b_46f7_9a12_e937f96e0d1b["NeonPreparedQuery"]
  afed55a9_87b6_c85c_1288_688d4915117f -->|defined in| eff3d8ee_672b_46f7_9a12_e937f96e0d1b
  0df49818_fd3d_7eaf_026f_4bb7ca00ab17["transaction()"]
  0df49818_fd3d_7eaf_026f_4bb7ca00ab17 -->|calls| afed55a9_87b6_c85c_1288_688d4915117f
  bd152654_7670_2106_bc9f_e0113b3e1db9["transaction()"]
  bd152654_7670_2106_bc9f_e0113b3e1db9 -->|calls| afed55a9_87b6_c85c_1288_688d4915117f
  88f3cd0b_32e9_d2ff_604d_a5259bc10c9e["query()"]
  afed55a9_87b6_c85c_1288_688d4915117f -->|calls| 88f3cd0b_32e9_d2ff_604d_a5259bc10c9e
  style afed55a9_87b6_c85c_1288_688d4915117f fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

drizzle-orm/src/neon-serverless/session.ts lines 139–159

	async execute(placeholderValues: Record<string, unknown> | undefined = {}): Promise<T['execute']> {
		const params = fillPlaceholders(this.params, placeholderValues);

		this.logger.logQuery(this.rawQueryConfig.text, params);

		const { fields, client, rawQueryConfig: rawQuery, queryConfig: query, joinsNotNullableMap, customResultMapper } =
			this;
		if (!fields && !customResultMapper) {
			return await this.queryWithCache(rawQuery.text, params, async () => {
				return await client.query(rawQuery, params);
			});
		}

		const result = await this.queryWithCache(query.text, params, async () => {
			return await client.query(query, params);
		});

		return customResultMapper
			? customResultMapper(result.rows)
			: result.rows.map((row) => mapResultRow<T['execute']>(fields!, row, joinsNotNullableMap));
	}