Page History

Attaches an ElastiCube folder to the local server.

Example:

psm ecube attach path=s:\ElastiCubedata\acheck1 serverAddress=192.168.1.xxx

path: Defines the full path of the folder you want to attach to a server.

serverAddress: Defines the address of a remote server. If the address is not a remote server or no value is entered, the default value localhost is used.

sync: Determines whether to execute this synchronously or asynchronously. Optional. By default, the value is False, asynchronously.

ecube build

Builds an ElastiCube from an ecube file or server-hosted ElastiCube.

Example:

Full Build, Local Server

psm ecube build name="<elasticube name>" mode=restart serverAddress=localhost

Accumulative Build, Remote Server 

psm ecube build name="<elasticube name>" mode=restart serverAddress=192.168.1.134

Note: You can access similar functionality in the REST API. See /elasticubes/{server}/{elasticube}/startBuild for more information.

filename: Defines the name of the ecube file. The ecube file contains the ElastiCube schema and data connection settings required for building the ElastiCube on the target server.
name: Defines the name of an existing ElastiCube in an ElastiCube server. Use the name parameter when you want to rebuild the ElastiCube.
serverAddress: Defines the target server address on which the ElastiCube should be built.
mode: Defines the how the ElastiCube should be built. Possible values include: 

1. mode=restart: Rebuilds the ElastiCube entirely.
2. mode=full: Rebuilds the ElastiCube and accumulates data for tables marked as accumulative. This mode should only be used for accumulative builds.
3. mode=changes: Rebuilds from scratch tables that have changed in the ElastiCube schema.
4. mode=metadataonly: Updates the ElastiCube server with the ElastiCube schema, without building.

OrchestratorTask Id: Optional. The default value is none. This parameter is relevant for high availability configurations. For more information, see High Availability.

Converts ElastiCube XMLs files or encrypted ElastiCube XMLs files into ElastiCube files or ElastiCube files into ElastiCube XMLs (unencrypted).

The converted file is created in the same folder as the source file.

Example:

Ecube to XML

psm ecube convert name="c:\mycube.ecube"

XML to Ecube

psm ecube convert name="c:\mycube.xml"

name: Address and filename of the source file.

Creates an empty ElastiCube.

Example:

psm ecube create serverAddress=localhost name=TestCube 

serverAddress: Defines the target server address on which the ElastiCube should be built.

 name: Defines the name of the new ElastiCube.

Delete an ElastiCube from the target server.

Example:

psm ecube delete name="mycube" serverAddress=localhost

name: Defines the name of the ElastiCube to be removed from the target server.

serverAddress: Defines the target server address from which the ElastiCube should be removed.

Detaches an ElastiCube from the local server. When you detach an ElastiCube, the ElastiCube can no longer be accessed, but is saved in your ElastiCube folder in case you want to attach and reuse the ElastiCube again.

Example:

psm ecube detach name="mycube" serverAddress=localhost

name: Defines the name of the ElastiCube you want to detach.

 serverAddress: Defines the address of a remote server. If the address is not a remote server or no value is entered, the default value localhost is used.

 sync: Determines whether to execute this synchronously or asynchronously. Optional. By default, the value is False, asynchronously. 

Adds a custom field to a specified table in an ElastiCube.

Example:

psm ecube edit fields addCustomField serverAddress=localhost cubeName="Sample ECommerce" 

tableName=MyTable fieldName=MyField sqlExpression="SELECT 1"

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the table where a new custom field will be added.

fieldName: The name of the table.

sqlExpression: The SQL expression of the new custom field.

Retrieves a list of all fields from a table.

Example:

psm ecube edit fields getListOfFields serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable isCustom=false

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the table.

isCustom: Indicates if the table is custom when set to true.

Retrieves the SQL string of a custom field in a table in the specified ElastiCube.

Example:

psm ecube edit fields getSqlOfField serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable fieldName=MyField 

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

 cubeName: The name of the ElastiCube.

 tableName:The name of the table.

 fieldName: The name of the custom field.

Removes a field from a specific table from an ElastiCube.

Example:

psm ecube edit fields removeField serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable fieldName=MyField 

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName:The name of the table.

fieldName: The name of the custom field.

Modifies the SQL statement of a field.

