在 Amazon 中建立自訂資產類型 DataZone - Amazon DataZone

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Amazon 中建立自訂資產類型 DataZone

在 Amazon 中 DataZone，資產代表特定類型的資料資源，例如資料庫資料表、儀表板或機器學習模型。若要在描述目錄資產時提供一致性和標準化，Amazon DataZone 網域必須具有一組資產類型，以定義在目錄中呈現資產的方式。資產類型定義特定類型資產的結構描述。資產類型具有一組必要和選用的可命名中繼資料表單類型 （例如 govForm 或 GovernanceFormType）。Amazon 中的資產類型 DataZone 是版本化的。建立資產時，會根據其資產類型 （通常是最新版本） 定義的結構描述進行驗證，如果指定無效的結構，則資產建立會失敗。

系統資產類型 - Amazon DataZone 佈建服務擁有的系統資產類型 （包括 GlueTableAssetType、 RedshiftTableAssetType RedshiftViewAssetType、 GlueViewAssetType和 S3ObjectCollectionAssetType） 和系統表單類型 （包括 DataSourceReferenceFormType AssetCommonDetailsFormType、 和 SubscriptionTermsFormType）。無法編輯系統資產類型。

自訂資產類型 - 若要建立自訂資產類型，請先建立所需的中繼資料表單類型和詞彙表，以用於表單類型。然後，您可以指定名稱、描述和相關聯的中繼資料表單，以建立自訂資產類型，這些類型可以是必要或選用。

對於具有結構化資料的資產類型，若要代表資料入口網站中的資料欄結構描述，您可以使用 RelationalTableFormType將技術中繼資料新增至資料欄，包括資料欄名稱、描述和資料類型），以及使用 ColumnBusinessMetadataForm來新增資料欄的業務描述，包括商業名稱、詞彙和自訂索引鍵值對。

若要透過資料入口網站建立自訂資產類型，請完成下列步驟：

  1. 導覽至 Amazon DataZone 資料入口網站URL，並使用單一登入 （SSO） 或您的 AWS 憑證登入。如果您是 Amazon DataZone 管理員，您可以導覽至位於 https://console.aws.amazon.com/datazone 的 Amazon DataZone 主控台，並使用建立網域 AWS 帳戶 的 登入，然後選擇開啟資料入口網站 。

  2. 從頂端導覽窗格中選擇選取專案，然後選擇您要建立自訂資產類型的專案。

  3. 導覽至專案的資料索引標籤。

  4. 從左側導覽窗格中選擇資產類型，然後選擇建立資產類型 。

  5. 指定以下內容，然後選擇建立 。

    • 名稱 - 自訂資產類型的名稱

    • Description - 自訂資產類型的描述。

    • 選擇新增中繼資料表單，將中繼資料表單新增至此自訂資產類型。

  6. 建立自訂資產類型後，您可以使用它來建立資產。

若要透過 建立自訂資產類型APIs，請完成下列步驟：

  1. 叫用 CreateFormTypeAPI動作來建立中繼資料表單類型。

    以下是 Amazon SageMaker 範例：

    
m_model = "

structure SageMakerModelFormType {
   @required
   @amazon.datazone#searchable
   modelName: String

   @required
   modelArn: String

   @required
   creationTime: String
}
"

CreateFormType(
    domainIdentifier="my-dz-domain",
    owningProjectIdentifier="d4bywm0cja1dbb",
    name="SageMakerModelFormType",
    model=m_model
    status="ENABLED"
    )

  2. 接下來，您可以透過叫用 CreateAssetTypeAPI動作來建立資產類型。您只能使用可用的系統表單類型 （SubscriptionTermsFormType 在以下範例中） 或自訂表單類型透過 Amazon DataZone APIs 建立資產類型。對於系統表單類型，類型名稱必須以 開頭amazon.datazone。

    
CreateAssetType(
    domainIdentifier="my-dz-domain",
    owningProjectIdentifier="d4bywm0cja1dbb",
    name="SageMakerModelAssetType",
    formsInput={
        "ModelMetadata": {
            "typeIdentifier": "SageMakerModelMetadataFormType",
            "typeRevision": 7,
            "required": True,
        },
        "SubscriptionTerms": {
            "typeIdentifier": "amazon.datazone.SubscriptionTermsFormType",
            "typeRevision": 1,
            "required": False,
        },
    },
)

    以下是為結構化資料建立資產類型的範例：

    
CreateAssetType(
    domainIdentifier="my-dz-domain",
    owningProjectIdentifier="d4bywm0cja1dbb",
    name="OnPremMySQLAssetType",
    formsInput={
        "OnpremMySQLForm": {
            "typeIdentifier": "OnpremMySQLFormType",
            "typeRevision": 5,
            "required": True,
        },
        "RelationalTableForm": {
            "typeIdentifier": "RelationalTableFormType",
            "typeRevision": 1,
            "required": True,
        },
        "ColumnBusinessMetadataForm": {
            "typeIdentifier": "ColumnBusinessMetadataForm",
            "typeRevision": 1,
            "required": False,
        },
        "SubscriptionTerms": {
            "typeIdentifier": "SubscriptionTermsFormType",
            "typeRevision": 1,
            "required": False,
        },
    },
)

  3. 現在，您可以使用您在上述步驟中建立的自訂資產類型來建立資產。

    
CreateAsset(
   domainIdentifier="my-dz-domain",
   owningProjectIdentifier="d4bywm0cja1dbb",
   owningProjectIdentifier="my-project",
   name="MyModelAsset",
   glossaryTerms="xxx",
   formsInput=[{
        "formName": "SageMakerModelForm",
        "typeIdentifier": "SageMakerModelForm",
        "typeRevision": "5",
        "content": "{\n \"ModelName\" : \"sample-ModelName\",\n \"ModelArn\" : \"999999911111\"\n}"
        }
        ]
)

    在此範例中，您正在建立結構化資料資產：

    
CreateAsset(
   domainIdentifier="my-dz-domain",
   owningProjectIdentifier="d4bywm0cja1dbb",
   name="MyModelAsset",
   glossaryTerms="xxx",
   formsInput=[{
        "formName": "RelationalTableForm",
        "typeIdentifier": "amazon.datazone.RelationalTableForm",
        "typeRevision": "1",
        "content": ".."
        },
        {
        "formName": "mySQLTableForm",
        "typeIdentifier": "mySQLTableForm",
        "typeRevision": "6",
        "content": ".."
        },
        {
        "formName": "mySQLTableForm",
        "typeIdentifier": "mySQLTableForm",
        "typeRevision": "1",
        "content": ".."
        },
        .....
        ]
)