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

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

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

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

<Steps>
  <Step title="Выберите источник данных" id="1-select-the-data-source">
    **1.** В ClickHouse Cloud выберите **Источники данных** в главном меню навигации и нажмите **Create ClickPipe**.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=fb04bb07245be43cb784fa68cee62287" alt="Выбор импортируемых данных" width="2606" height="790" data-path="images/integrations/data-ingestion/clickpipes/cp_step0.webp" />
    </Frame>

    **2.** Нажмите на плитку **Google Cloud Storage**.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=b9e0d4154a6e96f7acb595c81f988c15" alt="Выберите импорты" width="3016" height="952" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp" />
    </Frame>
  </Step>

  <Step title="Настройте подключение ClickPipe" id="2-setup-your-clickpipe-connection">
    **1.** Чтобы настроить новый ClickPipe, необходимо указать данные для подключения и аутентификации в вашем сервисе объектного хранилища.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/dZZG_-B0EzCG8L4V/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp?fit=max&auto=format&n=dZZG_-B0EzCG8L4V&q=85&s=3da74887fe8ea9aa9c0c2b4ba67e8c7c" alt="Заполните сведения о подключении" width="3014" height="1428" data-path="images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp" />
    </Frame>

    * **Путь к файлу GCS**: GCS ClickPipe использует [XML API](https://docs.cloud.google.com/storage/docs/interoperability) Cloud Storage для обеспечения совместимости и требует использования конечной точки `storage.googleapis.com`:

      ```bash theme={null}
      https://storage.googleapis.com/bucket-name/key-name
      ```

      Вы можете использовать подстановочные шаблоны POSIX, чтобы указывать несколько файлов или префиксов. Поддерживаемые шаблоны описаны в [справочной документации](/docs/ru/integrations/clickpipes/object-storage/google-cloud-storage/overview#file-pattern-matching).

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

  <Step title="Выберите формат данных" id="3-select-data-format">
    В интерфейсе отобразится список файлов в указанном бакете.
    Выберите формат данных (в настоящее время мы поддерживаем только часть форматов ClickHouse) и укажите, нужно ли включить непрерывную ингестию.
    Подробнее см. в разделе "continuous ingest" на странице обзора.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e3c03fbaec5b6db3810a4380343c42b9" alt="Выберите формат данных и topic" width="2336" height="1566" data-path="images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp" />
    </Frame>
  </Step>

  <Step title="Настройте таблицу, схему и параметры" id="5-configure-table-schema-settings">
    На следующем шаге вы можете выбрать, выполнять ли приём данных в новую таблицу ClickHouse или использовать существующую.
    Следуйте инструкциям на экране, чтобы изменить имя таблицы, схему и параметры.
    В верхней части страницы доступен предварительный просмотр изменений в реальном времени в примере таблицы.

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=e0cdb9469f6867e897cc77541af7f59b" alt="Задайте таблицу, схему и параметры" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4a3.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=db7cb839e136d26563b239937f029c7a" alt="Задайте дополнительные параметры" width="1592" height="338" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a3.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step4b.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=a5cb66aa9b3855c5d53b340dbd89b108" alt="Использовать существующую таблицу" width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.webp" />
    </Frame>

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

  <Step title="Настройте разрешения" id="6-configure-permissions">
    Наконец, вы можете настроить разрешения для внутреннего пользователя ClickPipes.

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

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_step5.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=71ea5baaa2c38fcc83b160f4856264ab" alt="Разрешения" width="2736" height="1318" data-path="images/integrations/data-ingestion/clickpipes/cp_step5.webp" />
    </Frame>
  </Step>

  <Step title="Завершите настройку" id="7-complete-setup">
    После нажатия "Complete Setup" система зарегистрирует ваш ClickPipe, и вы увидите его в сводной таблице.

    <div className="ch-image-sm">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_success.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=ce045b4a85e7f294d23c03897e9ce11f" alt="Уведомление об успешном выполнении" width="613" height="212" data-path="images/integrations/data-ingestion/clickpipes/cp_success.webp" />
      </Frame>
    </div>

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_remove.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=83b452ee5d8017da1b1c0d50cf8a491d" alt="Уведомление об удалении" width="2756" height="1320" data-path="images/integrations/data-ingestion/clickpipes/cp_remove.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_destination.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=cb3ebed0c324cb30c6cbf35726b3bec7" alt="Просмотр целевой таблицы" width="2758" height="1316" data-path="images/integrations/data-ingestion/clickpipes/cp_destination.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99/Rm4A9_kDxZf0ApeE/images/integrations/data-ingestion/clickpipes/cp_overview.webp?fit=max&auto=format&n=Rm4A9_kDxZf0ApeE&q=85&s=1ce91f5079842cfc66a4c88919f2e061" alt="Просмотр обзора" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.webp" />
    </Frame>

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