Загрузка данных федерированных разделов

Из куба федерированного раздела Essbase, можно загрузить данные в таблицу фактов в Autonomous Data Warehouse. Прежде чем сделать это, необходимо интегрировать Essbase с объектным хранилищем OCI и настроить учетные данные DBMS_CLOUD с помощью сценария configure-dbms-writeback.

Интеграция Essbase с объектным хранилищем OCI

Чтобы загрузить данные из куба федерированного раздела в таблицу фактов в Autonomous Data Warehouse, Essbase использует пакет DBMS_CLOUD, поставляемый с автономной базой данных.

Чтобы получить доступ к пакету DBMS_CLOUD, нужно выбрать интеграцию Essbase с объектным хранилищем OCI при развертывании стека Oracle Essbase из Oracle Cloud Marketplace.

Чтобы узнать все подробности, см. Развертывание Essbase из Marketplace для федерированных разделов.

Настройка учетных данных для загрузки данных

Перед выполнением любой операции загрузки данных через Essbase в Autonomous Data Warehouse необходимо выполнить рабочий поток, чтобы включить возможность использования облачных учетных данных для федерированных разделов.

Типы пользователей в рабочем потоке загрузки данных

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

Тип пользователя	Роль в рабочем потоке
Пользователь SSH	Может с помощью командной строки операционной системы получать доступ к экземпляру Essbase, развернутому в Oracle Cloud Infrastructure, как пользователь opc . (Этот может быть тот же человек, который занимался развертыванием Essbase как стека в OCI).
Пользователь БД	Знает имя схемы Autonomous Data Warehouse и пароль, которые использовались для создания подключения Essbase к базе данных Oracle Database (необходимое предварительное условие для создания федерированного раздела).
Пользователь OCI	Может получать доступ к консоли OCI, включая сегмент объектного хранилища с каталогом Essbase.
Администратор БД	Знает имя схемы администратора БД Oracle и пароль.
Администратор Essbase	Системный администратор Essbase. Это может быть как первоначальный администратор Essbase, созданный администратором домена идентификации (который может быть также Пользователем OCI), так и другой системный администратор Essbase, созданный после завершения развертывания Essbase.
Менеджер приложения Essbase	Менеджер/владелец приложения Essbase, созданный после завершения развертывания Essbase.

Рабочий поток загрузки данных

Для каждой схемы базы данных, используемой для создания федерированного раздела, необходимо выполнить следующие шаги.

Пользователь OCI: выполните инструкции в разделе "Развертывание Essbase из Marketplace для федерированных разделов", чтобы развернуть Essbase в пространстве OCI с соответствующим выбором федерированных разделов.
Пользователь DB, Администратор Essbase или Менеджер приложения Essbase: войдите в веб-интерфейс Essbase и создайте подключение к Autonomous Data Warehouse, как описано в разделе "Создание подключения для федерированных разделов".
Пользователь базы данных, Администратор Essbase или Менеджер приложения Essbase: создайте федерированный раздел, как описано в разделе "Создание федерированного раздела".
Пользователь OCI: в профиле пользователя в консоли OCI сгенерируйте и скопируйте токен аутентификации. Сообщите эти данные и свое имя пользователя Пользователю SSH.

См. раздел "Получение токена аутентификации".
Пользователь User: запустите сценарий подготовки загрузки данных, доступный в экземпляре Essbase в OCI. Сценарий нужно выполнить один раз для каждой схемы базы данных в Autonomous Data Warehouse.

Пример.
1. Переключитесь на пользователя oracle.
```
sudo su oracle
```
2. Перейдите к местоположению сценария.
```
cd /u01/vmtools/config/adwwb_dbms
```
3. Запустите сценарий.
```
./configure-dbms-writeback.sh
```
  Примечание.:
  Чтобы увидеть параметры сценария, запустите его с аргументом -h или --help. Синтаксис: ./configure-dbms-writeback.sh [--help | -h]
  
  Примечание.:
  При необходимости выполните сценарий с параметром vault. При использовании этого параметра сценарий получает учетные данные администратора БД из хранилища, получая туда доступ с помощью OCID, а не просит вас ввести пароль. Синтаксис: ./configure-dbms-writeback.sh [--vault | -V]
