blpsrv

Связь Сервера Bloomberg V3

Описание

Функция blpsrv создает объект blpsrv. Объект blpsrv представляет связь Сервера Bloomberg®.

Другие функции соединяются с различными сервисами Bloomberg: Рабочий стол Bloomberg (blp), Bloomberg B-PIPE® (bpipe) и Лицензия Данных Bloomberg (bdl). Для получения дополнительной информации об этих сервисах, смотрите Сравнение Связей Bloomberg.

Для получения дополнительной информации о требованиях связи Bloomberg, смотрите Требования Связи Сервера данных. Чтобы гарантировать успешную связь Bloomberg, выполните необходимые шаги прежде, чем выполнить blpsrv. Для получения дополнительной информации смотрите Установку Bloomberg и Конфигурирование Связей.

Создание

Синтаксис

c = blpsrv(uuid,ipaddress)
c = blpsrv(uuid,ipaddress,port)
c = blpsrv(uuid,ipaddress,port,timeout)

Описание

пример

c = blpsrv(uuid,ipaddress) создает объект c связи Сервера Bloomberg к Серверу Bloomberg, работающему на другой машине, и устанавливает свойства Uuid и IPAddress. Вам нужна лицензия на программное обеспечение Сервера Bloomberg для машины, запускающей Сервер Bloomberg.

пример

c = blpsrv(uuid,ipaddress,port) также устанавливает Свойство портов.

пример

c = blpsrv(uuid,ipaddress,port,timeout) также устанавливает Свойство Timeout.

Внимание:

Чтобы относиться к связи Bloomberg в других функциях, используйте объект связи, созданный функцией blpsrv. В противном случае с помощью blpsrv, когда входной параметр открывает несколько связей Bloomberg, вызывая неожиданное поведение и исчерпывая ресурсы памяти.

Свойства

развернуть все

Пользовательская идентичность Bloomberg UUID, заданный в виде числа. Чтобы найти ваш UUID, введите IAM в терминал Bloomberg и нажмите GO.

Пример: 12345678

Типы данных: double

Это свойство доступно только для чтения.

Пользователь Bloomberg, заданный как пользовательский единичный объект Bloomberg.

Пример: [1x1 com.bloomberglp.blpapi.impl.aT]

Это свойство доступно только для чтения.

IP-адрес машины рабочий MATLAB, заданный как вектор символов.

Пример: '111.11.11.111'

Типы данных: char

Это свойство доступно только для чтения.

Сеанс Bloomberg V3, заданный как объект Bloomberg V3 API Session.

Пример: [1x1 com.bloomberglp.blpapi.Session]

IP-адрес Сервера Bloomberg, заданный как вектор символов или скаляр строки, который идентифицирует машину, запускающую Сервер Bloomberg.

Пример: '111.11.11.111'

Типы данных: char | string

Номер порта, заданный в виде числа, которое идентифицирует номер порта машины, запускающей Сервер Bloomberg.

Пример: 8194

Типы данных: double

Тайм-аут, задающий время в миллисекундах, которые MATLAB пытается соединить с машиной, запускающей Сервер Bloomberg перед таймаутом, заданным в виде числа.

Пример: 10

Типы данных: double

Тип данных даты и времени, заданный как одно из этих значений.

ЗначениеОписание
'' (значение по умолчанию)Дата возвращения и временные стоимости как числа даты MATLAB.
'datetime'Дата возвращения и временные стоимости как массив datetime.

Можно задать эти значения с помощью вектора символов или строки (например, "datetime").

Когда вы создаете объект blpsrv, функция blpsrv оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например:

c.DatetimeType = 'datetime';
Затем можно использовать эти поддерживаемые функции:

  • getbulkdata

  • getdata

  • history

  • tahistory

  • timeseries

    Примечание

    Если значением свойства DataReturnFormat является 'table', и значением свойства DatetimeType является 'datetime', то возвращенные данные являются таблицей, которая содержит значения даты и времени как массив datetime. Если значение свойства DataReturnFormat является пустым символьным вектором, то установка свойства DatetimeType к 'datetime' возвращает значения даты и времени для агрегированных меток деления и исторических запросов как числа даты MATLAB.

