Посібник користувача SARTORIUS ODBC SimApi

ODBC SimApi

Технічні характеристики

  • Продукт: ODBC SimApi
  • Виробник: Sartorius Stedim Data Analytics
  • Підключення: ODBC (підключення до відкритої бази даних)
  • Сумісність: працює з Umetrics Suite і зовнішніми даними
    джерела

Інструкція з використання продукту

передумови

Перед використанням ODBC SimApi переконайтеся, що:

  • Майте структуроване джерело даних ODBC, як реляційне
    бази даних
  • Джерело даних має поводитися як хороший історик даних процесу
  • Переконайтеся, що в джерелі даних немає затримок отримання даних
  • Дані в джерелі повинні відображати поточний стан
    процес
  • Джерело даних має швидко відповідати на запити в режимі реального часу
    моніторинг

Встановлення та налаштування

  1. Установіть програмне забезпечення ODBC SimApi у вашій системі.
  2. Налаштуйте джерело даних ODBC для підключення до потрібного
    бази даних.
  3. Зверніться до посібника користувача, щоб отримати детальні інструкції з налаштування
    про використання програмного забезпечення.

Часті запитання (FAQ)

З: Що таке SimApi?

В: SimApi — це з’єднання між Umetrics Suite і
зовнішні джерела даних, зокрема підключення до джерел даних ODBC
як реляційні бази даних.

З: Як я можу використовувати функцію ідентифікатора партії синтетичного процесу?

A: Щоб використовувати функцію ідентифікатора партії синтетичного процесу, налаштуйте
Ідентифікатор партії tag бути пакетним ідентифікатором пакетного вузла на
Сторінка умов виконання в SIMCA-online.

З: Чи можна використовувати ODBC SimApi з одночасними пакетами?

В: Функція ідентифікатора партії синтетичного процесу не працює
одночасні партії. У пакеті має бути активним лише один пакет
вузол у будь-який момент часу.

Loading PDF…
Download PDF

Помилка! Використовуйте вкладку «Головна», щоб застосувати «Заголовок_1» («Заголовки») до тексту, який має відображатися тут.
Посібник користувача ODBC SimApi
24 жовтня 2024 р

вступ
Зміст
1 Вступ…………………………………………………………………………………………………………….. 3
1.1 Особливості …………………………………………………………………………………………………………………………………………………………………….. 3 1.1.1 Ідентифікатор партії синтетичного процесу …………………………………………………………………………………………………………………………. 4 1.1.2 Ідентифікатор партії згенерованого синтетичного процесу tags; по одному на унікальний ідентифікатор пристрою ………………………………………….. 4 1.1.3 Пакетний вузол із підтримкою фільтрації …………………………………………………………………………………………………………….. 4 1.1.4 Пакетні дані Views………………………………………………………………………………………………………………………………………… 5 1.1.5 Дискретний дані………………………………………………………………………………………………………………………………………………… 6 1.1.6 Одночасний SimApi Доступ…………………………………………………………………………………………………………………………. 7
2 Передумови ………………………………………………………………………………………………………… 7
2.1 Вимоги до структури бази даних ………………………………………………. 7 2.2 Розгляд мережі ……………………………………………………………………………………………………………………………………. 7 2.3 Драйвери ODBC…………………………………………………………………………………………………………………………………………………….. 8 2.4 Автентифікація бази даних …………………………………………………………………………………………………………………………………………… 8 2.5 Visual C++ Redistributable …………………………………………………………………………………………………………………………………….. 8
3 Встановлення та налаштування …………………………………………………………………………………………….. 9
3.1 Configuring an ODBC data source connection in Windows for use by the SimApi ………………………………… 9 3.2 Selecting between two ways to access process data……………………………………………………………………………………… 10 3.3 XML configuration file і журнал file розташування………………………………………………………………………………………………….. 11 3.4 Глобальні налаштування з’єднання ……………………………………………………………………………………………………………………………………. 11 3.5 Прямий режим для безперервного/процесу views …………………………………………………………………………………………………………. 11 3.6 Пошук View Режим безперервний/процес viewс………………………………………………………………………………………….. 12
3.6.1 PDB views і HDB views ……………………………………………………………………………………………………………………….. 13 3.7 Пакет вузол………………………………………………………………………………………………………………………………………………………….. 14 3.8 Пакетні дані Views ………………………………………………………………………………………………………………………………………………………. 15
3.8.1 Екземпляр даних синтетичної партії tags …………………………………………………………………………………………………….. 16 3.8.2 Ідентифікатор партії синтетичного процесу tags відфільтровано за значеннями стовпців………………………………………………………….. 16 3.9 Дискретні вузли ……………………………………………………………………………………………………………………………………………………… 16 3.9.1 Дискретні Tag Визначення View……………………………………………………………………………………………………………………. 17 3.9.2 Окремі дані, які бачить SIMCA-online ………………………………………………………………………………………………. 18 3.10 Деякі зауваження щодо SIMCA-online Write Back ……………………………………………………………………………………………………… 18 3.11 Конфігурація XML File …………………………………………………………………………………………………………………………………… ……… 19
4 Підтримка ……………………………………………………………………………………………………………..22