Example:

psm ecube edit fields updateSqlStatementOfField serverAddress=localhost cubeName="Sample ECommerce" 

tableName=MyTable fieldName=MyField  sqlExpression="SELECT 2" 

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the table.

fieldName: The name of the custom field.

sqlExpression: The new SQL expression.

Renames local ElastiCube files.

Example:

psm ecube edit rename ecube="c:\test.ecube" name="mycube”

ecube: Address and filename of the .ecube file.

name: The new name of the ElastiCube file.

backup: (Optional) Boolean value that creates a .bak file of the ecube when renaming it. The backup file created has the format name.ecube.bak. By default, this value is false.

Refreshes all tables within an ElastiCube. 

Example:

psm ecube edit connection refresh ecube="C:\test.ecube"

ecube: Address and filename of the .ecube file.

Adds a new custom table to the specified ElastiCube.

Example:

psm ecube edit tables addCustomTable serverAddress=localhost cubeName="Sample ECommerce" 

tableName=MyTable sqlExpression="SELECT * FROM [category]"

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

 cubeName: The name of the ElastiCube.

 tableName:The name of the table.

 sqlExpression: The new SQL expression.

Adds a new Base table to the specified ElastiCube.

Example:

psm ecube edit tables addTable serverAddress=localhost cubeName="Sample ECommerce" provider=MySql 

connectionString="data source=10.500.10.404;UID=admin;password=Ad!234qwpassword;database=testdb" 

schemaName=testdb tableName=currency customTableName="MyTable" sqlExpression=""

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

 cubeName: The name of the ElastiCube.

 provider: The name of the provider. Currently supported providers and their usage:

MsSql - "sql",
MySql - "MySql"
Amazon Redshift - "RedShift"
PostGreSQL - "PostgreSQL"
Oracle - "Oracle"

 connectionString: The name of the ElastiCube where the table is to be added.

 schemaName: The schema name of new table to be added.

 tableName: The name of new table to be added.

 customTableName: An optional custom name for the new table to be added.

 sqlExpression: An SQL expression for the new Base table.

Deletes a table from the specified ElastiCube.

Example:

psm ecube edit tables deleteTable serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

Retrieves the connection string of a table from an ElastiCube.

Example:

psm ecube edit tables getConnectionStringOfTable serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

additionalParameters: A boolean value that allows you to return additional parameters that are part of the connection string instead of just the basic string that is returned by default. This

Retrieves a list of all custom tables from an ElastiCube.

Example:

psm ecube edit fields getListOfFields serverAddress=localhost cubeName="Sample ECommerce" 

tableName=MyTable isCustom=true

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

isCustom: Set to true to return only custom fields.

Retrieves a list of all tables from an ElastiCube.

Example:

psm ecube edit tables getListOfTables serverAddress=localhost cubeName="Sample ECommerce" isCustom=false

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

isCustom: Set to true to return only custom tables.

Retrieves the provider string of a specific table from an ElastiCube.

Example:

psm ecube edit tables getProviderOfTable serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

Retrieves the SQL string of a specific table from an ElastiCube.

Example:

psm ecube edit tables getSqlOfTable serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

Modifies the SQL statement of a table.

Example:

psm ecube edit tables updateSqlStatementOfTable serverAddress=localhost cubeName="Sample ECommerce" 

tableName=MyTable sqlExpression="SELECT * FROM accounts360.account" isCustom=false

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

sqlExpression: The new SQL expression.

isCustom: Set to true if the table is a custom table.

Creates a new relationship between two fields in an ElastiCube.

Example:

psm ecube edit relations createRelation serverAddress=localhost cubeName="Sample ECommerce" sourceTable=category 

sourceField="Category ID" targetTable=brand targetField="Brand ID"

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

 sourceTable: The name of the relationship source table.

sourceField: The name of the relationship source field.

targetTable: The name of the relationship target table.

targetField: The name of the relationship target field.

Deletes a relation between two fields.

Example:

psm ecube edit relations deleteRelation serverAddress=localhost cubeName="Sample ECommerce" 

sourceTable=category sourceField="Category ID" targetTable=brand targetField="Brand ID"

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

sourceTable: The name of the relationship source table.

sourceField: The name of the relationship source field.

