快速入門：使用 Python 建立Microsoft Purview (先前稱為 Azure Purview) 帳戶

在本快速入門中，您將使用 Python 以程式設計方式建立Microsoft Purview (先前稱為 Azure Purview) 帳戶。 Microsoft Purview 的 Python 參考 可供使用，但本文將引導您完成使用 Python 建立帳戶所需的所有步驟。

Microsoft Purview 治理入口網站會呈現 Microsoft Purview 資料對應 和 Microsoft Purview 資料目錄 等工具，協助您管理和控管您的數據環境。 透過連線到內部部署、多雲端和軟體即服務 (SaaS) 來源的數據，Microsoft Purview 資料對應 會建立資訊的最新對應。 它會識別並分類敏感數據，並提供端對端的Linage。 數據取用者能夠探索整個組織的數據，而且數據管理員能夠稽核、保護及確保正確使用您的數據。

如需 Microsoft Purview 傳統治理功能的詳細資訊，請 參閱我們的治理解決方案概觀頁面。

必要條件

• 如果您沒有 Azure 訂用帳戶，請在開始前建立 免費訂用帳戶 。

• 與您的訂用帳戶相關聯的 Microsoft Entra 租使用者。

• 您用來登入 Azure 的使用者帳戶必須是 參與者 或 擁有者 角色的成員，或是 Azure 訂用帳戶的 系統管理員 。 若要檢視您在訂用帳戶中擁有的許可權，請遵循下列步驟：

  1. 移至 Azure 入口網站
  2. 選取右上角的用戶名稱。
  3. 選取省略號按鈕 (“...”) 取得更多選項。
  4. 然後選取 [我的許可權]。
  5. 如果您有多個訂用帳戶的存取權，請選取適當的訂用帳戶。

登入 Azure

使用您的 Azure 帳戶登入 Azure 入口網站。

安裝 Python 套件

1. 以系統管理員許可權開啟終端機或命令提示字元。

2. 首先，安裝適用於 Azure 管理資源的 Python 套件：

   pip install azure-mgmt-resource
   

3. 若要安裝適用於 Microsoft Purview 的 Python 套件，請執行下列命令：

   pip install azure-mgmt-purview
   

   適用於 Microsoft Purview 的 Python SDK 支援 Python 2.7、3.3、3.4、3.5、3.6 和 3.7。

4. 若要安裝適用於 Azure 身分識別驗證的 Python 套件，請執行下列命令：

   pip install azure-identity
   

   注意事項

   “azure-identity” 套件在某些常見的相依性上可能會與 “azure-cli” 發生衝突。 如果您遇到任何驗證問題，請移除 「azure-cli」 及其相依性，或使用乾淨的機器而不安裝 「azure-cli」 套件。

建立 purview 用戶端

1. 建立名為 purview.py 的檔案。 新增下列語句以新增命名空間的參考。

   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. 將下列程式代碼新增至 Main 方法，以建立 PurviewManagementClient 類別的實例。 您將使用此物件來建立 purview 帳戶、刪除 purview 帳戶、檢查名稱可用性，以及其他資源提供者作業。

   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)
   

建立 purview 帳戶

1. 將下列程式代碼新增至 Main 方法，以建立 purview 帳戶。 如果您的資源群組已經存在，請將第一個 create_or_update 語句批注化。

    # 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. 現在，新增下列 語句，以在程序執行時叫用 main 方法：

   # Start the main method
   main()
   

完整腳本

以下是完整的 Python 程式代碼：

	
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()

執行程序代碼

建置並啟動應用程式。 控制台會列印 Purview 帳戶建立Microsoft進度。 等候完成。 以下是範例輸出：

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

確認輸出

移至 Azure 入口網站 中的 [Microsoft Purview 帳戶] 頁面，並確認使用上述程式代碼建立的帳戶。

刪除 Microsoft 帳戶

若要刪除 purview 帳戶，請將下列程式代碼新增至程式，然後執行：

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

後續步驟

在本快速入門中，您已瞭解如何建立Microsoft Purview (先前稱為 Azure Purview) 帳戶、刪除帳戶，以及檢查名稱可用性。 您現在可以下載 Python SDK，並瞭解您可以針對 Microsoft Purview 帳戶執行的其他資源提供者動作。

請遵循下列文章，瞭解如何流覽 Microsoft Purview 治理入口網站、建立集合，以及授與 Microsoft Purview 治理入口網站的存取權。

• 如何使用 Microsoft Purview 治理入口網站
• 將治理入口網站的許可權授與使用者
• 建立集合