Руководство пользователя
Как управлять подключениями к источникам данных
Работа с подключениями
В этом руководстве говорится, как работать с подключениями к источникам данных в Epsilon Metrics.
Введение
Панель управления Epsilon Metrics включает в себя функции для регистрации и управления подключениями к источникам данных. Вы можете регистрировать подключения к облачным хранилищам, базам данных и хранилищам данных. После регистрации подключения вы можете выполнять различные операции с источником данных, например выполнять функции, предоставляемые пространственным расширением Epsilon Metrics (если оно доступно для источника данных), или импортировать наборы данных.
Создание подключения
Если вы перейдете на страницу данных на панели управления, вы увидите список ваших текущих наборов данных. Если вы выберете вкладку «Ваши подключения», вы увидите список ваших текущих подключений. Если вы еще не зарегистрировали подключение, вы увидите следующую страницу:
img
Рабочий процесс для добавления подключения выглядит следующим образом:
- Нажмите на кнопку «Добавить подключение»
- Выберите коннектор для вашего источника данных
- Введите параметры подключения и учетные данные
Когда вы нажмете кнопку «Добавить подключение», вы увидите новый модальный диалог для выбора используемого коннектора:
img
Вы можете создавать подключения, используя два разных типа коннекторов:
- Коннекторы баз данных. В эту группу входят коннекторы для облачных хранилищ данных и реляционных баз данных. Нам нужно ввести параметры подключения, такие как сервер, имя пользователя или пароль, либо предоставить учетную запись службы, в зависимости от коннектора. Вам необходимо убедиться, что Epsilon Metrics может подключиться к вашей базе данных: если у вас есть брандмауэр, вам необходимо открыть его для общедоступных IP-адресов Epsilon Metrics. В форме параметров подключения справа вы увидите список IP-адресов.
- Коннекторы облачных файлов. В эту группу входят коннекторы для служб облачного хранения. Аутентификация в этих службах настраивается с использованием OAuth. Когда вы выберете один из этих коннекторов, появится диалоговое окно согласия от поставщика услуг.
После того, как вы указали параметры подключения или дали согласие на использование платформы Epsilon Metrics, появится следующий экран:
img
В этом диалоговом окне вы можете вернуться на страницу «Ваши подключения» или напрямую импортировать набор данных. Если коннектор предоставляет доступ к модулю визуализации пространственного расширения, вы увидите дополнительную опцию для перехода на страницу со списками ваших наборов листов.
Если вы вернетесь на страницу «Ваши подключения», вы увидите только что зарегистрированное подключение:
img
Если вы кликните по подключению, вы будете перенаправлены на страницу для импорта набора данных с использованием подключения. Если вы наведете курсор мыши на подключение, вы сможете получить доступ к меню быстрых действий, кликнув по значку с тремя точками в правом верхнем углу.
img
Для подключений к облачным хранилищам через OAuth единственным доступным действием будет функция «Удалить», которая аннулирует согласие. Для подключений к базе данных в дополнение к действию «Удалить» вы также увидите действие «Редактировать», которое можно использовать для изменения параметров подключения. Более подробную информацию о действиях по редактированию и удалению подключения вы можете найти ниже.
Помимо быстрых действий, если навести курсор мыши на «Параметры» внизу подключения, вы увидите всплывающую подсказку с параметрами подключения.
img
В следующих разделах мы расскажем вам, как настроить подключения к поддерживаемым источникам данных.
Подключение к BigQuery
Epsilon Metrics использует учетные данные для доступа к BigQuery, чтобы выполнять запросы от вашего имени.
Вы можете использовать части Epsilon Metrics напрямую, используя консоль BigQuery через пространственное расширение Epsilon Metrics, или вы можете использовать панель управления Epsilon Metrics для запуска различных операций, таких как создание набора листов.
Мы будем использовать адрес электронной почты, связанный с вашей учетной записью Epsilon Metrics, чтобы предоставить доступ к расширению из консоли BigQuery. Если вы зарегистрировались, используя свою учетную запись Google, вам больше ничего не нужно делать. В противном случае перед регистрацией подключения обновите свой адрес электронной почты в настройках своей учетной записи, чтобы он совпадал с вашей учетной записью Google.
При доступе к BigQuery будет взиматься плата с платежного аккаунта, связанного с выбранным платежным проектом. Если у вас нет соглашения о фиксированной цене, мы рекомендуем вам настроить ограничения в BigQuery, чтобы избежать непредвиденных расходов.
При выборе коннектора BigQuery в диалоговом окне «Добавить новое подключение» вы увидите следующую страницу:
img
Если вы нажмете кнопку «Продолжить», вы будете перенаправлены на страницу, где вам нужно предоставить ключевой файл вашей учетной записи в формате JSON. Прочтите следующие инструкции по созданию учетной записи службы и ключевого файла учетной записи службы.
img
После того, как вы загрузили файл, вы можете нажать на кнопку «Продолжить». Epsilon Metrics попытается подключиться к вашему хранилищу данных BigQuery, используя предоставленную учетную запись службы.
img
В случае успешного подключения вы будете перенаправлены на страницу выбора платежного проекта. Селектор покажет проекты, доступные из предоставленной учетной записи службы. С платежного аккаунта, связанного с выбранным проектом, будет взиматься плата при доступе к BigQuery из Epsilon Metrics. Epsilon Metrics получит доступ к BigQuery для импорта наборов данных, создания и обновления наборов листов и выполнения функций из пространственного расширения.
img
И наконец, нажмите на кнопку «Подключиться», после чего подключение будет зарегистрировано.
img
Подключение к Snowflake
Если вы хотите создать подключение к своей учетной записи Snowflake, вам нужно в диалоговом окне «Добавить новое подключение» выбрать коннектор Snowflake. После выбора коннектора появится следующий диалог для ввода параметров подключения:
img
Вот параметры, которые вам необходимо указать:
| Параметр | Описание |
|---|---|
| Имя | С коннектором Snowflake вы можете зарегистрировать различные подключения. Вы можете использовать имя для идентификации подключений. |
| Сервер | Имя хоста для вашей учетной записи в следующем формате: <account_name>.snowflakecomputing.com |
| База данных | База данных, которая будет использоваться вашим подключением. |
| Имя пользователя | Имя для входа в систему для пользователя Snowflake. |
| Пароль | Пароль для пользователя Snowflake. |
| Хранилище | Хранилище по умолчанию, которое будет выполнять ваши запросы. Этот параметр является необязательным. |
В настоящее время мы поддерживаем только аутентификацию по имени пользователя/паролю с использованием внутреннего аутентификатора Snowflake. Мы не поддерживаем поставщиков удостоверений, совместимых с федеративной аутентификацией/SSO, OAuth или SAML 2.0.
Если у вас имеется какая-либо IP-фильтрация для ограничения доступа к вашей учетной записи Snowflake, вам необходимо разрешить доступ к общедоступным IP-адресам серверов Epsilon Metrics, которые перечислены в диалоговом окне параметров подключения.
После того, как вы ввели параметры, нажмите кнопку «Подключиться». Epsilon Metrics попытается подключиться к вашей учетной записи Snowflake. Если все в порядке, ваше новое подключение будет зарегистрировано.
Подключение к Amazon Redshift
Вот параметры, которые вам необходимо указать:
| Параметр | Описание |
|---|---|
| Имя | С помощью коннектора Redshift вы можете зарегистрировать различные подключения. Вы можете использовать имя для идентификации подключений. |
| Кластер | DNS-имя или IP-адрес для вашего кластера Redshift. |
| Порт | TCP-порт, на котором ваш кластер ожидает подключения. |
| База данных | База данных, которая будет использоваться вашим подключением. |
| Имя пользователя | Имя учетной записи пользователя. |
| Пароль | Пароль для учетной записи пользователя. |
Если у вас имеется какая-либо IP-фильтрация/безопасность VPC для ограничения доступа к вашему кластеру Redshift, вам необходимо разрешить доступ к общедоступным IP-адресам серверов Epsilon Metrics, которые перечислены в диалоговом окне параметров подключения.
После того, как вы ввели параметры, нажмите кнопку «Подключиться». Epsilon Metrics попытается подключиться к вашему кластеру Redshift. Если все в порядке, ваше новое подключение будет зарегистрировано.
Подключение к PostgreSQL.
Если вы хотите создать подключение к вашему серверу PostgreSQL, вам нужно в диалоговом окне «Добавить новое подключение» выбрать коннектор PostgreSQL. После выбора коннектора появится следующий диалог для ввода параметров подключения:
img
Вот параметры, которые вам необходимо указать:
| Параметр | Описание |
|---|---|
| Имя | С помощью коннектора PostgreSQL вы можете зарегистрировать различные подключения. Вы можете использовать имя для идентификации подключений. |
| Сервер | DNS-имя или IP-адрес для вашего сервера PostgreSQL. |
| Порт | TCP-порт, на котором ваш сервер ожидает подключения. |
| База данных | База данных, которая будет использоваться вашим подключением. |
| Имя пользователя | Имя учетной записи пользователя. |
| Пароль | Пароль для учетной записи пользователя. |
Этот коннектор можно использовать для регистрации подключений к базам данных, совместимым с PostgreSQL, включая Amazon Aurora, Amazon RDS для PostgreSQL, Google Cloud для PostgreSQL и базу данных Microsoft Azure для PostgreSQL.
Если у вас имеется какая-либо IP-фильтрация для ограничения доступа к вашему серверу PostgreSQL, вам необходимо разрешить доступ к общедоступным IP-адресам серверов Epsilon Metrics, которые перечислены в диалоговом окне параметров подключения.
После того, как вы ввели параметры, нажмите кнопку «Подключиться». Epsilon Metrics попытается подключиться к вашему серверу PostgreSQL. Если все в порядке, ваше новое подключение будет зарегистрировано.
Подключение к MySQL
Если вы хотите создать подключение к вашему серверу MySQL, вам нужно в диалоговом окне «Добавить новое подключение» выбрать коннектор MySQL. После выбора коннектора появится следующий диалог для ввода параметров подключения:
img
Вот параметры, которые вам необходимо указать:
| Параметр | Описание |
|---|---|
| Имя | С помощью коннектора MySQL вы можете зарегистрировать различные подключения. Вы можете использовать имя для идентификации подключений. |
| Сервер | DNS-имя или IP-адрес для вашего сервера MySQL . |
| Порт | TCP-порт, на котором ваш сервер ожидает подключения. |
| База данных | База данных, которая будет использоваться вашим подключением. |
| Имя пользователя | Имя учетной записи пользователя. |
| Пароль | Пароль для учетной записи пользователя. |
Этот коннектор можно использовать для регистрации подключений к базам данных, совместимым с MySQL, включая MariaDB, Amazon Aurora, Amazon RDS для MySQL, Google Cloud для MySQL и базу данных Microsoft Azure для MySQL.
Если у вас имеется какая-либо IP-фильтрация для ограничения доступа к вашему серверу MySQL, вам необходимо разрешить доступ к общедоступным IP-адресам серверов Epsilon Metrics, которые перечислены в диалоговом окне параметров подключения.
После того, как вы ввели параметры, нажмите кнопку «Подключиться». Epsilon Metrics попытается подключиться к вашему серверу MySQL. Если все в порядке, ваше новое подключение будет зарегистрировано.
Подключение к Microsoft SQL Server
Если вы хотите создать подключение к Microsoft SQL Server, вам необходимо в диалоговом окне «Добавить новое подключение» выбрать коннектор SQL Server. После выбора коннектора появится следующий диалог для ввода параметров подключения:
img
Вот параметры, которые вам необходимо указать:
| Параметр | Описание |
|---|---|
| Имя | С помощью коннектора SQL Server вы можете зарегистрировать различные подключения. Вы можете использовать имя для идентификации подключений. |
| Сервер | DNS-имя или IP-адрес для вашего сервера SQL Server . |
| Порт | TCP-порт, на котором ваш сервер ожидает подключения. |
| База данных | База данных, которая будет использоваться вашим подключением. |
| Имя пользователя | Имя учетной записи пользователя. |
| Пароль | Пароль для учетной записи пользователя. |
Этот коннектор можно использовать для регистрации подключений к базам данных, совместимым с SQL Server, включая Amazon RDS для SQL Server, Google Cloud для SQL Server и базу данных SQL Azure.
Если у вас имеется какая-либо фильтрация IP-адресов для ограничения доступа к SQL Server, вам необходимо разрешить доступ к общедоступным IP-адресам серверов Epsilon Metrics, которые перечислены в диалоговом окне параметров подключения.
После того, как вы ввели параметры, нажмите кнопку «Подключиться». Epsilon Metrics попытается подключиться к SQL Server. Если все в порядке, ваше новое подключение будет зарегистрировано.
Подключение к облачным службам хранения
Все коннекторы для облачных хранилищ (Google Диск, Box и Dropbox) используют протокол OAuth для доступа к файлам облачного хранилища из вашей учетной записи Epsilon Metrics. Во всех случаях рабочий процесс одинаков: когда вы кликаете по коннектору, вы перенаправляетесь на внешнюю страницу от поставщика облачного хранилища, где вам нужно дать согласие на доступ Epsilon Metrics к вашей учетной записи.
После того, как вы дали согласие и нажали на подключение к облачному хранилищу, на панели управления отобразится список файлов из вашей учетной записи. В настоящее время навигация по папкам не поддерживается. Это означает, что все файлы, в том числе те, которыми вы поделились, представлены в одном списке. Если вы хотите найти конкретный файл, вы можете воспользоваться функцией поиска вашего браузера для поиска имени файла.
Редактирование подключения
Если вы кликните по быстрому действию «Редактировать», вы будете перенаправлены в диалог редактирования параметров подключения. Это диалоговое окно содержит ту же форму, которую вы заполняли при добавлении подключения, с отображением текущих значений.
Если вы редактируете параметры подключения и у вас имеются наборы данных, которые синхронизируются через определенные промежутки времени, эти наборы данных больше не будут синхронизироваться, если они недоступны с использованием измененных параметров подключения. В верхней части формы появится предупреждение, информирующее вас об этом.
img
После того, как вы изменили параметры, нажмите кнопку «Сохранить и подключить». Платформа Epsilon Metrics попытается подключиться к источнику данных. Если подключение прошло успешно, новые параметры подключения будут сохранены.
Удаление подключения
Если вы кликните по быстрому действию «Удалить», вы будете перенаправлены в диалоговое окно, где вам нужно подтвердить удаление. Если вы удалили подключение, и у вас были наборы данных, которые периодически синхронизировались, они больше не будут обновляться, но не будут удалены из вашей учетной записи. Как мы уже упоминали выше, удаление подключения OAuth аннулирует согласие на доступ к вашей учетной записи с платформы Epsilon Metrics.
img