targetTable: The name of the relationship target table.

targetField: The name of the relationship target field.

Retrieves a list of all relations of a specified table in an ElastiCube.

Example:

psm ecube edit relations getRelationsOfTable serverAddress=localhost cubeName="Sample ECommerce" tableName=MyTable

serverAddress: The target server address where the ElastiCube is hosted. The default value is LocalHost.

cubeName: The name of the ElastiCube.

tableName: The name of the ElastiCube table.

• MS SQL Server
• Oracle
• MySQL
• PostgreSQL
• DB2
• Teradata
• Salesforce
• Zendesk
• Splunk

Example:

psm ecube edit connection database ecube="c:\users\myuser\documents\mycube.ecube" server="10.0.0.1" 

database="tracking" newserver="localhost" newdatabase="trackingX" newusername="mynewuser" newpassword="newpassword"

ecube: Defines the ecube file name to edit.

server: Defines the source server to modify (leave empty to modify all databases in server).

database: Defines the source database to modify.

newserver: Defines the new server address (leave empty to keep previous value).

newdatabase: The new database (leave empty to keep previous value).

newschema: The new schema (leave empty to keep previous value).

newusername: Defines the new username (leave empty to keep previous value).

newpassword: Defines the new password (leave empty to keep previous value).

backup: Indicates if the ElastiCube file should be backed up (defaults is true).

Returns information about the ElastiCube such as its build history and current status.

Example:

psm ecube info name="mycube" serverAddress=localhost

name: Defines the name of the ElastiCube.

serverAddress: Defines the target server address of the ElastiCube.

Restarts an ElastiCube on the target server.

Example:

psm ecube restart name="mycube" serverAddress=localhost

Note: You can access similar functionality in the REST API. See /elasticubes/{server}/{elasticube}/restart for more information.

name: Defines the name of the ElastiCube to be restarted.

serverAddress: Defines the target server address on which the ElastiCube should be restarted.

Performs a scale analysis of ElastiCubes or tables within an ElastiCube without building a new ElastiCube.

The scale analysis returns two CSV files, Columns and Tables, which provides data regarding the type, size and standard deviation of the data within the files.

Scale analysis is supported for MySQL, PostGreSQL, and Oracle-based tables.

Example:

psm ecube scaleanalysis name="C:\My ElastiCubes\mycube.ecube" 

name: Address and filename of the .ecube file.

 table: The name of the table to be analyzed. When this parameter is blank all the tables are analyzed.

Starts an ElastiCube on the target server.

Example:

psm ecube start name="myCube" serverAddress="localhost"

name: Defines the name of the ElastiCube to be started.

serverAddress: Defines the target server address on which the ElastiCube should be started.

Stops an ElastiCube on the target serving. Stopping an ElastiCube reduces the amount of system resources Sisense uses. When you stop an ElastiCube, the ElastiCube can longer be queried.

Example:

psm ecube stop name="myCube" serverAddress="localhost"

name: Defines the name of the ElastiCube to be started.

serverAddress: Defines the target server address on which the ElastiCube should be stopped.

Changes the data source behind a psm to another data source.

Note: This is a legacy command used with Sisense version 4. Note: You can access similar functionality in the REST API. See /dashboards/{server}/{title}/replaceDatasource for more information.

file: Prism document file name to open and convert.

prev: Previous data source that is being updated.

new: New data source.

Starts the ElastiCube server.

Example:

psm ecs start

Note: You can access similar functionality in the REST API. See /elasticubes/{server}/{elasticube}/start for more information.

Stops the ElastiCube server.

Example:

psm ecs stop

Note: You can access similar functionality in the REST API. See /elasticubes/{server}/{elasticube}/stop for more information.

Returns system information (server hardware) and ElastiCube details (number of cubes, size, etc.).

Example:

psm sysinfo

Note: You can access similar functionality in the REST API. See /settings/system for more information.

Downgrades ElastiCube data files created and encrypted in Sisense version 6.2 to ElastiCube files compatible with versions prior to 6.2 without encryption. This is useful if you have created ElastiCubes in 6.2 and wish to downgrade while still using all of your ElastiCubes.

Example:

psm ecdata 62downgrade filename="C:\Program Files\test62.ecdata"