вступ
1 Вступ
Цей документ є посібником користувача для ODBC SimApi від Sartorius Stedim Data Analytics.
SimApi — це зв’язок між Umetrics Suite і зовнішніми джерелами даних.
Цей SimApi підключається до джерела даних ODBC (Open Database Connectivity), наприклад до реляційної бази даних. Джерело даних має бути структуроване, як описано в цьому документі.
Для використання SimApi в SIMCA-online, який використовується для моніторингу в режимі реального часу, важливо, щоб джерело даних поводилося як хороший історик даних процесу: у джерелі даних не повинно бути затримок отримання даних: поточні дані в джерелі даних повинні відображати поточний стан процесу, щоб добре працювати в SIMCA-online. Джерело даних також має швидко реагувати на запити даних, щоб сервер міг не відставати від виконання проектів у реальному часі.
Детальний список змін у різних версіях цього SimApi див. у файлі Version Info.txt file який постачається разом із установкою.
Цей SimApi може використовуватися SIMCA або SIMCA-online або іншим програмним забезпеченням, яке може використовувати SimApis.
Для отримання додаткової інформації про доступний SimApis відвідайте sartorius.com/umetrics-simapi.
1.1 Особливості
· Підтримує діалекти SQL для Microsoft SQL Server, Oracle, Microsoft Access, IBM db2, Denodo, MySQL, PostgreSQL і стандартного SQL.
· Автентифікація рядка підключення ODBC за допомогою наданого імені користувача та пароля, автентифікації Windows або облікових даних, указаних у підключенні ODBC у джерелах даних ODBC Windows.
· Доступ до кількох таблиць або views для зчитування даних безперервного процесу (поточних і історичних). Два режими; Пошук view і прямий режим (читання безпосередньо з бази даних view).
· Кілька пакетних вузлів, що визначають час життя пакетів. Містить один рядок для кожної партії з часом початку та закінчення.
· Читання пакетних даних (пакетних умов) із додаткових стовпців у пакетних вузлах або з пакетних даних Viewякі зберігають умови партії у вузькій таблиці лише з двома стовпцями (tag назва та значення).
· Підтримка дискретних даних: читання дискретних даних одного або кількох вузлів, які можуть мати різні імена стовпців. · Зворотний запис із SIMCA-online: історичні дані процесу та дані партії. · Працює з числовими даними або текстовими (якісними) даними. · Синтетичний ідентифікатор партії процесу у пакетному вузлі, який можна використовувати у виконанні фази SIMCA-online
умови, якщо дані процесу не мають ідентифікатора партії tag. · Ідентифікатор партії синтетичного процесу tags у пакетних даних Views, які можна відфільтрувати за іншими стовпцями. Можна використовувати
у фазових умовах, коли ідентифікатор партії інакше недоступний у даних процесу. · Пакетні вузли з підтримкою фільтрації. Підтримка фільтрації корисна, якщо у вас є пакетний вузол із головним
список партій для всієї вашої системи, але хочете мати можливість фільтрувати його, щоб відображати лише партії в частині системи (наприклад, партії, що працюють в одному пристрої, або партію певного матеріалу чи типу). · Екземпляр даних синтетичної партії tags обробляти кілька вимірювань даних партії на партію. Корисно, якщо ви хочете мати можливість створювати моделі рівня партії, які використовують два або більше вимірювань кожної змінної умов партії на партію. · Кілька екземплярів ODBC SimApi, які можна налаштувати та використовувати з того самого сервера SIMCA-online. Це дозволяє підключатися до кількох баз даних на одному або кількох серверах баз даних. · Стійкість підключення SimApi автоматично повторно підключається до джерела даних після його відключення (наприклад,ampпісля збою мережі). · Потокобезпечний одночасний доступ. SimApi працює з функцією одночасного доступу SimApi, представленою на сервері SIMCA-online 18, яка може покращити продуктивність і швидкість реагування. · Підтримує дати, що зберігаються як місцевий час або UTC у базі даних.
Кожну функцію (безперервну, пакетну або дискретну) можна налаштувати та використовувати окремо, і всі функції є необов’язковими. Вам не потрібно налаштовувати функції, якщо вони вам не потрібні.

вступ
1.1.1 Ідентифікатор партії синтетичного процесу
У пакетному проекті дані процесу повинні мати пакетний ідентифікатор tag (стовпець), що вказується на сторінці Умови виконання в конфігурації проекту в SIMCA-online. Це tag зіставляється з пакетним вузлом, щоб знати, чи має виконуватися фаза.
Якщо дані процесу не мають ідентифікатора партії tag, можна використовувати синтетичний пакетний ідентифікатор процесу функції ODBC SimApi. Він генерує ідентифікатор партії даних процесу, використовуючи дані з пакетного вузла.
Щоб скористатися цією функцією, перейдіть на сторінку Умови виконання та налаштуйте ідентифікатор партії tag бути пакетним ідентифікатором пакетного вузла. Кожного разу, коли сервер зчитує ідентифікатор пакета для даних процесу, синтетичний ідентифікатор пакета з пакетного вузла повертатиметься, забезпечуючи виконання пристрою.
Зауважте, що ця функція не працює з одночасними (паралельними) пакетами. Таким чином, протягом будь-якого заданого часу має бути лише один активний пакет у пакетному вузлі.
1.1.2 Ідентифікатор партії створеного синтетичного процесу tags; один на унікальний ідентифікатор одиниці
Ця функція ґрунтується на описаному вище синтетичному ідентифікаторі партії процесу, але використовує додатковий стовпець у вузлі пакета, який містить UnitID. Пакетний вузол сегментується на класи пакетів, які мають однакове значення в стовпці UnitID. Це діє як для пакетів у пакетному вузлі, які мають певне значення для UnitID.
Для кожного унікального значення в стовпці UnitID (переглядаючи весь пакетний вузол) SimApi створює синтетичний tag у пакетному вузлі з іменем BatchID_Unit_[Value].
наприкладample: якщо значення 1 і 2 є двома унікальними значеннями в стовпці UnitID, це призведе до двох синтетичних tags; BatchID_Unit_1 і BatchID_Unit_2. Читання даних процесу з синтетичного ідентифікатора партії tag BatchID_Unit_1 поверне лише ідентифікатори партій для партій, стовпець UnitID яких має значення 1. Пакети з 2 у стовпці UnitID ігноруватимуться.
Щоб використовувати це, ви налаштовуєте ідентифікатор партії tag на сторінці «Умови виконання» для кожного блоку використовувати синтетичний BatchID_Unit_[Value] tags.
Ім’я стовпця ідентифікатора одиниці налаштовується в XML file.
Обмеження
· Що стосується звичайного синтетичного пакетного ідентифікатора, описаного вище, це не працює з одночасними (паралельними) пакетами, що мають однакове значення UnitID (паралельні пакети з різними UnitID працюють добре).
· Усі ідентифікатори одиниць необхідно вказати у пакетному вузлі перед запуском SimApi (синтетичний tags створюються під час запуску). Порада: ви можете попередньо заповнити таблицю одним фіктивним пакетом у пакетному вузлі для кожного потрібного ідентифікатора блоку.
· Ідентифікатори пакетів мають бути унікальними у вузлі пакету, і для кожного ідентифікатора пакета може бути лише один рядок. Тому кожна партія може мати лише одне значення UnitID.
· Значення UnitID не повинно змінюватися для конкретної партії протягом її життя.
Примітка: альтернативою використанню синтетичного ідентифікатора партії процесу, відфільтрованого UnitID, як це, є використання кількох пакетних вузлів; по одному для кожного унікального значення UnitID. У випадку кількох пакетних вузлів, той самий пакетний ідентифікатор може бути присутнім у багатьох пакетних вузлах (на відміну від використання фільтра UnitID), тому в деяких випадках кілька пакетних вузлів є кращим рішенням.
1.1.3 Пакетний вузол із підтримкою фільтрації
Пакетний вузол потрібен у SIMCA-online для виконання пакетних проектів.
Фільтрування корисне, якщо у вас є пакетний вузол із головним списком партій для всієї системи, але ви хочете відфільтрувати його, щоб показати лише партії в частині системи (наприклад, партії, що працюють в одному пристрої, або продукт із певного матеріалу чи типу).

вступ

Фільтрування є необов’язковим, і для його використання необхідно вказати стовпець для фільтрування та вказати список дійсних значень для цього стовпця. Для кожного налаштованого значення SimApi створює окремий вузол, який містить лише пакети з цим значенням у стовпці фільтра.

Ось колишнійampле партії view, який у базі даних називається BatchNode, зі стовпцем Unit, який можна використовувати для фільтрації пакетів.

BatchID StartTime

StopTime

Одиниця (стовпець фільтра) Змінна умов партії 1

Batch1 2017-01-01 01:00 2017-01-01 11:00 A

34

Batch2 2017-01-02 02:00 2017-01-02 12:00 B

4

Batch3 2017-01-03 03:00 2017-01-01 13:00 A

12

Batch4 2017-01-04 04:00 2017-01-04 14:00 A

4

Batch5 2017-01-05 05:00 2017-01-05 15:00 B

5

