Schnellstart: Erstellen eines Microsoft Purview-Kontos (früher Azure Purview) mit Python

Wichtig

Microsoft Purview Unified Catalog und klassische Microsoft Purview-Datengovernancefunktionen (früher Azure Purview) werden eingestellt. Microsoft konsolidiert seine Data Governance-Funktionen in Microsoft Fabric. Sie können keine neuen Konten mehr erstellen, und vorhandene Funktionen bleiben bis zum 12. November 2027 im Wartungsmodus. Zeitpläne für die Deaktivierung, Umstellungsleitfäden und empfohlene nächste Schritte finden Sie in der Ankündigung der Einstellung der Datengovernance von Microsoft Purview.

Hinweis

Microsoft Purview Data Catalog (klassisch), Data Health Insights (klassisch) und Purview-Workflow (klassisch) nehmen keine neuen Kunden mehr an, und diese Dienste, zuvor Azure Purview, befinden sich jetzt im Kundensupportmodus.

Wichtig

Sie können nur ein Microsoft Purview-Konto pro Mandant erstellen. Wenn Ihre organization bereits über ein Microsoft Purview-Konto verfügt, können Sie kein neues Microsoft Purview-Konto erstellen, es sei denn, Ihre organization verfügte bereits über mehrere Konten und befindet sich noch unter dem bereits vorhandenen Kontingent. Weitere Informationen finden Sie in den FAQ.

In dieser Schnellstartanleitung erstellen Sie programmgesteuert ein Microsoft Purview-Konto (früher Azure Purview) mithilfe von Python. Die Python-Referenz für Microsoft Purview ist verfügbar, aber dieser Artikel führt Sie durch alle Schritte, die zum Erstellen eines Kontos bei Python erforderlich sind.

Das Microsoft Purview-Governanceportal zeigt Tools wie Microsoft Purview Data Map und Microsoft Purview Data Catalog, mit denen Sie Ihre Datenlandschaft verwalten und steuern können. Durch die Verbindung mit Daten aus Ihren lokalen, Multi-Cloud- und SaaS-Quellen (Software-as-a-Service) erstellt die Microsoft Purview Data Map eine aktuelle Karte Ihrer Informationen. Es identifiziert und klassifiziert vertrauliche Daten und bietet eine End-to-End-Herkunft. Datenconsumer können Daten in Ihrer gesamten Organization ermitteln, und Datenadministratoren können Ihre Daten überwachen, sichern und die richtige Verwendung sicherstellen.

Weitere Informationen zu den klassischen Governancefunktionen von Microsoft Purview finden Sie auf der Übersichtsseite zu Governancelösungen.

Voraussetzungen

  • Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Abonnement, bevor Sie beginnen.

  • Ein Microsoft Entra-Mandant, der Ihrem Abonnement zugeordnet ist.

  • Das Benutzerkonto, das Sie für die Anmeldung bei Azure verwenden, muss ein Mitglied der Rolle "Mitwirkender" oder "Besitzer" oder ein Administrator des Azure-Abonnements sein. Führen Sie die folgenden Schritte aus, um die Berechtigungen anzuzeigen, die Sie im Abonnement haben:

    1. Wechseln Sie zum Azure-Portal
    2. Wählen Sie Ihren Benutzernamen in der oberen rechten Ecke aus.
    3. Wählen Sie die Schaltfläche mit den Auslassungspunkten ("...") aus, um weitere Optionen anzuzeigen.
    4. Wählen Sie dann "Meine Berechtigungen" aus.
    5. Wenn Sie Zugriff auf mehrere Abonnements haben, wählen Sie das entsprechende Abonnement aus.

Bei Azure anmelden

Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.

Installieren des Python-Pakets

  1. Öffnen Sie ein Terminal oder eine Eingabeaufforderung mit Administratorrechten.

  2. Installieren Sie zunächst das Python-Paket für Azure-Verwaltungsressourcen:

    pip install azure-mgmt-resource

  3. Führen Sie den folgenden Befehl aus, um das Python-Paket für Microsoft Purview zu installieren:

    pip install azure-mgmt-purview

    Das Python SDK für Microsoft Purview unterstützt Python 2.7, 3.3, 3.4, 3.5, 3.6 und 3.7.

  4. Führen Sie den folgenden Befehl aus, um das Python-Paket für die Azure Identity-Authentifizierung zu installieren:

    pip install azure-identity

    Hinweis

    Das Paket "azure-identity" kann in Konflikten mit "azure-cli" bei einigen allgemeinen Abhängigkeiten stehen. Wenn ein Authentifizierungsproblem auftritt, entfernen Sie "azure-cli" und seine Abhängigkeiten, oder verwenden Sie einen sauberen Computer, ohne das Paket "azure-cli" zu installieren.

Purview-Client erstellen

  1. Erstellen Sie eine Datei mit dem Namen purview.py. Fügen Sie die folgenden Anweisungen hinzu, um Verweise auf Namespaces hinzuzufügen.

    from azure.identity import ClientSecretCredential 
 from azure.mgmt.resource import ResourceManagementClient
 from azure.mgmt.purview import PurviewManagementClient
 from azure.mgmt.purview.models import *
 from datetime import datetime, timedelta
 import time

  2. Fügen Sie der Main-Methode, die eine Instance der PurviewManagementClient-Klasse erstellt, den folgenden Code hinzu. Sie verwenden dieses Objekt, um ein Purview-Konto zu erstellen, Purview-Konten zu löschen, die Verfügbarkeit von Namen zu überprüfen und andere Vorgänge des Ressourcenanbieters durchzuführen.

    def main():

# Azure subscription ID
subscription_id = '<subscription ID>'

 # This program creates this resource group. If it's an existing resource group, comment out the code that creates the resource group
