D1 提供数据库分析功能,允许您检查账户中所有和/或每个数据库的查询量、查询延迟和存储大小。
Cloudflare 仪表板 ↗ 图表中显示的指标从 Cloudflare 的 GraphQL Analytics API 查询。您可以通过 GraphQL 或 HTTP 客户端以编程方式访问这些指标。
D1 目前导出以下指标:
| 指标 | GraphQL 字段名 | 描述 |
|---|---|---|
| 读取查询(qps) | readQueries |
针对数据库发出的读取查询数量。这是原始读取查询数量,不用于计费。 |
| 写入查询(qps) | writeQueries |
针对数据库发出的写入查询数量。这是原始写入查询数量,不用于计费。 |
| 读取行数(计数) | rowsRead |
查询中读取(扫描)的行数。有关行计数方式的更多详情,请参阅定价。 |
| 写入行数(计数) | rowsWritten |
查询中写入的行数。 |
| 查询响应(字节) | queryBatchResponseBytes |
序列化查询响应的总响应大小,包括所有/任何列名、行和元数据。以字节为单位报告。 |
| 查询延迟(毫秒) | queryBatchTimeMs |
服务器端总查询响应时间,包括响应序列化。以毫秒为单位报告。 |
| 存储空间(字节) | databaseSizeBytes |
数据库的最大大小。以字节为单位报告。 |
指标可查询(并保留)过去 31 天的数据。
D1 通过 Workers Binding API 为每个独立查询返回读取行数、写入行数(或两者)。
行计数是对该查询读取(扫描)或写入的行数的精确计数。 检查行计数以了解给定查询的性能和成本,包括是否可以通过使用索引减少读取行数。使用查询计数了解数据库的总流量,并判断哪些数据库处于活跃使用状态。
有关行计数方式的更多详情,请参阅定价文档。
D1 的每个数据库分析可在 Cloudflare 仪表板中查看。要查看数据库的当前和历史指标:
-
在 Cloudflare 仪表板中,前往 D1 页面。
前往 D1 SQL database(D1 SQL 数据库) ↗ -
选择一个现有 D1 数据库。
-
选择 Metrics(指标) 选项卡。
您可以选择要查询的时间窗口。默认为过去 24 小时。
您可以通过 GraphQL Analytics API 以编程方式查询 D1 数据库的分析数据。此 API 查询与 Cloudflare 仪表板相同的数据集,并支持 GraphQL 内省。
D1 的 GraphQL 数据集需要带有 Cloudflare 账户 ID 的 accountTag 过滤器,包括:
d1AnalyticsAdaptiveGroupsd1StorageAdaptiveGroupsd1QueriesAdaptiveGroups
要查询给定 $databaseId 的 readQueries、writeQueries 总和,按 databaseId 和 date 分组:
query D1ObservabilitySampleQuery(
$accountTag: string!
$start: Date
$end: Date
$databaseId: string
) {
viewer {
accounts(filter: { accountTag: $accountTag }) {
d1AnalyticsAdaptiveGroups(
limit: 10000
filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
orderBy: [date_DESC]
) {
sum {
readQueries
writeQueries
}
dimensions {
date
databaseId
}
}
}
}
}要查询每个数据库的平均 queryBatchTimeMs 和第 90 百分位 queryBatchTimeMs:
query D1ObservabilitySampleQuery2(
$accountTag: string!
$start: Date
$end: Date
$databaseId: string
) {
viewer {
accounts(filter: { accountTag: $accountId }) {
d1AnalyticsAdaptiveGroups(
limit: 10000
filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
orderBy: [date_DESC]
) {
quantiles {
queryBatchTimeMsP90
}
dimensions {
date
databaseId
}
}
}
}
}要查询账户范围的 readQueries 和 writeQueries:
query D1ObservabilitySampleQuery3(
$accountTag: string!
$start: Date
$end: Date
$databaseId: string
) {
viewer {
accounts(filter: { accountTag: $accountTag }) {
d1AnalyticsAdaptiveGroups(
limit: 10000
filter: { date_geq: $start, date_leq: $end, databaseId: $databaseId }
) {
sum {
readQueries
writeQueries
}
}
}
}
}D1 提供指标,帮助您了解和调试查询性能。您可以通过 GraphQL 的 d1QueriesAdaptiveGroups 或 wrangler d1 insights 命令访问这些指标。
D1 捕获您的查询字符串,以便更轻松地分析跨查询执行的指标。绑定参数不会被捕获,以移除任何敏感信息。
wrangler d1 insights 会从 GraphQL Analytics API 读取数据。如果使用 API 令牌,该令牌必须具有 Account Analytics Read 权限。
传入数据库名称、绑定或 ID,可获取该数据库的热门查询。省略此参数则会针对整个帐户运行,并获取帐户中所有 D1 数据库的热门查询:
# Top queries for one database
npx wrangler d1 insights <database_name_or_id>
# Top queries across every D1 database in the account
npx wrangler d1 insights针对整个帐户运行时,每个结果还会包含 databaseId 字段,其中是执行该查询的数据库 ID。若要查找数据库名称,请运行 npx wrangler d1 info <database_id>。
| 选项 | 描述 |
|---|---|
--time-period |
获取从当前时间到指定时间范围的数据,例如 30m、12h 或 7d(默认值:1d,最大值:31d)。 |
--sort-type |
您想要排序 insights 的操作。在 sum 和 avg 之间选择(默认:sum)。 |
--sort-by |
您想要排序 insights 的字段。在 time、reads、writes 和 count 之间选择(默认:time)。 |
--sort-direction |
排序方向。在 ASC 和 DESC 之间选择(默认:DESC)。 |
--json |
布尔值,指定是否以干净的 JSON 返回结果(默认:false)。 |
--limit |
要获取的查询数量上限。针对整个帐户运行时,此限制适用于所有数据库(默认值:5)。 |
按执行次数查找帐户中所有数据库的前 3 条查询:
npx wrangler d1 insights --sort-type=sum --sort-by=count --limit=3 --json[
{
"query": "SELECT \"Order\".Id, \"Order\".CustomerId, \"Order\".OrderDate,\n SUM(OrderDetail.UnitPrice * OrderDetail.Quantity) AS TotalAmount\n FROM \"Order\"\n JOIN OrderDetail ON OrderDetail.OrderId = \"Order\".Id\n GROUP BY \"Order\".Id\n ORDER BY \"Order\".Id DESC\n LIMIT ?",
"avgRowsRead": 1244521,
"totalRowsRead": 11040145791,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 259.2086358584151,
"totalDurationMs": 2299439.8087000004,
"numberOfTimesRun": 8871,
"queryEfficiency": 1.6070439952399358e-05,
"databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
},
{
"query": "SELECT * FROM \"Order\" WHERE OrderDate BETWEEN ? AND ?",
"avgRowsRead": 16818,
"totalRowsRead": 148553394,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 5.4971649382995595,
"totalDurationMs": 48556.45790000001,
"numberOfTimesRun": 8833,
"queryEfficiency": 0.019146152931383043,
"databaseId": "2e4f6a81-9c3d-4b7e-a512-8d0f3c6b9e15"
},
{
"query": "SELECT * FROM Customer WHERE Id = ?",
"avgRowsRead": 1,
"totalRowsRead": 8714,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 0.318006288730778,
"totalDurationMs": 2771.1067999999996,
"numberOfTimesRun": 8714,
"queryEfficiency": 1,
"databaseId": "b5d18e3a-6f29-4c04-8e7b-1a9c2d5f7e60"
}
]每个结果都包含执行该查询的数据库的 databaseId。
查找平均执行时间最长的前 3 个查询:
npx wrangler d1 insights <database_name> --sort-type=avg --sort-by=time --limit=3⛅️ wrangler 3.95.0
-------------------
-------------------
🚧 `wrangler d1 insights` is an experimental command.
🚧 Flags for this command, their descriptions, and output may change between wrangler versions.
-------------------
[
{
"query": "SELECT * From Customers",
"avgRowsRead": 0,
"totalRowsRead": 0,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 1.0225,
"totalDurationMs": 1.0225,
"numberOfTimesRun": 1,
"queryEfficiency": 0
},
{
"query": "SELECT tbl_name as name,\n (SELECT ncol FROM pragma_table_list(tbl_name)) as num_columns\n FROM sqlite_master\n WHERE TYPE = \"table\"\n AND tbl_name NOT LIKE \"sqlite_%\"\n AND tbl_name NOT LIKE \"d1_%\"\n AND tbl_name NOT LIKE \"_cf_%\"\n ORDER BY tbl_name ASC;",
"avgRowsRead": 2,
"totalRowsRead": 4,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 0.49505,
"totalDurationMs": 0.9901,
"numberOfTimesRun": 2,
"queryEfficiency": 0
},
{
"query": "SELECT * FROM Customers",
"avgRowsRead": 4,
"totalRowsRead": 4,
"avgRowsWritten": 0,
"totalRowsWritten": 0,
"avgDurationMs": 0.1873,
"totalDurationMs": 0.1873,
"numberOfTimesRun": 1,
"queryEfficiency": 1
}
]查找过去 7 天内帐户中所有数据库写入行数最多的前 3 条查询:
npx wrangler d1 insights --sort-type=sum --sort-by=writes --limit=3 --time-period=7d --json[
{
"query": "INSERT INTO OrderDetail (Id, OrderId, ProductId, UnitPrice, Quantity, Discount) VALUES (?, ?, ?, ?, ?, ?)",
"avgRowsRead": 0,
"totalRowsRead": 0,
"avgRowsWritten": 3,
"totalRowsWritten": 453720,
"avgDurationMs": 0.41,
"totalDurationMs": 62008.4,
"numberOfTimesRun": 151240,
"queryEfficiency": 0,
"databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
},
{
"query": "INSERT INTO \"Order\" (Id, CustomerId, EmployeeId, OrderDate, ShipVia, Freight) VALUES (?, ?, ?, ?, ?, ?)",
"avgRowsRead": 0,
"totalRowsRead": 0,
"avgRowsWritten": 1,
"totalRowsWritten": 48906,
"avgDurationMs": 0.38,
"totalDurationMs": 18584.28,
"numberOfTimesRun": 48906,
"queryEfficiency": 0,
"databaseId": "7c9e2b14-3f6a-4d8e-9b21-5a0c8f3e6d47"
},
{
"query": "UPDATE Product SET UnitsInStock = UnitsInStock - ? WHERE Id = ?",
"avgRowsRead": 1,
"totalRowsRead": 37118,
"avgRowsWritten": 1,
"totalRowsWritten": 37118,
"avgDurationMs": 0.29,
"totalDurationMs": 10764.22,
"numberOfTimesRun": 37118,
"queryEfficiency": 0,
"databaseId": "2e4f6a81-9c3d-4b7e-a512-8d0f3c6b9e15"
}
]每个结果都包含执行该查询的数据库的 databaseId。
若要查找帐户中成本最高的数据库和查询,并了解如何修复,请参阅查找缓慢且成本高昂的查询。