Skip to content

Commit 8f51ed4

Browse files
authored
Merge pull request #11591 from SurabhiSaraf/11.13EDBUpdate
11.13 External database connector update
2 parents f16b70a + dc6a8d0 commit 8f51ed4

3 files changed

Lines changed: 39 additions & 10 deletions

File tree

content/en/docs/marketplace/platform-supported-content/modules/external-database-connector.md

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,10 @@ aliases:
99

1010
## Introduction
1111

12+
{{% alert color="info" %}}
13+
If you are using Studio Pro 11.13 or later, you do not need to download this module from the Marketplace, as the External Database Connector comes included with Studio Pro. For more information, see [Connect to an External Database](/refguide/external-database-connection/).
14+
{{% /alert %}}
15+
1216
Connect to Microsoft SQL, MySQL, PostgreSQL, Oracle, and Snowflake databases with the [External Database Connector](https://marketplace.mendix.com/link/component/219862).
1317

1418
## Use Cases
@@ -139,6 +143,10 @@ WHERE empno IN
139143

140144
Here, the parameter `EmpIdList` is of type String with the value `[1,7946,3,4,7942,7943,7945]`.
141145

146+
{{% alert color="info" %}}
147+
Parameter names cannot start with a number.
148+
{{% /alert %}}
149+
142150
### Using Query Response {#use-query-response}
143151

144152
After querying the database, you can view the response in the **Response** screen.
@@ -261,16 +269,28 @@ To connect to PostgreSQL when the application is running in Mendix Cloud, follow
261269

262270
### Configure Database Schema Information
263271

264-
The Browse Database Schema tab might not display a comprehensive overview of all available schemas for certain databases. You can customize this behavior using the Configure option. To do so, follow these steps:
272+
The Browse Database Schema tab might not display a comprehensive overview of all available schemas for certain databases. You can customize this behavior using the Configure option.
273+
274+
If you are using Studio Pro 11.13 or later, follow the steps below:
275+
276+
1. Use the Mendix public API class QueryBasedSchemaInfoProvider to extend your Java class. For example, create `MxDb2SchemaInfoProvider.java` inside `\MendixApp\javasource\myfirstmodule\myloader`.
277+
2. Override the following methods based on your requirements:
278+
* `getTableMetaDataQuery`
279+
* `getViewMetaDataQuery`
280+
* `getProcedureMetaDataQuery`
281+
* `getFunctionMetaDataQuery`
282+
283+
If you are using Studio Pro 11.12 or earlier, follow the steps below:
265284

266285
1. Open the **App** menu and select **Deploy for Eclipse**.
267-
2. Extend the class MxQueryBasedSchemaInfoProvider.
286+
2. Extend the class `MxQueryBasedSchemaInfoProvider`.
268287
3. Override the following methods based on your requirements:
269-
* getTableMetaDataQuery
270-
* getViewMetaDataQuery
271-
* getProcedureMetaDataQuery
272-
* getFunctionMetaDataQuery
273-
4. Use the provided example, MxDb2SchemaInfoProvider for IBM Db2, for a better understanding of how to customize the schema information.
288+
* `getTableMetaDataQuery`
289+
* `getViewMetaDataQuery`
290+
* `getProcedureMetaDataQuery`
291+
* `getFunctionMetaDataQuery`
292+
4. Use the provided example, `MxDb2SchemaInfoProvider` for IBM Db2, for a better understanding of how to customize the schema information.
293+
274294

275295
### Running Queries and Handling Query Responses
276296

content/en/docs/refguide/modeling/integration/use-platform-supported-content/external-database-connector/_index.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,8 @@ description: "Overview of how to configure the [External Database Connection doc
1111
The [External Database Connector](/appstore/modules/external-database-connector/) integrates with Studio Pro with an **External database connection** service document. Use this document to connect to external databases in Studio Pro.
1212

1313
{{% alert color="info" %}}
14-
You must install the [External Database Connector](https://marketplace.mendix.com/link/component/219862) for external database connections to work properly while running your app. For instructions on adding modules or connectors to your app, see [Use Marketplace Content in Studio Pro](/appstore/use-content/).
14+
For Studio Pro 11.13 and later, external database connectivity is built into Studio Pro. Therefore you do not need to download the Marketplace module for use.
15+
For Studio Pro 11.12 and earlier, you must install the [External Database Connector](https://marketplace.mendix.com/link/component/219862) from the Marketplace for external database connections to work. For instructions, see [Use Marketplace Content in Studio Pro](/appstore/use-content/).
1516
{{% /alert %}}
1617

1718
## Connect to the Database Wizard {#wizard}
@@ -25,6 +26,12 @@ Enter or select the following:
2526
* **Name** — name of your database connection
2627
* **Database Type** — Microsoft SQL, MySQL, Oracle, PostgreSQL, or Snowflake
2728

29+
{{% alert color="info" %}}
30+
From Studio Pro 11.13 and later, when you select a database type, the required JDBC library is automatically added to the **Java Dependencies** tab in [Module Settings](/refguide/module-settings/) of the module you are working on. The dependency is downloaded to the **vendorlib** folder when you run the app or trigger Java dependency management. To use a different version, you can edit the dependency in [Module Settings](/refguide/module-settings/).
31+
32+
For BYOD, you have to add the required JDBC driver details in Module Settings.
33+
{{% /alert %}}
34+
2835
### Connection Details
2936

3037
If you select **Use connection details**, enter:
@@ -101,5 +108,4 @@ The **Response Structure** tab displays a preview of an entity that can be creat
101108

102109
* To configure the connector with an external database, follow the steps in [External Database Connector](/appstore/modules/external-database-connector/).
103110
* To utilize the connector to integrate data into your Mendix application, see [Querying and Integrating External Data](/refguide/use-the-external-database-connector/).
104-
* To use SQL, see [Execute an SQL Statement on an External Database](/refguide/execute-an-sql-statement-on-an-external-database/).
105111
* To learn about how to use the data in a microflow, see the [Query External Database](/refguide/query-external-database/) activity.

content/en/docs/refguide/modeling/integration/use-platform-supported-content/external-database-connector/query-and-integrate-external-data.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,10 @@ This document teaches you how to do the following:
2222

2323
## Prerequisites
2424

25-
Ensure you have an active connection using the External Database Connection document. For information on how to configure the connector, see [External Database Connector](/appstore/modules/external-database-connector/) in the *Marketplace Guide*.
25+
{{% alert type="info" %}}
26+
For Studio Pro 11.13 and later, external database connectivity is built into Studio Pro. Therefore you do not need to download the Marketplace module for use.
27+
28+
For Studio Pro 11.12 and earlier, ensure you have an active connection using the External Database Connection document. For information on how to configure the connector, see [External Database Connector](/appstore/modules/external-database-connector/) in the *Marketplace Guide*. {{% /alert %}}
2629

2730
* If additional connection properties are required to connect, you can alternatively use **JDBC Connection String**.
2831
* If certificate-based authentication is required for PostgreSQL connections, ensure that all necessary certificates are added before running the app.

0 commit comments

Comments
 (0)