Database

공장 시스템이 데이터베이스 테이블에 두는 값(SQL Server, PostgreSQL, MySQL과 MariaDB, SQLite, 또는 ODBC를 통한 모든 데이터베이스)을 태그로 읽고, 태그가 지시한 곳에 다시 씁니다. "데이터베이스"와 "로그인" 카드, 테이블과 열과 행으로 셀을 읽거나 자체 쿼리를 실행하는 태그, 태그가 쓰는 두 가지 방식, 열마다 태그를 제안하는 스캔, 네 가지 완전한 예, 그리고 드라이버가 하지 않는 일입니다.

Database 드라이버는 공장 시스템이 데이터베이스 테이블에 두는 값을 읽습니다. MES가 가진 생산 지시, ERP가 가진 레시피나 설정값, 다른 시험 시스템이 기록한 결과 같은 것입니다. 각 태그는 테이블 하나의 값 하나를 읽고, 값은 다른 모든 태그의 값과 같은 곳에 도착합니다. Logic, 대시보드, 그리고 Process 시험대의 실행 기록입니다. 태그가 지시하면 드라이버는 다시 쓰기도 합니다. 태그가 읽는 셀에 쓰거나, 태그 자체의 명령으로 씁니다.

SQL Server, PostgreSQL, MySQL과 MariaDB, SQLite에는 컴퓨터에 아무것도 설치하지 않고 연결합니다. 그 밖의 데이터베이스(Oracle, Access, Firebird 등)에는 그 데이터베이스의 ODBC 드라이버를 통해 연결하며, 그 드라이버의 64비트 버전이 컴퓨터에 설치되어 있어야 합니다.

주된 용도는 읽기이며, 그 경로는 짧습니다. 장치가 데이터베이스의 위치와 스테이션의 로그인 방법을 알려 주고, 스캔이 테이블의 열마다 태그를 제안하며, 모든 태그는 읽기 전용으로 만들어집니다. 쓰기에 관한 것은 태그의 접근이 스테이션의 쓰기를 허용한 뒤에만 그 태그에 나타납니다.

이 드라이버의 장치는 데이터베이스 하나입니다. 같은 서버의 데이터베이스 두 개는 장치 두 개입니다. 장치는 드라이버 아래에 놓이고 폴더로 정리할 수 있으며, 시리얼 회선도 브로커도 없는 다른 모든 드라이버와 마찬가지로 드라이버 → 폴더 → 장치 → 태그가 됩니다.

드라이버 페이지

머리글 아래 줄에는 "각 장치는 데이터베이스 하나를 읽습니다. 장치를 추가하고 데이터베이스의 위치와 스테이션의 로그인 방법을 입력한 다음 스캔하여 열을 태그로 추가하십시오."라고 적혀 있습니다. Connector 구성 권한이 있으면, 페이지에는 이 드라이버 고유의 스캔 범위 카드가 있어 스캔이 데이터베이스를 읽을 장치를 담습니다(장치 검색을 보십시오). 그 아래에는 다른 모든 드라이버와 같은 장치 표(장치 표를 보십시오)가 있으며, 제목 오른쪽의 장치 추가로 늘립니다. 비어 있으면 "아직 장치가 없습니다."라고 표시합니다. 드라이버 막대에는 장치 검색이 있으며, 스캔 범위 카드가 다 채워질 때까지 회색입니다. 이 드라이버는 파일과 데이터베이스 아래, File 드라이버 옆에 있습니다.

장치

이 드라이버의 장치에는 연결 카드가 없습니다. 그 자리에 데이터베이스 카드가 있고, 로그인이 없는 SQLite를 뺀 모든 데이터베이스에서는 이어서 로그인 카드가 있습니다. "장치" 카드의 읽기 주기 (ms)는 기본값이 1000이며 태그가 데이터베이스를 얼마나 자주 읽는지를 정하고, 다른 모든 드라이버와 마찬가지로 각 태그가 재정의할 수 있습니다.

