Oracle by Example brandingOracle® Cloud Collaborating in Oracle Machine Learning

section 0Before You Begin

This tutorial shows you how to collaborate and share notebooks with other users in Oracle Machine Learning. This is the third tutorial in the series Working with Oracle Machine Learning. Read the tutorials in sequence.

This tutorial takes approximately 5 minutes to complete.

Background

A notebook is a web-based interface for data analysis, data discovery, data visualization and collaboration.

What Do You Need?

  • Access to your Oracle Machine Learning account
  • Provide workspace permission to users with whom you want to collaborate
  • A notebook created in your OML account

section 1Assign Workspace Permissions

You can collaborate with other users in Oracle Machine Learning by granting permissions to access your workspace. Your workspace contains your projects and notebooks. Oracle Machine Learning allows three types of permissions. By granting different types of permissions such as Manager, Developer, and Viewer, you can allow another user to view your workspace and perform different tasks in your projects and notebooks such as edit, create, update, delete, run, view notebooks and so on.

Caution: If you grant the permission type Manager or Developer, then the user can also drop tables, create tables, and run any scripts at any time on your account. The user with Viewer permission type can only view your notebooks, and is not authorized to run or make any changes to your notebooks.

To grant permission to a user:

  1. On the top right corner of Oracle Machine Learning home page, click the project and workspace drop-down list, and select Workspace Permissions. 
    workspace permission
    Description of the illustration select_workspace_permission.png
  2. In the Permissions dialog box, select a user from the Username drop-down list.
  3. In the Permission Type drop-down list, select the permission type to grant to the selected user.
    workspace permission
    Description of the illustration workspace_permissions.png
    These types of permissions are available:
    • Manager: A user with the permission type Manager may perform the following tasks:
      • Project - Create, update, delete your projects
      • Workspace - View only
      • Notebooks - Create, update, run, delete, and schedule jobs to run your notebooks
    • Developer: A user with the permission type Developer may perform the following tasks:
      • Project: View only
      • Workspace: View only
      • Notebooks: Create, update, run, and delete jobs to run your notebooks
    • Viewer: A user with the permission type Viewer can only view your workspace, projects, and notebooks.
  4. Click Add. Once the user is granted the selected permission type, the username is displayed along with the permission type.
  5. Click OK. This completes the task of granting permission to the user. To delete a user along with the associated permission, select the user and click Delete.

section 2Collaborate Using the Export Option

You can export a notebook as a .json (JavaScript Object Notation) file, and later import it in to the same or a different environment.

  1. In the Notebook page, click the notebook that you want to export. The notebook opens in the Notebook editor.
  2. In the top panel of the notebook editor, click the export icon.
    export
    Description of the illustration export_notebook_option.png
  3. The Save as Dialog box opens. Navigate to the location in your system where you want to save the notebook. The notebook is saved in your local folder as a .json file.

section 3Share a Notebook by Using Oracle Machine Learning Library

You can share a notebook by saving an existing notebook as a template in My Library or in Shared location in Oracle Machine Learning. To save a notebook as a template:

  1. In the Notebooks page, select the notebook that you want to save as template and click Save as Template. The Save as Template dialog box opens.
    save as template
    Description of the illustration save as template.png
  2. In the Name field, enter a name for the notebook template.
  3. In the Comments field, enter comments if any.
  4. In the Tags field, enter tags for the template.
  5. In Save To field, select Personal if you want to save this notebook under Personal templates. Notebooks under Personal are visible only to the owner of the notebook. Select Shared if you want to save and share this notebook. The Shared template is visible to all users of the system within the scope of the tenant.
    Note:     Notebook templates under Examples are provided by Oracle and are visible to all tenants. Users cannot add notebooks to the Examples template.
    templates
    Description of the illustration templates.png

next stepNext Tutorial

Creating SQL Scripts in Oracle Machine Learning