Skip to main content
Amazon Glue — это полностью управляемый бессерверный сервис интеграции данных от Amazon Web Services (AWS). Он упрощает поиск, подготовку и преобразование данных для аналитики, машинного обучения и разработки приложений.

Установка

Чтобы интегрировать код для Glue с ClickHouse, вы можете использовать наш официальный Spark-коннектор в Glue одним из следующих способов:
  • Установить коннектор ClickHouse Glue из AWS Marketplace (рекомендуется).
  • Вручную добавить JAR-файлы Spark-коннектора в задачу Glue.
1

Подпишитесь на коннектор

Чтобы получить доступ к коннектору в своей учётной записи, подпишитесь на ClickHouse AWS Glue Connector в AWS Marketplace.
2

Предоставьте необходимые разрешения

Убедитесь, что роль IAM вашей задачи Glue имеет необходимые разрешения, как описано в руководстве по минимальным привилегиям.
3

Активируйте коннектор и создайте подключение

После оформления подписки выберите версию Glue, соответствующую требованиям вашей задачи. В разделе Additional details, в подразделе Usage instructions нажмите ссылку Open Glue Studio - Add ClickHouse connector. Откроется страница создания подключения Glue с уже заполненными ключевыми полями. Задайте имя подключения и нажмите Create (на этом этапе указывать сведения о подключении к ClickHouse не нужно).
4

Использование в задаче Glue

В задаче Glue выберите вкладку Job details и раскройте раздел Advanced properties. В разделе Connections выберите только что созданное подключение. Коннектор автоматически добавит необходимые JAR-файлы в среду выполнения задачи.
Обязательно выберите версию коннектора, соответствующую конфигурации вашей задачи Glue:
  • Glue 4: Spark 3.3, Scala 2, Python 3
  • Glue 5: Spark 3.5, Scala 2, Python 3

Использование AWS Secrets Manager для учетных данных

Вместо того чтобы явно указывать пользователя и пароль ClickHouse в задаче, сохраните их в AWS Secrets Manager и используйте секрет в подключении Glue или в скрипте задачи. Во время выполнения Glue извлекает секрет и добавляет его пары ключ-значение в параметры подключения коннектора.

Создайте секрет

В AWS Secrets Manager создайте секрет типа Другой тип секрета с парами ключ-значение, где ключи совпадают с именами параметров коннектора: Любой ключ, добавленный в секрет, будет передан коннектору, поэтому там также можно хранить host, database или любой другой параметр, если вы не хотите хранить их в коде.

Укажите секрет

Есть два способа передать секрет в задачу. Вариант 1: привязать его к подключению Glue. При создании или редактировании подключения ClickHouse в Glue Studio укажите в поле AWS secret имя секрета. Любая задача, использующая это подключение, автоматически получает секрет — никаких изменений в коде не требуется. Вариант 2: передать secretId в параметрах подключения. Используйте этот способ, если секрет не привязан к подключению. Добавьте secretId рядом с connectionName:
Ключи user и password из секрета добавляются к параметрам коннектора во время выполнения, поэтому читать их в скрипте не нужно.

Примеры

В примерах ниже используется marketplace.spark, а для ссылки на коннектор — connectionName. Если вы установили коннектор вручную (вкладка Установка вручную), используйте connection_type="custom.spark" и вместо него передавайте className, host, http_port, user и password напрямую в параметре options. Если вы привязали секрет AWS к самому подключению (вариант 1 в разделе Использование AWS Secrets Manager для учетных данных), уберите secretId из options — Glue автоматически получит учетные данные из подключения.
Вы можете использовать коннектор ClickHouse как источник или целевое назначение в визуальном редакторе Glue Studio. Просто перетащите компонент Spark-коннектора ClickHouse на холст и подключите его к своему конвейеру данных.
Подробнее см. в нашей документации по Spark.
Последнее изменение 14 августа 2026 г.