Подключить источник данных

Подключение говорит Антиме, откуда брать данные. Одно подключение — один источник: файл, Google Таблица или база данных.

Кто может

Администратор и сотрудники с уровнем «Полные»

Где

Бизнес аналитика → Настройки → Подключения

Как подключить Excel-файл к бизнес-аналитике 0:28

Подключить Excel-файл

1. В левом меню откройте «Бизнес аналитика» → «Настройки» и перейдите на вкладку «Подключения».

2. Нажмите «Добавить подключение».

3. В поле «Тип» выберите «Excel (.xlsx)». В окне останутся только название и файл.

4. Введите название — по нему подключение будет видно в списке. Если оставить пустым, подключение назовётся по имени файла.

5. Нажмите «Выберите файл» и укажите файл на компьютере. Под кнопкой появится «Выбран:» с именем и размером файла.

6. Нажмите «Загрузить». Появится сообщение «Excel-файл загружен, подключение создано», в окне — «Сохранено». Нажмите «Закрыть».

Каждый лист книги станет отдельной таблицей, первая строка листа — названия колонок. Все колонки приходят как текст: числа и даты нужно отметить в датасете. Проверять Excel-подключение не нужно — кнопки «Протестировать» у него нет, в списке оно сразу «Активно».

Ограничение	Значение
Формат	.xlsx или .xls. CSV не подходит — откройте его в Excel и сохраните как .xlsx
Размер файла	До 25 МБ
Строк на листе	До 200 000

Файл загружается один раз

Заменить файл у подключения нельзя. Если открыть Excel-подключение через «Редактировать» и нажать «Загрузить», появится новое подключение, а старое останется как было. Переименовать Excel-подключение тоже нельзя.

Если данные в Excel меняются, удобнее вести их в Google Таблице — Антима будет брать свежие данные сама.

Подключить Google Таблицу

1. Нажмите «Добавить подключение», введите название и в поле «Тип» выберите «Google Sheets».

2. В поле «Ссылка на таблицу или Spreadsheet ID» вставьте ссылку на таблицу из адресной строки браузера — Антима сама найдёт в ней номер таблицы.

3. «Название таблицы (опционально)» можно не заполнять. Если заполнить, оно будет видно в колонке «База данных» списка подключений.

4. Выберите «Google-аккаунт компании» — аккаунт, которому открыта таблица. Если нужного аккаунта нет, нажмите «Добавить аккаунт», войдите в Google и в окне Google отметьте галочку доступа к таблицам.

5. Нажмите «Протестировать», затем «Сохранить».

Антима просит у Google только право читать таблицы — изменить в них она ничего не может. Подключённый аккаунт виден всем подключениям компании: для следующей таблицы входить в Google заново не нужно.

Метка у аккаунта	Что сделать
«Подключение истекло» — красная	Нажмите «Переподключить» и войдите в Google снова
«Нет доступа к Google-таблицы» — серая	Нажмите «Выдать доступ» и отметьте галочку в окне Google. Без неё Антима покажет «Доступ не выдан»

Вместо аккаунта можно подключить сервисный аккаунт Google: нажмите «Использовать JSON ключ сервисного аккаунта» и вставьте ключ целиком в поле «JSON Key (Service Account)». Затем в Google Таблице нажмите «Настройки доступа» и откройте таблицу для email из ключа — он записан в ключе после client_email. Вернуться к входу через аккаунт — «Вернуться к OAuth».

Как Антима читает таблицу:

• каждый лист — отдельная таблица подключения;
• первая строка листа — названия колонок; колонка без названия получит имя по букве — A, B, C;
• пустые строки и колонки пропускаются;
• на листе читается до 702 колонок — до колонки ZZ;
• все колонки приходят как текст: числа и даты нужно отметить в датасете.

Несколько Google Таблиц

Одно подключение — одна Google Таблица. Чтобы свести данные из нескольких файлов — например, продажи филиалов, которые ведутся в разных таблицах, — сделайте подключение для каждого файла и соберите их в одном датасете.

1. Подключите каждую таблицу, как описано выше. Google-аккаунт можно выбирать один и тот же.