rg_name = '<resource group>'

# The purview name. It must be globally unique.
purview_name = '<purview account name>'

# Location name, where Microsoft Purview account must be created.
location = '<location name>'    

# Specify your Active Directory client ID, client secret, and tenant ID
credentials = ClientSecretCredential(client_id='<service principal ID>', client_secret='<service principal key>', tenant_id='<tenant ID>') 
# resource_client = ResourceManagementClient(credentials, subscription_id)
purview_client = PurviewManagementClient(credentials, subscription_id)

Erstellen eines Purview-Kontos

  1. Fügen Sie der Main-Methode, die ein Purview-Konto erstellt, den folgenden Code hinzu. Wenn Ihre Ressourcengruppe bereits vorhanden ist, kommentieren Sie die erste create_or_update Anweisung aus.

     # create the resource group
 # comment out if the resource group already exits
 resource_client.resource_groups.create_or_update(rg_name, rg_params)

 #Create a purview
 identity = Identity(type= "SystemAssigned")
 sku = AccountSku(name= 'Standard', capacity= 4)
 purview_resource = Account(identity=identity,sku=sku,location =location )

 try:
     pa = (purview_client.accounts.begin_create_or_update(rg_name, purview_name, purview_resource)).result()
     print("location:", pa.location, " Microsoft Purview Account Name: ", pa.name, " Id: " , pa.id ," tags: " , pa.tags)  
 except:
     print("Error")
     print_item(pa)

 while (getattr(pa,'provisioning_state')) != "Succeeded" :
     pa = (purview_client.accounts.get(rg_name, purview_name))  
     print(getattr(pa,'provisioning_state'))
     if getattr(pa,'provisioning_state') == "Failed" :
         print("Error in creating Microsoft Purview account")
         break
     time.sleep(30)

  2. Fügen Sie nun die folgende Anweisung hinzu, um die main-Methode aufzurufen, wenn das Programm ausgeführt wird:

    # Start the main method
main()

Vollständiges Skript

Hier ist der vollständige Python-Code:

	
from azure.identity import ClientSecretCredential 
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.purview import PurviewManagementClient
from azure.mgmt.purview.models import *
from datetime import datetime, timedelta
import time

def main():

    # Azure subscription ID
    subscription_id = '<subscription ID>'
	
    # This program creates this resource group. If it's an existing resource group, comment out the code that creates the resource group
    rg_name = '<resource group>'

    # The purview name. It must be globally unique.
    purview_name = '<purview account name>'

    # Location for your resource group and your Microsoft Purview account.
    location ="<location>" 

    # Specify your Active Directory client ID, client secret, and tenant ID
    credentials = ClientSecretCredential(client_id='<service principal ID>', client_secret='<service principal key>', tenant_id='<tenant ID>') 
    resource_client = ResourceManagementClient(credentials, subscription_id)
    purview_client = PurviewManagementClient(credentials, subscription_id)
	
    # create the resource group
    # comment out if the resource group already exits
    resource_client.resource_groups.create_or_update(rg_name, {"location": location})

    #Create a purview
    identity = Identity(type= "SystemAssigned")
    sku = AccountSku(name= 'Standard', capacity= 4)
    purview_resource = Account(identity=identity,sku=sku,location =location)
       
    try:
        pa = (purview_client.accounts.begin_create_or_update(rg_name, purview_name, purview_resource)).result()
        print("location:", pa.location, " Microsoft Purview Account Name: ", purview_name, " Id: " , pa.id ," tags: " , pa.tags) 
    except:
        print("Error in submitting job to create account")
        print_item(pa)
 
    while (getattr(pa,'provisioning_state')) != "Succeeded" :
        pa = (purview_client.accounts.get(rg_name, purview_name))  
        print(getattr(pa,'provisioning_state'))
        if getattr(pa,'provisioning_state') == "Failed" :
            print("Error in creating Microsoft Purview account")
            break
        time.sleep(30)    

# Start the main method
main()

Führen Sie den Code aus,

Erstellen Sie die Anwendung, und starten Sie sie. Die Konsole druckt den Fortschritt der Erstellung des Microsoft Purview-Kontos. Warten Sie, bis der Vorgang abgeschlossen ist. Dies ist das Beispiel für die Ausgabe:

location: southcentralus  Microsoft Purview Account Name:  purviewpython7  Id:  /subscriptions/8c2c7b23-848d-40fe-b817-690d79ad9dfd/resourceGroups/Demo_Catalog/providers/Microsoft.Purview/accounts/purviewpython7  tags:  None
Creating
Creating
Succeeded

Überprüfen der Ausgabe

Wechseln Sie im Azure-Portal zur Seite "Microsoft Purview-Konten", und überprüfen Sie das Konto, das mit dem obigen Code erstellt wurde.

Löschen eines Microsoft Purview-Kontos

Um das Purview-Konto zu löschen, fügen Sie dem Programm den folgenden Code hinzu, und führen Sie ihn dann aus:

pa = purview_client.accounts.begin_delete(rg_name, purview_name).result()

Nächste Schritte

In dieser Schnellstartanleitung haben Sie erfahren, wie Sie ein Microsoft Purview-Konto (früher Azure Purview) erstellen, das Konto löschen und die Verfügbarkeit des Namens überprüfen. Sie können jetzt das Python SDK herunterladen und sich über andere Ressourcenanbieteraktionen informieren, die Sie für ein Microsoft Purview-Konto ausführen können.

In den nächsten Artikeln erfahren Sie, wie Sie im Microsoft Purview-Governanceportal navigieren, eine Sammlung erstellen und Zugriff auf das Microsoft Purview-Governanceportal gewähren.

  • Zuletzt aktualisiert um