设置外部数据库

在 MySQL 服务器端

推荐的数据库服务器设置：

• 使用 InnoDB 存储引擎。

• 使用 utf8mb4 字符集 （或者如果 MySQL 版本是 5.5.2 或更早版本的话，使用 utf8）。

• 使用区分大小写的排序规则。

• 确保运行 TeamCity 的 JVM 和 MySQL 实例的时区保持一致，您可以使用 my.cnf 文件，或者在操作系统级别配置时区。

• 服务器的 sql_require_primary_key 系统变量必须设定为 关闭 ，因为 TeamCity 管理的表格没有主键。

• 也请参阅关于 MySQL 服务器设置的建议。

将被 TeamCity 使用的 MySQL 用户帐户必须被授予对 TeamCity 数据库的所有权限。 这可以通过在 MySQL 控制台中执行以下 SQL 命令来完成：

在 TeamCity 服务器端（配合 MySQL）

JDBC 驱动安装：

1. 下载 MySQL JDBC driver。 确保使用与您的服务器兼容的版本。 如果 MySQL 服务器版本是 5.5 或更高版本，那么 JDBC 驱动程序版本应至少为 5.1.23。 对于版本8以上，应使用驱动版本8。

2. 对于 Windows，以“自定义”模式运行安装程序，并选择“MySQL Connectors | Connector/J”以安装独立连接器。

3. 将下载的存档（Linux）或安装文件夹（Windows）中的 mysql-connector-java-*-bin.jar 复制到 <TeamCity 数据目录>/lib/jdbc 目录中（如果存在任何文件，请先删除）。 继续进行 TeamCity 设置。

在 PostgreSQL 服务器端

1. 在 PostgreSQL 中为 TeamCity 创建一个空的数据库。

   • 确保将数据库设置为使用 UTF8。

   • 授予 TeamCity 用户帐户修改此数据库的权限，该用户帐户被用于与数据库工作。

2. 另请参阅 PostgreSQL 服务器设置的建议。

TeamCity 并未明确指定将为其表格使用哪种模式。 默认情况下，PostgreSQL 会在 public schema 中创建表。 TeamCity 也可以与其他 PostgreSQL 架构一起使用。 要切换到不同的模式，请创建一个与用户名完全相同的模式。 这可以使用 pgAdmin 工具来完成，或使用以下的 SQL：

模式必须为空（不得包含任何表格）。

在 TeamCity 服务器端（使用 PostgreSQL）

下载所需的 PostgreSQL JDBC42 驱动程序 并将其放入 <TeamCity 数据目录>/lib/jdbc 目录中（如有任何现有文件，请先删除）。 继续进行 TeamCity 设置。

在 Oracle 服务器端

为 TeamCity 创建一个 Oracle 用户帐户 / 架构。

• 确保数据库实例的国家字符集是 UTF 或 Unicode。

• 授予 创建会话 和 创建表格 权限给一个用户。这个用户的账号将被 TeamCity 用于与这个数据库进行操作。

在首次连接时，TeamCity会在用户的模式中创建所有必要的表格和索引。 （注意：TeamCity 从不尝试访问其他架构，即使它们是可访问的。）

确保 TeamCity 用户有权限访问表空间。

在 TeamCity 服务器端（使用 Oracle）

1. 获取 Oracle JDBC 驱动。 支持的驱动程序版本为 11.1 及以后版本。 Oracle JDBC 驱动程序必须与您的 Oracle 服务器兼容。
   请放置以下文件：

   • ojdbc8.jar （或 ojdbc6.jar， ojdbc7.jar ，根据您的数据库版本而定）

   • orai18n.jar （如果在驱动版本中缺失，可以省略）
     导入至 <TeamCity 数据目录>/lib/jdbc 目录（如果有的话，删除那里的现有文件）。
     强烈建议您在 Oracle 服务器安装中定位驱动程序。 如果需要，联系您的 DBA 获取文件。 或者，从 Oracle 网站 下载 Oracle JDBC 驱动程序。

2. 继续进行 TeamCity 设置。

在 MS SQL Server 端

1. 创建一个新的数据库。 作为主要的排序约定，请使用与您的地区相对应的区分大小写的排序方式（排序名称以 _CS_AS 结尾）。

2. 创建一个 TeamCity 用户，并确保此用户是数据库的所有者（授予用户 dbo 权限），这将赋予用户修改数据库架构的能力。 对于 SSL 连接，请确保 MS SQL 服务器的版本和 TeamCity 的 Java 版本兼容。 我们建议使用 SQL 服务器的最新版本。

3. 根据服务器的使用强度，分配足够的事务日志空间。 我们建议的设置不低于 1 GB。

4. 确保 SQL Server 浏览器正在运行。

5. 确保已为 SQL Server 实例启用了 TCP/IP 协议。

在 TeamCity 服务器端（配合 MS SQL）

1. 下载 Microsoft JDBC 驱动程序v8.4+（ sqljdbc_8.4.x 包）从 Microsoft 下载中心。

2. 将下载的包解压到一个临时目录中。 将刚刚下载的包中的 mssql-jdbc-*.jre11.jar 复制到 <TeamCity 数据目录>/lib/jdbc 目录中（如果有的话，删除那里现有的文件）。 MS SQL 集成安全性（Windows 认证）需要按照 说明 从驱动程序包中安装 sqljdbc_auth.dll。

3. 继续进行 TeamCity 设置。

jTDS 驱动

不建议使用 jTDS JDBC 驱动程序，因为它存在已知的使用 Unicode 字符的问题。

如果您使用的是驱动程序（ jtds 文本出现在 connectionUrl 的 database.properties 中），强烈建议您切换至本地驱动程序：

1. 创建服务器 backup，包括数据库。

2. 停止服务器并配置服务器，使其使用在上述部分中提到的原生 Microsoft JDBC 驱动程序。

3. 将备份恢复到新的 MS SQL 数据库中。

4. 运行服务器。