设置外部数据库

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

• 使用 InnoDB 存储引擎。

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

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

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

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

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

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

create database <database-name> collate utf8mb4_bin; -- or utf8_bin on MySQL 5.5.2 or earlier
create user <user-name> identified by '<password>';
grant all privileges on <database-name>.* to <user-name>;
grant process on *.* to <user-name>;

JDBC 驱动安装：

1. 下载 MySQL JDBC driver。 确保使用与您的服务器兼容的版本。

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

3. 从下载的归档文件（Linux）或安装文件夹（Windows）中复制 mysql-connector-j-<version>.jar 到 <TeamCity Data Directory>/lib/jdbc 目录中（如果有现有文件，请将其删除）。 继续进行 TeamCity 设置。

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

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

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

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

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

create schema teamcity authorization teamcity;

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

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

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

tip

TeamCity 使用主要字符集（char，varchar，clob）来存储内部文本数据，并使用国家字符集（nchar2，nvarchar，nclob）来存储用户输入和来自外部系统的数据，比如 VCS 和 NTLM。

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

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

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

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

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

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

   • orai18n.jar （如果驱动程序版本中缺失，可以省略）
     到 <TeamCity Data Directory>/lib/jdbc 目录中（如果有现有文件，请将其删除）。
     强烈建议将驱动程序放置在您的 Oracle 服务器安装中。 如果需要，联系您的 DBA 获取文件。 或者，从 Oracle 网站 下载 Oracle JDBC 驱动程序。

2. 继续进行 TeamCity 设置。

tip

TeamCity 使用主要字符集（char，varchar，text）来存储内部文本数据，并使用国家字符集（nchar，nvarchar，ntext）来存储用户输入和来自外部系统的数据，比如 VCS 和 NTLM。

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

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

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

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

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

1. 请从 Microsoft 下载中心 下载 Microsoft JDBC driver v12.6+ (sqljdbc_12.6.x 包)。

2. 将下载的包解压到一个临时目录中。 将刚下载的包中的 mssql-jdbc-<version>.jre8.jar 复制到 <TeamCity Data Directory>/lib/jdbc 目录中（如果有现有文件，请将其删除）。 MS SQL 集成安全性（Windows 身份验证）需要根据 说明从驱动程序包中安装 sqljdbc_auth.dll。

3. 继续进行 TeamCity 设置。

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

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

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

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

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

4. 运行服务器。