Якщо налаштувати для блоків A і B, це дасть два пакетні вузли з іменами BatchNode_A і BatchNode_B. Кожен із цих пакетних вузлів повертатиме лише пакети, які відповідають значенню їхнього фільтра, тому для BatchNode_A повертатимуться Batch1, Batch3 і Batch4, а для BatchNode_B — Batch2 і Batch5. Останній стовпець є exampфайл змінної умови пакета, який буде доступний у цьому пакетному вузлі для читання даних на рівні пакета.

Ідентифікатори пакетів синтетичних процесів підтримуються для пакетних вузлів, налаштованих таким чином.

1.1.4 Пакетні дані Views
Пакет даних view це база даних view або таблицю для зберігання значень умов партії. Він повинен мати три стовпці: ідентифікатор партії, Tag ім'я та значення. Один ряд у цьому view зберігає значення для конкретного tag і партія. Тут буде багато рядків view для кожної партії, коли є багато змінних умов партії.
Ось колишнійampфайл пакетних даних view у базі даних з трьома стовпцями:

BatchID

Tag назва

Значення

Партія7

Врожайність

0.95

Партія7

Якість продукту

Чудово

Партія8

Врожайність

0.90

Партія8

Якість продукту

Бідний

Дані цієї партії view буде представлено через SimApi як два tags Врожайність і якість продукції. Читання значень для тих tags для Batch8 отримають значення 0.90 і «Погано» відповідно.

Примітка. Якщо існує кілька рядків для одного BatchID і Tag комбінація імен у базі даних view, SimApi поверне значення з останнього з цих рядків.

У пакетних даних немає стовпців часу початку або завершення пакету views, тому їх не можна використовувати як пакетні вузли.

Ви можете налаштувати багато різних пакетних даних views.

Порада: як альтернатива Batch Data Views, дані умов пакету також можуть зберігатися в пакетному вузлі. У цьому випадку потрібен один стовпець для кожної змінної умов партії. Таким чином, у пакетних вузлах буде лише один рядок для кожного пакета, але потрібно більше стовпців.

вступ

Важливо для функції Extract SIMCA-online: Щоб витягти дані з пакетних даних view вам також потрібно включити один tag (наприклад, ідентифікатор партії tag) із пакетного вузла, щоб SIMCA-online могла знати, для яких пакетів потрібно витягти дані.

1.1.4.1 Екземпляр даних синтетичної партії tags Пакетні дані завжди складаються з одного спостереження на пакет1.
Але що, якщо значення пакетних даних tag може змінитися (наприклад,ample, тому що ви повторно виконуєте деякі вимірювання) і якщо ви хочете використовувати кілька вимірювань на партію в SIMCA-онлайн моделі рівня партії?
Тоді ви можете використовувати додаткову функцію екземпляр синтетичних пакетних даних tags. Це tags які додаються як додаткові tags у даних партії view, кожне зіставлення з певним екземпляром пакетних даних для tag.
Ось колишнійampле:

BatchID

TimeColumn

Tag назва

Значення

Партія7

2015-06-23 09:00 Yield

0.90

Партія7

2015-06-23 17:00 Yield

0.99

Потім SimApi відкриє ці пакетні дані view з двома tags; Урожайність_1 і Урожайність_2. Коли дані зчитуються для партії Batch7, це призведе до значень 0.90 для Yield_1 і 0.99 для Yield_2.

Зверніть увагу, що в цьому прикладі додано новий TimeColumnample, з часомamp для кожного рядка. Цей стовпець потрібен для екземпляра синтетичних пакетних даних tag функція, щоб SimApi знав, як упорядкувати значення для tags в екземпляр tags.

1.1.4.2 Ідентифікатор партії синтетичного процесу tags відфільтровано за значеннями стовпців. Ця функція схожа на ідентифікатор партії створеного синтетичного процесу tags; по одному на унікальний ідентифікатор блоку з тією різницею, що він зчитується з пакетних даних view а ідентифікатор пакета можна відфільтрувати за кількома стовпцями.
Ось колишнійampле:

BatchID

TimeColumn

Tag ім'я Значення

одиниця

лінія

Партія7

2015-06-23 09:00 Yield

0.90

A

1

Партія8

2015-06-23 09:00 Yield

0.95

B

2

Якщо ми відфільтруємо BatchID за стовпцями Unit і Line, це дасть нам один синтетичний ідентифікатор партії tag для кожної унікальної комбінації значень зі стовпців Одиниця вимірювання та Рядок.

Синтетичний tags створено буде: BatchID_A_1, BatchID_B_2

Таким чином, читання BatchID_A_1 протягом часу в таблиці дасть значення Batch7, для того самого часу BatchID_B_2 дасть значення Batch8.

Зверніть увагу, що стовпчик часу з часомamp для кожного рядка потрібен для цієї функції.

1.1.5 Дискретні дані
Дискретні дані – це рідко вимірювані дані, які не мають логічних значень між вимірюваннями. Зазвичай, якample приймають з кожної партії через напіврегулярні проміжки часу (наприклад, один раз на день). Це сampпотім файл надсилається до лабораторії, яка виконує аналіз sample і пізніше stagе повернувся з доповіддю на сample для необхідних змінних. Потім це вноситься до бази даних у таблиці дискретних даних.
Дізнайтеся більше про це в Посібнику SimApi та Технічному посібнику SIMCA-online.

1 Щоб отримати додаткові відомості про різні режими отримання даних, одним із яких є пакетні дані, див. SimApi Guide.pdf.

