This is an automated email from the ASF dual-hosted git repository.
emaynard pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git
The following commit(s) were added to refs/heads/main by this push:
new 3614be523 Update metastores.md (#1537)
3614be523 is described below
commit 3614be5232e73e0cb37fa9f3f0303370c0f6ce9a
Author: Yufei Gu <[email protected]>
AuthorDate: Wed May 7 11:01:22 2025 -0700
Update metastores.md (#1537)
* Update metastores.md
* Resolve comment.
* Resolve comment.
---------
Co-authored-by: Yufei Gu <yufei.apache.org>
---
site/content/in-dev/unreleased/metastores.md | 21 ++++++++-------------
1 file changed, 8 insertions(+), 13 deletions(-)
diff --git a/site/content/in-dev/unreleased/metastores.md
b/site/content/in-dev/unreleased/metastores.md
index a8bff0d39..a21b4a89b 100644
--- a/site/content/in-dev/unreleased/metastores.md
+++ b/site/content/in-dev/unreleased/metastores.md
@@ -22,17 +22,10 @@ type: docs
weight: 700
---
-This page documents important configurations for connecting to a production
database through [EclipseLink](https://eclipse.dev/eclipselink/).
+This page explains how to configure and use Polaris metastores with either the
recommended Relational JDBC or the
+deprecated EclipseLink persistence backends.
-## Polaris EclipseLink
-
-Polaris includes EclipseLink plugin by default with PostgreSQL driver.
-
-In order to add other JDBC drivers, you have to build Polaris using the
`eclipseLinkDeps` build property.
-
-## Polaris Server Configuration
-
-### Relational JDBC
+## Relational JDBC
This implementation leverages Quarkus for datasource management and supports
configuration through
environment variables or JVM -D flags at startup. For more information, refer
to the [Quarkus configuration
reference](https://quarkus.io/guides/config-reference#env-file).
@@ -50,9 +43,11 @@ The Relational JDBC metastore currently relies on a
Quarkus-managed datasource a
Please refer to the documentation here:
[Configure data sources in Quarkus](https://quarkus.io/guides/datasource)
-### EclipseLink
+## EclipseLink (Deprecated)
> [!IMPORTANT] Eclipse link is deprecated, its recommend to use Relational
> JDBC as persistence instead.
+Polaris includes EclipseLink plugin by default with PostgreSQL driver.
+
Configure the `polaris.persistence` section in your Polaris configuration file
(`application.properties`) as follows:
@@ -79,7 +74,7 @@ Polaris creates and connects to a separate database for each
realm. Specifically
A single `persistence.xml` can describe multiple [persistence
units](https://eclipse.dev/eclipselink/documentation/4.0/concepts/concepts.html#APPDEV001).
For example, with both a `polaris-dev` and `polaris` persistence unit defined,
you could use a single `persistence.xml` to easily switch between development
and production databases. Use the `persistence-unit` option in the Polaris
server configuration to easily switch between persistence units.
-#### Using H2
+### Using H2
> [!IMPORTANT] H2 is an in-memory database and is not suitable for production!
@@ -122,7 +117,7 @@ java -Dpolaris.persistence.type=eclipse-link \
-jar quarkus/server/build/quarkus-app/quarkus-run.jar
```
-#### Using Postgres
+### Using Postgres
PostgreSQL is included by default in the Polaris server distribution.
