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

Применимо к: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

В этой статье описываются свойства строки подключения, используемые клиентскими приложениями, которые подключаются к службам Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) и семантические модели Power BI Premium. Эти свойства используются клиентскими библиотеками служб Analysis Services, ADOMD.NET, AMO и OLE DB (MSOLAP) для служб Analysis Services. Большинство свойств строки подключения можно использовать со всеми тремя клиентскими библиотеками. Исключения вызываются в описании.

Используйте селектор версий над оглавлением слева, чтобы увидеть только те свойства, которые применяются к определенной платформе или версии.

Свойства подключения

Источник данных

Указывает экземпляр сервера. Это свойство требуется для всех подключений.

Provider

Это свойство необходимо для строки подключения при использовании поставщика OLE DB, например MSOLAP. Он позволяет использовать независимый поставщик версий (обычно последний), например Provider=MSOLAP, или можно также указать зависимый от версии поставщик, например Provider=MSOLAP.7. Допустимые значения, зависящие от версий, соответствуют шаблону MSOLAP.<версия>, в которой <используется версия> 7 или 8. Например, MSOLAP.7, выпущенная в SQL Server 2016. Версия .8 является последней и считается "вечной". Ожидается, что обновление будет обновляться с сохранением обратной совместимости. Более ранние номера версий также возможны, но эти выпуски MSOLAP теперь не поддерживаются в стандартной версии.

Это свойство необязательно для ADOMD.NET и AMO. При копировании строки подключения MSOLAP можно использовать с ADOMD.NET и AMO.

Куб

Имя куба или имя перспективы. База данных может содержать несколько кубов и перспектив. Если возможно несколько целевых объектов, включите имя куба или перспективы в строку подключения.

Свойства проверки подлинности и безопасности

Свойства перечислены в алфавитном порядке.

EffectiveUserName

Используется, когда удостоверение пользователя должно быть олицетворены на сервере. Для служб SSAS укажите в формате domain\user. Для Azure AS и Power BI Premium укажите в формате имени участника-пользователя. Чтобы использовать это свойство, вызывающий объект должен иметь административные разрешения в службах Analysis Services. В Power BI Premium вызывающий объект должен быть администратором рабочей области, где находится семантическая модель.

CustomData

Строковое значение, передаваемое подсистеме в строке подключения, а затем извлекается с помощью функции многомерных выражений CustomData() или функции CUSTOMDATA() DAX. Чаще всего используется для передачи идентификатора пользователя или имени пользователя в качестве значения, а затем укажите это значение в определении выражения безопасности.

Уровень олицетворения

Указывает уровень олицетворения, который сервер может использовать при олицетворении клиента. Допустимые значения:

• Анонимные. Клиент является анонимным на сервере. Серверный процесс не может получить сведения о клиенте и не может быть олицетворен.
• Определите. Серверный процесс может получить удостоверение клиента. Сервер может олицетворить удостоверение клиента в целях авторизации, но не может получить доступ к системным объектам в качестве клиента.
• Олицетворения. Это значение по умолчанию. Удостоверение клиента можно олицетворить, но только при установке подключения, а не при каждом вызове.
• Делегат. Серверный процесс может олицетворить контекст безопасности клиента при действии от имени клиента. Серверный процесс также может выполнять исходящие вызовы к другим серверам при действии от имени клиента.

Встроенные функции безопасности

Удостоверение вызывающего объекта Windows используется для подключения к службам Analysis Services. Допустимые значения: SSPI, пустые, basic и ClaimsToken*.

SSPI — это значение по умолчанию для TCP-подключений, разрешающее проверку подлинности NTLM, Kerberos или Анонимную проверку подлинности. Для Azure AS и Power BI Premium SSPI указывает на перевод AD. При использовании SSPI свойство ProtectionLevel должно иметь значение Connect, Pkt Integrity или Pkt Privacy.

пустое значение по умолчанию для HTTP-подключений.

*ClaimsToken поддерживается для Azure AS и Power BI Premium.

Сохранение сведений о безопасности

Допустимые значения: True или False. Если задано значение True, данные безопасности, такие как удостоверение пользователя или пароль, указанные ранее в строке подключения, можно получить из подключения после завершения подключения. Значение по умолчанию — False.

Уровень защиты

Определяет уровень безопасности, используемый для подключения. Поддерживаемые значения зависят от базового транспорта. Допустимые значения:

• Нет. Не прошедшие проверку подлинности или анонимные подключения. Не выполняет проверку подлинности для данных, отправляемых на сервер.
• Connect. Прошедшие проверку подлинности подключения. Проверяет подлинность только в том случае, если клиент устанавливает связь с сервером.
• Целостность Pkt. Зашифрованные подключения. Проверяет, что все данные получены от клиента и что он не был изменен при передаче.
• Pkt Privacy. Подписанное шифрование, поддерживаемая только для TCP. Проверяет, что все данные получены от клиента, что он не был изменен при передаче, и защищает конфиденциальность данных путем его шифрования.

Дополнительные сведения см. в разделе "Установка безопасных подключений" в ADOMD.NET

Роли

Укажите список предопределенных ролей с разделителями-запятыми для подключения к серверу или базе данных с помощью разрешений, передаваемых этой ролью. Если это свойство опущено, используются все роли, а действующие разрешения — сочетание всех ролей. Установка свойства на пустое значение, например, означает, Roles=' ' что подключение клиента не имеет членства в роли.

Администратор, использующий это свойство, подключается с помощью разрешений, передаваемых ролью. Некоторые команды могут завершиться ошибкой, если роль не предоставляет достаточного разрешения.

При указании ролей при подключении к рабочей области Power BI Premium используйте роли рабочей области из модели безопасности Power BI.

SSPI

Явным образом указывает, какой пакет безопасности следует использовать для проверки подлинности клиента, если для встроенной безопасностизаданО значение SSPI. SSPI поддерживает несколько пакетов, но это свойство можно использовать для указания конкретного пакета. Допустимые значения:

• Переговоры
• Кербер
• NTLM
• Анонимный пользователь

Если это свойство не задано, все пакеты будут доступны для подключения.

Использование шифрования для данных

Шифрует передачи данных. Допустимые значения: True или False.

Идентификатор пользователя=...; Пароль=

Свойства идентификатора пользователя и пароля предоставляют соответствующие учетные данные серверу, если текущий активный пользователь в клиентском приложении не может автоматически распространяться на сервер. Поведение зависит от транспортного протокола и сервера, к которому подключается:

• При подключении через TCP к SSAS клиентская библиотека олицетворяет пользователя Windows с помощью указанного имени пользователя и пароля, а затем подключается как обычно к серверу.

• При подключении по протоколу HTTP(S) к SSAS учетные данные предоставляются веб-серверу на основе режима проверки подлинности, настроенного на веб-сервере, например обычная проверка подлинности или проверка подлинности Windows. Веб-сервер выполнит соответствующую олицетворение Windows перед подключением к серверу SSAS, поэтому предоставляя правильный поток учетных данных серверу.

• При подключении к Azure AS или Power BI Premium идентификатор пользователя и пароль используются для получения маркера Microsoft Entra, который затем предоставляется службе во время проверки подлинности. Идентификатор Microsoft Entra также может потребовать многофакторной проверки подлинности (MFA), которая может потребовать дополнительного взаимодействия с пользователем перед созданием маркера.

• Если вы уже приобрели действительный маркер доступа носителя идентификатора Microsoft Entra id из собственного приложения, можно задать свойство AccessToken объекта AdomdConnection перед установкой подключения. В свойстве AccessToken соответствующего объекта подключения (AdomdConnection, Server и т. д.) обязательно задайте маркер доступа и укажите его срок действия. Проверка подлинности поддерживается для маркеров носителя, приобретенных в интерактивном режиме для пользователя, и с помощью потока OAuth 2.0 On-Behalf-Of (например, веб-приложение среднего уровня, подключающееся к службам Analysis Services от имени пользователя). Опустить тип маркера при передаче маркера доступа в свойстве AccessToken . Клиентские библиотеки служб Analysis Services автоматически добавляют значение auth-scheme "Bearer" в маркер доступа. Не забудьте помнить следующее:

  • Маркеры доступа носителя Microsoft Entra имеют ограниченное время существования. По умолчанию от 60 до 90 минут. Если приложение выполняет длительные операции, превышающие время существования маркера доступа, можно предоставить функцию обратного вызова с помощью свойства OnAccessTokenExpired объекта AdomdConnection, чтобы обновить маркер доступа, когда срок действия текущего маркера доступа истекает. Кроме того, можно обновить свойство AccessToken напрямую без помощи функции обратного вызова. Рекомендуется использовать функцию обратного вызова, чтобы убедиться, что маркер доступа обновляется в течение текущего времени существования маркера доступа.
  • Использование свойства строки подключения паролей для передачи маркера доступа не рекомендуется. Вы по-прежнему можете опустить свойство идентификатора пользователя в строке подключения и указать только маркер доступа в свойстве Password , но в этих случаях маркер доступа не может быть обновлен. Используйте вместо этого свойство AccessToken , чтобы при необходимости предоставить новый маркер доступа для существующего подключения. Установка свойства Password и свойства AccessToken не поддерживается.