передумови
1.1.5.1 Вік синтетичної партії tags для дискретних вузлів даних Для дискретних вузлів даних існує чотири синтетичних tags з назвами $BatchAge(d), $BatchAge(h), $BatchAge(m), $BatchAge(s). Під час читання їхніх значень вони будуть віком партії як число з плаваючою комою для кожного sample в чотирьох різних величинах: дні, години, хвилини та секунди відповідно. Ці tags можна використовувати як зрілість у моделі SIMCA, зменшуючи потребу в явному додаванні та заповненні таких tags до дискретних таблиць даних.
1.1.6 Одночасний доступ SimApi
Паралельний доступ SimApi є додатковою функцією, представленою на сервері SIMCA-online 18, яка може покращити продуктивність і швидкість реагування сервера та клієнтів.
ODBC SimApi є потокобезпечним і використовує пул підключень до сервера. Розмір пулу можна налаштувати за допомогою параметра DatabaseConnectionPoolSize у конфігурації file (за замовчуванням 10). Це визначає кількість дозволених одночасних запитів до бази даних. Додаткові одночасні запити ставляться в чергу та виконуються після завершення попередніх запитів.
Різні механізми баз даних і різні сервери баз даних можуть підтримувати різну кількість одночасних потоків. Для оптимальної продуктивності, можливо, доведеться налаштувати розмір пулу підключень.
Дізнайтеся більше про те, як увімкнути це, у онлайн-довідці SIMCA щодо паралельного доступу SimApi.
2 Передумови
Щоб цей SimApi працював, необхідно виконати вимоги як до ПК, на якому запущено SimApi, так і до самого джерела даних щодо структури та продуктивності бази даних.
2.1 Вимоги до структури бази даних
Звичайно, база даних може містити практично будь-які дані з довільною структурою. ODBC SimApi створено для отримання даних процесу для використання в SIMCA-online і SIMCA.
Щоб SimApi працював, база даних повинна мати певну структуру або дизайн, як описано нижче.
Ось загальні вимоги:
· Усі використовувані таблиці мають унікальний первинний ключ. · Для більшості таблиць у базі даних потрібні стовпці дати/часу, щоб SimApi міг визначити часamp
для кожного рядка даних. Цей стовпець має бути проіндексований у базі даних, щоб продуктивність не погіршилася. · SimApi підтримує два типи даних для стовпців даних: чисельні дійсні значення (з плаваючою точкою або інші
числовий тип даних) або текстові рядки (наприклад,ample varchar у базі даних). Відсутні значення (нулі) також дозволені для стовпців даних. · Термін view і table використовуються як синоніми в цьому документі, щоб означати те саме. · Якщо ви створюєте a view у джерелі даних і хочете використовувати це в SimApi, будьте обережні, щоб не викликати проблеми з продуктивністю: view повинен мати швидкий доступ через SimApi. Це означає, що ви зазвичай не можете створити комплекс view який агрегує дані з багатьох інших таблиць і виконує складну бізнес-логіку для обчислення результатів. Такий view не відповідатиме вимогам щодо продуктивності користувачів SimApi, наприклад SIMCA-online, який використовується для моніторингу процесу в реальному часі.
SimApi має багато функцій, і кожна функція має різні необхідні налаштування, які потрібно виконати, як описано в розділі 3.
2.2 Зауваження продуктивності бази даних
Для використання SimApi в SIMCA-online, який використовується для моніторингу в реальному часі, важливо, щоб джерело даних поводилося як хороший архіватор даних процесу.
· У джерелі даних не повинно бути затримок отримання даних: поточні дані в джерелі даних повинні відображати поточний стан процесу, щоб добре працювати в SIMCA-online.

передумови
· Джерело даних має також швидко реагувати на запити даних, щоб сервер міг не відставати від виконання проектів у реальному часі.
Це має кілька наслідків:
· Сховища даних або бази даних, які виконують агрегацію даних, можуть погано працювати з SIMCA-online для виконання проекту в реальному часі, оскільки вони можуть вводити затримки в отриманні даних.
· База даних viewякі виконують складні та трудомісткі запити, ризикують бути надто повільними для використання в SIMCA-online.
2.3 Мережеві міркування
Ви повинні розташувати сервер SIMCA-online поблизу джерела даних у мережі. Це забезпечує швидке з’єднання між SIMCA-online та його джерелом даних. Мережеве обладнання, таке як брандмауери, може заважати з’єднанню між SIMCA-online та джерелом даних. Якщо це так, можливо, доведеться змінити правила брандмауера. Перевірте підключення від ПК, на якому запущено SimApi, до джерела даних, напрampнатисніть кнопку Перевірити з’єднання в джерелах даних ODBC.
2.4 Драйвери ODBC
SimApi потребує встановлення драйверів ODBC для джерела даних на ПК, на якому встановлено SimApi. Драйвери ODBC отримують від виробника бази даних. Завантажте та встановіть останню доступну версію. Драйвери для Microsoft SQL Server часто вже інстальовано на більшості комп’ютерів Windows. Вам потрібні драйвери, які відповідають платформі SimApi. Як правило, це означає, що 64-розрядні драйвери x64 будуть використовуватися з 64-розрядною Windows і SIMCA та SIMCA-online. Для старих 32-розрядних версій SIMCA потрібні 32-розрядні драйвери ODBC.
2.5 Аутентифікація бази даних
Бази даних вимагають автентифікації, щоб SimApi міг отримати доступ до даних, щоб отримати доступ лише до тих даних, які потрібні SimApi. Адміністратори бази даних обмежують доступ до бази даних для певного користувача, який використовується SimApi. Автентифікацію користувача можна виконати одним із трьох способів за допомогою ODBC SimApi:
1. Вкажіть ім’я користувача та пароль у діалоговому вікні налаштування SimApi. Облікові дані зберігаються в зашифрованому форматі на ПК.
2. Вказівка ​​імені користувача та пароля в підключенні ODBC, створеному в джерелах даних ODBC (див. нижче). Це зберігає облікові дані в Windows.
3. Не вказуючи облікові дані явно, а замість цього використовуючи автентифікацію Windows і обліковий запис користувача, який запускає SimApi. Для настільного ПК SIMCA це означає користувача, який запускає SIMCA, а для SIMCA-онлайн це означає обліковий запис служби SIMCA-онлайн, налаштований у службах Windows.
Розділ 3 показує, як налаштувати SimApi.
2.6 Розповсюджуваний Visual C++
Щоб використовувати SimApi на комп’ютері, на ньому має бути встановлено таке програмне забезпечення:
· Повторне розповсюдження Microsoft Visual C++ для Visual Studio 2015-2022. Це вже доступно на всіх комп’ютерах із останніми версіями SIMCA або SIMCA-online. Щоб запустити SimApi в інших контекстах, останню версію можна знайти за адресою https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vcredist?view=msvc-170#visual-studio-2015-2017-2019-and-2022

Встановлення та налаштування
3 Установка та налаштування
Посібник SimApi, який можна завантажити з sartorius.com/umetrics-simapi, містить гарну довідкову інформацію про SimApis, як встановити, налаштувати, усунути неполадки та протестувати SimApi. Ви можете звернутися до цього документа, щоб дізнатися більше про різні теми. Щоб установити та налаштувати SimApi, виконайте такі дії:
1. Встановіть драйвери ODBC для вашої бази даних (див. розділ 2). 2. Налаштуйте підключення до бази даних ODBC у джерелах даних Windows ODBC і перевірте його, щоб переконатися
роботи (докладні кроки в наступному розділі). 3. Встановіть SimApi на ПК за допомогою програми встановлення: (докладні інструкції див. у розділі 5 у
довідник SimApi): a. Перш ніж встановлювати нову, спочатку видаліть будь-яку попередню версію в програмах і функціях Windows. b. Розпакуйте блискавку file, зверніться до Version Info.txt file і посібник користувача (який ви зараз читаєте…). в. Запустіть інсталяційний exe file щоб встановити SimApi.
4. Якщо пакет Visual C++ Redistributable на ПК не оновлений, інсталюйте найновішу версію (див. 2.6). 5. Додайте SimApi до SIMCA або SIMCA-online, як описано в розділі 5 посібника SimApi.
a. Коли ви натискаєте кнопку, щоб налаштувати SimApi, ви отримаєте це діалогове вікно, щоб надати облікові дані для використання (дізнайтеся про параметри в попередньому розділі):
b. Усі інші налаштування для цього SimApi виконуються вручну в XML file за допомогою текстового редактора. Далі в цьому розділі описано, як налаштувати кожну функцію.
6. Перевірте SimApi. Див. розділ 6 у посібнику SimApi.
3.1 Налаштування підключення до джерела даних ODBC у Windows для використання SimApi
Для роботи SimApi потрібне налаштоване підключення до джерела даних ODBC. Це створюється на панелі керування джерелами даних ODBC у Windows. Існує дві версії цього інструменту для 64-розрядної Windows: одна для 32-розрядних програм і друга для 64-розрядних. Використовуйте той, який відповідає SimApi, який ви використовуєте, зазвичай 64-розрядний, оскільки всі останні версії SIMCA-online і SIMCA є 64-розрядними і вимагають 64-розрядних варіантів SimApis. На цьому знімку екрана показано цю програму в Windows. У цьому випадку є три різні підключення до бази данихample. У наведеному нижче діалоговому вікні показано першу сторінку майстра налаштування для підключення SQL Server до сервера se01wssuite01:

