> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MySQLとClickHouseのインテグレーション

> MySQLインテグレーションの説明ページ

このページでは、MySQL テーブルからデータを読み取るための `MySQL` テーブルエンジンの使用方法について説明します。

> [!NOTE]
>
> ClickHouse Cloud では、[MySQL ClickPipe](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/index.md) を使用して、MySQL テーブルから ClickHouse に簡単にデータを移行することもできます。

## MySQL テーブルエンジン を使用して ClickHouse を MySQL に接続する

`MySQL` テーブルエンジンを使用すると、ClickHouse を MySQL に接続できます。**SELECT** ステートメントと **INSERT** ステートメントは、ClickHouse と MySQL テーブルのどちらに対しても実行できます。この記事では、`MySQL` テーブルエンジンの基本的な使い方を説明します。

**1. MySQL を設定する**

1. MySQL でデータベースを作成します:

```sql theme={null}
CREATE DATABASE db1;
```

2. テーブルを作成します:

```sql theme={null}
CREATE TABLE db1.table1 (
  id INT,
  column1 VARCHAR(255)
);
```

3. サンプルの行を挿入します:

```sql theme={null}
INSERT INTO db1.table1
  (id, column1)
VALUES
  (1, 'abc'),
  (2, 'def'),
  (3, 'ghi');
```

4. ClickHouse から接続するためのユーザーを作成します:

```sql theme={null}
CREATE USER 'mysql_clickhouse'@'%' IDENTIFIED BY 'Password123!';
```

5. 必要に応じて権限を付与します。 (デモ用として、`mysql_clickhouse` ユーザーには管理者権限を付与しています。)

```sql theme={null}
GRANT ALL PRIVILEGES ON *.* TO 'mysql_clickhouse'@'%';
```

> [!NOTE]
>
> この機能を ClickHouse Cloud で使用する場合は、ClickHouse Cloud の IP アドレスから MySQL インスタンスにアクセスできるよう許可する必要がある場合があります。
> エグレストラフィックの詳細については、ClickHouse の [Cloud Endpoints API](https://clickhouse.com/docs/ja/products/cloud/guides/sql-console/query-endpoints.md) を確認してください。

**2. ClickHouse にテーブルを定義する**

1. それでは、`MySQL` テーブルエンジンを使用する ClickHouse テーブルを作成しましょう:

```sql theme={null}
CREATE TABLE mysql_table1 (
  id UInt64,
  column1 String
)
ENGINE = MySQL('mysql-host.domain.com','db1','table1','mysql_clickhouse','Password123!')
```

最小限必要なパラメータは次のとおりです:

| parameter | Description | example |
| - | - | - |
| host | ホスト名または IP | mysql-host.domain.com |
| database | MySQL データベース名 | db1 |
| table | MySQL テーブル名 | table1 |
| user | MySQL に接続するユーザー名 | mysql\_clickhouse |
| password | MySQL に接続するパスワード | Password123! |

> [!NOTE]
>
> 完全なパラメータ一覧については、[MySQL テーブルエンジン](https://clickhouse.com/docs/ja/reference/engines/table-engines/integrations/mysql.md) のドキュメントページを参照してください。

**3. インテグレーションをテストする**

1. MySQL でサンプルの行を挿入します:

```sql theme={null}
INSERT INTO db1.table1
  (id, column1)
VALUES
  (4, 'jkl');
```

2. MySQLテーブルの既存の行に、先ほど追加した新しい行も含めて、ClickHouseテーブルに入っていることを確認します。

```sql theme={null}
SELECT
    id,
    column1
FROM mysql_table1
```

4 行表示されるはずです。

```response theme={null}
Query id: 6d590083-841e-4e95-8715-ef37d3e95197

┌─id─┬─column1─┐
│  1 │ abc     │
│  2 │ def     │
│  3 │ ghi     │
│  4 │ jkl     │
└────┴─────────┘

4 rows in set. Elapsed: 0.044 sec.
```

3. ClickHouseのテーブルに行を追加しましょう:

```sql theme={null}
INSERT INTO mysql_table1
  (id, column1)
VALUES
  (5,'mno')
```

4. MySQL に新しい行が表示されていることを確認します:

```bash theme={null}
mysql> select id,column1 from db1.table1;
```

新しい行が表示されます：

```response theme={null}
+------+---------+
| id   | column1 |
+------+---------+
|    1 | abc     |
|    2 | def     |
|    3 | ghi     |
|    4 | jkl     |
|    5 | mno     |
+------+---------+
5 rows in set (0.01 sec)
```

### 概要

`MySQL` テーブルエンジンを使用すると、ClickHouse を MySQL に接続し、データを双方向にやり取りできます。詳細については、[MySQL テーブルエンジン](https://clickhouse.com/docs/ja/reference/functions/table-functions/mysql.md) のドキュメントページを参照してください。
