本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 检测对 PostgreSQL 数据库的调用
SQL 客户端

**注意**  
X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， Amazon X-Ray SDKs/Daemon 将进入维护模式，在该模式下，X-Ray SDK 和 Daemon 的发布 Amazon 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 [X-Ray SDK 和 Daemon Support 时间表](xray-sdk-daemon-timeline.md)。我们建议迁移到 OpenTelemetry。有关迁移到的更多信息 OpenTelemetry，请参阅[从 X-Ray 仪器迁移到 OpenTelemetry 仪器](https://docs.amazonaws.cn/xray/latest/devguide/xray-sdk-migration.html)。

`application-pgsql.properties` 文件将 X-Ray PostgreSQL 跟踪拦截程序添加到在 [https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/RdsWebConfig.java](https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/java/scorekeep/RdsWebConfig.java) 中创建的数据源。

**Example [https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/resources/application-pgsql.properties](https://github.com/awslabs/eb-java-scorekeep/tree/xray/src/main/resources/application-pgsql.properties) - PostgreSQL 数据库检测**  

```
spring.datasource.continue-on-error=true
spring.jpa.show-sql=false
spring.jpa.hibernate.ddl-auto=create-drop
spring.datasource.jdbc-interceptors=com.amazonaws.xray.sql.postgres.TracingInterceptor
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQL94Dialect
```

**注意**  
有关如何将 PostgreSQL 数据库添加到应用程序环境的详细信息，请参阅 [https://docs.amazonaws.cn/elasticbeanstalk/latest/dg/using-features.managing.db.html](https://docs.amazonaws.cn/elasticbeanstalk/latest/dg/using-features.managing.db.html) 开发人员指南* 中的Amazon Elastic Beanstalk 使用 Elastic Beanstalk 配置数据库*。

`xray` 分支中的 X-Ray 演示页包含一个使用检测的数据源生成跟踪的演示，此跟踪显示有关其生成的 SQL 查询的信息。导航到正在运行的应用程序中的 `/#/xray` 路径，或选择导航栏中的 **Powered by Amazon X-Ray** 查看该演示页。

![\[Amazon X-Ray integration demo page showing game session tracing and SQL query tracing options.\]](http://docs.amazonaws.cn/xray/latest/devguide/images/scorekeep-demo.png)


选择 **Trace SQL queries** 模拟游戏会话并将结果存储在附加的数据库中。然后，选择 “**在 Amazon X-Ray 中查看跟**踪”，查看经过筛选的到达该 API `/api/history` 路线的跟踪列表。

从该列表中选择一个跟踪以查看时间线，包括 SQL 查询。

![\[Timeline view of a trace showing method, response, duration, and age for a GET request.\]](http://docs.amazonaws.cn/xray/latest/devguide/images/scorekeep-trace-sql.png)