4. При запросе введите необходимые сведения:
  - Пароль администратора БД, если сценарий выполняется без параметра vault. Пароль — это защищенная информация, поэтому вы не увидите набранный текст в командной строке.
  - Имя пользователя и пароль пользователя БД. Пароль — это защищенная информация, поэтому вы не увидите набранный текст в командной строке.
  - Имя пользователя и токен аутентификации пользователя OCI. Введите полную строку идентификации пользователя. Чтобы найти эту строку, в консоли OCI нажмите на значок профиля в правом верхнем углу, чтобы открыть обзор профиля пользователя. Скопируйте всю строку, которая находится под словом Профиль и над словом Аренда.
Сценарий создает необходимые облачные учетные данные и сохраняет их в схеме базы данных. При перезапуске OCI, Essbase или приложения Essbase повторно запускать сценарий не нужно.

Теперь вы можете загружать через Essbase данные для обновления таблицы фактов Autonomous Data Warehouse.

Примечание.:

Вниманию пользователя SSH User: если токен аутентификации пользователя OCI, использованный в сценарии подготовки загрузки данных, больше не имеет доступа к сегменту объектного хранилища с каталогом Essbase, нужно найти другого пользователя OCI, соответствующего требованиям, которые указаны в разделе Типы пользователей в рабочем потоке подготовки загрузки данных, и повторить описанные выше шаги.

Другие замечания о загрузке данных федерированного раздела

Расположение файла исходных данных

Перед загрузкой данных в таблицу фактов через Essbase Oracle рекомендует загрузить файл данных на сервер Essbase. Загрузка данных на стороне клиента так же поддерживается, но занимает больше времени.

Сторонние инструменты загрузки данных (не Essbase)

Если не требуется загружать данные через Essbase в Autonomous Data Warehouse, можно использовать инструменты данных в автономной базе данных для загрузки данных в таблицу фактов и выполнения других задач управления. При этом необходимо убедиться, что схема куба и таблица фактов синхронизируются. См. Меры предосторожности при работе с метаданными в федерированных разделах.

Файлы данных в формате DBMS

Загрузка файлов экспорта данных в формате Essbase в куб федерированных разделов может занимать много времени. Для оптимизации загрузки данных используйте исходный файл в формате DBMS. Его можно создать с помощью команды расчета DATAEXPORT с параметром DataExportCSVFormat option. Файлы в формате загружаются быстрее, поскольку они соответствуют параметрам формата пакетов DBMS_CLOUD для исходных файлов.

Сводное измерение в таблице фактов и источник ввода при загрузке данных

Сводное измерение, используемое во входных файлах загрузки данных, должно быть тем же, что и в таблице фактов.

Например, в следующей таблице фактов сводное измерение — это измерение "Показатели" (Sales, COGS, Margin, и т. д.).

Таблица фактов с денормализованными данными и метаданными, отображаемая в SQL Developer, с заголовками столбцов "Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions" и "Ending Inventory."

Допустимый входной файл загрузки данных для этой таблицы фактов имеет такую же форму, поскольку у него то же сводное измерение. Пример (усечен):

"Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory"
"Jan","100-10","New York","Actual",678,271,407,94,51,0,145,262,2101,644,2067
"Feb","100-10","New York","Actual",645,258,387,90,51,1,142,245,2067,619,2041
"Mar","100-10","New York","Actual",675,270,405,94,51,1,146,259,2041,742,2108

Если сводное измерение файла исходных данных отличается от сводного измерения таблицы фактов, будет возвращена ошибка, и выполнение задания загрузки данных завершится.

Импорт из нескольких файлов в MaxL не поддерживается

Параллельный импорт данных из нескольких файлов с помощью инструкции import в MaxL с использованием подстановочных знаков не поддерживается для кубов федерированных разделов.