> ## 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.

> Guía paso a paso para crear tu primer ClickPipe de Google Cloud Storage.

# Crear tu primer ClickPipe de GCS

export const props_0 = undefined

export const provider_0 = "gcs"

ClickPipe de GCS ofrece una forma totalmente gestionada y resiliente de ingestar datos desde Google Cloud Storage (GCS). Admite tanto la **ingestión de una sola vez** como la **ingestión continua**, con semántica exactly-once.

<Steps>
  <Step>
    ## Seleccione el origen de datos

    **1.** En ClickHouse Cloud, seleccione **Data sources** en el menú principal de navegación y haga clic en **Create ClickPipe**.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step0.png" alt="Seleccionar importaciones" size="lg" border />

    {props_0.provider_0 === 's3' && <S3DataSource />}

    {props_0.provider_0 === 'gcs' && <GCSSDataSource />}
  </Step>

  <Step>
    ## Configure la conexión de su ClickPipe

    **1.** Para configurar un nuevo ClickPipe, debe indicar cómo conectarse a su servicio de almacenamiento de objetos y autenticarse en él.

    {props_0.provider_0 === 's3' && <S3Connection />}

    {props_0.provider_0 === 'gcs' && <GCSConnection />}

    **2.** Haga clic en **Incoming data**. ClickPipes obtendrá los metadatos de su bucket para el siguiente paso.
  </Step>

  <Step>
    ## Seleccione el formato de los datos

    La UI mostrará una lista de archivos en el bucket especificado.
    Seleccione el formato de los datos (actualmente admitimos un subconjunto de los formatos de ClickHouse) y si desea habilitar la ingestión continua.
    Consulte la sección "continuous ingest" en la página de descripción general para obtener más información.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" alt="Definir el formato de los datos y el topic" size="lg" border />
  </Step>

  <Step>
    ## Configure la tabla, el esquema y la configuración

    En el siguiente paso, puede elegir si desea ingestar datos en una tabla nueva de ClickHouse o reutilizar una existente.
    Siga las instrucciones que aparecen en pantalla para modificar el nombre de la tabla, el esquema y la configuración.
    Puede ver una vista previa en tiempo real de sus cambios en la tabla de muestra de la parte superior.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4a.png" alt="Definir la tabla, el esquema y la configuración" size="lg" border />

    También puede personalizar la configuración avanzada con los controles proporcionados

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4a3.png" alt="Definir controles avanzados" size="lg" border />

    Como alternativa, puede optar por ingestar los datos en una tabla existente de ClickHouse.
    En ese caso, la UI le permitirá asignar campos del origen a los campos de ClickHouse en la tabla de destino seleccionada.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4b.png" alt="Usar una tabla existente" size="lg" border />

    <Info>
      También puede asignar [columnas virtuales](/es/reference/functions/table-functions/s3#virtual-columns), como `_path` o `_size`, a campos.
    </Info>
  </Step>

  <Step>
    ## Configure los permisos

    Por último, puede configurar los permisos para el usuario interno de ClickPipes.

    **Permisos:** ClickPipes creará un usuario dedicado para escribir datos en una tabla de destino. Puede seleccionar un rol para este usuario interno usando un rol personalizado o uno de los roles predefinidos:

    * `Full access`: con acceso completo al clúster. Es obligatorio si usa una vista materializada o un Diccionario con la tabla de destino.
    * `Only destination table`: solo con permisos `INSERT` sobre la tabla de destino.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step5.png" alt="Permisos" size="lg" border />
  </Step>

  <Step>
    ## Complete la configuración

    Al hacer clic en "Complete Setup", el sistema registrará su ClickPipe y podrá verlo en la tabla de resumen.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_success.png" alt="Aviso de éxito" size="sm" border />

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_remove.png" alt="Aviso de eliminación" size="lg" border />

    La tabla de resumen ofrece controles para mostrar datos de muestra del origen o de la tabla de destino en ClickHouse

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_destination.png" alt="Ver destino" size="lg" border />

    Así como controles para eliminar el ClickPipe y mostrar un resumen del job de ingestión.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_overview.png" alt="Ver descripción general" size="lg" border />

    **¡Enhorabuena!** Ha configurado correctamente su primer ClickPipe.
    Si este es un ClickPipe configurado para ingestión continua, se ejecutará de forma continua e ingestará datos en tiempo real desde su origen de datos remoto.
    De lo contrario, ingestará el lote y finalizará.
  </Step>
</Steps>