diff --git a/content/en/docs/appstore/use-content/platform-supported-content/modules/database-connector-mx10.md b/content/en/docs/appstore/use-content/platform-supported-content/modules/database-connector-mx10.md index d4f44aab468..6c774219ff1 100644 --- a/content/en/docs/appstore/use-content/platform-supported-content/modules/database-connector-mx10.md +++ b/content/en/docs/appstore/use-content/platform-supported-content/modules/database-connector-mx10.md @@ -17,6 +17,12 @@ If you are using Studio Pro 10.12, make sure to use the latest version 3.0.0 [Ex This document provides instructions on how to configure and use the External Database Connector. For information on the database wizard and how to connect using the External Database Connection document, see [External Database Connection](/refguide/external-database-connection/). For information on how to create and validate SQL queries, see [Use the External Database Connector](/refguide/use-the-external-database-connector/). +{{% alert color="info" %}} +For Studio Pro 10.18, the External Database Connector uses a different approach to connect to databases during design time. This functionality enhances consistency between design time and runtime environments. To enable this beta feature, use the flag: `--enable-live-preview` + +For information on how to connect using the External Database Connection document with a feature flag, see [External Database Connection](/refguide/external-database-connection/enable-live-preview). +{{% /alert %}} + ### Typical Use Cases Use this module if you need to connect to databases and select data to use in your app. This connector allows you to directly test connections and queries during configuration in Studio Pro (design time). @@ -81,11 +87,14 @@ After [installing](#installation) the connector, get started by doing the follow 4. Click **Save** to open the external database document for this database. +{{% alert color="info" %}} Values for these constants are stored in the active configuration of the user. The password is stored as a private value. + +Constants are an environment variable whose values can differ per environment, When you deploy an app on Mendix Cloud, values for constants are not added. For more information, see [Constants](https://docs.mendix.com/refguide/configuration/#constants){{% /alert %}} + {{% alert color="info" %}} -Connection details are stored as constants, their values are stored in the Active configuration of the user, the password is stored as a private value. -{{% /alert %}} +For free apps, make sure to add the default values to the constant in Studio Pro. For more information, see the [Deploying a Free App](https://docs.mendix.com/developerportal/deploy/mendix-cloud-deploy/deploying-an-app/#deploy-free-app) section below. {{% /alert %}} -Now you can start [querying the database](#query-database) to select data to use in your app. +Now, you can [query the database](#query-database) to select data to use in your app. ### Querying a Database {#query-database} diff --git a/content/en/docs/appstore/use-content/platform-supported-content/modules/snowflake/snowflake-edc.md b/content/en/docs/appstore/use-content/platform-supported-content/modules/snowflake/snowflake-edc.md index 18c6a90f8af..b39d4866987 100644 --- a/content/en/docs/appstore/use-content/platform-supported-content/modules/snowflake/snowflake-edc.md +++ b/content/en/docs/appstore/use-content/platform-supported-content/modules/snowflake/snowflake-edc.md @@ -152,7 +152,19 @@ To execute and test the query in Studio Pro, follow these steps: 10. Click **OK**. 11. Configure a nanoflow with the [Refresh entity](/appstore/modules/nanoflow-commons/) action to refresh the data grid if a user changes one of the filter values. -{{% alert color="info" %}}When using JDK version above 16, set JVM Parameter **--add-opens=java.base/java.nio=ALL-UNNAMED** in the App configuration.{{% /alert %}} +### Resolving Snowflake Dependency Issues with Apache Arrow on JDK 17 or 21 + +When using JDK versions 17 or 21 (or any version above 16), you may encounter compatibility issues with the Snowflake dependency, Apache Arrow. + +The Snowflake JDBC Driver uses Arrow as the default result format for query execution to improve performance. However, you can override this default setting by switching the result format to JSON. + +To set the result format at the Snowflake session or user level, use the following SQL statement: + +```sql +**ALTER USER SET JDBC_QUERY_RESULT_FORMAT='JSON';** +``` + +This approach ensures compatibility with JDK 16+. ## Configuring a Query to Display Data as a Chart diff --git a/content/en/docs/refguide/modeling/integration/use-extensions/external-database-connection.md b/content/en/docs/refguide/modeling/integration/use-extensions/external-database-connection.md index 1384802a7e3..6ae093d64f5 100644 --- a/content/en/docs/refguide/modeling/integration/use-extensions/external-database-connection.md +++ b/content/en/docs/refguide/modeling/integration/use-extensions/external-database-connection.md @@ -15,6 +15,12 @@ This page references the External Database Connection document in Studio Pro. Fo You must have the [External Database Connector](https://marketplace.mendix.com/link/component/219862) installed 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/). {{% /alert %}} +{{% alert color="info" %}} +For Studio Pro 10.18, the External Database Connector uses a different approach to connect to databases during design time. This functionality enhances consistency between design time and runtime environments. To enable this beta feature, use the flag: `--enable-live-preview` + +For information on how to connect using the External Database Connection document with a feature flag, see [External Database Connection](/refguide/external-database-connection/enable-live-preview). +{{% /alert %}} + ## Connect to Database Wizard {#wizard} Right-click your module and click **Add other > External database connection** to open the **Database Connection** wizard: diff --git a/content/en/docs/refguide/modeling/integration/use-extensions/use-the-external-database-connector.md b/content/en/docs/refguide/modeling/integration/use-extensions/use-the-external-database-connector.md index d1c6967846c..052b300fb75 100644 --- a/content/en/docs/refguide/modeling/integration/use-extensions/use-the-external-database-connector.md +++ b/content/en/docs/refguide/modeling/integration/use-extensions/use-the-external-database-connector.md @@ -44,6 +44,12 @@ Download the [External Database Connector](https://marketplace.mendix.com/link/c If additional connection properties are required to connect, you can alternatively use **JDBC Connection String**. +### If Using the Flag: `--enable-live-preview` (available for Studio Pro 10.18){#enable-live-preview} + +* Download the [External Database Connector](https://marketplace.mendix.com/link/component/219862). +* If certificate-based authentication is required for PostgreSQL connections, ensure that all necessary certificates are added before running the app. +* To test the connection and execute queries during design time, run your app locally. + ## Connect to the External Database ### Establish Connection Between the External Database and Mendix App @@ -66,7 +72,12 @@ Click **Save** to save the connection details, which are stored in 3 constants: For example: `*Database*_DBsource.` -{{% alert color="info" %}} Values for these constants are stored in the active configuration of the user. The password is stored as a private value.{{% /alert %}} +{{% alert color="info" %}} Values for these constants are stored in the active configuration of the user. The password is stored as a private value. + +Constants are an environment variable whose values can differ per environment, When you deploy an app on Mendix Cloud, values for constants are not added. For more information, see [Constants](https://docs.mendix.com/refguide/configuration/#constants){{% /alert %}} + +{{% alert color="info" %}} +For free apps, make sure to add the default values to the constant in Studio Pro. For more information, see the [Deploying a Free App](https://docs.mendix.com/developerportal/deploy/mendix-cloud-deploy/deploying-an-app/#deploy-free-app) section below. {{% /alert %}} ### Explore Schemas of a Connected Database