Gérer les utilisateurs et rôles de bases de données

Article
06/01/2023

Au niveau de la base de données du modèle, tous les utilisateurs doivent appartenir à un rôle. Les rôles définissent les utilisateurs disposant d’autorisations spécifiques pour la base de données du modèle. Tout utilisateur ou groupe de sécurité ajouté à un rôle doit avoir un compte dans un client Microsoft Entra dans le même abonnement que le serveur.

Le mode de définition des rôles est différent selon l’outil utilisé, mais l’effet est le même.

Les autorisations des rôles incluent :

Administrateur : les utilisateurs disposent des autorisations complètes pour la base de données. Les rôles de base de données avec des autorisations d’administrateur sont différents des administrateurs de serveur.
Processus : les utilisateurs peuvent se connecter et effectuer des opérations de traitement sur la base de données et analyser les données des bases de données du modèle.
Lecture : les utilisateurs peuvent utiliser une application cliente pour se connecter à la base de données du modèle et analyser les données.

Lorsque vous créez un projet de modèle tabulaire, vous créez des rôles et ajoutez des utilisateurs ou des groupes à ces rôles à l’aide du Gestionnaire de rôles dans les projets Visual Studio avec Analysis Services. Lors du déploiement sur un serveur, utilisez SQL Server Management Studio (SSMS), cmdlets PowerShell Analysis Services ou Tabular Model Scripting Language (TMSL) pour ajouter ou supprimer des rôles et des membres utilisateur.

Lors de l'ajout d'un groupe de sécurité, utilisez obj:groupid@tenantid.

Lors de l’ajout d'un principal de service, utilisez app:appid@tenantid.

Pour ajouter ou gérer des rôles et des utilisateurs dans Visual Studio

Dans l’Explorateur de modèle tabulaire, cliquez avec le bouton droit sur Rôles.
Dans le Gestionnaire de rôles, cliquez sur Nouveau.
Entrez ensuite le nom du rôle.

Par défaut, le nom de rôle par défaut est numéroté de façon incrémentielle pour chaque nouveau rôle. Il est recommandé de saisir un nom qui identifie clairement le type de membre, par exemple, directeurs financiers ou spécialistes des ressources humaines.

Sélectionnez l’une des autorisations suivantes :

Autorisation	Description
Aucun	Les membres ne peuvent pas lire ou modifier le schéma de modèle et ne peuvent pas interroger les données.
Lire	Les membres peuvent interroger des données (selon les filtres de lignes) mais ne peuvent pas modifier le schéma de modèle.
Lecture et traitement	Les membres peuvent interroger des données (selon les filtres au niveau des lignes) et exécuter des processus et traiter toutes les opérations, mais ne peuvent pas modifier le schéma de modèle.
Processus	Les membres peuvent exécuter des processus et traiter toutes les opérations. Ils ne peuvent ni lire ou modifier le schéma de modèle, ni interroger les données.
Administrateur	Les membres peuvent modifier le schéma de modèle et interroger toutes les données.

Si le rôle que vous créez a l’autorisation de Lecture ou de Lecture et processus, vous pouvez ajouter des filtres de lignes à l’aide d’une formule DAX. Cliquez sur l’onglet Filtres de lignes, sélectionnez une table, puis cliquez sur le champ Filtre DAX, puis tapez une formule DAX.
Cliquez sur Membres>Ajouter externe.
Dans Ajouter un membre externe, entrez les utilisateurs ou groupes dans votre Microsoft Entra ID client par adresse e-mail. Une fois que vous avez cliqué sur OK et fermé le Gestionnaire de rôles, les rôles et les membres du rôle s’affichent dans l’Explorateur de modèles tabulaires.
Déployez votre serveur Azure Analysis Services.

Pour ajouter ou gérer des rôles et des utilisateurs dans SSMS

Pour ajouter des rôles et des utilisateurs à une base de données du modèle déployée, vous devez être connecté au serveur en tant qu’administrateur de serveur ou déjà dans un rôle de base de données avec des autorisations d’administrateur.

Dans Explorateur d’objets, cliquez avec le bouton droit sur Rôles>Nouveau rôle.
Dans Créer un rôle, entrez un nom de rôle et une description.

Sélectionnez une autorisation.

Autorisation	Description
Contrôle total (administrateur)	Les membres peuvent modifier le schéma de modèle, le processus et interroger toutes les données.
Base de données de processus	Les membres peuvent exécuter des processus et traiter toutes les opérations. Impossible de modifier le schéma de modèle et d'interroger les données.
Lire	Les membres peuvent interroger des données (selon les filtres de lignes) mais ne peuvent pas modifier le schéma de modèle.

