> ## 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.
> Guía paso a paso para crear tu primer ClickPipe de BigQuery.
# Crea tu primer ClickPipe de BigQuery
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
Puede inscribirse en la lista de espera de la vista previa privada [aquí](https://clickhouse.com/cloud/clickpipes/bigquery-connector).
El ClickPipe de BigQuery ofrece una forma totalmente gestionada y robusta de ingestar datos desde BigQuery en ClickHouse Cloud. En la vista previa privada, admite el método de replicación de **carga inicial** para ayudarle a cargar de forma masiva datasets de BigQuery para su exploración y creación de prototipos. **CDC** será compatible en el futuro; mientras tanto, recomendamos usar el [ClickPipe de Google Cloud Storage](/docs/es/integrations/clickpipes/object-storage/google-cloud-storage/overview) para sincronizar continuamente en ClickHouse Cloud las exportaciones de datos de BigQuery una vez completada la carga inicial.
Los ClickPipes de BigQuery pueden desplegarse y gestionarse manualmente desde la UI de ClickPipes, así como de forma programática mediante [OpenAPI](/docs/es/integrations/clickpipes/programmatic-access/openapi) y [Terraform](/docs/es/integrations/clickpipes/programmatic-access/terraform).
## Requisitos previos
* Debe tener privilegios para administrar [cuentas de servicio](https://docs.cloud.google.com/iam/docs/service-account-overview) y [roles de IAM](https://docs.cloud.google.com/iam/docs/roles-overview) en su proyecto de GCP, o contar con la ayuda de un administrador. Recomendamos crear una cuenta de servicio dedicada con el conjunto mínimo de [permisos](/docs/es/integrations/clickpipes/bigquery/overview#permissions) necesarios, siguiendo la [documentación oficial](https://docs.cloud.google.com/iam/docs/service-accounts-create).
* El proceso de carga inicial requiere un bucket de Google Cloud Storage (GCS) proporcionado por el usuario para el almacenamiento temporal. Recomendamos crear un bucket dedicado para su ClickPipe siguiendo la [documentación oficial](https://docs.cloud.google.com/storage/docs/creating-buckets). En el futuro, ClickPipes proporcionará y administrará el bucket intermedio.
**1.** En ClickHouse Cloud, selecciona **Data sources** en el menú principal de navegación y haz clic en **Create ClickPipe**.
**2.** Haz clic en el tile de **BigQuery**.
Para configurar un nuevo ClickPipe, debes indicar cómo conectarte y autenticarte con tu data warehouse de BigQuery, así como un bucket de Google Cloud Storage (GCS) de almacenamiento temporal.
**1.** Sube la key `.json` de la cuenta de servicio que creaste para ClickPipes. Asegúrate de que la cuenta de servicio tenga el conjunto mínimo de [permisos](/docs/es/integrations/clickpipes/bigquery/overview#permissions) requerido.
**2.** Selecciona el **método de replicación**. En Private Preview, la única opción compatible es [**solo carga inicial**](/docs/es/integrations/clickpipes/bigquery/overview#initial-load).
**3.** Indica la path al bucket de Google Cloud Storage (GCS) para almacenar temporalmente los datos durante la carga inicial.
**4.** Haz clic en **Next** para validar.
Según el tamaño de tu dataset de BigQuery o el tamaño total de las tablas que quieres sincronizar, puede que necesites ajustar la configuración predeterminada de ingestión del ClickPipe.
**1.** Selecciona la base de datos de ClickHouse en la que quieres replicar las tablas de BigQuery. Puedes seleccionar una base de datos existente o crear una nueva.
**2.** Selecciona las tablas y, opcionalmente, las columnas que quieres replicar. Solo aparecerán los datasets a los que tenga acceso la cuenta de servicio proporcionada.
**3.** Para cada tabla seleccionada, asegúrate de definir una clave de ordenación personalizada en **Advanced settings** > **Use a custom sorting key**. En el futuro, la clave de ordenación se inferirá automáticamente a partir de las claves de clustering o partición existentes en la base de datos de origen.
**Debes** definir una [clave de ordenación](/docs/es/concepts/best-practices/choosing-a-primary-key) para las tablas replicadas con el fin de optimizar el rendimiento de las consultas en ClickHouse. De lo contrario, la clave de ordenación se establecerá como `tuple()`, lo que significa que no se creará ningún índice primario y ClickHouse realizará escaneos completos de la tabla en todas las consultas sobre ella.
Por último, puedes configurar los permisos para el usuario interno de ClickPipes.
**Permisos:** ClickPipes creará un usuario dedicado para escribir datos en una tabla de destino. Puedes seleccionar un rol para este usuario interno mediante un rol personalizado o uno de los roles predefinidos:
* `Full access`: acceso completo al cluster. Es necesario si usas vistas materializadas o un diccionario con la tabla de destino.
* `Only destination`: permisos de inserción únicamente en la tabla de destino.
Haz clic en **Create ClickPipe** para completar la configuración. Se te redirigirá a la página de resumen, donde podrás ver el progreso de la carga inicial y acceder a los detalles de tus ClickPipes de BigQuery.