> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.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). Он поддерживает как **однократную** загрузку, так и **непрерывную ингестию** с семантикой «ровно один раз». **1.** В ClickHouse Cloud выберите **Источники данных** в главном меню навигации и нажмите **Create ClickPipe**. Выбор импортируемых данных **2.** Нажмите на плитку **Google Cloud Storage**. Выберите импорты **1.** Чтобы настроить новый ClickPipe, необходимо указать данные для подключения и аутентификации в вашем сервисе объектного хранилища. Заполните сведения о подключении * **Путь к файлу 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 получит метаданные из вашего бакета для следующего шага. В интерфейсе отобразится список файлов в указанном бакете. Выберите формат данных (в настоящее время мы поддерживаем только часть форматов ClickHouse) и укажите, нужно ли включить непрерывную ингестию. Подробнее см. в разделе "continuous ingest" на странице обзора. Выберите формат данных и topic На следующем шаге вы можете выбрать, выполнять ли приём данных в новую таблицу ClickHouse или использовать существующую. Следуйте инструкциям на экране, чтобы изменить имя таблицы, схему и параметры. В верхней части страницы доступен предварительный просмотр изменений в реальном времени в примере таблицы. Задайте таблицу, схему и параметры Вы также можете настроить дополнительные параметры с помощью доступных элементов управления Задайте дополнительные параметры Либо вы можете выбрать приём данных в существующую таблицу ClickHouse. В этом случае интерфейс позволит сопоставить поля источника с полями ClickHouse в выбранной целевой таблице. Использовать существующую таблицу Вы также можете сопоставлять [виртуальные столбцы](/ru/reference/functions/table-functions/s3#virtual-columns), такие как `_path` или `_size`, с полями. Наконец, вы можете настроить разрешения для внутреннего пользователя ClickPipes. **Разрешения:** ClickPipes создаст отдельного пользователя для записи данных в целевую таблицу. Вы можете назначить этому внутреннему пользователю пользовательскую роль или одну из предопределённых ролей: * `Full access`: полный доступ к кластеру. Требуется, если вы используете materialized view или словарь с целевой таблицей. * `Only destination table`: только разрешения `INSERT` для целевой таблицы. Разрешения После нажатия "Complete Setup" система зарегистрирует ваш ClickPipe, и вы увидите его в сводной таблице.
Уведомление об успешном выполнении
Уведомление об удалении В сводной таблице доступны элементы управления для отображения примеров данных из источника или из целевой таблицы ClickHouse Просмотр целевой таблицы А также элементы управления для удаления ClickPipe и отображения сводки по заданию приёма. Просмотр обзора **Поздравляем!** Вы успешно настроили свой первый ClickPipe. Если этот ClickPipe настроен для непрерывной ингестии, он будет непрерывно работать, выполняя приём данных в реальном времени из удалённого источника данных. В противном случае он примет батч и завершит работу.