Cliquez sur Appartenance, puis entrez un utilisateur ou un groupe dans votre client Microsoft Entra ID par adresse e-mail.
Si le rôle que vous créez a l’autorisation de Lecture, vous pouvez ajouter des filtres de lignes à l’aide d’une formule DAX. Cliquez sur Filtres de lignes, sélectionnez une table, puis tapez une formule DAX dans le champ Filtre DAX.

Pour ajouter des rôles et des utilisateurs à l’aide d’un script TMSL

Vous pouvez exécuter un script TMSL dans la fenêtre XMLA dans SSMS ou à l’aide de PowerShell. Utilisez la commande CreateOrReplace et l’objet Rôles.

Exemple de script TMSL

Dans cet exemple, un utilisateur externe B2B et un groupe sont ajoutés au rôle d’analyste avec des autorisations de Lecture pour la base de données SalesBI. L’utilisateur externe et le groupe doivent être dans le même client Microsoft Entra ID.

{
  "createOrReplace": {
    "object": {
      "database": "SalesBI",
      "role": "Analyst"
    },
    "role": {
      "name": "Users",
      "description": "All allowed users to query the model",
      "modelPermission": "read",
      "members": [
        {
          "memberName": "user1@contoso.com",
          "identityProvider": "AzureAD"
        },
        {
          "memberName": "group1@adventureworks.com",
          "identityProvider": "AzureAD"
        }
      ]
    }
  }
}

Pour ajouter des rôles et des utilisateurs à l’aide de Powershell

Le module SqlServer fournit des applets de commande de gestion de bases de données spécifiques à chaque tâche, ainsi que l’applet de commande Invoke-ASCmd à usage général, qui accepte un script ou une requête utilisant le langage de script de modèle tabulaire (TMSL). Les applets de commande suivantes sont utilisées pour la gestion des utilisateurs et des rôles de bases de données.

Applet de commande	Description
Add-RoleMember	Ajoute un membre à un rôle de base de données.
Remove-RoleMember	Supprime un membre d’un rôle de base de données.
Invoke-ASCmd	Exécute un script TMSL.

Filtres de lignes

Les filtres de lignes définissent les lignes d’une table qui peuvent être interrogées par les membres d’un rôle donné. Les filtres de lignes sont définis pour chaque table dans un modèle à l'aide de formules DAX.

Les filtres de lignes peuvent être définis uniquement pour les rôles avec des autorisations de Lecture et de Lecture et processus. Par défaut, si un filtre de lignes n’est pas défini pour une table en particulier, les membres peuvent interroger toutes les lignes de la table, sauf si un filtrage croisé s’applique à partir d’une autre table.

Les filtres de lignes nécessitent une formule DAX, qui doit correspondre à une valeur TRUE/FALSE, pour définir les lignes qui peuvent être interrogées par les membres de ce rôle en particulier. Les lignes non incluses dans la formule DAX ne peuvent pas être interrogées. Par exemple, la table Clients avec l’expression de filtres de la ligne suivante, =Customers [Country] = "USA", les membres du rôle Ventes peuvent voir uniquement les clients aux États-Unis.

Les filtres de lignes s’appliquent aux lignes spécifiées et aux lignes connexes. Si une table possède plusieurs relations, les filtres appliquent la sécurité de la relation qui est active. Les filtres de lignes sont croisés avec d’autres filtres de lignes définis pour les tables associées, par exemple :

Table	Expression DAX
Région	=Region[Country]="USA"
ProductCategory	=ProductCategory[Name]="Bicycles"
Transactions	=Transactions[Year]=2016

L’effet net est que les membres peuvent interroger les lignes de données pour lesquelles le client réside aux États-Unis, la catégorie de produits est bicyclettes et l’année est 2016. Les utilisateurs ne peuvent pas interroger les transactions en dehors des États-Unis, qui ne sont pas des bicyclettes ou les transactions hors de 2016, sauf si ils sont membres d’un autre rôle qui accorde ces autorisations.

Vous pouvez utiliser le filtre, = FALSE(), pour refuser l’accès à toutes les lignes pour une table entière.

Étapes suivantes

Gérer les administrateurs de serveur
Gérer Azure Analysis Services avec PowerShell
Langage TMSL (Tabular Model Scripting Language)

Partager via