Свойства строки подключения (службы Analysis Services)

Статья
11/10/2015

В этом разделе описываются свойства строки подключения, которые можно задать в конструкторе или одном из средств управления. Также эти свойства есть в строках подключения, созданных клиентскими приложениями, которые подключаются и запрашивают данные служб 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.<версия>, где <версия> имеет значение 3, 4 или 5. В файловой системе именем поставщика данных будет msolap110.dll для SQL Server 2012, msolap100.dll для SQL Server 2008 и 2008 R2, и msolap90.dll для SQL Server 2005. Версия MSOLAP.3 выпущена в составе SQL Server 2005. Версия MSOLAP.4 выпущена в составе SQL Server 2008 и SQL Server 2008 R2. Версия MSOLAP.5 выпущена в составе SQL Server 2012. Текущая версия — 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 и выберите Свойства. Щелкните Сведения. Просмотрите информацию о версии файла. Для SQL Server 2008 R2 номер версии должен содержать 10.50.<buildnumber>. Дополнительные сведения см. в разделах Установка поставщика OLE DB служб Analysis Services на серверах SharePoint и Клиентские библиотеки, которые используются для подключения к службам Analysis Services.	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	Указывает уровень олицетворения, который разрешен серверу при олицетворении клиента. Допустимы следующие значения: Anonymous. Клиент анонимен по отношению к серверу. Серверному процессу не удается получить идентификационные сведения о клиенте, также клиент не может быть олицетворен. Identify. Серверный процесс может получить удостоверение клиента. Сервер может олицетворять клиента для авторизации, но не может получить доступ к системным объектам от имени клиента. Impersonate. Это значение по умолчанию. Клиент может быть олицетворен, но только при установке соединения, а не при каждом вызове. Delegate. Серверный процесс может олицетворять контекст безопасности клиента при действии от имени клиента. Серверный процесс также может отправлять исходящие вызовы другим серверам, действуя от имени клиента.
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. Проверяется, что все данные получаются от клиента и без изменений во время передачи в пути. Конфиденциальность данных защищается путем шифрования. Дополнительные сведения см. в разделе Установка безопасных соединений в 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 отсутствующие значения пропускаются.
Mode	Определяет в строке подключения разрешения доступа к базе данных, что позволяет переопределить существующее значение. Допустимые значения — Read и ReadWrite. В SSMS это свойство базы данных обозначено как режим Read-Write. Значение по умолчанию — ReadWrite.
Optimize Response	Битовая маска, определяющая используемую оптимизацию ответа на запрос. 0х01 — использовать NormalTupleSet (по умолчанию). 0х02 — использовать, когда срезы пусты.
Packet Size	Размер сетевого пакета (в байтах) от 512 до 32 767. Размер сетевого пакета по умолчанию: 4 096.
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 — никакое сжатие не используется. При сжатии применяется XPRESS-сжатие (SQL Server 2008 и более поздние версии). gzip допустимо только для HTTP-соединений, где 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 Mode, режим кэша (Использование этого свойства было разобрано в более ранних версиях. Хотя в некоторых блогах рекомендуется использовать это свойство, не следует задавать его, если только вы не получили соответствующие инструкции от службы технической поддержки Майкрософт).
Cache Policy
Cache Ratio
Cache Ratio2
Use Formula Cache
Dynamic Debug Limit
Режим отладки
SQLCompatibility

Примеры строк подключения

В этом разделе показаны строки подключения, которые, скорее всего, будут часто использоваться при настройке соединения служб Analysis Services.

Общая строка подключения

Подобную строку подключения можно использовать, если настраивается соединение из служб Reporting Services.

Data source=<servername>; initial catalog=<databasename>

Строка подключения в Excel

Строка подключения ADOMD.NET по умолчанию указывает в Excel поставщик данных, сервер, имя базы данных, учетные сведения встроенной безопасности Windows. Уровень совместимости MDX всегда равен 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

Дополнительные сведения см. в разделах Подключения к данным, источники данных и сроки подключения (службы SSRS) и Сведения для проверки подлинности службы 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, выполняющимся на сервере «server1», через порт «port1».

«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 в службах Internet Information Services (IIS) 7.0.

Соединения по HTTP(S) с книгами PowerPivot (файлы XLSX, XLSB или XLSM)

Data Source=<URL>, где «URL» — это путь SharePoint к книге PowerPivot, опубликованной в библиотеке SharePoint. Например «Data Source=https://localhost/Shared Documents/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 необходимо подключиться к источнику данных.