Расширение соединителя JDBC
Расширение ThingWorx JDBC предоставляет быстрое и простое решение, позволяющее администраторам ThingWorx развертывать стандартные драйверы JDBC, необходимые для поддержки сторонних баз данных, чтобы использовать их с вещью базы данных ThingWorx. Вещи базы данных позволяют разработчикам и архитекторам решений ThingWorx внедрять и использовать преимущества функциональности, предоставляемые базой данных в решении, развернутом в ThingWorx.
Политика поддержки
Чтобы использовать расширение ThingWorx JDBC, администраторы должны предоставить соответствующий драйвер JDBC для требуемой базы данных. Несмотря на то что компания PTC предприняла все необходимые меры, чтобы обеспечить общую функциональность и безопасность расширения соединителя JDBC, PTC не может подтвердить совместимость ThingWorx с любым конкретным драйвером JDBC; PTC также не будет обрабатывать запросы на техническую поддержку, связанные с такими драйверами или неподдерживаемыми базами данных.
Кроме того, PTC не предоставляет и не может подтвердить функциональность или безопасность сторонних драйверов JDBC, необходимых для использования расширения для неподдерживаемых поставщиков хранилища данных. PTC настоятельно рекомендует ознакомиться с рекомендациями по обеспечению безопасности расширений, прежде чем использовать сторонние драйверы с расширением JDBC.
Наконец, упомянутые выше драйверы JDBC предназначены только для использования с базы данных ThingWorx.
Обзор
Если расширение JDBC для базы данных не существует в ThingWorx, можно вручную добавить драйвер JDBC, загрузив и добавив файлы в следующее расположение: /Tomcat folder/webapps/Thingworx/WEB-INF/lib
После копирования драйверов необходимо перезапустить ThingWorx.
Во избежание перезапуска Tomcat можно скомпоновать и импортировать расширение базы данных, содержащее драйвер JDBC. Преимущество такого подхода в том, что вам не придется вручную загружать драйвер. Нагрузка класса обрабатывается автоматически, и это безопасное обновление, поэтому не нужно повторно развертывать драйвер при обновлении веб-приложения ThingWorx. Дополнительные сведения о создании расширения базы данных см. в следующих шагах.
Создание расширения JDBC для ThingWorx
Чтобы создать расширение JDBC, выполните следующие действия.
1. Получите расширение соединителя ThingWorx JDBC из support.ptc.com.
 |
Модель поддержки расширений ThingWorx недавно изменилась. Большинство расширений больше не будет доступно на странице загрузки. Дополнительные сведения см. в этой статье.
|
2. Загрузите JAR-файл драйвера JDBC для вашей конкретной реляционной базы данных, такой как Microsoft SQL Server или MySQL, с соответствующего официального сайта.
3. Перейдите в ThingWorx Composer.
4. Импортируйте расширение соединителя JDBC, загруженное на шаге 1.
5. Откройте мэшап JdbcCreator и щелкните Просмотр мэшапа.
6. Щелкните команду Выберите файл.
7. Выберите файл драйвера JDBC, загруженный на шаге 2.
8. Щелкните Выгрузить.
9. Щелкните Download Extension File, чтобы загрузить расширение.
10. Импортируйте ZIP-файл, загруженный на шаге 9, в ThingWorx Composer.
11. После импорта вы должны увидеть шаблон вещи с именем <JAR file name>Template.
12. Создайте новую вещь, используя созданный шаблон вещи.
13. Сконфигурируйте настройки JDBC для соединения с реляционной базой данных.
Имя поля | Описание |
|---|---|
Наименование класса драйверов JDBC | Зависит от используемого драйвера. |
Строка соединения JDBC | Определяет информацию, необходимую для подключения к базе данных. Форматирование строки соединения можно найти в файле connectionstrings.com. |
ConnectionValidationString | Простой запрос, который проверяет возвращаемые из базы данных значения (независимо от наименований выполняемых таблиц). |
Запросы и команды для базы данных
После настройки конфигурации можно создавать в сервисах запросы SQL и команды SQL для взаимодействия с подключенной базой данных.
Передача переменных
При построении запроса используйте [[Наименование параметра]] для подстановки параметров/переменных и <<замена строки>> для подстановки строк.
Пример
DELETE FROM <> WHERE (FieldName = '[[MatchName]]');
DELETE FROM << TableName >> WHERE ( FieldName = [[MatchNumber]]);
DELETE FROM << TableName >> WHERE ( FieldName = [[MatchNumber]]);
| | Чрезвычайно опасно использовать подстановку строки << ... >> из-за угрозы внедрения SQL-кода. Рекомендуется осмотрительно подходить к возможности использования этого метода передачи параметров. Однако, чтобы создать динамический набор запросов, необходимо передать имена таблиц в виде << Имя таблицы >>. Кроме того, если необходимо использовать предложение IN, требуется передавать набор в виде << Элемент1, Элемент2, Элемент3,>>. |