Publish Models to the SAS Metadata Repository :: SAS(R) Model Manager 12.3: User's Guide

About Publishing Models to the SAS Metadata Repository

SAS Model Manager publishes a model by creating a MiningResults object in the SAS Metadata Repository. You can use the model information in the MiningResults object to set up a scoring environment. A scoring application can use SAS Data Integration Studio or SAS Enterprise Guide to access the metadata and run a batch job or stored process that executes the score code. SAS Real-Time Decision Manager can also read the metadata and use it in that process environment. Therefore, when you publish a project champion model, challenger model, or other models (with proper configuration), the scoring application always uses the most current champion model. Only the project champion model can be published from the project level and from the project control group level.

Note: SAS Model Manager cannot publish R models.

SAS Model Manager uses the SAS Folders view to publish the model to any folder that is accessible to the user. These folders include all folders in the SAS Foundation repository and folders in custom repositories that are created in SAS Management Console to reflect the structure of your business organization.

These are the tasks that you perform to publish models:

Publish a Model
Publish a Project Champion Model
Verify the Model Publish

Publish a Model

To publish a model:

Right-click the model that you want to publish and select Publish Model. The SAS Metadata Repository window appears. SAS Model Manager displays metadata folders.
Select the folder to store the model. You must have Write permission to this folder.

Note: If you created your own subfolders, then select a folder to store the metadata for the published model.
Enter the name for the model and click Save. If a MiningResults object is in the repository that has the same name as the object, then you are asked whether to overwrite the metadata for this stored object. In addition, if a MiningResults object is in the repository that has the same model UUID, you are asked whether you want to continue with publishing the model.

Note: Do not overwrite an existing MiningResults object unless you are certain that the model is from the same project in SAS Model Manager.

Note: If the score code for the model changes, then publish the model again to ensure that your score application uses the current scoring code. If you change the status of model that has been published, then it is recommended that you publish the model again. For example, flag or clear a model as a challenger, or set or clear a model as champion.

Publish a Project Champion Model

To publish the champion model for a project, you must have already set a model as the champion. When a champion model is selected, the version that contains the model is automatically set as the default version for the project. SAS Model Manager examines the project and always publishes the project champion model. When the champion model for a project changes and you publish the model again to the same location, the scoring application automatically uses the latest score code.

Note: SAS Model Manager cannot publish R models.

To publish the champion model for a project:

Verify that the project that you want to publish has a champion model assigned. Select the project folder to examine its properties. The Default Version property contains the name of the version that contains the champion model.
Right-click the project name and select Publish Modelsto the SAS Metadata Repository. If the project is not locked, you are prompted to confirm publishing the champion model. The SAS Metadata Repository window appears. SAS Model Manager displays the metadata folders.
Select a folder that you want to publish the model to.

Note: A champion model can be published only to a folder and you must have permissions to access the folder on the SAS Metadata Repository. If a folder is selected when the SAS Metadata Repository window appears, navigate to a list that contains your folder and select the folder.
Click OK. If a MiningResults object is in the SAS Metadata Repository that has the same name or model UUID, then you are asked whether to overwrite the metadata for this stored object.

Note: Do not overwrite an existing MiningResults object unless you are certain that the model is from the same project in SAS Model Manager.

Verify the Model Publish

To verify that SAS Model Manager successfully created the MiningResults object in the SAS Metadata Repository for the published model, use SAS Management Console. To view the contents of the published model, you can use SAS Data Integration Studio. You can also use SAS Management Console to export the MiningResult objects to a SAS package.

Note: You can also view the publish history of models in the MMRoot, project, or version object details view. For more information, see View Publish History.

To view a MiningResult object in the SAS Metadata Repository:

In SAS Management Console, open a SAS Model Manager metadata profile that connects to the SAS Metadata Server.
From the SAS Management Console Folders tab, expand the folder to which you published the model. When you select the folder, the right pane lists the MiningResult objects for the published models.
Right-click the MiningResults object that has the name of published model or project and select Properties from the pop-up menu. The Properties window appears.
Examine the Keywords box on the General tab to verify that the MiningResults object contains the UUID of the published project or model.

Note: You can use the UUID to conduct filtered searches and query the published models. For more information, see Query Folders, Projects, and Versions.
Examine the metadata on the Advanced tab to determine when the MiningResults object was created or most recently updated.
Click OK.