새 장치는 서버가 없는 SQL Server입니다. "서버를 아직 입력하지 않음"이라고 표시하고, 페이지에는 "데이터베이스의 위치를 알려 주기 전까지 스테이션은 이 장치에 연결하지 않으므로, 아직 아무것도 읽지 않고 표시할 오류도 없습니다. 아래 데이터베이스 카드에 입력하면(서버와 데이터베이스 이름, 파일 또는 데이터 원본) 스테이션이 연결합니다."라고 표시되며, 위치를 알려 줄 때까지 아무것도 읽지 않습니다. 머리글에 보이는 기본 URI는 실행 시 주소로, 사용자도 비밀번호도 절대 담지 않습니다. SQL Server 인스턴스는 database://sqlserver?server=mes-sql&instance=SQLEXPRESS&database=MES, SQLite 파일은 database://sqlite?file=C%3A%5CData%5Crecipes.db, ODBC 데이터 원본은 database://odbc?source=ERP입니다.

"데이터베이스" 카드

고른 종류가 읽지 않는 필드는 표시되지 않으며, 읽게 될 때를 위해 값을 유지합니다. 다른 종류를 고르면, 이전 데이터베이스 자체의 포트로 남아 있던 포트가 비워져 새 데이터베이스는 자신의 포트로 연결됩니다. "서버" 칸은 데이터베이스 도구가 함께 쓰는 것을 나누어 읽습니다.

카드가 데이터베이스의 위치를 알려 주지 않는 동안 장치는 그대로 저장되어 대기하며, 회색 점으로 아무것도 읽지 않고 오류도 표시하지 않습니다.

카드가 받아들일 수 없는 설정은 카드 아래에 표시되며, 고칠 때까지 장치는 저장되지 않습니다.

저장에도 같은 규칙이 적용되며, 거부하면 피드가 알려 줍니다. "장치 'MES'에 드라이버가 사용할 수 없는 데이터베이스 설정이 있습니다. 장치를 열어 패널이 표시하는 필드를 고치십시오."

"로그인" 카드

SQLite를 뺀 모든 데이터베이스에는 로그인 카드가 있으며, 스테이션이 로그인할 사용자를 담습니다.

PostgreSQL과 MySQL에는 "암호화" 필드가 없습니다. 서버가 제공하면 연결이 암호화됩니다. 공장 서버에 흔한, 자체 인증서를 가진 SQL Server는 신뢰할 수 없는 기관이 발급한 인증서 체인에 관한 데이터베이스 자체의 말로 연결을 거부합니다. 그 서버가 요구하는 선택은 암호화, 모든 인증서 허용입니다.

필드 아래에서 카드는 어떤 사용자를 요청할지 알려 줍니다. "데이터베이스 관리자에게 스테이션에 필요한 권한만 가진 사용자를 요청하십시오. 읽기, 그리고 태그가 바꾸는 테이블에만 쓰기입니다." 스테이션은 그 사용자가 할 수 있는 모든 것으로 다른 시스템의 데이터를 읽고 쓰므로, 이 사용자가 스테이션이 바꿀 수 있는 것의 실제 한계입니다. 모든 쓰기는 다른 모든 드라이버와 마찬가지로 진단 로그에 기록됩니다.

사용자로 로그인하는 서버에 아직 사용자가 입력되지 않았으면 대신 "스테이션이 로그인할 사용자를 입력하십시오. 그전까지 스테이션은 이 장치에 연결하지 않습니다."라고 표시합니다. 이것은 거부가 아닙니다. 장치는 저장되며, 사용자가 입력될 때까지 그 오류는 데이터베이스 사용자가 아직 입력되지 않았다고 알려 줍니다.

온라인, 대기, 오프라인

각 장치는 자신만의 연결을 가집니다. 연결할 때 열리며 공유되거나 풀에 놓이지 않으므로, 서버가 끊은 연결이 다시 쓰이는 일은 없습니다.

서버 준비

네트워크로 쓰는 세 데이터베이스는 흔한 설치에서 다른 컴퓨터에 닫힌 채 출하됩니다. 다음 설정은 모두 서버를 관리하는 사람이 서버에서 합니다. 스테이션은 어느 것도 바꾸지 않습니다.

