Настройка списка репозиториев

Перед настройкой списка репозиториев ознакомьтесь с ограничениями при работе с BI-сервером на Linux.

Список репозиториев в реестре

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

Для настройки конкретного репозитория используйте раздел реестра:

Допустимые параметры данного раздела аналогичны атрибутам, допустимым для создания файла Metabases.xml.

Список репозиториев в Metabases.xml

Для настройки списка репозиториев на нескольких рабочих станциях можно использовать файл Metabases.xml, размещенный на сетевом ресурсе. Путь к файлу должен быть прописан в системном реестре рабочих станций. Файл Metabases.xml может быть размещен и на локальном ресурсе.

Изменения настроек подключения к репозиториям в файле Metabases.xml автоматически применяются на рабочих станциях, которые настроены на этот файл. Репозитории, заданные через файл Metabases.xml, недоступны для редактирования с помощью мастера настройки репозитория в веб-приложении или окна «Параметры» в настольном приложении.

Примечание. При совпадении наименований репозиториев, заданных в файле Metabases.xml и мастере настройки репозитория/окне «Параметры», в списке будут отображены оба репозитория.

Для указания пути до файла Metabases.xml в системном реестре:

  1. Откройте раздел реестра [HKEY_LOCAL_MACHINE\Software\Foresight\Foresight Analytics Platform\10.0\Metabases] с настройками репозиториев.

  1. Добавьте строковый параметр Path со значением пути до папки, в которой содержится файл Metabases.xml, например, «C:\Repository_settings\».

Файл Metabases.xml должен состоять из раздела <PP>, включающего в себя раздел <Metabases>. Раздел <Metabases> представляет собой список репозиториев. Настройки каждого репозитория задаются в разделе, название которого соответствует идентификатору репозитория. Ниже приведен список доступных настроек репозитория:

Атрибуты Описание
Name Наименование репозитория.
Authentication

Тип аутентификации:

  • 0. Любой принятый тип аутентификации;

  • 1. Парольная. Аутентификация пользователя производится при указании имени пользователя и пароля в явном виде;

  • 2. Интегрированная доменная. Аутентификация пользователя производится с использованием доменного имени пользователя и пароля (текущей учётной записи ОС). Если тип аутентификации выбран для Oracle, то выполните дополнительные настройки сервера;

  • 3. Ролевая. При данном типе аутентификации каждый пользователь ассоциируется с определенной ролью.

Примечание. Ролевой тип аутентификации является устаревшим. Оставлен для совместимости с предыдущими версиями.

  • 4. Доменная. Аутентификация пользователя производится при указании домена, имени пользователя и пароля в явном виде. Тип аутентификации доступен, если выбран тип драйвера: Oracle, Microsoft SQL Server 2008, 2012\2014\2016, ODBC, PostgreSQL;

  • 7. OAuth. Аутентификация пользователя производится под учётной записью сервисов, поддерживающих протокол OAuth 2.0 или OpenID. Для использования данного типа аутентификации обратитесь к разделу «Настройка входа через внешние сервисы».

Если используется данный тип аутентификации, то дополнительно задайте атрибут OAuthService.

Примечание. При авторизации в веб-приложении тип аутентификации определяется настройками BI-сервера. Если в файле PP.xml в разделе <metabase> заданы репозиторий по умолчанию с помощью атрибута id и тип аутентификации с помощью атрибута authentication, то для данного репозитория будет применяться заданный тип аутентификации независимо от настроек BI-сервера.
Для получения подробной информации о настройках BI-сервера в ОС Linux обратитесь к разделу «Конфигурация и настройка».
OAuthService

Параметры авторизации через протокол OAuth/OpenID, если атрибут Authentication принимает значение «7»:

  • Providers. Массив наименований сервисов авторизации, учётные записи которых можно использовать для входа в веб-приложение. Допустимые значения определяются тем, какие сервисы заданы при настройке параметров для протокола OAuth/OpenID, и указываются через точку с запятой. Обязательный параметр;

  • AutoStartProvider. Порядковый номер сервиса авторизации, указанного в массиве параметра Providers. На выбранный сервис будет выполняться автоматическая переадресация при попытке входа в веб-приложение с использованием протокола OAuth/OpenID. Необязательный параметр.

