Omron Microsoft SQL connection to Sysmac NJ Quick Start Guide

Omron Microsoft SQL connection to Sysmac NJ Quick Start Guide
Microsoft SQL connection to Sysmac NJ
Quick Start Guide
This Quick Start will show you how to connect to a Microsoft SQL database – it will not show you how
to set up the database.
Watch the corresponding video on YouTube: Connect Sysmac NJ to Microsoft SQL Server
http://youtu.be/ys3Mn2zP-wA
Introduction:
The NJ501 series controllers have three new part numbers NJ501-1320, 1420, and 1520 which have the ability
to send data directly to a Microsoft SQL database and an Oracle SQL database.
This Quick Start will show you how to connect to a database – it will not show you how to set up the database.
Why the need for database connection?
Assembly lines need easy and fast way to log or get data on the assembly line for production and product data.
Why direct from PLC?
Assembly lines last up to 10 years. Very difficult to maintain a SCADA package for 10 years. The computer will
not last that long and it is difficult to find someone to support a 10 year old version of a SCADA package.
Computers take a long time to boot – lost production time.
Computers need updates – IT has to service – no guarantee an update will not adversely affect the
performance of the unit.
Why SQL type data bases:
SQL databases accept many connections at once unlike databases like Microsoft Access which only allow one
user at a time. Many PLC’s can send data at once and many people can get data from the database at once.
Other Features:
The NJ can store the data to a spool file (1Mbyte in NJ memory) if connection to data base is lost.
The NJ can log commmands and responses to files on the NJ SD card which come in handy to debug the
logging error.
Versions Required:
Sysmac Studio V1.06 with database patch or V1.07.
Document: QSG Microsoft SQL connection to Sysmac NJ Page 1 of 12 Example of How to Connect to Microsoft SQL
Setup:
In this example my laptop has IP address 192.168.250.9 and has Microsoft SQL installed on it.
NJ uses address 192.168.250.1
Introduction:
The SQL DB connection is setup in the “Configurations and Setup” in Sysmac Studio.
Show “ Host Connection Setting” in the setup section of Sysmac Studio. This lets you test and setup your
connection to the SQL Host.
• DB Connection Service Settings – specify error files and enable service
• DB Connection Settings – set logon to SQL server
Under DB Connection Service Setting – pick “Auto Start” to make the SQL service start on power up. Test
mode will send all SQL commands to SD memory card and all the program instructions will assume connect or
data transfer was good – for debugging.
Execution Log, Debug Log, and SQL Execution Failure Log all go to the SD card.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 2 of 12
If you right click on “DB Connection” then you can see the Operation Logs – assuming you have a least tried to
log on or safe a record. You must be online to see the files.
An “Operation Log” Window will open. There are three tabs – one for each of the log types.
Pressing “Upload” at the bottom of the screen will bring up a list of log files that exist on the SD card.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 3 of 12
Select on of the files an press “OK”
The Operation Log is good for seeing when services start and stop.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 4 of 12
The operation log shows when the database commands occurred – good for the line programmer.
The SQL Execution Failure Log shows the (to and from) SQL commands – good for IT and high level NJ/SQL
programmer. These logs are good for showing why a log did not happen – i.e. empty field on a field that cannot
be empty.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 5 of 12
How to create the connection profile:
Go to “DB Connection Settings – Right Click – “Add” – “DB Connection Settings”. This will create a new
connection setting – in this case “NJEXPRESS” is what I labeled this connection setting – “Connection Name”.
Database Type: SQL Server for Microsoft SQL and Oracle for Oracle SQL.
Server Specification Method: IP address or Host name of the computer the SQL server is on.
Instance Name/Port Number: 1433 is the default. You do not need to specify if it is the default.
Service Name/Database Name: You must enter the database name here as specified by IT people. You can
omit the name if the user has been set by default to the correct Service/Database within SQL.
You must then enter the Login Name and Password as given by IT people.
You can now press the Communications Test Button.
“Test OK” will show if successful.
In this case the controller was not connected to the SQL server so an error message is shown.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 6 of 12
Ladder Code to send data to SQL:
You have created a connection setup log into the SQL data base and tested it.
Now we want to add ladder code to send data to/from the SQL server.
There is 3 basic parts to this step:
1) DB_Connect and DB_Close instructions to log in and log out of the SQL the database.
2) A DB_CreateMapping instruction to create a map between NJ Tags and SQL fields/Table.
3) DB_Insert/Select/Delete/Update instructions.
• Insert:
to append data to the table
• Select:
which allows you to query data from the table
• Delete:
delete a record.
• UpDate:
modify a record.
This is an example of how to write the connection program:
The _DBC_Status.Run bit lets you know the DB service has actually started up and is running.
‘NJEXPRESS’ with single quotes is how you specify the DB Connection you want to connect use.
The “Done” bit lets you know if you successfully connected to the database/table.
The SQL_DBConnection variable is the reference variable to this database connection for all the other
instructions including SQL_Close.
It is a good idea to close the database when the controller is about to shut down.
The next step is to map the NJ Tags to the Database Tables Fields
DBConnection: This came from the “DB_Connect Instruction” – unique number identifier for each connection.
TableName: This is the name of the Table you want to send data to/from in the SQL server.
SQLType: Enter one of the following: DBC_SQLTYPE_INSERT, DBC_SQLTYPE_SELECT,
DBC_SQLTYPE_DELETE, DBC_SQLTYPE_UPDATE.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 7 of 12
You must enter a unique variable name for “MapVar” even if it is for the same table – or only the last one will
work. The MapVar must be of a structure type. Here is an example of an NJ Structure and the SQL table. In
this case under Table4 of Database NJEXPRESS you will see Barcode, Qty, and Timestamp.
The SQL_Insert_Type is exactly the same. The member names must match exactly the field names in the SQL
database. You do not have to have all the field names – nor do they have to be in order. The variable types
will not match exactly and the manual shows you how to match them up. I have included most of the table
below.
The “done” output in the DB_Mapping means nothing. No data transfer occurs with the SQL database. It does
not mean the mapping was good.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 8 of 12
Data Type
Data Type specified
in IEC 61131
Oracle
SQL Server
Boolean / bit string
BOOL
NUMBER(1)
bit
BYTE
RAW
varbinary
WORD
RAW
varbinary
DWORD
RAW
varbinary
LWORD
RAW
varbinary
SINT
NUMBER(3)
tinyint
INT
NUMBER(5)
smallint
DINT
NUMBER(10)
int
LINT
NUMBER(20)
bigint
USINT
NUMBER(3)
smallint
UINT
NUMBER(5)
int
UDINT
NUMBER(10)
bigint
ULINT
NUMBER(20)
decimal
REAL
NUMBER
BINARY_FLOAT
real
LREAL
NUMBER BINARY_DOUBLE
float
TIME
TIMESTAMP
time
DATE
TIMESTAMP
date
TIME_OF_DATE
TIMESTAMP
time
DATE_AND_TIME
TIMESTAMP
datetime
STRING
VARCHAR2
NVARCHAR2 <A03>
varchar
nvarchar
Signed integers
Unsigned integers
Real
Time of day, duration,
date
Text string
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 9 of 12
To Insert Data into the SQL database:
The DB_Insert instruction needs two reference inputs:
• DB_Connection comes from the DB_Connect instruction.
• MapVar is the same variable we used in the DB_CreateMapping instruction.
• With these two pieces of information the insert instruction know which database, table, and
fields to add the data too.
• The “done” output does tell you if the data was successfully sent to the SQL database.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 10 of 12
To Select Data from the database:
The DB_Select instruction does this for us. It works mostly the same as DB_Insert with two major differences.
The MapVar can be an array. (Notice there is not “[0]” at the end of the variable name when it is an array.
There is a “Where” input to filter which records you are looking for. (There is also a sort input).
There are two counters at the bottom right corner of the instruction to tell you how many records it found and
how many it gave to you (if your array was to small it just gives you enough to fill the array.)
Notes on how to use the “Where” are below.
Both SQL and Sysmac Studio use ‘ ‘ in their syntex. To let Sysmac Studio the ‘ is for Oracle put a $’.
So the following first example means: BARCODE LIKE ‘B%’ to Oracle. The % is a wildcard to Oracle when the
“LIKE” is included.
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 11 of 12
Here is an example of the Select type Variable for the answer – notice how it is an array so we can accept
more than one record from the select query.
Here is the data type:
This completes the Quick Start for the
Connect Sysmac NJ to Microsoft SQL Server
Please visit our YouTube Channel for Omron Quick Tip and other videos:
https://www.youtube.com/user/OmronAutomationTech
Document: QSG Microsoft SQL connection to Sysmac NJ
Page 12 of 12
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement