diff --git a/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md b/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md index cc85c9aa2a73d8614e185400cc33c279ba5a11dd..f2e2164f00812c74eb183d29ebeb42306d41bbd3 100644 --- a/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md +++ b/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md @@ -17,17 +17,11 @@ Prometheus exporter for openGauss server metrics.
-## Limit - -- openGauss Password authentication method must be md5 - -
- ## Quick Start This package is available for Docker: -```bash +``` # Start an example database docker run --net=host -it --rm -e GS_PASSWORD=mtkOP@128 enmotech/opengauss # Connect to it @@ -38,23 +32,11 @@ docker run --net=host -e DATA_SOURCE_NAME="postgresql://postgres:password@localh ## Building and running -### github - -The default make file behavior is to build the binary: - -```bash -go get github.com/enmotech/opengauss_exporter -cd ${GOPATH-$HOME/go}/src/github.com/enmotech/opengauss_exporter -make build -export DATA_SOURCE_NAME="postgresql://login:password@hostname:port/dbname" -./bin/opengauss_exporter -``` - ### gitee The default make file behavior is to build the binary: -```bash +``` go get gitee.com/enmotech/opengauss_exporter cd ${GOPATH-$HOME/go}/src/gitee.com/enmotech/opengauss_exporter make build @@ -123,7 +105,7 @@ In addition, the option `--exclude-databases` adds the possibily to filter the r ### run test -```bash +``` make build cd test;sh test.sh ../bin/opengauss_exporter ``` @@ -140,7 +122,7 @@ grant select on pg_stat_replication to dbuser_monitor; ### primary and standby -```bash +``` docker network create opengauss_network --subnet=172.11.0.0/24 docker run --network opengauss_network --ip 172.11.0.101 \ --privileged=true --name opengauss_primary -h opengauss_primary -p 1111:5432 -d \ diff --git a/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md b/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md index 868e5e05e2a5f0a7263ef8fe025aeb64a2eaf57c..cf4fa7b631183ddd2b60d4792e6a59a636664fac 100644 --- a/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md +++ b/product/en/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md @@ -7,14 +7,6 @@ date: 2021-07-14 # compat-tools -## How to Get the Component - - - -
- -## Introduction - This project is a set of compatibility tools. It aims to provide compatibility for necessary functions and system views created for OSs migrated from other asynchronous databases to MogDB, thereby facilitating the follow-up system maintenance and application modification. The script is executed based on the version information. When you execute the script, it will be executed in terms of the following three situations: @@ -23,404 +15,4 @@ The script is executed based on the version information. When you execute the sc 2. If the version of the object to be created is later than that of the object in the target database, the target database will be upgraded and has the object re-created. 3. If the version of the object to be created is earlier than that of the object in the target database, the creation operation will be skipped. -
- -## Software Architecture - -SQL file - -- runMe.sql: Total scheduling script -- Oracle_Views.sql: Compatible with Oracle database compatibility data dictionaries and views -- Oracle_Functions.sql: Compatible with Oracle database compatibility functions -- Oracle_Packages.sql: Compatible with Oracle database management packages -- MySQL_Views.sql: Compatible with MySQL database compatibility data dictionaries and views //TODO -- MySQL_Functions.sql: Compatible with MySQL database compatibility functions -- DB2_Functions.sql: DB2 database compatibility functions - -
- -## Usage Description - -Execute the SQL script in the MogDB database. - -> Note: All the following actions need to be executed in the directory where the current script is located. - -### Creating All Compatibility Objects - -Create all compatibility objects, including views, functions, management packages, and other objects. - -```bash -# Log in to the default database as a local user. -gsql -f runMe.sql - -# Detailed creation syntax: Pay attention to the test user's permission (the user needs to have the sysadmin permission). -gsql -h 127.0.0.1 -p 5432 -U test -d postgres -f runMe.sql -``` - -### Creating a Single Compatibility Object - -The following uses the Oracle compatibility view as an example. For other compatibility objects, the following method also applies. - -```bash -# Log in to the default database as a local user. -gsql -f Oracle_Views.sql - -# Detailed creation syntax: Pay attention to the test user's permission (the user needs to have the sysadmin permission). -gsql -h 127.0.0.1 -p 5432 -U test -d postgres -f Oracle_Views.sql -``` - -
- -## Results Description - -At the end of script execution, the following two types of content are automatically output. - -1. The compatibility objects involved in this script, and the corresponding operation contents - - ```bash - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: -- Compat Object List: - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: | type | name | version | language | operation | - gsql:Oracle_Functions.sql:1035: NOTICE: |-----------|--------------------------------------------------|---------|----------|---------------------| - gsql:Oracle_Functions.sql:1035: NOTICE: | function | months_between(timestamptz,timestamptz) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | sys_guid() | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | aggregate | wm_concat(text) | 1.0 | internal | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | nvl2(anyelement,anyelement,anyelement) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | trunc(timestamp,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | trunc(timestamptz,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | nanvl(numeric,numeric) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_substr(text,text,int4) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_substr(text,text,int4,int4,text,int4) | 2.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_instr(text,text,int4,int4,int4,text,int4) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_replace(text,text,text,int4,int4,text) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_count(text,text,int4,text) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | replace(text,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | ora_hash(anyelement,int4,int4) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | show(text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | show_parameter(text) | 1.0 | sql | Skip due to version | - ``` - -2. Summary of the runs of the test cases built into this script - - Make sure that all test cases are up to date and that there are no test cases of type `FAILED`. - - ```bash - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: -- Function Test Result: - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: | result_type | case_count | start_time | complete_time | - gsql:Oracle_Functions.sql:1035: NOTICE: |-------------|------------|----------------------------|----------------------------| - gsql:Oracle_Functions.sql:1035: NOTICE: | PASSED | 387 | 2021-11-25 09:42:20.016619 | 2021-11-25 09:42:52.127892 | - gsql:Oracle_Functions.sql:1035: NOTICE: | NULL | 6 | 2021-11-25 09:42:20.016619 | 2021-11-25 09:42:20.016619 | - ``` - -### Query the Created Compatibility Objects and Versions - -```sql -select * from compat_tools.compat_version; -``` - -### Query Test Case Details - -```sql -select * from compat_tools.compat_testing; -``` - -
- -## Oracle Compatibility Views - -Oracle_Views.sql includes the following Oracle compatibility views: - -### Management Views: ALL_\*, DBA_\*, USER_\* - -> `ALL_` views are consistent with `DBA_` views, which are not verified with permission. In later versions, permission check will be performed. - -- [DBA,ALL,USER]_CATALOG -- [DBA,ALL,USER]_CONS_COLUMNS -- [DBA,ALL,USER]_CONSTRAINTS -- [DBA,ALL,USER]_DATA_FILES -- [DBA,ALL,USER]_DEPENDENCIES -- [DBA,ALL,USER]_IND_COLUMNS -- [DBA,ALL,USER]_IND_PARTITIONS -- [DBA,ALL,USER]_IND_STATISTICS -- [DBA,ALL,USER]_INDEX_USAGE -- [DBA,ALL,USER]_INDEXES -- [DBA,ALL,USER]_OBJECTS -- [DBA,ALL,USER]_PART_INDEXES -- [DBA,ALL,USER]_PART_TABLES -- [DBA,ALL,USER]_PROCEDURES -- [DBA,ALL,USER]_SEGMENTS -- [DBA,ALL,USER]_SEQUENCES -- [DBA,ALL,USER]_SOURCE -- [DBA,ALL,USER]_SYNONYMS -- [DBA,ALL,USER]_TAB_COL_STATISTICS -- [DBA,ALL,USER]_TAB_COLS -- [DBA,ALL,USER]_TAB_COLUMNS -- [DBA,ALL,USER]_TAB_COMMENTS -- [DBA,ALL,USER]_TAB_MODIFICATIONS -- [DBA,ALL,USER]_TAB_PARTITIONS -- [DBA,ALL,USER]_TAB_STATISTICS -- [DBA,ALL,USER]_TABLES -- [DBA,ALL,USER]_TABLESPACES -- [DBA,ALL,USER]_TRIGGER_COLS -- [DBA,ALL,USER]_TRIGGERS -- [DBA,ALL,USER]_TYPES -- [DBA,ALL,USER]_VIEWS -- [DBA,ALL,USER]_JOBS -- [DBA,ALL,USER]_JOBS_RUNNING -- [DBA,ALL]_USERS -- DBA_SOURCE_ALL -- NLS_DATABASE_PARAMETERS -- NLS_INSTANCE_PARAMETERS -- NLS_SESSION_PARAMETERS - -### Other Short-Name Views - -- DICTIONARY -- DICT -- COLS -- IND -- OBJ -- TAB -- DUAL (For 2.0 and above) - -### Dynamic Performance Views: GV,V - -- [GV,V]$DATAFILE -- [GV,V]$LOCK -- [GV,V]$PARAMETER -- [GV,V]$PARAMETER_VALID_VALUES -- [GV,V]$SESSION -- [GV,V]$SESSTAT -- [GV,V]$SPPARAMETER -- [GV,V]$SYSSTAT -- [GV,V]$TABLESPACE -- [GV,V]$VERSION -- [GV,V]$NLS_PARAMETERS -- [GV,V]$NLS_VALID_VALUES - -### Views of Unified Permission Query - -- DBA_DETAIL_PRIVILEGES -- DBA_ALL_PRIVILEGES -- DBA_ALL_PRIVILEGES_SQL - -
- -## Oracle Compatibility Functions - -### Character Functions - -- regexp_substr(text,text,int4) -- regexp_substr(text,text,int4,int4,text,int4) -- Note: The **p_subexpr** parameter is not supported. -- regexp_instr(text,text,int4,int4,text,int4) -- regexp_replace(text,text,text,int4,int4,text) -- regexp_count(text,text,int4,text) -- replace(text,text) - -### Time Functions - -- months_between(timestamp, timestamp) -- trunc(timestamp, text) -- trunc(timestamptz, text) -- round(timestamptz,text) - -### Number Functions - -- nanvl(numeric,numeric) - -### Aggregate Functions - -- wm_concat(text) - -### NULL-Related Functions - -- nullif(anyelement, anyelement) -- nvl2(anyelement, anyelement, anyelement) - -### Other Functions - -- sys_guid() -- ora_hash(anyelement,bigint,bigint) -- show(text) - provides functions similar to "show xxx" in Oracle for viewing related parameters. -- show_parameter(text) - provides functions as show(text) -- dump(anynonarray) - -
- -## Oracle Management Packages - -### DBMS_METADATA - -- get_ddl(object_type, object_name, schema_name) - -### DBMS_OUTPUT - -- enable(size) -- disable() -- get_line(line, status) -- get_lines(lines, numlines) -- new_line() -- put(text) -- put_line(text) - -### DBMS_RANDOM - -- initialize(int4) -- deprecated in Oracle -- normal() -- random() -- deprecated in Oracle -- seed(int4) -- seed(text) -- string(char,int4) -- terminate() -- deprecated in Oracle -- value() -- value(numeric,numeric) - -For details about how to use DBMS_RANDOM to generate random data (number, string, and date), see [DBMS_RANDOM](DBMS-RANDOM). - -### DBMS_JOB - -- broken(int8,bool,timestamp) -- change(int8,text,timestamp,text,int4,bool) -- instance(int8,int4,bool) -- interval(int8,text) -- next_date(int8,timestamp) -- remove(int8) -- run(int8,bool) -- submit(int8,text,timestamp,text,bool,int4,bool) -- user_export(int8,text) -- what(int8,text) - -
- -## MySQL Compatibility Functions - -### NULL-Related Functions - -> Note: The effect of **ifnull** is equivalent to the general function **coalesce**. If conditions allow, it is recommended to modify SQL to use the **coalesce** function, which is supported in almost all databases. - -- ifnull(text,text) -- ifnull(numeric,numeric) -- ifnull(timestamp,timestamp) -- ifnull(timestamptz,timestamptz) -- isnull(text) -- Note: If the default **A** compatibility mode is used when creating the database in MogDB, then the **''** empty string will also be recognized as a **NULL** value -- isnull(numeric) -- isnull(timestamptz) - -### Condition Control Functions - -- if(bool,text,text) -- if(bool,numeric,numeric) -- if(bool,timestamptz,timestamptz) - -### Character Functions - -- find_in_set(text,text) -- find_in_set(text,text[]) -- field(text,text[]) -- elt(int4,text[]) -- strcmp(text,text) -- insert(text,int8,int8,text) -- lcase(text) -- ucase(text) -- space(int4) -- mid(text,int8,int8) -- locate(text,text,int4) -- to_base64(text) -- from_base64(text) - -### Numerical Functions - -- field(numeric,numeric[]) -- log10(numeric) -- log10(float8) -- rand(int4) - -### Time Functions - -- unix_timestamp(timestamp) -- unix_timestamp(timestamptz) -- from_unixtime(int8) -- from_unixtime(numeric) -- from_unixtime(numeric,text) -- to_days(timestamp) -- to_seconds(timestamp) -- to_seconds(timestamptz) -- timediff(timestamptz,timestamptz) -- time_to_sec(time) -- sec_to_time(int4) -- date_format(timestamp, text) -- date_format(timestamptz, text) -- timestampdiff(text,timestamptz,timestamptz) -- Note: The Schema prefixed with **pg_catalog.** must be used, and the first unit parameter must be wrapped in single quotes -- str_to_date(text,text) -- Due to the difference in time types between MySQL and MogDB, this compatible function is not completely compatible. For details, please refer to the use case description section at the end of the corresponding function. - -### Other Functions - -- uuid() -- Provide hash calculation uuid based on random value + timestamp -- uuid_to_bin(uuid, int4) -- bin_to_uuid(bytea, int4) - -
- -## DB2 Compatibility Functions - -### NULL-Related Functions - -> Note: The effect of **value** is equivalent to the general function **coalesce**. If conditions allow, it is recommended to modify SQL to use the **coalesce** function, which is supported in almost all databases. - -- value(text,text) -- value(numeric,numeric) -- value(timestamp,timestamp) -- value(timestamptz,timestamptz) - -### Character Functions - -- posstr(text,text) -- locate_in_string(text,text,int4,int4,text) -- regexp_match_count(text,text,int4,text,text) - -### Time Functions - -- year (text) -- year (timestamptz) -- year (interval) -- month (text) -- month (timestamptz) -- month (interval) -- quarter (timestamptz) -- week (timestamptz) -- day (text) -- day (timestamptz) -- day (interval) -- hour (text) -- hour (timestamptz) -- hour (interval) -- minute (text) -- minute (timestamptz) -- minute (interval) -- second (text) -- second (timestamptz) -- second (interval) -- days (timestamptz) -- dayofyear (timestamptz) -- dayofweek (timestamptz) -- dayofweek_iso (timestamptz) -- dayname (timestamptz) -- monthname (timestamptz) -- midnight_seconds (timestamptz) -- next_day (timestamptz,text,text) -- next_month (timestamptz) -- next_quarter (timestamptz) -- next_week (timestamptz) -- next_year (timestamptz) -- last_day (timestamptz) -- first_day (timestamptz) -- this_month (timestamptz) -- this_quarter (timestamptz) -- this_week (timestamptz) -- this_year (timestamptz) -- days_between (timestamptz,timestamptz) -- years_between (timestamptz,timestamptz) -- ymd_between (timestamptz,timestamptz) +Please refer to [compat-tools repository page](https://gitee.com/enmotech/compat-tools) for details on how to obtain and use component. diff --git a/product/en/docs-mogdb/v2.1/quick-start/container-based-installation.md b/product/en/docs-mogdb/v2.1/quick-start/container-based-installation.md index 4c5e639fbc8cc6f0e213a69926f4dc04867e5c09..fef49cd8aa7cca19a41a4514001eed6a061bd3eb 100644 --- a/product/en/docs-mogdb/v2.1/quick-start/container-based-installation.md +++ b/product/en/docs-mogdb/v2.1/quick-start/container-based-installation.md @@ -189,7 +189,7 @@ MogDB=#\dt MogDB=# ``` -For detailed introduction and query example of mogila sample dataset, please refer to [sample dataset: Mogila](mogila). +For detailed introduction and query example of mogila sample dataset, please refer to [Using Sample Dataset Mogila](mogila).
diff --git a/product/en/docs-mogdb/v2.1/quick-start/mogila.md b/product/en/docs-mogdb/v2.1/quick-start/mogila.md index 678da5adb8826dea794f8ec88b090363fed1f8c5..1c58de7e13d4531a04cd662c109bbf7f632ac303 100644 --- a/product/en/docs-mogdb/v2.1/quick-start/mogila.md +++ b/product/en/docs-mogdb/v2.1/quick-start/mogila.md @@ -1,13 +1,13 @@ --- -title: Sample Dataset Mogila -summary: Sample Dataset Mogila +title: Using Sample Dataset Mogila +summary: Using Sample Dataset Mogila author: Guo Huan date: 2022-02-11 --- -# Sample Dataset: Mogila +# Using Sample Dataset Mogila MogDB provides a sample dataset Mogila, which is a database representing a DVD rental store (remember those?!), containing information about films (like title, category, actresses), rental stores (like address, staff members, customers) and rentals @@ -53,7 +53,7 @@ The image below shows an overview of the Mogila database tables and views. Here gsql ((MogDB 2.1.0 build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + mogila=# \dt List of relations Schema | Name | Type | Owner | Storage @@ -74,7 +74,7 @@ The image below shows an overview of the Mogila database tables and views. Here public | staff | table | mogdb | {orientation=row,compression=no} public | store | table | mogdb | {orientation=row,compression=no} (15 rows) - + mogila=# ``` @@ -133,7 +133,7 @@ The image below shows an overview of the Mogila database tables and views. Here gsql ((MogDB 2.1.0 build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + mogila=# \dt List of relations Schema | Name | Type | Owner | Storage @@ -154,7 +154,7 @@ The image below shows an overview of the Mogila database tables and views. Here public | staff | table | mogdb | {orientation=row,compression=no} public | store | table | mogdb | {orientation=row,compression=no} (15 rows) - + mogila=# ``` diff --git a/product/en/docs-mogdb/v2.1/source-code-parsing.md b/product/en/docs-mogdb/v2.1/source-code-parsing.md index 1efbcbd254ef01a3c6c775c41fe2918c686a0ab3..61707aaddeded8d886bab124490ec61fda2c589c 100644 --- a/product/en/docs-mogdb/v2.1/source-code-parsing.md +++ b/product/en/docs-mogdb/v2.1/source-code-parsing.md @@ -60,3 +60,5 @@ You can click the links below to view this series of articles. [openGauss database source code parsing series of articles - AI Technology (Part 3): Index Recommendation](https://www.modb.pro/db/210235) [openGauss database source code parsing series of articles - AI Technology (Part 4): Metrics Collection, Prediction, and Anomaly Detection](https://www.modb.pro/db/245341) + +[openGauss database source code parsing series of articles - AI Technology (Part 5): AI Query Time Prediction](https://www.modb.pro/db/251405) \ No newline at end of file diff --git a/product/en/docs-mogdb/v2.1/toc.md b/product/en/docs-mogdb/v2.1/toc.md index f01e3bebafda55e7301327021dbe6fd46770fa44..7001bf96d497f57841047c143479d1c958b7412d 100644 --- a/product/en/docs-mogdb/v2.1/toc.md +++ b/product/en/docs-mogdb/v2.1/toc.md @@ -32,7 +32,7 @@ + Use Middleware to Access MogDB + [Use WebLogic to Configure MogDB Data Sources](/quick-start/mogdb-access/use-middleware-to-access-mogdb/weblogic-configures-mogdb(postgresql)-data-source-reference.md) + [Use WebSphere to Configure MogDB Data Sources](/quick-start/mogdb-access/use-middleware-to-access-mogdb/websphere-configures-mogdb(postgresql)-data-source-reference.md) - + [Sample Dataset: Mogila](/quick-start/mogila.md) + + [Using Sample Dataset Mogila](/quick-start/mogila.md) + Installation Guide + [Container Installation](/installation-guide/docker-installation/docker-installation.md) + Simplified Installation Process diff --git a/product/en/docs-mogdb/v2.1/toc_quickstart.md b/product/en/docs-mogdb/v2.1/toc_quickstart.md index 8611ae4e82b2146d99e75109e588ac88b2546a09..b67333a914516a0437cf9912dfe7c912deda29a3 100644 --- a/product/en/docs-mogdb/v2.1/toc_quickstart.md +++ b/product/en/docs-mogdb/v2.1/toc_quickstart.md @@ -12,4 +12,4 @@ + Use Middleware to Access MogDB + [Use WebLogic to Configure MogDB Data Sources](/quick-start/mogdb-access/use-middleware-to-access-mogdb/weblogic-configures-mogdb(postgresql)-data-source-reference.md) + [Use WebSphere to Configure MogDB Data Sources](/quick-start/mogdb-access/use-middleware-to-access-mogdb/websphere-configures-mogdb(postgresql)-data-source-reference.md) -+ [Sample Dataset: Mogila](/quick-start/mogila.md) ++ [Using Sample Dataset Mogila](/quick-start/mogila.md) diff --git a/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md b/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md index 9ef02c108a82fb71eae128ee23b1233691fa9611..82c8b64e332ae8bf8fef5f39d70d91cfd1b7b243 100644 --- a/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md +++ b/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/4-mogdb&opengauss-exporter-for-prometheus.md @@ -17,12 +17,6 @@ date: 2021-06-02
-## 限制 - -- openGauss密码认证方式必须为md5 - -
- ## 快速开始 本软件包适用于Docker： @@ -38,18 +32,6 @@ docker run --net=host -e DATA_SOURCE_NAME="postgresql://postgres:password@localh ## 构建及运行 -### github - -make命令默认构建二进制文件： - -``` -$ go get github.com/enmotech/opengauss_exporter -$ cd ${GOPATH-$HOME/go}/src/github.com/enmotech/opengauss_exporter -$ make build -$ export DATA_SOURCE_NAME="postgresql://login:password@hostname:port/dbname" -$ ./bin/opengauss_exporter -``` - ### gitee make命令默认构建二进制文件： diff --git a/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md b/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md index 09124ff8dfec959c4088565f50208406358f5612..476083231ffc5bbde6ef7978b931fadd336d8f04 100644 --- a/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md +++ b/product/zh/docs-mogdb/v2.1/about-mogdb/open-source-components/compat-tools.md @@ -7,14 +7,6 @@ date: 2021-07-14 # compat-tools -## 组件获取 - - - -
- -## 介绍 - 本项目是一个兼容工具集合，旨在为从其他异构数据库，迁移到 MogDB 之后的系统，创建必要的函数，以及系统视图的兼容。为后续的系统运维与应用改造提供便利。 脚本中带有版本控制，直接运行脚本时，会根据如下三种情况进行处理： @@ -23,404 +15,4 @@ date: 2021-07-14 2. 若待创建对象版本高于目标数据库中的对象版本，则进行升级重建 3. 若待创建对象版本不高于目标数据库中的对象版本，则跳过创建 -
- -## 软件架构 - -SQL文件： - -* runMe.sql: 总调度脚本 -* Oracle_Views.sql: Oracle数据库兼容性数据字典及视图 -* Oracle_Functions.sql: Oracle数据库兼容性函数 -* Oracle_Packages.sql: Oracle数据库管理包兼容 -* MySQL_Views.sql: MySQL数据库兼容性数据字典及视图 //TODO -* MySQL_Functions.sql: MySQL数据库兼容性函数 -* DB2_Functions.sql: DB2数据库兼容性函数 - -
- -## 使用说明 - -直接在MogDB数据库中执行sql文本。 - -> 注意：以下所有操作需要在当前脚本所在的目录中执行。 - -### 创建所有兼容性对象 - -创建所有兼容性对象，包括：视图，函数，管理包等。 - -``` -# 本地用户，默认库登录 -gsql -f runMe.sql - -# 详细创建语法，注意 test 用户权限（需要具有 sysadmin 权限） -gsql -h 127.0.0.1 -p 5432 -U test -d postgres -f runMe.sql -``` - -### 创建单一类兼容对象 - -以下以 Oracle 兼容性视图为例，其他兼容性对象脚本，也可以以此方式创建。 - -``` -# 本地用户，默认库登录 -gsql -f Oracle_Views.sql - -# 详细创建语法，注意 test 用户权限（需要具有 sysadmin 权限） -gsql -h 127.0.0.1 -p 5432 -U test -d postgres -f Oracle_Views.sql -``` - -
- -## 结果说明 - -脚本运行结束后，会自动输出以下两类内容： - -1. 本次脚本中涉及到的兼容对象，以及对应的操作内容 - - ``` - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: -- Compat Object List: - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: | type | name | version | language | operation | - gsql:Oracle_Functions.sql:1035: NOTICE: |-----------|--------------------------------------------------|---------|----------|---------------------| - gsql:Oracle_Functions.sql:1035: NOTICE: | function | months_between(timestamptz,timestamptz) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | sys_guid() | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | aggregate | wm_concat(text) | 1.0 | internal | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | nvl2(anyelement,anyelement,anyelement) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | trunc(timestamp,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | trunc(timestamptz,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | nanvl(numeric,numeric) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_substr(text,text,int4) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_substr(text,text,int4,int4,text,int4) | 2.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_instr(text,text,int4,int4,int4,text,int4) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_replace(text,text,text,int4,int4,text) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | regexp_count(text,text,int4,text) | 2.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | replace(text,text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | ora_hash(anyelement,int4,int4) | 1.0 | plpgsql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | show(text) | 1.0 | sql | Skip due to version | - gsql:Oracle_Functions.sql:1035: NOTICE: | function | show_parameter(text) | 1.0 | sql | Skip due to version | - ``` - -2. 本次脚本中内置的测试用例的运行汇总 - - 确认所有测试用例都是最新执行，并且没有类型为 `FAILED` 的测试用例即可。 - - ``` - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: -- Function Test Result: - gsql:Oracle_Functions.sql:1035: NOTICE: -- ===================================================================== - gsql:Oracle_Functions.sql:1035: NOTICE: | result_type | case_count | start_time | complete_time | - gsql:Oracle_Functions.sql:1035: NOTICE: |-------------|------------|----------------------------|----------------------------| - gsql:Oracle_Functions.sql:1035: NOTICE: | PASSED | 387 | 2021-11-25 09:42:20.016619 | 2021-11-25 09:42:52.127892 | - gsql:Oracle_Functions.sql:1035: NOTICE: | NULL | 6 | 2021-11-25 09:42:20.016619 | 2021-11-25 09:42:20.016619 | - ``` - -### 查询已创建的兼容对象及版本 - -```sql -select * from compat_tools.compat_version; -``` - -### 查询测试用例详情 - -```sql -select * from compat_tools.compat_testing; -``` - -
- -## Oracle 兼容视图 - -Oracle_Views.sql 包含如下几类 Oracle 兼容性视图： - -### 管理视图： ALL_\*, DBA_\*, USER_\* - -> `ALL_` 视图当前与 `DBA_` 视图一致，并未做权限检验，后期版本将会考虑权限校验。 - -* [DBA,ALL,USER]_CATALOG -* [DBA,ALL,USER]_CONS_COLUMNS -* [DBA,ALL,USER]_CONSTRAINTS -* [DBA,ALL,USER]_DATA_FILES -* [DBA,ALL,USER]_DEPENDENCIES -* [DBA,ALL,USER]_IND_COLUMNS -* [DBA,ALL,USER]_IND_PARTITIONS -* [DBA,ALL,USER]_IND_STATISTICS -* [DBA,ALL,USER]_INDEX_USAGE -* [DBA,ALL,USER]_INDEXES -* [DBA,ALL,USER]_OBJECTS -* [DBA,ALL,USER]_PART_INDEXES -* [DBA,ALL,USER]_PART_TABLES -* [DBA,ALL,USER]_PROCEDURES -* [DBA,ALL,USER]_SEGMENTS -* [DBA,ALL,USER]_SEQUENCES -* [DBA,ALL,USER]_SOURCE -* [DBA,ALL,USER]_SYNONYMS -* [DBA,ALL,USER]_TAB_COL_STATISTICS -* [DBA,ALL,USER]_TAB_COLS -* [DBA,ALL,USER]_TAB_COLUMNS -* [DBA,ALL,USER]_TAB_COMMENTS -* [DBA,ALL,USER]_TAB_MODIFICATIONS -* [DBA,ALL,USER]_TAB_PARTITIONS -* [DBA,ALL,USER]_TAB_STATISTICS -* [DBA,ALL,USER]_TABLES -* [DBA,ALL,USER]_TABLESPACES -* [DBA,ALL,USER]_TRIGGER_COLS -* [DBA,ALL,USER]_TRIGGERS -* [DBA,ALL,USER]_TYPES -* [DBA,ALL,USER]_VIEWS -* [DBA,ALL,USER]_JOBS -* [DBA,ALL,USER]_JOBS_RUNNING -* [DBA,ALL]_USERS -* DBA_SOURCE_ALL -* NLS_DATABASE_PARAMETERS -* NLS_INSTANCE_PARAMETERS -* NLS_SESSION_PARAMETERS - -### 其他短名称视图 - -* DICTIONARY -* DICT -* COLS -* IND -* OBJ -* TAB -* DUAL (For 2.0 and above) - -### 动态性能视图： GV,V - -* [GV,V]$DATAFILE -* [GV,V]$LOCK -* [GV,V]$PARAMETER -* [GV,V]$PARAMETER_VALID_VALUES -* [GV,V]$SESSION -* [GV,V]$SESSTAT -* [GV,V]$SPPARAMETER -* [GV,V]$SYSSTAT -* [GV,V]$TABLESPACE -* [GV,V]$VERSION -* [GV,V]$NLS_PARAMETERS -* [GV,V]$NLS_VALID_VALUES - -### 权限统一查询视图 - -* DBA_DETAIL_PRIVILEGES -* DBA_ALL_PRIVILEGES -* DBA_ALL_PRIVILEGES_SQL - -
- -## Oracle 兼容函数 - -### 字符函数 - -* regexp_substr(text,text,int4) -* regexp_substr(text,text,int4,int4,text,int4) -- 注意： 最后一个参数 p_subexpr 不支持 -* regexp_instr(text,text,int4,int4,text,int4) -* regexp_replace(text,text,text,int4,int4,text) -* regexp_count(text,text,int4,text) -* replace(text,text) - -### 时间函数 - -* months_between(timestamp, timestamp) -* trunc(timestamp, text) -* trunc(timestamptz, text) -* round(timestamptz,text) - -### 数字函数 - -* nanvl(numeric,numeric) - -### 聚合函数 - -* wm_concat(text) - -### NULL 值相关函数 - -* nullif(anyelement, anyelement) -* nvl2(anyelement, anyelement, anyelement) - -### 其他函数 - -* sys_guid() -* ora_hash(anyelement,bigint,bigint) -* show(text) -- 提供类似 Oracle 中 show xxx 查看相关参数的功能 -* show_parameter(text) -- 等同于 show(text) -* dump(anynonarray) - -
- -## Oracle 管理包 - -### DBMS_METADATA - -* get_ddl(object_type, object_name, schema_name) - -### DBMS_OUTPUT - -* enable(size) -* disable() -* get_line(line, status) -* get_lines(lines, numlines) -* new_line() -* put(text) -* put_line(text) - -### DBMS_RANDOM - -* initialize(int4) -- deprecated in Oracle -* normal() -* random() -- deprecated in Oracle -* seed(int4) -* seed(text) -* string(char,int4) -* terminate() -- deprecated in Oracle -* value() -* value(numeric,numeric) - -关于如何使用DBMS_RANDOM在MogDB数据库中生成随机数（数字、字符串和日期），请参见[DBMS_RANDOM](DBMS-RANDOM)。 - -### DBMS_JOB - -- broken(int8,bool,timestamp) -- change(int8,text,timestamp,text,int4,bool) -- instance(int8,int4,bool) -- interval(int8,text) -- next_date(int8,timestamp) -- remove(int8) -- run(int8,bool) -- submit(int8,text,timestamp,text,bool,int4,bool) -- user_export(int8,text) -- what(int8,text) - -
- -## MySQL 兼容函数 - -### NULL 相关函数 - -> 注意: ifnull 效果等同于通用函数 coalesce，在条件允许的情况下，建议修改 SQL 使用 coalesce 函数，该函数几乎在各个数据库中均支持 - -- ifnull(text,text) -- ifnull(numeric,numeric) -- ifnull(timestamp,timestamp) -- ifnull(timestamptz,timestamptz) -- isnull(text) -- 注意： MogDB 中如果创建数据库时，使用默认的 A 兼容模式，那么 '' 空字符串也会被识别为 NULL 值 -- isnull(numeric) -- isnull(timestamptz) - -### 条件控制函数 - -- if(bool,text,text) -- if(bool,numeric,numeric) -- if(bool,timestamptz,timestamptz) - -### 字符函数 - -- find_in_set(text,text) -- find_in_set(text,text[]) -- field(text,text[]) -- elt(int4,text[]) -- strcmp(text,text) -- insert(text,int8,int8,text) -- lcase(text) -- ucase(text) -- space(int4) -- mid(text,int8,int8) -- locate(text,text,int4) -- to_base64(text) -- from_base64(text) - -### 数字函数 - -- field(numeric,numeric[]) -- log10(numeric) -- log10(float8) -- rand(int4) - -### 时间函数 - -- unix_timestamp(timestamp) -- unix_timestamp(timestamptz) -- from_unixtime(int8) -- from_unixtime(numeric) -- from_unixtime(numeric,text) -- to_days(timestamp) -- to_seconds(timestamp) -- to_seconds(timestamptz) -- timediff(timestamptz,timestamptz) -- time_to_sec(time) -- sec_to_time(int4) -- date_format(timestamp, text) -- date_format(timestamptz, text) -- timestampdiff(text,timestamptz,timestamptz) -- 注意： 使用必须带 pg_catalog. 前缀Schema，第一个单位参数必须使用单引号包裹 -- str_to_date(text,text) -- 由于 MySQL 与 MogDB 中时间类型的差异，本兼容函数并非完全一致性的兼容，详细请查阅对应函数尾部的用例描述部分 - -### 其他函数 - -- uuid() -- 提供基于 随机值+时间戳 的哈希计算 uuid -- uuid_to_bin(uuid, int4) -- bin_to_uuid(bytea, int4) - -
- -## DB2 兼容函数 - -### NULL 相关函数 - -> 注意： value 效果等同于通用函数 coalesce，在条件允许的情况下，建议修改 SQL 使用 coalesce 函数，该函数几乎在各个数据库中均支持 - -- value(text,text) -- value(numeric,numeric) -- value(timestamp,timestamp) -- value(timestamptz,timestamptz) - -### 字符函数 - -- posstr(text,text) -- locate_in_string(text,text,int4,int4,text) -- regexp_match_count(text,text,int4,text,text) - -### 时间函数 - -- year (text) -- year (timestamptz) -- year (interval) -- month (text) -- month (timestamptz) -- month (interval) -- quarter (timestamptz) -- week (timestamptz) -- day (text) -- day (timestamptz) -- day (interval) -- hour (text) -- hour (timestamptz) -- hour (interval) -- minute (text) -- minute (timestamptz) -- minute (interval) -- second (text) -- second (timestamptz) -- second (interval) -- days (timestamptz) -- dayofyear (timestamptz) -- dayofweek (timestamptz) -- dayofweek_iso (timestamptz) -- dayname (timestamptz) -- monthname (timestamptz) -- midnight_seconds (timestamptz) -- next_day (timestamptz,text,text) -- next_month (timestamptz) -- next_quarter (timestamptz) -- next_week (timestamptz) -- next_year (timestamptz) -- last_day (timestamptz) -- first_day (timestamptz) -- this_month (timestamptz) -- this_quarter (timestamptz) -- this_week (timestamptz) -- this_year (timestamptz) -- days_between (timestamptz,timestamptz) -- years_between (timestamptz,timestamptz) -- ymd_between (timestamptz,timestamptz) +组件获取及使用方法详见[compat-tools仓库页面](https://gitee.com/enmotech/compat-tools)。 diff --git a/product/zh/docs-mogdb/v2.1/quick-start/container-based-installation.md b/product/zh/docs-mogdb/v2.1/quick-start/container-based-installation.md index 77e5732239998f3e596ca2a3895f505fd00c015b..c2ff5a1ee1273fdfa61944a241bf388beffd28a9 100644 --- a/product/zh/docs-mogdb/v2.1/quick-start/container-based-installation.md +++ b/product/zh/docs-mogdb/v2.1/quick-start/container-based-installation.md @@ -148,7 +148,7 @@ MogDB的密码有复杂度要求，密码长度8个字符以上，必须同时
-## Mogila样本数据库 +## Mogila样本数据集 MogDB容器版内置了一个样本数据库mogila，该数据库是一个关于DVD出租店信息的数据库，包含有关电影（如标题、类别、女演员）、出租店（如地址、工作人员、客户）和出租的信息，其中一位顾客通过店员从一家商店租了一部影片。安装完MogDB容器版之后，您可以使用mogila数据库进行各种功能测试。 @@ -185,7 +185,7 @@ MogDB=#\dt MogDB=# ``` -有关mogila样本数据库的详细介绍及查询示例，请参考[样本数据库：Mogila](mogila)。 +有关mogila样本数据集的详细介绍及查询示例，请参考[使用样本数据库集Mogila](mogila)。
diff --git a/product/zh/docs-mogdb/v2.1/quick-start/mogila.md b/product/zh/docs-mogdb/v2.1/quick-start/mogila.md index 62990570cc8e2fe91d765ed897e7b964443b3064..ee7598eff602c74d3c342a255e94bdf2b61a72f6 100644 --- a/product/zh/docs-mogdb/v2.1/quick-start/mogila.md +++ b/product/zh/docs-mogdb/v2.1/quick-start/mogila.md @@ -1,13 +1,13 @@ --- -title: 样本数据库：Mogila -summary: 样本数据库：Mogila +title: 使用样本数据集Mogila +summary: 使用样本数据集Mogila author: Guo Huan date: 2022-01-20 --- -# 样本数据库：Mogila +# 使用样本数据集Mogila MogDB提供了一个样本数据库Mogila，该数据库是一个关于DVD出租店信息的数据库，包含有关电影（如标题、类别、女演员）、出租店（如地址、工作人员、客户）和出租的信息。您可以使用Mogila数据库进行各种功能测试。 @@ -52,7 +52,7 @@ Mogila适用于MogDB 2.1.0及更高版本。 gsql ((MogDB 2.1.0 build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + mogila=# \dt List of relations Schema | Name | Type | Owner | Storage @@ -73,7 +73,7 @@ Mogila适用于MogDB 2.1.0及更高版本。 public | staff | table | mogdb | {orientation=row,compression=no} public | store | table | mogdb | {orientation=row,compression=no} (15 rows) - + mogila=# ``` @@ -132,7 +132,7 @@ Mogila适用于MogDB 2.1.0及更高版本。 gsql ((MogDB 2.1.0 build 56189e20) compiled at 2022-01-07 18:47:53 commit 0 last mr ) Non-SSL connection (SSL connection is recommended when requiring high-security) Type "help" for help. - + mogila=# \dt List of relations Schema | Name | Type | Owner | Storage @@ -153,7 +153,7 @@ Mogila适用于MogDB 2.1.0及更高版本。 public | staff | table | mogdb | {orientation=row,compression=no} public | store | table | mogdb | {orientation=row,compression=no} (15 rows) - + mogila=# ``` diff --git a/product/zh/docs-mogdb/v2.1/source-code-parsing.md b/product/zh/docs-mogdb/v2.1/source-code-parsing.md index ad49e8593c19e857188154563fecd50f934a3fda..9a4033787cc217a5318b5a1b5961ccdd9c47c46e 100644 --- a/product/zh/docs-mogdb/v2.1/source-code-parsing.md +++ b/product/zh/docs-mogdb/v2.1/source-code-parsing.md @@ -60,3 +60,5 @@ date: 2022-02-07 [openGauss数据库源码解析系列文章——AI技术（三）：智能索引推荐](https://www.modb.pro/db/210235) [openGauss数据库源码解析系列文章——AI技术（四）：指标采集、预测与异常检测](https://www.modb.pro/db/245341) + +[openGauss数据库源码解析系列文章——AI技术（五）：AI查询时间预测](https://www.modb.pro/db/251405) \ No newline at end of file diff --git a/product/zh/docs-mogdb/v2.1/toc.md b/product/zh/docs-mogdb/v2.1/toc.md index 60d326f5934148aa3b5febf1224b85b2d12b2f7d..298c2a00f5436d46ae02f45f817de428a2cf8a4c 100644 --- a/product/zh/docs-mogdb/v2.1/toc.md +++ b/product/zh/docs-mogdb/v2.1/toc.md @@ -32,7 +32,7 @@ + 使用中间件访问MogDB + [WebLogic配置MogDB数据源参考](/quick-start/mogdb-access/use-middleware-to-access-mogdb/weblogic-configures-mogdb(postgresql)-data-source-reference.md) + [WebSphere配置MogDB数据源参考](/quick-start/mogdb-access/use-middleware-to-access-mogdb/websphere-configures-mogdb(postgresql)-data-source-reference.md) - + [样本数据库：Mogila](/quick-start/mogila.md) + + [使用样本数据集Mogila](/quick-start/mogila.md) + 安装指南 + [容器化安装](/installation-guide/docker-installation/docker-installation.md) + 极简安装 diff --git a/product/zh/docs-mogdb/v2.1/toc_quickstart.md b/product/zh/docs-mogdb/v2.1/toc_quickstart.md index de3366a8643f4216b9d24221f0b5bd3075124777..3e02d63e0c2fbd37bd8e3c8614ce1281717ac69e 100644 --- a/product/zh/docs-mogdb/v2.1/toc_quickstart.md +++ b/product/zh/docs-mogdb/v2.1/toc_quickstart.md @@ -12,4 +12,4 @@ + 使用中间件访问MogDB + [WebLogic配置MogDB数据源参考](/quick-start/mogdb-access/use-middleware-to-access-mogdb/weblogic-configures-mogdb(postgresql)-data-source-reference.md) + [WebSphere配置MogDB数据源参考](/quick-start/mogdb-access/use-middleware-to-access-mogdb/websphere-configures-mogdb(postgresql)-data-source-reference.md) -+ [样本数据库：Mogila](/quick-start/mogila.md) \ No newline at end of file ++ [使用样本数据集Mogila](/quick-start/mogila.md) \ No newline at end of file