exponenta event banner

bpipe

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

Описание

bpipe функция создает bpipe объект. bpipe объект представляет соединение Bloomberg ® B-PIPE ®.

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

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

Создание

Описание

пример

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

пример

c = bpipe(authtype,appname,ipaddress,port,timeout) также задает свойство TimeOut.

пример

c = bpipe(authtype,appname,ipaddress,port,timeout,tlscred,tlspassword,tlstrust) подключается к облачному решению B-PIPE с нулевой компоновкой с использованием указанного файла учетных данных, пароля и файла доверия.

Внимание:

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

Входные аргументы

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

Файл учетных данных, указанный как вектор символов или строковый скаляр, содержащий полный путь к файлу учетных данных с расширением pk12. За подробностями о файле учетных данных обращайтесь в агентство Bloomberg.

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

Пароль B-PIPE, заданный как вектор символа или скаляр строки. Для получения пароля B-PIPE обратитесь в агентство Bloomberg.

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

Файл доверия, указанный как вектор символов или строковый скаляр, содержащий полный путь к файлу доверия с расширением pk7. За подробностями о файле доверия обращайтесь в агентство Bloomberg.

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

Свойства

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

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

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

  • "" - Соединение 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 com.bloomberglp.blpapi.Session]

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").

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

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").

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

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Определить V3 подключения Bloomberg
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 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 = bpipe(authtype,appname,ipaddress,port)
c = 

  bpipe with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'111.11.11.112'}
                Port: 8194.00
             TimeOut: 0
        DatetimeType: ''
    DataReturnFormat: ''

bpipe подключается к машине под управлением Bloomberg B-PIPE по номеру порта 8194. bpipe создает объект соединения Bloomberg B-PIPE 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 = bpipe(authtype,appname,ipaddress,port,timeout)
c = 

  bpipe with properties:

         AppAuthType: ''
            AuthType: 'OS_LOGON'
             AppName: []
                User: [1x1 com.bloomberglp.blpapi.impl.aT]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'172.28.17.118'}
                Port: 8194.00
             TimeOut: 1000.00
        DatetimeType: ''
    DataReturnFormat: ''

bpipe подключается к машине под управлением Bloomberg B-PIPE по номеру порта 8194. bpipe создает объект соединения Bloomberg B-PIPE 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. В этом примере предполагается следующее:

  • Аутентификация основана на имени приложения при установке authtype кому 'APPLICATION_ONLY'.

  • Имя приложения: 'APP'.

  • IP-адрес компьютера, на котором выполняется процесс Bloomberg B-PIPE: '111.11.11.112'.

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

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

  • Полный путь к файлу учетных данных: C:\ABCDEFG.pk12.

  • Пароль B-PIPE: 12345.

  • Полный путь к файлу доверия: C:\HIJKLM.pk7.

authtype = 'APPLICATION_ONLY';
appname = 'APP';
ipaddress = {'111.11.11.112'};
port = 8194;
timeout = 1000;
tlscred = 'C:\ABCDEFG.pk12';
tlspassword = '12345';
tlstrust = 'C:\HIJKLM.pk7';

c = bpipe(authtype,appname,ipaddress,port,timeout,tlscred,tlspassword,tlstrust)
c = 

  bpipe with properties:

         AppAuthType: 'APPNAME_AND_KEY'
            AuthType: 'APPLICATION_ONLY'
             AppName: 'APP'
                User: [1x1 com.bloomberglp.blpapi.impl.by]
             Session: [1x1 com.bloomberglp.blpapi.Session]
           IPAddress: {'111.11.11.112'}
                Port: 8194.00
             TimeOut: 1000.00
        DatetimeType: ''
    DataReturnFormat: ''

bpipe подключается к машине под управлением Bloomberg B-PIPE по номеру порта 8194. bpipe создает объект соединения Bloomberg B-PIPE 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)
Представлен в R2014b