Accessing trusted master data (IBM Master Data Connect)
Use the IBM® Master Data Connect service to power your business applications with trusted master data. Provide geographically distributed users and systems with fast, scalable, and concurrent access to your organization's most trusted data source.
This service is not available by default. An administrator must install this service on the IBM Cloud Pak for Data platform.
Prerequisite: Loading master data into Master Data Connect
Manager or Writer users in your organization can populate Master Data Connect with record data from your IBM InfoSphere® Master Data Management Advanced Edition or Standard Edition instance by using the IBM® MDM Publisher capability of the IBM InfoSphere Master Data Management (IBM InfoSphere MDM) offering.
Using MDM Publisher, Manager or Writer users can configure Master Data Connect on Cloud Pak for Data as a publishing endpoint, and then set up data subscriptions. MDM Publisher enables you to set up subscriptions with different data scopes for different Master Data Connect instances. This strategy provides the flexibility to target and refine your master data catalog for different applications.
For information about installing, configuring, and using MDM Publisher, see Loading data into an operational cache using IBM MDM Publisher in the IBM InfoSphere MDM Knowledge Center collection.
After your organization has loaded data into the master data catalog, Reader users or systems can use the API to run text searches and queries to quickly access the master data they need. Developers can use the API to enable your organization's business applications to access the master data catalog.
Accessing the Master Data Connect service and APIs
- Log into the Cloud Pak for Data web client, then go to the My Instances page.
- Find your service instance and click the ellipsis menu. Click View details to see information about your instance.
- Obtain an access token (authentication bearer token):
- From the View Details screen, locate the Access Information section.
- Optionally, click the refresh icon to generate a new access token.
- Click the copy icon to copy the token into your clipboard.
- Return to the My Instances page and click the ellipsis menu of your instance. Click Open to launch the Master Data Connect API in Swagger UI. The Swagger UI API Explorer enables you to visualize and interact with the API’s resources and run API commands.
- In the Swagger UI, click Authorize.
- Paste the access token into the field at the bottom of the page, then click Authorize and Close.
- Use the Swagger UI API Explorer to discover and run API commands.
Searching in your master data catalog
After a Manager or Writer user has loaded data into your master data catalog, Reader users can use the Master Data Connect API to search for records in the master data catalog. Developers can also enable your business applications as Readers to access and search for master data using the API.
- Run a full text or property query search:
- List all master data records:
- Get a single master data record by providing the record ID:
- List all relationships for a given master data record by providing the record ID:
- Run a query on the graph database:
POST /mdm/cache/v0/traverseNote: For information about running traversal queries on the Master Data Connect graph database, see Querying Master Data Connect using Gremlin in the IBM InfoSphere Master Data Management Knowledge Center collection.
- From the Cloud Pak for Data web client, click My instances. Click the ellipsis menu of your instance, then click Open.
- In a browser, navigate directly to
For information about installing Master Data Connect, see Installing Master Data Connect.
For information about administering Master Data Connect, see Administering Master Data Connect.
For more information about IBM InfoSphere MDM, see the IBM InfoSphere Master Data Management V11.6 documentation.
For more information about the MDM Publisher capability, see Publishing master data using IBM MDM Publisher in the IBM InfoSphere MDM V11.6 documentation.