Looker 22.16 のドキュメントを表示しています。最新のドキュメントはこちらをご覧ください。

パッケージ化されていない JDBC ドライバ

このページで説明する手順は、お客様がホストする Looker のデプロイにのみ適用されます。Looker ホスト型のデプロイの場合、Looker インスタンスがあらかじめ構成されている必要があります。問題が発生した場合は、Looker アナリストにお問い合わせください。

**これらの手順は、以下に示した方言でのみ使用することを想定しています。これは、サポートされていない他の JDBC ドライバを Looker にインストールして他のデータベースに接続する目的では使用しないでください。** 上述のドライバ以外の JDBC ドライバのインストールは動作しない可能性があり、Looker からテクニカルサポートを受ける資格がありません。

非パッケージ化 JDBC ドライバを使用するように Looker を構成する

Looker でサポートされている言語の一部については、ライセンス関連の理由により JDBC ドライバを Looker JAR ファイルにパッケージ化できません。このような場合には、JDBC ドライバを Looker サーバーにインストールしてから、このページの説明に沿ってパッケージ化されていないドライバを登録するように Looker を構成する必要があります。

次の表に、パッケージされていない JDBC ドライバのインストールが必要な言語を示します。

前提条件

Looker をパッケージ化されていない JDBC ドライバを必要とするデータベースに接続するには、以下が必要です。

Looker サーバーへのコマンドラインアクセス。
JAR ファイルとしての JDBC ドライバ。言語固有のドキュメントには、このファイルのダウンロード方法が記載されています。それ以外の場合は、必要な JAR ファイルにアクセスできることを前提としています。
言語のドライバシンボル。ドライバシンボルは、Looker が内部でドライバの言語とマッチングするために使用する文字列値です。このページの例では、一般的な値 driver_symbol を使用しています。Looker が言語に登録するために使用するシンボルについては、このページのドライバシンボルのリストをご覧ください。
言語の言語の YAML のドライバエントリを custom_jdbc_config.yml 構成ファイルに追加します。詳細については、このページの YAML 構成ファイルのドライバエントリをご覧ください。

YAML 構成ファイルのドライバエントリ

custom_jdbc_config.yml ファイル内のドライバエントリの例を以下に示します。

  - name: driver_symbol
    dir_name: driver_symbol
    module_path: com.dialect.jdbc.DialectDriver
    override_jdbc_url_subprotocol: driver_subprotocol  # optional

言語のドライバエントリを記述する場合:

ファイル custom_jdbc_config.yml は YAML ベースです。つまり、インデントとスペースは重要です。
name 属性と dir_name 属性は、JDBC ドライバの登録時に Looker が方言するドライバシンボルにする必要があります。
custom_jdbc_drivers から JDBC ドライバの JAR ファイルへの相対パスを含む dir_name の代わりに、属性 file_name を使用できます。dir_name が推奨されるのは、複数のドライバを独自のディレクトリに隔離して、Java クラスが競合する可能性を減らすためです。
module_path プロパティは、特定の JDBC ドライバによって異なります。Java ドライバクラスへの完全修飾パスを指定する必要があります。この例では一般的な値を使用していますが、ドライバが使用する特定の module_path を見つけるには、ドライバクラスの登録方法に関するドキュメントをご覧ください。
override_jdbc_url_subprotocol は、Looker がデータベースに送信する JDBC 文字列で使用されるサブプロトコルをオーバーライドするオプションの引数です。一般的な JDBC 文字列は次のようになります。

jdbc:mysql://localhost:3306/database_name[?propertyName1][=propertyValue1]

ここで、mysql は、使用されている JDBC サブプロトコルです。

override_jdbc_url_subprotocol: driver_subprotocol を指定すると、この JDBC 文字列は次のようになります。

jdbc:driver_subprotocol://localhost:3306/database_name[?propertyName1][=propertyValue1]

このオプションは、Looker のデフォルト URL サブプロトコル以外の URL サブプロトコルを必要とする、パッケージ化されていない JDBC ドライバを使用する必要がある場合に必要です。ほとんどの場合、この措置は、方言のドキュメントで明示的に必要とされない限り不要です。MongoBI は、このオプションが必要な言語の例です。