Встановлення та налаштування
Рекомендації щодо використання: · Ми рекомендуємо вам налаштувати джерела даних як системні DSN, як показано на знімку екрана. Це гарантує, що вони доступні для всіх користувачів ПК, включаючи такі служби, як SIMCA-online. · Натисніть Додати, щоб додати нове підключення. Виберіть драйвер для використання, який ви встановили, як описано в попередньому розділі, який відповідає вашій базі даних, і клацніть за допомогою майстра та налаштуйте параметри для підключення до сервера бази даних. · Наприкінці майстра ви можете спробувати кнопку Перевірити джерело даних, щоб перевірити підключення до бази даних. Звичайно, це не спрацює, якщо ви вкажете ім’я користувача та пароль у самому ODBC (див. попередній розділ).
3.2 Вибір між двома способами доступу до даних процесу
У цьому SimApi є два способи доступу до даних процесу: 1. Прямий режим. У цьому режимі ви вказуєте view імена, які мають бути представлені через SimApi. Кожен view стає вузлом у SimApi, а всі стовпці в a view стати tags. Рекомендується прямий режим, оскільки він відносно простий у використанні.

Встановлення та налаштування

2. Пошук View Режим. Цей режим більш складний і вимагає специфіки view у базі даних під назвою Lookup View. Це view визначає tags які мають бути представлені через SimApi, але дані беруться з додаткових пов’язаних views вказано для кожного рядка даних під час пошуку view.
Дізнайтеся більше про те, як налаштувати ці та всі інші функції SimApi нижче. Поверніться до розділу 1.1, щоб дізнатися більше про функції SimApi, які ви налаштовуєте нижче.

3.3 Конфігурація XML file і журнал file локації
SimApi зберігає свій журнал files у прихованій папці Program Data2: %programdata%UmetricsSimApi, де %programdata% відповідає фактичній папці на вашому комп’ютері. За замовчуванням C:ProgramData.
Він містить налаштування SimApi в XML file під назвою ODBCSimApi_ .xml. Ви можете редагувати це file вручну за допомогою текстового редактора, такого як Блокнот, щоб внести зміни.
Кожен SimApi зазвичай використовує власний журнал file, який аналогічно журналу сервера SIMCA-online file міститиме дані залежно від налаштування рівня журналу. Це file корисний для усунення несправностей.
Журнал file має назву ODBCSimApi_ .log.
це ім’я екземпляра SimApi, який ви додали в параметрах сервера SIMCA-online або за замовчуванням для настільного ПК SIMCA. наприкладample, якщо ви додали екземпляр із назвою «MyDB» до журналу file Ім'я буде ODBCSimApi_MyDB.log. Дізнайтеся більше про це в 4.2 4.3 посібника SimApi.

3.4 Глобальні налаштування підключення
Перший розділ конфігурації XML file це параметри підключення, які описують, як підключитися до вашої бази даних.

Необхідні налаштування:

· ДСН

назву джерела даних. Воно має відповідати назві системного DSN у Windows

Джерела даних ODBC, які ви налаштували вище.

· SQLDialect

встановити відповідно до сервера бази даних, який ви використовуєте.

Вам також може знадобитися встановити параметри LeftPunctuation і RightPunctuation, якщо ви використовуєте зарезервовані ключові слова SQL як імена ідентифікаторів або використовуєте пробіли в іменах ідентифікаторів вашого views/таблиць/стовпців у базі даних.

Інші параметри підключення необов’язкові.

Ці та всі інші параметри також мають описи в таблиці в кінці розділу.

Важливо: деякі бази даних чутливі до регістру, коли йдеться про назви баз даних, таблиць, views, columns so make sure you use the correct casing used in your database in the XML file.

3.5 Прямий режим для безперервного/процесу views
Кожен рядок у прямому режимі view є спостереженням.
Стовпчики в view представляють змінні:
· Повинен бути один стовпець із датою/часом. Цей стовпець має бути первинним ключем і не може містити нульові значення. Ім’я цього стовпця має відповідати налаштованому параметру TimeField у конфігурації file. Значеннями для цього стовпця є час стamp для спостережень.
· Стовпець дата/час має мати тип даних datetime або datetime2. · Інші стовпці будуть представлені через SimApi як tags з тими самими назвами, що й стовпець
імена. Значення для цих стовпців є даними процесу.

2 Ця папка прихована в Windows за замовчуванням. Щоб побачити це в File Провідник, який ви налаштовуєте, показує прихований fileс. Зауважте, що ви можете перейти до прихованої папки, ввівши адресу File Адресний рядок Провідника.

Встановлення та налаштування
· Відповідний запис підтримується для всіх tags, однак у джерелі даних ODBC потрібно встановити правильні дозволи. Щоб мати можливість записати відсутні значення, для стовпця повинні підтримуватися нулі.
Конфігурація в XML file прямо вперед: views і прямий режим views: –> ”/>
Примітка: SimApi перераховує стовпці лише під час запуску. Це означає, що якщо до a view SimApi потрібно перезапустити, щоб SimApi викрив їх.

Рисунок 1. Таблиця прямого режиму, напрample.
3.6 Пошук View Режим безперервний/процес views
Це view можна використовувати замість прямого режиму або на додаток до нього views, як описано вище. Пошук View це непрямий спосіб вказати, які стовпці даних в інших views, які слід зібрати та надати через SimApi. Інший views є джерелами HDB (історичні дані) або джерелами PDB (поточні дані) відповідно. Джерело PDB є необов’язковим. Дані, надані Пошуком View представляється SimApi як вузол, який завжди називається ODBCProcess:

Кожен рядок у Пошуку view визначає один tag бути виставлені через SimApi та які інші views щоб взяти дані для цього tag. Пошук view таким чином буде містити багато рядків. Він також визначає, якщо a tag є записуваним, тобто якщо SIMCA-online повинна мати можливість записувати значення назад до цього tag.

У пошуку може бути кілька джерел PDB і HDB View. Таким чином, ODBC SimApi може агрегувати дані з кількох views в один вузол з tags які доступні через SimApi.

Пошук view має містити наступні стовпці (у конфігурації вони називаються полями file):

· Ім'я

Ім'я а tag (Первинний ключ, varchar, не null).

· PDB_Source

Назва view який містить поточні дані для tag (varchar). Якщо це

містить порожнє значення, програма прочитає всі дані з HDB_Source.

· PDB_Field

Назва стовпця tag у вихідному коді PDB view (varchar). Якщо

Значення PDB_Source пропущено, цей стовпець не читатиметься.

· HDB_Source

Назва view який містить історичні дані для tag (varchar).

· HDB_Поле

Назва стовпця tag у джерелі HDB view (varchar).

Встановлення та налаштування

