> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step0.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=e9541eb0c881173eacc746f45524d8d4" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step1.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=b39d032591530a75aa1908d8c8f6fd26" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/object-storage/google-cloud-storage/cp_step2.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=d24ca13dc7da536763562895fd2b32d8" 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, чтобы указывать несколько файлов или префиксов. Поддерживаемые шаблоны описаны в [справочной документации](/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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step3_object_storage.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=a84e426c9e173c435890ac98a842551f" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step4a.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=24a3288470ed1e16962d0b66ac75a585" alt="Задайте таблицу, схему и параметры" width="2734" height="1328" data-path="images/integrations/data-ingestion/clickpipes/cp_step4a.webp" />
    </Frame>

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

    <Frame>
      <img src="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step4a3.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=178f11473c45ddcd9a1f7d28b8bb5fa3" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step4b.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=b1746ce2f9257230cd188f910e4b1979" alt="Использовать существующую таблицу" width="2738" height="1322" data-path="images/integrations/data-ingestion/clickpipes/cp_step4b.webp" />
    </Frame>

    <Info>
      Вы также можете сопоставлять [виртуальные столбцы](/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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_step5.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=9a75402c40da36a6a5c2936ca83f2523" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_success.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=3ee0e38a0f6c1e04971d5b80f01e0fd5" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_remove.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=08cf3ed6761f9606f741a6cb7d209e46" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_destination.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=f8b015bcd2ef5293053a6f4cf161c848" 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-postgresql-tls-support/w-Unfx0B83cK7_6Z/images/integrations/data-ingestion/clickpipes/cp_overview.webp?fit=max&auto=format&n=w-Unfx0B83cK7_6Z&q=85&s=e39f05bbffb64f3c6959363afb9451c9" alt="Просмотр обзора" width="3436" height="1076" data-path="images/integrations/data-ingestion/clickpipes/cp_overview.webp" />
    </Frame>

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