Crea tipos de activos personalizados en Amazon DataZone

En Amazon DataZone, los activos representan tipos específicos de recursos de datos, como tablas de bases de datos, paneles o modelos de aprendizaje automático. Para proporcionar coherencia y estandarización a la hora de describir los activos del catálogo, un DataZone dominio de Amazon debe tener un conjunto de tipos de activos que definan cómo se representan los activos en el catálogo. Un tipo de activo define el esquema de un tipo específico de activo. Un tipo de activo tiene un conjunto de tipos de formularios de metadatos obligatorios y opcionales con nombre (por ejemplo, govForm o GovernanceFormType). Los tipos de activos en Amazon DataZone están versionados. Cuando se crean los activos, se validan según el esquema definido por su tipo de activo (normalmente, la última versión) y, si se especifica una estructura no válida, se produce un error en la creación del activo.

Tipos de activos del sistema: DataZone Amazon suministra tipos de activos del sistema propiedad del servicio (incluidos GlueTableAssetType GlueViewAssetType, RedshiftTableAssetType RedshiftViewAssetType, y S3ObjectCollectionAssetType) y tipos de formularios del sistema (incluidos DataSourceReferenceFormType AssetCommonDetailsFormType, y SubscriptionTermsFormType). Los tipos de activos del sistema no se pueden editar.

Tipos de activos personalizados: para crear tipos de activos personalizados, comience por crear los tipos de formulario de metadatos y los glosarios necesarios para usarlos en los tipos de formulario. A continuación, puede crear tipos de activos personalizados especificando el nombre, la descripción y los formularios de metadatos asociados, que pueden ser obligatorios u opcionales.

En el caso de los tipos de activos con datos estructurados, para representar el esquema de columnas en el portal de datos, puede utilizarlos RelationalTableFormType para añadir los metadatos técnicos a las columnas (incluidos los nombres de las columnas, las descripciones y los tipos de datos) y ColumnBusinessMetadataForm para añadir las descripciones comerciales de las columnas, incluidos los nombres comerciales, los términos del glosario y los pares de valores clave personalizados.

Para crear un tipo de activo personalizado a través del portal de datos, siga estos pasos:

1. Navegue hasta el portal de DataZone datos de Amazon URL e inicie sesión con el inicio de sesión único (SSO) o sus AWS credenciales. Si eres DataZone administrador de Amazon, puedes ir a la DataZone consola de Amazon en https://console.aws.amazon.com/datazone e iniciar sesión con el Cuenta de AWS lugar donde se creó el dominio y, a continuación, elegir Open data portal.

2. Selecciona Seleccionar proyecto en el panel de navegación superior y selecciona el proyecto en el que quieres crear un tipo de activo personalizado.

3. Navegue hasta la pestaña Datos del proyecto.

4. Selecciona Tipos de activos en el panel de navegación izquierdo y, a continuación, selecciona Crear tipo de activo.

5. Especifique lo siguiente y, a continuación, elija Crear.

   • Nombre: el nombre del tipo de activo personalizado

   • Descripción: descripción del tipo de activo personalizado.

   • Elija Agregar formularios de metadatos para agregar formularios de metadatos a este tipo de activo personalizado.

6. Una vez creado el tipo de activo personalizado, puede usarlo para crear activos.

Para crear un tipo de activo personalizado mediante elAPIs, complete los siguientes pasos:

1. Cree un tipo de formulario de metadatos invocando la CreateFormType API acción.

   El siguiente es un SageMaker ejemplo de Amazon:

   
   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. A continuación, puede crear un tipo de activo invocando la CreateAssetType API acción. Solo puedes crear tipos de activos a través de Amazon DataZone APIs utilizando los tipos de formulario del sistema disponibles (SubscriptionTermsFormTypeen el siguiente ejemplo) o tus tipos de formulario personalizados. En el caso de los tipos de formulario del sistema, el nombre del tipo debe empezar poramazon.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,
           },
       },
   )
   
                   

   El siguiente es un ejemplo de creación de un tipo de activo para datos estructurados:

   
   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. Y ahora, puede crear un activo con los tipos de activos personalizados que creó en los pasos anteriores.

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

   Y en este ejemplo, está creando un activo de datos estructurados:

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