Как я могу запросить необработанные данные из Proficy Historian?

Как я могу получить необработанные данные временных рядов из Proficy Historian/iHistorian?

В идеале я бы попросил данные для конкретного тега между двумя датами.

4 ответа

Решение

Есть несколько различных режимов выборки, с которыми вы можете поэкспериментировать.

  • необработанный
  • интерполяция
  • лаборатория
  • тенденция
  • вычисленный

Эти режимы доступны с использованием всех следующих API.

  • Пользовательский API (ihuapi.dll)
  • SDK (ihsdk.dll)
  • OLEDB (iholedb.dll)
  • API клиентского доступа (Proficy.Historian.ClientAccess.API)

Из них, вероятно, вам нужен режим выборки тренда, так как он специально разработан для построения графиков / трендов. Тем не менее, лабораторные и интерполированные могут быть также полезны.

Прочитайте электронную книгу для получения дополнительной информации о каждом режиме отбора проб. На моей машине он хранится как C:\Program Files\GE Fanuc\Proficy Historian\Docs\iHistorian.chm и у меня установлена ​​версия 3.5. Обратите особое внимание на следующие разделы.

  • Использование Historian OLE DB Provider
  • Расширенные темы | поиск

Вот как вы можете построить OLEDB для выборки трендов.

set 
    SamplingMode = 'Trend',
    StartTime = '2010-07-01 00:00:00',
    EndTime = '2010-07-02 00:00:00',
    IntervalMilliseconds = 1h
select 
    timestamp, 
    value, 
    quality 
from 
    ihRawData 
where 
    tagname = 'YOUR_TAG'

Отображение эквивалентных методов с использованием пользовательского API и SDK является сложным (в большей степени с пользовательским API), поскольку для их настройки требуется большой объем кода в коде. API клиентского доступа является более новым и использует WCF за кулисами.

Кстати, у метода OLEDB есть несколько ограничений.

  • Несмотря на то, что написано в документации, мне никогда не удавалось заставить работать параметры собственного запроса. Это демонстрационный шаг, если вы хотите использовать его, например, со службами отчетов SQL Server.
  • Вы не можете записывать образцы в архив или каким-либо образом вносить изменения в конфигурацию Historian, включая добавление / изменение тегов, написание сообщений и т. Д.
  • В некоторых случаях это может быть немного медленным.
  • Он не предусматривает перекрестную привязку нескольких тэгов к столбцам и последующую передачу сэмплов, чтобы существовало значение для каждой комбинации меток времени и тэгов. Режим сэмплирования трендов ведет вас на полпути, но все еще не пересекает таблицу и фактически не загружает необработанные сэмплы. С другой стороны, пользовательский API и SDK также не могут этого сделать.

Мой коллега соединил это:

В web.config:

<add name="HistorianConnectionString" 
     providerName="ihOLEDB.iHistorian.1" 
     connectionString="
       Provider=ihOLEDB.iHistorian;
       User Id=;
       Password=;
       Data Source=localhost;"
/>

На уровне данных:

public DataTable GetProficyData(string tagName, DateTime startDate, DateTime endDate)
{
    using (System.Data.OleDb.OleDbConnection cn = new System.Data.OleDb.OleDbConnection())
    {
        cn.ConnectionString = webConfig.ConnectionStrings.ConnectionStrings["HistorianConnectionString"];
        cn.Open();

        string queryString = string.Format(
                "set samplingmode = rawbytime\n select value as theValue,Timestamp from ihrawdata where tagname = '{0}' AND timestamp between '{1}' and '{2}' and value > 0 order by timestamp",
                tagName.Replace("'", "\""), startDate, endDate);

        System.Data.OleDb.OleDbDataAdapter adp = new System.Data.OleDb.OleDbDataAdapter(queryString, cn);
        DataSet ds = new DataSet();

        adp.Fill(ds);
        return ds.Tables[0];
    }
}

Обновить:

Это работало хорошо, но мы столкнулись с проблемой с тегами, которые обновляются не очень часто. Если бы тег не обновлялся вблизи начала или конца запрошенных startDate и endDate, тренды выглядели бы плохо. Хуже того, все еще были случаи, когда во время запрошенного окна не было явных точек - мы не получили никаких данных.

Я решил это, сделав три запроса:

  1. Предыдущее значение перед датой начала
  2. Точки между startDate и endDate
  3. Следующее значение после endDate