Данные возвращают формат, заданный как одно из этих значений, которые определяют тип данных возвращенных данных.

ЗначениеТип данных возвращенных данных
'cell'cell array
'table'table
'timetable'timetable
'structure'structure

Примечание

Тип данных по умолчанию возвращенных данных зависит от выполняемой функции. Чтобы задать тип данных по умолчанию, установите свойство DataReturnFormat на ''. Для типов данных по умолчанию см. поддерживаемый функциональный список.

Можно задать эти значения с помощью вектора символов или строки (например, "table").

Когда вы создаете объект blpsrv, функция blpsrv оставляет этот сброс свойства. Чтобы получить данные, необходимо установить это значение свойства вручную в командной строке или в скрипте с помощью записи через точку, например:

c.DataReturnFormat = 'structure';
Затем можно использовать эти поддерживаемые функции.

Поддерживаемая функцияДопустимые типы данных для возвращенных данных
category
  • cell array (значение по умолчанию)

  • structure

  • table

eqs
  • cell array (значение по умолчанию)

  • structure

  • table

fieldinfo
  • cell array (значение по умолчанию)

  • structure

  • table

fieldsearch
  • cell array (значение по умолчанию)

  • structure

  • table

lookup
  • structure (значение по умолчанию)

  • table

portfolio
  • structure (значение по умолчанию)

  • table

getbulkdata
  • structure (значение по умолчанию)

  • table

  • timetable

getdata
  • structure (значение по умолчанию)

  • table

  • timetable

history
  • числовой массив (значение по умолчанию)

  • table

  • timetable

tahistory
  • structure (значение по умолчанию)

  • table

  • timetable

timeseries
  • cell array (значение по умолчанию для необработанных тиковых данных)

  • числовой массив (значение по умолчанию для тиковых данных интервала)

  • table

  • timetable

Примечание

Независимо от значения свойства DatetimeType, если значением свойства DataReturnFormat является 'timetable', то getdata и функции getbulkdata возвращают таблицу, которая содержит значения даты и времени как массивы datetime.

Функции объекта

развернуть все

closeЗакройте связь Bloomberg V3
getСвойства связи Bloomberg V3
isconnectionОпределите связь Bloomberg V3
eqsДанные об экранировании акции для связи Bloomberg V3
getbulkdataОбъемные данные с информацией о заголовке для связи Bloomberg V3
getdataТекущие данные для связи Bloomberg V3
historyИсторические данные для связи Bloomberg V3
portfolioТекущие данные о портфеле для связи Bloomberg V3
realtimeДанные реального времени для связи Bloomberg V3
stopОтпишите запросы в реальном времени о связи Bloomberg V3
tahistoryИсторический технический анализ для связи Bloomberg V3
timeseriesСуточные тиковые данные для связи Bloomberg V3
categoryПолевая категория ищет связь Bloomberg V3
fieldinfoИнформация о поле для связи Bloomberg V3
fieldsearchПолевой поиск связи Bloomberg V3
lookupНайдите информацию о ценных бумагах для связи Bloomberg V3

Примеры

свернуть все

Соединитесь с Сервером Bloomberg с помощью IP-адреса машины, запускающей Сервер Bloomberg. Этот пример принимает следующее:

  • UUID Bloomberg является 12345678.

  • IP-адресом для машины, запускающей Сервер Bloomberg, является '111.11.11.111'.

uuid = 12345678;
ipaddress = '111.11.11.111';

c = blpsrv(uuid,ipaddress)
c = 

  blpsrv with properties:

                Uuid: 12345678
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
              Userip: '111.11.11.112'
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