어느 경우든 서버 컴퓨터의 방화벽에서 데이터베이스 포트를 허용해야 합니다. 서버가 이 중 한 가지로 응답하면, 장치 페이지가 데이터베이스의 영어 오류 대신 어떤 설정인지를 이 절차와 이 장치의 값(포트, 인스턴스, 서버가 본 이 스테이션의 주소, pg_hba.conf 줄, MySQL 계정. 각각 복사 단추 포함)과 함께 알려 줍니다. 이 알림은 장치가 연결되거나 서버가 다르게 응답하면 저절로 사라집니다. 저널과 에이전트도 같은 절차를 읽습니다.

태그 주소 지정

태그가 읽는 방식

이 드라이버의 태그에는 자체 주소 입력란이 없습니다. 신호원 카드가 어떻게 읽을지 묻습니다.

새 태그는 테이블과 열을 키로 읽으며 Double입니다. 제공되는 형식은 Boolean, Int32, Int64, Float, Double, String, DateTime입니다. 셀을 읽을 때 정수 태그는 소수부가 있는 값을 반올림하지 않고 거부하며(쓰기는 그 반대이며 쓰기 참조), 텍스트는 숫자일 때만 숫자로 읽습니다. 모든 태그는 읽기 전용으로 만들어지며, 쓰기가 더하는 것은 쓰기에 있습니다.

테이블과 열

이름은 데이터베이스가 읽는 대로 읽힙니다.

드라이버는 이름의 각 부분을 그 데이터베이스가 받아들이는 따옴표로 감싸므로, 이름이 텍스트로 문에 붙여 넣어지는 일은 없습니다. 필드가 작동할 수 없는 태그는 저장되지 않으며, 그 페이지가 빠진 것을 알려 줍니다.

읽기 전용인 신호원 주소 (버스) 줄은 드라이버가 받는 것을 보여 줍니다. 키로 선택한 행이면 row?table=dbo.ProductionOrders&column=Quantity&key=OrderNo&equals=4711, 최신 행이면 newest?table=recipe_setpoints&column=oven_temperature&by=updated_at입니다.

자체 쿼리

쿼리는 데이터베이스가 읽는 대로 읽힙니다. 따옴표로 감싼 텍스트, 따옴표로 감싼 이름, 주석 안에 있는 것은 문의 단어가 아닙니다. 읽기 이상을 하는 쿼리는 입력한 곳에서 거부됩니다.

쿼리 태그의 버스 주소는 query?sql= 뒤에 퍼센트 인코딩한 쿼리가 붙습니다.

읽기

읽기에 실패해도 태그는 마지막 읽은 값을 유지하며, 그 값은 다른 모든 드라이버와 마찬가지로 읽기 주기에 10 s를 더한 시간보다 오래되면 실패로 셉니다. 데이터베이스에는 읽을 때마다 묻습니다. 다른 프로그램이 바꾼 것은 바꾼 순간이 아니라 다음 읽기에서 보입니다.

쓰기

태그는 접근이 읽기와 쓰기나 쓰기 전용이 된 뒤에만 씁니다. 그때 신호원 카드에 쓰기가 무엇을 하는지가 더해집니다.

쓰기 명령을 실행하는 쓰기 전용 태그는 아무것도 읽지 않으므로, 그 신호원 카드에는 쓰기만 있습니다.

드라이버가 실행할 수 없는 명령은 태그 페이지에서 거부됩니다.

@@로 시작하는 이름(SQL Server의 함수)과 EXEC의 인수 이름(@speed = @value)은 값이 아니며 쓴 그대로 남습니다. 저장에도 같은 규칙이 적용되며, 태그를 거부하면 피드가 알려 줍니다. "태그 'Order quantity'이(가) 데이터베이스에서 값의 위치를 알려 주지 않거나, 드라이버가 거부하는 쿼리나 쓰기 명령을 가지고 있습니다. 태그를 열어 태그 패널이 표시하는 필드를 고치십시오."

버스 주소에는 쓰기가 더해집니다. 셀이면 row?table=recipes&column=setpoint&key=code&equals=R-100&write=cell, 명령을 실행하는 쓰기 전용 태그면 none?write=command&command= 뒤에 명령이 붙습니다.

장치 검색

