Skip to content

Commit c3d8540

Browse files
authored
Merge pull request mendix#8951 from SurabhiSaraf/10.19_EDBUpdate
Added changes for BYOD. 10.19 release of Studio Pro
2 parents 73ff4b7 + 58f1cc1 commit c3d8540

2 files changed

Lines changed: 51 additions & 5 deletions

File tree

content/en/docs/appstore/use-content/platform-supported-content/modules/database-connector-mx10.md

Lines changed: 48 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,12 @@ If you need to connect to other database types, check out the [Database Connecto
3131

3232
### Features {#features}
3333

34+
{{% alert color="info" %}}
35+
36+
From [Studio Pro 10.19](/releasenotes/studio-pro/10.19/), you can connect to any database by using the Java dependency specified by the user for the respective database. For more information, see the [Configure for Any Database](#byod) section below.
37+
38+
{{</alert>}}
39+
3440
This connector supports connections to the following database types:
3541

3642
* Microsoft SQL
@@ -39,8 +45,6 @@ This connector supports connections to the following database types:
3945
* Oracle
4046
* Snowflake – GA support from [Studio Pro 10.12](/releasenotes/studio-pro/10.12/) (Beta versions are available from [Studio Pro 10.10](/releasenotes/studio-pro/10.10/)). For more information, see [Configure the External Database Connector for Snowflake](/appstore/modules/snowflake/external-database-connector/)
4147

42-
If you are looking for another database type, follow the prompt to request support your database when you open the database connection wizard.
43-
4448
This connector supports the following statements:
4549

4650
* `SELECT`
@@ -210,3 +214,45 @@ To connect to PostgreSQL when the application is running in Mendix Cloud, follow
210214
1. To configure SSL-based authentication in Mendix Cloud, add a CA certificate and client certificate for server configuration and the selected SSL mode. For more details, see the [Running in the Cloud](/howto/integration/use-a-client-certificate/#running-in-the-cloud) section of *Use a Client Certificate*.
211215
2. After the client certificate has been added, double-click the client certificate and add the value `ClientCertificateIdentifier` to `Use Client Certificate for specific services`. This must match the value provided for the constant `ClientCertificateIdentifier`.
212216
3. Add the required values to the constants created for DBSource, DBUsername, DBPassword, and ClientCertificateIdentifier.
217+
218+
## Configure for Any Database {#byod}
219+
220+
### Prerequisites
221+
222+
* Ensure you have the appropriate Java Database Connectivity (JDBC) JAR file for the specific database.
223+
* Gather the external connection details, including login credentials and the JDBC connection string.
224+
225+
### Connect to the Database
226+
227+
1. Open the module settings and add the JDBC JAR File.
228+
229+
* Alternatively, place the downloaded JAR file in the userlib folder of your application.
230+
231+
2. Run the app with the latest version of the External Database Connector.
232+
233+
3. Create a New External Database Connection.
234+
4. Open the connection settings and under Database Type, select **Other**.
235+
5. Enter the login credentials and JDBC connection string.
236+
6. Click **Test Connection** to ensure the database connection is successful.
237+
7. Click **Save** to save the connection details.
238+
239+
### Configure Database Schema Information
240+
241+
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:
242+
243+
1. Open the **App** menu and select **Deploy for Eclipse**.
244+
2. Extend the class MxQueryBasedSchemaInfoProvider.
245+
3. Override the following methods based on your requirements:
246+
* getTableMetaDataQuery
247+
* getViewMetaDataQuery
248+
* getProcedureMetaDataQuery
249+
* getFunctionMetaDataQuery
250+
4. Use the provided example, MxDb2SchemaInfoProvider for IBM Db2, for a better understanding of how to customize the schema information.
251+
252+
### Running Queries and Handling Query Responses
253+
254+
Execute queries as you would with supported databases, and retrieve responses in the associated entity. Refer to the documentation of your specific JDBC library for detailed syntax and execution options.
255+
256+
{{% alert color="info" %}}
257+
By default, autocommit is set to false for design time queries.
258+
{{% /alert %}}

content/en/docs/refguide/modeling/integration/use-extensions/use-the-external-database-connector.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,11 +44,11 @@ Download the [External Database Connector](https://marketplace.mendix.com/link/c
4444

4545
If additional connection properties are required to connect, you can alternatively use **JDBC Connection String**.
4646

47-
### If Using the Flag: `--enable-live-preview` (available for Studio Pro 10.18) {#enable-live-preview}
47+
### Prerequisites from Studio Pro 10.19 (available from Studio Pro 10.18 using the flag: `--enable-live-preview`) {#enable-live-preview}
4848

49-
* Download the [External Database Connector](https://marketplace.mendix.com/link/component/219862).
49+
* Download the latest [External Database Connector](https://marketplace.mendix.com/link/component/219862).
5050
* If certificate-based authentication is required for PostgreSQL connections, ensure that all necessary certificates are added before running the app.
51-
* To test the connection and execute queries during design time, run your app locally.
51+
* To test the connection and execute queries during design time, Ensure to run your app locally.
5252

5353
## Connect to the External Database
5454

0 commit comments

Comments
 (0)