メインコンテンツまでスキップ
に最終更新

Oracle JDBC Catalog

Apache Doris JDBC Catalog は、標準の JDBC インターフェースを介した Oracle データベースへの接続をサポートします。このドキュメントでは、Oracle データベースへの接続方法を説明します。

JDBC Catalog の概要については、JDBC Catalog の概要を参照してください。

使用上の注意​

Oracle データベースに接続するには、以下が必要です。

  • Oracle 19c、18c、12c、11g、または 10g。

  • Oracle データベース用の JDBC ドライバー。Oracle JDBC ドライバーの Ojdbc8 以降のバージョンは、Maven Repositoryからダウンロードできます。

  • Apache Doris の各 FE ノードおよび BE ノードと Oracle サーバー間のネットワーク接続。デフォルトのポートは 1521 です。Oracle RAC で ONS が有効な場合は、ポート 6200 も必要です。

Oracle への接続​

CREATE CATALOG oracle_catalog PROPERTIES (
    'type' = 'jdbc',
    'user' = 'username',
    'password'='pwd',
    'jdbc_url' = 'jdbc:oracle:thin:@example.net:1521:orcl',
    'driver_url' = 'ojdbc8.jar',
    'driver_class' = 'oracle.jdbc.driver.OracleDriver'
)

jdbc_url は、JDBC ドライバーに渡す接続情報とパラメーターを定義します。Oracle JDBC Thin ドライバーを使用する場合、URL の構文は Oracle の構成によって異なります。たとえば、Oracle SID に接続する場合と Oracle サービス名に接続する場合では、接続 URL が異なります。詳細については、Oracle Database JDBC Driver Documentationを参照してください。上の例の URL は、orcl という名前の Oracle SID に接続します。

階層のマッピング​

Oracle をマッピングする場合、Apache Doris のデータベースは Oracle のユーザーに対応します。また、Apache Doris のデータベース内のテーブルは、その Oracle ユーザーがアクセスできるテーブルに対応します。対応関係は次のとおりです。

DorisOracle
カタログデータベース
データベースユーザー
テーブルテーブル

列の型のマッピング​

Oracle の型Doris の型説明
number(P) / number(P, 0)tinyint/smallint/int/bigint/largeintDoris は P の大きさに応じて型を選択します。P < 3: TINYINT、P < 5: SMALLINT、P < 10: INT、P < 19: BIGINT、P > 19: LARGEINT
number(P, S), if (S > 0 && P > S)decimal(P, S)
number(P, S), if (S > 0 && P < S)decimal(S, S)
number(P, S), if (S < 0)tinyint/smallint/int/bigint/largeintS < 0 の場合、Doris は P を `P +
number現在、Doris は P と S が指定されていない number 型をサポートしていません。
decimal(P, S)decimal(P, S)
float/realdouble
datedate
timestampdatetime(S)
timestamp(s) with time zone / timestamp(s) with local time zoneTIMESTAMPTZ(S)4.1.5 以降、この型は常に TIMESTAMPTZ(S) にマッピングされます。enable.mapping.timestamp_tz プロパティは互換性のために保持されていますが、false に設定しても DATETIME へのマッピングには戻りません。精度の上限は 6 で、それを超える精度は失われます。それ以前のバージョンでは、このプロパティで従来のマッピングを選択できます。
char/ncharstring
varchar2/nvarchar2string
long/raw/long raw/internalstring
BLOBVARBINARY4.1.5 以降、この型は常に VARBINARY にマッピングされます。enable.mapping.varbinary プロパティは互換性のために保持されていますが、false に設定しても STRING へのマッピングには戻りません。それ以前のバージョンでは、このプロパティで従来のマッピングを選択できます。
otherUNSUPPORTED

よくある問題​

  1. Oracle Catalog の作成時またはクエリ時に ONS configuration failed が発生する

    be.conf の JAVA_OPTS に -Doracle.jdbc.fanEnabled=false を追加し、ドライバーを https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/19.23.0.0/ojdbc8-19.23.0.0.jar にアップグレードしてください。

  2. Oracle Catalog の作成時またはクエリ時に Non supported character set (add orai18n.jar in your classpath): ZHS16GBK 例外が発生する

    orai18n.jar をダウンロードし、各 FE と BE の custom_lib/ ディレクトリに配置してください。ディレクトリが存在しない場合は手動で作成します。その後、各 FE と BE を再起動してください。

Report issue