Свойства строки подключения (службы Analysis Services)
В этом разделе описываются свойства строки подключения, которые можно задать в конструкторе или одном из средств управления. Также эти свойства есть в строках подключения, созданных клиентскими приложениями, которые подключаются и запрашивают данные служб Analysis Services. Описывается только подмножество доступных свойств. Полный список содержит множество свойств сервера и базы данных, позволяющих настроить соединение для конкретного приложения независимо от того, как экземпляр или база данных настроены на сервере.
Разработчики, которые создают пользовательские строки подключения в коде приложений, могут найти более подробный список в документации по API-интерфейсам для клиента ADOMD.NET: ConnectionString
Свойства, описанные в этом разделе, используются клиентскими библиотеками служб Analysis Services, ADOMD.NET, объектами AMO и поставщиком OLE DB для служб Analysis Services. Большинство свойств строки подключения можно использовать со всеми тремя клиентскими библиотеками. Исключения приведены в описании.
Этот раздел включает следующие подразделы:
Часто применяемые параметры соединения
Проверка подлинности и безопасность
Зарезервировано для использования в будущем
Форматы строк подключения, используемые в службах Analysis Services
Примечание
Если при задании свойств одно и то же свойство было задано дважды, то в строке подключения используется последнее.
Дополнительные сведения о том, как указать подключение к службам Analysis Services в существующих приложениях Майкрософт, см. в разделе Подключение из клиентских приложений (службы Analysis Services).
Часто применяемые параметры соединения
В следующей таблице приведены описания свойств, наиболее часто используемых при создании строки подключения.
| Свойство | Описание | Пример |
|---|---|---|
Data Source либо DataSource |
Задает экземпляр сервера. Это свойство является обязательным для всех соединений. Допустимые значения — сетевое имя или IP-адрес сервера, local или localhost для локальных соединений, URL-адрес, если на сервере настроен доступ по протоколу HTTP или HTTPS, или имя файла для локального куба (CUB). | Data source=AW-SRV01 — порт (TCP 2383) и экземпляр по умолчанию.Data source=AW-SRV01$Finance:8081 — фиксированный порт и именованный экземпляр ($Finance).Data source=AW-SRV01.corp.Adventure-Works.com — полное доменное имя для экземпляра и порта по умолчанию.Data source=172.16.254.1 для IP-адреса сервера без уточняющегозапроса DNS, что удобно для устранения проблем с соединением. |
Initial Catalog или Catalog |
Определяет имя базы данных служб Analysis Services, к которой необходимо подключиться. База данных должна быть развернута на службах Analysis Services, и необходимо иметь разрешение на подключение к ней. Это свойство является необязательным для AMO-соединений, но необходимо для ADOMD.NET. | Initial catalog=AdventureWorks2012 |
Provider |
Допустимые значения: MSOLAP или MSOLAP.<version>, где <имеет> значение 3, 4 или 5. В файловой системе имя поставщика данных будет msolap110.dll для SQL Server версии 2012, msolap100.dll для SQL Server 2008 и 2008 R2 и msolap90.dll для SQL Server 2005. Текущая версия — MSOLAP.5. Это необязательное свойство. По умолчанию клиентские библиотеки считывают текущую версию поставщика OLE DB из реестра. Устанавливать это свойство необходимо, только если требуется определенная версия поставщика данных, например для подключения к экземпляру SQL Server 2008. Поставщики данных соответствуют версиям SQL Server. Если ваша организация использует текущую и предыдущую версии служб Analysis Services, то, скорее всего, нужно будет указать поставщик данных для строк подключений, созданных вручную. Также, возможно, потребуется загрузить и установить определенные версии поставщика данных на компьютерах, на которых нет нужных вам версий. Поставщик OLE DB можно загрузить с веб-страниц пакета дополнительных компонентов SQL Server (из центра загрузки). Откройте адрес Microsoft SQL Server 2012 Feature Pack , чтобы загрузить поставщик OLE DB служб Analysis Services для SQL Server 2012. MSOLAP.4 был выпущен как в SQL Server 2008, так и в SQL Server 2008 R2. Версия 2008 R2 поддерживает книги PowerPivot, иногда ее необходимо устанавливать вручную на серверах SharePoint. Чтобы отличить эти две версии, необходимо проверить номер сборки в свойствах файла поставщика. Перейдите в "Program files\Microsoft Analysis Services\AS OLEDB\10". Щелкните правой кнопкой мыши файл msolap110.dll и выберите пункт Свойства. Щелкните Сведения. Просмотрите информацию о версии файла. Версия должна включать 10.50.<buildnumber> для SQL Server 2008 R2. Дополнительные сведения см. в статьях Установка поставщика OLE DB служб Analysis Services на серверах SharePoint и Поставщики данных, используемые для соединений со службами Analysis Services. MSOLAP.3 был выпущен в SQL Server 2005 году. MSOLAP.4 был выпущен в SQL Server 2008 и снова SQL Server 2008 R2 MSOLAP.5 был выпущен в SQL Server 2012 г. |
Provider=MSOLAP.3 используется для подключений, которые требуют версию SQL Server 2005 поставщика OLE DB для служб Analysis Services. |
Cube |
Имя куба или имя перспективы. База данных может содержать несколько кубов и перспектив. Если возможны несколько целей, включите куб или имя перспективы в строку подключения. | Cube=SalesPerspective обозначает, что можно использовать свойство Cube строки подключения для указания имени куба или перспективы. |
Проверка подлинности и безопасность
В этом разделе описываются свойства строки подключения, относящиеся к проверке подлинности и шифрованию. Службы Analysis Services используют только проверку подлинности Windows, однако в строке подключения можно задать свойства для передачи заданного имени пользователя и пароля.
Свойства перечисляются в алфавитном порядке.
| Свойство | Описание |
|---|---|
EffectiveUserName |
Используется, когда идентификатор пользователя должен быть олицетворен на сервере. Укажите учетную запись в следующем формате: «домен\пользователь». Чтобы использовать это свойство, вызывающая сторона должна иметь разрешения системного администратора служб Analysis Services. Дополнительные сведения об использовании свойства этого свойства в книге Excel из SharePoint см. в разделе Использование свойства EffectiveUserName служб Analysis Services в SharePoint Server 2013. Примеры использования этого свойства со службами Reporting Services см. в разделе Использование EffectiveUserName для олицетворения в SSAS.EffectiveUserName используется в установке PowerPivot для SharePoint для сбора данных об использовании. Удостоверение пользователя предоставляется серверу, чтобы события или ошибки, включающие удостоверение пользователя, могли быть записаны в файлах журналов. В случае с PowerPivot не используется для выполнения авторизации. |
| Encrypt Password | Указывает, применяется ли для шифрования локальных кубов локальный пароль. Допустимые значения — True и False. Значение по умолчанию — False. |
Encryption Password |
Пароль, используемый для расшифровки зашифрованного локального куба. Значение по умолчанию — empty. Это значение должно быть прямо задано пользователем. |
Impersonation Level |
Указывает уровень олицетворения, который разрешен серверу при олицетворении клиента. Допустимые значения: Анонимный. Клиент является анонимным для сервера. Серверному процессу не удается получить идентификационные сведения о клиенте, также клиент не может быть олицетворен. Определение. Серверный процесс может получить удостоверение клиента. Сервер может олицетворять клиента для авторизации, но не может получить доступ к системным объектам от имени клиента. Олицетворения. Это значение по умолчанию. Клиент может быть олицетворен, но только при установке соединения, а не при каждом вызове. Делегат. Серверный процесс может олицетворять контекст безопасности клиента, действуя от имени клиента. Серверный процесс также может отправлять исходящие вызовы другим серверам, действуя от имени клиента. |
Integrated Security |
Идентификатор участника Windows вызывающей стороны используется для подключения к службам Analysis Services. Допустимые значения — blank (пусто), SSPI и BASIC.Integrated Security=SSPI — значение по умолчанию для TCP-подключений, разрешающее проверку подлинности NTLM, Kerberos или анонимную проверку подлинности. Значение по умолчанию для HTTP-соединений — blank (пустое значение).При использовании SSPI аргумент ProtectionLevel должен иметь одно из следующих значений: Connect, PktIntegrity, PktPrivacy. |
Persist Encrypted |
Установите это свойство, если клиентское приложение требует, чтобы объект источника данных хранил конфиденциальные данные проверки подлинности, например пароль в зашифрованном виде. По умолчанию сведения о проверке подлинности не сохраняются. |
Persist Security Info |
Допустимые значения — True или False. Если задано значение True, сведения о безопасности, например идентификатор пользователя и пароль, указанные в строке подключения, можно получить из соединения после того, как соединение установлено. Значение по умолчанию равно False. |
ProtectionLevel |
Определяет уровень безопасности, используемый для соединения. Допустимые значения:None. Без проверки подлинности или анонимные соединения. Не выполняется проверка подлинности на данных, отправляемых на сервер.Connect. Проверенные на подлинность соединения. Проверка проходит успешно только в том случае, когда клиент устанавливает соединение с сервером.PktIntegrity. Зашифрованные соединения. Проверяет, что все данные получаются от клиента и что они не меняются во время передачи.PktPrivacy. Шифрование подписями поддерживается только для XMLA. Проверяется, что все данные получаются от клиента и без изменений во время передачи в пути. Конфиденциальность данных защищается путем шифрования.Дополнительные сведения см. в разделе Establishing Secure Connections in ADOMD.NET. |
Roles |
Укажите разделенный запятыми список стандартных ролей для подключения к серверу и базе данных с помощью разрешений, переданных этой роли. Если это свойство пропущено, используются все роли и применяются разрешения как сочетания всех ролей. Присвойствуя свойству пустое значение (например, Roles=' '), клиентское подключение не имеет членства в роли. Администратор, применяя это свойство, соединяется с использованием разрешений, представленных ролью. Некоторые команды могут завершиться ошибкой, если роль не предоставляет достаточные разрешения. |
SSPI |
Явно указывает, какой пакет безопасности следует использовать для проверки подлинности клиента, когда для Integrated Security задано значение SSPI. SSPI поддерживает несколько пакетов, однако с помощью этого свойства можно указать определенный пакет. Допустимые значения: Negotiate, NTLM, Kerberos и Anonymous User. Если это свойство не задано, то для соединения будут доступны все пакеты. |
Use Encryption for Data |
Шифрует передачу данных. Возможными значениями являются True и False. |
User ID=...; Password= |
User ID и Password используются вместе. Службы Analysis Services олицетворяют удостоверение пользователя, указанное с помощью этих учетных данных. В соединении служб Analysis Services учетные данные в командной строке используются только в том случае, если на сервере настроен доступ по HTTP-протоколу и указана обычная проверка подлинности вместо встроенной безопасности виртуального каталога IIS.Имя пользователя и пароль могут быть учетными данными удостоверения Windows или учетной записью локального пользователя или пользователя домена. Обратите внимание, что User ID имеет внедренный пробел. Другие псевдонимы для этого свойства: UserName (без пробела) и UID. Псевдоним для Password — PWD. |
Специальные параметры
В этом разделе описываются остальные параметры строки подключения. Они используются для предоставления приложению конкретных режимов подключения.
Свойства перечисляются в алфавитном порядке.
| Свойство | Описание |
|---|---|
Application Name |
Задает имя приложения, связанного с соединением. Это значение может быть полезно для мониторинга событий трассировки, особенно при наличии нескольких приложений, обращающихся к одним и тем же базам данных. Например, добавление Application Name='test' в строку подключения приводит к отображению test в трассировке SQL Server Profiler, как показано на следующем снимке экрана: Псевдонимы для этого свойства: sspropinitAppName и AppName. Дополнительные сведения см. разделе Использование параметра Application Name при соединении с SQL Server. |
AutoSyncPeriod |
Задает частоту (в миллисекундах) синхронизации кэша клиента и сервера. ADOMD.NET предоставляет механизм кэширования клиента для часто используемых объектов, имеющий минимальные издержки на использование памяти. Это способствует сокращению циклов приема-передачи данных с сервера и на сервер. Значение по умолчанию равно 10000 миллисекунд (10 секундам). Если задано значение NULL или 0, то автоматическая синхронизация отключена. |
Character Encoding |
Определяет, как кодируются символы в запросе. Допустимые значения: Default (по умолчанию), UTF-8 (это эквивалент Default) и UTF-16 |
CompareCaseSensitiveStringFlags |
Задает учет регистра при сравнении строк для указанной локали. Дополнительные сведения об установке данного свойства см. в разделе Свойство CompareCaseSensitiveStringFlags |
Compression Level |
Если TransportCompression задано как XPRESS, то можно задать используемый уровень сжатия. Допустимые значения: от 0 до 9, где 0 дает наименьшее сжатие, а 9 — самое большое. Более высокое сжатие снижает производительность. Значение по умолчанию — 0. |
Connect Timeout |
Определяет максимальное время (в секундах) попытки подключения клиента до истечения времени ожидания. Если подключение не удается выполнить в течение этого периода, клиент завершает попытку подключения и выдает ошибку. |
MDX Compatibility |
Назначение этого свойства — обеспечить согласованное выполнение запросов многомерных выражений для приложений, которые их используют. В Excel при использовании запросов многомерных выражений для заполнения и вычисления сводных таблиц, подключенных к службам Analysis Services, этому свойству присваивается значение 1, чтобы обеспечить отображение в сводной таблице элементов-заполнителей из неоднородных иерархий. Допустимые значения — 0, 1, 2. При 0 и 1 элементы-заполнители доступны, при 2 — нет. Если значение пустое, то используется 0. |
MDX Missing Member Mode=Error |
Указывает на то, что отсутствующие элементы в инструкциях многомерных выражений не обрабатываются. Допустимые значения: Default, Error и Ignore. При Default используется значение, определенное на сервере. При Error формируется ошибка, если элемент не существует. При использовании значения Ignore отсутствующие значения пропускаются. |
Optimize Response |
Битовая маска, определяющая используемую оптимизацию ответа на запрос. 0x01: по умолчанию. Использование NormalTupleSet 0x02: используйте, если срезы пусты. |
Packet Size |
Размер пакета (в байтах) между 512 и 32 767. Размер сетевых пакетов по умолчанию равен 4096. |
Protocol Format |
Задает формат XML-данных, отправляемых на сервер. Допустимые значения: Default, XML, Binary. Протокол — XMLA. Можно указать, что следует отправлять XML-данные в сжатом виде (это применяется по умолчанию), в несжатом виде или в двоичной форме. XML-элементы и атрибуты кодируются в двоичном формате, что уменьшает их размер. Для сжатия используется внутренний формат, что еще сильнее уменьшает размер запросов и ответов. Сжатие и двоичные форматы используются для ускорения запросов передачи данных и ответов. Если используется двоичный или сжатый формат, то для соединения нужно применять клиентскую библиотеку. Поставщик OLE DB может форматировать запросы и ответы в двоичном или в сжатом виде. Объекты AMO и ADOMD.NET форматируют запросы как текст, но принимают ответы в двоичном или сжатом формате. Эта строка подключения — эквивалент параметрам конфигурации сервера EnableBinaryXML и EnableCompression. |
Real Time Olap |
Установите это свойство, чтобы обойти кэширование, в результате чего все секции будут активно ожидать уведомления о запросах. По умолчанию это свойство не задано. |
Safety Options |
Устанавливает уровень безопасности для определяемых пользователем функций и действий. Допустимые значения: 0, 1, 2. В соединении Excel это свойство соответствует Safety Options=2. Сведения об этом параметре см. в разделе ConnectionString. |
SQLQueryMode |
Указывает, содержат ли SQL-запросы вычисления. Допустимые значения: Data, Calculated, IncludeEmpty. Data — вычисления не разрешены. Calculated — вычисления разрешены. IncludeEmpty — позволяет возвращать в результатах запроса вычисления и пустые строки. |
Timeout |
Задает время (в миллисекундах) ожидания клиентской библиотекой завершения команды перед формированием ошибки. |
Transport Compression |
Определяет способ сжатия пакетов в канале «клиент-сервер», когда сжатие задано свойством Protocol Format. Допустимые значения: Default, None, Compressed и gzip. По умолчанию для TCP сжатия нет, для HTTP применяется gzip. None — никакое сжатие не используется. Compressed — применяется сжатие XPress (SQL Server 2008 и более поздние версии). Значение gzip допустимо только для HTTP-запросов, где запрос включает строку Accept-Encoding=gzip. |
UseExistingFile |
Используется для соединения с локальным кубом. Это свойство определяет, следует ли перезаписывать локальный куб. Допустимые значения — True и False. Если значение — True, то файл куба должен существовать. Существующий файл будет целевым объектом соединения. Если значение — False, то файл куба перезаписывается. |
VisualMode |
Задайте с помощью этого свойства, как объединяются элементы при применении настроек безопасности измерения. Есть смысл выполнять статистическую обработку всех членов данных куба, которые могут видеть все, поскольку видимы все значения, входящую в общую сумму. Однако если на основе идентификатора пользователя применяется фильтрация и ограничиваются измерения, то отображение общей суммы по всем элементам (куда входят разрешенные и закрытые значения) может выдавать непонятный результат или раскрывать больше данных, чем следует. Чтобы указать способ статистической обработки членов при применении средств безопасности измерения, можно установить это свойство в значение True. Это приведет к использованию в агрегате только допустимых значений. Если указать False, то это исключит ограниченные значения из общей суммы. Если задать это свойство в строке подключения, оно будет применяться к кубу или уровню перспективы. В модели можно управлять видимыми итогами на более детальном уровне. Допустимые значения: 0, 1, и 2. Значение по умолчанию равно 0. В настоящее время по умолчанию применяются правила для значения 2, где агрегаты содержат значения, скрытые от пользователя. При значении 1 скрытые значения не входят в общую сумму. Так по умолчанию происходит в Excel. 2 — скрытые значения входят в итоги. Это значение по умолчанию на сервере. Псевдонимы для этого свойства: Visual Total и Default MDX Visual Mode. |
Зарезервировано для использования в будущем.
Следующие свойства являются допустимыми в строке подключения, но не работают в текущих выпусках служб Analysis Services.
прошедший проверку пользователь
Проверка подлинности Cache
Режим кэша (использование этого свойства изучалось в более ранних выпусках. Хотя вы можете найти записи блога с рекомендациями по его использованию, не следует задавать это свойство, если не указано служба поддержки Майкрософт).
Политика кэша
Cache Ratio
Cache Ratio2
Dynamic Debug Limit
Режим отладки
Режим
SQLCompatibility
Use Formula Cache
Примеры строк подключения
В этом разделе показана строка подключения, которую вы, скорее всего, будете использовать при настройке подключения служб Analysis Services в часто используемых приложениях.
Общая строка подключения
Подобную строку подключения можно использовать, если настраивается соединение из служб Reporting Services.
Data source=<servername>; initial catalog=<databasename>
Строка подключения в Excel
Стандартная строка подключения ADOMD.NET в Excel указывает поставщик данных, сервер, имя базы данных и учетные сведения встроенной безопасности Windows. Уровень совместимости многомерного выражения всегда задается как 1. Можно изменить это значение для текущего сеанса, но Excel при открытии следующего файла сбросит уровень совместимости многомерного выражения в 1.
Provider=MSOLAP.5;Integrated Security=SSPI;Persist Security Info=True;Initial Catalog=Adventure Works DW 2008R2;Data Source=AW-SRV01;MDX Compatibility=1;Safety Options=2;MDX Missing Member Mode=Error
Дополнительные сведения см. в разделах Подключения к данным, источники данных и строки подключения в Reporting Services и Проверка подлинности данных для службы Excel в SharePoint Server 2013.
Форматы строк подключения, используемые в службах Analysis Services
В этом разделе перечислены все форматы строк подключения, поддерживаемые службами Analysis Services. За исключением соединений с базами данных PowerPivot, эти строки подключения можно указывать в соединениях, которые подключаются к службам Analysis Services.
Собственные (или прямые) соединения с сервером
Data Source=server[:port][\instance] где "port" и "\instance" являются необязательными. Например, если указать "Data Source=server1", откроется подключение к экземпляру по умолчанию (и порту по умолчанию 2383) на сервере с именем "server1".
"Data Source=server1:port1" откроет подключение к экземпляру служб Analysis Services, работающему на порте "port1" на "server1".
Data Source=server1\instance1 откроет подключение к браузеру SQL (порт по умолчанию 2382), разрешим порт для именованного экземпляра instance1, а затем откроет подключение к порту служб Analysis Services.
"Data Source=server1:port1\instance1" откроет подключение к браузеру SQL на "port1", разрешим порт для именованного экземпляра instance1, а затем откроет подключение к порту служб Analysis Services.
Соединение с локальными кубами (файлы CUB)
Data Source=<path>, например "Data Source=c:\temp\a.cub"
Соединения по HTTP(S) с msmdpump.dll
Data Source=<URL>, где «URL» является адресом HTTP или HTTPS виртуальной папки IIS, которая содержит файл msmdpump.dll. Дополнительные сведения см. в статье Настройка http-доступа к службам Analysis Services в службах IIS 8.0.
Соединения по HTTP(S) с книгами PowerPivot (файлы XLSX, XLSB или XLSM)
Data Source=<URL>, где «URL» — это путь SharePoint к книге PowerPivot, опубликованной в библиотеке SharePoint. Например, "Источник данных=https://localhost/Shared Документы/Sales.xlsx".
Соединения по HTTP(S) с файлами соединения семантической модели бизнес-аналитики
Data Source=<URL> , где «URL» — путь SharePoint к BISM-файлу. Например, "Data Source=https://localhost/Shared Documents/Sales.bism".
Внедренные соединения PowerPivot
Data Source=$Embedded$, где «$Embedded$» — моникер, ссылающийся на внедренную в книгу модель данных PowerPivot. Такая строка подключения создается и управляется внутренними системными механизмами. Не изменяйте ее. Внедренные строки подключения разрешаются надстройкой PowerPivot для Excel на клиентских рабочих станциях или экземплярами PowerPivot для SharePoint в ферме SharePoint.
Контекст локального сервера в хранимых процедурах служб Analysis Services
Data Source=*, где * разрешается в локальный экземпляр.
Шифрование строк соединения
Службы Analysis Services шифруют и сохраняют строки подключения, которые используются для подключения к каждому из своих источников данных. Если для подключения к источнику данных требуется имя пользователя и пароль, службы Analysis Services могут хранить имя и пароль в строке подключения или запрашивать имя и пароль каждый раз, когда требуется подключение к источнику данных. Если службы Analysis Services запрашивают сведения о пользователе, это означает, что эти сведения не нужно хранить и шифровать. Однако при сохранении этих данных в строке соединения эти данные необходимо шифровать и обеспечивать их безопасность.
Для шифрования и защиты сведений о строке подключения службы Analysis Services используют API защиты данных. Службы Analysis Services используют отдельный ключ шифрования для шифрования сведений о строках подключения для каждой базы данных служб Analysis Services. Службы Analysis Services создают этот ключ при создании базы данных и шифруют сведения о строке подключения на основе учетной записи запуска служб Analysis Services. При запуске служб Analysis Services зашифрованный ключ для каждой базы данных считывается, расшифровывается и сохраняется. Затем службы Analysis Services используют соответствующий расшифрованный ключ для расшифровки сведений о строке подключения к источнику данных, когда службам Analysis Services необходимо подключиться к источнику данных.
См. также:
Настройка HTTP-доступа к службам Analysis Services в службах Internet Information Services (IIS) 8.0
Настройка служб Analysis Services для ограниченного делегирования Kerberos
Поставщики данных, используемые для соединений со службами Analysis Services
Подключение к службам Analysis Services