"스캔 범위" 카드

Connector 구성 권한이 있으면 드라이버 페이지에는 스캔 범위 카드가 있고, 그 아래에 "장치와 같은 방법으로 로그인하여, 테이블의 열마다 최신 행이나 키가 가장 작은 행의 태그를 제안합니다."라는 줄이 있습니다.

장치가 없는 드라이버에는 "데이터베이스는 로그인 정보를 가진 장치를 통해 스캔합니다. 이 드라이버의 장치를 추가하고 데이터베이스의 위치를 입력하십시오."만 표시됩니다. 범위에 아직 빠진 것은 카드 아래에 빨간색으로 표시되며, 범위가 다 채워질 때까지 장치 검색은 회색으로 남습니다.

스캔할 장치에 저장할 수 없는 편집이 있으면 스캔은 시작하지 않습니다. "스캔할 장치의 편집을 저장하지 못해 장치 검색을 시작하지 않았습니다."

스캔이 제시하는 것

스캔은 장치와 같은 방법으로 로그인하고, 데이터베이스 자체가 가진 테이블과 뷰(시스템 것은 제외)와 그 열의 목록을 읽으며, 읽는 테이블을 "recipes의 열을 읽는 중…"처럼 알려 줍니다. 후보는 하나로, 장치 자체가 이미 설정됨으로 표시됩니다. 그 카드에는 장치의 어떤 태그도 아직 읽지 않는 열이 체크된 채 나열되며, 열기 앞에 있는 태그로 추가가 체크한 것을 읽기 전용으로 장치에 추가합니다.

태그는 테이블과 열의 이름을 받고(recipes.oven_temperature), 열의 형식에 맞는 형식을 가지며, 모두 읽기 전용입니다. 스캔은 테이블 최대 100개, 값 최대 500개를 읽으며, 거기서 잘린 스캔은 "Recipes의 스캔이 일찍 멈췄습니다. 스캔은 테이블 최대 100개, 값 최대 500개를 읽습니다. 나머지를 보려면 테이블 이름이나 패턴을 지정하십시오."라고 알려 줍니다. 스캔의 다른 동작은 장치 검색에 있습니다.

장치 자신의 페이지도 드라이버 페이지 없이 같은 일을 합니다. 태그 카드 머리의 태그 검색은 장치와 똑같이 로그인해 저장된 그대로 데이터베이스를 스캔하고, 아직 태그가 없는 열만 제시합니다(장치의 태그 검색 참고).

예: SQL Server의 생산 지시

MES는 생산 지시를 SQL Server의 MES 데이터베이스, dbo.ProductionOrders 테이블에 지시 번호마다 한 행으로 둡니다.

1. 드라이버 페이지에서 장치 추가를 누르고 이름을 MES로 합니다. 데이터베이스 카드에서 SQL Server를 그대로 두고, 서버에 mes-sql(명명된 인스턴스라면 mes-sql\SQLEXPRESS)을 입력하고, 포트는 비워 두고, 데이터베이스 이름에 MES를 입력합니다.
2. 로그인 카드에서 사용자 이름에 station_reader와 그 비밀번호를 입력하거나, 스테이션의 Windows 계정으로 로그인을 켭니다. 자체 인증서를 가진 공장 서버라면 암호화, 모든 인증서 허용을 고릅니다.
3. 태그 추가로 Order quantity, Int32: 테이블 dbo.ProductionOrders, 값 열 Quantity, 읽을 행 키로 선택, 키 열 OrderNo, 키 값 4711. 버스 주소는 row?table=dbo.ProductionOrders&column=Quantity&key=OrderNo&equals=4711입니다.
4. 태그 추가로 Product, String, 같은 테이블과 행에서 값 열은 ProductCode. 두 태그는 쿼리 하나로 읽힙니다.

도구로는 다음과 같습니다.

device_upsert name=MES driver=Database databaseKind=SqlServer host="mes-sql\SQLEXPRESS" databaseName=MES username=station_reader password=<password> databaseEncryption=TrustServerCertificate
tag_upsert device=MES name="Order quantity" opcUaType=Int32 databaseTable=dbo.ProductionOrders address=Quantity databaseRow=Key databaseKeyColumn=OrderNo databaseKeyValue=4711
tag_upsert device=MES name=Product opcUaType=String databaseTable=dbo.ProductionOrders address=ProductCode databaseRow=Key databaseKeyColumn=OrderNo databaseKeyValue=4711

