Propriétés des chaînes de connexion (Analysis Services)
Cette rubrique documente les propriétés de chaîne de connexion que vous pouvez définir dans le concepteur ou les outils d'administration, ou voir dans les chaînes de connexion générées par les applications clientes qui se connectent aux données Analysis Services et interrogent ces dernières. Par conséquent, elle couvre uniquement un sous-ensemble des propriétés disponibles. La liste complète inclut de nombreuses propriétés de serveur et de base de données, vous permettant de personnaliser une connexion à une application spécifique, indépendamment de la façon dont l'instance ou la base de données est configurée sur le serveur.
Les développeurs qui créent des chaînes de connexion personnalisées dans le code de l'application doivent consulter la documentation de l'API pour le client ADOMD.NET pour obtenir une liste plus détaillée : ConnectionString
Les propriétés décrites dans cette rubrique sont utilisées par les bibliothèques clientes Analysis Services, ADOMD.NET, AMO et le fournisseur OLE DB pour Analysis Services. La majorité des propriétés de chaîne de connexion peut être utilisée avec les trois bibliothèques clientes. Les exceptions sont signalées dans la description.
Cette rubrique comprend les sections suivantes :
Paramètres de connexion couramment utilisés
Authentification et sécurité
Paramètres spéciaux
Paramètres réservés pour un usage ultérieur
Exemples de chaîne de connexion
Formats de chaîne de connexion utilisés dans Analysis Services
Chiffrement des chaînes de connexion
[!REMARQUE]
Si, par inadvertance, vous définissez deux fois la même propriété, c'est la dernière figurant dans la chaîne de connexion qui est utilisée.
Pour plus d'informations sur la façon de spécifier une connexion Analysis Services dans des applications Microsoft existantes, consultez Connexion à partir d'applications clientes (Analysis Services).
Paramètres de connexion couramment utilisés
Le tableau suivant décrit les propriétés couramment utilisées lors de la génération d'une chaîne de connexion.
Propriété |
Description |
Exemple |
---|---|---|
Data Source - ou - DataSource |
Spécifie l'instance du serveur. Cette propriété est obligatoire pour toutes les connexions. Les valeurs valides incluent le nom réseau ou l'adresse IP du serveur, local ou localhost pour les connexions locales, une adresse URL si le serveur est configuré pour l'accès HTTP ou HTTPS, ou le nom d'un fichier de cube local (.cub). |
Data source=AW-SRV01 pour l'instance et le port par défaut (TCP 2383). Data source=AW-SRV01$Finance:8081 pour un port fixe pour une instance nommée ($Finance). Data source=AW-SRV01.corp.Adventure-Works.com pour un nom de domaine complet, avec le port et l'instance par défaut. Data source=172.16.254.1 pour une adresse IP du serveur, en ignorant la recherche de serveur DNS, utile pour résoudre des problèmes de connexion. |
Initial Catalog - ou - Catalog |
Spécifie le nom de la base de données Analysis Services à laquelle se connecter. La base de données doit être déployée sur Analysis Services et vous devez avoir l'autorisation de vous y connecter. Cette propriété est facultative pour les connexions AMO, mais requise pour ADOMD.NET. |
Initial catalog=AdventureWorks2012 |
Provider |
Les valeurs valides sont MSOLAP ou MSOLAP.<version>, où <version> correspond à 3, 4 ou 5. Dans le système de fichiers, le nom du fournisseur de données est msolap110.dll pour la version SQL Server 2012, msolap100.dll pour SQL Server 2008 et SQL Server 2008 R2, et msolap90.dll pour SQL Server 2005.
La version actuelle est MSOLAP.5. Cette propriété est facultative. Par défaut, les bibliothèques clientes lisent la version actuelle du fournisseur OLE DB à partir du Registre. Il vous suffit de définir cette propriété à si vous avez besoin d'une version spécifique du fournisseur de données, par exemple pour vous connecter à une instance SQL Server 2008. Les fournisseurs de données correspondent aux versions de SQL Server. Si votre organisation utilise la version actuelle et les versions antérieures d'Analysis Services, vous devrez probablement spécifier le fournisseur à utiliser dans les chaînes de connexion que vous créez manuellement. Vous devrez peut-être aussi télécharger et installer des versions spécifiques du fournisseur de données sur des ordinateurs qui n'ont pas la version dont vous avez besoin. Vous pouvez télécharger le fournisseur OLE DB à partir des pages SQL Server Feature Pack du Centre de téléchargement. Accédez à Microsoft SQL Server 2012 Feature Pack pour télécharger le fournisseur OLE DB d'Analysis Services pour SQL Server 2012. MSOLAP.4 a été implémenté à la fois dans SQL Server 2008 et dans SQL Server 2008 R2. La version 2008 R2 prend en charge les classeurs PowerPivot et doit parfois être installée manuellement sur les serveurs SharePoint. Pour distinguer ces versions, vous devez vérifier le numéro de build dans les propriétés de fichier du fournisseur : Accédez au dossier \Program Files\Microsoft Analyse Services\AS OLEDB\10. Cliquez avec le bouton droit sur msolap110.dll et sélectionnez Propriétés. Cliquez sur Détails. Consultez les informations de version du fichier. La version doit inclure 10.50.<numéro_de_build> pour SQL Server 2008 R2. Pour plus d'informations, consultez Installer le fournisseur OLE DB Analysis Services sur les serveurs SharePoint et Bibliothèques clientes utilisées pour les connexions Analysis Services. |
Provider=MSOLAP.3 est utilisé pour les connexions qui nécessitent la version SQL Server 2005 du fournisseur OLE DB pour Analysis Services. |
Cube |
Nom du cube ou de la perspective. Une base de données peut contenir plusieurs cubes et perspectives. Lorsque plusieurs cibles sont possibles, indiquez le nom du cube ou de la perspective dans la chaîne de connexion. |
Cube=SalesPerspective indique que vous pouvez utiliser la propriété de chaîne de connexion Cube pour spécifier le nom d'un cube ou le nom d'une perspective. |
Authentification et sécurité
Cette section présente les propriétés de chaîne de connexion relatives à l'authentification et au chiffrement. Analysis Services utilise l'authentification Windows uniquement, mais vous pouvez définir des propriétés sur la chaîne de connexion pour transmettre un nom d'utilisateur et un mot de passe spécifiques.
Les propriétés sont répertoriées par ordre alphabétique.
Propriété |
Description |
---|---|
EffectiveUserName |
À utiliser lorsque l'identité de l'utilisateur final doit être empruntée sur le serveur. Spécifiez le compte sous le format domaine\utilisateur. Pour utiliser cette propriété, l'appelant doit avoir des autorisations d'administration dans Analysis Services. Pour plus d'informations sur l'utilisation de cette propriété dans un classeur Excel depuis SharePoint, consultez Utiliser Analysis Services EffectiveUserName dans SharePoint Server 2013. Pour obtenir une illustration de l'utilisation de cette propriété avec Reporting Services, consultez Utilisation d'EffectiveUserName pour l'emprunt d'identité dans SSAS. EffectiveUserName est utilisé dans une installation de PowerPivot pour SharePoint afin de recueillir des informations d'utilisation. L'identité de l'utilisateur est fournie au serveur afin que les événements ou les erreurs qui incluent l'identité de l'utilisateur puissent être stockés dans les fichiers journaux. Dans le cas de PowerPivot, elle n'est pas utilisée pour l'autorisation. |
Encrypt Password |
Spécifie si un mot de passe local doit être utilisé pour chiffrer les cubes locaux. Les valeurs valides sont True ou False. La valeur par défaut est False. |
Encryption Password |
Le mot de passe utilisé pour déchiffrer un cube local chiffré. La valeur par défaut est vide. Cette valeur doit être explicitement définie par l'utilisateur. |
Impersonation Level |
Indique le niveau d'emprunt d'identité que le serveur est autorisé à utiliser lorsqu'il emprunte l'identité du client. Les valeurs suivantes sont valides :
|
Integrated Security |
L'identité Windows de l'appelant est utilisée pour la connexion à Analysis Services. Les valeurs possibles sont SSPI et BASIC ou aucune valeur. Integrated Security=SSPI est la valeur par défaut pour les connexions TCP, ce qui autorise l'authentification NTLM, Kerberos ou anonyme. La valeur par défaut pour les connexions HTTP est vide. Quand vous utilisez SSPI, ProtectionLevel doit avoir l'une des valeurs suivantes : Connect, PktIntegrity, PktPrivacy. |
Persist Encrypted |
Définissez cette propriété lorsque l'application cliente doit disposer de l'objet source de données pour conserver les informations d'authentification sensibles, telles qu'un mot de passe, sous forme chiffrée. Par défaut, les informations d'identification ne sont pas conservées. |
Persist Security Info |
Les valeurs valides sont True et False. Lorsque la valeur est True, les informations de sécurité, telles que l'identité de l'utilisateur ou le mot de passe spécifié précédemment dans la chaîne de connexion, figurent dans la connexion une fois celle-ci établie. La valeur par défaut est False. |
ProtectionLevel |
Détermine le niveau de sécurité utilisé lors de la connexion. Les valeurs valides sont les suivantes :
Pour plus d'informations, consultez Établissement de connexions sécurisées dans ADOMD.NET |
Roles |
Spécifiez une liste séparée par des virgules des rôles prédéfinis pour la connexion à un serveur ou une base de données à l'aide des autorisations données à ce rôle. Si cette propriété est omise, tous les rôles sont utilisés, et les autorisations effectives correspondent à la combinaison de tous les rôles. Définissez la propriété sur une valeur vide (par exemple, Roles=’ ‘) si la connexion cliente n'a aucune appartenance au rôle. Un administrateur utilisant cette propriété se connecte à l'aide des autorisations données par le rôle. Certaines commandes risquent d'échouer si le rôle ne fournit pas d'autorisations suffisantes. |
SSPI |
Spécifie explicitement les packages de sécurité à utiliser pour l'authentification du client lorsque Integrated Security a la valeur SSPI. SSPI prend en charge plusieurs packages, mais cette propriété permet de spécifier un package particulier. Les valeurs valides sont Negotiate, Kerberos, NTLM et Anonymous User. Si propriété n'est pas définie, tous les packages sont disponibles pour la connexion. |
Use Encryption for Data |
Chiffre les transmissions de données. Les valeurs possibles sont True et False. |
User ID=…; Password= |
User ID et Password sont utilisés conjointement. Analysis Services emprunte l'identité de l'utilisateur spécifiée au moyen de ces informations d'identification. Sur une connexion Analysis Services, placer les informations d'identification sur la ligne de commande n'est permis que lorsque le serveur est configuré pour l'accès HTTP et que vous avez défini l'authentification de base au lieu de la sécurité intégrée dans le répertoire virtuel IIS. Le nom d'utilisateur et le mot de passe doivent être des informations d'identification d'une identité Windows, c'est-à-dire un compte d'utilisateur de domaine ou local. Notez que User ID comporte un espace incorporé. D'autres alias pour cette propriété sont UserName (sans espace) et UID. L'alias pour Password est PWD. |
Paramètres spéciaux
Cette section décrit les autres paramètres de chaîne de connexion. Ceux-ci sont utilisées pour garantir des comportements de connexion spécifiques requis par une application.
Les propriétés sont répertoriées par ordre alphabétique.
Propriété |
Description |
---|---|
Application Name |
Définit le nom de l'application associée à la connexion. Cette valeur peut être utile pour surveiller les événements de suivi, notamment lorsque vous disposez de plusieurs applications accédant aux mêmes bases de données. Par exemple, ajouter Application Name=’test’ à une chaîne de connexion entraîne l'affichage de ‘test’ dans une trace de SQL Server Profiler, comme le montre la capture d'écran suivante : Les alias pour cette propriété sont sspropinitAppName, AppName. Pour plus d'informations, consultez Utiliser le paramètre de nom d'application lors de la connexion à SQL Server. |
AutoSyncPeriod |
Définit la fréquence (en millisecondes) de la synchronisation du cache client et serveur. ADOMD.NET facilite la mise en cache client pour les objets souvent utilisés avec une charge minimale de mémoire. Cela permet de réduire le nombre d'allers-retours au serveur. La valeur par défaut est 10 000 millisecondes (dix secondes). Si la valeur est Null ou 0, la synchronisation automatique est désactivée. |
Character Encoding |
Définit la manière dont les caractères sont encodés dans la demande. Les valeurs valides sont Default ou UTF-8 (les deux sont équivalentes), et UTF-16 |
CompareCaseSensitiveStringFlags |
Ajuste les comparaisons de chaînes sensibles à la casse pour les paramètres régionaux spécifiés. Pour plus d'informations sur la définition de cette propriété, consultez Propriété CompareCaseSensitiveStringFlags. |
Compression Level |
Si TransportCompression est XPRESS, vous pouvez définir le niveau de compression pour contrôler le degré de compression utilisé. Les valeurs valides sont comprises entre 0 et 9, 0 correspondant à une compression moindre et 9 à la compression la plus importante. Une compression élevée ralentit les performances. La valeur par défaut est 0. |
Connect Timeout |
Détermine la durée maximale (en secondes) pendant laquelle le client tente d'établir une connexion avant expiration du délai d'attente. Si une connexion ne parvient pas à s'établir au cours de cette période, le client cesse toute tentative de connexion et génère une erreur. |
MDX Compatibility |
L'objectif de cette propriété est de garantir un ensemble cohérent de comportements MDX pour les applications qui génèrent des requêtes MDX. Excel, qui utilise des requêtes MDX pour remplir et calculer un tableau croisé dynamique connecté à Analysis Services, définit cette propriété sur 1 pour s'assurer que les membres d'espace réservé dans les hiérarchies déséquilibrées sont visibles dans un tableau croisé dynamique. Les valeurs valides incluent 0, 1 et 2. 0 et 1 exposent les membres d'espace réservé, contrairement à la valeur 2. En l'absence de valeur, c'est 0 qui est utilisé. |
MDX Missing Member Mode=Error |
Indique si les membres manquants sont ignorés dans les instructions MDX. Les valeurs valides sont Default, Error et Ignore. Default utilise une valeur définie par le serveur. Error génère une erreur lorsqu'un membre n'existe pas. Ignore spécifie que les valeurs manquantes doivent être ignorées. |
Mode |
Définit les autorisations d'accès à la base de données dans la chaîne de connexion, en vous permettant de remplacer la valeur existante. Les valeurs valides sont Read et ReadWrite. Dans SSMS, cette propriété de base de données est désignée comme mode de lecture-écriture. La valeur par défaut est ReadWrite. |
Optimize Response |
Un masque de bits indiquant lesquelles des optimisations suivantes de réponse aux requêtes sont activées.
|
Packet Size |
Taille d'un paquet réseau (en octets), comprise entre 512 et 32 767. La taille des paquets réseau par défaut est 4 096. |
Protocol Format |
Définit le format du code XML envoyé au serveur. Les valeurs valides sont Default, XML ou Binary. Le protocole est XMLA. Vous pouvez spécifier que XML soit envoyé sous forme compressée (il s'agit de la valeur par défaut), dans un fichier XML brut ou sous un format binaire. Le format binaire encode les attributs et les éléments XML, ce qui les rend plus petits. La compression est un format propriétaire qui réduit encore la taille des demandes et des réponses. La compression et les formats binaires sont utilisés pour accélérer les demandes et les réponses de transfert de données. Vous devez utiliser une bibliothèque cliente sur la connexion si vous utilisez le format binaire ou le format compressé. Le fournisseur OLE DB peut mettre en forme les demandes et les réponses au format binaire ou compressé. AMO et ADOMD.NET mettent en forme les demandes sous forme de texte, mais acceptent des réponses au format binaire ou compressé. Cette propriété de chaîne de connexion est équivalente aux paramètres de configuration de serveur EnableBinaryXML et EnableCompression. |
Real Time Olap |
Définissez cette propriété pour ignorer la mise en cache, afin que toutes les partitions écoutent activement les notifications de requêtes. Par défaut, cette propriété n'est pas définie. |
Safety Options |
Définit le niveau de sécurité pour les actions et les fonctions définies par l'utilisateur. Les valeurs valides sont 0, 1 et 2. Dans une connexion Excel, cette propriété correspond à Options de sécurité=2. Des informations sur cette option sont disponibles dans ConnectionString. |
SQLQueryMode |
Spécifie si les requêtes SQL incluent des calculs. Les valeurs valides sont Data, Calculated, IncludeEmpty. Data signifie qu'aucun calcul n'est autorisé. Calculated autorise les calculs. IncludeEmpty permet le renvoi de calculs et de lignes vides dans le résultat de la requête. |
Timeout |
Spécifie la durée (en millisecondes) pendant laquelle la bibliothèque cliente attend la fin d'une commande avant de générer une erreur. |
Transport Compression |
Définit la manière dont les communications client et serveur sont compressées, si la compression est définie via la propriété Protocol Format. Les valeurs valides sont Default, None, Compressed et gzip. Default indique l'absence de compression pour TCP ou gzip pour HTTP. None indique qu'aucune compression n'est utilisée. Compressed utilise la compression XPRESS (SQL Server 2008 et versions ultérieures). gzip est valide uniquement pour les connexions HTTP, où la demande HTTP inclut Accept-Encoding=gzip. |
UseExistingFile |
Utilisé lors de la connexion à un cube local. Cette propriété spécifie si le cube local est remplacé. Les valeurs valides sont True ou False. Si la valeur True est définie, le fichier de cube doit exister. Le fichier existant sera la cible de la connexion. Si la valeur définie est False, le fichier de cube est remplacé. |
VisualMode |
Définissez cette propriété pour contrôler la façon dont les membres sont agrégées lorsque la sécurité de dimension est appliquée. Pour les données de cube que toute le monde est autorisé à afficher, l'agrégation de tous les membres est logique car toutes les valeurs qui contribuent au total sont visibles. Toutefois, si vous filtrez ou restreignez les dimensions en fonction de l'identité de l'utilisateur, afficher un total basé sur tous les membres (en combinant les valeurs restreintes et autorisées dans un seul total) risque d'être déroutant ou d'inclure plus d'informations que nécessaire. Pour spécifier la façon dont les membres sont agrégés lorsque la sécurité de dimension est appliquée, vous pouvez définir cette propriété sur True afin d'utiliser uniquement les valeurs autorisées dans l'agrégation, ou False pour exclure les valeurs restreintes du total. Si la chaîne de connexion est définie, cette valeur s'applique au niveau de cube ou de perspective. Dans un modèle, vous pouvez contrôler les valeurs totales affichées à un niveau plus granulaire. Les valeurs valides sont 0, 1 et 2.
Les alias pour cette propriété sont Visual Total ou Default MDX Visual Mode. |
Paramètres réservés pour un usage ultérieur
Les propriétés suivantes sont autorisées sur une chaîne de connexion, mais ne sont pas opérationnelles dans les versions actuelle d'Analysis Services.
Utilisateur authentifié
Mise en cache des informations d'authentification
Mode de cache (l'utilisation de cette propriété a été étudiée avec les versions antérieures. Bien que son utilisation soit recommandée dans certains blogs, vous devez éviter de définir cette propriété sauf spécification contraire par le support technique de Microsoft).
Stratégie de cache
Rapport du cache
Ratio2 du cache
Utiliser le cache de formule
Limite dynamique de débogage
Mode débogage
SQLCompatibility
Exemples de chaîne de connexion
Cette section montre la chaîne de connexion que vous utiliserez très probablement lors de la configuration d'une connexion Analysis Services dans les applications couramment utilisées.
Chaîne de connexion générique
Vous pouvez utiliser une chaîne de connexion comme celle-ci si vous configurez une connexion depuis Reporting Services.
Data source=<servername>; initial catalog=<databasename>
Chaîne de connexion dans Excel
La chaîne de connexion ADOMD.NET par défaut dans Excel spécifie le fournisseur de données, le serveur, le nom de la base de données et la sécurité intégrée de Windows. Le niveau de compatibilité MDX est toujours défini sur 1. Bien que vous puissiez modifier la valeur pour la session active, Excel rétablira la compatibilité MDX à 1 lors de la prochaine ouverture du fichier.
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
Pour plus d'informations, consultez Connexions de données, sources de données et chaînes de connexion (SSRS) et Authentification de données pour Excel Services dans SharePoint Server 2013.
Formats de chaîne de connexion utilisés dans Analysis Services
Cette section répertorie tous les formats de chaîne de connexion pris en charge par Analysis Services. À l'exception des connexions aux bases de données PowerPivot, vous pouvez spécifier ces chaînes de connexion dans les applications qui se connectent à Analysis Services.
Connexions natives (ou directes) au serveur
Data Source=server[:port][\instance] où « port » et « \instance » sont facultatifs. Par exemple, la spécification de « Data Source=server1 » ouvre une connexion à l'instance par défaut (et au port par défaut 2383) sur un serveur nommé « server1 ».
« Data Source=server1:port1 » ouvre une connexion à une instance en cours de exécution d'Analysis Services sur le port « port1 » sur le serveur « server1 ».
« Data Source=server1\instance1 » ouvre une connexion au navigateur SQL (sur son port par défaut 2382), résout le port de l'instance nommée « instance1 », puis ouvre la connexion à ce port Analysis Services.
« Data Source=server1:port1\instance1 » ouvre une connexion au navigateur SQL sur « port1 », résout le port de l'instance nommée « instance1 », puis ouvre la connexion à ce port Analysis Services.
Connexions de cube locales (fichiers .cub)
Data Source=<path>, par exemple « source de données = c:\temp\a.cub »
Connexions HTTP à msmdpump.dll
Data Source=<URL>, où l'URL est l'adresse HTTP ou HTTPS dans le dossier virtuel IIS qui contient le fichier msmdpump.dll. Pour plus d'informations, consultez Configurer l'accès HTTP à Analysis Services sur Internet Information Services (IIS) 7.0.
Connexions HTTP aux classeurs PowerPivot (fichiers .xlsx, .xlsb ou .xlsm)
Data Source=<URL>, où l'URL est le chemin d'accès SharePoint à un classeur PowerPivot publié dans une bibliothèque SharePoint. Par exemple, « Data Source=https://localhost/Shared Documents/Sales.xlsx ».
Connexions HTTP aux fichiers de connexion de modèle sémantique BI
Data Source=<URL> où l'URL est le chemin d'accès SharePoint au fichier .bism. Par exemple, « Data Source=https://localhost/Shared Documents/Sales.bism ».
Connexions incorporées PowerPivot
Data Source=$Embedded$ où $embedded$ " est un moniker qui fait référence à un modèle de données PowerPivot incorporées dans le classeur. Cette chaîne de connexion est créée et gérée en interne. Ne la modifiez pas. Les chaînes de connexion incorporées sont résolues par le complément PowerPivot pour Excel sur les stations de travail clientes, ou par les instances PowerPivot pour SharePoint dans une batterie de serveurs SharePoint.
Contexte de serveur local dans les procédures stockées Analysis Services
Data Source=*, où * est résolu sur l'instance locale.
Chiffrement des chaînes de connexion
Analysis Services chiffre et stocke les chaînes de connexion qu'il utilise pour se connecter à chacune de ses sources de données. Si la connexion à une source de données nécessite un nom d'utilisateur et un mot de passe, vous pouvez demander à Analysis Services de stocker le nom et le mot de passe avec la chaîne de connexion, ou lui indiquer de demander le nom et le mot de passe chaque fois qu'une connexion à la source de données est nécessaire. Si vous indiquez à Analysis Services de vous demander les informations utilisateur, ceci implique que ces informations ne doivent pas être stockées et chiffrées. En revanche, si vous stockez ces informations dans la chaîne de connexion, ces informations doivent être chiffrées et protégées.
Pour chiffrer et protéger les informations de la chaîne de connexion, Analysis Services utilise l'API de protection des données. Analysis Services utilise une clé de chiffrement distincte pour chiffrer les informations de la chaîne de connexion de chaque base de données Analysis Services. Analysis Services crée cette clé lorsque vous créez une base de données, et chiffe les informations de la chaîne de connexion en fonction du compte de démarrage Analysis Services. Lorsque Analysis Services démarre, la clé chiffrée de chaque base de données est lue, déchiffrée et stockée. Analysis Services utilise ensuite la clé déchiffrée appropriée pour déchiffrer les informations de la chaîne de connexion à la source de données lorsque Analysis Services doit se connecter à cette dernière.
Voir aussi
Concepts
Configurer l'accès HTTP à Analysis Services sur Internet Information Services (IIS) 7.0
Configurer Analysis Services pour la délégation contrainte Kerberos
Bibliothèques clientes utilisées pour les connexions Analysis Services