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

> Пошаговое руководство по созданию вашего первого ClickPipe для Google Cloud Storage.

# Создание первого GCS ClickPipe

export const props_0 = undefined

export const provider_0 = "gcs"

GCS ClickPipe предоставляет полностью управляемый и отказоустойчивый способ приёма данных из Google Cloud Storage (GCS). Он поддерживает как **однократную** загрузку, так и **непрерывную ингестию** с семантикой «ровно один раз».

<Steps>
  <Step>
    ## Выберите источник данных

    **1.** В ClickHouse Cloud выберите **Data sources** в главном навигационном меню и нажмите **Create ClickPipe**.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step0.png" alt="Выбор импорта" size="lg" border />

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

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

  <Step>
    ## Настройте подключение ClickPipe

    **1.** Чтобы настроить новый ClickPipe, необходимо указать параметры подключения и аутентификации для вашего сервиса Объектного хранилища.

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

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

    **2.** Нажмите **Incoming data**. ClickPipes получит метаданные из вашего бакета для следующего шага.
  </Step>

  <Step>
    ## Выберите формат данных

    В интерфейсе отобразится список файлов в указанном бакете.
    Выберите формат данных (сейчас поддерживается только часть форматов ClickHouse), а также укажите, нужно ли включить непрерывный приём.
    Подробнее см. в разделе "continuous ingest" на странице обзора.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.png" alt="Задать формат данных и topic" size="lg" border />
  </Step>

  <Step>
    ## Настройте таблицу, схему и параметры

    На следующем шаге вы можете выбрать, выполнять ли приём данных в новую таблицу ClickHouse или использовать существующую.
    Следуйте инструкциям на экране, чтобы изменить имя таблицы, схему и параметры.
    Предварительный просмотр изменений в реальном времени отображается в sample-таблице в верхней части экрана.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4a.png" alt="Задать таблицу, схему и параметры" size="lg" border />

    Вы также можете настроить дополнительные параметры с помощью доступных элементов управления

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4a3.png" alt="Задать расширенные элементы управления" size="lg" border />

    Кроме того, вы можете выбрать приём данных в существующую таблицу ClickHouse.
    В этом случае интерфейс позволит сопоставить поля из источника с полями ClickHouse в выбранной целевой таблице.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step4b.png" alt="Использовать существующую таблицу" size="lg" border />

    <Info>
      Вы также можете сопоставлять [virtual columns](/ru/reference/functions/table-functions/s3#virtual-columns), такие как `_path` или `_size`, с полями.
    </Info>
  </Step>

  <Step>
    ## Настройте разрешения

    Наконец, вы можете настроить разрешения для внутреннего пользователя ClickPipes.

    **Разрешения:** ClickPipes создаст отдельного пользователя для записи данных в целевую таблицу. Для этого внутреннего пользователя можно выбрать пользовательскую роль или одну из предопределённых ролей:

    * `Full access`: полный доступ к кластеру. Требуется, если вы используете materialized view или словарь с целевой таблицей.
    * `Only destination table`: только разрешения `INSERT` для целевой таблицы.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_step5.png" alt="Разрешения" size="lg" border />
  </Step>

  <Step>
    ## Завершите настройку

    Нажав "Complete Setup", вы зарегистрируете ClickPipe, и он появится в сводной таблице.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_success.png" alt="Уведомление об успешном завершении" size="sm" border />

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_remove.png" alt="Уведомление об удалении" size="lg" border />

    В сводной таблице доступны элементы управления для просмотра sample-данных из исходной или целевой таблицы в ClickHouse

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_destination.png" alt="Просмотр пункта назначения" size="lg" border />

    А также элементы управления для удаления ClickPipe и просмотра сводки по задаче приёма.

    <Image img="/images/integrations/data-ingestion/clickpipes/cp_overview.png" alt="Просмотр обзора" size="lg" border />

    **Поздравляем!** Вы успешно настроили свой первый ClickPipe.
    Если этот ClickPipe настроен для непрерывного приёма, он будет работать постоянно и выполнять приём данных в реальном времени из удалённого источника данных.
    В противном случае он обработает батч и завершит работу.
  </Step>
</Steps>