EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB485056: FreeFrom SQL reports containing text prompt may fail due to disabling of Parameterized Query after upgrading to MicroStrategy 2021 Update 1 if warehouse version has not been certified with parameterization yet


Qinyi Chen

Quality Engineer, Principal • Strategy


After users upgrade the Intelligence Server to MicroStrategy 2021 Update 1, some Parameterized FreeFrom reports which use Text Prompt may fail. This is because the Parameterized Query is disabled after the upgrade. The reason for disabling it is because the warehouse has not been certified with Parameterized Query yet and MicroStrategy is working on certifying more gateways in subsequent update releases. If you are encountering this issue, it is likely you are on an older version of a major database. Please review this page for a list of certified gateways for the parameterized query. This article provides an alternative solution to re-enable parameterization for uncertified gateways.

Description  

  • The Engine is upgraded to Strategy 2021 Update 1 
  • Free-form SQL reports used to run with parameterized query starts to fail, and the new behavior is not parameterized 
  • The failing free-form SQL reports utilize text value prompt, including system prompts 

 

Example 

  • The user created a free-form SQL report with a text value prompt before the upgrade and enabled the parameterized queries on the database connection. 
ka04W000001Ev6XQAS_0EM4W0000028YoL.png
ka04W000001Ev6XQAS_0EM4W0000028YoM.png
  • Before the upgrade, the report can run with parameterized query and generate results. 
ka04W000001Ev6XQAS_0EM4W0000028YoN.png
  • After the upgrade, the report fails with the following error:
ka04W000001Ev6XQAS_0EM4W0000028YoO.png
  • Examine the SQL and notice the prompt is no longer parameterized: 
ka04W000001Ev6XQAS_0EM4W0000028YoP.png

Why is this happening?

This is an expected behavior with Strategy 2021 Update 1 due to changes in parameterized query behavior control.  
Before Strategy 2021 Upgrade 1, to enable parameterized query in free-form SQL, you only need to enable it on the database connection-level, regardless of whether the DBMS is certified for parameterization.  
After Strategy 2021 Upgrade 1, if the DBMS is not certified for parameterization, parameterization for free-form SQL with text prompt is disabled, even when the database connection-level control is enabled. This is because parameterization for secure SQL has been extended to all live execution workflows (not limited to free-form SQL containing text prompt) and it is essential that Strategy certify such workflows in a unified way on all Diamond and Platinum gateways.  
So far, all recent versions of major Diamond and Platinum gateways have been certified. The list of certified gateways can be found here and we are working on certifying more. 

Solution 

If you are unable to move to one of the certified gateways, and if you have certified that your free-form SQL reports can run with parameterized queries with your specific DBMS, you can re-enable it for your projects by the following steps: 

  • Identify the Database Connection Type for your database instance.
ka04W000001Ev6XQAS_0EM4W0000028YoQ.png
  1. Locate DATABASE.PDS file, edit and find the section for the DBMS. 
  1. Under the VLDB select section, add the line in red.  

<PROPERTYSET NAME="VLDB Select"> 
        <PROPERTY NAME="GROUP BY Non-ID Attribute" VALUE="1" /> 
        <PROPERTY NAME="Sub Query Type" VALUE="3" /> 
        <PROPERTY NAME="Maximum Metric Alias Length" VALUE="128" /> 
        <PROPERTY NAME="Set Operation" VALUE="1" /> 
        <PROPERTY NAME="Full Outer Join Support" VALUE="1" /> 
        <PROPERTY NAME="Parameterized Query for Text Input" VALUE="1" /> 

  1. Save DATABASE.PDS file.
  1. Update the database connection type in Developer and reload the specific DBMS.
  1. Restart the Intelligence Server. Parameterized query should be working again.

Comment

0 comments

Details

Knowledge Article

Published:

June 14, 2021

Last Updated:

June 14, 2021