· Можливість запису

Якщо SIMCA-online повинна мати можливість записувати дані на це tag чи ні (біт).

Зауважте, що для кожного стовпця в наведеному вище описі також зазначено, які рядки повинні бути первинними ключами та тип даних для кожного стовпця.

Назви стовпців є довільними, оскільки вони вказуються в конфігурації file.

Малюнок 2. Впрampфайл пошуку view у вигляді таблиці бази даних. На знімку екрана ви побачите, що використовуються одне джерело PDB і одне джерело HDB. Стовпець Ім'я визначає tag імена, які використовуватиме SimApi, і в цьому випадку стовпці _Field використовують однакові імена стовпців. Тільки один tag доступний для запису.

3.6.1 PDB views і HDB views
Коли ви використовуєте Lookup View вам також потрібен принаймні один HDB view. The views для історичних даних (HDB) і необов’язковий views для поточних даних PDB обидва мають однакову структуру даних (стовпці).
Кожен рядок у PDB або HDB views представляє спостереження зі значеннями для кожного tag у цьому PDB/HDB view як зазначено в пошуку view.
Відмінності між PDB і HDB:

· PDB view містить лише один рядок даних для tags вказаний у Пошуку view. Він також повинен мати час вулamp стовпець для останнього оновлення.
· HDB view містить кілька рядків даних для tags зазначені в таблиці пошуку. У кожному ряду час стamp містить історичний часamp для конкретного спостереження.

PDB і HDB views має мати такі стовпці,

· ДатаЧас

Для PDB: час останнього оновлення таблиці (первинний ключ, дата, час або

datetime2, а не null).

Для HDB: історичний час для tag значення (первинний ключ, дата, час або

datetime2, а не null).

· [Назва стовпця] Для кожного має бути один стовпець tag який було зазначено в таблиці пошуку.

Містить дані для tag в кожному ряду.

Зауважте, що для кожного стовпця в наведеному вище описі також зазначено, які рядки повинні бути первинними ключами та тип даних для кожного стовпця.
Назви стовпців у базі даних довільні, оскільки назви вказані в конфігурації file.
Наступні стовпці не є обов’язковими, але їх корисно додати, якщо партії моделюються з кількома фазами та в процесі є кілька одиниць:

· UnitBatchID

Один стовпець на одиницю, який містить ідентифікатор пакета в певній одиниці (varchar).

Це tag можна використовувати в ідентифікаторі партії tag для цієї одиниці на сторінці Умови виконання

налаштування цього проекту в SIMCA-online.

Встановлення та налаштування

· PhaseID

Один стовпець на одиницю, який містить інформацію про фазу для одиниці (int, float або varchar).

Це tag можна використовувати в логічному виразі в полі умови виконання фази в конфігурації цього

проект в SIMCA-online.

Максимально дозволена кількість tags (стовпці) становить 255.

Малюнок 4. PDB example.
Рисунок 3. HDB example.
3.7 Пакетний вузол
Пакетний вузол містить метаінформацію про пакети, наприклад час початку, час завершення та, за бажанням, умови пакетів. Пакетний вузол потрібен SIMCA-online для аналізу пакетних даних, але його можна не використовувати для безперервного (не пакетного) проекту. Ім'я пакетного вузла, яке видно з SIMCA-online або SIMCA, є оригінальною назвою view або таблиці в базі даних, у цьому прикладіampфайл «BatchData»:
Кожен рядок у пакетному вузлі представляє один пакет.

Встановлення та налаштування

Партія view має мати такі стовпці:

· BatchID

Ім’я пакету (первинний ключ, varchar, не null).

· BatchStart

Час початку партії, коли вона вперше входить у весь процес (а не коли вона

починається в одиниці (частині) у процесі) (datetime або datetime2, не null).

· BatchStop

Час, коли вся партія завершена в системі (не в одиниці), значення нульове, якщо

не завершено (datetime або datetime2).

Зауважте, що стовпець BatchID має бути первинним ключем.

Крім того, для кожної змінної умов партії можуть бути такі додаткові стовпці:

· [Назва умови партії]

Один стовпець для кожного стану партії. Назва стовпця буде

використовується як tag назва. (float для числових значень або varchar для тексту, наприклад ідентифікатора конфігурації).

· UnitID

Назва одиниці, з якою пов’язана партія

(varchar).

Імена пакетного вузла та стовпців є довільними в базі даних, оскільки імена вказані в конфігурації file.

Малюнок 5. Пакетний вузол напрampфайл із двома пакетними умовами (bc1 і bc2) і стовпцем UnitID.

3.8 Пакетні дані Views
Дані кожної партії view має мати ці три стовпці (додаткові стовпці ігноруватимуться):

· Ідентифікатор партії · Tag назва · Значення
текст або float3).

