Démarrage rapide : Créer un compte Microsoft Purview (anciennement Azure Purview) à l’aide du Kit de développement logiciel (SDK) .NET
Remarque
Catalogue de données Microsoft Purview (classique) et Data Health Insights (classique) n’acceptent plus de nouveaux clients et ces services, précédemment Azure Purview, sont désormais en mode de support client.
Importante
Vous ne pouvez créer qu’un seul compte Microsoft Purview par locataire. Si votre organization dispose déjà d’un compte Microsoft Purview, vous ne pourrez pas créer de compte Microsoft Purview, sauf si votre organization déjà plusieurs comptes et est toujours sous le quota préexistant. Pour plus d’informations, consultez la FAQ.
Dans ce guide de démarrage rapide, vous allez utiliser le Kit de développement logiciel (SDK) .NET pour créer un compte Microsoft Purview (anciennement Azure Purview).
Le portail de gouvernance Microsoft Purview présente des outils tels que les Mappage de données Microsoft Purview et les Catalogue de données Microsoft Purview qui vous aident à gérer et à gouverner votre paysage de données. En vous connectant à des données sur vos sources locales, multiclouds et SaaS (Software-as-a-Service), le Mappage de données Microsoft Purview crée une carte à jour de vos informations. Il identifie et classifie les données sensibles et fournit un linage de bout en bout. Les consommateurs de données sont en mesure de découvrir des données dans votre organization, et les administrateurs de données sont en mesure d’auditer, de sécuriser et de garantir une utilisation appropriée de vos données.
Pour plus d’informations sur les fonctionnalités de gouvernance classiques de Microsoft Purview, consultez la page vue d’ensemble de nos solutions de gouvernance.
Configuration requise
Si vous n’avez pas d’abonnement Azure, créez un abonnement gratuit avant de commencer.
Un locataire Microsoft Entra associé à votre abonnement.
Le compte d’utilisateur que vous utilisez pour vous connecter à Azure doit être membre du rôle contributeur ou propriétaire, ou administrateur de l’abonnement Azure. Pour afficher les autorisations dont vous disposez dans l’abonnement, procédez comme suit :
- Accéder à la Portail Azure
- Sélectionnez votre nom d’utilisateur dans le coin supérieur droit.
- Sélectionnez le bouton de sélection (« ... ») pour plus d’options.
- Sélectionnez ensuite Mes autorisations.
- Si vous avez accès à plusieurs abonnements, sélectionnez l’abonnement approprié.
Se connecter à Azure
Connectez-vous au Portail Azure avec votre compte Azure.
Visual Studio
La procédure pas à pas de cet article utilise Visual Studio 2019. Les procédures pour Visual Studio 2013, 2015 ou 2017 peuvent différer légèrement.
Kit de développement logiciel (SDK) Azure .NET
Téléchargez et installez le Kit de développement logiciel (SDK) Azure .NET sur votre ordinateur.
Créer une application dans Microsoft Entra ID
- Dans Créer une application Microsoft Entra, créez une application qui représente l’application .NET que vous créez dans ce tutoriel. Pour l’URL de connexion, vous pouvez fournir une URL factice comme indiqué dans l’article (
https://contoso.org/exampleapp). - Dans Obtenir des valeurs pour la connexion, obtenez l’ID d’application et l’ID de locataire, puis notez ces valeurs que vous utiliserez plus loin dans ce tutoriel.
- Dans Certificats et secrets, obtenez la clé d’authentification et notez cette valeur que vous utiliserez plus loin dans ce tutoriel.
- Dans Attribuer l’application à un rôle, attribuez l’application au rôle Contributeur au niveau de l’abonnement afin que l’application puisse créer des fabriques de données dans l’abonnement.
Créer un projet Visual Studio
Ensuite, créez une application console C# .NET dans Visual Studio :
- Lancez Visual Studio.
- Dans la fenêtre Démarrer, sélectionnez Créer une application console de projet>(.NET Framework). .NET version 4.5.2 ou ultérieure est obligatoire.
- Dans Nom du projet, entrez PurviewQuickStart.
- Sélectionnez Créer pour créer le projet.
Installation de packages NuGet
Sélectionnez Outils>NuGet Package ManagerConsole du gestionnaire >de package.
Dans le volet Console du Gestionnaire de package, exécutez les commandes suivantes pour installer les packages. Pour plus d’informations, consultez le package NuGet Microsoft.Azure.Management.Purview.
Install-Package Microsoft.Azure.Management.Purview Install-Package Microsoft.Azure.Management.ResourceManager -IncludePrerelease Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory
Conseil
Si vous obtenez une erreur indiquant : <Le nom> du package est introuvable dans les sources principales suivantes et qu’il répertorie un dossier local, vous devez mettre à jour les sources de votre package dans Visual Studio pour inclure le site Nuget en tant que source en ligne.
- Accéder aux outils
- Sélectionner le Gestionnaire de package NuGet
- Sélectionnez Paramètres de gestion des packages
- Sélectionner les sources de package
- Ajouter https://nuget.org/api/v2/ en tant que source.
Créer un client Microsoft Purview
Ouvrez Program.cs, incluez les instructions suivantes pour ajouter des références à des espaces de noms.
using System; using System.Collections.Generic; using System.Linq; using Microsoft.Rest; using Microsoft.Rest.Serialization; using Microsoft.Azure.Management.ResourceManager; using Microsoft.Azure.Management.Purview; using Microsoft.Azure.Management.Purview.Models; using Microsoft.IdentityModel.Clients.ActiveDirectory;Ajoutez le code suivant à la méthode Main qui définit les variables. Remplacez les espaces réservés par vos propres valeurs. Pour obtenir la liste des régions Azure dans lesquelles Microsoft Purview est actuellement disponible, recherchez Microsoft Purview et sélectionnez les régions qui vous intéressent dans la page suivante : Produits disponibles par région.
// Set variables string tenantID = "<your tenant ID>"; string applicationId = "<your application ID>"; string authenticationKey = "<your authentication key for the application>"; string subscriptionId = "<your subscription ID where the data factory resides>"; string resourceGroup = "<your resource group where the data factory resides>"; string region = "<the location of your resource group>"; string purviewAccountName = "<specify the name of purview account to create. It must be globally unique.>";Ajoutez le code suivant à la méthode Main qui crée un instance de la classe PurviewManagementClient. Vous utilisez cet objet pour créer un compte Microsoft Purview.
// Authenticate and create a purview management client var context = new AuthenticationContext("https://login.windows.net/" + tenantID); ClientCredential cc = new ClientCredential(applicationId, authenticationKey); AuthenticationResult result = context.AcquireTokenAsync( "https://management.azure.com/", cc).Result; ServiceClientCredentials cred = new TokenCredentials(result.AccessToken); var client = new PurviewManagementClient(cred) { SubscriptionId = subscriptionId };
Créer un compte
Ajoutez le code suivant à la méthode Main qui créera le compte Microsoft Purview.
// Create a purview Account
Console.WriteLine("Creating Microsoft Purview Account " + purviewAccountName + "...");
Account account = new Account()
{
Location = region,
Identity = new Identity(type: "SystemAssigned"),
Sku = new AccountSku(name: "Standard", capacity: 4)
};
try
{
client.Accounts.CreateOrUpdate(resourceGroup, purviewAccountName, account);
Console.WriteLine(client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState);
}
catch (ErrorResponseModelException purviewException)
{
Console.WriteLine(purviewException.StackTrace);
}
Console.WriteLine(
SafeJsonConvert.SerializeObject(account, client.SerializationSettings));
while (client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState ==
"PendingCreation")
{
System.Threading.Thread.Sleep(1000);
}
Console.WriteLine("\nPress any key to exit...");
Console.ReadKey();
Exécuter le code
Générez et démarrez l’application, puis vérifiez l’exécution.
La console affiche la progression de la création d’un compte Microsoft Purview.
Exemple de résultat
Creating Microsoft Purview Account testpurview...
Succeeded
{
"sku": {
"capacity": 4,
"name": "Standard"
},
"identity": {
"type": "SystemAssigned"
},
"location": "southcentralus"
}
Press any key to exit...
Vérifier la sortie
Accédez à la page Comptes Microsoft Purview dans le Portail Azure et vérifiez le compte créé à l’aide du code ci-dessus.
Supprimer un compte Microsoft Purview
Pour supprimer par programmation un compte Microsoft Purview, ajoutez les lignes de code suivantes au programme :
Console.WriteLine("Deleting the Microsoft Purview Account");
client.Accounts.Delete(resourceGroup, purviewAccountName);
Vérifier si le nom du compte Microsoft Purview est disponible
Pour case activée disponibilité d’un compte Purview, utilisez le code suivant :
CheckNameAvailabilityRequest checkNameAvailabilityRequest = newCheckNameAvailabilityRequest()
{
Name = purviewAccountName,
Type = "Microsoft.Purview/accounts"
};
Console.WriteLine("Check Microsoft Purview account name");
Console.WriteLine(client.Accounts.CheckNameAvailability(checkNameAvailabilityRequest).NameAvailable);
Le code ci-dessus avec imprimer « True » si le nom est disponible et « False » si le nom n’est pas disponible.
Étapes suivantes
Dans ce guide de démarrage rapide, vous avez appris à créer un compte Microsoft Purview (anciennement Azure Purview), à supprimer le compte et à case activée pour la disponibilité des noms. Vous pouvez maintenant télécharger le Kit de développement logiciel (SDK) .NET et en savoir plus sur les autres actions du fournisseur de ressources que vous pouvez effectuer pour un compte Microsoft Purview.
Suivez les articles suivants pour découvrir comment naviguer dans le portail de gouvernance Microsoft Purview, créer une collection et accorder l’accès au portail de gouvernance Microsoft Purview.