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

> Guia passo a passo para criar seu primeiro ClickPipe do Google Cloud Storage.

# Criando seu primeiro ClickPipe do GCS

export const props_0 = undefined

export const provider_0 = "gcs"

O ClickPipe do GCS oferece uma forma totalmente gerenciada e resiliente de realizar a ingestão de dados do Google Cloud Storage (GCS). Ele oferece suporte tanto à **ingestão única** quanto à **ingestão contínua**, com semântica exactly-once.

<Steps>
  <Step>
    ## Selecione a fonte de dados

    **1.** No ClickHouse Cloud, selecione **Data sources** no menu principal de navegação e clique em **Create ClickPipe**.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step0.png" alt="Selecionar importações" size="lg" border />

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

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

  <Step>
    ## Configure a conexão do ClickPipe

    **1.** Para configurar um novo ClickPipe, você deve informar como se conectar ao seu serviço de armazenamento de objetos e se autenticar nele.

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

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

    **2.** Clique em **Incoming data**. O ClickPipes buscará os metadados do seu bucket para a próxima etapa.
  </Step>

  <Step>
    ## Selecione o formato dos dados

    A UI exibirá uma lista de arquivos no bucket especificado.
    Selecione o formato dos dados (no momento, oferecemos suporte a um subconjunto dos formatos do ClickHouse) e se deseja habilitar a ingestão contínua.
    Consulte a seção "continuous ingest" na página de visão geral para mais detalhes.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" alt="Definir formato dos dados e tópico" size="lg" border />
  </Step>

  <Step>
    ## Configure a tabela, o esquema e as configurações

    Na próxima etapa, você poderá escolher se deseja fazer a ingestão dos dados em uma nova tabela do ClickHouse ou reutilizar uma existente.
    Siga as instruções na tela para alterar o nome da tabela, o esquema e as configurações.
    Você pode ver uma prévia em tempo real das alterações na tabela de amostra na parte superior.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4a.png" alt="Definir tabela, esquema e configurações" size="lg" border />

    Você também pode personalizar as configurações avançadas usando os controles fornecidos

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

    Como alternativa, você pode optar por fazer a ingestão dos dados em uma tabela existente do ClickHouse.
    Nesse caso, a UI permitirá mapear campos da origem para os campos do ClickHouse na tabela de destino selecionada.

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

    <Info>
      Você também pode mapear [colunas virtuais](/pt-BR/reference/functions/table-functions/s3#virtual-columns), como `_path` ou `_size`, para campos.
    </Info>
  </Step>

  <Step>
    ## Configure as permissões

    Por fim, você pode configurar as permissões para o usuário interno do ClickPipes.

    **Permissões:** O ClickPipes criará um usuário dedicado para gravar dados em uma tabela de destino. Você pode selecionar uma função para esse usuário interno usando uma função personalizada ou uma das funções predefinidas:

    * `Full access`: com acesso total ao cluster. Obrigatório se você usar visão materializada ou Dicionário com a tabela de destino.
    * `Only destination table`: com permissões `INSERT` apenas na tabela de destino.

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

  <Step>
    ## Conclua a configuração

    Ao clicar em "Complete Setup", o sistema registrará seu ClickPipe, e você poderá vê-lo listado na tabela de resumo.

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

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_remove.png" alt="Aviso de remoção" size="lg" border />

    A tabela de resumo fornece controles para exibir dados de amostra da origem ou da tabela de destino no ClickHouse

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

    Assim como controles para remover o ClickPipe e exibir um resumo do job de ingestão.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_overview.png" alt="Ver visão geral" size="lg" border />

    **Parabéns!** Você configurou com sucesso seu primeiro ClickPipe.
    Se este for um ClickPipe configurado para ingestão contínua, ele será executado continuamente, fazendo a ingestão de dados em tempo real da sua fonte de dados remota.
    Caso contrário, ele fará a ingestão do batch e será concluído.
  </Step>
</Steps>