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

> Guía paso a paso para crear tu primer ClickPipe de Amazon S3.

# Crea tu primer ClickPipe de Amazon S3

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

export const props_0 = undefined

export const provider_0 = "s3"

El ClickPipe de S3 ofrece una forma totalmente gestionada y resiliente de ingestar datos de Amazon S3 y de almacenes de objetos compatibles con S3 en ClickHouse Cloud. Admite tanto la **ingestión única** como la **ingestión continua**, con semántica de exactamente una vez.

<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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step0.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=8604d9b9df8655f1edcdc73536e5def1" alt="Seleccionar importaciones" size="lg" border width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.png" />

    {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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=4376b8bfb59f04113f532eb0a420072c" alt="Definir el formato de los datos y el topic" size="lg" border width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" />
  </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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4a.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=b7af999c6e0a73c262f056e55751dba4" alt="Definir la tabla, el esquema y la configuración" size="lg" border width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4a3.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=62cb085edcb38779bf897cee66e60043" alt="Definir controles avanzados" size="lg" border width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.png" />

    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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step4b.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=5fcb518694a73232d0a0ea7a56a31b81" alt="Usar una tabla existente" size="lg" border width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.png" />

    <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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_step5.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=26bdb80d849f8e306831cc8b95559738" alt="Permisos" size="lg" border width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.png" />
  </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="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_success.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=d018023601453375093404901348444f" alt="Aviso de éxito" size="sm" border width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.png" />

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_remove.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=a076de091319cd10a2891b7653b59e99" alt="Aviso de eliminación" size="lg" border width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_destination.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=16249fc3debb01d3cfb83f78d10ec18d" alt="Ver destino" size="lg" border width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/lGskH5qUgz9Vtlav/images/integrations/data-ingestion/clickpipes/cp_overview.png?fit=max&auto=format&n=lGskH5qUgz9Vtlav&q=85&s=6d118b6e76a5320b0204eea68147b689" alt="Ver descripción general" size="lg" border width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.png" />

    **¡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>
