You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerquery-docs/connectors/sap-bw/use-advanced-options.md
+23-23Lines changed: 23 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,15 +3,15 @@ title: Use advanced options
3
3
description: Describes how to use the Power Query SAP Business Warehouse connector advanced sign-in options.
4
4
author: dougklopfenstein
5
5
ms.topic: concept-article
6
-
ms.date: 1/8/2024
6
+
ms.date: 12/1/2025
7
7
ms.author: dougklo
8
8
ms.subservice: connectors
9
9
ms.custom: sfi-image-nochange
10
10
---
11
11
12
12
# Use advanced options
13
13
14
-
When you create a connection to an SAP Business Warehouse server, you can optionally specify a language code, execution mode, batch size, and an MDX Statement. Also, you can select whether you want to enable characteristic structures.
14
+
When you create a connection to an SAP Business Warehouse (BW) server, you can optionally specify a language code, execution mode, batch size, and an MDX Statement. Also, you can select whether you want to enable characteristic structures.
15
15
16
16
> [!NOTE]
17
17
> Although the images in this article illustrate the advanced options in the SAP Business Warehouse Application Server connector, they work the same way in the SAP Business Warehouse Message Server connector.
@@ -20,7 +20,7 @@ When you create a connection to an SAP Business Warehouse server, you can option
20
20
21
21
You can optionally specify a language code when establishing a connection to the SAP BW server.
22
22
23
-
:::image type="content" source="language-code.png" alt-text="Entering a two-digit language code in the advanced options.":::
23
+
:::image type="content" source="language-code.png" alt-text="Screenshot of the SAP BW connection dialog with a two-digit language code in the advanced options emphasized.":::
24
24
25
25
The expected value is a two-letter language code as defined in the SAP system. In Power Query Desktop, select the Help icon (question mark) next to the Language Code field for a list of valid values.
26
26
@@ -29,9 +29,9 @@ After you set the language code, Power Query displays the descriptive names of t
29
29
> [!NOTE]
30
30
> Not all listed languages might be configured in your SAP BW system, and object descriptions might not be translated in all languages.
31
31
32
-
:::image type="content" source="navigator-language-option.png" alt-text="Navigator showing language change for descriptive and field names.":::
32
+
:::image type="content" source="navigator-language-option.png" alt-text="Screenshot of the Navigator showing the language change for descriptive and field names.":::
33
33
34
-
If no language code is specified, the default locale from the **Options** dialog will be used and mapped to a valid SAP language code. To view or override the current locale in Power BI Desktop, open the **File** > **Options and settings** > **Options** dialog box and select **Current File** > **Regional settings**. To view or override the current locale in Power Query Online, open the **Home** > **Options** > **Project options** dialog box. If you do override the locale, your setting gets persisted in your M query and would be honored if you copy-paste your query from Power Query Desktop to Power Query Online.
34
+
If no language code is specified, the default locale from the **Options** dialog is used and mapped to a valid SAP language code. To view or override the current locale in Power BI Desktop, open the **File** > **Options and settings** > **Options** dialog box and select **Current File** > **Regional settings**. To view or override the current locale in Power Query Online, open the **Home** > **Options** > **Project options** dialog box. If you do override the locale, your setting gets persisted in your M query and would be honored if you copy-paste your query from Power Query Desktop to Power Query Online.
35
35
36
36
## Execution mode
37
37
@@ -41,18 +41,18 @@ The **Execution mode** option specifies the MDX interface is used to execute que
41
41
***BasXmlGzip**: Specifies the *Gzip compressed bXML flattening mode* option for MDX execution in SAP Business Warehouse. This option is recommended for low latency or high volume queries. The default value for the execution mode option.
42
42
***DataStream**: Specifies the *DataStream flattening mode* option for MDX execution in SAP Business Warehouse.
43
43
44
-
:::image type="content" source="execution-mode.png" alt-text="Sign in dialog box showing location of the Execution mode option.":::
44
+
:::image type="content" source="execution-mode.png" alt-text="Screenshot of the SAP BW connection dialog showing location of the Execution mode option.":::
45
45
46
46
## Batch size
47
47
48
-
Specifies the maximum number of rows to retrieve at a time when executing an MDX statement. A small number translates into more calls to the server when retrieving a large data set. A large number of rows may improve performance, but could cause memory issues on the SAP BW server. The default value is 50000 rows.
48
+
Specifies the maximum number of rows to retrieve at a time when executing an MDX statement. A small number translates into more calls to the server when retrieving a large data set. A large number of rows might improve performance, but could cause memory issues on the SAP BW server. The default value is 50000 rows.
49
49
50
50
## MDX Statement
51
51
52
52
> [!NOTE]
53
53
>The MDX statement option isn't available in Power Query Online.
54
54
55
-
Instead of using the navigator to browse through and select from available data objects in SAP BW, a user who's familiar with the MDX query language can specify an MDX statement for direct execution in SAP BW. However, be aware that no further query folding will be applied when using a custom MDX statement.
55
+
Instead of using the navigator to browse through and select from available data objects in SAP BW, a user who's familiar with the MDX query language can specify an MDX statement for direct execution in SAP BW. However, be aware that no further query folding is applied when using a custom MDX statement.
56
56
57
57
The statement for the example used here would look as shown in the following sample, based on the technical names of the objects and properties in SAP BW.
58
58
@@ -69,43 +69,43 @@ DIMENSION PROPERTIES
69
69
[0D_VENTOR].[50D_VENDOR] ON ROWS FROM [0D_PU_C01/0D_PU_C01_Q0013]
:::image type="content" source="example-mdx-statement.png" alt-text="Screenshot of the SAP BW connection dialog with the example MDX statement shown in the MDX statement option.":::
73
73
74
-
The SAP BW connector will display a preview of the data that is returned by the MDX statement. You can then either select **Load** to load the data (Power Query Desktop only), or select **Transform Data** to further manipulate the data set in the Power Query Editor.
74
+
The SAP BW connector displays a preview of the data returned by the MDX statement. You can then either select **Load** to load the data (Power Query Desktop only), or select **Transform Data** to further manipulate the data set in the Power Query Editor.
75
75
76
-
:::image type="content" source="mdx-preview-data.png" alt-text="MDX data displayed in the navigator preview.":::
76
+
:::image type="content" source="mdx-preview-data.png" alt-text="Screenshot of the MDX data displayed in the navigator preview.":::
77
77
78
78
To validate and troubleshoot an MDX statement, SAP BW provides the *MDXTEST* transaction for SAP GUI for Windows users. Further, the MDXTEST transaction can be a useful tool for analyzing server errors or performance concerns as a result of processing that occurs within the SAP BW system.
79
79
80
80
For more detailed information on this transaction, go to [MDX Test Environment](https://help.sap.com/viewer/64e2cdef95134a2b8870ccfa29cbedc3/7.3.15/en-US/19fdd486b13c43e2ad9f562a3222a480.html).
81
81
82
-
:::image type="content" source="mdxtest-in-sapgui.png" alt-text="Troubleshooting an MDX statement with MDXTEST in the SAPGUI.":::
82
+
:::image type="content" source="mdxtest-in-sapgui.png" alt-text="Screenshot of the MDX Test Environment where you troubleshoot an MDX statement with MDXTEST in the SAPGUI.":::
83
83
84
-
MDXTEST can also be used to construct an MDX statement. The transaction screen includes panels on the left that assist the user in browsing to a query object in SAP BW and generating an MDX statement.
84
+
MDXTEST can also be used to construct an MDX statement. The transaction screen includes panels that assist the user in browsing to a query object in SAP BW and generating an MDX statement.
85
85
86
-
The transaction offers different execution modes/interfaces for the MDX statement. Select *Flattening (basXML)* to mimic how Power Query would execute the query in SAP BW. This interface in SAP BW creates the row set dynamically using the selections of the MDX statement. The resulting dynamic table that's returned to Power Query Desktop has a very compact form that reduces memory consumption.
86
+
The transaction offers different execution modes/interfaces for the MDX statement. Select *Flattening (basXML)* to mimic how Power Query would execute the query in SAP BW. This interface in SAP BW creates the row set dynamically using the selections of the MDX statement. The resulting dynamic table returned to Power Query Desktop has a very compact form that reduces memory consumption.
87
87
88
-
:::image type="content" source="select-flattening.png" alt-text="Shows Flattening selected in Execute in Export mode.":::
88
+
:::image type="content" source="select-flattening.png" alt-text="Screenshot that shows Flattening selected in Execute in Export mode.":::
89
89
90
-
The transaction will display the result set of the MDX statement and useful runtime metrics.
90
+
The transaction displays the result set of the MDX statement and useful runtime metrics.
91
91
92
-
:::image type="content" source="mdx-result-set.png" alt-text="Displays the result set of the MDX statement.":::
92
+
:::image type="content" source="mdx-result-set.png" alt-text="Screenshot showing the result set of the MDX statement.":::
93
93
94
94
## Enable characteristic structures
95
95
96
-
The **Enable characteristic structures** selection changes the way characteristic structures are displayed in the navigator. A structure is an SAP BW object that can be used when building BEX queries. In the BEX UX they look like the following image.
96
+
The **Enable characteristic structures** selection changes the way characteristic structures are displayed in the navigator. A structure is an SAP BW object that can be used when building BEX queries. In the BEX UX, they look like the following image.
97
97
98
-
:::image type="content" source="characteristic-structures.png" alt-text="Structure used when building BEX queries.":::
98
+
:::image type="content" source="characteristic-structures.png" alt-text="Screenshot of the structure used when building BEX queries.":::
99
99
100
-
If the **Enable characteristic structures** selection is clear (default), the connector will produce a cartesian product of each dimension on the structure with each available measure. For example:
100
+
If the **Enable characteristic structures** selection is clear (default), the connector produces a cartesian product of each dimension on the structure with each available measure. For example:
101
101
102
-

102
+
:::image type="content" source="clear-characteristic-structure.png" alt-text="Screenshot of the navigator showing the Net Value stat curr and Number of documents values each displayed for Calgary, Frankfurt, and Munich.":::
103
103
104
104
If selected, the connector produces only the available measures. For example:
105
105
106
-
:::image type="content" source="enable-characteristic-structure.png" alt-text="Image of the navigator showing only the Net Value stat curr and Number of documents values displayed.":::
106
+
:::image type="content" source="enable-characteristic-structure.png" alt-text="Screenshot of the navigator showing only the Net Value stat curr and Number of documents values displayed.":::
107
107
108
-
### See also
108
+
### Related content
109
109
110
110
*[Navigate the query objects](navigate-query-objects.md)
111
111
*[Transform and filter SAP BW data set](transform-filter-sap-bw-data.md)
0 commit comments