Примечание: Идентификатор пользователя имеет внедренное пространство. Альтернативный псевдоним для идентификатора пользователя — UID , а альтернативный псевдоним для пароля — PWD.

Свойства специального назначения

Эти свойства используются для обеспечения конкретных действий подключения, необходимых приложению. Свойства перечислены в алфавитном порядке.

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

Задает имя приложения, связанного с подключением. Это значение может быть полезно при мониторинге событий трассировки, особенно при наличии нескольких приложений, обращаюющихся к тем же базам данных. Например, добавление application Name='test" в строку подключения приводит к отображению "test" в трассировке профилировщика SQL Server. Псевдонимы для этого свойства включают SspropInitAppName, AppName. Дополнительные сведения см. в статье "Имя приложения для подключений SQL Server".

CommitTimeout

Свойство XMLA. Определяет, сколько времени в миллисекундах этап фиксации текущей выполняемой команды ожидается перед откатом. Если больше 0, переопределяет значение соответствующего свойства CommitTimeout в конфигурации сервера.

Время ожидания подключения

Определяет максимальное время (в секундах) клиент пытается подключиться до истечения времени ожидания. Если подключение не выполнено в течение этого периода, клиент завершает попытку подключиться и создает ошибку.

DbpropMsmdRequestMemoryLimit

Переопределяет значение свойства сервера Memory\QueryMemoryLimit для подключения.

Указанное в килобайтах, это свойство может уменьшить объем памяти, используемой во время запроса, из максимально допустимой памяти (указанной в процентах) в QueryMemoryLimit. Он не может увеличить объем памяти, используемой за пределы максимально допустимой памяти, указанной в QueryMemoryLimit.

Совместимость многомерных выражений

Цель этого свойства — обеспечить согласованный набор поведения многомерных выражений для приложений, которые выдают запросы многомерных выражений. Excel, использующий запросы многомерных выражений для заполнения и вычисления сводной таблицы, подключенной к службам Analysis Services, задает для этого свойства значение 1, чтобы убедиться, что элементы заполнителя в неровных иерархиях отображаются в сводной таблице. Допустимые значения: 0, 1, 2.

0 и 1 предоставляют элементы заполнителя; 2 не. Если это пусто, предполагается 0.

Режим отсутствующих многомерных выражений

Указывает, игнорируются ли отсутствующие члены в инструкциях многомерных выражений. Допустимые значения: Default, Error и Ignore. По умолчанию используется определяемое сервером значение. Ошибка создает ошибку, если элемент не существует. Игнорировать указывает, что отсутствующие значения следует игнорировать.

Оптимизация ответа

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

• 0x01 Использовать NormalTupleSet (по умолчанию).
• 0x02 Использовать, если срезы пусты.

Размер пакета

Применяется только к TCP-подключениям. Размер сетевого пакета (в байтах) от 512 до 32 767. Размер сетевого пакета по умолчанию — 4096.

Формат протокола

Задает формат XML, используемый протоколом связи XMLA. Допустимые значения: Default, XML или Binary. Можно указать XML-файл в двоичном формате или в виде текстового XML. Двоичный формат кодирует XML-элементы и атрибуты, что делает их меньше. Кроме того, сжатие также можно включить для сообщений, чтобы уменьшить размер запросов и ответов с помощью параметра "Сжатие транспорта". Запросы и ответы могут использовать различные форматы протокола в зависимости от того, что поддерживает клиент и сервер. Например, клиентская библиотека может поддерживать только двоичные файлы для ответов, но не для запросов, или сервер может отключить двоичный файл для входящих запросов.

Поставщик OLE DB может форматировать запросы и ответы в двоичном или сжатом формате. AMO и ADOMD.NET форматировать запросы в виде текста, но принимать ответы в двоичном или сжатом формате.

Это свойство строки подключения эквивалентно параметрам конфигурации сервера EnableBinaryXML и EnableCompression .

Таймаут

Указывает, сколько времени (в секундах) клиентская библиотека ожидает завершения команды перед созданием ошибки.

См. также

Основные классы AMO — объекты сервера
Класс AdomdConnection — свойства