Расширенное управление каталогами

Страницу "Каталог" можно использовать в классическом представлении в Oracle Analytics для выполнения большинства задач управления каталогом.

Для выполнения дополнительных задач можно развернуть диспетчер каталогов на локальном компьютере с ОС Windows или Linux. Например, диспетчер каталогов позволяет создавать расширенные отчеты каталога и диагностировать проблемы каталога, просматривая базовый XML-код объектов каталога.

Разделы:

Развертывание диспетчера каталогов

Диспетчер каталогов развертывается на локальном компьютере с ОС Windows или Linux.

Предварительные условия

Для использования диспетчера каталогов с Oracle Analytics Cloud требуются действительные учетные данные пользователя. В частности, учетные данные пользователя в системе управления идентификацией Oracle Cloud, связанной с Oracle Analytics Cloud, с правами администратора в Oracle Analytics Cloud (то есть пользователь с ролью "Администратор сервиса BI").

Ваш экземпляр Oracle Analytics Cloud использует одну из этих систем управления идентификацией Oracle Cloud:
  • Oracle Identity Cloud Service (IDCS): если ваш экземпляр Oracle Analytics Cloud объединяется с Oracle Identity Cloud Service, вы должны подключиться с учетными данными пользователя Oracle Identity Cloud Service.
  • домены идентификации в системе управления идентификацией и доступом в Oracle Cloud Infrastructure (IAM): если ваш экземпляр Oracle Analytics Cloud использует домен идентификации IAM для управления идентификацией, вы должны подключиться с учетными данными пользователя домена идентификации.

Если вы не уверены, обратитесь к своему администратору облачного сервиса. См. раздел "О настройке пользователей и групп".

Если в Oracle Analytics Cloud используется внешний поставщик идентификационных данных, такой как Active Directory для единого входа (SSO), при попытке подключения с учетными данными пользователя SSO отображается сообщение "Connection failed 401: Unauthorized" (Ошибка подключения 401: несанкционированный доступ).

  1. Если вы еще не сделали этого, выгрузите Oracle Analytics Client Tools из Oracle Technology Network. См. раздел "Выгрузка и установка Oracle Analytics Client Tools".

    Если приложение Oracle Analytics Client Tools уже выгружено и установлено, шаг 1 можно пропустить.

  2. В Oracle Analytics перейдите на страницу Каталог в классическом представлении и скопируйте URL-адрес браузера. Например, https://myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com/ui/analytics/saw.dll?catalog.
    При входе в диспетчер каталогов используется часть этого URL-адреса.
  3. На компьютере с установленным Oracle Analytics Client Tools запустите диспетчер каталогов.
    • В Windows в меню "Пуск"нажмите Oracle Analytics Client Tools, а затем Диспетчер каталогов.
    • В Linux используйте эквивалентный пункт меню "Пуск".
  4. В диспетчере каталогов нажмите Файл, а затем Открыть каталог.
  5. Введите следующее:
    • Тип — выберите Онлайн.
    • URL — измените URL-адрес, скопированный в ходе выполнения шага 2. После имени хоста необходимо добавить analytics-ws/saw.dll.

      Например, если URL-адрес — https://myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com/ui/analytics/saw.dll?catalog, измените его на https://myoac-idabcd0efghj-ia.analytics.ocp.oraclecloud.com/analytics-ws/saw.dll

    • Пользователь и Пароль — введите учетные данные пользователя с полномочиями администратора.
    • Режим "Только просмотр" — рекомендуется выбрать этот вариант, чтобы избежать внесения изменений в каталог. Если требуется внести изменения, рекомендуется сначала заархивировать каталог, чтобы при необходимости его можно было восстановить.

Выгрузка и установка Oracle Analytics Client Tools

Скачайте и установите Oracle Analytics Client Tools, чтобы активировать удаленные подключения из инфопанелей отчетности и анализов. Кроме того, можно использовать инструмент администрирования моделей (один из клиентских инструментов, доступных для Microsoft Windows) для редактирования семантической модели (файл .rpd), которая не поддерживается средством семантического моделирования.

Oracle Analytics Client Tools устанавливается на компьютере под управлением ОС Windows или Linux.
  • В ОС Windows пакет программ устанавливает версии графического интерфейса Инструмента администрирования моделей и Диспетчера каталогов, а также служебные программы командной строки.
  • В Linux пакет программ устанавливает служебные программы командной строки runcat.sh и datamodel.sh.

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

