Erstellen Sie benutzerdefinierte Asset-Typen

In Amazon DataZone stellen Assets bestimmte Arten von Datenressourcen wie Datenbanktabellen, Dashboards oder Modelle für maschinelles Lernen dar. Um Konsistenz und Standardisierung bei der Beschreibung von Katalog-Assets zu gewährleisten, muss eine DataZone Amazon-Domain über eine Reihe von Asset-Typen verfügen, die definieren, wie Assets im Katalog dargestellt werden. Ein Asset-Typ definiert das Schema für einen bestimmten Asset-Typ. Ein Asset-Typ hat eine Reihe erforderlicher und optionaler benennbarer Metadaten-Formulartypen (z. B. GovForm oder). GovernanceFormType Die Asset-Typen in Amazon DataZone sind versioniert. Wenn Assets erstellt werden, werden sie anhand des Schemas validiert, das durch ihren Asset-Typ (in der Regel die neueste Version) definiert ist. Wenn eine ungültige Struktur angegeben wird, schlägt die Asset-Erstellung fehl.

System-Asset-Typen — DataZone Amazon stellt serviceeigene System-Asset-Typen (einschließlich GlueTableAssetType GlueViewAssetType RedshiftTableAssetType, RedshiftViewAssetType,, und S3ObjectCollectionAssetType) und Systemformtypen (einschließlich DataSourceReferenceFormType AssetCommonDetailsFormType, und SubscriptionTermsFormType) bereit. System-Asset-Typen können nicht bearbeitet werden.

Benutzerdefinierte Asset-Typen — Um benutzerdefinierte Asset-Typen zu erstellen, erstellen Sie zunächst die erforderlichen Metadaten-Formulartypen und Glossare, die in den Formulartypen verwendet werden sollen. Anschließend können Sie benutzerdefinierte Asset-Typen erstellen, indem Sie den Namen, die Beschreibung und die zugehörigen Metadatenformulare angeben, die erforderlich oder optional sein können.

Bei Assettypen mit strukturierten Daten können Sie zur Darstellung des Spaltenschemas im Datenportal die verwenden, RelationalTableFormType um Ihren Spalten die technischen Metadaten hinzuzufügen (einschließlich Spaltennamen, Beschreibungen und Datentypen) und die, ColumnBusinessMetadataForm um die Unternehmensbeschreibungen der Spalten hinzuzufügen, einschließlich Unternehmensnamen, Glossarbegriffen und benutzerdefinierten Schlüsselwertpaaren.

Gehen Sie wie folgt vor, um über das Datenportal einen benutzerdefinierten Asset-Typ zu erstellen:

1. Navigieren Sie zur URL des DataZone Amazon-Datenportals und melden Sie sich mit Single Sign-On (SSO) oder Ihren AWS Anmeldeinformationen an. Wenn Sie ein DataZone Amazon-Administrator sind, können Sie unter https://console.aws.amazon.com/datazone zur DataZone Amazon-Konsole navigieren und sich dort anmelden, AWS-Konto wo die Domain erstellt wurde, und dann Datenportal öffnen wählen.

2. Wählen Sie im oberen Navigationsbereich die Option Projekt auswählen und wählen Sie das Projekt aus, für das Sie einen benutzerdefinierten Asset-Typ erstellen möchten.

3. Navigieren Sie zur Registerkarte Daten für das Projekt.

4. Wählen Sie im linken Navigationsbereich die Option Asset-Typen und anschließend Asset-Typ erstellen aus.

5. Geben Sie Folgendes an und wählen Sie dann „Erstellen“.

   • Name — der Name des benutzerdefinierten Asset-Typs

   • Beschreibung — die Beschreibung des benutzerdefinierten Asset-Typs.

   • Wählen Sie Metadatenformulare hinzufügen, um diesem benutzerdefinierten Asset-Typ Metadatenformulare hinzuzufügen.

6. Sobald der benutzerdefinierte Asset-Typ erstellt wurde, können Sie ihn zum Erstellen von Assets verwenden.

Gehen Sie wie folgt vor, um über die APIs einen benutzerdefinierten Asset-Typ zu erstellen:

1. Erstellen Sie einen Metadaten-Formulartyp, indem Sie die CreateFormType API-Aktion aufrufen.

   Das Folgende ist ein SageMaker Amazon-Beispiel:

   
   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. Als Nächstes können Sie einen Asset-Typ erstellen, indem Sie die CreateAssetType API-Aktion aufrufen. Sie können Asset-Typen nur über DataZone Amazon-APIs erstellen, indem Sie die verfügbaren Systemformulartypen (SubscriptionTermsFormTypeim folgenden Beispiel) oder Ihre benutzerdefinierten Formulartypen verwenden. Bei Systemformulartypen muss der Typname mit beginnenamazon.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,
           },
       },
   )
   
                   

   Im Folgenden finden Sie ein Beispiel für die Erstellung eines Asset-Typs für strukturierte Daten:

   
   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. Und jetzt können Sie mithilfe der benutzerdefinierten Asset-Typen, die Sie in den obigen Schritten erstellt haben, ein Asset erstellen.

   
   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}"
           }
           ]
   )
                   

   Und in diesem Beispiel erstellen Sie ein strukturiertes Daten-Asset:

   
   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": ".."
           },
           .....
           ]
   )