Расширение "Оценка миграции базы данных для Oracle"

Примечание.

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

Оценка миграции базы данных для расширения Oracle в Azure Data Studio помогает оценить рабочую нагрузку Oracle для миграции в SQL Azure и База данных Azure для PostgreSQL. Расширение определяет соответствующий целевой объект SQL Azure или PostgreSQL с рекомендациями по правильному размеру и способом сложной миграции.

Необходимые компоненты

Установка расширения Azure Data Studio

Выполните следующие действия, чтобы установить расширение Database Migration Assessment for Oracle в Azure Data Studio.

  1. Откройте диспетчер расширений в Azure Data Studio. Для этого нажмите значок расширений или выберите пункт Расширения в меню "Вид".

  2. Введите Oracle в строке поиска.

  3. Выберите расширение Оценка миграции базы данных для Oracle и просмотрите сведения о нем.

  4. Выберите Установить.

    Снимок экрана: установка расширения.

Настройка параметров расширения

После установки расширения можно настроить несколько параметров расширения.

  1. Перейдите к расширениям и выберите "Оценка миграции базы данных для Oracle", щелкните значок "Управление параметрами" и выберите параметры расширения.

    Снимок экрана: расширение.

  2. В разделе "Параметры расширения" измените все параметры расширения в соответствии с требованиями среды.

    Снимок экрана: параметры свойств расширения.

    Примечание.

    Чтобы выполнить оценку кода Oracle в PostgreSQL, путь к домашнему путь клиента Oracle и путь установки Ora2Pg являются обязательными параметрами.

Запуск оценки

После установки расширения оценки следующим шагом является подключение к базе данных Oracle, сбор метаданных из экземпляра Oracle и создание отчета об оценке.

  1. Перейдите к значку подключений в строке меню.

    Снимок экрана: строка меню подключений.

  2. В разделе Сведения о подключении заполните поля.

    1. В поле "Тип подключения" выберите Oracle.
    2. В поле Источник данных введите имя и экземпляр сервера Oracle.
      1. Также можно указать имя TNS. (Убедитесь, что ORACLE_HOME переменная среды задана и TNSNAMES.ORA файл находится в <ORACLE_HOME>/network/admin folder.)
      2. Для базы данных контейнера можно подключить корневую базу данных контейнера с помощью идентификатора службы CDB или использовать имя подключаемой службы базы данных для подключения к подключаемой базе данных.
    3. Укажите имя пользователя базы данных в поле идентификатора пользователя.
    4. Укажите пароль базы данных в поле "Пароль ".

    Снимок экрана: сведения о подключении.

  3. Нажмите Подключиться.

  4. Теперь новое подключение появится в меню сведений о подключении.

  5. Щелкните правой кнопкой мыши подключение Oracle и выберите пункт Управление.

    Снимок экрана: экран

  6. Выберите Оценка миграции.

    Снимок экрана: экран базы данных оценки миграции.

  7. Выберите Выполнить новую оценку.

    Снимок экрана: экран запуска новой оценки.

  8. Укажите сведения об оценке.

    1. В поле "Имя оценки" введите заголовок, напримерdemo1.
    2. Введите параметры оценки.
      1. Введите целевую базу данных миграции в поле "Целевая платформа ". В настоящее время она поддерживает SQL Azure и PostgreSQL в качестве целевых объектов.

        Примечание.

        Целевой объект PostgreSQL находится в предварительной версии. Этот целевой параметр будет прекращен. Необходимо экспортировать все предыдущие оценки.

      2. В разделе сбора данных о производительности выберите "Выполнить сбор данных о производительности" в базе данных Oracle (подключено) или добавьте отчет AWR.

        Рекомендуется использовать подключенный параметр, если вы используете это средство во время пиковой или реалистичной нагрузки. В противном случае предоставьте отчеты AWR, созданные в прошлом для рекомендаций по производительности и размерам.

        Примечание.

        Параметр оценки отчета AWR не включен для подключаемой базы данных.

      3. Введите значение умножения в поле коэффициента масштабирования.

        • Если рекомендуемый номер SKU должен учитывать другие пиковые нагрузки, умножение коэффициента масштабирования должно быть больше 1. Например, при загрузке, сезонном использовании и будущем планировании емкости. При переносе частичной рабочей нагрузки схемы Oracle умножение должно быть меньше 1.
      4. В поле Процентиль использования введите значение процентиля для определения размера целевого объекта Azure.

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

    Снимок экрана: экран сведений об оценке.

  9. Существует два типа оценки:

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

    • Оценка кода. Оценка кода выполняет подробную оценку объектов схемы Oracle, а затем предлагает общую готовность объектов кода с "готовой", "необходимо проверить" и "не готов" типы объектов на детализированном уровне и связанные с ней часы преобразования с более высокой точностью.

      Примечание.

      Расширение использует преобразователь схемы Ora2Pg с открытым кодом для оценки кода.

      Если клиент Oracle и/или Ora2Pg не установлены на том же компьютере, что и Azure Data Studio, вручную установите их или используйте скрипт установки Ora2Pg из GitHub.

      Если установлен клиент Oracle и Ora2Pg, убедитесь, что путь к домашнему путь клиента Oracle и путь установки Ora2Pg обновляются в параметрах расширения.

      • При выборе оценки кода для сценариев SQL выберите схемы, к которым вы хотите получить доступ к Oracle для преобразования и миграции SQL. По умолчанию для оценки выбираются все подходящие схемы.
  10. Выберите "Выполнить проверку", чтобы выполнить предварительные требования и различные правила проверки , связанные с разрешениями безопасности, параметрами конфигурации и т. д. Если проверка завершается ошибкой, необходимо исправить ошибки, чтобы продолжить.

  11. При успешной проверке можно выбрать команду "Выполнить оценку".

  12. Теперь вы увидите новую оценку в разделе "Последние пять оценок".

    Снимок экрана: параметр для имени оценки.

  13. Выберите ссылку оценки, чтобы просмотреть страницу сведений об оценке. Можно просмотреть последнее состояние оценки.

    Снимок экрана: последнее состояние оценки.

  14. Выберите "Обновить" или дождитесь завершения оценки. По умолчанию страница состояния оценки обновляется каждые 15 секунд. В состоянии отображается одно из четырех состояний: успех, сбой, ход выполнения или отмена.

Просмотр оценки

После завершения оценки создается консолидированная выходная карта с помощью карточек для каждого целевого объекта SQL Azure: SQL Server в Azure Виртуальные машины, База данных SQL Azure и Управляемый экземпляр SQL Azure или База данных Azure для PostgreSQL — гибкий сервер.

Снимок экрана: параметр оценки представления.

Каждая карточка содержит несколько разделов. На карточке показана общая возможность миграции в целевой объект. Вы можете детализируете различные рабочие нагрузки в различных категориях сложности миграции:

  • Раздел совместимости компонентов предоставляет результат проверки компонентов.
  • Рекомендация по SKU обеспечивает правильный выбор размера целевого объекта.
  • Оценка кода обеспечивает сложность кода объектов базы данных.

При выборе сведений о представлении отчета сначала отображается сводка по оценке.

Снимок экрана: сводка по оценке.

Если выбран целевой объект Database for Azure PostgreSQL, вкладка "Сведения о базе данных" или вкладка "Оценка кода" отображается на основе выбора типа оценки.

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

Снимок экрана: разбивка по схеме.

Эта оценка основана на статистической модели, которая применяется к количеству объектов, строкам кода, включенным функциям и размеру базы данных. Для более точной оценки преобразования кода используйте оценку кода.

Примечание.

Из оценки рабочей нагрузки исключены следующие встроенные схемы или схемы Oracle:

APEXORDSYS, APPQOSSYSAUDSYSCSMIGCTXSYSDBMS_PRIVILEGE_CAPTUREDBSFWUSERDBSNMPDIPDMSYSDVFDVSYSEXFSYSFLOW_GSMADMIN_INTERNALLBACSYSMDDATAMDSYSMGDSYSMGMT_VIEWMTMSYSODMODM_MTROJVMSYSOLAPSYSORACLE_OCMORDDATAORDPLUGINSOSE$HTTP$ADMINOUTLNOWBSYSOWBSYS_AUDITPERFSTATSDESI_INFORMTN_SCHEMASPATIAL_CSW_ADMIN_USRSPATIAL_WFS_ADMIN_USRSQLTXPLAINSYSSYSMANSYSTEMTRACESRVTSMSYSWEBSYSWKPROXYWKSYSWK_PROXYWK_TESTWMSYSXDBXS$NULL

Рекомендация по номеру SKU предоставляет следующие элементы:

  • Подходящий целевой объект Azure.

  • Уровень служб.

  • Пороговые значения метрик используются для предоставления рекомендуемого номера SKU.

    Снимок экрана: рекомендации по номеру SKU.

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

Примечание.

Если функция автоматического репозитория рабочей нагрузки (AWR) включена в экземпляре Oracle, рекомендуется использовать DBA_HIST_ представления для сбора метаданных метрик производительности. В противном случае рекомендуется использовать конфигурацию сервера и другие сведения о системном представлении для изменения размера целевого объекта SQL Azure.

Совместимость кода (только для целевых объектов PostgreSQL) содержит сводку объектов схемы, которые можно преобразовать в целевой объект Azure. Отчет предоставляет разрыв объектов, которые могут быть преобразованы автоматически, готовы к условиям и должны быть исправлены и преобразованы вручную.

Снимок экрана: отчет о совместимости кода.

В отчете показано общее количество объектов и часов усилий преобразования, необходимых для переноса кода в базу данных Azure PostgreSQL. Графическое изображение обеспечивает разрыв для каждого типа объекта схемы, например таблиц, представлений и кластеров. Усилия классифицируются как "Готово - автоматически преобразованы", "Требуется проверка" и "Не готово - требуется ручное преобразование".

Детализация для разделов "Не готово" и "Требует проверки" содержит список задач исправления и часов усилий для каждой задачи.

Снимок экрана: задача исправления.

Оценка функций предоставляет Oracle целевому объекту данных Azure и усилия, необходимые для переноса этих возможностей в целевой объект Azure.

Снимок экрана: сопоставленная оценка.

Вы можете скачать отчет для автономного просмотра, выбрав "Скачать объединенные отчеты " или "Скачать отдельные отчеты".

Снимок экрана: параметр отчета об оценке загрузки.

Также можно отменить текущую оценку, удалить оценку и переместить оценки в другой каталог.

Изменение пути оценки

  1. Перейдите в marketplace расширения и найдите оценку миграции базы данных для Oracle.
  2. Щелкните значок "Управление" и выберите параметры расширений.
  3. Укажите новый путь оценки в разделе "Оценка Oracle: путь оценки".

Снимок экрана: параметр

Устранение неполадок

Журналы

Расширение ведет журналы ошибок, предупреждений и другие диагностические журналы, которые хранятся в каталоге журналов по умолчанию:

  • Для Windows — C:\Users\<username>.dmaoracle\logs\.
  • Linux — ~/.dmaoracle/logs.
  • macOS: /Users/<username>/.dmaoracle/logs

Примечание.

По умолчанию расширение сохраняет последние семь файлов журналов.

Чтобы изменить каталог журнала, обновите LogDirectory свойство в файле параметров расширения.

Операционная система Путь
Windows C:\Users\<username>\.azuredatastudio\extensions\microsoft.azuredatastudio-dma-oracle-<VersionNumber>\bin\service\Properties\ConfigSettings\extension-settings.json
Linux ~/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json
macOS /Users/<username>/.azuredatastudio/extensions/microsoft.azuredatastudio-dma-oracle-<VersionNumber>/<VersionNumber>/bin/service/Properties/ConfigSettings/extension-settings.json

Дополнительные сведения об устранении неполадок см . в статье "Устранение неполадок с оценкой миграции базы данных" для ошибок расширения Oracle.

Известные проблемы и ограничения

  • Указанный путь не существует.

    Причина: отсутствуют файлы или отсутствуют разрешения на папку оценки.

    Возможное решение:

    • Пользователь имеет разрешение на чтение и запись в папке оценки.
    • Если отсутствует файл или папка, удалите оценку и создайте новую оценку.
  • Обнаружено исключение времени ожидания подключения при взаимодействии с Oracle.

    Причина. Не удалось подключиться к экземпляру Oracle.

    Возможное решение:

    • Проверьте, блокируют ли правила брандмауэра порт прослушивания Oracle.
    • Запустите tnsping и просмотрите, разрешен ли идентификатор службы.

Обратитесь в корпорацию Майкрософт за помощью

Если вам нужна дополнительная помощь от Корпорации Майкрософт, обратитесь к @dmasupport. Чтобы ускорить обходное решение, можно подключить журналы из каталога журналов по умолчанию.