> ## 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. > 分步指导您创建首个 BigQuery ClickPipe。 # 创建您的首个 BigQuery ClickPipe export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return

; }; export const PrivatePreviewBadge = () => { return

{'ClickHouse Cloud 私有预览'}

; }; 你可以在[这里](https://clickhouse.com/cloud/clickpipes/bigquery-connector)加入私有预览候补名单。 BigQuery ClickPipe 提供了一种完全托管且具备高弹性的方式，可将 BigQuery 中的数据摄取到 ClickHouse Cloud。在私有预览阶段，它支持 **initial load** 复制方法，帮助你批量加载 BigQuery 数据集，以便进行探索和原型验证。未来将支持 **CDC (变更数据捕获) **；在此之前，我们建议你在 initial load 完成后，使用 [Google Cloud Storage ClickPipe](/docs/zh/integrations/clickpipes/object-storage/google-cloud-storage/overview) 持续将 BigQuery 导出的数据同步到 ClickHouse Cloud。 BigQuery ClickPipes 既可通过 ClickPipes UI 手动部署和管理，也可通过 [OpenAPI](/docs/zh/integrations/clickpipes/programmatic-access/openapi) 和 [Terraform](/docs/zh/integrations/clickpipes/programmatic-access/terraform) 以编程方式进行部署和管理。

## 前提条件

* 您必须具备在 GCP 项目中管理[服务账号](https://docs.cloud.google.com/iam/docs/service-account-overview)和 [IAM roles](https://docs.cloud.google.com/iam/docs/roles-overview) 的权限，或者获得管理员协助。我们建议按照[官方文档](https://docs.cloud.google.com/iam/docs/service-accounts-create)创建一个专用服务账号，并仅授予所需的最小[权限](/docs/zh/integrations/clickpipes/bigquery/overview#permissions)。 * 初始加载过程需要用户提供一个 Google Cloud Storage (GCS) 存储桶用于暂存。我们建议按照[官方文档](https://docs.cloud.google.com/storage/docs/creating-buckets)为您的 ClickPipe 创建一个专用存储桶。未来，该中间存储桶将由 ClickPipes 提供并管理。 **1.** 在 ClickHouse Cloud 中，从主导航菜单选择 **Data sources** 并点击 **Create ClickPipe**。选择导入

**2.** 点击 **BigQuery** 磁贴。选择 BigQuery 磁贴

要设置新的 ClickPipe，你必须提供如何连接和验证你的 BigQuery 数据仓库的详细信息，以及一个用于暂存的 GCS 存储桶。 **1.** 上传为 ClickPipes 创建的服务账号的 `.json` 密钥。确保该服务账号具有最小所需的 [权限](/docs/zh/integrations/clickpipes/bigquery/overview#permissions)。上传服务账号密钥

**2.** 选择 **Replication method**。在 Private Preview 中，当前唯一支持的选项是 [**仅初始加载**](/docs/zh/integrations/clickpipes/bigquery/overview#initial-load)。 **3.** 提供用于初始加载期间暂存数据的 GCS 存储桶路径。 **4.** 点击 **Next** 以进行验证。根据你的 BigQuery 数据集的大小，或你想要同步的表的总大小，你可能需要调整 ClickPipe 的默认摄取设置。 **1.** 选择要将 BigQuery 表复制到的 ClickHouse 数据库。你可以选择现有数据库或创建新的数据库。 **2.** 选择要复制的表以及 (可选) 要复制的列。只有提供的服务账号有权访问的数据集才会被列出。

**3.** 对于每个选定的表，请务必在 **Advanced settings** > **Use a custom sorting key** 下定义自定义排序键。将来，排序键会根据上游数据库中现有的聚类或分区键自动推断。你**必须**为被复制的表定义 [排序键](/docs/zh/concepts/best-practices/choosing-a-primary-key)，以优化 ClickHouse 中的查询性能。否则，排序键将被设置为 `tuple()`，这意味着不会创建主索引，ClickHouse 将对该表上的所有查询执行全表扫描。

最后，你可以为内部 ClickPipes 用户配置权限。 **Permissions:** ClickPipes 将创建一个专用用户用于将数据写入目标表。你可以为该内部用户选择自定义角色或以下预定义角色之一： * `Full access`: 对集群具有完全访问权限。如果你在目标表上使用 materialized views 或 dictionary，则需要此权限。 * `Only destination`: 仅对目标表具有插入权限。点击 **Create ClickPipe** 完成设置。你将被重定向到概览页面，在那里可以查看初始加载的进度并点击查看你的 BigQuery ClickPipes 的详细信息。