예: PostgreSQL의 레시피 설정값

레시피 시스템은 설정값이 바뀔 때마다 recipe_setpoints에 행을 추가하고, updated_at 열에 날짜를 넣습니다.

1. 장치 추가를 누르고 이름을 Recipes로 합니다. 데이터베이스 종류 PostgreSQL, 서버 recipes-db, 포트는 비워 두고(PostgreSQL의 5432), 데이터베이스 이름 recipes, 그리고 로그인 카드에서 사용자 이름과 비밀번호를 입력합니다.
2. 태그 추가로 Oven setpoint, Double: 테이블 recipe_setpoints, 값 열 oven_temperature, 읽을 행 최신 행, 날짜 열 updated_at.

새 행은 태그의 다음 읽기에서 읽힙니다. PostgreSQL은 단순한 이름을 소문자로 읽으므로, 대문자로 만든 열(OvenTemp 등)은 따옴표로 감싸 "OvenTemp"로 씁니다. 도구로는 다음과 같습니다.

device_upsert name=Recipes driver=Database databaseKind=PostgreSql host=recipes-db databaseName=recipes username=station password=<password>
tag_upsert device=Recipes name="Oven setpoint" opcUaType=Double databaseTable=recipe_setpoints address=oven_temperature databaseRow=Newest databaseDateColumn=updated_at

예: INSERT로 쓰는 결과 행

품질 시스템은 측정한 부품마다 test_results 테이블에 행 하나를 원합니다.

1. 그 데이터베이스의 장치에서 태그 추가로 Result, Double, 접근은 쓰기 전용으로 합니다.
2. 쓰기 동작은 쓰기 명령을 실행으로 하고, 쓰기 명령에는 행을 추가하는 INSERT INTO test_results (result, recorded_at) VALUES (@value, @now)를 씁니다.

Logic이 Result에 쓰는 값은 저마다 별도의 행이 되며, 옆에 스테이션의 날짜와 시간이 들어갑니다. 연달아 일어난 쓰기도 모두 순서대로 남고, 새 쓰기 때문에 버려지는 것은 없습니다. 셀을 읽는 읽기와 쓰기 태그라면 쓸 때마다 그 한 행을 바꿉니다. 도구로는 다음과 같습니다.

tag_upsert device=Quality name=Result opcUaType=Double accessType=WriteOnly databaseWriteMode=Command databaseCommand="INSERT INTO test_results (result, recorded_at) VALUES (@value, @now)"

예: ODBC를 통한 Access와 Oracle

장치가 지정한 데이터 원본이나 드라이버가 32비트 프로그램용으로만 있거나(32비트 Office의 Access, ODBC 데이터 원본(32비트)에서 만든 데이터 원본 등) 이 컴퓨터에 아예 없으면, 장치 패널은 장치가 지정한 이름과 함께 둘 중 어느 경우인지 알려 주고, 장치가 켜져 있고 연결되지 않는 동안 전체 안내를 보여 줍니다. 장치의 오류도 영어로 같은 내용을 알려 주며, driver_capabilities도 Database 드라이버의 prerequisite(perDevice가 true)에서 같은 내용을 알려 줍니다.

알림 끝에는 이 컴퓨터에 있는 64비트 ODBC 드라이버가 Driver={...}에 쓰는 이름으로 나열됩니다. 64비트 쪽에 있는데도 실패하는 데이터 원본이나 드라이버는 드라이버 관리자 자체의 오류를 보여 줍니다.

ODBC를 통하면 단순한 이름은 데이터베이스가 읽는 대로(Oracle에서는 대문자로) 읽히고, 따옴표로 감싼 이름은 그대로 읽힙니다. 날짜와 시간은 모든 ODBC 드라이버가 받아들이는 가장 세밀한 단위인 초 단위로 보냅니다. 도구로는 다음과 같습니다.

