This is an automated email from the ASF dual-hosted git repository.
fanng pushed a commit to branch branch-0.7
in repository https://gitbox.apache.org/repos/asf/gravitino.git
The following commit(s) were added to refs/heads/branch-0.7 by this push:
new 6832d1c68 [MINOR] correct Iceberg multi catalog document (#5367)
6832d1c68 is described below
commit 6832d1c68f070d9133efe8ca394d16a54dd661a6
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Oct 30 21:13:36 2024 +0800
[MINOR] correct Iceberg multi catalog document (#5367)
### What changes were proposed in this pull request?
correct Iceberg multi catalog document, was refactored to
`static-config-provider`, `dynamic-config-provider`
### Why are the changes needed?
The name was refactored and polish document
### Does this PR introduce _any_ user-facing change?
no
### How was this patch tested?
just document
Co-authored-by: FANNG <[email protected]>
---
docs/iceberg-rest-service.md | 30 +++++++++++++++---------------
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/docs/iceberg-rest-service.md b/docs/iceberg-rest-service.md
index be2e1e060..0fd670c42 100644
--- a/docs/iceberg-rest-service.md
+++ b/docs/iceberg-rest-service.md
@@ -236,17 +236,17 @@ You could access the view interface if using JDBC backend
and enable `jdbc.schem
#### Multi catalog support
-The Gravitino Iceberg REST server supports multiple catalogs and offers a
configuration-based catalog management system.
+The Gravitino Iceberg REST server supports multiple catalogs, and you could
manage the catalog by different ways.
-| Configuration item | Description
| Default
value | Required | Since Version |
-|-------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------|----------|------------------|
-| `gravitino.iceberg-rest.catalog-provider` | Catalog provider class name, you
can develop a class that implements `IcebergTableOpsProvider` and add the
corresponding jar file to the Iceberg REST service classpath directory. |
`config-based-provider` | No | 0.7.0-incubating |
+| Configuration item | Description
|
Default value | Required | Since Version |
+|--------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|----------|------------------|
+| `gravitino.iceberg-rest.catalog-config-provider` | The className of catalog
configuration provider, Gravitino provides build-in `static-config-provider`
and `dynamic-config-provider`, you could also develop a custom class that
implements `apache.gravitino.iceberg.service.provider.IcebergConfigProvider`
and add the corresponding jar file to the Iceberg REST service classpath
directory. | `static-config-provider` | No | 0.7.0-incubating |
-##### Configuration based catalog provider
+##### Static catalog configuration provider
-When using a configuration based catalog provider, you can configure the
default catalog with `gravitino.iceberg-rest.catalog.<param name>=<value>`. For
specific catalogs, use the format `gravitino.iceberg-rest.catalog.<catalog
name>.<param name>=<value>`.
+The static catalog configuration provider retrieves the catalog configuration
from the configuration file of the Gravitino Iceberg REST server. You could
configure the default catalog with `gravitino.iceberg-rest.catalog.<param
name>=<value>`. For specific catalogs, use the format
`gravitino.iceberg-rest.catalog.<catalog name>.<param name>=<value>`.
-For instance, you can configure three different catalogs, the default catalog
and the specific `hive_backend` and `jdbc_backend` catalogs separately.
+For instance, you could configure three different catalogs, the default
catalog and the specific `hive_backend` and `jdbc_backend` catalogs separately.
```text
gravitino.iceberg-rest.catalog-backend = jdbc
@@ -281,19 +281,19 @@ You can access different catalogs by setting the `prefix`
to the specific catalo
...
```
-##### Gravitino server based catalog provider
+##### Dynamic catalog configuration provider
-When using a Gravitino server based catalog provider, you can leverage
Gravitino to support dynamic catalog management for the Iceberg REST server.
+The dynamic catalog configuration provider retrieves the catalog configuration
from the Gravitino server.
-| Configuration item | Description
| Default value | Required |
Since Version |
-|-------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|---------------|----------|------------------|
-| `gravitino.iceberg-rest.gravitino-uri` | The uri of
Gravitino server address, only worked if `catalog-provider` is
`gravitino-based-provider`. | (none)
| No | 0.7.0-incubating |
-| `gravitino.iceberg-rest.gravitino-metalake` | The metalake
name that `gravitino-based-provider` used to request to Gravitino, only worked
if `catalog-provider` is `gravitino-based-provider`. | (none) | No
| 0.7.0-incubating |
-| `gravitino.iceberg-rest.catalog-cache-eviction-interval-ms` | Catalog cache
eviction interval.
| 3600000 | No |
0.7.0-incubating |
+| Configuration item | Description
| Default value |
Required | Since Version |
+|-------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|----------|------------------|
+| `gravitino.iceberg-rest.gravitino-uri` | The uri of
Gravitino server address, only worked if `catalog-config-provider` is
`dynamic-config-provider`. | (none)
| No | 0.7.0-incubating |
+| `gravitino.iceberg-rest.gravitino-metalake` | The metalake
name that `dynamic-config-provider` used to request to Gravitino, only worked
if `catalog-config-provider` is `dynamic-config-provider`. | (none) | No
| 0.7.0-incubating |
+| `gravitino.iceberg-rest.catalog-cache-eviction-interval-ms` | Catalog cache
eviction interval.
| 3600000 | No
| 0.7.0-incubating |
```text
gravitino.iceberg-rest.catalog-cache-eviction-interval-ms = 300000
-gravitino.iceberg-rest.catalog-provider = gravitino-based-provider
+gravitino.iceberg-rest.catalog-config-provider = dynamic-config-provider
gravitino.iceberg-rest.gravitino-uri = http://127.0.0.1:8090
gravitino.iceberg-rest.gravitino-metalake = test
```