blpsrv соединяется с машиной, запускающей Сервер Bloomberg с помощью номера порта по умолчанию 8194. blpsrv создает объект c связи Сервера Bloomberg с этими свойствами:

  • Пользовательская идентичность Bloomberg UUID

  • Пользовательский единичный объект Bloomberg

  • IP-адрес машины рабочий MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей Сервер Bloomberg

  • Номер порта машины, запускающей Сервер Bloomberg

  • Номер в миллисекундах, задающих, сколько времени MATLAB пытается соединиться с машиной, запускающей Сервер Bloomberg перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft®.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь Сервера Bloomberg.

close(c)

Соединитесь с Сервером Bloomberg с помощью IP-адреса машины, запускающей Сервер Bloomberg. Этот пример принимает следующее:

  • UUID Bloomberg является 12345678.

  • IP-адресом для машины, запускающей Сервер Bloomberg, является '111.11.11.111'.

  • Номером порта машины, запускающей Сервер Bloomberg, является 8194.

uuid = 12345678;
ipaddress = '111.11.11.111';
port = 8194;

c = blpsrv(uuid,ipaddress,port)
c = 

  blpsrv with properties:

                Uuid: 12345678
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
              Userip: '111.11.11.112'
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

blpsrv соединяется с машиной, запускающей Сервер Bloomberg с помощью номера порта 8194, и создает объект c связи Сервера Bloomberg с этими свойствами:

  • Пользовательская идентичность Bloomberg UUID

  • Пользовательский единичный объект Bloomberg

  • IP-адрес машины рабочий MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей Сервер Bloomberg

  • Номер порта машины, запускающей Сервер Bloomberg

  • Номер в миллисекундах, задающих, сколько времени MATLAB пытается соединиться с машиной, запускающей Сервер Bloomberg перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь Сервера Bloomberg.

close(c)

Соединитесь с Сервером Bloomberg с помощью IP-адреса машины, запускающей Сервер Bloomberg. Этот пример принимает следующее:

  • UUID Bloomberg является 12345678.

  • IP-адресом для машины, запускающей Сервер Bloomberg, является '111.11.11.111'.

  • Номер порта машины, запускающей Сервер Bloomberg, является вашим номером порта по умолчанию.

  • Значение тайм-аута является 10 миллисекундами.

uuid = 12345678;
ipaddress = '111.11.11.111';
port = [];
timeout = 10;

c = blpsrv(uuid,ipaddress,port,timeout)
c = 

  blpsrv with properties:

                Uuid: 12345678
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
              Userip: '111.11.11.112'
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: '111.11.11.111'
                Port: 8194
             TimeOut: 10
        DatetimeType: ''
    DataReturnFormat: ''

blpsrv соединяется с машиной, запускающей Сервер Bloomberg с помощью номера порта по умолчанию 8194 и значение тайм-аута 10 миллисекунд. blpsrv создает объект c связи Сервера Bloomberg с этими свойствами:

  • Пользовательская идентичность Bloomberg UUID

  • Пользовательский единичный объект Bloomberg

  • IP-адрес машины рабочий MATLAB

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, запускающей Сервер Bloomberg

  • Номер порта машины, запускающей Сервер Bloomberg

  • Номер в миллисекундах, задающих, сколько времени MATLAB пытается соединиться с машиной, запускающей Сервер Bloomberg перед таймаутом

  • Тип данных даты и времени

  • Данные возвращают формат

Запросите последние и цены открытия за Microsoft.

format bank  % Display data format for currency
s = 'MSFT US Equity';
f = {'LAST_PRICE';'OPEN'};
[d,sec] = getdata(c,s,f)
d = 
    LAST_PRICE: 33.34
          OPEN: 33.60

sec = 
    'MSFT US Equity'

getdata возвращает структуру d с последними и ценами открытия. Кроме того, getdata возвращает безопасность в sec.

Закройте связь Сервера Bloomberg.

close(c)

Введенный в R2014b