device_upsert name="Plant book" driver=Database databaseKind=Odbc databaseOdbc="Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=C:\Data\plant.accdb"
device_upsert name=ERP driver=Database databaseKind=Odbc databaseOdbc=ERP username=STATION password=<password>

에이전트 도구

driver_capabilities는 이 드라이버를 database 아래에서 설명합니다. 간단한 경로, 각 데이터베이스와 그 필드와 자체 포트, 암호화 선택, 태그가 읽는 두 가지 방식과 쓰는 두 가지 방식, 값은 @value나 @now로만 문에 들어간다는 규칙, 형식, 대기 시간, 데이터베이스 사용자에 관한 조언, 장치 검색, 그리고 네 가지 완전한 예입니다. device_upsert driver=Database는 databaseKind(기본값 SqlServer, PostgreSql, MySql, Sqlite, Odbc)를 받고, 서버에서는 host(SQL Server의 server\INSTANCE나 server,port는 나누어 읽습니다), port, databaseName, SQL Server에서는 추가로 databaseInstance, databaseWindowsSignIn, databaseEncryption(Verified, TrustServerCertificate, Off), SQLite에서는 databaseFile, ODBC에서는 databaseOdbc, 그리고 username과 절대 돌려주지 않는 password를 받습니다. 돌려주는 장치에는 database가 있으며, 거기에 주소와 장치가 아직 사용자를 기다리는지가 담깁니다. tag_upsert는 값 열을 address로, databaseSource(Fields나 Query), databaseTable, databaseRow(Key나 Newest), databaseKeyColumn, databaseKeyValue, databaseDateColumn, databaseQuery, 그리고 accessType이 쓸 때는 databaseWriteMode(Cell이나 Command)와 databaseCommand를 받습니다. 새 태그는 opcUaType으로 달리 지정하지 않으면 읽기 전용인 Double입니다. device_discover driver=Database는 이 드라이버의 설정된 장치 이름인 databaseDevice와, 선택 사항인 databaseTables(테이블 이름이나 *를 쓰는 패턴)를 받습니다. 장치에 빠진 태그는 tag_upsert로 추가합니다. connector_browse는 각 장치의 databaseKind를 돌려줍니다. 다른 도구는 에이전트 도구에 있습니다.

알아 둘 한계

• 드라이버는 태그의 값을 태그마다 하나씩 읽고 씁니다. 스테이션의 실행 기록을 데이터베이스에 기록하지는 않습니다. 일련번호, 판정, 측정값을 담은 실행마다의 행 하나는 이 드라이버가 쓰는 것이 아닙니다.
• 제품에는 ODBC 드라이버가 들어 있지 않습니다. Oracle, Access, Firebird 등 직접 연결하는 네 가지 이외의 데이터베이스에는 그 데이터베이스 자체의 64비트 ODBC 드라이버를 컴퓨터에 설치해야 합니다. 32비트 드라이버는 보이지 않습니다.
• 장치는 Windows 비밀번호를 저장하지 않습니다. SQL Server에 대한 Windows 로그인과 네트워크 공유에 있는 SQLite 파일은 스테이션을 실행하는 계정을 쓰므로, 데이터베이스나 공유는 그 계정을 받아들여야 합니다.
• 쿼리는 읽기만 합니다. 데이터베이스를 바꾸는 것은 쓰기이며, 쓰기는 접근이 쓰기를 허용하는 태그에서만 일어납니다.
• 값이 문의 본문에 들어가는 일은 없습니다. 쓸 값은 항상 매개 변수 @value, 스테이션의 날짜와 시간은 @now이며, 키 값도 매개 변수입니다. 그 밖의 값을 이름으로 쓰는 문은 거부됩니다.
• 셀 쓰기는 정확히 한 행을 바꿉니다. UPDATE 명령에는 WHERE가 필요합니다.
• 데이터베이스에는 읽을 때마다 묻습니다. 다른 프로그램이 바꾼 것은 다음 읽기에서 보이며, 같은 행의 태그가 많은 데이터베이스에는 한 번의 순회에서 그 모두에 대해 한 번만 묻습니다.
• 이진 열은 읽지 않습니다.