Exponenta Banner
exponenta event banner

bloombergBPIPE

Соединение Bloomberg B-PIPE V3

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

Описание

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

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

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

Создание

Синтаксис

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

Описание

пример

c = bloombergBPIPE(authtype,appname,ipaddress,port) создает объект соединения Bloomberg B-PIPE 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 с аутентификацией приложения

Дополнительные сведения см. в руководстве разработчика Bloomberg B-PIPE API с использованием опции 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 функция оставляет это свойство неснятым. Чтобы получить данные, необходимо задать это значение свойства вручную в командной строке или в сценарии с использованием точечной нотации, например: 

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 функция оставляет это свойство неснятым. Чтобы получить данные, необходимо задать это значение свойства вручную в командной строке или в сценарии с использованием точечной нотации, например: 

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

  • Объект сеанса API Bloomberg V3

  • 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

  • Объект сеанса API Bloomberg V3

  • 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

Документация по панели инструментов для передачи данных

Поддержка