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

> 将 Cloud SQL for MySQL 设置为 ClickPipes source 的分步指南

# Cloud SQL for MySQL source 设置指南

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

这是一份分步指南，介绍如何配置您的 Cloud SQL for MySQL 实例，以便通过 MySQL ClickPipe 复制其中的数据。

<div id="enable-binlog-retention-gcp">
  ## 启用二进制日志保留
</div>

二进制日志是一组日志文件，用于记录对 MySQL 服务器实例所做的数据更改；而二进制日志文件是进行复制所必需的。

<div id="enable-binlog-logging-gcp">
  ### 通过 PITR 启用二进制日志
</div>

PITR 功能决定 Google Cloud 中 MySQL 是否启用二进制日志。你可以在 Cloud 控制台中进行设置：编辑你的 Cloud SQL 实例，然后向下滚动到以下部分。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=3ff38799aaa57ca03541bb3951675624" alt="在 Cloud SQL 中启用 PITR" size="lg" border width="1622" height="1800" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-pitr.png" />

建议根据复制使用场景，将该值设置为一个足够长且合理的值。

如果尚未配置，请编辑 Cloud SQL，并确保在数据库标志部分设置以下内容：

1. 将 `binlog_expire_logs_seconds` 设为 >= `86400` (1 天) 的值。
2. 将 `binlog_row_metadata` 设为 `FULL`
3. 将 `binlog_row_image` 设为 `FULL`

为此，请点击实例概览页面右上角的 `Edit` 按钮。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-edit-button.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=975410975dd8948188c3399078c194ae" alt="GCP MySQL 中的 Edit 按钮" size="lg" border width="2174" height="570" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-edit-button.png" />

然后向下滚动到 `Flags` 部分，并添加上述标志。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-flags.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=037387c0ed00250ed9e1438d5b593191" alt="在 GCP 中设置 binlog 标志" size="lg" border width="1174" height="1810" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-flags.png" />

<div id="configure-database-user-gcp">
  ## 配置数据库用户
</div>

以 root 用户身份连接到您的 Cloud SQL MySQL 实例，并执行以下命令：

1. 为 ClickPipes 创建一个专用用户：

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
   ```

2. 授予 schema 权限。以下示例展示了 `clickpipes` database 的权限。对于您要复制的每个 database 和主机，请重复执行这些命令：

   ```sql theme={null}
   GRANT SELECT ON `clickpipes`.* TO 'clickpipes_user'@'host';
   ```

3. 向该用户授予复制权限：

   ```sql theme={null}
   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   ```

<div id="configure-network-access-gcp-mysql">
  ## 配置网络访问
</div>

如果你想限制对 Cloud SQL 实例的访问流量，请将[文档中列出的静态 NAT IP 地址](/zh/integrations/clickpipes/home#list-of-static-ips)添加到 Cloud SQL MySQL 实例的 IP 允许列表中。
你可以通过编辑该实例来完成此操作，也可以前往 Cloud 控制台侧边栏中的 `Connections` 选项卡。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-ip.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=e1cbbd3b7989c19de040f797429d2d50" alt="GCP MySQL 中的 IP 允许列表" size="lg" border width="1110" height="1598" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-ip.png" />

<div id="download-root-ca-certificate-gcp-mysql">
  ## 下载并使用根 CA 证书
</div>

要连接到您的 Cloud SQL 实例，您需要下载根 CA 证书。

1. 在 Cloud 控制台中打开您的 Cloud SQL 实例。
2. 在侧边栏中点击 `Connections`。
3. 点击 `Security` 选项卡。
4. 在 `Manage server CA certificates` 部分，点击底部的 `DOWNLOAD CERTIFICATES` 按钮。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-cert.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=2a974f67658678ccf70dcd061b211b96" alt="下载 GCP MySQL 证书" size="lg" border width="1584" height="1098" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/gcp-mysql-cert.png" />

5. 在 ClickPipes UI 中创建新的 MySQL ClickPipe 时，上传已下载的证书。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/2Zeerd64Tl5ZAQUa/images/integrations/data-ingestion/clickpipes/mysql/source/gcp/rootca.png?fit=max&auto=format&n=2Zeerd64Tl5ZAQUa&q=85&s=b35ec2089934eba61bec2bdde0c02ee0" alt="使用 GCP MySQL 证书" size="lg" border width="1636" height="1170" data-path="images/integrations/data-ingestion/clickpipes/mysql/source/gcp/rootca.png" />