ім'я пакету (varchar, не null) ім'я змінної умови пакета (varchar, не null) значення змінної умови пакета (float для числових значень або varchar для

Поєднання BatchID і Tag ім'я має бути первинним ключем (якщо ви не хочете використовувати функцію примірника кількох пакетних даних).

Дані кожної партії view розкривається як вузол SimApi. Ім'я вузла - view ім'я в базі даних. The view ім'я та імена стовпців налаштовуються в конфігурації XML file використовуючи атрибути одного BatchDataView такий елемент:

3 Використовуючи текстовий стовпець varchar, ви можете зберігати текст (дані для якісних змінних у проекті SIMCA). Однак ви також можете зберігати числові числа в текстовому форматі, і SimApi перетворить їх на числа. Таким чином ви можете отримати трохи tags числові, а деякі містять текст.

Встановлення та налаштування

<BatchDataView ViewНазва=”База данихViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag name” ValueColumn=”Значення” />
Зауважте, що використані тут значення збігаються з таблицею на рисунку 5. Додайте кілька пакетних даних views, додавши більше BatchDataView елементів.

3.8.1 Екземпляр даних синтетичної партії tags
Щоб налаштувати додатковий екземпляр пакетних даних tags, ви додаєте атрибути NumSyntheticBatchTags і TimeColumn до BatchDataView елемент:
<BatchDataView ViewНазва=”База данихViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag name” ValueColumn=”Значення” TimeColumn=”TimeColumn” NumSyntheticBatchTags=”3″ />
TimeColumn — це ім’я стовпця часу у вашій базі даних view. Цей стовпець необхідно надати для екземпляра пакетних даних tags.
Дозволене значення для NumSyntheticBatchTags це числові значення від 1 до 10. Це визначає кількість синтетичних екземплярів tags створюються за реальні tag. наприкладample, для tag «tag” нове tags «tag_1", "tag_2", … "tag_N» буде створено, доки N не буде NumSyntheticBatchTags.

3.8.2 Ідентифікатор партії синтетичного процесу tags відфільтровано за значеннями стовпців
Щоб налаштувати додатковий фільтр ідентифікатора партії tags який можна використовувати для режиму безперервного отримання даних, ви додаєте атрибути FilterColumns і TimeColumn до BatchDataView елемент:
<BatchDataView ViewНазва=”База данихViewOrTableName” BatchIDColumn=”BatchID” TagNameColumn=”Tag name” ValueColumn=”Значення” FilterColumns=”Column1|Column2″ TimeColumn=”TimeColumn”/>
FilterColumns має бути одним або кількома іменами стовпців у вашій базі даних view. Якщо використовується кілька імен стовпців, розділіть їх символом вертикальної лінії (|).
TimeColumn має бути назвою стовпця часу у вашій базі даних view. Цей стовпець необхідно надати для екземпляра пакетних даних tags.

3.9 Дискретні вузли
Додаткові дискретні вузли містять дискретні вимірювання даних. Кожен рядок у дискретному вузлі представляє одне вимірювання для партії та tag в даний час.

Дискретний вузол повинен мати такі стовпці:

· Ідентифікатор партії · TagНазва · Час · Значення

Ім'я пакета (varchar, не null). Назва tag (varchar, а не null). Час, коли сampфайл було взято (datetime або datetime2, не null). Значення вимірювання (float). Дискретні дані не можуть бути рядковими даними.

Зверніть увагу, що комбінація BatchID+TagІм’я+Час має бути первинним ключем.

Кожен налаштований дискретний вузол відображається як вузол SimApi. Ім'я вузла - view ім'я в базі даних, якщо воно не перевизначено. Ім'я вузла, view ім'я, пошук view, а назви стовпців налаштовуються в конфігурації XML file використовуючи такі атрибути елемента DiscreteNode:

<DiscreteNode NodeName=”ODBCDiscrete” ViewНазва=”Дискретний” TagПошукView=”ДискретнийTags” BatchIDField=”BatchID” TimeField=”Час” TagNameField=”TagІм’я” ValueField=”Значення”/>

Наведений вище прикладample надає SimApi вузол з назвою ODBCDiscrete, він перераховує tags за допомогою дискретногоTags стіл/view. Дані зчитуються з дискретної таблиці/view за допомогою налаштованих стовпців.

Встановлення та налаштування
Імена дискретного вузла та його стовпців є довільними в базі даних, оскільки імена вказані в конфігурації file.
Малюнок 6. Дискретний вузол напрampле з двома tags sampтри рази (приблизно з інтервалом 24 години) на партію.
3.9.1 Дискретний Tag Визначення View
Це необов'язково view використовується SimApi для перерахування дискретних tags які мають бути доступні через SimApi. Це відбувається під час запуску SimApi. Ви можете скористатися цим view для оптимізації продуктивності під час завантаження SimApi або якщо ви хочете контролювати що tags піддаються з SimApi. Наприклад, якщо ви хочете викрити tags який ще не має жодних вимірювань під час запуску SimApi.
Малюнок 7. Простий дискрет tag пошук view який використовує дискретну таблицю.

Встановлення та налаштування
3.9.2 Дискретні дані, які бачить SIMCA-online
Нижче показано, як дискретні дані на малюнку 6. Дискретний вузол напрampле з двома tags sampтри рази (приблизно з 24-годинними інтервалами) на партію. ​​Малюнок 6 Малюнок 2 Помилка! Джерело посилання не знайдено. шукатиметься в SIMCAonline у ​​поєднанні з пакетами на малюнку 5.
Малюнок 8. Дискретні дані у вигляді SIMCA-online. Зауважте, що вік створеної партії tags представляють вік партії для кожного спостереження/івample.
3.10 Деякі зауваження щодо SIMCA-online Write Back
Зворотний запис у SIMCA-online можна використовувати для запису даних із SIMCA-online у ​​джерело даних ODBC. Підтримується запис безперервних даних процесу (з безперервних конфігурацій, рівня еволюції пакетів або з Control Advisor) і даних пакетів (з рівня пакетів). Не рекомендується виконувати зворотний запис до тих самих вузлів, які ви використовуєте для читання даних, оскільки це призведе до спроби додати повторювані рядки з однаковими первинними ключами в базі даних views через первинні ключі, які ми рекомендуємо для стовпців дати/часу та стовпців ідентифікатора партії (див. вище). Натомість створіть один або кілька прямих режимів views для безперервних/еволюційних даних або пакетні вузли для пакетних даних, які використовуються для зворотного запису. Причиною цієї проблеми є те, що ODBC SimApi використовує оператори SQL INSERT для додавання нового рядка даних для кожного спостереження або для кожного пакета на рівні пакета.
· Для безперервних даних час спостереження записується разом із значеннями з SIMCAonline.
· Для пакетних даних ідентифікатор партії записується разом із значеннями з SIMCA-online. · Якщо відсутні значення будуть записані назад, вони будуть записані як нульові, тому база даних повинна підтримувати нульові значення
щоб це спрацювало. Оскільки час спостереження або ідентифікатор пакету записується назад, це порушить обмеження первинного ключа в базах даних, якщо ті самі значення вже присутні (як це було б, якби дані зчитувалися з тих самих вузлів). За винятком цих відмінностей первинного ключа, та сама схема бази даних застосовується до вузлів для зворотного запису (додаткову інформацію див. вище):

Встановлення та налаштування

· Для безперервних вузлів має існувати стовпець дати/часу, а для пакетних вузлів — стовпець пакетного ідентифікатора. · Додайте один стовпець даних для кожного tag які мають бути доступні для зворотного запису. Використовуйте тип даних float для
числові дані та varchar для текстових даних (наприклад, під час запису ідентифікатора конфігурації). наприкладample, якщо ви плануєте записати 20 різних векторів даних із SIMCA-online, вам потрібно додати 20 стовпців даних до бази даних view. · Стовпці повинні дозволяти нулі для підтримки запису відсутніх значень

3.11 Конфігурація XML File
У цій таблиці перераховано всі налаштування в конфігурації XML file. Використовуйте цю інформацію та описи вище, щоб налаштувати SimApi.

Спеціальні налаштування підключення

Пояснення

DSN

Назва джерела даних, налаштована на панелі керування адміністратора Windows ODBC.

SQLDialect

Діалект SQL для використання. Одне з цих значень: standard, postgresql, db2, mssql, mysql, oracle, access, denodo. Якщо залишити порожнім, буде використано стандарт, але за замовчуванням для нового XML-file це mssql.

Облікові дані

Зберігає ім’я користувача та пароль ODBC у зашифрованому вигляді. Використовуйте кнопку Налаштувати, щоб вказати ім'я користувача та пароль.

QueryTimeout

Час перед запитом або з’єднанням з базою даних закінчиться та завершиться невдало.

DBSchema

Схема бази даних у базі даних (якщо є). Схема бази даних — це спосіб логічного групування об’єктів, таких як таблиці, views, збережені процедури тощо. Думайте про схему як про контейнер об’єктів. Ви можете призначити дозволи користувача на вхід до однієї схеми, щоб користувач міг отримати доступ лише до тих об’єктів, до яких він має доступ. Схеми можна створювати та змінювати в базі даних, а користувачам можна надавати доступ до схеми. Схемою може володіти будь-який користувач, і право власності на схему можна передати.

ЗліваПунктуація

Лівий роздільник, специфічний для діалекту SQL, який використовується для відокремлення ідентифікаторів від інших команд SQL. Значення за замовчуванням порожнє, що означає, що пунктуація зліва не використовується. Вам потрібно вказати непорожнє значення, якщо ідентифікатори в базі даних використовують пробіли або зарезервовані ключові слова SQL. Для SQL Server або Access ви використовуєте «[“, але для Oracle та інших баз даних, які використовують стандарт SQL, вам слід встановити для цього параметра значення «"» (це керуюча послідовність XML для подвійних лапок «).

RightPunctuation

Правий роздільник, специфічний для діалекту SQL, який використовується для відокремлення ідентифікаторів від команд SQL. Для SQL Server або Access ви використовуєте «]», але для Oracle та інших баз даних, що використовують стандарт SQL, вам слід встановити для цього параметра значення «"», як для LeftPunctuation вище.

Виберіть StatementTerminator

Специфічний діалект SQL. Символ для завершення операторів select. Для деяких діалектів і версій потрібно встановити порожній рядок «». Типовим є «;».

DatabaseConnectionPoolSize

Максимальна дозволена кількість одночасних підключень до бази даних. За замовчуванням 10. Цей параметр може підвищити продуктивність, дозволяючи більш ніж одному потоку одночасно отримувати доступ до бази даних. Дізнайтеся більше в розділі 1.

Встановлення та налаштування

Спеціальні налаштування бази даних

UseLocalTime

Визначає, чи зберігаються дати в базі даних як місцевий час або UTC. За умовчанням встановлено «1», що означає, що використовується місцевий час.

Спеціальні параметри прямого режиму

Таблиці

Назва views, що містить безперервні/процесні дані. множинний views можна вказати, розділивши їхні імена вертикальною рискою (|). наприкладample: Таблиця1|Таблиця2|Таблиця3|View1. Ім'я TimeField має бути ідентичним у всіх views.

Пошук view конкретні налаштування

LookupTable

Ім'я пошуку view або стіл.

TagNameField

Назва стовпця, де знаходиться tag даються імена.

PDBTableField

Ім'я стовпця в підстановці view. Для кожного рядка цей стовпець містить назву PDB view. Ім'я а view з даними PDB. Можна залишити порожнім, якщо так, для поточних даних використовуватиметься останній рядок HDB.

PDBTagПоле

Назва стовпця в таблиці PDB, де дані для tag можна знайти (не використовується, якщо PDBTableField опущено).

HDBTableField

Ім'я стовпця в підстановці view. Для кожного рядка цей стовпець містить назву HDB view.

HDBTagПоле

Ім'я стовпця в підстановці view. Для кожного рядка цей стовпець містить назву a tag в HDB view.

WriteableField

Назва стовпця, яка повідомляє, чи є tag можна писати чи ні.

Прямий режим і HDB/PDB view конкретні налаштування

TimeField

Назва стовпця дати/часу в Continuous/Process View і PDB- або HDB-views (або таблиці).

Спеціальні параметри пакетного вузла

BatchTable

Назва view або таблицю, яка містить дані партії. Багаторазова партія view можна вказати, відокремивши їх імена вертикальною рискою (|). наприкладample: BT1|BT2|BT3. Наступні стовпці мають бути однаковими views.

BatchIDField

Ім’я стовпців ідентифікатора пакета у вузлі пакету.

StartTimeField

Назва стовпця часу початку пакета.

StopTimeField

Назва стовпця часу зупинки для партії.

BatchIDUnitField

Ім’я стовпця ідентифікатора блоку в пакетному вузлі. Це поле можна використовувати для генерації процесу синтетичного пакетного ідентифікатора tags відфільтровано за ідентифікатором блоку.

Пакетний вузол із підтримкою фільтрації One елемент із такими атрибутами, які керують

налаштування

налаштування для пакетного вузла синтетичного фільтрування.

Встановлення та налаштування

ViewІм'я BatchIDColumn StartTimeColum StopTimeColumn FilterColumn
FilterValues
Пакетні дані view Параметри окремих вузлів
NodeName ViewІм'я TagПошукView
BatchIDField TimeField TagІм'яПоле ЗначенняПоле Журнал file журнал конкретних налаштуваньFileРозмір LogLevel

Назва view або таблицю, яка містить дані партії.
Ім'я стовпця ідентифікатора партії.
Назва стовпця часу початку пакета.
Назва стовпця часу зупинки для партії.
Ім’я стовпця, який містить значення фільтра у пакетному вузлі. Цей параметр можна залишити пустим, якщо вам не потрібна функція фільтрації.
Значення, які слід використовувати для фільтрації партій. Кілька значень фільтра розділені вертикальною рискою (|). Залиште порожнім, якщо вам не потрібна фільтрація. наприкладample: FilterValue1| FilterValue2| FilterValue3. Це колишнійampопис того, як це може виглядати в конфігурації file: ViewName=”BatchNode” BatchIDColumn=”BatchID” StartTimeColumn=”StartTime” StopTimeColumn=”StopTime” FilterColumn=”Unit FilterValues=”FilterValue1| FilterValue2″ /> Кілька елементи підтримуються. Зверніть увагу, що ви можете мати різні назви стовпців між пакетними вузлами.
Зберігається в одному або кількохView> елементи. Див. 3.8 Пакетні дані Views.
Ан елемент для кожного дискретного вузла з наступними атрибутами. Див. 3.9 Дискретний.
Ім’я вузла, яке буде представлено SimApi. Якщо залишити порожнім, значення ViewБуде використано назву.
Назва view/таблиця, яка містить дискретні дані. Якщо залишити порожнім, вузол вимкнено.
Назва view/таблиця, яка визначає дискрет tags використовувати. Якщо залишити порожнім, ViewІм’я буде проаналізовано під час запуску, щоб перерахувати всі tags там.
Назва стовпця ідентичності партії, яка була виміряна.
Назва стовпця часу вимірювання.
Назва стовпця tag що було виміряно.
Назва стовпця значення вимірювання.
Максимально допустимий розмір колоди file перед file є усіченим.
Чим вище значення, тим більше інформації друкується в журналі file. Максимальне значення — 4, мінімальне — 0. (0=Критичний, 1=Помилка, 2=Попередження, 3=Інформація, 4=Налагодження).

Підтримка
4 Підтримка
Цей SimApi розроблено Sartorius Data Analytics. Щоб отримати підтримку, відвідайте sartorius.com/umetrics-support.

Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sweden
Телефон: +46 90-18 48 00 www.sartorius.com
Інформація та малюнки, що містяться в цих інструкціях, відповідають даті версії, вказаній нижче. Sartorius залишає за собою право вносити зміни в технологію, характеристики, специфікації та дизайн обладнання без попередження. Форми чоловічого або жіночого роду використовуються для полегшення розбірливості в цих інструкціях і завжди одночасно позначають усі статі.
Повідомлення про авторські права: ці інструкції, включаючи всі компоненти, захищені авторським правом. Будь-яке використання поза межами закону про авторське право заборонено без нашого дозволу. Це стосується, зокрема, передруку, перекладу та редагування, незалежно від типу використовуваного носія.

Підтримка

Документи / Ресурси

PDF thumbnailODBC SimApi
User Guide · ODBC SimApi, SimApi

Задайте питання

Use this section to ask about setup, compatibility, troubleshooting, or anything missing from this manual.

Задайте питання

Ask about setup, compatibility, troubleshooting, or anything missing from this manual. Name and email are optional.