CREATE SERVER 语句- JDBC 包装器的示例

使用 CREATE SERVER 语句来注册 JDBC 包装器的服务器定义。此示例提供了用于简化和传统案例的必需参数，以及具有其他服务器参数的示例。

以下示例显示如何通过发出 CREATE SERVER 语句来注册 PostgreSQL 数据源的服务器定义:

--New simplifed syntax
CREATE SERVER jdbc_server1 
   TYPE JDBC 
   VERSION 3.0 
   OPTIONS (
   URL ‘jdbc:db2://server.example.com:50471/testdb');

--Old traditional syntax
CREATE SERVER jdbc_server1 
   TYPE JDBC 
   VERSION 3.0 
   WRAPPER jdbc_wrapper1 
   OPTIONS (
      DRIVER_PACKAGE '/path1/file1.jar: /path2/file2.jar', 
      DRIVER_CLASS ‘com.ibm.db2.jcc.DB2Driver', 
      URL ‘jdbc:db2://server.example.com:50471/testdb');

参数值

jdbc_server1: 指定分配给 JDBC 数据源服务器的名称。不允许重复的服务器定义名称。
TYPE JDBC: 指定要访问的数据源服务器的类型。此参数是可选的。
VERSION 3.0: 指定要访问的 JDBC 数据源的版本。此参数是可选的。
WRAPPER jdbc_wrapper1: 指定在 CREATE WRAPPER 语句中指定的包装器名称。
DRIVER_PACKAGE '/home/My_LIB/JDBC_driver/postgresql.jar': 指定 JDBC 驱动程序包。对于 Db2® v11.5.7 或更低版本，此参数是必需的。
DRIVER_CLASS ‘org.postgresql.Driver': 指定 JDBC 驱动程序库。此参数对于 Db2 v11.5.7 或更低版本是必需的。
URL ‘jdbc:postgresql://server.example.com:5432/testdb': 指定远程服务器的 JDBC 连接字符串。此参数是必需的。

服务器参数

创建服务器定义时，可以在 CREATE SERVER 语句中指定其他服务器选项。服务器选项可以同时包含常规服务器选项和特定于 JDBC的服务器参数。

通常，服务器参数的缺省设置具有有限的功能。您可以使用服务器参数来优化配置。

要访问 JDBC 数据源，必须在 CREATE SERVER 语句中指定 DRIVER_CLASS ， DRIVER_PACKAGE 和 URL 服务器参数。常规服务器选项是可选的。在特定于 JDBC的服务器选项列表中， JDBC_LOG 参数也是可选的。

OPTIONS (
   DRIVER_PACKAGE '/path1/file1.jar: /path2/file2.jar', 
   DRIVER_CLASS 'com.ibm.db2.jcc.DB2Driver', 
   URL 'jdbc:db2://server.example.com:50471/testdb',
   JDBC_LOG 'Y');

参数

DRIVER_PACKAGE '/path1/file1.jar: /path2/file2.jar'

指定 JDBC 驱动程序包。

DRIVER_CLASS 'com.ibm.db2.jcc.DB2Driver'

指定 Db2 JDBC 驱动程序库。

URL 'jdbc:db2://server.example.com:50471/testdb'

指定由三个部分组成的 JDBC 连接字符串，这些部分全部用冒号分隔:

数据库协议
数据库类型名称或连接驱动程序名称
通过别名或子名称的数据库标识

JDBC_LOG 'Y'

指定此项以创建用于错误跟踪的日志文件。此服务器选项的缺省值为 N。

示例

对于具有由用户下载的驱动程序的 Teradata 数据源: 当前，用户必须从 Teradata 供应商下载 Teradata JDBC 驱动程序。有关更多信息，请参阅准备联合服务器以通过类型为 1 的 JDBC 访问数据源。

CREATE SERVER jdbc_td 
   TYPE JDBC 
   VERSION 3.0 
   WRAPPER jdbc_wrapper1 
   OPTIONS (
      DRIVER_PACKAGE '/path1/tdgssconfig.jar:/path2/terajdbc4.jar', 
      DRIVER_CLASS ‘com.teradata.jdbc.TeraDriver’, 
      URL ‘jdbc:teradata://server.example.com /’, 
      JDBC_LOG 'Y');

对于缺省情况下已安装驱动程序的 SalesForce 数据源: 当前，缺省情况下已安装 SalesForce JDBC 驱动程序。有关更多信息，请参阅准备联合服务器以通过类型为 2 的 JDBC 访问数据源。

CREATE SERVER jdbc_salesforce  
   TYPE JDBC 
   VERSION 3.0 
   WRAPPER jdbc_wrapper1 
   OPTIONS (
      DRIVER_PACKAGE '$INSTANCE_HOME /sqllib/federation/jdbc/lib/FOsforce.jar',  
      DRIVER_CLASS ‘com.ibm.fluidquery.jdbc.sforce.SForceDriver’,  
      URL ‘jdbc:ibm:sforce://login.salesforce.com;SecurityToken=XXXX’, 
      JDBC_LOG 'Y');

URL 参数中的 "XXXX" 是 SalesForce中您帐户的"SecurityToken"。有关更多信息，请参阅此处。

对于具有您下载的驱动程序的 Amazon Athena 数据源: 当前，必须从 Amazon Athena 供应商下载 Athena JDBC 驱动程序。有关更多信息，请参阅准备联合服务器以通过类型为 1 的 JDBC 访问数据源。

CREATE SERVER jdbc_athena
   TYPE JDBC 
   WRAPPER jdbc_wrapper1
   OPTIONS (
      DRIVER_PACKAGE '/path/AthenaJDBC42_2.0.9.jar',  
      DRIVER_CLASS 'com.simba.athena.jdbc.Driver',  
      URL 'jdbc:awsathena://S3OutputLocation=s3://athena/out;AwsRegion=us-east-2;Schema=testdbu', 
      JDBC_LOG 'Y');

有关 Amazon Athena 的 URL 参数中的连接属性的更多信息，请参阅 Simba Athena JDBC Driver with SQL Connector: Installation and Configuration Guide。