Oracle обновляет инструменты Oracle Analytics Client Tools при каждом обновлении Oracle Analytics Cloud. Убедитесь, что используется последнее обновление Oracle Analytics Client Tools.
  1. Перейдите на страницу выгрузки для Oracle Analytics Client Tools.
  2. Нажмите на последнюю ссылку Обновление Oracle Analytics Client Tools <месяц, год>, чтобы открыть страницу Oracle Software Delivery Cloud.
  3. В меню Платформы нажмите стрелку вниз и выберите Все, затем кликните за пределами раскрывающегося списка или нажмите клавишу Enter.
  4. В столбце "Программное обеспечение" таблицы выберите пакет выгрузки для вашей платформы.
    • Для Windows выберите Oracle Analytics Client May2023-Win for (Microsoft Windows x64 (64-bit)), <Размер в МБ>.
    • Для Linux выберите Oracle Analytics Client May2023-Linux for (Linux x86-64), <Размер в МБ>.

    Убедитесь, что с остальных компонентов выбор снят (например, Data Gateway и Power BI Connector).

  5. Примите условия лицензионного соглашения Oracle Cloud Service.
  6. Нажмите Выгрузить, чтобы запустить Oracle Download Manager, и следуйте инструкциям на экране.
  7. После завершения выгрузки нажмите Открыть целевую папку.
  8. Извлеките установщик Oracle из выгруженного ZIP-файла и запустите его.

    Например, извлеките и запустите файл установщика oac_client-<update ID>-win64.exe и следуйте инструкциям на экране.

    Чтобы запустить инструменты в Windows, зайдите в меню "Пуск" Windows, нажмите Oracle Analytics Client Tools, а затем выберите название инструмента, который требуется использовать. Например, для редактирования семантической модели нажмите Инструмент администрирования моделей.

    В Linux используйте служебные программы командной строки runcat.sh и datamodel.sh. См. раздел "Использование Oracle Analytics Client Tools в Linux".

Создание отчетов для отображения данных каталога с помощью диспетчера каталогов

Можно создавать отчеты, чтобы отобразить данные каталога для объектов каталога. Отчет можно отобразить на экране или сохранить в файл. Например, можно создать отчет, в котором будет отображаться инструкция SQL, отправленная в Oracle Analytics для каждого объекта.

При создании отчета пустое поле экспортируется в виде символа табуляции. При создании отчета по умолчанию с символом табуляции в качестве разделителя полей два символа табуляции в файле отчета указывают на пустое поле.

  1. В диспетчере каталогов выберите верхнюю папку для каталога.
  2. В меню Инструменты выберите Создать отчет.
  3. Выберите тип объектов каталога, для которого требуется создать отчет.
  4. Чтобы удалить из отчета все совпадающие строки, установите флажок Различные.
  5. Укажите столбцы для отображения в отчете в списке "Столбцы в отчете". Кнопки со стрелками влево и вправо (< and >) используются для перемещения столбцов между списком "Доступные столбцы" и списком "Столбцы в отчете", а кнопки со знаками плюс и минус (+ и -) — для задания порядка отображения столбцов в отчете.
  6. Нажмите ОК.
  7. Повторяйте шаги с 4 по 7, пока в отчете не появятся соответствующие столбцы.
  8. Чтобы сохранить отчет в файл, в поле Сохранить отчет в укажите путь к файлу. Нажмите кнопку Обзор, чтобы открыть диалоговое окно "Сохранить как" и выбрать путь (если файл не существует, то он будет создан).
  9. Выберите Формат Excel, чтобы создать файл с расширением .tab, который можно импортировать в Microsoft Excel.
  10. Нажмите ОК.

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

Примеры использования отчетов

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

Можно, например:

  • Узнайте, какие информационные панели используют анализ. Создайте отчет информационной панели, включающий анализы, и выполните поиск анализа в этом отчете.

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

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

    Пример: "Рынки"."Регион" [фильтр, запрошенный]

  • Найдите списки управления доступом для объектов. Просматривая списки управления доступом в отчете, можно проверить, что доступ к объектам предоставлен соответствующим ролям с соответствующими разрешениями, например для чтения/записи. Например, чтобы отобразить списки управления доступом, укажите:

    ^biconsumer=RX:steve=F, где символ вставки (^) указывает на роль приложения.

Просмотр объектов каталога в XML

В диспетчере каталогов можно просмотреть XML-описание объектов каталога, таких как анализы, информационные панели, фильтры и т. д.

  1. В диспетчере каталогов перейдите к объекту.

  2. Правой кнопкой мыши нажмите объект в столбце "Имя" и выберите Свойства.

  3. Нажмите Редактировать XML.

  4. По завершении просмотра XML-определения нажмите Отмена.

  5. Нажмите кнопку ОК в диалоговом окне Свойства.

На иллюстрации показан пример XML- кода в диспетчере каталогов для некоторого объекта.

Описание GUID-0D08A070-1A63-4A4E-B757-CF836EA21A8A-default.gif ниже
.gif

Редактирование объектов каталога в XML

В диспетчере каталогов можно редактировать XML-описание объектов каталога, таких как анализы, информационные панели, фильтры и т. д.

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

  1. В диспетчере каталогов перейдите к объекту, который требуется отредактировать.
  2. Правой кнопкой мыши нажмите объект в столбце "Имя" и выберите Свойства.Описание GUID-0D08A070-1A63-4A4E-B757-CF836EA21A8A-default.gif ниже
    .gif
  3. Нажмите Редактировать XML, а затем Редактировать.
  4. Внесите изменения в область XML-код объекта.
  5. Нажмите кнопку ОК в диалоговом окне Редактировать XML.
  6. Нажмите кнопку ОК в диалоговом окне Свойства.

Поиск и замена текста каталога с помощью диспетчера каталогов

Можно выполнять поиск определенного текста в каталоге и заменять его другим текстом с помощью диспетчера каталогов.

В частности, можно выполнять поиск и замену указанных ниже элементов.

  • Простая текстовая строка — с помощью диалогового окна, как описано в разделе Поиск и замена простой текстовой строки каталога.

    Например, предположим, что объект содержит строку "My Misspeled Wirds". С помощью диспетчера каталогов можно выполнить поиск и замену этой строки правильным текстом "My Misspelled Words".

  • Множественные или сложные текстовые строки — одновременно, с использованием файла XML, как описано в разделе Поиск и замена нескольких текстовых строк каталога.

    Например, предположим, что администратор переименовывает рабочую книгу, предметную область, таблицу или столбец. Таблицу "Sales" можно переименовать в "MySales". С помощью диспетчера каталогов можно выполнить поиск и замену всех видов использования этого объекта в каталоге.

Поиск и замена простой текстовой строки каталога

Можно выполнять поиск простой текстовой строки в каталоге и заменять ее другим текстом.

  1. В диспетчере каталогов откройте нужный каталог.
  2. В меню Инструменты выберите Поиск и замена XML.
  3. В поле Старый текст введите текстовую строку для поиска.
  4. В поле Заменить на введите текст для замены.
  5. Чтобы при поиске можно было вводить буквы в любом регистре, снимите флажок С учетом регистра .
  6. Нажмите ОК.

Поиск и замена нескольких текстовых строк каталога

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

Формат файла XML для поиска и замены текстовых строк

В файле XML для поиска и замены используется элемент действия для идентификации каждой текстовой строки.

Элементы действия содержатся в элементе команд.

  • command — указание текста для замены. Допустимое значение:

    • textReplace — замена всего текста, соответствующего элементу в файле XML, например имени столбца.

  • oldValue — указание текстовой строки для поиска.

    Если указан этот атрибут для команды textReplace для поиска и замены файла XML, необходимо использовать полный синтаксис Java regex, который не похож на обычную строку. При замене строки необходимо выполнить указанные ниже действия.

    • Замените специальные символы Java regex, такие как квадратные скобки, круглые скобки, знаки доллара и знаки вставки.
    • Замените специальные символы строк, такие как обратные косые черты и кавычки.
    • Замените специальные символы HTML, такие как кавычки и амперсады.

  • newValue — указание текста для замены.

  • ignoreCase — игнорирование регистра при установке значения true, но при установке значения false регистр учитывается. Значение по умолчанию: false.

Образцы строк, которые будут использоваться с синтаксисом Regex в критериях поиска

В критериях поиска можно использовать образцы строк:

Полный синтаксис Java regex описан в следующем документе:

java.util.regex: Class Pattern (java.util.regex: шаблон класса)

Используйте эти образцы строк с синтаксисом regex в критериях поиска.

Введенная строка поиска Результат

a

Добавление подстановочных знаков до и после строки поиска (например, *a*), что позволяет выполнять поиск с результатами, содержащими символ "a".

^a

Добавление подстановочного знака после строки поиска (например, a*), что позволяет выполнять поиск с результатами, начинающимися с символа "a".

a$

Добавление подстановочного знака перед строкой поиска (например, *a ), что позволяет выполнять поиск с результатами, заканчивающимися символом "a".

a\*

Поиск в явном виде строк, содержащих символ, за которым следует звездочка (*), например "a*".

?

Использование вопросительного знака (?) с символом и звездочкой (*), в результате чего возвращается ноль (0) или большее число вхождений символа. Например, при вводе ?a* возвращается ноль или более вхождений символа "a".

Пример файла XML для поиска и замены текстовых строк

Ниже приведен частичный пример файла XML для поиска и замены текстовой строки.

<?xml version="1.0" encoding="utf-8"?>
<actions>
<action command="textReplace" oldValue="boots" newValue="HoleyShoes" ignoreCase="true"/>
</actions>

Поиск и замена нескольких текстовых строк каталога

Выполните следующие действия для поиска и замены нескольких текстовых строк каталога одновременно.

  1. Создайте файл XML для поиска и замены нескольких текстовых строк.
  2. В диспетчере каталогов откройте нужный каталог.
  3. В меню Инструменты выберите Поиск и замена XML.
  4. В поле Импортировать из файла введите путь или нажмите Обзор, чтобы указать файл XML, созданный в ходе выполнения шага 1.
  5. Чтобы при поиске учитывался регистр, установите флажок С учетом регистра .
  6. Нажмите ОК.