bloombergBPIPE

Соединительные узлы Bloomberg B-PIPE V3

Описание

bloombergBPIPE функция создает bloombergBPIPE объект. The bloombergBPIPE объект представляет Bloomberg® B-PIPE® подключение с помощью Bloomberg V3 C++ API.

Другие функции подключаются к различным сервисам Bloomberg: Bloomberg Desktop (bloomberg) и Bloomberg Server (bloombergServer). Для получения дополнительной информации об этих услугах смотрите Сравнение подключений Bloomberg.

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

Создание

Описание

пример

c = bloombergBPIPE(authtype,appname,ipaddress,port) создает объект соединения B-PIPE Bloomberg c, и устанавливает следующие свойства:

пример

c = bloombergBPIPE(authtype,appname,ipaddress,port,timeout) также устанавливает свойство TimeOut.

Внимание:

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

Свойства

расширить все

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

Тип проверки подлинности приложения, заданный как одно из следующих значений:

  • "" - Соединение Bloomberg B-PIPE с Windows® идентификация

  • "APPNAME_AND_KEY" - Соединение Bloomberg B-PIPE с аутентификацией приложения

Тип проверки подлинности пользователя Bloomberg, заданный как одно из следующих значений:

  • "OS_LOGON" - Соединение Bloomberg B-PIPE с аутентификацией Windows

  • "APPLICATION_ONLY" - Соединение Bloomberg B-PIPE с аутентификацией приложения

Для получения дополнительной информации смотрите Руководство разработчика API Bloomberg B-PIPE с помощью опции WAPI <GO> от терминала Bloomberg.

Имя приложения, заданное как вектор символов или строка, которая идентифицирует приложение, используемое для подключения к Bloomberg B-PIPE.

Пример: 'appname'

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

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

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

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

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

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

Пример: [1x1 BLPSession]

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

Пример: {'111.11.11.112'}

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

Номер порта машины, выполняющей процесс Bloomberg B-PIPE, задается как числовой скаляр.

Пример: 8194

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

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

Пример: 1000

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

Тип данных даты и времени, заданный в качестве одного из следующих значений.

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

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

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

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

  • getbulkdata

  • getdata

  • история

  • tahistory

  • timeseries

    Примечание

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

Формат возврата данных, заданный в качестве одного из следующих значений, которые определяют тип данных возвращенных данных.

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

Примечание

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

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

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

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

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

  • structure

  • table

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

  • structure

  • table

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

  • structure

  • table

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

  • structure

  • table

поиск
  • structure (по умолчанию)

  • table

портфель
  • structure (по умолчанию)

  • table

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

  • table

  • timetable

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

  • table

  • timetable

история
  • числовой массив (по умолчанию)

  • table

  • timetable

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

  • table

  • timetable

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

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

  • table

  • timetable

Примечание

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

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

расширить все

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

Примеры

свернуть все

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

  • Проверка подлинности - это проверка подлинности Windows при установке authtype на 'OS_LOGON'.

  • Имя приложения пусто, так как вы не соединяетесь с Bloomberg B-PIPE с помощью приложения.

  • IP-адрес машины, выполняющей процесс Bloomberg B-PIPE '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE 8194.

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;

c = bloombergBPIPE(authtype,appname,ipaddress,port)
c = 

  bloombergBPIPE with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: []
             Session: [1×1 BLPSession]
           IPAddress: {'111.11.11.112'}
                Port: 8194.00
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

bloombergBPIPE функция соединяется с машиной, работающей под управлением Bloomberg B-PIPE, по номеру порта 8194. bloombergBPIPE функция создает bloombergBPIPE c объекта со следующими свойствами:

  • Тип проверки подлинности приложения

  • Тип проверки подлинности пользователя Bloomberg

  • Имя приложения

  • Тождества пользователя Bloomberg

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, выполняющей процесс Bloomberg B-PIPE

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE

  • Число (в миллисекундах), указывающее, как долго MATLAB пытается подключиться к машине перед тайм-аутом

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

  • Формат возврата данных

Запросить последнюю и открытую цену для 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 B-PIPE.

close(c)

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

  • Проверка подлинности - это проверка подлинности Windows при установке authtype на 'OS_LOGON'.

  • Имя приложения пусто, так как вы не соединяетесь с Bloomberg B-PIPE с помощью приложения.

  • IP-адрес машины, выполняющей процесс Bloomberg B-PIPE '111.11.11.112'.

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE 8194.

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

authtype = 'OS_LOGON';
appname = '';
ipaddress = {'111.11.11.112'};
port = 8194;
timeout = 1000;

c = bloombergBPIPE(authtype,appname,ipaddress,port,timeout)
c = 

  bloombergBPIPE with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: []
             Session: [1×1 BLPSession]
           IPAddress: {'172.28.17.118'}
                Port: 8194.00
             TimeOut: 1000.00
        DatetimeType: ''
    DataReturnFormat: ''

bloombergBPIPE функция соединяется с машиной, работающей под управлением Bloomberg B-PIPE, по номеру порта 8194. bloombergBPIPE функция создает bloombergBPIPE c объекта со следующими свойствами:

  • Тип проверки подлинности приложения

  • Тип проверки подлинности пользователя Bloomberg

  • Имя приложения

  • Тождества пользователя Bloomberg

  • Объект Bloomberg V3 API Session

  • IP-адрес машины, выполняющей процесс Bloomberg B-PIPE

  • Номер порта машины, выполняющей процесс Bloomberg B-PIPE

  • Число (в миллисекундах), указывающее, как долго MATLAB пытается подключиться к машине перед тайм-аутом

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

  • Формат возврата данных

Запросить последнюю и открытую цену для 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 B-PIPE.

close(c)
Введенный в R2021a
Для просмотра документации необходимо авторизоваться на сайте