Если в качестве значения параметра используется сервис, который не содержится в параметре Providers, то автоматическая переадресация выполняться не будет;

  • UseDefaultUser. Признак, который определяет, под каким пользователем происходит подключение к репозиторию при авторизации через протокол OAuth/OpenID:

    • true. По умолчанию. Подключение к репозиторию выполняется под пользователем по умолчанию, учётные данные которого были сохранены с помощью утилиты PP.Util;

    • false. Подключение к репозиторию выполняется под конкретным пользователем, авторизовавшемся на внешнем сервере. Если используется данное значение, то учётные данные каждого пользователя для каждого репозитория должны быть сохранены с помощью утилиты PP.Util.

Необязательный параметр.
Driver Идентификатор СУБД.
Package

Тип пакета безопасности:

  • STANDARDSECURITYPACKAGE. Стандартный пакет безопасности.
DebugMode

Тип кэширования сборок:

  • 0. Кэширование сборок осуществляется на сервере БД и на локальном диске. При запуске/компиляции модуля/формы/сборки будет осуществляться проверка скомпилированной версии сборки. Если версии одинаковые, то работа продолжается со сборкой на локальном диске. Если версии разные или сборка на локальном диске отсутствует, то на сервере БД будет скомпилирована и скопирована новая версия сборки на локальный диск. После чего работа со сборкой будет продолжаться на локальном диске;

  • 1. Кэширование сборок осуществляется только на локальном диске. Сборки, образующиеся при компиляции модулей/форм/сборок, будут кэшироваться на локальном диске.
LogonData

Параметры подключения к репозиторию:

  • DATABASE. Идентификатор базы данных, к которой будет осуществляться подключение. Идентификатор базы данных должен совпадать с идентификатором репозитория. Если при подготовке серверной части СУБД была создана пользовательская схема, то укажите её идентификатор через точку после идентификатора базы данных, например: REPOSITORY_ID.myschema.

Если используется схема по умолчанию, то она не указывается. По умолчанию для Microsoft SQL Server используется схема «dbo», а для PostgreSQL - «public»;

  • SERVER. IP-адрес или DNS-имя, под которым зарегистрирован сервер с подключаемой базой данных (репозиторий). Параметр доступен, если выбран тип драйвера: Oracle, Microsoft SQL Server 2008, 2012\2014\2016, ODBC, Teradata, PostgreSQL;

  • CASESENSITIVE. Признак учёта регистра при работе с СУБД:

    • true. Регистр учитывается;

    • false. Регистр не учитывается.
Credentials Настройки для подключения к репозиторию. Содержит параметр Authentication - тип аутентификации (см. описание Authentication).
VcsLocalPath и VcsStoredPath Путь до папки на диске, в которой хранятся локальные файлы объектов. Для атрибутов указывается одинаковое значение.
VcsName Тип системы управления версиями. Актуально, если репозиторий добавлен в систему управления Git. В качестве значения атрибута указывается - «Git».

Сводный список идентификаторов

Ниже приведен список идентификаторов драйверов, которые могут использоваться для настройки различных объектов репозитория. Идентификаторы используются различными свойствами при настройке объектов с помощью макросов на Fore, а также при создании списка репозиториев в файле Metabases.xml:

Идентификатор Драйвер СУБД

ORCL8

Oracle указанных выше версий

MSSQL2008

Microsoft SQL Server 2008

MSSQL2012

Microsoft SQL Server 2012\2014\2016\2017

MSSQL2012ODBC

Microsoft SQL Server (ODBC)

OLEDB(ODBC HIVE)

OLE DB (ODBC HIVE)

OLEDB(DB2)

OLE DB (DB2)

OLEDB(ODBC)

OLE DB (ODBC)

OLEDB(VISTADB)

OLE DB (VISTADB)

OLEDB

OLE DB провайдер

DB2

Реляционная базы данных DB2

TRDT

Teradata указанных выше версий

POSTGRES

PostgreSQL/Postgres Pro указанных выше версий

POSTGRES(NO_LO)

Greenplum/Pivotal HD Hawq

VERTICA

HP Vertica версии указанных выше версий

ODBC

Generic ODBC

ODBC(CLICKHOUSE)

ClickHouse (ODBC)

Примечание. Для различных объектов репозитория список доступных для использования драйверов может отличаться.

Пример файла Metabases.xml:

<PP>
 <Metabases>
   <WAREHOUSE Name="WAREHOUSE" Authentication="1" Driver="ORCL8" Package="STANDARDSECURITYPACKAGE" DebugMode="1">
     <LogonData DATABASE="WAREHOUSE" SERVER="Server1"/>
     <Credentials Authentication="1"/>
   </WAREHOUSE>
 </Metabases>
</PP>

См. также:

Настройка доступа к репозиторию | Настройка подключения к репозиторию