> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse와 MySQL 통합

> MySQL 통합 설명 페이지

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            Experimental feature. <u><a href="/docs/beta-and-experimental-features#experimental-features">Learn more.</a></u>
        </div>;
};

export const CloudNotSupportedBadge = () => {
  return <div className="cloudNotSupportedBadge">
            <div className="cloudNotSupportedIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.5" d="M6.33366 12.6666L12.3739 12.6667C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00003 12.3739 8.00003C12.3739 8.00003 12.3337 7.66659 12.0003 7.33325M10.667 5.33322C8.00033 2.33325 4.45395 4.78537 4.14195 6.68203C2.55728 6.7627 1.29395 8.06203 1.29395 9.6667C1.29395 11.3234 2.66699 12.6666 4.00033 12.6666" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.5" d="M2.66699 14L12.0003 4.66663" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>

        </div>
            Not supported in ClickHouse Cloud
        </div>;
};

이 페이지에서는 MySQL 테이블에서 데이터를 읽기 위해 `MySQL` 테이블 엔진을 사용하는 방법을 설명합니다.

<Note>
  ClickHouse Cloud의 경우 [MySQL ClickPipe](/ko/integrations/clickpipes/mysql)를 사용해 MySQL 테이블의 데이터를 ClickHouse로 손쉽게 옮길 수도 있습니다(현재 공개 베타).
</Note>

<div id="connecting-clickhouse-to-mysql-using-the-mysql-table-engine">
  ## MySQL 테이블 엔진을 사용해 ClickHouse를 MySQL에 연결하기
</div>

`MySQL` 테이블 엔진을 사용하면 ClickHouse를 MySQL에 연결할 수 있습니다. **SELECT** 및 **INSERT** SQL 문은 ClickHouse와 MySQL 테이블 양쪽에서 실행할 수 있습니다. 이 문서에서는 `MySQL` 테이블 엔진의 기본 사용 방법을 설명합니다.

<div id="1-configure-mysql">
  ### 1. MySQL 설정
</div>

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](/ko/products/cloud/guides/sql-console/query-endpoints)에서 확인하세요.
</Note>

<div id="2-define-a-table-in-clickhouse">
  ### 2. ClickHouse에서 테이블 정의하기
</div>

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!')
```

최소 매개변수는 다음과 같습니다:

| 매개변수     | 설명              | 예시                    |
| -------- | --------------- | --------------------- |
| host     | 호스트명 또는 IP      | mysql-host.domain.com |
| database | MySQL 데이터베이스 이름 | db1                   |
| table    | MySQL 테이블 이름    | table1                |
| user     | MySQL에 연결할 사용자명 | mysql\_clickhouse     |
| password | MySQL에 연결할 비밀번호 | Password123!          |

<Note>
  전체 매개변수 목록은 [MySQL 테이블 엔진](/ko/reference/engines/table-engines/integrations/mysql) 문서 페이지를 참조하십시오.
</Note>

<div id="3-test-the-integration">
  ### 3. 통합 테스트
</div>

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)
```

<div id="summary">
  ### 요약
</div>

`MySQL` 테이블 엔진을 사용하면 ClickHouse를 MySQL에 연결해 데이터를 양방향으로 주고받을 수 있습니다. 자세한 내용은 [MySQL 테이블 엔진](/ko/reference/functions/table-functions/mysql) 문서를 확인하십시오.
