Предварительные требования
Перед промежуточным сохранением или репликацией данных необходимо выполнить следующие предварительные требования:
-
Установите необходимый driver на сервере Data Movement Gateway
Примечание к информацииЭто требуется, только если выбрана работа с Data Movement Gateway. Для получения информации о преимуществах Data Movement Gateway и о том, когда его необходимо использовать, см. раздел Qlik Data Gateway — Data Movement.
-
Предоставьте необходимые разрешения в источнике данных
-
Настройка коннектора источника данных
Настройка драйвера
driver можно установить с помощью программы для установки драйверов (рекомендуется) или вручную. Ручную установку следует выполнять только в том маловероятном случае, если возникла проблема с программой для установки драйверов.
Использование программы для установки драйверов для установки драйвера
В этом разделе описывается процедура установки необходимого driverа. Она включает выполнение скрипта, который автоматически загружает, устанавливает и настраивает необходимый driver. Также можно выполнять скрипты для обновления и удаления driverа по необходимости.
Подготовка к установке
-
Убедитесь, что на сервере шлюза Перемещение данных установлена версия Python 3.6 или более поздняя.
Python предустанавливается в большинстве дистрибутивов Linux. Чтобы проверить, какая версия Python установлена в системе, выполните следующую команду:
python3 --version
Установка driver
Чтобы загрузить и установить driver, выполните следующие действия.
-
На компьютере шлюза Перемещение данных измените рабочую папку на:
opt/qlik/gateway/movement/drivers/bin
-
Выполните следующую команду:
Синтаксис:
./install oracle
Если не удается загрузить driver (из-за ограничений доступа или технических проблем), появится сообщение с указанием места, откуда можно загрузить driver и куда его скопировать на компьютере шлюза Перемещение данных. После этого выполните команду install oracle еще раз.
В противном случае откроется лицензионное соглашение с конечным пользователем driverа.
-
Выполните одно из следующих действий:
- Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
- Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
- Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.
-
Затем выполните одно из следующих действий:
- Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
- Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.
-
Введите «v» и нажмите клавишу [Enter], чтобы снова открыть лицензионное соглашение для просмотра.
Будет установлен driver.
Обновление driverа
Выполните команду обновления, если требуется удалить предыдущие версии driverа перед установкой предоставленной версии driverа.
Чтобы загрузить и обновить driver, выполните следующие действия.
-
На компьютере шлюза Перемещение данных измените рабочую папку на:
opt/qlik/gateway/movement/drivers/bin
-
Выполните следующую команду:
Синтаксис:
./update oracle
Если не удается загрузить driver (из-за ограничений доступа или технических проблем), появится сообщение с указанием места, откуда можно загрузить driver и куда его скопировать на компьютере шлюза Перемещение данных. После этого выполните команду update oracle еще раз.
В противном случае откроется лицензионное соглашение с конечным пользователем driverа.
-
Выполните одно из следующих действий:
- Нажмите клавишу [Enter] несколько раз, чтобы медленно прокрутить лицензионное соглашение.
- Нажимайте клавишу «Пробел» несколько раз, чтобы быстро прокрутить лицензионное соглашение.
- Нажмите клавишу «q», чтобы закрыть текст лицензионного соглашения и перейти к шагу принятия/отклонения.
-
Затем выполните одно из следующих действий:
- Введите «y» и нажмите клавишу [Enter], чтобы принять лицензионное соглашение и запустить установку.
- Введите «n» и нажмите клавишу [Enter], чтобы отклонить лицензионное соглашение и отменить установку.
- Введите «v» и нажмите клавишу [Enter], чтобы снова просмотреть лицензионное соглашение от начала.
Будет удален старый driver и установлен новый driver.
Удаление driverа
Выполните команду удаления, если требуется удалить driver.
Чтобы удалить driver, выполните следующие действия.
-
Остановите все задачи, использующие данный коннектор.
-
На компьютере шлюза Перемещение данных измените рабочую папку на:
opt/qlik/gateway/movement/drivers/bin
-
Выполните следующую команду:
Синтаксис:
./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 откройте приглашение оболочки и выполните действия, указанные ниже.
-
Остановите службу Data Movement Gateway:
sudo systemctl stop repagent
-
Если нужно, подтвердите, что служба остановлена:
sudo systemctl status repagent
- Установите драйвер (RPM).
-
Дополнительно создайте символьную ссылку в каталоге $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
-
Измените рабочий каталог на <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
-
При необходимости подтвердите, что местоположение драйвера было скопировано:
cat site_arep_login.sh
-
Запустите службу Data Movement Gateway.
sudo systemctl start repagent
-
При необходимости подтвердите, что служба запущена.
sudo systemctl status repagent
Статус должен быть следующим:
Active: active (running) since <timestamp> ago
Статус должен быть следующим:
Active: inactive (dead) 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 (а не в резервном), как описано ниже.
Проверка и включение дополнительного ведение журнала на уровне базы данных
-
Выполните следующий запрос:
SELECT name, value, description FROM v$parameter WHERE name = 'compatible';
Запрос должен вернуть результат от GE to n.n.n, где n.n.n – версия базы данных Oracle (например, 10.0.0).
Примечание к предупреждениюЗначение параметра должно соответствовать реальной версии базы данных.
-
Выполните следующий запрос:
SELECT supplemental_log_data_min FROM v$database;
Запрос должен вернуть YES или IMPLICIT.
Активируйте дополнительное ведение журнала, выполнив следующий запрос:
ALTER DATABASE ADD SUPPLEMENTAL LOG DATA
Примечание к информацииЕсли экземпляр базы данных Oracle находится на RDS, требуется выполнить другую команды. Для получения дополнительной информации см. Работа с Amazon RDS for Oracle.
Проверка и включение дополнительного ведения журнала на уровне таблицы
-
Чтобы проверить, что дополнительное ведение журнала включено на уровне таблицы, выполните следующий запрос:
Синтаксис:
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';
-
Чтобы включить дополнительное ведение журнала на уровне таблицы, выполните следующий запрос:
Синтаксис:
ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
Пример:
ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
См. также: Необходимые разрешения