---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/integrations/visualization/finebi.md?version=v25.3
  - https://ydb.tech/docs/ru/integrations/visualization/finebi.md?version=v25.3
  - href: ru/integrations/visualization/finebi.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/integrations/visualization/finebi.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# FineBI

FineBI — это мощный инструмент для анализа больших данных. FineBI дает возможность организациям анализировать данные и делиться ими для принятия информированных решений. Он позволяет визуализировать необработанные данные, отслеживать ключевые показатели эффективности (KPI), идентифицировать тренды и прогнозировать будущие результаты.

[Режим совместимости с PostgreSQL в YDB](https://ydb.tech/docs/ru/postgresql/intro.md?version=v25.3) позволяет использовать [FineBI](https://intl.finebi.com/) для выполнения запросов и визуализации данных из YDB. В этом случае FineBI работает с YDB как с PostgreSQL.

<!-- source: ru/postgresql/_includes/alert_preview.md -->
{% note warning %}

Поддержка синтаксиса PostgreSQL в YDB **находится в разработке**. Использовать её в production окружениях **не рекомендуется**. Запросы в PostgreSQL могут исполняться до нескольких раз медленнее по сравнению с аналогичными запросами на YQL.

Основной сценарий, который можно тестировать — выполнение аналитических запросов к хранимым в YDB данным.

{% endnote %}
<!-- endsource: ru/postgresql/_includes/alert_preview.md -->

## Пререквизиты

Для работы понадобятся:

* [FineBI](https://intl.finebi.com/);
* PostgreSQL JDBC-драйвер, загруженный в FineBI.

    {% note info %}

    Скачать актуальный PostgreSQL JDBC-драйвер можно со [страницы загрузки](https://jdbc.postgresql.org/download/) сайта PostgreSQL. Чтобы загрузить JDBC-драйвер для PostgreSQL в FineBI, следуйте [инструкции](https://help.fanruan.com/finebi-en/doc-view-1540.html) в документации FineBI.

    {% endnote %}

## Создание подключения к YDB {#add-database-connection}

Чтобы создать подключение к YDB из FineBI с использованием сетевого протокола PostgreSQL, выполните следующие шаги:

1. Войдите в аккаунт `admin` на FineBI.

1. Перейдите в **System Management** > **Data Connection** > **Data Connection Management**.

1. Нажмите кнопку **New Data Connection**.

1. Чтобы найти иконку PostgreSQL, в поле **Search** введите `postgresql`.

1. Нажмите иконку PostgreSQL.

1. Введите данные для подключения к YDB в следующие поля:

    * **Data Connection Name** — наименование соединения с YDB в FineBI.

    * **Driver** — драйвер для подключения FineBI к YDB.

        Выберите `Custom` и установленный JDBC-драйвер `org.postgresql.Driver`.

    * **Database Name** — путь к [базе данных](https://ydb.tech/docs/ru/concepts/glossary.md?version=v25.3#database) в кластере YDB, к которой будут выполняться запросы.

        {% note alert %}

        Специальные символы в пути к базе данных должны быть [закодированы](https://en.wikipedia.org/wiki/Percent-encoding). Например, убедитесь, что все слэши (`/`) заменены на `%2F`.

        {% endnote %}

    * **Host** — [эндпоинт](https://ydb.tech/docs/ru/concepts/connect.md?version=v25.3#endpoint) кластера YDB, к которому осуществляется подключение.

    * **Port** — порт эндпоинта YDB.

    * **Username** — логин для подключения к базе данных YDB.

    * **Password** — пароль для подключения к базе данных YDB.

    ![](_assets/finebi/finebi-database-connection.png =600x)

1. Нажмите кнопку **Test Connection**.

    Если данные для подключения указаны верно, появится сообщение об удачном установлении соединения.

1. Чтобы сохранить подключение, нажмите кнопку **Save**.

    Созданное подключение к YDB появится в списке **Data Connection**.

## Создание набора данных (SQL dataset) {#create-dataset}

Чтобы создать набор данных из таблицы YDB, выполните следующие шаги:

1. В FineBI откройте вкладку **Public Data**.

1. Выберите папку, в которой вы хотите создать набор данных.

    {% note warning %}

    У вас должны быть права [Public Data Management](https://help.fanruan.com/finebi-en/doc-view-5734.html) для выбранной папки в FineBI.

    {% endnote %}

1. Нажмите кнопку **Add Dataset** и выберите **SQL Dataset** в выпадающем списке.

1. В поле **Table Name** введите наименование набора данных.

1. В выпадающем списке **Data from Data Connection** выберите подключение к YDB.

1. В поле **SQL Statement** введите текст SQL-запроса на получение всех колонок из таблицы YDB. Например, `SELECT * FROM <YDB_table_name>`.

    {% note tip %}

    Если вы хотите создать набор данных из таблицы, которая расположена в поддиректории YDB, необходимо указать путь к таблице в самом наименовании таблицы. Например:

    ```yql
    SELECT * FROM "<path/to/subdirectory/table_name>";
    ```

    {% endnote %}

1. Нажмите кнопку **Preview**, чтобы проверить SQL-запрос. Если SQL-запрос составлен правильно, появится таблица с данными в правой части страницы.

    ![](_assets/finebi/finebi-sql-dataset.png)

1. Чтобы сохранить набор данных, нажмите кнопку **OK**.

После создания наборов данных вы можете использовать данные из YDB для создания диаграмм в FineBI. См. документацию [FineBI](https://help.fanruan.com/finebi-en/).


## Создание диаграммы {#create-chart}

Теперь давайте создадим пример диаграммы с использованием набора данных из таблицы `episodes`, [создание](https://ydb.tech/docs/ru/dev/yql-tutorial/create_demo_tables.md?version=v25.3) и [наполнение данными](https://ydb.tech/docs/ru/dev/yql-tutorial/fill_tables_with_data.md?version=v25.3) которой описано в [Туториале по YQL](https://ydb.tech/docs/ru/dev/yql-tutorial/index.md?version=v25.3). Мы создадим круговую диаграмму, в которой будет видно, сколько серий содержит каждый сезон сериала.

Таблица `episodes` содержит следующие колонки:

* `series_id`;
* `season_id`;
* `episode_id`;
* `title`;
* `air_date`.

Чтобы создать диаграмму, выполните следующие шаги:

1. В FineBI откройте вкладку **My Analysis**.

1. Нажмите кнопку **New Subject**.

    Откроется диалоговое окно **Select Data**.

1. В открывшемся окне **Select Data** выберите набор данных для таблицы `episodes` и нажмите кнопку **OK**.

1. Откройте вкладку **Component** внизу страницы.

1. На панели **Chart Type** нажмите иконку **Pie Chart**.

1. В списке колонок набора данных `episodes` нажмите стрелку рядом с колонкой `episode_id` и выберите пункт **Convert to Dimension** в выпадающем списке.

    ![](_assets/finebi/finebi-convert2dimension.png =350x)

1. Перетащите колонку `season_id` в поле **Color**.

1. Перетащите колонку `title` в поле **Label**.

1. Перетащите колонку `series_id` в поле **Filter**.

    Откроется диалоговое окно **Add Filter to episodes.series_id**.

1. В открывшемся окне **Add Filter to episodes.series_id** выберите пункт `Detailed Value` и нажмите кнопку **Next Step**.

1. Укажите следующее условие:

    `series_id` `Equal To` `Fixed Value` `2`

1. Нажмите кнопку **OK**.

    Диаграмма будет использовать данные только для сериала с идентификатором `2`.

    ![](_assets/finebi/finebi-sample-chart.png)

1. Нажмите кнопку **Save**.