[设计器]JDBC连接数据库

1 概述

JDBC（Java DataBase Connectivity）是一种用于执行SQL语句的Java API，可以为多种数据库提供统一访问。
它由一组用Java语言编写的类和接口组成，是我们最常用的数据库连接接口方式。

2 操作步骤

2.1 选择创建方式

  乐创者提供了两种数据连接创建方式：
  方式一：在智能门户中进行创建，具体方法请参见：数据连接管理
  方式二：在设计器中进行创建 ，本文主要介绍此种方式。

2.2 选择连接类型

JDBC数据连接的创建，系统提供了一个向导窗体：

系统提供了“简单”和“高级”两种配置方式，“简单”方式下可配置一些常用的数据库连接参数配置，简单、易用，适用于大部分常规应用情景；“高级”方式提供用户通过编写JDBC连接串的方式进行配置，需要了解JDBC连接串知识、可扩展性强，适用于需要通过特殊参数或连接数据库集群等特殊应用情景。

2.2.1 简单方式的数据库设置

连接类型选择“简单”时，数据库设置界面如下：

1）类型：选择数据库类型，支持MYSQL、SQL Server、Oracle、AnalyticDB等关系型数据库，还支持达梦、华为、人大金仓等国产化数据库，用户可按需选择，不同的数据库类型的数据库设置会有少许差别；
2）ODBC：如果选择的数据库类型是ODBC，由于ODBC数据源中已经具有了连接实际数据库的地址和密码了，所以只需要填写ODBC的数据源名称就可以了；
3）服务器地址：非ODBC的数据源，需要 填写服务器的地址。地址可以是IP地址，也可以是能够解析为IP地址的名称；
4）端口：服务器的端口，是一个整数值，根据数据源的实际情况进行填写；
5）数据库名：填写数据库名称；
6）用户名：填写登录数据库的用户名；
7）密码：填写登录密码。
8）字符集：选择某种字符集。
9）表空间：授权能够访问的空间，只有Oracle、达梦和人大金仓3种数据库支持配置。

2.2.2 高级方式的数据库设置

连接类型选择“高级”时，数据库设置界面如下：

由于JDBC的本质是用一个URL串来配置与服务器的连接以及配置相关的连接属性的，所以，这种方式是JDBC“原始”的方式。
所以，“简单”或“原始”两种方式最终的结果一样，无非“原始”方式会要求您必构造和填写一个“URL串”。
假设选择了MySQL数据库类型，那么，URL串的构造一般是例如：

jdbc:MySQL://db1.lczyun.com:10155/order?
useUnicode=true&characterEncoding=utf8&autoReconnect=true&failOverReadOnly=false

上述URL中，包含了地址、端口、数据库名以及相关的字符集编码等属性。

2.3 连接池设置

由于1个数据库连接同一时刻只能为1个查询所服务，所以，当并发访问数据库的时候，往往需要多个数据库连接同时使用。
“连接池”，是把同一个数据库的连接象蓄水池一样地存在，随时为查询提供“水资源”。
所以，当访问数据库并发量很大的时候，相关的连接池的容量参数要配套调整，以适应不同场景下的使用。
设置界面如下图：

1）最小空闲连接数：默认为0。乐创者服务启动后，会按照这个数量来初始化该数据库的连接数。
2）最大活动连接数：默认为50。该数量代表最大负荷访问数据库的数据连接数。
3）连接等待超时（毫秒）：默认为30000。尝试连接到连接成功之间的时间如果超过了这个阈值，系统就认为连接失败了。
4）状态查询SQL：默认为空。状态查询SQL是用来检查数据库是否能够连接成功。如果是空，则启用默认SQL，即“SELECT 1”语句，如果所连接的数据库不支持这个语句，那么我们您就得在这里填写一句其它的语句，一般不需要填写。

2.4 其它设置

其他设置，如下图：

1）最大记录数：默认不勾选。一旦勾选，则默认如上图。您可以修改具体值。这个阈值的含义是，如果一个查询所检索的二维集记录数量超过这个阈值的话，则被系统认为是故障，抛出错误。
2）最大查询时间（秒）：默认不勾选。一旦勾选，则默认如上图。您可以修改具体值。这个阈值的含义是，如果一个查询的执行时间（从递交查询到结果返回的时间间隔）超过这个阈值的话，系统认为查询失败，抛出错误。