バージョン: 26.x

IBM Db2 JDBC カタログ

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

JDBC Catalogの概要については、以下を参照してください: 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
カタログ	DataBase
Database	Schema
Table	Table

カラム型マッピング

IBM Db2 タイプ	Doris タイプ	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

よくある問題

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;。
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

使用上の注意​

IBM Db2への接続​

階層マッピング​

カラム型マッピング​

よくある問題​

使用上の注意

IBM Db2への接続

階層マッピング

カラム型マッピング

よくある問題