IBM Db2 JDBCカタログ

Doris JDBC カタログは標準JDBCインターフェースを通じてIBM Db2データベースへの接続をサポートしています。このドキュメントでは、IBM Db2データベース接続の設定方法について説明します。

JDBC カタログの概要については、以下を参照してください: JDBC カタログ 概要

使用上の注意

IBM Db2データベースに接続するには、以下が必要です:

• IBM Db2 11.5.x以上

• IBM Db2データベース用のJDBCドライバー。最新版または指定バージョンのIBM Db2ドライバーはMaven Repositoryからダウンロードできます。IBM db2 jccバージョン11.5.8.0の使用を推奨します。

• 各Doris FEおよびBEノードとIBM Db2サーバー間のネットワーク接続。デフォルトポートは51000です。

IBM Db2への接続

CREATE CATALOG db2_catalog PROPERTIES (
    'type' = 'jdbc',
    'user' = 'USERNAME',
    'password' = 'PASSWORD',
    'jdbc_url' = 'jdbc:db2://host:port/database',
    'driver_url' = 'jcc-11.5.8.0.jar',
    'driver_class' = 'com.ibm.db2.jcc.DB2Driver'
)

jdbc_urlは、IBM Db2ドライバーに渡される接続情報とパラメータを定義します。サポートされているURLパラメータは、Db2 JDBC Driver Documentationで確認できます。

階層マッピング

IBM Db2をマッピングする際、DorisのDatabaseは、DB2の指定されたDataBase（jdbc_urlの「database」パラメータ）下のSchemaに対応します。そして、DorisのDatabase下のTableは、DB2のSchema下のTablesに対応します。マッピング関係は以下の通りです：

Doris	IBM Db2
Catalog	DataBase
Database	Schema
Table	Table

カラムタイプマッピング

IBM Db2 Type	Doris Type	Comment
smallint	smallint
int	int
bigint	bigint
double	double
double precision	double
float	double
real	float
decimal(P, S)	decimal(P, S)
decfloat(P, S)	decimal(P, S)
date	date
timestamp(S)	datetime(S)
char(N)	char(N)
varchar(N)	varchar(N)
long varchar(N)	varchar(N)
vargraphic	string
long vargraphic	string
time	string
clob	string
xml	string
BLOB	varbinary	Catalogのenable.mapping.varbinaryプロパティによって制御されます（4.0.2以降でサポート）。デフォルトはfalseで、stringにマッピングされます。trueの場合、varbinaryタイプにマッピングされます。
other	UNSUPPORTED

一般的な問題

1. JDBC CatalogでIBM Db2データを読み取る際に、Invalid operation: result set is closed. ERRORCODE=-4470例外が発生する。

   IBM Db2 Catalogを作成する際に、jdbc_url接続文字列に接続パラメータを追加してください：allowNextOnExhaustedResultSet=1;resultSetHoldability=1;。例：jdbc:db2://host:port/database:allowNextOnExhaustedResultSet=1;resultSetHoldability=1;。

2. Caught java.io.CharConversionException

   この問題は文字セットの問題が原因である可能性があります。be.confのJAVA_OPTSに設定-Ddb2.jcc.charsetDecoderEncoder=3を追加して、BEを再起動し、問題が解決されるかどうか試してみてください。1や2などの値も試してみてください。詳細については、以下を参照してください：https://www.ibm.com/docs/en/content-collector/4.0.1?topic=manager-jdbc-throws-javaiocharconversionexception