教學課程：Atlas 2.2 新功能

在本教學課程中，瞭解如何以程序設計方式與 Microsoft Purview 中的數據對應互動的新 Atlas 2.2 API。

必要條件

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

• 您必須擁有現有的 Microsoft Purview 帳戶。 如果您沒有目錄，請參閱 建立 Microsoft Purview 帳戶的快速入門。

• 若要建立持有人令牌並呼叫任何 API，請參閱 有關如何驗證 Microsoft Purview 的 API 的檔。

商務元數據 API

商務元數據是一個範本，其中包含自定義屬性 (索引鍵值) 。 您可以全域建立這些屬性，然後將它們套用到多個 typedef。

Atlas 端點

針對所有要求，您需要 Microsoft Purview 帳戶的 Atlas 端點。

1. 在 Azure 入口網站 中尋找您的 Microsoft Purview 帳戶
2. 選取左側選單上的 [ 屬性 ] 頁面
3. 複製 Atlas 端點 值

使用屬性建立商務元數據

您可以將要求傳送 POST 至下列端點：

POST {{endpoint}}/api/atlas/v2/types/typedefs

提示

applicableEntityTypes 屬性會指出元數據將套用至哪些數據類型。

範例 JSON：

   {
  "businessMetadataDefs": [
    {
      "category": "BUSINESS_METADATA",
      "createdBy": "admin",
      "updatedBy": "admin",
      "version": 1,
      "typeVersion": "1.1",
      "name": "<Name of Business Metadata>",
      "description": "",
      "attributeDefs": [
        {
          "name": "<Attribute Name>",
          "typeName": "string",
          "isOptional": true,
          "cardinality": "SINGLE",
          "isUnique": false,
          "isIndexable": true,
          "options": {
            "maxStrLength": "50",
            "applicableEntityTypes": "[\"Referenceable\"]"
          }          
        }
      ]
    }
  ]
}

將屬性加入或更新至現有的商務元數據

您可以將要求傳送 PUT 至下列端點：

PUT {{endpoint}}/api/atlas/v2/types/typedefs

範例 JSON：

   {
  "businessMetadataDefs": [
    {
      "category": "BUSINESS_METADATA",
      "createdBy": "admin",
      "updatedBy": "admin",
      "version": 1,
      "typeVersion": "1.1",
      "name": "<Name of Business Metadata>",
      "description": "",
      "attributeDefs": [
        {
          "name": "<Attribute Name>",
          "typeName": "string",
          "isOptional": true,
          "cardinality": "SINGLE",
          "isUnique": false,
          "isIndexable": true,
          "options": {
            "maxStrLength": "500",
            "applicableEntityTypes": "[\"Referenceable\"]"
          }          
        },
        {
          "name": "<Attribute Name 2>",
          "typeName": "int",
          "isOptional": true,
          "cardinality": "SINGLE",
          "isUnique": false,
          "isIndexable": true,
          "options": {
            "applicableEntityTypes": "[\"Referenceable\"]"
          }          
        }
      ]
    }
  ]
}

取得商務元數據定義

您可以將要求傳送 GET 至下列端點：

GET {endpoint}}/api/atlas/v2/types/typedef/name/{{Business Metadata Name}}

將商務元數據屬性設定為實體

您可以將要求傳送 POST 至下列端點：

POST {{endpoint}}/api/atlas/v2/entity/guid/{{GUID}}/businessmetadata?isOverwrite=true

範例 JSON：

{
  "myBizMetaData1": {
        "bizAttr1": "I am myBizMetaData1.bizAttr1",
        "bizAttr2": 123,
  }
 }

從實體刪除商務元數據屬性

您可以將要求傳送 DELETE 至下列端點：

'DELETE' {{endpoint}}/api/atlas/v2/entity/guid/{{GUID}}/businessmetadata?isOverwrite=true

範例 JSON：

{
  "myBizMetaData1": {
    "bizAttr1": ""    
  }
}

刪除商務元數據類型定義

注意事項

如果商務元數據類型定義沒有參考，也就是如果尚未指派給目錄中的任何資產，您才能刪除它。

您可以將要求傳送 DELETE 至下列端點：

DELETE {{endpoint}}/api/atlas/v2/types/typedef/name/{{Business Metadata Name}}

自訂屬性 API

自定義屬性是可直接新增至 Atlas 實體的索引鍵/值組。

將自訂屬性設定為實體

您可以將要求傳送 POST 至下列端點：

POST {{endpoint}}/api/atlas/v2/entity

範例 JSON：

{
    "entity": {
        "typeName": "azure_datalake_gen2_path",
        "attributes": {
           
            "qualifiedName": "<FQN of the asset>",
            "name": "data6.csv"
        },
        "guid": "3ffb28ff-138f-419e-84ba-348b0165e9e0",
        "customAttributes": {
            "custAttr1": "attr1",
            "custAttr2": "attr2"
        }
    }
}

標籤 API

標籤是可用的文字標記，可以套用至任何 Atlas 實體。

將標籤設定為實體

您可以將要求傳送 POST 至下列端點：

POST {{endpoint}}/api/atlas/v2/entity/guid/{{GUID}}/labels

範例 JSON：

[
  "label1",
  "label2"
]

刪除實體的標籤

您可以將要求傳送 DELETE 至下列端點：

DELETE {{endpoint}}/api/atlas/v2/entity/guid/{{GUID}}/labels

範例 JSON：

[
  "label2"
]

後續步驟

管理Purview 數據平面 REST API Microsoft數據源