Установка
- Установить коннектор ClickHouse Glue из AWS Marketplace (рекомендуется).
- Вручную добавить JAR-файлы Spark-коннектора в задачу Glue.
- AWS Marketplace
- Установка вручную
Подпишитесь на коннектор
Чтобы получить доступ к коннектору в своей учётной записи, подпишитесь на ClickHouse AWS Glue Connector в AWS Marketplace.
Предоставьте необходимые разрешения
Убедитесь, что роль IAM вашей задачи Glue имеет необходимые разрешения, как описано в руководстве по минимальным привилегиям.
Активируйте коннектор и создайте подключение
После оформления подписки выберите версию Glue, соответствующую требованиям вашей задачи. В разделе Additional details, в подразделе Usage instructions нажмите ссылку Open Glue Studio - Add ClickHouse connector. Откроется страница создания подключения Glue с уже заполненными ключевыми полями. Задайте имя подключения и нажмите Create (на этом этапе указывать сведения о подключении к ClickHouse не нужно).
Использование в задаче 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 для учетных данных
Создайте секрет
Любой ключ, добавленный в секрет, будет передан коннектору, поэтому там также можно хранить
host, database или любой другой параметр, если вы не хотите хранить их в коде.
Укажите секрет
secretId в параметрах подключения. Используйте этот способ, если секрет не привязан к подключению. Добавьте secretId рядом с connectionName:
- Python
- Scala
user и password из секрета добавляются к параметрам коннектора во время выполнения, поэтому читать их в скрипте не нужно.
Примеры
marketplace.spark, а для ссылки на коннектор — connectionName. Если вы установили коннектор вручную (вкладка Установка вручную), используйте connection_type="custom.spark" и вместо него передавайте className, host, http_port, user и password напрямую в параметре options.
Если вы привязали секрет AWS к самому подключению (вариант 1 в разделе Использование AWS Secrets Manager для учетных данных), уберите secretId из options — Glue автоматически получит учетные данные из подключения.
- Визуальный редактор
- Scala
- Python
Вы можете использовать коннектор ClickHouse как источник или целевое назначение в визуальном редакторе Glue Studio. Просто перетащите компонент Spark-коннектора ClickHouse на холст и подключите его к своему конвейеру данных.