Это потенциально неэффективный способ сделать это, но он работает:

public DataTable GetProficyData(string tagName, DateTime startDate, DateTime endDate)
{
    DataSet ds = new DataSet();
    string queryString;
    System.Data.OleDb.OleDbDataAdapter adp;

    using (System.Data.OleDb.OleDbConnection cn = new System.Data.OleDb.OleDbConnection())
    {
        cn.ConnectionString = proficyConn.ConnectionString;
        cn.Open();

        // always get a start value
        queryString = string.Format(
             "set samplingmode = lab\nselect value as theValue,Timestamp from ihrawdata where tagname = '{0}' AND timestamp between '{1}' and '{2}' order by timestamp",
            tagName.Replace("'", "\""), startDate.AddMinutes(-1), startDate);
        adp = new System.Data.OleDb.OleDbDataAdapter(queryString, cn);
        adp.Fill(ds);

        // get the range
        queryString = string.Format(
             "set samplingmode = rawbytime\nselect value as theValue,Timestamp from ihrawdata where tagname = '{0}' AND timestamp between '{1}' and '{2}' order by timestamp",
            tagName.Replace("'", "\""), startDate, endDate);
        adp = new System.Data.OleDb.OleDbDataAdapter(queryString, cn);
        adp.Fill(ds);

        // always get an end value
        queryString = string.Format(
             "set samplingmode = lab\nselect value as theValue,Timestamp from ihrawdata where tagname = '{0}' AND timestamp between '{1}' and '{2}' order by timestamp",
        tagName.Replace("'", "\""), endDate.AddMinutes(-1), endDate);
        adp = new System.Data.OleDb.OleDbDataAdapter(queryString, cn);
        adp.Fill(ds);

        return ds.Tables[0];
    }
}

И да, я знаю, эти запросы должны быть параметризованы.

Майкл - в IP21 есть таблица "Интерполированный", а также "фактическая" таблица точек данных. Есть ли у Proficy это?

Мы написали DLL-оболочку, которая выглядела примерно так:

[DllImport("IHUAPI.dll", CallingConvention = CallingConvention.StdCall, EntryPoint = "ihuReadRawDataByTime@24")]
public static extern int ihuReadRawDataByTime(int serverhandle, string tagname, ref IHU_TIMESTAMP startTime, ref IHU_TIMESTAMP endTime, ref int noOfSamples, ref IHU_DATA_SAMPLE* dataValues);
...
private int _handle;

public HistorianTypes.ErrorCode ReadRawByTime(string tagName, DateTime startTime, DateTime endTime,
                                              out double[] timeStamps, out double[] values, out IhuComment [] comments)
{
    var startTimeStruct = new IhuApi.IHU_TIMESTAMP();  //Custom datetime to epoch extension method
    var endTimeStruct = new IhuApi.IHU_TIMESTAMP();

    int lRet = 0;
    int noOfSamples = 0;
    startTimeStruct = DateTimeToTimeStruct(dstZone.ToUniversalTime(startTime));
    endTimeStruct = DateTimeToTimeStruct(dstZone.ToUniversalTime(endTime));
    IhuApi.IHU_DATA_SAMPLE* dataSample = (IhuApi.IHU_DATA_SAMPLE*)new IntPtr(0);

    try {
        lRet = IhuApi.ihuReadRawDataByTime
            (
                _handle, // the handle returned from the connect
                tagName, // the single tagname to retrieve
                ref startTimeStruct, // start time for query
                ref endTimeStruct, // end time for query
                ref noOfSamples, // will be set by API
                ref dataSample // will be allocated and populated in the user API
            );
            ....

Некоторые замечания заключаются в том, что iFIX будет проверять, загружена ли DLL при запуске, поэтому вам нужно выполнять такие вещи, как динамическая загрузка / выгрузка DLL, чтобы другие приложения не зависали. Мы сделали это, удалив / добавив ключи реестра на лету.

Еще один вариант: если вы опросите 10000 образцов, а один из образцов будет поврежден, все 10 000 образцов будут отброшены. Вам необходимо реализовать обработчик неверных данных, который будет запускаться по обе стороны от неверных данных и постепенно увеличиваться, чтобы получить все данные по обе стороны от неверного образца.

Существует несколько заголовочных файлов C, которые содержат все коды ошибок и заголовок функции для DLL.

Другие вопросы по тегам