2. Создайте датасет. На вкладке «Источники» в блоке «Подключения» нажмите «Добавить», отметьте все нужные подключения — или «Выбрать все» — и нажмите «Добавить (N)».

3. Окно «Выбор таблиц» откроется для каждого подключения по очереди — в заголовке видно, сколько ещё «в очереди». Отметьте листы и нажмите «Применить». Если нажать «Отмена», очередь прервётся: остальные подключения останутся в датасете без таблиц, их листы можно выбрать позже кнопкой «Выбрать таблицы».

4. В блоке «Связи» должно быть выбрано «Объединить строки (UNION)». Новому датасету только из Excel и Google Таблиц Антима выбирает его сама — при первом выборе таблиц.

5. Сохраните датасет.

Строки всех листов встанут друг под другом:

Как	Что происходит
Колонки с одинаковым названием	Становятся одной колонкой. Большие и маленькие буквы и пробелы по краям не важны: «Сумма» и «сумма » совпадут
Колонка есть не во всех файлах	В строках из других файлов она будет пустой
Одно и то же под разными названиями — «Телефон» и «Тел.»	«Объединить столбцы с разными именами» → «Настроить» → «Правило»: общее название и какие колонки к нему отнести. «Автоопределить по имени» подставит совпадающие
Нужно знать, из какого файла строка	«Ручные поля» → «Настроить» → «Поле»: колонка-метка, например «Филиал», и её значение для каждого файла
Порядок строк и повторы	«Настройки объединения» — см. «Создать датасет»

В одном объединении можно смешивать Google Таблицы, листы Excel и таблицы баз данных.

Ограничения объединения

• Только «Объединить строки». «Связать (JOIN)» для таблиц из разных подключений не работает.
• До 100 000 строк на весь датасет. Строки сверх этого отбрасываются без предупреждения.
• Если какой-то файл не прочитался — например, у аккаунта забрали доступ к нему, — датасет соберётся из остальных. Если итоги вдруг уменьшились, проверьте подключения.
• Google ограничивает частые запросы. Если таблиц много или дашборд открывают часто, включите «Копию данных в сервисе».

Подключить базу данных или Битрикс24

Порядок тот же: «Добавить подключение», название, тип. Дальше поля зависят от типа:

Тип	Что указать
PostgreSQL, MySQL	«Хост», «Порт», «Имя базы данных», «Пользователь» и «Пароль»
ClickHouse	«Хост», «Порт», «Пользователь» и «Пароль». Имени базы у ClickHouse в окне нет
Bitrix24	«Адрес сервера Bitrix24» — например, company.bitrix24.ru — и «Секретный ключ». Ключ — в Битрикс24: CRM → Аналитика → BI-аналитика → Microsoft Power BI

Порт подставляется сам при выборе типа: 5432 у PostgreSQL, 3306 у MySQL, 8443 у ClickHouse. Если вы ввели свой порт, смена типа его не тронет. Если сервер базы требует шифрования, отметьте «Использовать SSL».

Пользователь только для чтения

Для подключения к базе заведите отдельного пользователя с правом только на чтение нужных таблиц — так аналитика точно ничего не изменит в ваших данных.

Проверить подключение

Кнопка «Протестировать» проверяет, что источник отвечает. Рядом с ней появится зелёная галочка — всё хорошо — или красный крестик, а вверху — сообщение: «Подключение успешно установлено!» или текст ошибки. Что значат тексты ошибок — в статье «Ошибки и что делать».

«Сохранить» сохраняет подключение и сразу проверяет его ещё раз. Если проверка не прошла, подключение всё равно сохранится, Антима предупредит «Сохранено с ошибкой», а в списке у него будет статус «Ошибка».

Как исправить сохранённое подключение

У сохранённой базы данных и Битрикс24 «Протестировать» проверяет то, что уже сохранено, а не то, что сейчас в полях окна. Поэтому порядок такой: исправьте данные в окне и нажмите «Сохранить» — проверка пройдёт сама.

Сохранённое подключение при ошибке отвечает только «Connection failed», без причины. Чтобы увидеть причину, нажмите «Добавить подключение», введите те же данные, нажмите «Протестировать» и прочитайте текст ошибки. Потом нажмите «Отмена», чтобы не создать второе подключение.

Что ещё полезно знать об окне подключения:

• при правке поле «Пароль» или «Секретный ключ» пустое. Оставьте его пустым — сохранится прежний пароль; введите новый — он заменит старый;
• у Google Таблицы, подключённой через аккаунт, «Протестировать» проверяет выбранный в окне аккаунт — можно сменить аккаунт и сразу проверить;
• Esc закрывает окно без сохранения, пока не идёт проверка или сохранение;
• после сохранения кнопка «Отмена» превращается в «Закрыть».

Список подключений

На вкладке «Подключения» видны все подключения компании. Если вы работаете внутри портфеля, в списке только подключения этого портфеля, а новое подключение сразу попадает в него — см. «Портфели».

Колонка	Что показывает
Название	Название подключения
Тип	Значок и тип источника
Хост	Адрес сервера и порт. У Google Таблицы — номер таблицы, у Excel — служебное имя файла
База данных	Имя базы. У Google Таблицы — «Название таблицы», если его задали. На узком экране колонка скрыта
Статус	Результат последней проверки — см. ниже
Инфо	Сколько строк, столбцов и листов. Заполняется только у Google Таблиц, для которых включена «Копия данных в сервисе». У остальных — прочерк
Действия	Кнопки «Проверить», «Редактировать», «Удалить» — появляются при наведении на строку

Статус	Что значит
Активно — зелёный	Последняя проверка прошла
Ошибка — красный	Последняя проверка не прошла
Неактивно — серый	Подключение ещё ни разу не проверяли. Так бывает у подключений, созданных из датасета или перенесённых из DataLens — см. «Перенос из DataLens». Нажмите «Проверить»

Над списком:

• «Поиск подключений…» — ищет по названию и хосту;
• фильтр статуса: «Все статусы», «Активные», «Неактивные» или «С ошибками».

Щелчок по строке открывает подключение для правки — как кнопка «Редактировать».

Действие	Что делает
Проверить	Заново проверяет, что источник отвечает, и обновляет статус. Если вместо причины написано «Connection failed», см. «Как исправить сохранённое подключение»
Редактировать	Меняет название и параметры доступа. У Excel — см. «Файл загружается один раз»
Удалить	Спрашивает «Вы уверены, что хотите удалить это подключение?» и удаляет его

Чтобы удалить несколько подключений сразу, отметьте их галочками слева — галочка появляется при наведении на строку, а галочка в заголовке отмечает все найденные. Внизу появится панель «Выбрано: N» — нажмите «Удалить» и подтвердите «Удалить N подключений?». Крестик на панели снимает выбор.

Удаление не проверяет датасеты

Антима не предупреждает, что на подключении построены датасеты. После удаления такие датасеты останутся без источника, а их виджеты перестанут показывать данные. Перед удалением убедитесь, что подключение нигде не используется.

Подключение «Продажи Antima»

Если в компании работает сервис «Продажи», в его отчётах есть кнопка «Открыть в аналитике». При первом нажатии Антима сама заводит подключение «Продажи Antima» и датасет «Продажи: …» по выбранному набору — например, «Продажи: Сделки» — и открывает датасет.

• Подключение одно на компанию. Логина и пароля у него нет: это ваши же данные из «Продаж».
• Данные в датасете обновляются сами — это те же записи, что в разделе «Продажи». В датасет попадает до 50 000 строк.
• Повторное нажатие «Открыть в аналитике» по тому же набору открывает прежний датасет, а не создаёт новый.
• Подключение можно проверить кнопкой «Проверить». Редактировать и удалять его не нужно: окно правки не рассчитано на этот тип, а после удаления датасеты «Продаж» останутся без источника.

Создать подключение из датасета

В редакторе датасета есть кнопка «Подключения» на вкладке «Источники» и ссылка «+ Создать новое подключение» в окне «Выбор подключений». Они открывают упрощённую форму «Новое подключение», и её проверка сейчас всегда отвечает ошибкой.

Создавайте подключения в «Настройки» → «Подключения», как описано выше, а потом добавляйте их в датасет кнопкой «Добавить» на вкладке «Источники».