.default})
これは、外部データソースに対してネイティブに組み込まれた[統合エンジン](/docs/ja/engines/table-engines/index.md#integration-engines-integration-engines)、テーブル関数、または外部ディクショナリが利用できない場合に便利ですが、データソースのJDBCドライバーが存在します。
ClickHouse JDBC Bridgeを使用すると、複数の外部データソースに対して並行してリアルタイムでClickHouse上で分散クエリを実行することができます。
このレッスンでは、ClickHouseを外部データソースに接続するためにClickHouse JDBC Bridgeをインストール、設定、および実行する方法を示します。このレッスンでは、外部データソースとしてMySQLを使用します。
さあ、始めましょう！
:::note 前提条件
あなたのマシンには以下が必要です:
1. Unixシェルとインターネットアクセス
2. wgetがインストールされている
3. **Java**の最新バージョン（例：OpenJDK バージョン >= 17）がインストールされている
4. **MySQL**の最新バージョン（例：MySQL バージョン >=8）がインストールされて動作している
5. **ClickHouse**が[インストール](/docs/ja/getting-started/install.md)されて動作している
:::
## ClickHouse JDBC Bridgeをローカルにインストールする
最も簡単なClickHouse JDBC Bridgeの使用方法は、ClickHouseが動作しているのと同じホストにインストールして実行することです:.default})
ClickHouseが動作しているマシンのUnixシェルに接続し、ClickHouse JDBC Bridgeをインストールするためのローカルフォルダを作成しましょう。そのフォルダの名前や場所はお好みで決めてください:
```bash
mkdir ~/clickhouse-jdbc-bridge
```
次に、最新版のClickHouse JDBC Bridgeをそのフォルダにダウンロードします:
```bash
cd ~/clickhouse-jdbc-bridge
wget https://github.com/ClickHouse/clickhouse-jdbc-bridge/releases/download/v2.0.7/clickhouse-jdbc-bridge-2.0.7-shaded.jar
```
MySQLに接続できるように、名前付きデータソースを作成します:
```bash
cd ~/clickhouse-jdbc-bridge
mkdir -p config/datasources
touch config/datasources/mysql8.json
```
次に、以下の構成をファイル `~/clickhouse-jdbc-bridge/config/datasources/mysql8.json` にコピー＆ペーストできます:
```json
{
"mysql8": {
"driverUrls": [
"https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.28/mysql-connector-java-8.0.28.jar"
],
"jdbcUrl": "jdbc:mysql://これでClickHouse JDBC Bridgeを開始する準備が整いました: ```bash cd ~/clickhouse-jdbc-bridge java -jar clickhouse-jdbc-bridge-2.0.7-shaded.jar ``` :::note ClickHouse JDBC Bridgeをフォアグラウンドモードで開始しました。ブリッジを停止するには、上記のUnixシェルウィンドウをフォアグラウンドにして`CTRL+C`を押すことができます。 ::: ## ClickHouseからJDBC接続を使用する ClickHouseは、[jdbc テーブル関数](/docs/ja/sql-reference/table-functions/jdbc.md)または[JDBC テーブルエンジン](/docs/ja/engines/table-engines/integrations/jdbc.md)を使用してMySQLデータにアクセスできます。 以下の例を実行する最も簡単な方法は、例をコピーして[`clickhouse-client`](/docs/ja/interfaces/cli.md)または[Play UI](/docs/ja/interfaces/http.md)に貼り付けることです。 - jdbc テーブル関数: ```sql SELECT * FROM jdbc('mysql8', 'mydatabase', 'mytable'); ``` :::note jdbc テーブル関数の最初のパラメーターとして、上記で設定した名前付きデータソースの名前を使用しています。 ::: - JDBC テーブルエンジン: ```sql CREATE TABLE mytable (
.default})
この方法の利点は、各ClickHouseホストがJDBC Bridgeにアクセスできることです。そうでない場合は、外部データソースにアクセスするためのBridgeが必要な各ClickHouseインスタンスごとにローカルにJDBC Bridgeをインストールする必要があります。
ClickHouse JDBC Bridgeを外部にインストールするためには、以下の手順を実行します:
1. このガイドのセクション1で説明されている手順に従って、専用のホストにClickHouse JDBC Bridgeをインストール、設定、および実行します。
2. 各ClickHouseホストで、ClickHouseサーバー設定に次の設定ブロックを追加します（選択した設定形式に応じて、XMLまたはYAMLバージョンを使用してください）: