Перейти к основному содержимому Перейти к дополнительному содержимому

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

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

  • Установите необходимый driver на сервере со шлюзом движения данных

  • Предоставьте необходимые разрешения в источнике данных

  • Настройка коннектора источника данных

Настройка драйвера

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

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

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

Подготовка к установке

  • Убедитесь, что на сервере шлюза Перемещение данных установлена версия Python 3.6 или более поздняя.

    Python предустанавливается в большинстве дистрибутивов Linux. Чтобы проверить, какая версия Python установлена в системе, выполните следующую команду:

    python3 --version

Установка driver

Чтобы загрузить и установить driver, выполните следующие действия.

  1. На компьютере шлюза Перемещение данных измените рабочую папку на:

    opt/qlik/gateway/movement/drivers/bin

  2. Выполните следующую команду:

    Синтаксис:

    ./install oracle

    Если не удается загрузить driver (из-за ограничений доступа или технических проблем), появится сообщение с указанием места, откуда можно загрузить driver и куда его скопировать на компьютере шлюза Перемещение данных. После этого выполните команду install oracle еще раз.

    В противном случае откроется лицензионное соглашение с конечным пользователем driverа.

  3. Выполните одно из следующих действий:

    • Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
    • Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
    • Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.
  4. Затем выполните одно из следующих действий:

    • Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
    • Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.
    • Введите «v» и нажмите клавишу [Enter], чтобы снова открыть лицензионное соглашение для просмотра.

  5. Будет установлен driver.

Обновление driverа

Выполните команду обновления, если требуется удалить предыдущие версии driverа перед установкой предоставленной версии driverа.

Чтобы загрузить и обновить driver, выполните следующие действия.

  1. На компьютере шлюза Перемещение данных измените рабочую папку на:

    opt/qlik/gateway/movement/drivers/bin

  2. Выполните следующую команду:

    Синтаксис:

    ./update oracle

    Если не удается загрузить driver (из-за ограничений доступа или технических проблем), появится сообщение с указанием места, откуда можно загрузить driver и куда его скопировать на компьютере шлюза Перемещение данных. После этого выполните команду update oracle еще раз.

    В противном случае откроется лицензионное соглашение с конечным пользователем driverа.

  3. Выполните одно из следующих действий:

    • Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
    • Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
    • Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.
  4. Затем выполните одно из следующих действий:

    • Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
    • Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.
    • Введите «v» и нажмите клавишу [Enter], чтобы снова просмотреть лицензионное соглашение от начала.
  5. Будет удален старый driver и установлен новый driver.

Удаление driverа

Выполните команду удаления, если требуется удалить driver.

Чтобы удалить driver, выполните следующие действия.

  1. Остановите все задачи, использующие данный коннектор.

  2. На компьютере шлюза Перемещение данных измените рабочую папку на:

    opt/qlik/gateway/movement/drivers/bin

  3. Выполните следующую команду:

    Синтаксис:

    ./uninstall oracle

    driver будет удален.

Установка драйвера вручную

Установку driver вручную следует пытаться выполнить только в том случае, если автоматическая установка драйвера не завершилась успешно.

После установки Data Movement Gateway загрузите драйвер oracle-instantclient-basiclite-<version>.x86_64.rpm. Прямую ссылку для загрузки поддерживаемой версии можно найти в разделе binary-artifacts в /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. После завершения загрузки скопируйте RPM на компьютер Data Movement Gateway.

Затем на сервере Data Movement Gateway откройте приглашение оболочки и выполните действия, указанные ниже.

  1. Остановите службу Data Movement Gateway:

    sudo systemctl stop repagent

  2. Если нужно, подтвердите, что служба остановлена:

    sudo systemctl status repagent

  3. Статус должен быть следующим:

    Active: inactive (dead) since <timestamp> ago

  4. Установите драйвер (RPM).
  5. Дополнительно создайте символьную ссылку в каталоге $Oracle_Home\lib, если такая ссылка отсутствует в системе. Назовите ссылку libclntsh.so и свяжите ее с конкретной версией этого файла.

    lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

  6. Измените рабочий каталог на <Data Movement Gateway-Install-Dir>/bin и добавьте переменную среды LD_LIBRARY_PATH в каталог Oracle Instant Client, а также в каталог Data Movement Gatewaylib, скопировав местоположение драйвера в файл site_arep_login.sh:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

  7. При необходимости подтвердите, что местоположение драйвера было скопировано:

    cat site_arep_login.sh
  8. Запустите службу Data Movement Gateway.

    sudo systemctl start repagent

  9. При необходимости подтвердите, что служба запущена.

    sudo systemctl status repagent

    Статус должен быть следующим:

    Active: active (running) since <timestamp> ago

Предоставьте доступ к учетной записи Oracle

Предоставьте пользователю Data Movement Gateway доступ к учетной записи Oracle. Этот пользователь должен иметь права на чтение и запись в базу данных Oracle. Информацию по настройке доступа к учетной записи Oracle см. Необходимые разрешения.

Убедитесь, что режим ARCHIVELOG активен

Oracle может работать в двух разных режимах: ARCHIVELOG и NOARCHIVELOG. Чтобы использовать журналы Oracle с Data Movement Gateway, запустите базу данных в режиме ARCHIVELOG. Если журнал не настроен для режима ARCHIVELOG, выполните следующий запрос:

ALTER database ARCHIVELOG

Примечание. Если экземпляр базы данных Oracle не на Amazon RDS, необходимо выполнить другую команду. Для получения дополнительной информации см. Включение автоматического резервного копирования и Настройка архивирования

Настройка дополнительного ведения журнала

Дополнительное ведение журнала должно быть включено как на уровне базы данных Oracle, так и на уровне таблицы.

Примечание к информации

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

Проверка и включение дополнительного ведение журнала на уровне базы данных

  1. Выполните следующий запрос:

    SELECT name, value, description FROM v$parameter WHERE name = 'compatible';

    Запрос должен вернуть результат от GE to n.n.n, где n.n.n – версия базы данных Oracle (например, 10.0.0).

    Примечание к предупреждению

    Значение параметра должно соответствовать реальной версии базы данных.

  2. Выполните следующий запрос:

    SELECT supplemental_log_data_min FROM v$database;

    Запрос должен вернуть YES или IMPLICIT.

    Активируйте дополнительное ведение журнала, выполнив следующий запрос:

    ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

    Примечание к информации

    Если экземпляр базы данных Oracle находится на RDS, требуется выполнить другую команды. Для получения дополнительной информации см. Работа с Amazon RDS for Oracle.

Проверка и включение дополнительного ведения журнала на уровне таблицы

  1. Чтобы проверить, что дополнительное ведение журнала включено на уровне таблицы, выполните следующий запрос:

    Синтаксис:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';

    Пример:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';

  2. Чтобы включить дополнительное ведение журнала на уровне таблицы, выполните следующий запрос:

    Синтаксис:

    ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

    Пример:

    ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

См. также: Необходимые разрешения

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!