To access your data in Planning Analytics, create a connection asset for it.
Planning Analytics (formerly known as "TM1") is an enterprise performance management database that stores data in in-memory multidimensional OLAP cubes.
Supported versions
IBM Planning Analytics, version 2.0.5 or later
Create a connection to Planning Analytics
To create the connection asset, you need these connection details:
- TM1 server API root URL
- Authentication type (Basic or CAM Credentials)
- Username and password
- SSL certificate (if required by the database server)
For authentication setup information, see Authenticating and managing sessions.
Choose the method for creating a connection based on where you are in the platform
- In a project
- Click Assets > New asset > Connect to a data source. See Adding a connection to a project.
- In a catalog
- Click Add to catalog > Connection. See Adding a connection asset to a catalog.
- In a deployment space
- Click Import assets > Data access > Connection. See Adding data assets to a deployment space.
- In the Platform assets catalog
- Click New connection. See Adding platform connections.
Next step: Add data assets from the connection
Where you can use this connection
You can use Planning Analytics connections in the following workspaces and tools:
Projects
- Data Refinery (watsonx.ai Studio or IBM Knowledge Catalog)
- DataStage (DataStage service). See Connecting to a data source in DataStage.
- Decision Optimization experiments (watsonx.ai Studio)
- Notebooks (watsonx.ai Studio). Click Read data on the Code snippets pane to get the connection credentials and load the data into a data structure. See Load data from data source connections.
- SPSS Modeler (watsonx.ai Studio)
Catalogs
-
Platform assets catalog
-
Other catalogs (IBM Knowledge Catalog)
- Data Virtualization service
- You can connect to this data source from Data Virtualization.
Planning Analytics setup
Enable TM1 REST APIs on the TM1 Server. See TMI REST API Installation and configuration.
Cube dimension order
Versions earlier than TM1 11.4
For best performance, do not combine string and numeric data in a single cube. However, if the cube does include both string and numeric data, the string elements must be in the last dimension
when the cube is created. Reordering dimensions later is ignored.
Version TM1 11.4 or later
The default setting in Planning Analytics for cube creation is current. This setting might cause errors or unexpected results when you use the Planning Analytics connection. Instead,
set the interaction property use_creation_order value to true.
Planning Analytics view
You cannot alter the schema that is specified for a view. If you want use a different schema, you need to change the view.
Restriction
For Data Refinery, you can use this connection only as a source. You cannot use this connection as a target connection or as a target connected data asset.
Learn more
Planning Analytics product documentation
Parent topic: Supported connections