Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/apache-hive-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ When using Gravitino authorization for Hive with Apache Ranger, see the [Authori

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `s3-access-key-id`, `s3-secret-access-key`, `oss-access-key-id`, and `oss-secret-access-key` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -103,7 +103,7 @@ The following table lists predefined schema properties for the Hive database. Ad

### Schema Operations

see [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations).
see [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations).

## Table

Expand Down Expand Up @@ -159,7 +159,7 @@ The following table lists the data types mapped from the Hive catalog to Graviti
| `uniontype` | `union` |

:::info
1. The data types other than listed above are mapped to Gravitino **[External Type](./manage-relational-metadata-using-gravitino.md#external-type)** that represents an unresolvable data type from the Hive catalog.
1. The data types other than listed above are mapped to Gravitino **[External Type](./tables-and-views.md#external-type)** that represents an unresolvable data type from the Hive catalog.
2. Using the `struct` data type with field comments will throw an error, as it does not work for Hive tables (see [HIVE-26593](https://issues.apache.org/jira/browse/HIVE-26593)).
:::

Expand Down
6 changes: 3 additions & 3 deletions docs/aws-glue-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Besides the [common catalog properties](./gravitino-server-config.md#catalog-pro

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `aws-access-key-id` and `aws-secret-access-key` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -70,7 +70,7 @@ The Glue catalog defines no predefined schema properties beyond `comment`. Addit

### Schema Operations

See [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations).
See [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations).

## Table

Expand Down Expand Up @@ -133,7 +133,7 @@ The following table lists the data types mapped from the Glue catalog to Graviti
| `uniontype` | `union` |

:::info
Data types not listed above map to Gravitino **[External Type](./manage-relational-metadata-using-gravitino.md#external-type)**, which represents an unresolvable data type from the Glue catalog.
Data types not listed above map to Gravitino **[External Type](./tables-and-views.md#external-type)**, which represents an unresolvable data type from the Glue catalog.
:::

### Table Properties
Expand Down
2 changes: 1 addition & 1 deletion docs/expression.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ import TabItem from '@theme/TabItem';

## Introduction

This page introduces the expression system of Apache Gravitino. Expressions are vital component of metadata definition, through expressions, you can define [default values](./manage-relational-metadata-using-gravitino.md#table-column-default-value) for columns, function arguments for [function partitioning](./table-partitioning-distribution-sort-order-indexes.md#table-partitioning), [bucketing](./table-partitioning-distribution-sort-order-indexes.md#table-distribution), and sort term of [sort ordering](./table-partitioning-distribution-sort-order-indexes.md#sort-ordering) in tables.
This page introduces the expression system of Apache Gravitino. Expressions are vital component of metadata definition, through expressions, you can define [default values](./tables-and-views.md#table-column-default-value) for columns, function arguments for [function partitioning](./table-partitioning-distribution-sort-order-indexes.md#table-partitioning), [bucketing](./table-partitioning-distribution-sort-order-indexes.md#table-distribution), and sort term of [sort ordering](./table-partitioning-distribution-sort-order-indexes.md#sort-ordering) in tables.
Gravitino expression system divides expressions into three basic parts: field reference, literal, and function. Function expressions can contain field references, literals, and other function expressions.

## Field Reference
Expand Down
6 changes: 3 additions & 3 deletions docs/jdbc-clickhouse-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ Catalog catalog =
</TabItem>
</Tabs>

See [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for other catalog operations.
See [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for other catalog operations.

## Schema

Expand Down Expand Up @@ -161,7 +161,7 @@ Schema schema = catalog.asTableCatalog()
</TabItem>
</Tabs>

See [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations) for more schema operations.
See [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations) for more schema operations.

## Table

Expand Down Expand Up @@ -199,7 +199,7 @@ See [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-us
| `BOOLEAN` | `Bool` |
| `UUID` | `UUID` |

Other ClickHouse types are exposed as [External Type](./manage-relational-metadata-using-gravitino.md#external-type).
Other ClickHouse types are exposed as [External Type](./tables-and-views.md#external-type).

### Table Properties

Expand Down
10 changes: 5 additions & 5 deletions docs/jdbc-doris-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Gravitino saves some system information in schema and table comments, like
- Gravitino catalog corresponds to the Doris instance.
- Supports metadata management of Doris (1.2.x, 3.0.x, 4.0.x).
- Supports table index (PRIMARY_KEY, UNIQUE_KEY, INVERTED, BITMAP (legacy), ANN/VECTOR).
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value).
- Supports [column default value](./tables-and-views.md#table-column-default-value).

### Catalog Properties

Expand Down Expand Up @@ -81,7 +81,7 @@ Returning null for DATETIME type precision. Driver version: mysql-connector-java

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -102,15 +102,15 @@ Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden
### Schema Operations

Refer to
[Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations) for more details.
[Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations) for more details.

## Table

### Table Capabilities

- Gravitino's table concept corresponds to the Doris table.
- Supports index.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value).
- Supports [column default value](./tables-and-views.md#table-column-default-value).

#### Table Column Types

Expand Down Expand Up @@ -139,7 +139,7 @@ Refer to
| `ExternalType("hll")` | `HLL` |

Doris doesn't support Gravitino `Fixed` `Timestamp_tz` `IntervalDay` `IntervalYear` `Union` `UUID` type.
The data types other than those listed above are mapped to Gravitino's **[Unparsed Type](./manage-relational-metadata-using-gravitino.md#unparsed-type)** that represents an unresolvable data type.
The data types other than those listed above are mapped to Gravitino's **[Unparsed Type](./tables-and-views.md#unparsed-type)** that represents an unresolvable data type.

:::note
Doris `array`, `map`, and `struct` types are loaded as `ExternalType` with the full type string preserved (e.g. `array<int(11)>`). They are not resolved into Gravitino native composite types (`ListType`, `MapType`, `StructType`). The type identifier in `ExternalType` is always lowercase (e.g. `"json"`, not `"JSON"`), matching Doris JDBC metadata behavior.
Expand Down
14 changes: 7 additions & 7 deletions docs/jdbc-hologres-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,10 @@ Gravitino saves some system information in schema and table comment, like `(From
- Supports metadata management of Hologres.
- Supports DDL operation for Hologres schemas and tables.
- Supports table index (PRIMARY KEY in CREATE TABLE).
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value).
- Supports [column default value](./tables-and-views.md#table-column-default-value).
- Supports LIST partitioning (physical and logical partition tables).
- Supports Hologres-specific table properties via `WITH` clause (orientation, clustering_key, distribution_key, etc.).
- Does not support [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment).
- Does not support [auto-increment](./tables-and-views.md#table-column-auto-increment).

### Catalog Properties

Expand All @@ -59,7 +59,7 @@ Hologres uses the PostgreSQL JDBC Driver (version 42.3.2 or later recommended).

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -80,7 +80,7 @@ Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden

### Schema Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations) for more details.

## Table

Expand All @@ -89,10 +89,10 @@ Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metada
- Gravitino's table concept corresponds to the Hologres table.
- Supports DDL operation for Hologres tables.
- Supports PRIMARY KEY index in CREATE TABLE.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value).
- Supports [column default value](./tables-and-views.md#table-column-default-value).
- Supports expression columns via DEFAULT expressions (note: Gravitino maps these as column default values, not as true generated/computed columns in the Hologres sense).
- Supports LIST partitioning (physical and logical).
- Does not support [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment). Creating auto-increment columns is rejected in both CREATE TABLE and ALTER TABLE.
- Does not support [auto-increment](./tables-and-views.md#table-column-auto-increment). Creating auto-increment columns is rejected in both CREATE TABLE and ALTER TABLE.

### Table Properties

Expand Down Expand Up @@ -145,7 +145,7 @@ Hologres-specific table properties are set via the `WITH` clause during CREATE T
:::info
- Hologres does not support precision syntax for `TIMESTAMP`/`TIMESTAMPTZ` (e.g., `timestamptz(6)` is invalid), so the type converter always emits the base type without precision.
- Array element types must be non-nullable (Hologres limitation). Multidimensional arrays are not supported.
- Types like `json`, `jsonb`, `uuid`, `inet`, `money`, `roaringbitmap` are mapped to Gravitino **[External Type](./manage-relational-metadata-using-gravitino.md#external-type)** with the original type name preserved.
- Types like `json`, `jsonb`, `uuid`, `inet`, `money`, `roaringbitmap` are mapped to Gravitino **[External Type](./tables-and-views.md#external-type)** with the original type name preserved.
:::

### Table Distribution
Expand Down
10 changes: 5 additions & 5 deletions docs/jdbc-mysql-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Gravitino saves some system information in schema and table comment, like `(From
- Supports metadata management of MySQL (5.7, 8.0).
- Supports DDL operation for MySQL databases and tables.
- Supports table index.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value) and [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment).
- Supports [column default value](./tables-and-views.md#table-column-default-value) and [auto-increment](./tables-and-views.md#table-column-auto-increment).
- Supports managing MySQL table features through table properties, like using `engine` to set MySQL storage engine.

### Catalog Properties
Expand Down Expand Up @@ -84,7 +84,7 @@ Returning null for TIMESTAMP type precision. Driver version: mysql-connector-jav

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -105,7 +105,7 @@ Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden

### Schema Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations) for more details.

## Table

Expand All @@ -114,7 +114,7 @@ Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metada
- Gravitino's table concept corresponds to the MySQL table.
- Supports DDL operation for MySQL tables.
- Supports index.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value) and [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment)..
- Supports [column default value](./tables-and-views.md#table-column-default-value) and [auto-increment](./tables-and-views.md#table-column-auto-increment)..
- Supports managing MySQL table features through table properties, like using `engine` to set MySQL storage engine.

### Table Column Types
Expand Down Expand Up @@ -144,7 +144,7 @@ Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metada

:::info
MySQL doesn't support Gravitino `Fixed` `Struct` `List` `Map` `IntervalDay` `IntervalYear` `Union` `UUID` type.
Meanwhile, the data types other than listed above are mapped to Gravitino **[External Type](./manage-relational-metadata-using-gravitino.md#external-type)** that represents an unresolvable data type.
Meanwhile, the data types other than listed above are mapped to Gravitino **[External Type](./tables-and-views.md#external-type)** that represents an unresolvable data type.
:::

### Table Column Auto-Increment
Expand Down
10 changes: 5 additions & 5 deletions docs/jdbc-oceanbase-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Apache Gravitino provides the ability to manage OceanBase metadata.
- Supports metadata management of OceanBase (4.x).
- Supports DDL operation for OceanBase databases and tables.
- Supports table index.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value) and [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment).
- Supports [column default value](./tables-and-views.md#table-column-default-value) and [auto-increment](./tables-and-views.md#table-column-auto-increment).

### Catalog Properties

Expand Down Expand Up @@ -84,7 +84,7 @@ Returning null for TIMESTAMP type precision. Driver version: mysql-connector-jav

### Catalog Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#catalog-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#catalog-operations) for more details.

:::note
Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden from the load catalog response. Use the [credential vending API](security/credential-vending.md) to retrieve them at runtime.
Expand All @@ -105,7 +105,7 @@ Sensitive catalog properties such as `jdbc-user` and `jdbc-password` are hidden

### Schema Operations

Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metadata-using-gravitino.md#schema-operations) for more details.
Refer to [Manage Catalogs and Schemas](./manage-catalogs-and-schemas.md#schema-operations) for more details.

## Table

Expand All @@ -114,7 +114,7 @@ Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metada
- Gravitino's table concept corresponds to the OceanBase table.
- Supports DDL operation for OceanBase tables.
- Supports index.
- Supports [column default value](./manage-relational-metadata-using-gravitino.md#table-column-default-value) and [auto-increment](./manage-relational-metadata-using-gravitino.md#table-column-auto-increment)..
- Supports [column default value](./tables-and-views.md#table-column-default-value) and [auto-increment](./tables-and-views.md#table-column-auto-increment)..

### Table Properties

Expand Down Expand Up @@ -146,7 +146,7 @@ Refer to [Manage Relational Metadata Using Gravitino](./manage-relational-metada

:::info
OceanBase doesn't support Gravitino `Boolean` `Fixed` `Struct` `List` `Map` `IntervalDay` `IntervalYear` `Union` `UUID` type.
Meanwhile, the data types other than listed above are mapped to Gravitino **[External Type](./manage-relational-metadata-using-gravitino.md#external-type)** that represents an unresolvable data type.
Meanwhile, the data types other than listed above are mapped to Gravitino **[External Type](./tables-and-views.md#external-type)** that represents an unresolvable data type.
:::

### Table Column Auto-Increment
Expand Down
Loading
Loading