From 32ad37a0298251f392bca27b5203480baa34501c Mon Sep 17 00:00:00 2001 From: travelliu Date: Mon, 20 Jun 2022 18:42:17 +0800 Subject: [PATCH] style: Fix bold spelling issue --- .../5-mot-performance-benchmarks.md | 8 +- .../2-using-mot/2-mot-preparation.md | 10 +- .../2-using-mot/3-mot-deployment.md | 6 +- .../mot-engine/2-using-mot/4-mot-usage.md | 8 +- .../2-using-mot/5-mot-administration.md | 4 +- .../6-mot-sample-tpcc-benchmark.md | 4 +- .../mot-engine/3-concepts-of-mot/3-1.md | 2 +- .../mot-engine/3-concepts-of-mot/3-2.md | 2 +- .../mot-engine/3-concepts-of-mot/3-6.md | 4 +- .../1-logging-destination.md | 48 +- .../2-logging-time.md | 24 +- .../3-logging-content.md | 68 +-- .../guc-parameters/11-alarm-detection.md | 16 +- .../1-query-and-index-statistics-collector.md | 34 +- .../2-performance-statistics.md | 2 +- .../guc-parameters/13-load-management.md | 52 +-- .../guc-parameters/14-automatic-vacuuming.md | 56 +-- .../1-statement-behavior.md | 72 +-- .../2-zone-and-formatting.md | 44 +- .../3-other-default-parameters.md | 10 +- .../guc-parameters/16-lock-management.md | 32 +- .../1-compatibility-with-earlier-versions.md | 36 +- .../2-platform-and-client-compatibility.md | 12 +- .../guc-parameters/18-fault-tolerance.md | 32 +- .../19-connection-pool-parameters.md | 12 +- .../guc-parameters/2-file-location.md | 30 +- .../guc-parameters/20-MogDB-transaction.md | 32 +- .../guc-parameters/21-developer-options.md | 86 ++-- .../22-auditing/1-audit-switch.md | 24 +- .../2-user-and-permission-audit.md | 20 +- .../22-auditing/3-operation-audit.md | 44 +- .../guc-parameters/23-upgrade-parameters.md | 10 +- .../24-miscellaneous-parameters.md | 66 +-- .../guc-parameters/25-wait-events.md | 2 +- .../guc-parameters/26-query.md | 10 +- .../27-system-performance-snapshot.md | 6 +- ...ity-query-in-a-fully-encrypted-database.md | 2 +- .../29-global-temporary-table.md | 4 +- .../1-connection-settings.md | 42 +- .../2-security-and-authentication.md | 110 ++--- .../3-communication-library-parameters.md | 64 +-- .../4-resource-consumption/1-memory.md | 64 +-- .../4-resource-consumption/2-disk-space.md | 6 +- .../3-kernel-resource-usage.md | 8 +- .../4-cost-based-vacuum-delay.md | 20 +- .../5-background-writer.md | 16 +- .../6-asynchronous-io-operations.md | 40 +- .../guc-parameters/5-parallel-import.md | 8 +- .../6-write-ahead-log/1-settings.md | 32 +- .../6-write-ahead-log/2-checkpoints.md | 22 +- .../6-write-ahead-log/3-log-replay.md | 12 +- .../6-write-ahead-log/4-archiving.md | 6 +- .../7-ha-replication/1-sending-server.md | 50 +- .../7-ha-replication/2-primary-server.md | 38 +- .../7-ha-replication/3-standby-server.md | 38 +- .../1-optimizer-method-configuration.md | 12 +- .../4-other-optimizer-options.md | 44 +- .../sql-syntax/101-DROP-USER.md | 2 +- .../sql-syntax/106-EXPLAIN-PLAN.md | 4 +- .../reference-guide/sql-syntax/108-GRANT.md | 10 +- .../reference-guide/sql-syntax/109-INSERT.md | 4 +- .../reference-guide/sql-syntax/111-MOVE.md | 2 +- .../reference-guide/sql-syntax/117-REINDEX.md | 4 +- .../reference-guide/sql-syntax/125-SELECT.md | 18 +- .../sql-syntax/126-SELECT-INTO.md | 4 +- .../sql-syntax/131-SET-TRANSACTION.md | 2 +- .../sql-syntax/134-START-TRANSACTION.md | 2 +- .../sql-syntax/135-TRUNCATE.md | 2 +- .../reference-guide/sql-syntax/136-UPDATE.md | 2 +- .../reference-guide/sql-syntax/137-VACUUM.md | 4 +- .../sql-syntax/2-ALTER-DATABASE.md | 4 +- .../sql-syntax/22-ALTER-TABLE.md | 8 +- .../sql-syntax/23-ALTER-TABLE-PARTITION.md | 10 +- .../sql-syntax/24-ALTER-TABLESPACE.md | 6 +- .../26-ALTER-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/28-ALTER-TYPE.md | 2 +- .../sql-syntax/32-ANALYZE-ANALYSE.md | 14 +- .../reference-guide/sql-syntax/34-CALL.md | 2 +- .../sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md | 2 +- .../reference-guide/sql-syntax/41-COPY.md | 38 +- .../sql-syntax/44-CREATE-DATABASE.md | 6 +- .../sql-syntax/48-CREATE-FUNCTION.md | 6 +- .../sql-syntax/50-CREATE-INDEX.md | 4 +- .../52-CREATE-ROW-LEVEL-SECURITY-POLICY.md | 2 +- .../sql-syntax/53-CREATE-PROCEDURE.md | 6 +- .../sql-syntax/54-CREATE-ROLE.md | 4 +- .../sql-syntax/56-CREATE-SCHEMA.md | 4 +- .../sql-syntax/57-CREATE-SEQUENCE.md | 4 +- .../sql-syntax/59-CREATE-SYNONYM.md | 2 +- .../sql-syntax/60-CREATE-TABLE.md | 10 +- .../sql-syntax/61-CREATE-TABLE-AS.md | 2 +- .../sql-syntax/62-CREATE-TABLE-PARTITION.md | 16 +- .../65-CREATE-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/66-CREATE-TRIGGER.md | 2 +- .../sql-syntax/67-CREATE-TYPE.md | 8 +- .../sql-syntax/70-CREATE-VIEW.md | 2 +- .../sql-syntax/78-DROP-DATABASE.md | 2 +- .../sql-syntax/9-ALTER-INDEX.md | 2 +- .../sql-syntax/91-DROP-SCHEMA.md | 4 +- .../1-client-access-authentication.md | 12 +- .../v2.0.0/administrator-guide/br/1-2-br.md | 12 +- .../v2.0.0/administrator-guide/br/1-3-br.md | 2 +- .../5-mot-performance-benchmarks.md | 8 +- .../2-using-mot/2-mot-preparation.md | 10 +- .../2-using-mot/3-mot-deployment.md | 6 +- .../mot-engine/2-using-mot/4-mot-usage.md | 8 +- .../2-using-mot/5-mot-administration.md | 4 +- .../6-mot-sample-tpcc-benchmark.md | 4 +- .../mot-engine/3-concepts-of-mot/3-1.md | 2 +- .../mot-engine/3-concepts-of-mot/3-2.md | 2 +- .../mot-engine/3-concepts-of-mot/3-6.md | 4 +- .../0-starting-and-stopping-mogdb.md | 4 +- .../routine-maintenance/11-log-reference.md | 4 +- .../using-the-gsql-client-for-connection.md | 10 +- .../2-3-usage-guide.md | 10 +- .../3-2-usage-guide.md | 6 +- .../3-3-examples.md | 4 +- .../4-2-usage-guide.md | 2 +- .../5-2-preparations.md | 2 +- .../6-1-single-query-index-recommendation.md | 4 +- .../6-2-virtual-index.md | 2 +- .../7-deepsql/7-2-environment-deployment.md | 6 +- .../AI-features/7-deepsql/7-3-usage-guide.md | 4 +- .../7-deepsql/7-4-best-practices.md | 2 +- .../autonomous-transaction/4-restrictions.md | 2 +- .../15-JDBC/1-java-sql-Connection.md | 2 +- .../15-JDBC/2-java-sql-CallableStatement.md | 2 +- .../15-JDBC/5-java-sql-PreparedStatement.md | 2 +- .../15-JDBC/6-java-sql-ResultSet.md | 2 +- .../15-JDBC/8-java-sql-Statement.md | 2 +- .../7-running-sql-statements.md | 2 +- .../11-PQprepare.md | 2 +- .../2-PQexec.md | 2 +- .../foreign-data-wrapper/3-postgres_fdw.md | 2 +- ...cal-decoding-by-sql-function-interfaces.md | 2 +- .../1-installation-preparation.md | 4 +- .../2-installation-on-a-single-node.md | 2 +- ...3-installation-on-primary-standby-nodes.md | 2 +- .../3-modifying-os-configuration.md | 8 +- .../standard-installation/deployment-faqs.md | 2 +- .../use-gui-tools-to-access-mogdb.md | 2 +- .../13.1-hll-functions-and-operators.md | 4 +- .../9-other-functions.md | 2 +- .../25-statistics-information-functions.md | 2 +- .../28-ai-feature-functions.md | 8 +- .../1-logging-destination.md | 48 +- .../2-logging-time.md | 24 +- .../3-logging-content.md | 68 +-- .../guc-parameters/11-alarm-detection.md | 28 +- .../1-query-and-index-statistics-collector.md | 34 +- .../2-performance-statistics.md | 2 +- .../guc-parameters/13-load-management.md | 52 +-- .../guc-parameters/14-automatic-vacuuming.md | 56 +-- .../1-statement-behavior.md | 72 +-- .../2-zone-and-formatting.md | 44 +- .../3-other-default-parameters.md | 10 +- .../guc-parameters/16-lock-management.md | 32 +- .../1-compatibility-with-earlier-versions.md | 36 +- .../2-platform-and-client-compatibility.md | 26 +- .../guc-parameters/18-fault-tolerance.md | 38 +- .../19-connection-pool-parameters.md | 12 +- .../guc-parameters/2-file-location.md | 20 +- .../guc-parameters/20-MogDB-transaction.md | 32 +- .../guc-parameters/21-developer-options.md | 52 +-- .../22-auditing/1-audit-switch.md | 24 +- .../2-user-and-permission-audit.md | 20 +- .../22-auditing/3-operation-audit.md | 40 +- .../guc-parameters/23-upgrade-parameters.md | 10 +- .../24-miscellaneous-parameters.md | 46 +- .../guc-parameters/25-wait-events.md | 2 +- .../guc-parameters/26-query.md | 10 +- .../27-system-performance-snapshot.md | 6 +- ...ity-query-in-a-fully-encrypted-database.md | 2 +- .../29-global-temporary-table.md | 4 +- .../1-connection-settings.md | 48 +- .../2-security-and-authentication.md | 110 ++--- .../3-communication-library-parameters.md | 64 +-- .../guc-parameters/31-scheduled-task.md | 6 +- .../guc-parameters/32-thread-pool.md | 12 +- .../4-resource-consumption/1-memory.md | 70 +-- .../4-resource-consumption/2-disk-space.md | 6 +- .../3-kernel-resource-usage.md | 8 +- .../4-cost-based-vacuum-delay.md | 20 +- .../5-background-writer.md | 46 +- .../6-asynchronous-io-operations.md | 58 +-- .../guc-parameters/5-parallel-import.md | 8 +- .../6-write-ahead-log/1-settings.md | 32 +- .../6-write-ahead-log/2-checkpoints.md | 22 +- .../6-write-ahead-log/3-log-replay.md | 14 +- .../6-write-ahead-log/4-archiving.md | 6 +- .../7-ha-replication/1-sending-server.md | 50 +- .../7-ha-replication/2-primary-server.md | 36 +- .../7-ha-replication/3-standby-server.md | 38 +- .../1-optimizer-method-configuration.md | 18 +- .../4-other-optimizer-options.md | 184 ++++---- .../sql-reference/2-keywords.md | 2 +- .../4-expressions/1-simple-expressions.md | 2 +- .../4-expressions/4-array-expressions.md | 4 +- .../5-type-conversion/2-operators.md | 4 +- .../5-type-conversion/3-functions.md | 2 +- .../5-type-conversion/4-value-storage.md | 2 +- .../5-union-case-and-related-constructs.md | 2 +- .../1-introduction/2-what-is-a-document.md | 2 +- .../1-manipulating-tsvector.md | 2 +- .../3-rewriting-queries.md | 2 +- .../3-testing-a-dictionary.md | 2 +- .../8-controlling-transactions.md | 2 +- .../sql-reference/9-ddl-syntax-overview.md | 2 +- .../sql-syntax/101-DROP-USER.md | 2 +- .../sql-syntax/106-EXPLAIN-PLAN.md | 4 +- .../reference-guide/sql-syntax/108-GRANT.md | 10 +- .../reference-guide/sql-syntax/109-INSERT.md | 4 +- .../reference-guide/sql-syntax/111-MOVE.md | 2 +- .../reference-guide/sql-syntax/117-REINDEX.md | 4 +- .../reference-guide/sql-syntax/125-SELECT.md | 18 +- .../sql-syntax/126-SELECT-INTO.md | 4 +- .../sql-syntax/131-SET-TRANSACTION.md | 2 +- .../sql-syntax/134-START-TRANSACTION.md | 2 +- .../sql-syntax/135-TRUNCATE.md | 2 +- .../reference-guide/sql-syntax/136-UPDATE.md | 2 +- .../reference-guide/sql-syntax/137-VACUUM.md | 4 +- .../sql-syntax/2-ALTER-DATABASE.md | 4 +- .../sql-syntax/22-ALTER-TABLE.md | 8 +- .../sql-syntax/23-ALTER-TABLE-PARTITION.md | 10 +- .../sql-syntax/24-ALTER-TABLESPACE.md | 6 +- .../26-ALTER-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/28-ALTER-TYPE.md | 2 +- .../sql-syntax/32-ANALYZE-ANALYSE.md | 14 +- .../reference-guide/sql-syntax/34-CALL.md | 2 +- .../sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md | 2 +- .../reference-guide/sql-syntax/41-COPY.md | 38 +- .../sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md | 2 +- .../sql-syntax/44-CREATE-DATABASE.md | 6 +- .../sql-syntax/48-CREATE-FUNCTION.md | 6 +- .../sql-syntax/50-CREATE-INDEX.md | 4 +- .../52-CREATE-ROW-LEVEL-SECURITY-POLICY.md | 2 +- .../sql-syntax/53-CREATE-PROCEDURE.md | 6 +- .../sql-syntax/54-CREATE-ROLE.md | 4 +- .../sql-syntax/56-CREATE-SCHEMA.md | 4 +- .../sql-syntax/57-CREATE-SEQUENCE.md | 4 +- .../sql-syntax/59-CREATE-SYNONYM.md | 2 +- .../sql-syntax/60-CREATE-TABLE.md | 10 +- .../sql-syntax/61-CREATE-TABLE-AS.md | 2 +- .../sql-syntax/62-CREATE-TABLE-PARTITION.md | 16 +- .../65-CREATE-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/66-CREATE-TRIGGER.md | 2 +- .../sql-syntax/67-CREATE-TYPE.md | 8 +- .../sql-syntax/70-CREATE-VIEW.md | 2 +- .../sql-syntax/78-DROP-DATABASE.md | 2 +- .../sql-syntax/9-ALTER-INDEX.md | 2 +- .../sql-syntax/91-DROP-SCHEMA.md | 4 +- .../tool-reference/client-tool.md | 20 +- .../tool-reference/server-tools/1-gs_check.md | 4 +- .../server-tools/2-gs_checkos.md | 6 +- .../server-tools/4-gs_collector.md | 6 +- .../tool-reference/server-tools/5-gs_dump.md | 16 +- .../server-tools/6-gs_dumpall.md | 4 +- .../tool-reference/server-tools/7-gs_guc.md | 24 +- .../tool-reference/server-tools/8-gs_om.md | 4 +- .../server-tools/9-gs_restore.md | 10 +- .../1-gaussdb.md | 6 +- .../10-gs_tar.md | 2 +- .../11-gs_uninstall.md | 4 +- .../12-gs_upgradectl.md | 2 +- .../13-gs_expansion.md | 2 +- .../15-gs_probackup.md | 12 +- .../16-gstrace.md | 4 +- .../3-gs_basebackup.md | 6 +- .../5-gs_initdb.md | 2 +- .../6-gs_install.md | 2 +- .../7-gs_postuninstall.md | 2 +- .../8-gs_preinstall.md | 8 +- .../9-gs_sshexkey.md | 4 +- .../1-client-access-authentication.md | 12 +- .../v2.0.1/administrator-guide/br/1-2-br.md | 12 +- .../v2.0.1/administrator-guide/br/1-3-br.md | 2 +- .../5-mot-performance-benchmarks.md | 8 +- .../2-using-mot/2-mot-preparation.md | 10 +- .../2-using-mot/3-mot-deployment.md | 6 +- .../mot-engine/2-using-mot/4-mot-usage.md | 8 +- .../2-using-mot/5-mot-administration.md | 4 +- .../6-mot-sample-tpcc-benchmark.md | 4 +- .../mot-engine/3-concepts-of-mot/3-1.md | 2 +- .../mot-engine/3-concepts-of-mot/3-2.md | 2 +- .../mot-engine/3-concepts-of-mot/3-6.md | 4 +- .../0-starting-and-stopping-mogdb.md | 4 +- .../routine-maintenance/11-log-reference.md | 4 +- .../using-the-gsql-client-for-connection.md | 10 +- .../2-3-usage-guide.md | 10 +- .../3-2-usage-guide.md | 6 +- .../3-3-examples.md | 4 +- .../4-2-usage-guide.md | 2 +- .../5-2-preparations.md | 2 +- .../6-1-single-query-index-recommendation.md | 4 +- .../6-2-virtual-index.md | 2 +- .../7-deepsql/7-2-environment-deployment.md | 6 +- .../AI-features/7-deepsql/7-3-usage-guide.md | 4 +- .../7-deepsql/7-4-best-practices.md | 2 +- .../autonomous-transaction/4-restrictions.md | 2 +- .../15-JDBC/1-java-sql-Connection.md | 2 +- .../15-JDBC/2-java-sql-CallableStatement.md | 2 +- .../15-JDBC/5-java-sql-PreparedStatement.md | 2 +- .../15-JDBC/6-java-sql-ResultSet.md | 2 +- .../15-JDBC/8-java-sql-Statement.md | 2 +- .../4-loading-the-driver.md | 2 +- .../6-connecting-to-a-database-using-ssl.md | 2 +- .../7-running-sql-statements.md | 2 +- .../11-PQprepare.md | 2 +- .../2-PQexec.md | 2 +- .../foreign-data-wrapper/3-postgres_fdw.md | 2 +- ...cal-decoding-by-sql-function-interfaces.md | 2 +- .../faqs/deployment-and-maintenance-faqs.md | 2 +- .../1-installation-preparation.md | 4 +- .../2-installation-on-a-single-node.md | 2 +- ...3-installation-on-primary-standby-nodes.md | 2 +- .../3-modifying-os-configuration.md | 8 +- .../1-system/4-configuring-smp.md | 2 +- .../mogdb-access/use-cli-to-access-mogdb.md | 10 +- .../use-gui-tools-to-access-mogdb.md | 2 +- .../13.1-hll-functions-and-operators.md | 4 +- .../9-other-functions.md | 2 +- .../25-statistics-information-functions.md | 2 +- .../28-ai-feature-functions.md | 8 +- .../1-logging-destination.md | 48 +- .../2-logging-time.md | 24 +- .../3-logging-content.md | 68 +-- .../guc-parameters/11-alarm-detection.md | 28 +- .../1-query-and-index-statistics-collector.md | 34 +- .../2-performance-statistics.md | 2 +- .../guc-parameters/13-load-management.md | 52 +-- .../guc-parameters/14-automatic-vacuuming.md | 56 +-- .../1-statement-behavior.md | 72 +-- .../2-zone-and-formatting.md | 44 +- .../3-other-default-parameters.md | 10 +- .../guc-parameters/16-lock-management.md | 32 +- .../1-compatibility-with-earlier-versions.md | 36 +- .../2-platform-and-client-compatibility.md | 26 +- .../guc-parameters/18-fault-tolerance.md | 38 +- .../19-connection-pool-parameters.md | 12 +- .../guc-parameters/2-file-location.md | 20 +- .../guc-parameters/20-MogDB-transaction.md | 32 +- .../guc-parameters/21-developer-options.md | 52 +-- .../22-auditing/1-audit-switch.md | 24 +- .../2-user-and-permission-audit.md | 20 +- .../22-auditing/3-operation-audit.md | 40 +- .../guc-parameters/23-upgrade-parameters.md | 10 +- .../24-miscellaneous-parameters.md | 46 +- .../guc-parameters/25-wait-events.md | 2 +- .../guc-parameters/26-query.md | 10 +- .../27-system-performance-snapshot.md | 6 +- ...ity-query-in-a-fully-encrypted-database.md | 2 +- .../29-global-temporary-table.md | 4 +- .../1-connection-settings.md | 70 +-- .../2-security-and-authentication.md | 110 ++--- .../3-communication-library-parameters.md | 64 +-- .../guc-parameters/31-scheduled-task.md | 6 +- .../guc-parameters/32-thread-pool.md | 12 +- .../4-resource-consumption/1-memory.md | 70 +-- .../4-resource-consumption/2-disk-space.md | 6 +- .../3-kernel-resource-usage.md | 8 +- .../4-cost-based-vacuum-delay.md | 20 +- .../5-background-writer.md | 46 +- .../6-asynchronous-io-operations.md | 58 +-- .../guc-parameters/5-parallel-import.md | 8 +- .../6-write-ahead-log/1-settings.md | 32 +- .../6-write-ahead-log/2-checkpoints.md | 22 +- .../6-write-ahead-log/3-log-replay.md | 14 +- .../6-write-ahead-log/4-archiving.md | 6 +- .../7-ha-replication/1-sending-server.md | 50 +- .../7-ha-replication/2-primary-server.md | 36 +- .../7-ha-replication/3-standby-server.md | 38 +- .../1-optimizer-method-configuration.md | 18 +- .../4-other-optimizer-options.md | 184 ++++---- .../sql-reference/2-keywords.md | 2 +- .../4-expressions/1-simple-expressions.md | 2 +- .../4-expressions/4-array-expressions.md | 4 +- .../5-type-conversion/2-operators.md | 4 +- .../5-type-conversion/3-functions.md | 2 +- .../5-type-conversion/4-value-storage.md | 2 +- .../5-union-case-and-related-constructs.md | 2 +- .../1-introduction/2-what-is-a-document.md | 2 +- .../1-manipulating-tsvector.md | 2 +- .../3-rewriting-queries.md | 2 +- .../3-testing-a-dictionary.md | 2 +- .../8-controlling-transactions.md | 2 +- .../sql-reference/9-ddl-syntax-overview.md | 2 +- .../sql-syntax/101-DROP-USER.md | 2 +- .../sql-syntax/106-EXPLAIN-PLAN.md | 4 +- .../reference-guide/sql-syntax/108-GRANT.md | 10 +- .../reference-guide/sql-syntax/109-INSERT.md | 4 +- .../reference-guide/sql-syntax/111-MOVE.md | 2 +- .../reference-guide/sql-syntax/117-REINDEX.md | 4 +- .../reference-guide/sql-syntax/125-SELECT.md | 18 +- .../sql-syntax/126-SELECT-INTO.md | 4 +- .../sql-syntax/131-SET-TRANSACTION.md | 2 +- .../sql-syntax/134-START-TRANSACTION.md | 2 +- .../sql-syntax/135-TRUNCATE.md | 2 +- .../reference-guide/sql-syntax/136-UPDATE.md | 2 +- .../reference-guide/sql-syntax/137-VACUUM.md | 4 +- .../sql-syntax/2-ALTER-DATABASE.md | 4 +- .../sql-syntax/22-ALTER-TABLE.md | 8 +- .../sql-syntax/23-ALTER-TABLE-PARTITION.md | 10 +- .../sql-syntax/24-ALTER-TABLESPACE.md | 6 +- .../26-ALTER-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/28-ALTER-TYPE.md | 2 +- .../sql-syntax/32-ANALYZE-ANALYSE.md | 14 +- .../reference-guide/sql-syntax/34-CALL.md | 2 +- .../sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md | 2 +- .../reference-guide/sql-syntax/41-COPY.md | 38 +- .../sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md | 2 +- .../sql-syntax/44-CREATE-DATABASE.md | 6 +- .../sql-syntax/48-CREATE-FUNCTION.md | 6 +- .../sql-syntax/50-CREATE-INDEX.md | 4 +- .../52-CREATE-ROW-LEVEL-SECURITY-POLICY.md | 2 +- .../sql-syntax/53-CREATE-PROCEDURE.md | 6 +- .../sql-syntax/54-CREATE-ROLE.md | 4 +- .../sql-syntax/56-CREATE-SCHEMA.md | 4 +- .../sql-syntax/57-CREATE-SEQUENCE.md | 4 +- .../sql-syntax/59-CREATE-SYNONYM.md | 2 +- .../sql-syntax/60-CREATE-TABLE.md | 10 +- .../sql-syntax/61-CREATE-TABLE-AS.md | 2 +- .../sql-syntax/62-CREATE-TABLE-PARTITION.md | 16 +- .../65-CREATE-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/66-CREATE-TRIGGER.md | 2 +- .../sql-syntax/67-CREATE-TYPE.md | 8 +- .../sql-syntax/70-CREATE-VIEW.md | 2 +- .../sql-syntax/76-DROP-CLIENT-MASTER-KEY.md | 2 +- .../sql-syntax/78-DROP-DATABASE.md | 2 +- .../sql-syntax/9-ALTER-INDEX.md | 2 +- .../sql-syntax/91-DROP-SCHEMA.md | 4 +- .../tool-reference/client-tool.md | 20 +- .../tool-reference/server-tools/1-gs_check.md | 4 +- .../server-tools/2-gs_checkos.md | 6 +- .../server-tools/4-gs_collector.md | 6 +- .../tool-reference/server-tools/5-gs_dump.md | 16 +- .../server-tools/6-gs_dumpall.md | 4 +- .../tool-reference/server-tools/7-gs_guc.md | 24 +- .../tool-reference/server-tools/8-gs_om.md | 4 +- .../server-tools/9-gs_restore.md | 10 +- .../1-gaussdb.md | 6 +- .../10-gs_tar.md | 2 +- .../11-gs_uninstall.md | 4 +- .../12-gs_upgradectl.md | 2 +- .../13-gs_expansion.md | 2 +- .../15-gs_probackup.md | 12 +- .../16-gstrace.md | 4 +- .../3-gs_basebackup.md | 6 +- .../5-gs_initdb.md | 2 +- .../6-gs_install.md | 2 +- .../7-gs_postuninstall.md | 2 +- .../8-gs_preinstall.md | 8 +- .../9-gs_sshexkey.md | 4 +- .../1-client-access-authentication.md | 12 +- .../2-3-usage-guide.md | 10 +- .../3-2-preparations.md | 6 +- .../3-3-examples.md | 4 +- .../5-2-preparations.md | 2 +- .../6-1-single-query-index-recommendation.md | 4 +- .../6-2-virtual-index.md | 2 +- ...6-3-workload-level-index-recommendation.md | 4 +- .../7-deepsql/7-2-environment-deployment.md | 6 +- .../AI-features/7-deepsql/7-3-usage-guide.md | 4 +- .../7-deepsql/7-4-best-practices.md | 2 +- .../v2.1/administrator-guide/br/1-2-br.md | 14 +- .../v2.1/administrator-guide/br/1-3-br.md | 2 +- ...sing-a-gsql-meta-command-to-import-data.md | 2 +- .../5-mot-performance-benchmarks.md | 8 +- .../2-using-mot/2-mot-preparation.md | 10 +- .../2-using-mot/3-mot-deployment.md | 6 +- .../mot-engine/2-using-mot/4-mot-usage.md | 8 +- .../2-using-mot/5-mot-administration.md | 4 +- .../6-mot-sample-tpcc-benchmark.md | 4 +- .../mot-engine/3-concepts-of-mot/3-1.md | 2 +- .../mot-engine/3-concepts-of-mot/3-2.md | 2 +- .../mot-engine/3-concepts-of-mot/3-6.md | 4 +- .../0-starting-and-stopping-mogdb.md | 4 +- .../routine-maintenance/11-log-reference.md | 4 +- .../using-the-gsql-client-for-connection.md | 10 +- .../v2.1/administrator-guide/upgrade-guide.md | 2 +- .../11-password-strength-verification.md | 4 +- ...-to-the-database-in-different-scenarios.md | 2 +- .../15-JDBC/1-java-sql-Connection.md | 2 +- .../15-JDBC/2-java-sql-CallableStatement.md | 2 +- .../15-JDBC/5-java-sql-PreparedStatement.md | 2 +- .../15-JDBC/6-java-sql-ResultSet.md | 2 +- .../15-JDBC/8-java-sql-Statement.md | 2 +- .../7-running-sql-statements.md | 2 +- ...pplication-scenarios-and-configurations.md | 4 +- .../11-PQprepare.md | 2 +- .../2-PQexec.md | 2 +- .../foreign-data-wrapper/3-postgres_fdw.md | 2 +- ...cal-decoding-by-sql-function-interfaces.md | 2 +- .../developer-guide/plpgsql/1-11-cursors.md | 6 +- .../developer-guide/plpgsql/1-13-debugging.md | 4 +- .../plpgsql/1-5-declare-syntax.md | 2 +- .../plpgsql/1-6-basic-statements.md | 6 +- .../plpgsql/1-8-control-statements.md | 4 +- .../creating-a-resource-pool.md | 6 +- .../enabling-resource-load-management.md | 2 +- .../setting-a-cgroup.md | 6 +- .../faqs/deployment-and-maintenance-faqs.md | 2 +- .../1-installation-preparation.md | 4 +- .../2-installation-on-a-single-node.md | 8 +- ...3-installation-on-primary-standby-nodes.md | 10 +- .../3-modifying-os-configuration.md | 8 +- .../1-system/4-configuring-smp.md | 2 +- .../2-sql/9-hint-based-tuning.md | 6 +- .../performance-tuning/wdr-snapshot-schema.md | 2 +- .../use-cli-to-access-mogdb/gsql.md | 12 +- .../datastudio.md | 2 +- .../13.1-hll-functions-and-operators.md | 4 +- .../14-sequence-functions.md | 8 +- .../18-window-functions.md | 2 +- .../19-security-functions.md | 14 +- .../23-system-information-functions.md | 14 +- .../9-other-functions.md | 6 +- .../25-statistics-information-functions.md | 6 +- .../28-ai-feature-functions.md | 2 +- .../29.1-dynamic-data-masking-functions.md | 2 +- ...cter-processing-functions-and-operators.md | 18 +- .../5-bit-string-functions-and-operators.md | 4 +- .../6-mode-matching-operators.md | 4 +- ...time-processing-functions-and-operators.md | 2 +- .../1-logging-destination.md | 22 +- .../2-logging-time.md | 12 +- .../3-logging-content.md | 34 +- .../guc-parameters/11-alarm-detection.md | 20 +- .../1-query-and-index-statistics-collector.md | 18 +- .../2-performance-statistics.md | 2 +- .../guc-parameters/13-load-management.md | 96 ++-- .../guc-parameters/14-automatic-vacuuming.md | 28 +- .../1-statement-behavior.md | 36 +- .../2-zone-and-formatting.md | 22 +- .../3-other-default-parameters.md | 4 +- .../guc-parameters/16-lock-management.md | 6 +- .../1-compatibility-with-earlier-versions.md | 18 +- .../2-platform-and-client-compatibility.md | 32 +- .../guc-parameters/18-fault-tolerance.md | 20 +- .../guc-parameters/2-file-location.md | 10 +- .../guc-parameters/20-MogDB-transaction.md | 14 +- .../guc-parameters/21-developer-options.md | 32 +- .../22-auditing/1-audit-switch.md | 12 +- .../2-user-and-permission-audit.md | 12 +- .../22-auditing/3-operation-audit.md | 18 +- .../guc-parameters/23-upgrade-parameters.md | 6 +- .../24-miscellaneous-parameters.md | 24 +- .../guc-parameters/25-wait-events.md | 2 +- .../guc-parameters/26-query.md | 16 +- .../27-system-performance-snapshot.md | 20 +- .../27.1-security-configuration.md | 12 +- ...ity-query-in-a-fully-encrypted-database.md | 2 +- .../29-global-temporary-table.md | 4 +- .../1-connection-settings.md | 18 +- .../2-security-and-authentication.md | 54 +-- .../3-communication-library-parameters.md | 10 +- .../guc-parameters/31-scheduled-task.md | 6 +- .../guc-parameters/32-thread-pool.md | 12 +- .../33-user-defined-functions.md | 4 +- .../34-backup-and-restoration.md | 6 +- .../guc-parameters/37-flashback.md | 18 +- .../guc-parameters/39-reserved-parameters.md | 4 +- .../4-resource-consumption/1-memory.md | 40 +- .../4-resource-consumption/2-disk-space.md | 4 +- .../3-kernel-resource-usage.md | 4 +- .../4-cost-based-vacuum-delay.md | 10 +- .../5-background-writer.md | 38 +- .../6-asynchronous-io-operations.md | 38 +- .../6-write-ahead-log/1-settings.md | 14 +- .../6-write-ahead-log/3-log-replay.md | 2 +- .../7-ha-replication/1-sending-server.md | 24 +- .../7-ha-replication/2-primary-server.md | 28 +- .../7-ha-replication/3-standby-server.md | 24 +- .../1-optimizer-method-configuration.md | 12 +- .../4-other-optimizer-options.md | 198 ++++---- .../overview-of-DBE_PLDEBUGGER-schema.md | 2 +- .../sql-reference/2-keywords.md | 4 +- .../4-expressions/1-simple-expressions.md | 2 +- .../4-expressions/4-array-expressions.md | 4 +- .../5-type-conversion/2-operators.md | 4 +- .../5-type-conversion/3-functions.md | 2 +- .../5-type-conversion/4-value-storage.md | 2 +- .../5-union-case-and-related-constructs.md | 2 +- .../1-introduction/2-what-is-a-document.md | 2 +- .../1-manipulating-tsvector.md | 2 +- .../3-rewriting-queries.md | 2 +- .../3-testing-a-dictionary.md | 2 +- .../8-controlling-transactions.md | 2 +- .../sql-reference/9-ddl-syntax-overview.md | 2 +- .../sql-syntax/101-DROP-USER.md | 2 +- .../sql-syntax/106-EXPLAIN-PLAN.md | 4 +- .../reference-guide/sql-syntax/108-GRANT.md | 10 +- .../reference-guide/sql-syntax/109-INSERT.md | 4 +- .../sql-syntax/11.3-ALTER-RESOURCE-POOL.md | 6 +- .../reference-guide/sql-syntax/111-MOVE.md | 2 +- .../reference-guide/sql-syntax/117-REINDEX.md | 4 +- .../reference-guide/sql-syntax/125-SELECT.md | 20 +- .../sql-syntax/126-SELECT-INTO.md | 4 +- .../reference-guide/sql-syntax/127-SET.md | 2 +- .../sql-syntax/131-SET-TRANSACTION.md | 2 +- .../sql-syntax/134-START-TRANSACTION.md | 2 +- .../sql-syntax/135-TRUNCATE.md | 2 +- .../reference-guide/sql-syntax/136-UPDATE.md | 2 +- .../reference-guide/sql-syntax/137-VACUUM.md | 2 +- .../sql-syntax/2-ALTER-DATABASE.md | 4 +- .../sql-syntax/22-ALTER-TABLE.md | 8 +- .../sql-syntax/23-ALTER-TABLE-PARTITION.md | 12 +- .../23.1-ALTER-TABLE-SUBPARTITION.md | 2 +- .../sql-syntax/24-ALTER-TABLESPACE.md | 6 +- .../26-ALTER-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/28-ALTER-TYPE.md | 2 +- .../sql-syntax/32-ANALYZE-ANALYSE.md | 14 +- .../reference-guide/sql-syntax/34-CALL.md | 2 +- .../sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md | 2 +- .../reference-guide/sql-syntax/41-COPY.md | 38 +- .../sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md | 2 +- .../43-CREATE-COLUMN-ENCRYPTION-KEY.md | 2 +- .../sql-syntax/44-CREATE-DATABASE.md | 6 +- .../sql-syntax/47-CREATE-FOREIGN-TABLE.md | 2 +- .../sql-syntax/48-CREATE-FUNCTION.md | 6 +- .../sql-syntax/50-CREATE-INDEX.md | 4 +- .../52-CREATE-ROW-LEVEL-SECURITY-POLICY.md | 2 +- .../sql-syntax/53-CREATE-PROCEDURE.md | 6 +- .../sql-syntax/53.2-CREATE-RESOURCE-POOL.md | 8 +- .../sql-syntax/54-CREATE-ROLE.md | 4 +- .../sql-syntax/56-CREATE-SCHEMA.md | 4 +- .../sql-syntax/57-CREATE-SEQUENCE.md | 4 +- .../sql-syntax/59-CREATE-SYNONYM.md | 2 +- .../sql-syntax/6-ALTER-FOREIGN-TABLE.md | 2 +- .../sql-syntax/60-CREATE-TABLE.md | 10 +- .../sql-syntax/61-CREATE-TABLE-AS.md | 2 +- .../sql-syntax/62-CREATE-TABLE-PARTITION.md | 18 +- .../62.1-CREATE-TABLE-SUBPARTITION.md | 74 +-- .../65-CREATE-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/66-CREATE-TRIGGER.md | 2 +- .../sql-syntax/67-CREATE-TYPE.md | 8 +- .../sql-syntax/69-CREATE-USER-MAPPING.md | 4 +- .../sql-syntax/70-CREATE-VIEW.md | 2 +- .../sql-syntax/76-DROP-CLIENT-MASTER-KEY.md | 2 +- .../sql-syntax/78-DROP-DATABASE.md | 2 +- .../sql-syntax/86.2-DROP-RESOURCE-POOL.md | 2 +- .../sql-syntax/9-ALTER-INDEX.md | 2 +- .../sql-syntax/91-DROP-SCHEMA.md | 4 +- .../supported-data-types/13-HLL.md | 6 +- .../supported-data-types/17-xml-type.md | 2 +- .../5-binary-data-types.md | 2 +- ...iew-of-system-catalogs-and-system-views.md | 16 +- .../reference-guide/tool-reference/FAQ.md | 2 +- .../tool-reference/client-tool.md | 20 +- .../server-tools/0-gs_cgroup.md | 14 +- .../tool-reference/server-tools/1-gs_check.md | 4 +- .../server-tools/2-gs_checkos.md | 6 +- .../server-tools/4-gs_collector.md | 6 +- .../tool-reference/server-tools/5-gs_dump.md | 16 +- .../server-tools/6-gs_dumpall.md | 4 +- .../tool-reference/server-tools/7-gs_guc.md | 30 +- .../server-tools/7.1-gs_encrypt.md | 4 +- .../tool-reference/server-tools/8-gs_om.md | 4 +- .../server-tools/9-gs_restore.md | 10 +- .../1-gaussdb.md | 6 +- .../10-gs_tar.md | 2 +- .../11-gs_uninstall.md | 2 +- .../12-gs_upgradectl.md | 2 +- .../13-gs_expansion.md | 2 +- .../15-gs_probackup.md | 14 +- .../16-gstrace.md | 4 +- .../3-gs_basebackup.md | 6 +- .../5-gs_initdb.md | 2 +- .../6-gs_install.md | 2 +- .../7-gs_postuninstall.md | 2 +- .../8-gs_preinstall.md | 8 +- .../9-gs_sshexkey.md | 4 +- .../1-client-access-authentication.md | 8 +- .../2-managing-users-and-their-permissions.md | 8 +- .../4-setting-encrypted-equality-query.md | 8 +- .../security/5-setting-a-ledger-database.md | 4 +- .../intelligence-explain-user-guide.md | 12 +- .../1-2-preparations.md | 28 +- .../1-3-examples.md | 4 +- .../2-1-single-query-index-recommendation.md | 4 +- .../2-2-virtual-index.md | 2 +- ...2-3-workload-level-index-recommendation.md | 20 +- ...metheus-exporter-environment-deployment.md | 2 +- .../prometheus-exporter-overview.md | 2 +- .../ai4db/dbmind-mode/1-service.md | 12 +- .../AI-features/ai4db/dbmind-mode/3-set.md | 4 +- ...i-snapshots-for-data-version-management.md | 4 +- .../AI-features/db4ai/native-db4ai-engine.md | 6 +- .../v3.0/administrator-guide/br/1-2-br.md | 16 +- .../v3.0/administrator-guide/br/1-3-br.md | 36 +- .../v3.0/administrator-guide/br/1-4-br.md | 4 +- ...sing-a-gsql-meta-command-to-import-data.md | 2 +- .../5-mot-performance-benchmarks.md | 8 +- .../2-using-mot/2-mot-preparation.md | 10 +- .../2-using-mot/3-mot-deployment.md | 6 +- .../mot-engine/2-using-mot/4-mot-usage.md | 8 +- .../2-using-mot/5-mot-administration.md | 4 +- .../6-mot-sample-tpcc-benchmark.md | 4 +- .../mot-engine/3-concepts-of-mot/3-1.md | 2 +- .../mot-engine/3-concepts-of-mot/3-2.md | 2 +- .../mot-engine/3-concepts-of-mot/3-6.md | 4 +- .../0-starting-and-stopping-mogdb.md | 4 +- .../routine-maintenance/11-log-reference.md | 6 +- .../using-the-gsql-client-for-connection.md | 10 +- .../v3.0/administrator-guide/upgrade-guide.md | 2 +- .../11-password-strength-verification.md | 4 +- .../14-example-logic-replication-code.md | 2 +- ...-to-the-database-in-different-scenarios.md | 2 +- .../15-JDBC/1-java-sql-Connection.md | 2 +- .../15-JDBC/2-java-sql-CallableStatement.md | 2 +- .../15-JDBC/3-java-sql-DatabaseMetaData.md | 28 +- .../15-JDBC/5-java-sql-PreparedStatement.md | 2 +- .../15-JDBC/6-java-sql-ResultSet.md | 2 +- .../15-JDBC/7-java-sql-ResultSetMetaData.md | 6 +- .../15-JDBC/8-java-sql-Statement.md | 2 +- .../7-running-sql-statements.md | 16 +- .../4-development-process.md | 2 +- ...pplication-scenarios-and-configurations.md | 4 +- .../11-PQprepare.md | 2 +- .../2-PQexec.md | 2 +- .../development-process.md | 2 +- ...cal-decoding-by-sql-function-interfaces.md | 2 +- .../developer-guide/plpgsql/1-11-cursors.md | 6 +- .../developer-guide/plpgsql/1-13-debugging.md | 40 +- .../developer-guide/plpgsql/1-14-package.md | 6 +- .../plpgsql/1-4-arrays-and-records.md | 4 +- .../plpgsql/1-5-declare-syntax.md | 2 +- .../plpgsql/1-6-basic-statements.md | 8 +- .../plpgsql/1-8-control-statements.md | 8 +- .../basic-interfaces/PKG_SERVICE.md | 14 +- .../postgis-extension/using-postgis.md | 2 +- .../creating-a-resource-pool.md | 8 +- .../enabling-resource-load-management.md | 2 +- .../setting-a-cgroup.md | 6 +- .../faqs/deployment-and-maintenance-faqs.md | 2 +- .../1-installation-preparation.md | 6 +- .../2-installation-on-a-single-node.md | 12 +- ...3-installation-on-primary-standby-nodes.md | 14 +- .../1-installation-overview.md | 2 +- .../3-modifying-os-configuration.md | 12 +- .../4-installing-mogdb.md | 146 +++--- .../1-system/4-configuring-smp.md | 2 +- .../2-sql/9-hint-based-tuning.md | 16 +- .../3-wdr/wdr-snapshot-schema.md | 12 +- .../use-cli-to-access-mogdb/gsql.md | 12 +- .../datastudio.md | 2 +- .../1-logical-operators.md | 2 +- .../13.1-hll-functions-and-operators.md | 4 +- .../14-sequence-functions.md | 8 +- .../18-window-functions.md | 2 +- .../19-security-functions.md | 14 +- .../23-system-information-functions.md | 18 +- .../8-logical-replication-functions.md | 18 +- .../9-other-functions.md | 114 ++--- .../25-statistics-information-functions.md | 12 +- .../28-ai-feature-functions.md | 6 +- .../29.1-dynamic-data-masking-functions.md | 2 +- ...cter-processing-functions-and-operators.md | 100 ++-- .../5-bit-string-functions-and-operators.md | 4 +- .../6-mode-matching-operators.md | 28 +- ...time-processing-functions-and-operators.md | 14 +- .../1-logging-destination.md | 66 +-- .../2-logging-time.md | 36 +- .../3-logging-content.md | 108 ++--- .../guc-parameters/11-alarm-detection.md | 36 +- .../1-query-and-index-statistics-collector.md | 54 +-- .../2-performance-statistics.md | 6 +- .../guc-parameters/13-load-management.md | 188 ++++---- .../guc-parameters/14-automatic-vacuuming.md | 90 ++-- .../1-statement-behavior.md | 114 ++--- .../2-zone-and-formatting.md | 66 +-- .../3-other-default-parameters.md | 16 +- .../guc-parameters/16-lock-management.md | 64 +-- .../1-compatibility-with-earlier-versions.md | 54 +-- .../2-platform-and-client-compatibility.md | 70 +-- .../guc-parameters/18-fault-tolerance.md | 54 +-- .../19-connection-pool-parameters.md | 22 +- .../guc-parameters/2-file-location.md | 30 +- .../guc-parameters/20-MogDB-transaction.md | 54 +-- .../guc-parameters/21-developer-options.md | 154 +++--- .../22-auditing/1-audit-switch.md | 62 +-- .../2-user-and-permission-audit.md | 32 +- .../22-auditing/3-operation-audit.md | 62 +-- .../guc-parameters/23-upgrade-parameters.md | 20 +- .../24-miscellaneous-parameters.md | 108 ++--- .../guc-parameters/25-wait-events.md | 6 +- .../guc-parameters/26-query.md | 74 +-- .../27-system-performance-snapshot.md | 66 +-- .../27.1-security-configuration.md | 36 +- .../29-global-temporary-table.md | 12 +- .../guc-parameters/29.1-HyperLogLog.md | 54 +-- .../1-connection-settings.md | 80 ++-- .../2-security-and-authentication.md | 178 +++---- .../3-communication-library-parameters.md | 32 +- .../guc-parameters/31-scheduled-task.md | 12 +- .../guc-parameters/32-thread-pool.md | 12 +- .../33-user-defined-functions.md | 26 +- .../34-backup-and-restoration.md | 18 +- .../reference-guide/guc-parameters/35-undo.md | 12 +- .../36-DCF-parameters-settings.md | 202 ++++---- .../guc-parameters/37-flashback.md | 24 +- .../guc-parameters/38-rollback-parameters.md | 6 +- .../guc-parameters/39-reserved-parameters.md | 4 +- .../4-resource-consumption/1-memory.md | 162 +++---- .../4-resource-consumption/2-disk-space.md | 12 +- .../3-kernel-resource-usage.md | 12 +- .../4-cost-based-vacuum-delay.md | 30 +- .../5-background-writer.md | 72 +-- .../6-asynchronous-io-operations.md | 82 ++-- .../guc-parameters/40-AI-features.md | 30 +- .../6-write-ahead-log/1-settings.md | 110 ++--- .../6-write-ahead-log/2-checkpoints.md | 66 +-- .../6-write-ahead-log/3-log-replay.md | 50 +- .../6-write-ahead-log/4-archiving.md | 24 +- .../7-ha-replication/1-sending-server.md | 68 +-- .../7-ha-replication/2-primary-server.md | 98 ++-- .../7-ha-replication/3-standby-server.md | 70 +-- .../reference-guide/guc-parameters/8-mot.md | 36 +- .../1-optimizer-method-configuration.md | 168 +++---- .../2-optimizer-cost-constants.md | 42 +- .../3-genetic-query-optimizer.md | 42 +- .../4-other-optimizer-options.md | 300 ++++++------ .../guc-parameters/cm-parameters/cm_agent.md | 174 +++---- .../guc-parameters/cm-parameters/cm_server.md | 272 +++++------ .../global-syscache-parameters.md | 12 +- .../overview-of-DBE_PLDEBUGGER-schema.md | 24 +- .../sql-reference/2-keywords.md | 4 +- .../4-expressions/1-simple-expressions.md | 2 +- .../4-expressions/4-array-expressions.md | 4 +- .../5-type-conversion/2-operators.md | 4 +- .../5-type-conversion/3-functions.md | 2 +- .../5-type-conversion/4-value-storage.md | 2 +- .../5-union-case-and-related-constructs.md | 6 +- .../1-introduction/2-what-is-a-document.md | 2 +- .../1-manipulating-tsvector.md | 2 +- .../3-rewriting-queries.md | 2 +- .../3-testing-a-dictionary.md | 2 +- .../8-controlling-transactions.md | 2 +- .../sql-reference/9-ddl-syntax-overview.md | 2 +- .../sql-syntax/ALTER-DATABASE.md | 4 +- .../sql-syntax/ALTER-DEFAULT-PRIVILEGES.md | 2 +- .../sql-syntax/ALTER-FOREIGN-TABLE.md | 2 +- .../reference-guide/sql-syntax/ALTER-INDEX.md | 2 +- .../sql-syntax/ALTER-RESOURCE-POOL.md | 6 +- .../sql-syntax/ALTER-TABLE-PARTITION.md | 16 +- .../sql-syntax/ALTER-TABLE-SUBPARTITION.md | 18 +- .../reference-guide/sql-syntax/ALTER-TABLE.md | 30 +- .../sql-syntax/ALTER-TABLESPACE.md | 6 +- .../ALTER-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/ALTER-TRIGGER.md | 2 +- .../reference-guide/sql-syntax/ALTER-TYPE.md | 2 +- .../sql-syntax/ANALYZE-ANALYSE.md | 14 +- .../v3.0/reference-guide/sql-syntax/CALL.md | 2 +- .../v3.0/reference-guide/sql-syntax/COPY.md | 38 +- .../sql-syntax/CREATE-CLIENT-MASTER-KEY.md | 2 +- .../CREATE-COLUMN-ENCRYPTION-KEY.md | 2 +- .../sql-syntax/CREATE-DATABASE.md | 6 +- .../sql-syntax/CREATE-FOREIGN-TABLE.md | 2 +- .../sql-syntax/CREATE-FUNCTION.md | 6 +- .../sql-syntax/CREATE-INDEX.md | 40 +- .../sql-syntax/CREATE-PROCEDURE.md | 6 +- .../sql-syntax/CREATE-RESOURCE-POOL.md | 8 +- .../reference-guide/sql-syntax/CREATE-ROLE.md | 8 +- .../CREATE-ROW-LEVEL-SECURITY-POLICY.md | 2 +- .../sql-syntax/CREATE-SCHEMA.md | 4 +- .../sql-syntax/CREATE-SEQUENCE.md | 4 +- .../sql-syntax/CREATE-SYNONYM.md | 2 +- .../sql-syntax/CREATE-TABLE-AS.md | 2 +- .../sql-syntax/CREATE-TABLE-PARTITION.md | 32 +- .../sql-syntax/CREATE-TABLE-SUBPARTITION.md | 74 +-- .../sql-syntax/CREATE-TABLE.md | 16 +- .../CREATE-TEXT-SEARCH-DICTIONARY.md | 2 +- .../sql-syntax/CREATE-TRIGGER.md | 2 +- .../reference-guide/sql-syntax/CREATE-TYPE.md | 10 +- .../sql-syntax/CREATE-USER-MAPPING.md | 4 +- .../reference-guide/sql-syntax/CREATE-VIEW.md | 2 +- .../sql-syntax/DROP-CLIENT-MASTER-KEY.md | 2 +- .../sql-syntax/DROP-DATABASE.md | 2 +- .../sql-syntax/DROP-RESOURCE-POOL.md | 2 +- .../reference-guide/sql-syntax/DROP-SCHEMA.md | 4 +- .../reference-guide/sql-syntax/DROP-USER.md | 2 +- .../sql-syntax/EXPLAIN-PLAN.md | 4 +- .../v3.0/reference-guide/sql-syntax/GRANT.md | 16 +- .../v3.0/reference-guide/sql-syntax/INSERT.md | 14 +- .../v3.0/reference-guide/sql-syntax/MOVE.md | 2 +- .../reference-guide/sql-syntax/REINDEX.md | 6 +- .../reference-guide/sql-syntax/SELECT-INTO.md | 4 +- .../v3.0/reference-guide/sql-syntax/SELECT.md | 20 +- .../sql-syntax/SET-TRANSACTION.md | 2 +- .../v3.0/reference-guide/sql-syntax/SET.md | 2 +- .../sql-syntax/START-TRANSACTION.md | 2 +- .../reference-guide/sql-syntax/TRUNCATE.md | 2 +- .../v3.0/reference-guide/sql-syntax/UPDATE.md | 2 +- .../v3.0/reference-guide/sql-syntax/VACUUM.md | 4 +- .../supported-data-types/13-HLL.md | 6 +- .../supported-data-types/17-xml-type.md | 2 +- .../5-binary-data-types.md | 2 +- .../supported-data-types/6-date-time-types.md | 2 +- ...iew-of-system-catalogs-and-system-views.md | 16 +- .../system-catalogs/PG_STATISTIC.md | 2 +- .../system-catalogs/PG_STATISTIC_EXT.md | 2 +- .../reference-guide/tool-reference/FAQ.md | 2 +- .../tool-reference/client-tool/1-gsql.md | 20 +- .../server-tools/0-gs_cgroup.md | 16 +- .../tool-reference/server-tools/1-gs_check.md | 6 +- .../server-tools/2-gs_checkos.md | 6 +- .../server-tools/4-gs_collector.md | 6 +- .../tool-reference/server-tools/5-gs_dump.md | 16 +- .../server-tools/6-gs_dumpall.md | 6 +- .../tool-reference/server-tools/7-gs_guc.md | 32 +- .../server-tools/7.1-gs_encrypt.md | 12 +- .../tool-reference/server-tools/8-gs_om.md | 6 +- .../server-tools/9-gs_restore.md | 12 +- .../1-gaussdb.md | 6 +- .../10-gs_tar.md | 2 +- .../11-gs_uninstall.md | 2 +- .../12-gs_upgradectl.md | 2 +- .../13-gs_expansion.md | 4 +- .../15-gs_probackup.md | 14 +- .../16-gstrace.md | 4 +- .../3-gs_basebackup.md | 6 +- .../5-gs_initdb.md | 2 +- .../6-gs_install.md | 2 +- .../7-gs_postuninstall.md | 2 +- .../8-gs_preinstall.md | 8 +- .../9-gs_sshexkey.md | 2 +- .../unified-database-management-tool.md | 440 +++++++++--------- .../1-client-access-authentication.md | 8 +- .../2-managing-users-and-their-permissions.md | 8 +- .../4-setting-encrypted-equality-query.md | 8 +- .../security/5-setting-a-ledger-database.md | 16 +- scripts/test/overview.md | 18 +- 931 files changed, 7585 insertions(+), 7585 deletions(-) diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md index 96f9fe71..6aae374b 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md @@ -11,7 +11,7 @@ date: 2021-03-04 测试使用了BenchmarkSQL（请参见**MOT样例TPC-C基准**），并且使用交互式SQL命令而不是存储过程来生成工作负载。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 评估MogDB MOT性能和磁盘性能的所有测试都使用了同步日志记录和在MOT中优化的group-commit=on版本。 @@ -134,7 +134,7 @@ MOT高吞吐量测试结果如下。 MOT的平均事务速度为2.5倍，MOT延迟为10.5ms，而基于磁盘的表延迟为23至25ms。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 **图 2** 低延迟（90th%，事务平均）性能基准 @@ -152,7 +152,7 @@ MOT完全集成到MogDB中，包括支持主备部署的高可用场景。WAL重 **MogDB（包括MOT）的RTO小于10秒。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ 另外，从[MOT高吞吐量](#MOT高吞吐量)的MOT中可以看出，在Arm/鲲鹏架构下，主从高可用场景复制开销仅为7%，在x86架构下仅为2%，而基于磁盘的表复制开销为2%。Arm/鲲鹏机型为20%，x86机型为15%。 @@ -173,7 +173,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。
diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md index e2f6c514..a5c02b38 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md @@ -74,7 +74,7 @@ MOT不需要任何特殊修改或安装新软件。但是，一些优化可以 MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完全驻留在内存中。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 服务器上必须有足够的物理内存以维持内存表的状态，并满足工作负载和数据的增长。所有这些都是在传统的基于磁盘的引擎、表和会话所需的内存之外的要求。因此，提前规划好足够的内存来容纳这些内容是非常有必要的。 @@ -94,7 +94,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 如果违反此限制，则调整MOT内存内部限制，最大可能地满足上述限制范围。该调整在启动时进行，并据此计算MOT最大内存值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 此时，会向服务器日志发出警告，如下所示： @@ -181,7 +181,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 在配置max_mot_local_memory设置和应用程序开发时，请考虑此场景。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**内存（MOT）**部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**内存（MOT）**部分。
@@ -209,7 +209,7 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 检查点之所以需要两倍大小，是因为快照会保存数据的全部大小到磁盘上，此外还应该为正在进行的检查点分配同样数量的空间。当检查点进程结束时，以前的检查点文件将被删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 - **日志记录** @@ -223,4 +223,4 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低延迟的驱动器上。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**存储（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**存储（MOT）**。 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md index 3ff75fa1..654ded43 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md @@ -297,7 +297,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 阅读**总体原则**，根据需要查看和配置mot.conf文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 以下介绍了mot.conf文件中的各个部分，其包含的设置以及默认值。 @@ -395,7 +395,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 检查点由多个MOT引擎工作线程并行执行。工作线程的数量可能会大大影响整个检查点操作的整体性能，以及其它正在运行的事务的操作。为了实现较短的检查点持续时间，应使用更多线程，直至达到最佳数量（根据硬件和工作负载的不同而不同）。但请注意，如果这个数目太大，可能会对其他正在运行的事务的执行时间产生负面影响。尽可能低这个数字，以最小化对其他运行事务的运行时的影响。当此数目过高时，检查点持续时间会较长。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**MOT检查点**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**MOT检查点**。
@@ -405,7 +405,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 指定在检查点数据恢复期间要使用的工作线程数。每个MOT引擎工作线程在自己的核上运行，通过将不同的表读入内存，可以并行处理不同的表。缺省值为3，可将此参数设置为可处理的核数。恢复后，将停止并杀死这些线程。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**MOT恢复**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**MOT恢复**。
diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md index 3b987d89..ea3b811c 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md @@ -30,7 +30,7 @@ MogDB允许应用程序使用MOT和基于标准磁盘的表。MOT适用于最活 以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次： @@ -96,7 +96,7 @@ create FOREIGN table bmsql_oorder ( create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 有关MOT索引限制，请参见“MOT SQL覆盖和限制”的索引部分内容。 @@ -134,7 +134,7 @@ create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) 6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。 7. 恢复应用程序活动。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
@@ -301,7 +301,7 @@ MOT编译支持的特性和不支持的特性见下文。 在乐观并发控制（OCC）中，在COMMIT阶段前的事务期间（使用任何隔离级别）不会对记录进行锁定。这是一个能显著提高性能的强大优势。它的缺点是，如果另一个会话尝试更新相同的记录，则更新可能会失败。所以必须中止整个事务。这些所谓的更新冲突是由MOT在提交时通过版本检查机制检测到的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 这种更新冲突在常见的OLTP场景中非常少见，在使用MOT时尤其少见。但是，由于仍有可能发生这种情况，开发人员应该考虑使用事务重试代码来解决此问题。 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md index ba7acdb6..0b3f1a37 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md @@ -133,7 +133,7 @@ WAL重做日志将保留所有表行修改，直到执行检查点（如上所 - group_commit_size：一组已提交的事务数。例如，16表示当同一组中的16个事务已由它们的客户端应用程序提交时，则针对16个事务中的每个事务，在磁盘的WAL重做日志中写入一个条目。 - group_commit_timeout：超时时间，单位为毫秒。例如，10表示在10毫秒之后，为同一组由客户端应用程序在最近10毫秒内提交的每个事务，在磁盘的WAL重做日志中写入一个条目。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**重做日志（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**重做日志（MOT）**。
@@ -414,7 +414,7 @@ MOT使用返回码（Return Code，RC）返回Postgres标准错误代码至封 MOT从内部返回Postgres代码（见下文）到数据库包，数据库封装根据标准的Postgres行为对其做出反应。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 **表 2** 返回给用户并记录到日志文件的错误 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md index 74790a9e..906bdff5 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md @@ -47,7 +47,7 @@ tpm-C指标是每分钟执行的新订单事务数。考虑到事务中所需的 tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 ## 系统级优化 @@ -65,7 +65,7 @@ tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 在下载的Java文件（与原始文件相比）中所做的唯一更改是注释错误日志打印，以进行序列化和重复键错误。这些错误在MOT中是正常的，因为MOT使用的是乐观并发控制（OCC）机制。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 基准测试使用标准交互式SQL模式执行，没有存储过程。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 基准测试使用标准交互式SQL模式执行，没有存储过程。 ## 运行基准 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md index a8ebefc5..fe966232 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md @@ -17,7 +17,7 @@ MOT旨在实现以下目标： - **线性扩容**：MOT提供事务性存储引擎，利用单个NUMA架构服务器的所有核，以提供近线性的扩容性能。这意味着MOT的目标是在机器的核数和性能提升倍数之间实现直接的、近线性的关系。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md index 6d5f4565..b8a2a234 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md @@ -9,7 +9,7 @@ date: 2021-03-04 通过大量研究，我们找到了最佳的并发控制机制，结论为：基于SILO的OCC算法是MOT中最符合ACID特性的OCC算法。SILO为满足MOT的挑战性需求提供了最好的基础。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 下面介绍MOT的并发控制机制。 diff --git a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md index f76fd7d2..11d0fb72 100644 --- a/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md +++ b/product/zh/docs-mogdb/v1.1.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md @@ -40,7 +40,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 - 在恢复期间，从最后一个已知或特定检查点加载数据；然后使用WAL重做日志完成从该点开始发生的数据更改。 - WAL重做日志将保留所有表行修改，直到执行一个检查点为止（如上所述）。然后可以截断日志，以减少恢复时间和节省磁盘空间。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。
@@ -86,7 +86,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 这样，将事务写入WAL更为有效，因为来自同一个槽位的所有缓冲区都一起写入磁盘。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 2. 在事务完成并且客户端应用程序发送Commit命令之后，事务重做日志条目将与属于同一组的其他事务一起序列化。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md index f80b8ad6..38fe73a1 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 有效值为stderr、csvlog、syslog。 @@ -27,7 +27,7 @@ date: 2021-04-20 local0.* /var/log/postgresql ``` -**默认值:**stderr +**默认值**: stderr ## logging_collector @@ -40,12 +40,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 将服务器日志发送到stderr时可以不使用logging_collector参数，此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难，只适用于较小的日志容量。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启日志收集功能。 - off表示关闭日志收集功能。 -**默认值:**on +**默认值**: on ## log_directory @@ -62,9 +62,9 @@ date: 2021-04-20 > 合法路径: 用户对此路径有读写权限 > 非法路径: 用户对此路径无读写权限 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**安装时指定。 +**默认值**: 安装时指定。 ## log_filename @@ -77,13 +77,13 @@ date: 2021-04-20 > - 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 > - 当log_destination设为csvlog时，系统会生成附加了时间戳的日志文件名，文件格式为csv格式，例如"server_log.1093827753.csv"。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgresql-%Y-%m-%d_%H%M%S.log +**默认值**: postgresql-%Y-%m-%d_%H%M%S.log ## log_file_mode -**参数说明:**[logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 +**参数说明:** [logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -92,14 +92,14 @@ date: 2021-04-20 > - 使用此选项前请设置log_directory，将日志存储到数据目录之外的地方。 > - 因日志文件可能含有敏感数据，故不能将其设为对外可读。 -**取值范围:**整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 +**取值范围**: 整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 0600表示只允许服务器管理员读写日志文件。 > - 0640表示允许管理员所在用户组成员只能读日志文件。 -**默认值:**0600 +**默认值**: 0600 ## log_truncate_on_rotation @@ -111,12 +111,12 @@ date: 2021-04-20 假设日志需要保留7天，每天生成一个日志文件，日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。设置方法: 将log_filename设置为server_log.%a ，log_truncate_on_rotation设置为on，log_rotation_age设置为1440，即日志有效时间为1天。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on表示MogDB以覆盖写入的方式写服务器日志消息。 - off表示MogDB将日志消息附加到同名的现有日志文件上。 -**默认值:**off +**默认值**: off ## log_rotation_age @@ -124,9 +124,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 +**取值范围**: 整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 -**默认值:**1440(min) +**默认值**: 1440(min) ## log_rotation_size @@ -134,13 +134,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX / 1024，单位为kB。 +**取值范围**: 整型，0 ~ INT_MAX / 1024，单位为kB。 0表示关闭基于容量的新日志文件的创建。 建议该值大小设置级别至少为MB级,利于日志文件的及时划分。 -**默认值:**20MB +**默认值**: 20MB ## syslog_facility @@ -148,19 +148,19 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 +**取值范围**: 枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 -**默认值:**local0 +**默认值**: local0 ## syslog_ident -**参数说明:**[log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 +**参数说明:** [log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## event_source @@ -168,6 +168,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PostgreSQL +**默认值**: PostgreSQL diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md index 22059d3d..8aec66b7 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md @@ -16,9 +16,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当client_min_messages和[log_min_messages](#log_min_messages)取相同值时，其值所代表的级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 -**默认值:**notice +**默认值**: notice ## log_min_messages @@ -29,9 +29,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当[client_min_messages](#client_min_messages)和log_min_messages取相同值log时所代表的消息级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**warning +**默认值**: warning ## log_min_error_statement @@ -39,14 +39,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为error ，表示导致错误、日志消息、致命错误、panic的语句都将被记录。 > - 设置为panic，表示关闭此特性。 -**默认值:**error +**默认值**: error ## log_min_duration_statement @@ -59,13 +59,13 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当此选项与log_statement同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用log_line_prefix记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。 -**取值范围:**整型，-1 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，-1 ~ INT_MAX，单位为毫秒。 - 设置为250，所有运行时间不短于250ms的SQL语句都会被记录。 - 设置为0，输出所有语句的持续时间。 - 设置为-1，关闭此功能。 -**默认值:**30min +**默认值**: 30min ## backtrace_min_messages @@ -76,11 +76,11 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**panic +**默认值**: panic [表1](#信息严重程度分类)解释MogDB中使用的消息安全级别。当日志输出到syslog或者eventlog(仅windows环境下, MogDB版本不涉及该参数)时，MogDB进行如表中的转换。 @@ -106,10 +106,10 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数以毫秒为单位的，建议在使用过程中设置值为1000的整数倍，即设置值以秒为最小单位。该参数所控制的性能日志文件以prf为扩展名，文件放置在$GAUSSLOG/gs_profile/ 目录下面，其中node_name是由postgres.conf文件中的pgxc_node_name的值，不建议外部使用该参数。 -**取值范围:**0~2147483647，单位为毫秒（ms）。 +**取值范围**: 0~2147483647，单位为毫秒（ms）。 当设置为0时，当前会话不再输出性能日志数据。当设置为非0时，当前会话按照指定的时间周期进行输出性能日志数据。 该参数设置得越小，输出的日志数据越多，对性能的负面影响越大。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md index 6cfa71b6..6770a60e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_rewritten @@ -26,12 +26,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_plan @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示进行缩进。 - off表示不进行缩进。 -**默认值:**on +**默认值**: on ## log_checkpoints @@ -71,12 +71,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量。 - off表示关闭此参数时，服务器日志消息包含不涉及检查点和重启点的统计量。 -**默认值:**off +**默认值**: off ## log_connections @@ -87,12 +87,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 有些客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中重复的"connection receive"（收到连接请求）并不意味着一定是问题。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_disconnections @@ -100,12 +100,12 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_duration @@ -113,12 +113,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - 设置为off ，该选项与log_min_duration_statement的不同之处在于log_min_duration_statement强制记录查询文本。 - 设置为on并且log_min_duration_statement大于零，记录所有持续时间，但是仅记录超过阈值的语句。这可用于在高负载情况下搜集统计信息。 -**默认值:**on +**默认值**: on ## log_error_verbosity @@ -126,13 +126,13 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - terse输出不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose输出包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 - default输出包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录，不包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 -**默认值:**default +**默认值**: default ## log_hostname @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以同时记录主机名。 - off表示不可以同时记录主机名。 -**默认值:**on +**默认值**: on ## log_line_prefix @@ -188,9 +188,9 @@ FROM pg_stat_activity; - 当log_line_prefix设置为非空值时，请将其最后一个字符作为一个独立的段，以此来直观地与后续的日志进行区分，也可以使用一个标点符号。 - Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**%m %c %d %p %a %x %n %e +**默认值**: %m %c %d %p %a %x %n %e ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -202,12 +202,12 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录此信息。 - off表示不记录此信息。 -**默认值:**off +**默认值**: off ## log_statement @@ -219,14 +219,14 @@ FROM pg_stat_activity; 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，在执行阶段之前（语法分析或规划阶段）同样不会记录。将log_min_error_statement设为ERROR或更低才能记录这些语句。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - none表示不记录语句。 - ddl表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 - mod表示记录所有DDL语句，还包括数据修改语句INSERT、UPDATE、DELETE、TRUNCATE和COPY FROM 。 - all表示记录所有语句，PREPARE、EXECUTE和EXPLAIN ANALYZE语句也同样被记录。 -**默认值:**none +**默认值**: none ## log_temp_files @@ -234,13 +234,13 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为-1，最大值2147483647，单位KB。 +**取值范围**: 整型，最小值为-1，最大值2147483647，单位KB。 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 值0 表示记录所有的临时文件的删除信息。 - 值-1 表示不记录任何临时文件的删除信息。 -**默认值:**-1 +**默认值**: -1 ## log_timezone @@ -248,9 +248,9 @@ FROM pg_stat_activity; 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PRC +**默认值**: PRC ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -262,9 +262,9 @@ gs_initdb进行相应系统环境设置时会对默认值进行修改。 该参数属于USERSET类型参数，设置请参考表[GUC参数分类](30-appendix)中对应设置的方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 +**默认值**: 所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 **设置方法**: 首先，可以通过SHOW logging_module来查看哪些模块是支持可控制的。例如，查询输出结果为: @@ -312,7 +312,7 @@ mogdb=# show logging_module; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - off表示不打开该功能。 - log表示打开该功能，可以在数据库节点的执行计划中看到没有查询优化的具体原因。 @@ -321,4 +321,4 @@ mogdb=# show logging_module; 提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，log_min_messages设置成debug4级别，logging_module设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/11-alarm-detection.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/11-alarm-detection.md index 111da898..c8242845 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/11-alarm-detection.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/11-alarm-detection.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许打开告警检测线程。 - off表示不允许打开告警检测线程。 -**默认值:**on +**默认值**: on ## connection_alarm_rate @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0~1.0 +**取值范围**: 浮点型，0.0~1.0 -**默认值:**0.9 +**默认值**: 0.9 ## alarm_report_interval @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为秒。 +**取值范围**: 整型，单位为秒。 -**默认值:**10 +**默认值**: 10 ## alarm_component @@ -48,6 +48,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**/opt/huawei/snas/bin/snas_cm_cmd +**默认值**: /opt/huawei/snas/bin/snas_cm_cmd diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md index f536426c..4481362a 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 -**默认值:**on +**默认值**: on ## track_counts @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 在AutoVacuum自动清理进程中选择清理的数据库时，需要数据库的统计数据，故默认值设为on。 -**默认值:**on +**默认值**: on ## track_io_timing @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 - off表示关闭收集功能。 -**默认值:**off +**默认值**: off ## track_functions @@ -62,13 +62,13 @@ date: 2021-04-20 > > 当SQL语言函数设置为调用查询的"内联"函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - pl表示只追踪过程语言函数。 - all表示追踪SQL语言函数。 - none表示关闭函数追踪功能。 -**默认值:**none +**默认值**: none ## track_activity_query_size @@ -76,9 +76,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～102400 +**取值范围**: 整型，100～102400 -**默认值:**1024 +**默认值**: 1024 ## stats_temp_directory @@ -90,9 +90,9 @@ date: 2021-04-20 > > 将其设置为一个基于RAM的文件系统目录会减少实际的I/O开销并可以提升其性能。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_stat_tmp +**默认值**: pg_stat_tmp ## track_thread_wait_status_interval @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0～1天，单位为min。 +**取值范围**: 0～1天，单位为min。 -**默认值:**30min +**默认值**: 30min ## enable_save_datachanged_timestamp @@ -110,12 +110,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许收集相关操作对表数据改动的时间。 - off表示禁止收集相关操作对表数据改动的时间。 -**默认值:**on +**默认值**: on ## track_sql_count @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启计数功能。 - off表示关闭计数功能。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md index 9952a976..023ffa7e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md @@ -27,7 +27,7 @@ date: 2021-04-20 > - log_statement_stats记录总的语句统计数据，而其他的只记录针对每个模块的统计数据。 > - log_statement_stats不能和其他任何针对每个模块统计的选项一起打开。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启记录性能统计数据的功能。 - off表示关闭记录性能统计数据的功能。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/13-load-management.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/13-load-management.md index a681044e..a0fec023 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/13-load-management.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/13-load-management.md @@ -30,7 +30,7 @@ date: 2021-04-20 > select gs_wlm_readjust_user_space(0); > ``` -**默认值:**off +**默认值**: off ## cgroup_name @@ -46,7 +46,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**InvalidGroup +**默认值**: InvalidGroup ## cpu_collect_timer @@ -58,7 +58,7 @@ date: 2021-04-20 **取值范围**: 整型，1 ～ INT_MAX， 单位为秒。 -**默认值:**30 +**默认值**: 30 ## memory_tracking_mode @@ -73,7 +73,7 @@ date: 2021-04-20 - executor，生成统计文件，包含执行层使用过的所有已分配内存的上下文信息。 - fullexec，生成文件包含执行层申请过的所有内存上下文信息。 -**默认值:**none +**默认值**: none ## memory_detail_tracking @@ -83,7 +83,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -100,7 +100,7 @@ date: 2021-04-20 - on表示打开资源监控。 - off表示关闭资源监控。 -**默认值:**on +**默认值**: on ## enable_resource_record @@ -113,7 +113,7 @@ date: 2021-04-20 - on表示开启资源监控记录归档功能。 - off表示关闭资源监控记录归档功能。 -**默认值:**off +**默认值**: off ## enable_logical_io_statistics @@ -126,7 +126,7 @@ date: 2021-04-20 - on表示开启资源监控逻辑IO统计功能。 - off表示关闭资源监控逻辑IO统计功能。 -**默认值:**on +**默认值**: on ## enable_user_metric_persistent @@ -167,7 +167,7 @@ date: 2021-04-20 - on表示开启实例资源监控转存功能。 - off表示关闭实例资源监控转存功能。 -**默认值:**on +**默认值**: on ## instance_metric_retention_time @@ -180,7 +180,7 @@ date: 2021-04-20 - 值等于0时，实例历史资源监控数据将永久保存。 - 值大于0时，实例历史资源监控数据将保存对应设置天数。 -**默认值:**7 +**默认值**: 7 ## resource_track_level @@ -194,7 +194,7 @@ date: 2021-04-20 - query，开启query级别资源监控功能。 - operator，开启query级别和算子级别资源监控功能。 -**默认值:**query +**默认值**: query ## resource_track_cost @@ -208,7 +208,7 @@ date: 2021-04-20 - 值大于或等于0时，值大于或等于0且小于等于9时，对执行代价大于等于10的语句进行资源监控。 - 值大于或等于10时，对执行代价超过该参数值的语句进行资源监控。 -**默认值:**100000 +**默认值**: 100000 ## resource_track_duration @@ -221,7 +221,7 @@ date: 2021-04-20 - 值为0时，资源监控实时视图中记录的所有语句都进行历史信息归档。 - 值大于0时，资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。 -**默认值:**1min +**默认值**: 1min ## disable_memory_protect @@ -234,7 +234,7 @@ date: 2021-04-20 - on表示禁止内存保护功能。 - off表示启动内存保护功能。 -**默认值:**off +**默认值**: off ## query_band @@ -244,7 +244,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 ## enable_bbox_dump @@ -257,7 +257,7 @@ date: 2021-04-20 - on表示打开黑匣子功能。 - off表示关闭黑匣子功能。 -**默认值:**off +**默认值**: off ## bbox_dump_count @@ -267,7 +267,7 @@ date: 2021-04-20 **取值范围**: 整型，1～20 -**默认值:**8 +**默认值**: 8 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -281,7 +281,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 +**默认值**: 空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 ## enable_ffic_log @@ -294,7 +294,7 @@ date: 2021-04-20 - on表示打开FFIC功能。 - off表示关闭FFIC功能。 -**默认值:**on +**默认值**: on ## io_limits @@ -304,7 +304,7 @@ date: 2021-04-20 **取值范围**: 整型，0～1073741823 -**默认值:**0 +**默认值**: 0 ## io_priority @@ -319,7 +319,7 @@ date: 2021-04-20 - Medium: 表示限制iops为该作业原始触发数值的20%。 - High: 表示限制iops为该作业原始触发数值的50%。 -**默认值:**None +**默认值**: None ## io_control_unit @@ -331,7 +331,7 @@ date: 2021-04-20 **取值范围**: 整型，1000~1000000 -**默认值:**6000 +**默认值**: 6000 ## session_respool @@ -347,7 +347,7 @@ date: 2021-04-20 **取值范围**: string类型，通过create resource pool所设置的资源池。 -**默认值:**invalid_pool +**默认值**: invalid_pool ## session_statistics_memory @@ -357,7 +357,7 @@ date: 2021-04-20 **取值范围**: 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**5MB +**默认值**: 5MB ## topsql_retention_time @@ -380,7 +380,7 @@ date: 2021-04-20 **取值范围**: 整型，10 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**10MB +**默认值**: 10MB ## transaction_pending_time @@ -393,4 +393,4 @@ date: 2021-04-20 - 值为-1或0: 事务块语句和存储过程语句无超时判断，排队至资源满足可执行条件。 - 值大于0: 事务块语句和存储过程语句排队超过所设数值的时间后，无视当前资源情况强制执行。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/14-automatic-vacuuming.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/14-automatic-vacuuming.md index 87905df1..1f0ad172 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/14-automatic-vacuuming.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/14-automatic-vacuuming.md @@ -24,12 +24,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理进程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启数据库自动清理进程。 - off表示关闭数据库自动清理进程。 -**默认值:**on +**默认值**: on ## autovacuum_mode @@ -37,14 +37,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - analyze表示只做autoanalyze。 - vacuum表示只做autovacuum。 - mix表示autoanalyze和autovacuum都做。 - none表示二者都不做。 -**默认值:**mix +**默认值**: mix ## autoanalyze_timeout @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**int类型，单位是s，0~2147483。 +**取值范围**: int类型，单位是s，0~2147483。 -**默认值:**5min（即300s） +**默认值**: 5min（即300s） ## autovacuum_io_limits @@ -62,9 +62,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 +**取值范围**: 整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 -**默认值:**-1 +**默认值**: -1 ## log_autovacuum_min_duration @@ -76,13 +76,13 @@ date: 2021-04-20 将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。 -**取值范围:**整型，最小值为-1，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为-1，最大值为2147483647，单位为毫秒。 - 当参数设置为0时，表示所有的自动清理操作都记录到日志中。 - 当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。 - 当参数设置为非-1时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。 -**默认值:**-1 +**默认值**: -1 ## autovacuum_max_workers @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 +**取值范围**: 整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 -**默认值:**3 +**默认值**: 3 ## autovacuum_naptime @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为s，最小值为1，最大值为2147483。 +**取值范围**: 整型，单位为s，最小值为1，最大值为2147483。 -**默认值:**10min（即600s） +**默认值**: 10min（即600s） ## autovacuum_vacuum_threshold @@ -110,9 +110,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_analyze_threshold @@ -120,9 +120,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_vacuum_scale_factor @@ -130,9 +130,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.2 +**默认值**: 0.2 ## autovacuum_analyze_scale_factor @@ -140,9 +140,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.1 +**默认值**: 0.1 ## autovacuum_freeze_max_age @@ -155,7 +155,7 @@ date: 2021-04-20 **取值范围: 长**整型，100 000～576 460 752 303 423 487 -**默认值:**20000000000 +**默认值**: 20000000000 ## autovacuum_vacuum_cost_delay @@ -163,9 +163,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 +**取值范围**: 整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 -**默认值:**20ms +**默认值**: 20ms ## autovacuum_vacuum_cost_limit @@ -173,14 +173,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 +**取值范围**: 整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 -**默认值:**-1 +**默认值**: -1 ## defer_csn_cleanup_time **参数说明:**用来指定本地回收时间间隔，单位为毫秒（ms）。 -**取值范围:**整型，0~INT_MAX。 +**取值范围**: 整型，0~INT_MAX。 **默认值**: 5s（即5000ms） diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md index 6670e91c..fef11502 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md @@ -20,7 +20,7 @@ date: 2021-04-20 - 当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。 - 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -28,7 +28,7 @@ date: 2021-04-20 > - 设置为空串（"）的时候，系统会自动转换成一对双引号。 > - 设置的内容中包含双引号，系统会认为是不安全字符，会将每个双引号转换成一对双引号。 -**默认值:**\"$user",public +**默认值**: \"$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -39,9 +39,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**"\$user",public +**默认值**: "\$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -58,9 +58,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空表示使用默认表空间。 +**取值范围**: 字符串，其中空表示使用默认表空间。 -**默认值:**空 +**默认值**: 空 ## default_storage_nodegroup @@ -71,9 +71,9 @@ date: 2021-04-20 - 值为"installation"表示建表会默认建在安装的Node Group上。 - 值为其他字符串表示建表会默认建在设置的Node Group上。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**installation +**默认值**: installation ## temp_tablespaces @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 +**取值范围**: 字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 -**默认值:**空 +**默认值**: 空 ## check_function_bodies @@ -93,12 +93,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 - off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 -**默认值:**on +**默认值**: on ## default_transaction_isolation @@ -106,13 +106,13 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - read committed表示事务读已提交。 - repeatable read表示事务可重复读。 - serializable，MogDB目前功能上不支持此隔离级别，等价于repeatable read。 -**默认值:**read committed +**默认值**: read committed ## default_transaction_read_only @@ -120,12 +120,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示只读状态。 - off表示非只读状态。 -**默认值:**off +**默认值**: off ## default_transaction_deferrable @@ -135,12 +135,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示默认延迟。 - off表示默认不延迟。 -**默认值:**off +**默认值**: off ## session_replication_role @@ -151,13 +151,13 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 设置此参数会丢弃之前任何缓存的执行计划。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - origin表示从当前会话中复制插入、删除、更新等操作。 - replica表示从其他地方复制插入、删除、更新等操作到当前会话。 - local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。 -**默认值:**origin +**默认值**: origin ## statement_timeout @@ -165,9 +165,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为0，最大值为2147483647，单位为毫秒。 -**默认值:**0 +**默认值**: 0 ## vacuum_freeze_min_age @@ -175,12 +175,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为0到10亿之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 -**默认值:**5000000000 +**默认值**: 5000000000 ## vacuum_freeze_table_age @@ -188,12 +188,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为零到20亿之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。 -**默认值:**15000000000 +**默认值**: 15000000000 ## bytea_output @@ -201,12 +201,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - hex: 将二进制数据编码为每字节2位十六进制数字。 - escape: 传统化的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法，同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 -**默认值:**hex +**默认值**: hex ## xmlbinary @@ -214,12 +214,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - base64 - hex -**默认值:**base64 +**默认值**: base64 ## xmloption @@ -227,12 +227,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - document: 表示HTML格式的文档。 - content: 普通的字符串。 -**默认值:**content +**默认值**: content ## max_compile_functions @@ -240,9 +240,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，取值必须大于等于1。 +**取值范围**: 整型，取值必须大于等于1。 -**默认值:**1000 +**默认值**: 1000 ## gin_pending_list_limit @@ -250,6 +250,6 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为64，最大值为INT_MAX，单位为KB。 +**取值范围**: 整型，最小值为64，最大值为INT_MAX，单位为KB。 -**默认值:**4MB +**默认值**: 4MB diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md index 5e5009cd..59b85cb1 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请**参考表GUC参数设置方式**中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**ISO, MDY +**默认值**: ISO, MDY > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb会将这个参数初始化成与[lc_time](#lc_time)一致的值。 @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - sql_standard表示产生与SQL标准规定匹配的输出。 - postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当[DateStyle](#DateStyle)参数被设为ISO时。 @@ -43,7 +43,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > IntervalStyle参数也会影响不明确的间隔输入的说明。 -**默认值:**postgres +**默认值**: postgres ## TimeZone @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 -**默认值:**PRC +**默认值**: PRC > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb将设置一个与其系统环境一致的时区值。 @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图pg_timezone_names获得。 +**取值范围**: 字符串，可查询视图pg_timezone_names获得。 -**默认值:**Default +**默认值**: Default > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。 @@ -77,14 +77,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-15～3 +**取值范围**: 整型，-15～3 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。 > - 设置为负数，表示消除不需要的数据位。 -**默认值:**0 +**默认值**: 0 ## client_encoding @@ -94,7 +94,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 +**取值范围**: 兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -102,7 +102,7 @@ date: 2021-04-20 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 > - 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证MogDB内部通信编码格式一致。 -**默认值:**UTF8 +**默认值**: UTF8 **推荐值:**SQL_ASCII/UTF8 @@ -116,14 +116,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_monetary @@ -131,14 +131,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_numeric @@ -146,14 +146,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_time @@ -161,14 +161,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## default_text_search_config @@ -182,9 +182,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > MogDB支持pg_catalog.english，pg_catalog.simple两种配置。 -**默认值:**pg_catalog.english +**默认值**: pg_catalog.english diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md index 86e28546..4dab1265 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md @@ -26,7 +26,7 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 设置为空字符串，表示关闭自动路径搜索。 -**默认值:** \$libdir +**默认值**: \$libdir ## gin_fuzzy_search_limit @@ -34,9 +34,9 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值:**0 +**默认值**: 0 ## local_preload_libraries @@ -49,6 +49,6 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于BACKEND类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/16-lock-management.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/16-lock-management.md index 68622a4c..c580221b 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/16-lock-management.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/16-lock-management.md @@ -18,9 +18,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~2147483647，单位为毫秒（ms）。 +**取值范围**: 整型，1~2147483647，单位为毫秒（ms）。 -**默认值:**1s +**默认值**: 1s ## lockwait_timeout @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**20min +**默认值**: 20min ## update_lockwait_timeout @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**2min +**默认值**: 2min ## max_locks_per_transaction @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**256 +**默认值**: 256 ## max_pred_locks_per_transaction @@ -65,9 +65,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**64 +**默认值**: 64 ## partition_lock_upgrade_timeout @@ -83,17 +83,17 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值-1，最大值3000，单位为秒（s）。 +**取值范围**: 整型，最小值-1，最大值3000，单位为秒（s）。 -**默认值:**1800 +**默认值**: 1800 ## fault_mon_timeout **参数说明:**轻量级死锁检测周期。该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值0，最大值1440，单位为分钟（min） +**取值范围**: 整型，最小值0，最大值1440，单位为分钟（min） -**默认值:**5min +**默认值**: 5min ## enable_online_ddl_waitlock @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启。 - off表示关闭。 -**默认值:**off +**默认值**: off ## xloginsert_locks diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md index 8efb7b8d..b3a1826c 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md @@ -15,12 +15,12 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许向数组中输入空元素。 - off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。 -**默认值:**on +**默认值**: on ## backslash_quote @@ -31,13 +31,13 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'…'）。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - on表示一直允许使用\'表示。 - off表示拒绝使用\'表示。 - safe_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\\的ASCII值时允许。 -**默认值:**safe_encoding +**默认值**: safe_encoding ## escape_string_warning @@ -48,9 +48,9 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## lo_compat_privileges @@ -58,11 +58,11 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。 -**默认值:**off +**默认值**: off ## quote_all_identifiers @@ -70,12 +70,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开强制引用。 - off表示关闭强制引用。 -**默认值:**off +**默认值**: off ## sql_inheritance @@ -83,12 +83,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以访问子表。 - off表示不访问子表。 -**默认值:**on +**默认值**: on ## standard_conforming_strings @@ -99,12 +99,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**on +**默认值**: on ## synchronize_seqscans @@ -112,12 +112,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示扫描可能从表的中间开始，然后选择"环绕"方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 - off表示确保顺序扫描是从表头开始的。 -**默认值:**on +**默认值**: on ## enable_beta_features @@ -125,9 +125,9 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 - off表示禁止使用这些特性。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md index edd3190e..7933c67a 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md @@ -18,12 +18,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。 - off表示不控制，即expr = NULL总是返回NULL（未知）。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 @@ -34,12 +34,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示支持数据库的扩展特性。 - off表示不支持数据库的扩展特性。 -**默认值:**off +**默认值**: off ## td_compatible_truncation @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启动超长字符串自动截断功能。 - off表示停止超长字符串自动截断功能。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/18-fault-tolerance.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/18-fault-tolerance.md index 2a050f5d..1583f0ad 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/18-fault-tolerance.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/18-fault-tolerance.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示ERROR级别报错会升级为PANIC报错。 - off表示不会对ERROR级别报错进行升级。 -**默认值:**off +**默认值**: off ## restart_after_crash @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示能够最大限度地提高数据库的可用性。 @@ -36,7 +36,7 @@ date: 2021-04-20 - off表示能够使得管理工具在后端进程崩溃时获取控制权并采取适当的措施进行处理。 -**默认值:**on +**默认值**: on ## omit_encoding_error @@ -44,12 +44,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 - off表示有转换错误的字符不能被转换，打印错误信息到终端。 -**默认值:**off +**默认值**: off ## max_query_retry_times @@ -57,9 +57,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~20。 +**取值范围**: 整型，0~20。 -**默认值:**0 +**默认值**: 0 ## cn_send_buffer_size @@ -67,9 +67,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~128， 单位为KB。 +**取值范围**: 整型，8~128， 单位为KB。 -**默认值:**8KB +**默认值**: 8KB ## max_cn_temp_file_size @@ -77,9 +77,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~10485760， 单位为KB。 +**取值范围**: 整型，0~10485760， 单位为KB。 -**默认值:**5GB +**默认值**: 5GB ## retry_ecode_list @@ -87,9 +87,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 +**默认值**: YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 ## data_sync_retry @@ -97,9 +97,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 - off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/19-connection-pool-parameters.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/19-connection-pool-parameters.md index 239290f1..9ca00093 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/19-connection-pool-parameters.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/19-connection-pool-parameters.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为INT_MAX，最小单位为秒。 +**取值范围**: 整型，最小值为0，最大值为INT_MAX，最小单位为秒。 -**默认值:**10min +**默认值**: 10min ## minimum_pool_size @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为65535 +**取值范围**: 整型，最小值为1，最大值为65535 -**默认值:**50 +**默认值**: 50 ## cache_connection @@ -35,9 +35,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示回收连接池的连接。 - off表示不回收连接池的连接。 -**默认值:**on +**默认值**: on diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/2-file-location.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/2-file-location.md index 964b0a71..99c3a3bc 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/2-file-location.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/2-file-location.md @@ -16,54 +16,54 @@ date: 2021-04-20 ## data_directory -**参数说明:**设置MogDB的数据目录（data目录）。此参数可以通过如下方式指定。 +**参数说明:** 设置MogDB的数据目录（data目录）。此参数可以通过如下方式指定。 - 在安装MogDB时指定。 - 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**安装时指定，如果在安装时不指定，则默认不初始化数据库。 +**默认值**: 安装时指定，如果在安装时不指定，则默认不初始化数据库。 ## config_file -**参数说明:**设置主服务器配置文件名称（postgresql.conf）。 +**参数说明:** 设置主服务器配置文件名称（postgresql.conf）。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**postgresql.conf(实际安装可能带有绝对目录) +**默认值**: postgresql.conf(实际安装可能带有绝对目录) ## hba_file -**参数说明:**设置基于主机认证（HBA）的配置文件（pg_hba.conf）。此参数只能在配置文件postgresql.conf中指定。 +**参数说明:** 设置基于主机认证（HBA）的配置文件（pg_hba.conf）。此参数只能在配置文件postgresql.conf中指定。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_hba.conf(实际安装可能带有绝对目录) +**默认值**: pg_hba.conf(实际安装可能带有绝对目录) ## ident_file -**参数说明:**设置用于客户端认证的配置文件的名称（pg_ident.conf）。 +**参数说明:** 设置用于客户端认证的配置文件的名称（pg_ident.conf）。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_ident.conf(实际安装可能带有绝对目录) +**默认值**: pg_ident.conf(实际安装可能带有绝对目录) ## external_pid_file -**参数说明:**声明可被服务器管理程序使用的额外PID文件。 +**参数说明:** 声明可被服务器管理程序使用的额外PID文件。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 这个参数只能在数据库服务重新启动后生效。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/20-MogDB-transaction.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/20-MogDB-transaction.md index e38305b2..2410f49c 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/20-MogDB-transaction.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/20-MogDB-transaction.md @@ -15,14 +15,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，只识别以下字符串，大小写空格敏感: +**取值范围**: 字符串，只识别以下字符串，大小写空格敏感: - serializable: MogDB中等价于REPEATABLE READ。 - read committed: 只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 - repeatable read: 仅能读取事务开始之前提交的数据，不能读取未提交的数据以及在事务执行期间由其它并发事务提交的修改。 - default: 设置为default_transaction_isolation所设隔离级别。 -**默认值:**read committed +**默认值**: read committed ## transaction_read_only @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示设置当前事务为只读事务。 - off表示该事务可以是非只读事务。 -**默认值:**off +**默认值**: off ## xc_maintenance_mode @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，仅支持表[GUC参数分类](30-appendix)中的方式三进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -54,7 +54,7 @@ date: 2021-04-20 > > 谨慎打开这个开关，避免引起MogDB数据不一致。 -**默认值:**off +**默认值**: off ## allow_concurrent_tuple_update @@ -62,12 +62,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 -**默认值:**on +**默认值**: on ## transaction_deferrable @@ -75,12 +75,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许执行。 - off表示不允许执行。 -**默认值:**off +**默认值**: off ## enforce_two_phase_commit @@ -88,12 +88,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示强制使用两阶段提交。 - off表示不强制使用两阶段提交。 -**默认值:**on +**默认值**: on ## enable_show_any_tuples @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示表中元组的所有版本都会可见。 - off/false表示表中元组的所有版本都不可见。 -**默认值:**off +**默认值**: off ## replication_type @@ -116,10 +116,10 @@ date: 2021-04-20 该参数用户不能自己去设置参数值。 -**取值范围:**0~2 +**取值范围**: 0~2 - 2 表示单主机模式，此模式无法扩展备机。 - 1 表示使用一主多备模式，全场景覆盖，推荐使用。 - 0 表示主备从模式，目前此模式暂不支持。 -**默认值:**1 +**默认值**: 1 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/21-developer-options.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/21-developer-options.md index 7fef3c8f..b3a7e8ff 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/21-developer-options.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/21-developer-options.md @@ -15,12 +15,12 @@ date: 2021-04-20 不建议修改该参数默认值，如果设置为on，可能导致系统表损坏，甚至数据库无法启动。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许修改系统表的结构。 - off表示不允许修改系统表的结构。 -**默认值:**off +**默认值**: off ## debug_assertions @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开断言检查。 - off表示不打开断言检查。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 当启用断言选项编译MogDB时，debug_assertions缺省值为on 。 -**默认值:**off +**默认值**: off ## ignore_checksum_failure @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略数据校验错误。 - off表示数据校验错误正常报错。 -**默认值:**off +**默认值**: off ## enable_force_vector_engine @@ -75,9 +75,9 @@ date: 2021-04-20 > > 这个参数的取值必须是绝对路径加上.csv格式的文件名。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## explain_perf_mode @@ -104,12 +104,12 @@ date: 2021-04-20 > > 这个参数在从系统索引被破坏的表中恢复数据的时候非常有用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略系统索引。 - off表示不忽略系统索引。 -**默认值:**off +**默认值**: off ## post_auth_delay @@ -117,9 +117,9 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147，单位为秒。 +**取值范围**: 整型，最小值为0，最大值为2147，单位为秒。 -**默认值:**0 +**默认值**: 0 ## pre_auth_delay @@ -127,9 +127,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0～60，单位为秒。 +**取值范围**: 整型，最小值为0～60，单位为秒。 -**默认值:**0 +**默认值**: 0 ## trace_notify @@ -137,12 +137,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开输出功能。 - off表示关闭输出功能。 -**默认值:**off +**默认值**: off ## trace_recovery_messages @@ -150,9 +150,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 +**取值范围**: 枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 -**默认值:**log +**默认值**: log > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -165,12 +165,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**off +**默认值**: off ## zero_damaged_pages @@ -178,11 +178,11 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 -**默认值:**off +**默认值**: off ## string_hash_compatible @@ -221,7 +221,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示优先将字符串转为数字。 - off表示不优先将字符串转为数字。 @@ -291,12 +291,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值:**off +**默认值**: off ## enable_global_stats @@ -304,12 +304,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示全局统计信息。 - off/false表示数据库节点统计信息。 -**默认值:**on +**默认值**: on ## enable_fast_numeric @@ -317,12 +317,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启Numeric优化。 - off/false表示关闭Numeric优化。 -**默认值:**on +**默认值**: on ## rewrite_rule @@ -351,12 +351,12 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启下盘优化。 - off/false表示关闭下盘优化。 -**默认值:**on +**默认值**: on ## analysis_options @@ -364,13 +364,13 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 - LLVM_COMPILE表示在explain performance显示界面中显示每个线程的codegen编译时间。 - HASH_CONFLICT表示在数据库节点进程的pg_log目录中的log日志中显示hash表的统计信息，包括hash表大小，hash链长，hash冲突情况。 - STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 -**默认值:**ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 +**默认值**: ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** 设置时，选择开启或者关闭的选项请使用'on()'或'off()'包括，未被显示指定的功能选项会维持原来的值。参考格式: 'on(option1, option2, …)' 'off(ALL)' @@ -380,14 +380,14 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 - summary: 显示简略的诊断信息。 - detail: 显示详细的诊断信息。 目前这两个参数值只在显示多列统计信息未收集的告警的情况下有差别，summary不显示未收集多列统计信息的告警，detail会显示这类告警。 -**默认值:**summary +**默认值**: summary ## udf_memory_limit @@ -395,9 +395,9 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，200*1024～max_process_memory，单位为KB。 +**取值范围**: 整型，200*1024～max_process_memory，单位为KB。 -**默认值:**200MB +**默认值**: 200MB ## FencedUDFMemoryLimit @@ -407,9 +407,9 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 **设置建议:**不建议设置此参数，可用[udf_memory_limit](#udf_memory_limit)代替。 -**取值范围:**整数，0 ~ 2147483647，单位为KB，设置可带单位（KB，MB，GB）。其中0表示不做内存控制。 +**取值范围**: 整数，0 ~ 2147483647，单位为KB，设置可带单位（KB，MB，GB）。其中0表示不做内存控制。 -**默认值:**0 +**默认值**: 0 ## UDFWorkerMemHardLimit @@ -419,9 +419,9 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 **设置建议:**不建议设置此参数，可用[udf_memory_limit](#udf_memory_limit)代替。 -**取值范围:**整数，0 ~ 2147483647，单位为KB，设置时可带单位（KB，MB，GB）。 +**取值范围**: 整数，0 ~ 2147483647，单位为KB，设置时可带单位（KB，MB，GB）。 -**默认值:**1GB +**默认值**: 1GB ## pljava_vmoptions @@ -429,7 +429,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串， 支持: +**取值范围**: 字符串， 支持: - JDK8 JVM启动参数（可参见JDK官方说明） - JDK8 JVM系统属性参数（以-D开头如-Djava.ext.dirs，可参见JDK官方说明） @@ -437,7 +437,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** 如果用户在pljava_vmoptions中设置参数不满足上述取值范围，会在使用PL/Java语言函数时报错。此参数的详细说明参见**PL/pgSQL语言函数**。 -**默认值:**空 +**默认值**: 空 ## enable_pbe_optimization diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md index 9effc9ff..5a410a50 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启动审计功能。 - off表示关闭审计功能。 -**默认值:**on +**默认值**: on ## audit_directory @@ -26,9 +26,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 +**默认值**: pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 ## audit_data_format @@ -36,9 +36,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**binary +**默认值**: binary ## audit_rotation_interval @@ -72,12 +72,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示采用空间优先策略，最多存储[audit_space_limit](#audit_space_limit)大小的日志。 - off表示采用时间优先策略，最少存储[audit_file_remain_time](#audit_file_remain_time)长度时间的日志。 -**默认值:**on +**默认值**: on ## audit_file_remain_time @@ -95,9 +95,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024KB~1024GB，单位为KB。 +**取值范围**: 整型，1024KB~1024GB，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## audit_file_remain_threshold @@ -105,9 +105,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~1048576 +**取值范围**: 整型，1~1048576 -**默认值:**1048576 +**默认值**: 1048576 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 请尽量保证此参数为1048576，并不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md index 71096b2e..73f0fbaf 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~7。 +**取值范围**: 整型，0~7。 - 0表示关闭用户登录、注销审计功能。 - 1表示只审计用户登录成功。 @@ -24,7 +24,7 @@ date: 2021-04-20 - 6表示只审计用户注销和登录失败。 - 7表示审计用户登录成功、失败和注销。 -**默认值:**7 +**默认值**: 7 ## audit_database_process @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭MogDB启动、停止、恢复和切换审计功能。 - 1表示开启MogDB启动、停止、恢复和切换审计功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_locked @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户锁定和解锁审计功能。 - 1表示开启审计用户锁定和解锁功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_violation @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户越权操作审计功能。 - 1表示开启用户越权操作审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_grant_revoke @@ -71,9 +71,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计用户权限授予和回收功能。 - 1表示开启审计用户权限授予和回收功能。 -**默认值:**1 +**默认值**: 1 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md index d423c175..d9306cde 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～524287 +**取值范围**: 整型，0～524287 - 0代表关闭MogDB数据库对象的CREATE、DROP、ALTER操作审计功能。 - 非0代表只审计MogDB的某类或者某些数据库对象的CREATE、DROP、ALTER操作。 @@ -22,7 +22,7 @@ date: 2021-04-20 该参数的值由19个二进制位的组合求出，这19个二进制位分别代表MogDB的19类数据库对象。如果对应的二进制位取值为0，表示不审计对应的数据库对象的CREATE、DROP、ALTER操作；取值为1，表示审计对应的数据库对象的CREATE、DROP、ALTER操作。这19个二进制位代表的具体审计内容请参见[表1](#audit_system_object)。 -**默认值:**12295 +**默认值**: 12295 **表 1** audit_system_object取值含义说明 @@ -55,12 +55,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭具体表的DML操作（SELECT除外）审计功能。 - 1表示开启具体表的DML操作（SELECT除外）审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_dml_state_select @@ -68,12 +68,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SELECT操作审计功能。 - 1表示开启SELECT审计操作功能。 -**默认值:**0 +**默认值**: 0 ## audit_function_exec @@ -81,12 +81,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭过程或函数执行的审计功能。 - 1表示开启过程或函数执行的审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_copy_exec @@ -94,12 +94,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭COPY审计功能。 - 1表示开启COPY审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_set_parameter @@ -107,12 +107,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SET审计功能。 - 1表示开启SET审计功能。 -**默认值:**1 +**默认值**: 1 ## sql_compatibility @@ -120,14 +120,14 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**枚举型 +**取值范围**: 枚举型 - A表示同O数据库兼容。 - B表示同MY数据库兼容。 - C表示同TD数据库兼容。 - PG表示同POSTGRES数据库兼容。 -**默认值:**A +**默认值**: A > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，不能随便改动，否则会导致数据库行为不一致。 @@ -137,12 +137,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启三权分立。 - off表示不开启三权分立。 -**默认值:**off +**默认值**: off ## enable_nonsysadmin_execute_direct @@ -150,12 +150,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许任意用户执行EXECUTE DIRECT ON语句。 - off表示只允许系统管理员执行EXECUTE DIRECT ON语句。 -**默认值:**off +**默认值**: off ## enable_copy_server_files @@ -163,12 +163,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启copy服务端文件的权限。 - off表示不开启copy服务端文件的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** copy from/to file要求具有系统管理员权限的用户或初始用户才能使用，但是，在三权分立开启的状态下，系统管理员与初始用户的权限不同，可以通过使用enable_copy_server_file控制系统管理员的copy权限，当前默认不允许系统管理员权限用户进行对文件的copy操作，此参数打开后系统管理员方可执行该类型操作。 @@ -178,12 +178,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启系统管理员用户创建和删除DIRECTORY的权限。 - off表示不开启系统管理员用户创建和删除DIRECTORY的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/23-upgrade-parameters.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/23-upgrade-parameters.md index 2a9adf13..40a5632e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/23-upgrade-parameters.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/23-upgrade-parameters.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在升级过程中。 - off表示不在升级过程中。 -**默认值:**off +**默认值**: off ## inplace_upgrade_next_system_object_oids @@ -26,15 +26,15 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## upgrade_mode **参数说明**: 标示升级模式。该参数不建议用户自己修改。 -**取值范围:**整数，0~INT_MAX +**取值范围**: 整数，0~INT_MAX - 0表示不在升级过程中。 - 1表示在就地升级过程中。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md index 5012308c..d1687fb5 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md @@ -13,9 +13,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**9.2.4 +**默认值**: 9.2.4 ## server_version_num @@ -23,9 +23,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整数 +**取值范围**: 整数 -**默认值:**90204 +**默认值**: 90204 ## block_size @@ -33,9 +33,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**8192 +**取值范围**: 8192 -**默认值:**8192 +**默认值**: 8192 ## segment_size @@ -45,7 +45,7 @@ date: 2021-04-20 **单位**: 8KB -**默认值:**131072, 即1GB +**默认值**: 131072, 即1GB ## max_index_keys @@ -53,7 +53,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**32 +**默认值**: 32 ## integer_datetimes @@ -61,12 +61,12 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示支持。 - off表示不支持。 -**默认值:**on +**默认值**: on ## lc_collate @@ -74,7 +74,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## lc_ctype @@ -82,7 +82,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## max_identifier_length @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整型 +**取值范围**: 整型 -**默认值:**63 +**默认值**: 63 ## server_encoding @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**在创建数据库的时候由当前系统环境决定的。 +**默认值**: 在创建数据库的时候由当前系统环境决定的。 ## enable_upgrade_merge_lock_mode @@ -110,12 +110,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 - off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 -**默认值:**off +**默认值**: off ## job_queue_processes @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0～1000 +**取值范围**: 0～1000 功能: @@ -136,7 +136,7 @@ date: 2021-04-20 注: 如果同一时间内并行的job数很多，过小的参数值会导致job等待。而过大的参数值则消耗更多的系统资源，建议设置此参数为100，用户可以根据系统资源情况合理调整。 -**默认值:**10 +**默认值**: 10 ## ngram_gram_size @@ -144,9 +144,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型 ，1～4 +**取值范围**: 整型 ，1～4 -**默认值:**2 +**默认值**: 2 ## ngram_grapsymbol_ignore @@ -154,12 +154,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略图形化字符。 - off表示不忽略图形化字符。 -**默认值:**off +**默认值**: off ## ngram_punctuation_ignore @@ -167,20 +167,20 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略标点符号。 - off表示不忽略标点符号。 -**默认值:**on +**默认值**: on ## transparent_encrypted_string **参数说明:**它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，设置为空表示MogDB非加密。 +**取值范围**: 字符串，设置为空表示MogDB非加密。 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** 请勿手动设置该参数，设置不当将导致MogDB不可用。 @@ -190,9 +190,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## enable_auto_explain @@ -216,9 +216,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## basebackup_timeout @@ -234,9 +234,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/25-wait-events.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/25-wait-events.md index 65a819a2..81796520 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/25-wait-events.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/25-wait-events.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开等待事件信息收集功能。 - off: 表示关闭等待事件信息收集功能。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/26-query.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/26-query.md index fa84d45b..8c2e98b2 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/26-query.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/26-query.md @@ -27,7 +27,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - top: 只记录顶层SQL。 @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开sql响应时间信息计算功能。 - off: 表示关闭sql响应时间信息计算功能。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 **默认值**: 80,95 @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～3600（秒）。 +**取值范围**: 整型，0～3600（秒）。 **默认值**: 10s @@ -72,7 +72,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示捕获sql执行的cpu时间消耗。 - off: 表示不捕获sql执行的cpu时间消耗。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/27-system-performance-snapshot.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/27-system-performance-snapshot.md index 1083ca06..1e34b13e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/27-system-performance-snapshot.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/27-system-performance-snapshot.md @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1～8。 +**取值范围**: 整型，1～8。 **默认值**: 8 @@ -36,7 +36,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～INT_MAX（秒）。 +**取值范围**: 整型，100～INT_MAX（秒）。 **默认值**: 100s @@ -46,6 +46,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10～60（分钟）。 +**取值范围**: 整型，10～60（分钟）。 **默认值**: 1h diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md index 43908674..9a5f9a63 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md @@ -15,7 +15,7 @@ date: 2021-04-20 enable_full_encryption设置为on后，使用gsql连接数据库时需要输入"-C"参数，或"-enable-client-encryption"，否则连接不成功。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 全密态数据库开关打开。 - off: 全密态数据库开关关闭。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/29-global-temporary-table.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/29-global-temporary-table.md index 4f3d346c..275de54e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/29-global-temporary-table.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/29-global-temporary-table.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 - 0: 全局临时表功能关闭。 - > 0: 全局临时表功能打开。 @@ -26,6 +26,6 @@ date: 2021-04-20 该参数USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 **默认值**: 10000 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md index fbe87231..eb7b6e92 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md @@ -17,13 +17,13 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** +**取值范围**: - 主机名或IP地址，多个值之间用英文逗号分隔。 - 星号"*"或"0.0.0.0"表示侦听所有IP地址。配置侦听所有IP地址存在安全风险，不推荐用户使用。必须与有效地址结合使用（比如本地IP等），否则，可能造成Build失败的问题。 - 置空则服务器不会侦听任何IP地址，这种情况下，只有Unix域套接字可以用于连接数据库。 -**默认值:**localhost +**默认值**: localhost > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -35,7 +35,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值:**0.0.0.0（实际值由安装时的配置文件指定） +**默认值**: 0.0.0.0（实际值由安装时的配置文件指定） ## port @@ -51,9 +51,9 @@ date: 2021-04-20 > gs_om -t generateconf -X XMLFILE [--distribute] [-l LOGFILE] > ``` -**取值范围:**整型，1～65535 +**取值范围**: 整型，1～65535 -**默认值:**5432（实际值由安装时的配置文件指定） +**默认值**: 5432（实际值由安装时的配置文件指定） ## max_connections @@ -61,9 +61,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。最小值为10，最大值为262143。 +**取值范围**: 整型。最小值为10，最大值为262143。 -**默认值:**数据库节点: 5000。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 +**默认值**: 数据库节点: 5000。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 **设置建议:** @@ -77,9 +77,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 +**默认值**: 数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 **设置建议:** @@ -93,9 +93,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**3 +**默认值**: 3 ## unix_socket_directory @@ -105,9 +105,9 @@ date: 2021-04-20 该参数的长度限制于操作系统的长度，超过该限制将会导致Unix-domain socket path "xxx" is too long的问题。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空字符串（实际值由安装时配置文件指定） +**默认值**: 空字符串（实际值由安装时配置文件指定） ## unix_socket_group @@ -115,9 +115,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空字符串表示当前用户的缺省组。 +**取值范围**: 字符串，其中空字符串表示当前用户的缺省组。 -**默认值:**空字符串 +**默认值**: 空字符串 ## unix_socket_permissions @@ -129,9 +129,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0000-0777 +**取值范围**: 0000-0777 -**默认值:**0700 +**默认值**: 0700 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -163,9 +163,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串(连接到后端的应用名，以实际安装为准) +**默认值**: 空字符串(连接到后端的应用名，以实际安装为准) ## connection_info @@ -173,9 +173,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于USERSET类型参数，属于运维类参数，不建议用户设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串**。** +**默认值**: 空字符串**。** > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md index 96644ea0..185da005 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为600，最小单位为s。 +**取值范围**: 整型，最小值为1，最大值为600，最小单位为s。 -**默认值:**1min +**默认值**: 1min ## auth_iteration_count @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2048-134217728。 +**取值范围**: 整型，2048-134217728。 -**默认值:**10000 +**默认值**: 10000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化，请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。 @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0-86400，最小单位为s，0表示关闭超时设置。 +**取值范围**: 整型，0-86400，最小单位为s，0表示关闭超时设置。 -**默认值:**10min +**默认值**: 10min > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用SSL连接。 - off表示不启用SSL连接。 @@ -59,7 +59,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启，数据库节点默认值为off。开启此参数需要同时配置ssl_cert_file、ssl_key_file和ssl_ca_file等参数及对应文件，不正确的配置可能会导致MogDB无法正常启动。 -**默认值:**off +**默认值**: off ## require_ssl @@ -67,7 +67,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示服务器端强制要求SSL连接。 - off表示服务器端对是否通过SSL连接不作强制要求。 @@ -75,7 +75,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。 -**默认值:**off +**默认值**: off ## ssl_ciphers @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 +**取值范围**: 字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 -**默认值:**ALL +**默认值**: ALL ## ssl_renegotiation_limit @@ -93,9 +93,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 +**取值范围**: 整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 -**默认值:**0 +**默认值**: 0 ## ssl_cert_file @@ -103,9 +103,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**server.crt +**默认值**: server.crt ## ssl_key_file @@ -115,7 +115,7 @@ date: 2021-04-20 取值范围:字符串 -**默认值:**server.key +**默认值**: server.key ## ssl_ca_file @@ -123,9 +123,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**cacert.pem +**默认值**: cacert.pem ## ssl_crl_file @@ -143,9 +143,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## krb_srvname @@ -153,9 +153,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## krb_caseins_users @@ -163,12 +163,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示大小写不敏感 - off表示大小写敏感 -**默认值:**off +**默认值**: off ## modify_initial_password @@ -178,12 +178,12 @@ date: 2021-04-20 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示MogDB安装成功后初始用户首次登录操作前需要修改初始密码。 - off表示MogDB安装成功后初始用户无需修改初始密码即可进行操作。 -**默认值:**off +**默认值**: off ## password_policy @@ -194,12 +194,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 从安全性考虑，请勿关闭密码复杂度策略。 -**取值范围:**0、1 +**取值范围**: 0、1 - 0表示不采用任何密码复杂度策略。 - 1表示采用默认密码复杂度校验策略。 -**默认值:**1 +**默认值**: 1 ## password_reuse_time @@ -215,12 +215,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**浮点型（天），最小值为0，最大值为3650。 +**取值范围**: 浮点型（天），最小值为0，最大值为3650。 - 0表示不检查密码可重用的天数。 - 正数表示新密码不能为该值指定的天数内使用过的密码。 -**默认值:**60 +**默认值**: 60 ## password_reuse_max @@ -236,12 +236,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示不检查密码可重用次数。 - 正整数表示新密码不能为该值指定的次数内使用过的密码。 -**默认值:**0 +**默认值**: 0 ## password_lock_time @@ -252,12 +252,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > password_lock_time和[failed_login_attempts](#failed_login_attempts)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**浮点型，最小值为0，最大值为365，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为365，单位为天。 - 0表示密码验证失败时，自动锁定功能不生效。 - 正数表示帐户被锁定后，当锁定时间超过password_lock_time设定的值时，帐户将会被自行解锁。 -**默认值:**1d +**默认值**: 1d ## failed_login_attempts @@ -268,12 +268,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > failed_login_attempts和[password_lock_time](#password_lock_time)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示自动锁定功能不生效。 - 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前帐户将被锁定。 -**默认值:**10 +**默认值**: 10 ## password_encryption_type @@ -281,7 +281,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0、1、2 +**取值范围**: 0、1、2 - 0表示采用md5方式对密码加密。 - 1表示采用sha256和md5两种方式分别对密码加密。 @@ -290,7 +290,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > md5加密算法安全性低，存在安全风险，不建议用户使用。 -**默认值:**2 +**默认值**: 2 ## password_min_length @@ -298,9 +298,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**8 +**默认值**: 8 ## password_max_length @@ -308,9 +308,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**32 +**默认值**: 32 ## password_min_uppercase @@ -318,12 +318,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建账户所指定的密码中至少需要包含大写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_lowercase @@ -331,12 +331,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含小写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_digital @@ -344,12 +344,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含数字个数。 -**默认值:**0 +**默认值**: 0 ## password_min_special @@ -357,12 +357,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含特殊字符个数。 -**默认值:**0 +**默认值**: 0 ## password_effect_time @@ -370,12 +370,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，最小值为0，最大值为999，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为999，单位为天。 - 0表示不开启有效期限制功能。 - 1~999表示创建帐户所指定的密码有效期，临近或超过有效期系统会提示用户修改密码。 -**默认值:**90 +**默认值**: 90 ## password_notify_time @@ -383,9 +383,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为999，单位为天。 +**取值范围**: 整型，最小值为0，最大值为999，单位为天。 - 0表示不开启提醒功能。 - 1~999表示帐户密码到期前提醒的天数。 -**默认值:**7 +**默认值**: 7 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md index 6751202e..b525c870 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md @@ -20,9 +20,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPIDLE选项 ，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-3600，单位为s。 +**取值范围**: 0-3600，单位为s。 -**默认值:**60 +**默认值**: 60 ## tcp_keepalives_interval @@ -30,9 +30,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0-180，单位为s。 +**取值范围**: 0-180，单位为s。 -**默认值:**30 +**默认值**: 30 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -50,9 +50,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 +**取值范围**: 0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 -**默认值:**20 +**默认值**: 20 ## comm_tcp_mode @@ -63,9 +63,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SCTP协议的连接不再提供支持，为了保持兼容，提供此参数的接口，但此参数会在设置过程中强制改为on。 -**取值范围:**布尔型，设置为on表示使用TCP模式连接数据库节点。 +**取值范围**: 布尔型，设置为on表示使用TCP模式连接数据库节点。 -**默认值:**on +**默认值**: on ## comm_sctp_port @@ -76,9 +76,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7000 +**默认值**: 7000 ## comm_control_port @@ -89,9 +89,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7001 +**默认值**: 7001 ## comm_max_receiver @@ -99,9 +99,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为50。 +**取值范围**: 整型，最小值为1，最大值为50。 -**默认值:**4 +**默认值**: 4 ## comm_quota_size @@ -109,9 +109,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2048000，默认单位为KB。 +**取值范围**: 整型，最小值为0，最大值为2048000，默认单位为KB。 -**默认值:**1MB +**默认值**: 1MB ## comm_usable_memory @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**4000MB +**默认值**: 4000MB ## comm_memory_pool @@ -135,9 +135,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**2000MB +**默认值**: 2000MB ## comm_memory_pool_percent @@ -148,9 +148,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为100。 +**取值范围**: 整型，最小值为0，最大值为100。 -**默认值:**0 +**默认值**: 0 ## comm_no_delay @@ -158,12 +158,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 如果MogDB出现因每秒接收数据包过多导致的丢包时，需设置为off，以便小包合并成大包发送，减少数据包总数。 -**默认值:**off +**默认值**: off ## comm_debug_mode @@ -174,12 +174,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细debug日志。 - off表示不打印通信库详细debug日志。 -**默认值:**off +**默认值**: off ## comm_ackchk_time @@ -187,9 +187,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 +**取值范围**: 整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 -**默认值:**2000 +**默认值**: 2000 ## comm_timer_mode @@ -200,12 +200,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细时间桩日志。 - off表示不打印通信库详细时间桩日志。 -**默认值:**off +**默认值**: off ## comm_stat_mode @@ -216,9 +216,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库统计信息日志。 - off表示不打印通信库统计信息日志。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md index 8e9d45aa..2fe7e9d7 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md @@ -46,7 +46,7 @@ date: 2021-04-20 - on表示启用逻辑内存管理模块。 - off表示不启用逻辑内存管理模块。 -**默认值:**on +**默认值**: on > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 若max_process_memory-shared_buffers-cstore_buffers-元数据少于2G，MogDB强制把enable_memory_limit设置为off。（注: 实际上shared_buffers不直接参与计算，而是由shared_buffers通过一系列计算得到的数值更大的shared_memory。） @@ -59,7 +59,7 @@ date: 2021-04-20 **取值范围**: 整型，2\*1024\*1024～INT_MAX，单位为KB。 -**默认值:**12GB。 +**默认值**: 12GB。 **设置建议:** @@ -76,7 +76,7 @@ date: 2021-04-20 - on表示启用最大内存上下文限制检查功能。 - off表示关闭最大内存上下文限制检查功能。 -**默认值:**off +**默认值**: off ## uncontrolled_memory_context @@ -88,7 +88,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## shared_buffers @@ -96,11 +96,11 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16 ~ 1073741823 ，单位为KB。 +**取值范围**: 整型，16 ~ 1073741823 ，单位为KB。 shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 -**默认值:**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 +**默认值**: 数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 **设置建议:** @@ -114,9 +114,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384 ~ 2147483647，单位为KB。 +**取值范围**: 整型，16384 ~ 2147483647，单位为KB。 -**默认值:**2GB +**默认值**: 2GB **设置建议:**建议导入压力大的场景中增加数据库节点中此参数配置。 @@ -126,9 +126,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**双精度类型，0.1~1.0 +**取值范围**: 双精度类型，0.1~1.0 -**默认值:**0.3 +**默认值**: 0.3 ## temp_buffers @@ -140,9 +140,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 -**取值范围:**整型，100~1073741823，单位为8KB。 +**取值范围**: 整型，100~1073741823，单位为8KB。 -**默认值:**1MB +**默认值**: 1MB ## max_prepared_transactions @@ -152,9 +152,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。0~536870911。 +**取值范围**: 整型。0~536870911。 -**默认值:**800 +**默认值**: 800 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 为避免在准备步骤失败，此参数的值不能小于max_connections。 @@ -167,9 +167,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，64~2147483647，单位为KB。 +**取值范围**: 整型，64~2147483647，单位为KB。 -**默认值:**64MB +**默认值**: 64MB **设置建议:** @@ -185,9 +185,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 -**默认值:**0 +**默认值**: 0 ## query_max_mem @@ -195,9 +195,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 -**默认值:**0 +**默认值**: 0 ## maintenance_work_mem @@ -205,9 +205,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024~INT_MAX，单位为KB。 +**取值范围**: 整型，1024~INT_MAX，单位为KB。 -**默认值:**128MB +**默认值**: 128MB **设置建议:** @@ -224,9 +224,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 同样，好几个正在运行的会话可能会同时进行表的局部排序操作。因此使用的总内存可能是psort_work_mem的好几倍。 -**取值范围:**整型64~2147483647，单位为KB。 +**取值范围**: 整型64~2147483647，单位为KB。 -**默认值:**512MB +**默认值**: 512MB ## max_loaded_cudesc @@ -237,9 +237,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > max_loaded_cudesc设置过高时，有可能引起内存分配不足。 -**取值范围:**100~1073741823。 +**取值范围**: 100~1073741823。 -**默认值:**1024 +**默认值**: 1024 ## max_stack_depth @@ -253,9 +253,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 - 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在MogDB能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 - 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 -**取值范围:**整型，100~INT_MAX，单位为KB。 +**取值范围**: 整型，100~INT_MAX，单位为KB。 -**默认值:**2MB +**默认值**: 2MB > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。 @@ -266,9 +266,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384～1073741823，单位为KB。 +**取值范围**: 整型，16384～1073741823，单位为KB。 -**默认值:**1GB +**默认值**: 1GB **设置建议**: @@ -280,6 +280,6 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，256~2147483647，单位为KB。 +**取值范围**: 整型，256~2147483647，单位为KB。 -**默认值:**16MB +**默认值**: 16MB diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md index 39732fdf..98c8c5fa 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 **默认值: -1** @@ -30,6 +30,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SQL查询执行时使用的临时表空间不在此限制。 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 -**默认值:**-1 +**默认值**: -1 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md index e889ba86..e8eecfe3 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，25~2147483647。 +**取值范围**: 整型，25~2147483647。 -**默认值:**1000 +**默认值**: 1000 ## shared_preload_libraries @@ -36,6 +36,6 @@ date: 2021-04-20 > - 如果被声明的库不存在，MogDB服务将会启动失败。 > - 每一个支持MogDB的库都有一个特殊的标记用于保证兼容性。因此，不支持MogDB的库不能用这种方法加载。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md index 558ccc71..0ccd969f 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md @@ -31,9 +31,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 +**取值范围**: integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 -**默认值:**0 +**默认值**: 0 ## vacuum_cost_page_hit @@ -41,9 +41,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**1 +**默认值**: 1 ## vacuum_cost_page_miss @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**10 +**默认值**: 10 ## vacuum_cost_page_dirty @@ -61,9 +61,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~1000 +**取值范围**: integer，0~1000 -**默认值:**20 +**默认值**: 20 ## vacuum_cost_limit @@ -71,6 +71,6 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，1~10000。 +**取值范围**: integer，1~10000。 -**默认值:**200 +**默认值**: 200 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md index c85f1d7a..65e9c5a7 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md @@ -19,9 +19,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10~10000，单位为毫秒。 +**取值范围**: 整型，10~10000，单位为毫秒。 -**默认值:**2s +**默认值**: 2s **设置建议:**在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 @@ -31,13 +31,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000 +**取值范围**: 整型，0～1000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > 此参数设置为0表示禁用后端写功能，禁用后端写功能不会对checkpoints产生影响。 -**默认值:**100 +**默认值**: 100 ## bgwriter_lru_multiplier @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0~10。 +**取值范围**: 浮点型，0~10。 -**默认值:**2 +**默认值**: 2 ## max_io_capacity @@ -61,6 +61,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，30720~10485760。单位是KB。 +**取值范围**: 整型，30720~10485760。单位是KB。 -**默认值:**512000KB（500MB） +**默认值**: 512000KB（500MB） diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md index c3f50d51..1921e1de 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值:**off +**默认值**: off ## enable_adio_function @@ -26,12 +26,12 @@ date: 2021-04-20 当前版本暂不支持开启异步IO功能，默认该功能关闭，请勿自行修改。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## enable_fast_allocate @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。只有在XFS文件系统上才能开启该开关。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## prefetch_quantity @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**32MB (4096 * 8KB) +**默认值**: 32MB (4096 * 8KB) ## backwrite_quantity @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**8MB (1024 * 8KB) +**默认值**: 8MB (1024 * 8KB) ## cstore_prefetch_quantity @@ -74,9 +74,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**32MB +**默认值**: 32MB ## cstore_backwrite_quantity @@ -84,9 +84,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## cstore_backwrite_max_threshold @@ -94,9 +94,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096～INT_MAX/2，单位为KB。 +**取值范围**: 整型，4096～INT_MAX/2，单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## fast_extend_file_size @@ -104,9 +104,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## effective_io_concurrency @@ -114,6 +114,6 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型 ，0~1000 +**取值范围**: 整型 ，0~1000 -**默认值:**1 +**默认值**: 1 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/5-parallel-import.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/5-parallel-import.md index 623f1f8c..b27d3fee 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/5-parallel-import.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/5-parallel-import.md @@ -20,7 +20,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示导入时区分"导入文件记录数为空"和"导入文件不存在"。 - off表示导入时不区分"导入文件记录数为空"和"导入文件不存在"。 -**默认值:**off +**默认值**: off ## partition_mem_batch @@ -30,7 +30,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 **取值范围**: 1~ 65535 -**默认值:**256 +**默认值**: 256 ## partition_max_cache_size @@ -42,7 +42,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 列存分区表: 4096~ INT_MAX / 2，最小单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## enable_delta_store @@ -55,4 +55,4 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示开启列存delta表功能。 - off表示不开启列存delta表功能。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md index f863c89d..0166ec42 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md @@ -40,7 +40,7 @@ date: 2021-04-20 这个参数表示WAL日志支持逻辑复制。 -**默认值:**hot_standby +**默认值**: hot_standby ## fsync @@ -53,12 +53,12 @@ date: 2021-04-20 > - 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 > - 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示使用fsync()系统函数。 - off表示不使用fsync()系统函数。 -**默认值:**on +**默认值**: on ## synchronous_commit @@ -82,7 +82,7 @@ date: 2021-04-20 - 0表示异步提交。 - 2表示将备机同步日志回放完成。 -**默认值:**off +**默认值**: off ## wal_sync_method @@ -114,7 +114,7 @@ date: 2021-04-20 > > 不是所有的平台都支持以上参数。 -**默认值:**fdatasync +**默认值**: fdatasync ## full_page_writes @@ -127,12 +127,12 @@ date: 2021-04-20 > - 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 > - 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用此特性。 - off表示关闭此特性。 -**默认值:**on +**默认值**: on ## wal_log_hints @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示整个页面全部内容写到WAL日志中。 - off表示整个页面内容不会写到WAL日志中。 -**默认值:**on +**默认值**: on ## wal_buffers @@ -153,12 +153,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**-1~218 +**取值范围**: -1~218 - 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，为shared_buffers的1/32，最小值为8个XLOG_BLCKSZ，最大值为2048个XLOG_BLCKSZ。 - 如果设置为其他值，当小于4时，会被默认设置为4。 -**默认值:**16MB +**默认值**: 16MB **设置建议:**每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 @@ -174,7 +174,7 @@ date: 2021-04-20 **取值范围**: 整型， 1～10000（毫秒） -**默认值:**200ms +**默认值**: 200ms ## commit_delay @@ -189,7 +189,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～100000（微秒），其中0表示无延迟。 -**默认值:**0 +**默认值**: 0 ## commit_siblings @@ -199,7 +199,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～1000 -**默认值:**5 +**默认值**: 5 ## wal_block_size @@ -209,7 +209,7 @@ date: 2021-04-20 **取值范围**: 整型，单位为Byte。 -**默认值:**8192 +**默认值**: 8192 ## wal_segment_size @@ -219,4 +219,4 @@ date: 2021-04-20 **取值范围**: 整型，单位为8KB。 -**默认值:**16MB (2048 * 8KB) +**默认值**: 16MB (2048 * 8KB) diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md index 864a9644..5617970b 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md @@ -17,7 +17,7 @@ date: 2021-04-20 提升此参数可加快大数据的导入速度，但需要结合[checkpoint_timeout](#checkpoint_timeout)、shared_buffers这两个参数统一考虑。这个参数同时影响WAL日志段文件复用数量，通常情况下pg_xlog文件夹下最大的复用文件个数为2倍的checkpoint_segments个，复用的文件被改名为后续即将使用的WAL日志段文件，不会被真正删除。 -**默认值:**64 +**默认值**: 64 ## checkpoint_timeout @@ -29,7 +29,7 @@ date: 2021-04-20 在提升[checkpoint_segments](#checkpoint_segments)以加快大数据导入的场景也需将此参数调大，同时这两个参数提升会加大shared_buffers的负担，需要综合考虑。 -**默认值:**15min +**默认值**: 15min ## checkpoint_completion_target @@ -39,7 +39,7 @@ date: 2021-04-20 **取值范围**: 0.0～1.0 -**默认值:**0.5 +**默认值**: 0.5 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值0.5表示: 每个checkpoint需要在checkpoints间隔时间的50%内完成。 @@ -52,7 +52,7 @@ date: 2021-04-20 **取值范围**: 整型，0~INT_MAX（秒），其中0表示关闭警告。 -**默认值:**5min +**默认值**: 5min **推荐值:**5min @@ -64,7 +64,7 @@ date: 2021-04-20 **取值范围**: 整型，2～3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_incremental_checkpoint @@ -74,7 +74,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## enable_double_write @@ -84,7 +84,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## incremental_checkpoint_timeout @@ -94,7 +94,7 @@ date: 2021-04-20 **取值范围**: 整型，1~3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_xlog_prune @@ -107,7 +107,7 @@ date: 2021-04-20 - 设置为on时，如果任一备机断联时，主机不回收日志。 - 设置为off时，如果任一备机断联时，主机回收日志。 -**默认值:**on +**默认值**: on ## max_redo_log_size @@ -117,7 +117,7 @@ date: 2021-04-20 **取值范围**: 整型，163840 ~ 2147483647，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## max_size_for_xlog_prune @@ -127,4 +127,4 @@ date: 2021-04-20 **取值范围**: 整型，0～2147483647，单位为KB -**默认值:**2147483647，单位KB +**默认值**: 2147483647，单位KB diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md index 7f9a48ce..d6607238 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md @@ -17,7 +17,7 @@ date: 2021-04-20 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 -**默认值:**0 +**默认值**: 0 ## recovery_max_workers @@ -27,7 +27,7 @@ date: 2021-04-20 **取值范围**: 整型，0~20 -**默认值:**1 （安装工具默认将设置为4以获得更好的性能） +**默认值**: 1 （安装工具默认将设置为4以获得更好的性能） ## recovery_parse_workers @@ -39,7 +39,7 @@ date: 2021-04-20 仅在开启极致RTO情况下可以设置recovery_parse_workers为>1。需要配合recovery_redo_workers使用。若同时开启recovery_parse_workers和recovery_max_workers，以开启极致RTO的recovery_parse_workers为准，并行回放特性失效。因极致RTO不支持hot standby模式和主备从模式, 仅在参数hot_standby设置成off，replication_type设置成1时可以设置recovery_parse_workers为>1。另外，极致RTO也不支持列存，在已经使用列存表或者即将使用列存表的系统中，请关闭极致RTO. -**默认值:**1 +**默认值**: 1 ## recovery_redo_workers @@ -51,7 +51,7 @@ date: 2021-04-20 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于0，recovery_redo_workers参数才生效。 -**默认值:**1 +**默认值**: 1 ## recovery_parallelism @@ -61,7 +61,7 @@ date: 2021-04-20 该参数受参数: recovery_max_workers及参数: recovery_parse_workers影响，上述任意一参数值大于0时，该参数值将重新计算。 -**默认值:**1 +**默认值**: 1 ## enable_page_lsn_check @@ -71,4 +71,4 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md index c78b1fa9..8ac7a0c2 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md @@ -21,7 +21,7 @@ date: 2021-04-20 - on表示进行归档。 - off表示不进行归档。 -**默认值:**off +**默认值**: off ## archive_command @@ -56,7 +56,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**(disabled) +**默认值**: (disabled) ## archive_dest @@ -74,7 +74,7 @@ date: 2021-04-20 > archive_dest = '/mnt/server/archivedir/' > ``` -**默认值:**空字符串 +**默认值**: 空字符串 ## archive_timeout diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md index 82f7e502..e1c4cfa3 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md @@ -17,7 +17,7 @@ date: 2021-04-20 **取值范围**: 整型，0～262143 -**默认值:**16 +**默认值**: 16 ## wal_keep_segments @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2 ~ INT_MAX +**取值范围**: 整型，2 ~ INT_MAX -**默认值:**16 +**默认值**: 16 **设置建议:** @@ -46,9 +46,9 @@ date: 2021-04-20 > - 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为 600s。 > - 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**6s +**默认值**: 6s ## max_replication_slots @@ -56,9 +56,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0~262143。 +**取值范围**: 整型， 0~262143。 -**默认值:**8 +**默认值**: 8 **设置建议**: @@ -108,9 +108,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第一个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第一个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo2 @@ -118,9 +118,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第二个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第二个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo3 @@ -128,9 +128,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第三个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第三个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo4 @@ -138,9 +138,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第四个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第四个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo5 @@ -148,9 +148,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第五个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第五个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo6 @@ -158,9 +158,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第六个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第六个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo7 @@ -168,9 +168,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第七个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第七个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo8 @@ -178,9 +178,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第八个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第八个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## available_zone @@ -188,6 +188,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md index d813df9a..120b12cd 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md @@ -18,13 +18,13 @@ date: 2021-04-20 > - 当前连接的同步备机是列表中的第一个名称。如果当前同步备机失去连接，则它会立即更换下一个优先级更高的备机，并将此备机的名称放入列表中。 > - 备机名称可以通过设置环境变量PGAPPNAME指定。 -**取值范围:**字符串。当取值为*，表示匹配任意提供同步复制的备机名称。 +**取值范围**: 字符串。当取值为*，表示匹配任意提供同步复制的备机名称。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > ANY N (node1,node2,…)表示在括号内任选N个主机名称作为同步复制的备机名称列表。例如，ANY 1(node1,node2)表示在node1和node2中任选一个作为同步复制的备机名称。 -**默认值:*** +**默认值**: * ## most_available_sync @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在有同步备机故障时，不阻塞主机。 - off表示在有同步备机故障时，阻塞主机。 @@ -50,7 +50,7 @@ date: 2021-04-20 > - 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 > - 此参数属于受控参数，不建议正常业务场景下关闭此参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开主备、主从同步。 - off表示关闭主备、主从同步。 @@ -67,7 +67,7 @@ date: 2021-04-20 > > 此参数目前不允许正常业务场景下改变其值，即关闭WAL日志、数据页混合复制模式。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开WAL日志、数据页混合复制模式。 - off表示关闭WAL日志、数据页混合复制模式。 @@ -80,7 +80,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000000，值为0表示不延迟。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。 **默认值**: 0 @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1072693248，单位为KB。 +**取值范围**: 整型，4096~1072693248，单位为KB。 -**默认值:**16MB（即16448KB） +**默认值**: 16MB（即16448KB） ## walsender_max_send_size @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~INT_MAX，单位为KB。 +**取值范围**: 整型，8~INT_MAX，单位为KB。 -**默认值:**8M（即8192KB） +**默认值**: 8M（即8192KB） ## enable_data_replicate @@ -110,12 +110,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 - off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 -**默认值:**off +**默认值**: off ## ha_module_debug @@ -123,12 +123,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示日志中将打印数据复制时每个数据块的状态。 - off表示日志中不打印数据复制时每个数据块的状态。 -**默认值:**off +**默认值**: off ## enable_incremental_catchup @@ -136,7 +136,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示备机catchup时用增量catchup方式，即从从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 - off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 @@ -149,7 +149,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围1~INT_MAX，单位为秒 +**取值范围**: 整型，范围1~INT_MAX，单位为秒 **默认值**: 300 @@ -163,7 +163,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围-1~10000，单位为毫秒。 +**取值范围**: 整型，范围-1~10000，单位为毫秒。 - -1表示主机阻塞直到备机数据追赶完成。 - 0表示备机数据追赶时始终不阻塞主机。 @@ -177,13 +177,13 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 - only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 - none_node: 主机配置为none_node时，表示不允许主机向任何备机主动同步配置文件；备机配置为none_node时，表示不允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为none_node时，表示不允许当前级联备向其备机发送同步请求。 -**默认值:**all_node +**默认值**: all_node > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md index 0dc392ca..68f4e507 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md @@ -18,12 +18,12 @@ date: 2021-04-20 > - 如果此参数设置为on，wal_level必须设置为hot_standby，否则将导致数据库无法启动。 > - 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许备机在恢复过程中连接和查询。 - off表示不允许备机在恢复过程中连接和查询。 -**默认值:**on +**默认值**: on ## max_standby_archive_delay @@ -35,9 +35,9 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型，范围: -1~INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围: -1~INT_MAX，单位为毫秒。 -**默认值:**3s**（即**3000ms） +**默认值**: 3s**（即**3000ms） ## max_standby_streaming_delay @@ -49,7 +49,7 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型（毫秒），范围: -1~INT_MAX +**取值范围**: 整型（毫秒），范围: -1~INT_MAX **默认值: 3s（即**3000ms） @@ -59,9 +59,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围: 0 ~ INT_MAX ，单位为毫秒。 +**取值范围**: 整型，范围: 0 ~ INT_MAX ，单位为毫秒。 -**默认值:**5s**（即**5000ms） +**默认值**: 5s**（即**5000ms） ## hot_standby_feedback @@ -69,12 +69,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许将备机上执行查询的最小事务号反馈给主机。 - off表示不允许将备机上执行查询的最小事务号反馈给主机。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -86,9 +86,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒。 -**默认值:**6s（即6000ms） +**默认值**: 6s（即6000ms） ## wal_receiver_connect_timeout @@ -96,9 +96,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX / 1000，单位为秒。 +**取值范围**: 整型， 0 ~ INT_MAX / 1000，单位为秒。 -**默认值:**2s +**默认值**: 2s ## wal_receiver_connect_retries @@ -106,9 +106,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 1~ INT_MAX。 +**取值范围**: 整型， 1~ INT_MAX。 -**默认值:**1 +**默认值**: 1 ## wal_receiver_buffer_size @@ -116,9 +116,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1047552，单位为KB。 +**取值范围**: 整型，4096~1047552，单位为KB。 -**默认值:**64MB（即65536KB） +**默认值**: 64MB（即65536KB） ## primary_slotname @@ -126,9 +126,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符型 +**取值范围**: 字符型 -**默认值:**空字符串 +**默认值**: 空字符串 ## config_sync_interval diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md index f67f9922..dcfc9ba5 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md @@ -197,12 +197,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示正则表达式采用A格式的匹配规则。 - off表示正则表达式采用POSIX格式的匹配规则。 -**默认值:**on +**默认值**: on ## max_recursive_times @@ -246,12 +246,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以使用绝对路径。 - off表示不可以使用绝对路径。 -**默认值:**on +**默认值**: on ## enable_valuepartition_pruning @@ -259,12 +259,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示对DFS分区表进行静态/动态优化。 - off表示不对DFS分区表进行静态/动态优化。 -**默认值:**on +**默认值**: on ## expected_computing_nodegroup diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md index ea5396bc..2373d6e3 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md @@ -121,7 +121,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许开启代码生成优化。 @@ -130,7 +130,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 -**默认值:**on +**默认值**: on ## codegen_strategy @@ -138,7 +138,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - partial表示当所计算表达式中即使包含部分未被codegen化的函数时，仍可借助表达式全codegen框架调用LLVM动态编译优化策略。 @@ -147,7 +147,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 -**默认值:**partial +**默认值**: partial ## enable_codegen_print @@ -155,12 +155,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许在log日志中打印IR函数。 - off表示不允许在log日志中打印IR函数。 -**默认值:**off +**默认值**: off ## codegen_cost_threshold @@ -168,42 +168,42 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 2147483647。 +**取值范围**: 整型，0 ~ 2147483647。 -**默认值:**10000 +**默认值**: 10000 ## enable_bloom_filter **参数说明:**标识是否允许使用BloomFilter优化。该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许使用BloomFilter优化。 - off表示不允许使用BloomFilter优化。 -**默认值:**on +**默认值**: on ## enable_extrapolation_stats **参数说明:**标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性，但也存在错误推理导致估算过大的可能性，需要对于日期类型数据定期插入的场景开启此开关。该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许基于历史统计信息使用推理估算的逻辑。 - off表示不允许基于历史统计信息使用推理估算的逻辑。 -**默认值:**off +**默认值**: off ## autoanalyze **参数说明:**标识是否允许在生成计划的时候，对于没有统计信息的表进行统计信息自动收集。对于外表和临时表，不支持autoanalyze，如果需要收集统计信息，用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常，当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作，以同步统计信息数据。该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许自动进行统计信息收集。 - off表示不允许自动进行统计信息收集。 -**默认值:**off +**默认值**: off ## enable_analyze_check @@ -211,12 +211,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许检查。 - off表示不允许检查。 -**默认值:**off +**默认值**: off ## enable_sonic_hashagg @@ -224,7 +224,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。 - off表示不使用面向列的hash表设计的Hash Agg算子。 @@ -235,7 +235,7 @@ date: 2021-04-20 > > - 开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为"Sonic Hash Aggregation"，而未达到该约束条件时，算子名称将显示为"Hash Aggregation"，Explain详解请参见**详解**。 -**默认值:**on +**默认值**: on ## enable_sonic_hashjoin @@ -243,7 +243,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。 - off表示不使用面向列的hash表设计的Hash Join算子。 @@ -255,7 +255,7 @@ date: 2021-04-20 > - 在开启enable_sonic_hashjoin，查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashjoin，且查询达到约束条件使用基于面向列的hash表设计的Hash Join算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为"Sonic Hash Join"，而未达到该约束条件时，算子名称将显示为"Hash Join"，Explain详解请参见**详解**。 -**默认值:**on +**默认值**: on ## enable_sonic_optspill @@ -263,12 +263,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 - off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。 -**默认值:**on +**默认值**: on ## log_parser_stats diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/101-DROP-USER.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/101-DROP-USER.md index eae9d608..f898459f 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/101-DROP-USER.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/101-DROP-USER.md @@ -44,7 +44,7 @@ DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; - RESTRICT：如果用户还有任何依赖的对象，则拒绝删除该用户（缺省行为）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在MogDB中，存在一个配置参数enable_kill_query，此参数在配置文件postgresql.conf中。此参数影响级联删除用户对象的行为： > > - 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的进程，并删除用户。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md index 9cb11740..0208daf9 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md @@ -25,7 +25,7 @@ FOR statement ; - STATEMENT_ID用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。 ## 注意事项 @@ -40,7 +40,7 @@ FOR statement ; 1. 执行EXPLAN PLAN。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。 > PLAN_TABLE详细介绍见**PLAN_TABLE**。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/108-GRANT.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/108-GRANT.md index 06a5255b..b55879e6 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/108-GRANT.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/108-GRANT.md @@ -99,7 +99,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予域的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予域的访问权限。 - 将客户端加密主密钥CMK的访问权限赋予指定的用户或角色。 @@ -165,7 +165,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持大对象。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持大对象。 - 将模式的访问权限赋予指定的用户或角色。 @@ -176,7 +176,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 - 将表空间的访问权限赋予指定的用户或角色。 @@ -196,7 +196,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予类型的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予类型的访问权限。 - 将角色的权限赋予其他用户或角色的语法。 @@ -408,7 +408,7 @@ GRANT的参数说明如下所示。 - 如果用户有该对象上的部分权限，则GRANT命令只授予他有授权选项的权限。 - 如果用户没有可用的授权选项，GRANT ALL PRIVILEGES形式将发出一个警告信息，其他命令形式将发出在命令中提到的且没有授权选项的相关警告信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/109-INSERT.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/109-INSERT.md index e215661e..d704732d 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/109-INSERT.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/109-INSERT.md @@ -23,7 +23,7 @@ date: 2021-05-18 - 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的insert语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 ## 语法格式 @@ -58,7 +58,7 @@ INSERT INTO table_name [ ( column_name [, ...] ) ] - 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。 - **table_name** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/111-MOVE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/111-MOVE.md index 79ae2107..551ecd16 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/111-MOVE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/111-MOVE.md @@ -44,7 +44,7 @@ NEXT MOVE命令的参数与FETCH的相同，详细请参见FETCH的参数说明。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 成功完成时，MOVE命令将返回一个“MOVE count”的标签，count是一个使用相同参数的FETCH命令会返回的行数（可能为零）。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/117-REINDEX.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/117-REINDEX.md index c1d38221..4cdb1480 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/117-REINDEX.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/117-REINDEX.md @@ -63,7 +63,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 - **FORCE** @@ -80,7 +80,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 - 如果前面是REINDEX TABLE，则这里应该指定分区的名称； - 如果前面是REINDEX INTERNAL TABLE，则这里应该指定列存分区表的分区的名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/125-SELECT.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/125-SELECT.md index fac0d9f1..2a2cbee0 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/125-SELECT.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/125-SELECT.md @@ -39,7 +39,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > condition和expression中可以使用targetlist中表达式的别名。 - 只能同一层引用。 > @@ -87,7 +87,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 FOR ( partition_value [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定分区只适合普通表。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定分区只适合普通表。 - 其中设置排序方式nlssort_expression_clause为： @@ -133,7 +133,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 ON ( expression [, …] ) 只保留那些在给出的表达式上运算出相同结果的行集合中的第一行。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 - **SELECT列表** @@ -224,7 +224,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 CROSS JOIN等效于INNER JOIN ON（TRUE） ，即没有被条件删除的行。这种连接类型只是符号上的方便，因为它们与简单的FROM和WHERE的效果相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 其中CROSS JOIN和INNER JOIN生成一个简单的笛卡尔积，和在FROM的顶层列出两个项的结果相同。 @@ -261,7 +261,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 9. “(+)“只能出现”比较表达式”，”NOT表达式”，“ANY表达式”，“ALL表达式”，“IN表达式”，“NULLIF表达式”，“IS DISTINCT FROM表达式”，“IS OF”表达式。”(+)“不能出现在其他类型表达式中，并且这些表达式中不允许出现通过“AND”和“OR”连接的表达式。 10. “(+)“只能转化为左外连接或者右外连接，不能转化为全连接，即不能在一个表达式的两个表上同时指定”(+)“。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 - **GROUP BY子句** @@ -275,7 +275,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 GROUPING SETS子句是GROUP BY子句的进一步扩展，它可以使用户指定多个GROUP BY选项。 这样做可以通过裁剪用户不需要的数据组来提高效率。 当用户指定了所需的数据组时，数据库不需要执行完整CUBE或ROLLUP生成的聚合集合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 - **HAVING子句** @@ -315,7 +315,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 UNBOUNDED FOLLOWING ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 - **UNION子句** @@ -379,7 +379,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 - 如果对于所有声明的表达式都相同，则按随机顺序返回。 - ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: > > ```bash > initdb -E UTF8 -D ../data -locale=zh_CN.UTF-8或initdb -E GBK -D ../data -locale=zh_CN.GBK。 @@ -421,7 +421,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 如果一个表中同时出现（或隐含同时出现）在FOR UPDATE和FOR SHARE子句中，则按照FOR UPDATE处理。类似的，如果影响一个表的任意子句中出现了NOWAIT，该表将按照NOWAIT处理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询不支持for update/share。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询不支持for update/share。 - **NLS_SORT** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/126-SELECT-INTO.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/126-SELECT-INTO.md index 433e4bc9..213847bc 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/126-SELECT-INTO.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/126-SELECT-INTO.md @@ -64,14 +64,14 @@ new_table指定新建表的名称。 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > SELECT INTO的其它参数可参考SELECT的参数说明。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md index 6df84df0..563806f8 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md @@ -41,7 +41,7 @@ date: 2021-05-18 指定事务隔离级别，该参数决定当一个事务中存在其他并发运行事务时能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/134-START-TRANSACTION.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/134-START-TRANSACTION.md index 2d16fb53..dfd449f0 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/134-START-TRANSACTION.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/134-START-TRANSACTION.md @@ -51,7 +51,7 @@ BEGIN [ WORK | TRANSACTION ] 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/135-TRUNCATE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/135-TRUNCATE.md index 9838e84a..f346296f 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/135-TRUNCATE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/135-TRUNCATE.md @@ -78,7 +78,7 @@ date: 2021-05-18 取值范围: 需要进行删除数据分区的分区键的取值范围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 使用PARTITION FOR子句时，partition_value所在的整个分区会被清空。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/136-UPDATE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/136-UPDATE.md index 015c3891..9ea76fd2 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/136-UPDATE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/136-UPDATE.md @@ -83,7 +83,7 @@ SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 - **condition** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/137-VACUUM.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/137-VACUUM.md index 136610a5..9162707e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/137-VACUUM.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/137-VACUUM.md @@ -55,7 +55,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 - **FREEZE** @@ -93,7 +93,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 只针对列存表，将列存表的delta table中的数据转移到主表存储上。对列存表而言，此操作受enable_delta_store和参数说明中的deltarow_threshold控制。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 为了检查列存delta表中的信息，提供下述DFX函数，用于获取某个列存表的delta表中数据存储情况： > > - pgxc_get_delta_info(TEXT)，传入参数为列存表名，搜集并显示各个节点上的对应delta表信息，包括当前存活tuple数量、表大小、使用的最大block ID。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md index 7a7e6efc..53b4120c 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md @@ -69,7 +69,7 @@ date: 2021-05-17 ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。 > - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，普通用户只能查看有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。 @@ -126,7 +126,7 @@ date: 2021-05-17 重置全部的数据库会话参数值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。 > - 修改的数据库会话参数值，将在下一次会话中生效。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/22-ALTER-TABLE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/22-ALTER-TABLE.md index f74cfae3..52eaa2b0 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/22-ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/22-ALTER-TABLE.md @@ -67,7 +67,7 @@ date: 2021-05-17 | REPLICA IDENTITY {DEFAULT | USING INDEX index_name | FULL | NOTHING} ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD table_constraint [ NOT VALID ]** 给表增加一个新的约束。 @@ -132,7 +132,7 @@ date: 2021-05-17 | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 @@ -240,7 +240,7 @@ date: 2021-05-17 SET SCHEMA new_schema; ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。 - 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。 @@ -314,7 +314,7 @@ date: 2021-05-17 USING子句声明如何从旧的字段值里计算新的字段值；如果省略，缺省从旧类型向新类型的赋值转换。如果从旧数据类型到新类型没有隐含或者赋值的转换，则必须提供一个USING子句。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 - **NOT NULL | NULL** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md index 854ca870..654eae76 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md @@ -104,7 +104,7 @@ date: 2021-05-17 AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 列存分区表不支持切割分区。 > - 切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。 @@ -115,7 +115,7 @@ date: 2021-05-17 INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。 > - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。 @@ -154,7 +154,7 @@ date: 2021-05-17 [ TABLESPACE tablespacename ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - partition_list_item仅支持的1个分区键，其支持的数据类型参见**PARTITION BY LIST(partit…**。 > - 间隔/哈希分区表不支持添加分区。 @@ -165,7 +165,7 @@ date: 2021-05-17 DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 哈希分区表不支持删除分区。 > - 列表分区表仅支持通过子分区名称删除子分区。 @@ -249,7 +249,7 @@ date: 2021-05-17 在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 - **partition_new_name** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md index 795212b3..49a56321 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md @@ -17,7 +17,7 @@ date: 2021-05-17 - 要修改表空间的所有者A为B，则A必须是B的直接或者间接成员。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 ## 语法格式 @@ -88,7 +88,7 @@ date: 2021-05-17 - random_page_cost：设置优化器计算一次非顺序获取磁盘页面的开销。缺省为4.0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - random_page_cost是相对于seq_page_cost的取值，等于或者小于seq_page_cost时毫无意义。 > - 默认值为4.0的前提条件是，优化器采用索引来扫描表数据，并且表数据在cache中命中率可以90%左右。 @@ -107,7 +107,7 @@ date: 2021-05-17 - 由space_size来确定，其格式参考**CREATE TABLESPACE**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 修改参数MAXSIZE时也可使用： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 修改参数MAXSIZE时也可使用： > > ```sql > ALTER TABLESPACE tablespace_name RESIZE MAXSIZE diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md index 5bee39a5..7c3a6b1a 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md @@ -57,7 +57,7 @@ date: 2021-05-17 要修改的参数名。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不支持修改词典的TEMPLATE参数值。 > - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/28-ALTER-TYPE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/28-ALTER-TYPE.md index 387ed8c8..26e34f8c 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/28-ALTER-TYPE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/28-ALTER-TYPE.md @@ -133,7 +133,7 @@ date: 2021-05-17 如果需联动更新类型是已更新类型的关联记录，则拒绝更新。这是缺省选项。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - ADD ATTRIBUTE、DROP ATTRIBUTE和ALTER ATTRIBUTE选项可以组合成一个列表同时处理。 例如，在一条命令中同时增加几个属性或是更改几个属性的类型是可以实现的。 > - 要修改一个类型的模式，还必须在新模式上拥有CREATE权限。 要修改所有者，必须是新的所有角色的直接或间接成员， 并且该成员必须在此类型的模式上有CREATE权限。 （这些限制强制了修改所有者不会做任何通过删除和重建类型不能做的事情。 不过，系统管理员可以以任何方式修改任意类型的所有权。） 要增加一个属性或是修改一个属性的类型，也必须有该类型的USAGE权限。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md index bfcd6f44..3db177f2 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md @@ -39,7 +39,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 PARTITION ( patrition_name ) ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 - 收集多列统计信息 @@ -48,7 +48,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 table_name (( column_1_name, column_2_name [, ...] )); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 收集多列统计信息时，请设置GUC参数default_statistics_target为负数，以使用百分比采样方式。 > - 每组多列统计信息最多支持32列。 @@ -60,7 +60,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - Fast模式校验时，需要对校验的表有并发的DML操作，会导致校验过程中有误报的问题，因为当前Fast模式是直接从磁盘上读取，并发有其他线程修改文件时，会导致获取的数据不准确，建议离线操作。 > - 支持对全库进行操作，由于涉及的表较多，建议以重定向保存结果**gsql -d database -p port -f “verify.sql”> verify_warning.txt 2>&1**。 @@ -74,7 +74,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持对普通表的操作和索引表的操作，但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表，当单独对索引表进行检测时，无需使用CASCADE模式。 > - 对于主表的检测会同步检测主表的内部表，例如toast表、cudesc表等。 @@ -86,7 +86,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 ## 参数说明 @@ -94,7 +94,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 启用显示进度信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 - **table_name** @@ -182,7 +182,7 @@ INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若环境若有故障，需查看数据库主节点的log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若环境若有故障，需查看数据库主节点的log。 - 删除表。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/34-CALL.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/34-CALL.md index d6828893..a8b418bc 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/34-CALL.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/34-CALL.md @@ -39,7 +39,7 @@ CALL [schema.] {func_name| procedure_name} ( param_expr ); 取值范围: 已存在的函数参数名称或存储过程参数名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见示例。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md index b4788598..29a1106e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md @@ -139,7 +139,7 @@ ALTER DEFAULT PRIVILEGES 取值范围: 已存在的角色名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/41-COPY.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/41-COPY.md index 3629bda6..b7edfcc7 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/41-COPY.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/41-COPY.md @@ -43,7 +43,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 语法中的FIXED、FORMATTER ( { column_name( offset, length ) } [, …] )以及copy_option [ …]可以任意排列组合，但FIXED和FORMATTER必须配合使用。 - 把一个表的数据拷贝到一个文件。 @@ -65,7 +65,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. COPY TO语法形式约束如下： > (query)与[USING] DELIMITER不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。 @@ -156,7 +156,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 打开字段固定长度模式。在字段固定长度模式下，不能声明DELIMITER，NULL，CSV选项。指定FIXED类型后，不能再通过copy_option指定BINARY、CSV、TEXT等类型。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 定长格式定义如下： > > 1. 每条记录的每个字段长度相同。 @@ -183,7 +183,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 仅支持导入（即COPY FROM）时指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 此容错选项的使用限制如下： > > - 此容错机制仅捕捉COPY FROM过程中数据库主节点上数据解析过程中相关的数据类型错误（DATA_EXCEPTION）。 @@ -210,7 +210,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：若未指定LOG ERRORS，则会报错；若指定LOG ERRORS，则默认为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如上述LOG ERRORS中描述的容错机制，REJECT LIMIT的计数也是按照执行COPY FROM的数据库主节点上遇到的解析错误数量计算，而不是数据库节点的错误数量。 - **FORMATTER** @@ -247,7 +247,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 指定数据文件行数据的字段分隔符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 分隔符不能是\r和\n。 > - 分隔符不能和null参数相同，CSV格式数据的分隔符不能和quote参数相同。 @@ -295,7 +295,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -313,7 +313,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式导入。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -351,7 +351,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果行尾换行符丢失，使两行变成一行时，设置此参数为true将导致后一行数据被忽略掉。 - COMPATIBLE_ILLEGAL_CHARS @@ -365,7 +365,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -385,7 +385,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT @@ -414,7 +414,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 用来指定数据文件中空值的表示。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以应该确保指定的字符串和COPY TO相同。 取值范围: @@ -439,7 +439,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 导出数据时用于定义标题行的文件，一般用来描述每一列的数据信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 仅在header为on或true的情况下有效。 > - fileheader指定的是绝对路径。 @@ -456,7 +456,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 - 当前事务中没有打开的游标。 - 当前事务中没有原有的快照。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - FORCE NOT NULL column_name [, …] @@ -485,7 +485,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -503,7 +503,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -533,7 +533,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 若不使用该参数，导入时遇到非法字符进行报错，中断导入。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -547,7 +547,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目前COPY指定此Option实际不会生效，即不会有相应的容错处理效果（不生效）。需要额外注意的是，打开此选项会导致解析器在数据库主节点数据解析阶段（即COPY错误表容错的涵盖范围）忽略此数据问题，而到数据库节点重新报错，从而使得COPY错误表（打开LOG ERRORS REJECT LIMIT）在此选项打开的情况下无法成功捕获这类少列的数据异常。因此请不要指定此选项。 - DATE_FORMAT 'date_format_string' @@ -556,7 +556,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT 'time_format_string' diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md index 360d0f3c..182e7150 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md @@ -108,7 +108,7 @@ CREATE DATABASE database_name > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为MogDB将无法帮助你转换或者校验非ASCII字符。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 > - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[]^\_`a-z{|}重叠。其中@[]^\_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 @@ -133,7 +133,7 @@ CREATE DATABASE database_name 取值范围: A、B、C、PG。分别表示兼容O、MY、TD和POSTGRES。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 > - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 @@ -149,7 +149,7 @@ CREATE DATABASE database_name 数据库可以接受的并发连接数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，数据库MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md index 6387c1b9..90c83012 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md @@ -99,7 +99,7 @@ date: 2021-05-10 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。并且OUT和INOUT模式的参数不能用在RETURNS TABLE的函数定义中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: VARIADIC用于声明数组类型的参数。 - **argtype** @@ -141,7 +141,7 @@ date: 2021-05-10 表示该函数是窗口函数。替换函数定义时不能改变WINDOW属性。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 - **IMMUTABLE** @@ -243,7 +243,7 @@ date: 2021-05-10 PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/50-CREATE-INDEX.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/50-CREATE-INDEX.md index 7bc18122..0a181619 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/50-CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/50-CREATE-INDEX.md @@ -66,7 +66,7 @@ date: 2021-05-10 - 普通CREATE INDEX命令可以在事务内执行，但是CREATE INDEX CONCURRENTLY不可以在事务内执行。 - 列存表、分区表和临时表不支持CONCURRENTLY方式创建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > - 由于需要执行两次对表的扫描和build，而且必须等待现有的所有可能对该表执行修改的事务结束。这意味着该索引的创建比正常耗时更长，同时因此带来的CPU和I/O消耗对其他业务也会造成影响。 @@ -107,7 +107,7 @@ date: 2021-05-10 行存表支持的索引类型：btree（行存表缺省值）、gin、gist。列存表支持的索引类型：Psort（列存表缺省值）、btree、gin。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 - **column_name** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md index 6e56b42e..d0415f32 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -91,7 +91,7 @@ CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 系统管理员不受行访问控制特性影响。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 系统管理员不受行访问控制特性影响。 - **using_expression** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md index 8b5f3915..1226bde9 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md @@ -57,7 +57,7 @@ plsql_body 参数的模式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: VARIADIC用于声明数组类型的参数。 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。 @@ -97,9 +97,9 @@ plsql_body PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 ## 优化建议 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/54-CREATE-ROLE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/54-CREATE-ROLE.md index 3ec9dc3d..9065d6c1 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/54-CREATE-ROLE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/54-CREATE-ROLE.md @@ -67,7 +67,7 @@ CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { 取值范围: 字符串，要符合标识符的命名规范，且最多为63个字符。若超过63个字符，数据库会截断并保留前63个字符当做角色名称。在创建角色时，数据库的时候会给出提示信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 - **password** @@ -157,7 +157,7 @@ CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { 声明该角色可以使用的并发连接数量。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md index a39867b8..9794a8d3 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md @@ -41,7 +41,7 @@ date: 2021-05-10 模式名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 模式名不能和当前数据库里其他的模式重名。 > 模式的名称不可以“pg_”开头。 @@ -59,7 +59,7 @@ date: 2021-05-10 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md index 2ce55430..5bb1e95c 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md @@ -58,7 +58,7 @@ CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为1，表示一次只能生成一个值，也就是没有缓存。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 不建议同时定义cache和maxvalue或minvalue。因为定义cache后不能保证序列的连续性，可能会产生空洞，造成序列号段浪费。 - **CYCLE** @@ -79,7 +79,7 @@ CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为OWNED BY NONE，表示不存在这样的关联。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过OWNED BY创建的Sequence不建议用于其他表，如果希望多个表共享Sequence，该Sequence不应该从属于特定表。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md index 19bd23a4..b4b40052 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md @@ -40,7 +40,7 @@ CREATE [ OR REPLACE ] SYNONYM synonym_name 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > object_name可以是不存在的对象名称。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/60-CREATE-TABLE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/60-CREATE-TABLE.md index 74935c89..8a115aa1 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/60-CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/60-CREATE-TABLE.md @@ -108,7 +108,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 @@ -159,7 +159,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）会复制到新表中。默认情况下，不复制源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果源表包含serial、bigserial、smallserial类型，或者源表字段的默认值是sequence，且sequence属于源表（通过CREATE SEQUENCE … OWNED BY创建），这些Sequence不会关联到新表中，新表中会重新创建属于自己的sequence。这和之前版本的处理逻辑不同。如果用户希望源表和新表共享Sequence，需要首先创建一个共享的Sequence（避免使用OWNED BY），并配置为源表字段默认值，这样创建的新表会和源表共享该Sequence。 > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 @@ -168,7 +168,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 这个子句为表或索引指定一个可选的存储参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 参数的详细描述如下所示。 @@ -279,7 +279,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 - **DEFAULT default_expr** @@ -990,7 +990,7 @@ mogdb=# DROP SCHEMA IF EXISTS joe CASCADE; - 如果指定了INCLUDING PARTITION，则源表的分区定义会复制到新表中，同时新表将不能再使用PARTITION BY子句。默认情况下，不拷贝源表的分区定义。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 - LIKE INCLUDING RELOPTIONS diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md index 0338b95b..68c21cfb 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md @@ -54,7 +54,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE table_name 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md index 7d309307..e740522b 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md @@ -194,7 +194,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -235,19 +235,19 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name （1）对于从句是VALUES LESS THAN的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、CHARACTER VARYING(n)、VARCHAR(n)、CHARACTER(n)、CHAR(n)、CHARACTER、CHAR、TEXT、NVARCHAR2、NAME、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （2）对于从句是START END的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （3）对于指定了INTERVAL子句的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 @@ -255,7 +255,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name 指定各分区的信息。partition_name为范围分区的名称。partition_value为范围分区的上边界，取值依赖于partition_key的类型。MAXVALUE表示分区的上边界，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 每个分区都需要指定一个上边界。 > - 分区上边界的类型应当和分区键的类型一致。 @@ -272,7 +272,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_value：对[START，END) 表示的范围进行切分，interval_value是指定切分后每个分区的宽度，不可是MAXVALUE；如果（END-START）值不能整除以EVERY值，则仅最后一个分区的宽度小于EVERY值。 - MAXVALUE：表示最大值，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 1. 在创建分区表若第一个分区定义含START值，则范围（MINVALUE，START）将自动作为实际的第一个分区。 > 2. START END语法需要遵循以下限制： @@ -292,7 +292,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - STORE IN (tablespace_name [, … ] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列存表不支持间隔分区。 - **PARTITION BY LIST(partition_key)** @@ -322,7 +322,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ENABLE（缺省值）：行迁移开关打开。 - DISABLE：行迁移开关关闭。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持ROW MOVEMENT。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持ROW MOVEMENT。 - **NOT NULL** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md index 5808fa83..533e442f 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md @@ -136,7 +136,7 @@ CREATE TEXT SEARCH DICTIONARY name ( 词典定义文件所在目录。可以指定为本地目录或者OBS目录。其中，本地目录格式为”file://absolute_path”，OBS目录格式为”obs://bucket_name/path accesskey=ak secretkey=sk region=rg”。默认值为预定义词典文件所在目录。FILEPATH参数必须和STOPWORDS参数同时指定，不允许单独指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 词典定义文件的文件名仅支持小写字母、数据、下划线混合。 - **value** diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md index 19faba3d..da43a174 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md @@ -127,7 +127,7 @@ CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | INSTEAD OF } { eve 执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关于触发器种类： > > - INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/67-CREATE-TYPE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/67-CREATE-TYPE.md index 14a8fd05..3b7f62d8 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/67-CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/67-CREATE-TYPE.md @@ -107,7 +107,7 @@ CREATE TYPE name AS ENUM 输入函数必须返回一个该数据类型本身的值。通常，一个输入函数应该被声明为STRICT。 如果不是这样，在读到一个NULL输入值时，调用输入函数时第一个参数会是NULL。在这种情况下，该函数必须仍然返回NULL，除非调用函数发生了错误（这种情况主要是想支持域输入函数，域输入函数可能需要拒绝NULL输入）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 输入和输出函数能被声明为具有新类型的结果或参数是因为：必须在创建新类型之前创建这两个函数。而新类型应该首先被定义为一种shell type，它是一种占位符类型，除了名称和拥有者之外它没有其他属性。这可以通过不带额外参数的命令CREATE TYPE name做到。然后用C写的I/O函数可以被定义为引用这种shell type。最后，用带有完整定义的CREATE TYPE把该shell type替换为一个完全的、合法的类型定义，之后新类型就可以正常使用了。 - **output_function** @@ -143,7 +143,7 @@ CREATE TYPE name AS ENUM 可选参数。将类型的修饰符的内部形式转换为外部文本形式的函数名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果该类型支持修饰符（附加在类型声明上的可选约束，例如，char(5)或numeric(30,2)），则需要可选的type_modifier_input_function以及type_modifier_output_function。MogDB允许用户定义的类型有一个或者多个简单常量或者标识符作为修饰符。不过，为了存储在系统目录中，该信息必须能被打包到一个非负整数值中。所声明的修饰符会被以cstring数组的形式传递给type_modifier_input_function。 type_modifier_input_function必须检查该值的合法性（如果值错误就抛出一个错误），如果值正确，要返回一个非负integer值，该值将被存储在“typmod”列中。如果类型没有 type_modifier_input_function则类型修饰符将被拒绝。type_modifier_output_function把内部的整数typmod值转换回正确的形式用于用户显示。type_modifier_output_function必须返回一个cstring值，该值就是追加到类型名称后的字符串。例如，numeric的函数可能会返回(30,2)。如果默认的显示格式就是只把存储的typmod整数值放在圆括号内，则允许省略type_modifier_output_function。 - **analyze_function** @@ -198,7 +198,7 @@ CREATE TYPE name AS ENUM 可选参数。如果这种类型是其类型分类中的优先类型则为TRUE，否则为FALSE。默认为假。在一个现有类型分类中创建一种新的优先类型要非常谨慎， 因为这可能会导致很大的改变。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > category和preferred参数可以被用来帮助控制在混淆的情况下应用哪一种隐式造型。每一种数据类型都属于一个用单个ASCII 字符命名的分类，并且每一种类型可以是其所属分类中的“首选”。当有助于解决重载函数或操作符时，解析器将优先造型到首选类型（但是只能从同类的其他类型造型）。对于没有隐式转换到或来自任意其他类型的类型，让这些设置保持默认即可。不过，对于有隐式转换的相关类型的组，把它们都标记为属于同一个类别并且选择一种或两种“最常用”的类型作为该类别的首选通常是很有用的。在把一种用户定义的类型增加到一个现有的内建类别（例如，数字或者字符串类型）中时，category参数特别有用。不过，也可以创建新的全部是用户定义类型的类别。对这样的类别，可选择除大写字母之外的任何ASCII 字符。 - **default** @@ -227,7 +227,7 @@ CREATE TYPE name AS ENUM 可选参数。与枚举类型的一个值相关的文本标签，其值为长度不超过63个字符的非空字符串。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在创建用户定义类型的时候， MogDB会自动创建一个与之关联的数组类型，其名称由该元素类型的名称前缀一个下划线组成。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/70-CREATE-VIEW.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/70-CREATE-VIEW.md index b1c2b49c..bd4ee0b5 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/70-CREATE-VIEW.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/70-CREATE-VIEW.md @@ -23,7 +23,7 @@ CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( column_name [, ... AS query; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 创建视图时使用WITH(security_barriers)可以创建一个相对安全的视图，避免攻击者利用低成本函数的RAISE语句打印出隐藏的基表数据。 ## 参数说明 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/78-DROP-DATABASE.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/78-DROP-DATABASE.md index d5d11115..578d2e5e 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/78-DROP-DATABASE.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/78-DROP-DATABASE.md @@ -19,7 +19,7 @@ date: 2021-05-10 - 不能在事务块中执行DROP DATABASE命令。 - 如果执行DROP DATABASE失败，事务回滚，需要再次执行一次DROP DATABASE IF EXISTS。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DROP DATABASE一旦执行将无法撤销，请谨慎使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DROP DATABASE一旦执行将无法撤销，请谨慎使用。 ## 语法格式 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/9-ALTER-INDEX.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/9-ALTER-INDEX.md index 08e090fd..b0d62014 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/9-ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/9-ALTER-INDEX.md @@ -90,7 +90,7 @@ ALTER INDEX用于修改现有索引的定义。 [ MODIFY PARTITION index_partition_name ] UNUSABLE; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表不支持该语法。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表不支持该语法。 - 重建表索引或索引分区。 diff --git a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md index 379cfa21..c64abe0f 100644 --- a/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md +++ b/product/zh/docs-mogdb/v1.1.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md @@ -38,9 +38,9 @@ DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRICT ]; - CASCADE：自动删除包含在模式中的对象。 - RESTRICT：如果模式包含任何对象，则删除失败（缺省行为）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 ## 示例 diff --git a/product/zh/docs-mogdb/v1.1.0/security-guide/security/1-client-access-authentication.md b/product/zh/docs-mogdb/v1.1.0/security-guide/security/1-client-access-authentication.md index 42d769b7..68df8592 100644 --- a/product/zh/docs-mogdb/v1.1.0/security-guide/security/1-client-access-authentication.md +++ b/product/zh/docs-mogdb/v1.1.0/security-guide/security/1-client-access-authentication.md @@ -219,13 +219,13 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | 参数 | 描述 | 取值范围 | | :------------ | :------------------------------------ | :-----------------------------------| -| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值:**on | -| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值:**off | +| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值**: on | +| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值**: off | | ssl_cert_file | 指定服务器证书文件，包含服务器端的公钥。服务器证书用以表明服务器身份的合法性，公钥将发送给对端用来对数据进行加密。 | 请以实际的证书名为准。必须使用相对路径，相对路径是相对于数据目录的。
**默认值**: server.crt | | ssl_key_file | 指定服务器私钥文件，用以对公钥加密的数据进行解密。 | 请以实际的服务器私钥名称为准。必须使用相对路径，相对路径是相对于数据目录的。
**默认值**: server.key | | ssl_ca_file | CA服务器的根证书。此参数可选择配置，需要验证客户端证书的合法性时才需要配置。 | 请以实际的CA服务器根证书名称为准。
**默认值**: cacert.pem | | ssl_crl_file | 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。 | 请以实际的证书吊销列表名称为准。
**默认值**: 空，表示没有吊销列表。 | -| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值:**ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | +| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值**: ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | 在客户端配置SSL认证相关的环境变量，详细信息请参见[表3](#表1.3.3)。 @@ -238,9 +238,9 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | :------------ | :---------------------------------------------------------- | :--------------------------------------------------------- | | PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如:
**`export PGSSLCERT='/home/omm/client.crt'`**
**默认值**: 空 | | PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如:
**`export PGSSLKEY='/home/omm/client.key'`**
**默认值**: 空 | -| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值:**prefer | -| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值:**空 | -| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值:**空 | +| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值**: prefer | +| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值**: 空 | +| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值**: 空 | 服务器端参数ssl、require_ssl与客户端参数sslmode配置组合结果如下: diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-2-br.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-2-br.md index 6791bd82..252b41c9 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-2-br.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-2-br.md @@ -493,7 +493,7 @@ PTRACK：创建PTRACK增量备份。 **恢复目标相关参数(recovery_options)** - **说明：** + **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： @@ -530,7 +530,7 @@ PTRACK：创建PTRACK增量备份。 **留存相关参数(retention_options)** -**说明：** +**说明**: 可以和backup和delete命令一起使用这些参数。 @@ -570,7 +570,7 @@ PTRACK：创建PTRACK增量备份。 **固定备份相关参数(pinning_options)** -**说明：** +**说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -644,7 +644,7 @@ PTRACK：创建PTRACK增量备份。 **连接相关参数(connection_options)** -**说明：** +**说明**: 可以和backup命令一起使用这些参数。 @@ -686,7 +686,7 @@ PTRACK：创建PTRACK增量备份。 **压缩相关参数(compression_options)** - **说明：** + **说明**: 可以和backup命令一起使用这些参数。 @@ -715,7 +715,7 @@ PTRACK：创建PTRACK增量备份。 **远程模式相关参数(remote_options)** -**说明：** +**说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-3-br.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-3-br.md index 8fd404a9..6e605fdb 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-3-br.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/br/1-3-br.md @@ -387,7 +387,7 @@ gs_dump -p port_number -f dump1.sql AES128密钥长度必须是16字节。 -**说明：** +**说明**: 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md index 96f9fe71..6aae374b 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md @@ -11,7 +11,7 @@ date: 2021-03-04 测试使用了BenchmarkSQL（请参见**MOT样例TPC-C基准**），并且使用交互式SQL命令而不是存储过程来生成工作负载。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 评估MogDB MOT性能和磁盘性能的所有测试都使用了同步日志记录和在MOT中优化的group-commit=on版本。 @@ -134,7 +134,7 @@ MOT高吞吐量测试结果如下。 MOT的平均事务速度为2.5倍，MOT延迟为10.5ms，而基于磁盘的表延迟为23至25ms。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 **图 2** 低延迟（90th%，事务平均）性能基准 @@ -152,7 +152,7 @@ MOT完全集成到MogDB中，包括支持主备部署的高可用场景。WAL重 **MogDB（包括MOT）的RTO小于10秒。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ 另外，从[MOT高吞吐量](#MOT高吞吐量)的MOT中可以看出，在Arm/鲲鹏架构下，主从高可用场景复制开销仅为7%，在x86架构下仅为2%，而基于磁盘的表复制开销为2%。Arm/鲲鹏机型为20%，x86机型为15%。 @@ -173,7 +173,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。
diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md index e2f6c514..a5c02b38 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md @@ -74,7 +74,7 @@ MOT不需要任何特殊修改或安装新软件。但是，一些优化可以 MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完全驻留在内存中。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 服务器上必须有足够的物理内存以维持内存表的状态，并满足工作负载和数据的增长。所有这些都是在传统的基于磁盘的引擎、表和会话所需的内存之外的要求。因此，提前规划好足够的内存来容纳这些内容是非常有必要的。 @@ -94,7 +94,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 如果违反此限制，则调整MOT内存内部限制，最大可能地满足上述限制范围。该调整在启动时进行，并据此计算MOT最大内存值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 此时，会向服务器日志发出警告，如下所示： @@ -181,7 +181,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 在配置max_mot_local_memory设置和应用程序开发时，请考虑此场景。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**内存（MOT）**部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**内存（MOT）**部分。
@@ -209,7 +209,7 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 检查点之所以需要两倍大小，是因为快照会保存数据的全部大小到磁盘上，此外还应该为正在进行的检查点分配同样数量的空间。当检查点进程结束时，以前的检查点文件将被删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 - **日志记录** @@ -223,4 +223,4 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低延迟的驱动器上。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**存储（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**存储（MOT）**。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md index 3ff75fa1..654ded43 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md @@ -297,7 +297,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 阅读**总体原则**，根据需要查看和配置mot.conf文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 以下介绍了mot.conf文件中的各个部分，其包含的设置以及默认值。 @@ -395,7 +395,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 检查点由多个MOT引擎工作线程并行执行。工作线程的数量可能会大大影响整个检查点操作的整体性能，以及其它正在运行的事务的操作。为了实现较短的检查点持续时间，应使用更多线程，直至达到最佳数量（根据硬件和工作负载的不同而不同）。但请注意，如果这个数目太大，可能会对其他正在运行的事务的执行时间产生负面影响。尽可能低这个数字，以最小化对其他运行事务的运行时的影响。当此数目过高时，检查点持续时间会较长。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**MOT检查点**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**MOT检查点**。
@@ -405,7 +405,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 指定在检查点数据恢复期间要使用的工作线程数。每个MOT引擎工作线程在自己的核上运行，通过将不同的表读入内存，可以并行处理不同的表。缺省值为3，可将此参数设置为可处理的核数。恢复后，将停止并杀死这些线程。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**MOT恢复**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**MOT恢复**。
diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md index 3b987d89..ea3b811c 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md @@ -30,7 +30,7 @@ MogDB允许应用程序使用MOT和基于标准磁盘的表。MOT适用于最活 以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次： @@ -96,7 +96,7 @@ create FOREIGN table bmsql_oorder ( create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 有关MOT索引限制，请参见“MOT SQL覆盖和限制”的索引部分内容。 @@ -134,7 +134,7 @@ create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) 6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。 7. 恢复应用程序活动。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
@@ -301,7 +301,7 @@ MOT编译支持的特性和不支持的特性见下文。 在乐观并发控制（OCC）中，在COMMIT阶段前的事务期间（使用任何隔离级别）不会对记录进行锁定。这是一个能显著提高性能的强大优势。它的缺点是，如果另一个会话尝试更新相同的记录，则更新可能会失败。所以必须中止整个事务。这些所谓的更新冲突是由MOT在提交时通过版本检查机制检测到的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 这种更新冲突在常见的OLTP场景中非常少见，在使用MOT时尤其少见。但是，由于仍有可能发生这种情况，开发人员应该考虑使用事务重试代码来解决此问题。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md index ba7acdb6..0b3f1a37 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md @@ -133,7 +133,7 @@ WAL重做日志将保留所有表行修改，直到执行检查点（如上所 - group_commit_size：一组已提交的事务数。例如，16表示当同一组中的16个事务已由它们的客户端应用程序提交时，则针对16个事务中的每个事务，在磁盘的WAL重做日志中写入一个条目。 - group_commit_timeout：超时时间，单位为毫秒。例如，10表示在10毫秒之后，为同一组由客户端应用程序在最近10毫秒内提交的每个事务，在磁盘的WAL重做日志中写入一个条目。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**重做日志（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**重做日志（MOT）**。
@@ -414,7 +414,7 @@ MOT使用返回码（Return Code，RC）返回Postgres标准错误代码至封 MOT从内部返回Postgres代码（见下文）到数据库包，数据库封装根据标准的Postgres行为对其做出反应。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 **表 2** 返回给用户并记录到日志文件的错误 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md index 74790a9e..906bdff5 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md @@ -47,7 +47,7 @@ tpm-C指标是每分钟执行的新订单事务数。考虑到事务中所需的 tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 ## 系统级优化 @@ -65,7 +65,7 @@ tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 在下载的Java文件（与原始文件相比）中所做的唯一更改是注释错误日志打印，以进行序列化和重复键错误。这些错误在MOT中是正常的，因为MOT使用的是乐观并发控制（OCC）机制。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 基准测试使用标准交互式SQL模式执行，没有存储过程。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 基准测试使用标准交互式SQL模式执行，没有存储过程。 ## 运行基准 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md index a8ebefc5..fe966232 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md @@ -17,7 +17,7 @@ MOT旨在实现以下目标： - **线性扩容**：MOT提供事务性存储引擎，利用单个NUMA架构服务器的所有核，以提供近线性的扩容性能。这意味着MOT的目标是在机器的核数和性能提升倍数之间实现直接的、近线性的关系。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md index dee9cd44..3d7e994b 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md @@ -9,7 +9,7 @@ date: 2021-03-04 通过大量研究，我们找到了最佳的并发控制机制，结论为：基于SILO的OCC算法是MOT中最符合ACID特性的OCC算法。SILO为满足MOT的挑战性需求提供了最好的基础。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 下面介绍MOT的并发控制机制。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md index f76fd7d2..11d0fb72 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md @@ -40,7 +40,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 - 在恢复期间，从最后一个已知或特定检查点加载数据；然后使用WAL重做日志完成从该点开始发生的数据更改。 - WAL重做日志将保留所有表行修改，直到执行一个检查点为止（如上所述）。然后可以截断日志，以减少恢复时间和节省磁盘空间。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。
@@ -86,7 +86,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 这样，将事务写入WAL更为有效，因为来自同一个槽位的所有缓冲区都一起写入磁盘。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 2. 在事务完成并且客户端应用程序发送Commit命令之后，事务重做日志条目将与属于同一组的其他事务一起序列化。 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md index 55a005df..91ae33fb 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md @@ -17,7 +17,7 @@ date: 2021-06-24 gs_om -t start ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 双机启动必须以双机模式启动, 若中间过程以单机模式启动, 则必须修复才能恢复双机关系, 用gs_ctl build进行修复，gs_ctl的使用方法请参见《MogDB 工具参考》。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 双机启动必须以双机模式启动, 若中间过程以单机模式启动, 则必须修复才能恢复双机关系, 用gs_ctl build进行修复，gs_ctl的使用方法请参见《MogDB 工具参考》。 ## 停止MogDB @@ -29,7 +29,7 @@ date: 2021-06-24 gs_om -t stop ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 启停节点及AZ的操作请参见《MogDB 工具参考》中“服务端工具 > gs_om”章节。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 启停节点及AZ的操作请参见《MogDB 工具参考》中“服务端工具 > gs_om”章节。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/11-log-reference.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/11-log-reference.md index 818f1547..d27b6e17 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/11-log-reference.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/11-log-reference.md @@ -61,7 +61,7 @@ postgresql-创建时间.log 其中$GAUSSLOG默认为“/var/log/mogdb/_用户名_”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果使用om脚本部署时，则日志路径为 “/var/log/mogdb/_用户名_”。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果使用om脚本部署时，则日志路径为 “/var/log/mogdb/_用户名_”。 **日志文件命名格式** @@ -102,7 +102,7 @@ postgresql-创建时间.log 例如，系统中的第一个事务日志文件是000000010000000000000000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 **日志内容说明** diff --git a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md index 627a2f5d..d2f908be 100644 --- a/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md +++ b/product/zh/docs-mogdb/v2.0.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md @@ -141,7 +141,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 gs_guc set -N all -I all -h "host all jack 172.16.0.245/24 sha256" ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 使用"jack"用户前，需先本地连接数据库，并在数据库中使用如下语句建立"jack"用户: @@ -176,14 +176,14 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 因为认证时系统是为每个连接请求顺序检查"pg_hba.conf"里的记录的，所以这些记录的顺序是非常关键的。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在配置"pg_hba.conf"文件时，请依据通讯需求按照格式内容从上至下配置记录，优先级高的需求需要配置在前面。MogDB和扩容配置的IP优先级最高，用户手动配置的IP请放在这二者之后，如果已经进行的客户配置和扩容节点的IP在同一网段，请在扩容前删除，扩容成功后再进行配置。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在配置"pg_hba.conf"文件时，请依据通讯需求按照格式内容从上至下配置记录，优先级高的需求需要配置在前面。MogDB和扩容配置的IP优先级最高，用户手动配置的IP请放在这二者之后，如果已经进行的客户配置和扩容节点的IP在同一网段，请在扩容前删除，扩容成功后再进行配置。 因此对于认证规则的配置建议如下: - 靠前的记录有比较严格的连接参数和比较弱的认证方法。 - 靠后的记录有比较宽松的连接参数和比较强的认证方法。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 一个用户要想成功连接到特定的数据库，不仅需要通过pg_hba.conf中的规则检查，还必须要有该数据库上的CONNECT权限。如果希望控制某些用户只能连接到指定数据 库，赋予/撤销CONNECT权限通常比在pg_hba.conf中设置规则更为简单。 @@ -205,7 +205,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 3. 获取软件安装包中的"MogDB-2.0.0-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 软件包相对位置为安装时所放位置，根据实际情况填写。 - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -248,6 +248,6 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 postgres为需要连接的数据库名称，172.16.0.176为数据库主节点所在的服务器IP地址，jack为连接数据库的用户，26000为数据库主节点的端口号，Test@123为连接数据库用户jack的密码。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 由于安全性限制，数据库初始用户omm无法进行远程连接。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md index ce91e6c2..108b333e 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md @@ -22,7 +22,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 2. 信息收集： @@ -68,7 +68,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 2. 执行业务查询语句。 @@ -84,7 +84,7 @@ date: 2021-05-19 ## 模型管理（系统管理员用户） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 模型管理操作需要在数据库正常的状态下进行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 模型管理操作需要在数据库正常的状态下进行。 1. 新增模型： @@ -96,7 +96,7 @@ date: 2021-05-19 INSERT INTO gs_opt_model values('rlstm', 'model_name', 'datname', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text'); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 具体模型参数设置请参考GS_OPT_MODEL。 - 目前 “template_name” 列只支持 “rlstm”; - “datname” 列请和用于模型使用和训练的数据库保持一致，否则无法使用。 - “model_name” 一列需要满足unique约束。 - 其他参数设置见产品文档最佳实践部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 具体模型参数设置请参考GS_OPT_MODEL。 - 目前 “template_name” 列只支持 “rlstm”; - “datname” 列请和用于模型使用和训练的数据库保持一致，否则无法使用。 - “model_name” 一列需要满足unique约束。 - 其他参数设置见产品文档最佳实践部分。 2. 修改模型参数： @@ -174,7 +174,7 @@ date: 2021-05-19 ## 模型预测 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 - 目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。 例：INSERT INTO gs_opt_model values('rlstm', 'default', 'mogdb', '127.0.0.1', 5000, 1000, 1, -1, 50, 500, 0 , false, false, '{**S**, T}', '{0,0}', '{0,0}', 'Text'); +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 - 目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。 例：INSERT INTO gs_opt_model values('rlstm', 'default', 'mogdb', '127.0.0.1', 5000, 1000, 1, -1, 50, 500, 0 , false, false, '{**S**, T}', '{0,0}', '{0,0}', 'Text'); 1. 调用explain接口： diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md index 85bef905..c9df685e 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md @@ -25,7 +25,7 @@ date: 2021-05-19 调优程序是一个独立于数据库内核之外的工具，需要提供数据库及其所在实例的用户名和登录密码信息，以便控制数据库执行benchmark进行性能测试；在启动调优程序前，要求用户测试环境交互正常，能够正常跑通benchmark测试脚本、能够正常连接数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 调优程序X-Tuner包含三种运行模式，分别是: @@ -33,7 +33,7 @@ date: 2021-05-19 - train: 通过用户提供的benchmark信息，不断地进行参数修改和benchmark的执行。通过反复的迭代过程，训练强化学习模型，以便用户在后面通过tune模式加载该模型进行调优。 - tune: 使用优化算法进行数据库参数的调优，当前支持两大类算法，一种是深度强化学习，另一种是全局搜索算法（全局优化算法）。深度强化学习模式要求先运行train模式，生成训练后的调优模型，而使用全局搜索算法则不需要提前进行训练，可以直接进行搜索调优。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 **图 1** X-Tuner 结构图
@@ -46,7 +46,7 @@ X-Tuner 的整体架构如图1 X-Tuner 结构图所示，系统可以分为： - X-Tuner 主体逻辑模块：通过Enviroment模块进行封装，每一个step 就是一次调优过程。整个调优过程通过多个step进行迭代； - benchmark: 由用户指定的benchmark性能测试脚本，用于运行benchmark作业，通过跑分结果反映数据库系统性能优劣。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPCH这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPCH这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。
diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md index bf04caa3..c9a88102 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md @@ -40,7 +40,7 @@ X-Tuner 支持三种模式，分别是获取参数诊断报告的recommend模式 则可通过 -f connection.json 传递。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。
@@ -70,7 +70,7 @@ gs_xtuner recommend -f connection.json - checkpoint_avg_sync_time：数据库在checkpoint 时，平均每次同步刷新数据到磁盘的时长，单位是毫秒。 - load_average：平均**每个CPU核心**在1分钟、5分钟以及15分钟内的负载。一般地，该数值在1左右表明当前硬件比较匹配workload、在3左右表明运行当前作业压力比较大，大于5则表示当前硬件环境运行该workload压力过大（此时一般建议减少负载或升级硬件）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限）。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。清除统计信息的方法为： select pg_stat_reset_shared('bgwriter'); select pg_stat_reset(); +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限）。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。清除统计信息的方法为： select pg_stat_reset_shared('bgwriter'); select pg_stat_reset();
diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md index f05ba6bf..dae57f15 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md @@ -61,7 +61,7 @@ gensim SQL语句执行耗时,SQL语句文本 ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 列之间的分隔符为',' + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 列之间的分隔符为',' 测试数据格式为： diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md index 05e2f0a9..d10313cc 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md @@ -133,7 +133,7 @@ forecast_interval = 100S forecast_period = 60S ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持的时间单位： 'S' -> second, 秒 'M' -> minute, 分 'H' -> hour,小时 'D' -> day,天 'W' -> week,周 > - minimum和maximum至少提供一个，不能都不提供。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md index bb6c009a..4748f6b2 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md @@ -15,7 +15,7 @@ date: 2021-05-19 | :-------------- | :------------ | :----------------------------- | | gs_index_advise | SQL语句字符串 | 针对单条查询语句生成推荐索引。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。
@@ -55,4 +55,4 @@ mogdb=# select * from gs_index_advise('select name, age, sex from t1 where age > CREATE INDEX idx1 on t1(age, sex); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md index 5e9661cc..70d49de3 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md @@ -118,7 +118,7 @@ date: 2021-05-19 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 执行EXPLAIN ANALYZE不会涉及虚拟索引功能。 > - 创建的虚拟索引是数据库实例级别的，各个会话（session)之间可共享设置，关闭会话后虚拟索引仍可存在，但是重启数据库后将被清空。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md index d47abd54..0f5b7e23 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md @@ -36,7 +36,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 pip install scipy ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果自行编译python，需要在**configure**脚本执行时加入**-enable-shared**参数； > - 如果系统中的python2使用的UCS4编码，自行编译python2时，还需要加入**-enable-unicode=ucs4**参数。 可以在系统中自带的python2下执行：“import sys；print sys.maxunicode”并查看结果，如果结果是65535，说明系统默认的是ucs2；如果结果是1114111，说明用的ucs4编码。 @@ -78,7 +78,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 其中， {YOUR_MADLIB_INSTALL_FOLDER}需要改为用户的实际安装路径。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： > > ```bash > ./configure -DCMAKE_INSTALL_PREFIX={YOUR_MADLIB_INSTALL_FOLDER} # your install folder @@ -111,7 +111,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 install为安装的命令，除此之外，还有reinstall（重新安装），uninstall（卸载）等命令可用。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 目标数据库必须存在。 > - IP请使用127.0.0.1，不要使用localhost。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md index 7a43305c..50de1436 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md @@ -196,7 +196,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考审计。 当前PL/Python存储过程对并发执行不友好，建议串行执行。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。
@@ -204,7 +204,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考审计。 具体库内算法介绍和使用，可参考MADlib官方网站（MADlib文档）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当前仅支持机器学习算法，不支持深度学习（deep learning)模块。 > - 当前数据库不支持xml，所以pmml模块和相关功能不支持。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-4-best-practices.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-4-best-practices.md index ce0bd99f..906c3eb3 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-4-best-practices.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/AI-features/7-deepsql/7-4-best-practices.md @@ -161,7 +161,7 @@ create database test1 dbcompatibility='B'; 除了指定不同的核方法外，还可以指定迭代次数，初始参数，比如init_stepsize, max_iter, class_weight等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > ```sql > SET search_path="$user",public,madlib; diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/autonomous-transaction/4-restrictions.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/autonomous-transaction/4-restrictions.md index cbc933e0..32e3e04b 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/autonomous-transaction/4-restrictions.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/autonomous-transaction/4-restrictions.md @@ -42,7 +42,7 @@ $$; - 自治事务不支持执行嵌套 - **须知：** 在一个包含自治事务的函数中，通过perform、select、call等来显式执行另一个包含自治事务的函数或者存储过程是不被允许的，但是可以在最后return里显式调用另一个包含自治事务的函数或者存储过程。 + **须知**: 在一个包含自治事务的函数中，通过perform、select、call等来显式执行另一个包含自治事务的函数或者存储过程是不被允许的，但是可以在最后return里显式调用另一个包含自治事务的函数或者存储过程。 - 包含自治事务的函数，不支持参数传递的返回值 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md index 47294767..fd3efa67 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md @@ -28,5 +28,5 @@ java.sql.Connection是数据库连接接口。 | setClientInfo(Properties properties) | void | Yes | | setClientInfo(String name,String value) | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 接口内部默认使用自动提交模式，若通过setAutoCommit(false)关闭自动提交，将会导致后面执行的语句都受到显式事务包裹，数据库中不支持事务中执行的语句不能在此模式下执行。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md index 3a46627b..ad1d10ac 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md @@ -30,7 +30,7 @@ java.sql.CallableStatement是存储过程执行接口。 | getTimestamp(int parameterIndex) | Timestamp | Yes | | getObject(int parameterIndex) | Object | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不允许含有OUT参数的语句执行批量操作。 > - 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows , setFetchSize。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md index e1b33038..9aa8ee6b 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md @@ -33,7 +33,7 @@ java.sql.PreparedStatement是预处理语句接口。 | executeBatch() | int[] | Yes | | clearBatch() | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - addBatch()、execute()必须在clearBatch()之后才能执行。 > - 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除 。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md index a2e9c0b9..210e674e 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md @@ -45,7 +45,7 @@ java.sql.ResultSet是执行结果集接口。 | isFirst() | Boolean | Yes | | next() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一个Statement不能有多个处于"open"状态的ResultSet。 > - 用于遍历结果集(ResultSet)的游标(Cursor)在被提交后不能保持“open”的状态。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md index 1598a2a3..b19cd3f5 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md @@ -26,7 +26,7 @@ java.sql.Statement是SQL语句接口。 | setFetchSize(int rows) | void | Yes | | cancel() | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，会有性能损耗。 > - 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md index d5dca34b..93c32080 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md @@ -135,7 +135,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: > > - MogDB数据库不支持带有输出参数的函数，也不支持存储过程和函数参数默认值。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 > diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md index 7dbb5a0a..fefdd9f3 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md @@ -42,7 +42,7 @@ PGresult：包含查询结果的对象指针。 - PQprepare创建一个为PQexecPrepared执行用的预备语句，本特性支持命令的重复执行，不需要每次都进行解析和规划。PQprepare仅在协议3.0及以后的连接中支持，使用协议2.0时，PQprepare将失败。 - 该函数从查询字符串创建一个名为stmtName的预备语句，该查询字符串必须包含一个SQL命令。stmtName可以是”“来创建一个未命名的语句，在这种情况下，任何预先存在的未命名的语句都将被自动替换；否则，如果在当前会话中已经定义了语句名称，则这是一个错误。如果使用了任何参数，那么在查询中将它们称为$1,$2等。nParams是在paramTypes[]数组中预先指定类型的参数的数量。（当nParams为0时，数组指针可以为NULL） paramTypes[]通过OID指定要分配给参数符号的数据类型。如果paramTypes为NULL ，或者数组中的任何特定元素为零，服务器将按照对非类型化字面字符串的相同方式为参数符号分配数据类型。另外，查询可以使用数字高于nParams的参数符号；还将推断这些符号的数据类型。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过执行SQLPREPARE语句，还可以创建与PQexecPrepared一起使用的预备语句。此外，虽然没有用于删除预备语句的libpq函数，但是SQL DEALLOCATE语句可用于此目的。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md index 40b9d44f..01bbbdfd 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md @@ -34,7 +34,7 @@ PGresult：包含查询结果的对象指针。 应该调用PQresultStatus函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回PGRES_FATAL_ERROR）。使用PQerrorMessage获取有关错误的更多信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 命令字符串可以包括多个SQL命令（用分号分隔）。在一个PQexec调用中发送的多个查询是在一个事务里处理的，除非在查询字符串里有明确的BEGIN/COMMIT命令把整个字符串分隔成多个事务。请注意，返回的PGresult结构只描述字符串里执行的最后一条命令的结果，如果有一个命令失败，那么字符串处理的过程就会停止，并且返回的PGresult会描述错误条件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/foreign-data-wrapper/3-postgres_fdw.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/foreign-data-wrapper/3-postgres_fdw.md index 0283e578..6c55cfff 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/foreign-data-wrapper/3-postgres_fdw.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/foreign-data-wrapper/3-postgres_fdw.md @@ -11,7 +11,7 @@ postgres_fdw是一款开源插件，其代码随PostgreSQL源码一同发布。M postgres_fdw插件默认参与编译，使用安装包安装好MogDB后，可直接使用postgres_fdw，无须其他操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 ## 使用postgres_fdw diff --git a/product/zh/docs-mogdb/v2.0.0/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md b/product/zh/docs-mogdb/v2.0.0/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md index fc7fac0c..a8519147 100644 --- a/product/zh/docs-mogdb/v2.0.0/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md +++ b/product/zh/docs-mogdb/v2.0.0/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md @@ -13,7 +13,7 @@ MogDB可以通过调用SQL函数，进行创建、删除、推进逻辑复制槽 - 逻辑日志目前从主机节点中抽取，默认关闭SSL连接，如果进行逻辑复制，需要先上配置GUC参数ssl=on。 - > **说明：** 为避免安全风险，请保证启用SSL连接。 + > **说明**: 为避免安全风险，请保证启用SSL连接。 - 设置GUC参数wal_level=logical。 diff --git a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/1-installation-preparation.md b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/1-installation-preparation.md index 1e78c9ee..b1e44e2a 100644 --- a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/1-installation-preparation.md +++ b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/1-installation-preparation.md @@ -200,7 +200,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** *\$地区/\$时区*为需要设置时区的信息，例如：Asia/Shanghai。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: *\$地区/\$时区*为需要设置时区的信息，例如：Asia/Shanghai。 3. 使用**date -s**命令将各数据库节点的时间设置为统一时间，举例如下。 @@ -210,7 +210,7 @@ vim /etc/profile **(可选）关闭swap交换内存** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 diff --git a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md index a84fdc93..8d1ba735 100644 --- a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md @@ -37,7 +37,7 @@ date: 2021-06-11 sh install.sh -w xxxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。密码应包括大小写、字符、数字。 > - -p：指定的MogDB端口号, 如不指定，默认为5432。 diff --git a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md index 9b366a39..32793a61 100644 --- a/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md +++ b/product/zh/docs-mogdb/v2.0.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md @@ -37,7 +37,7 @@ date: 2021-06-11 sh install.sh -w xxxx --multinode ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。 密码应包括大小写、字符、数字。 > - -p：指定的MogDB主节点端口号, 默认5432。备节点端口号会使用主端口号+200，默认5632。 diff --git a/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/3-modifying-os-configuration.md b/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/3-modifying-os-configuration.md index d357a86b..659f6487 100644 --- a/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/3-modifying-os-configuration.md +++ b/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/3-modifying-os-configuration.md @@ -82,7 +82,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `\$地区/$时区`为需要设置时区的信息，例如：Asia_Shanghai。 使用date -s命令将各主机的时间设置为统一时间，举例如下。 @@ -91,11 +91,11 @@ cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime date -s "Sat Sep 27 16:00:07 CST 2020" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以通过date命令查询主机时区。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以通过date命令查询主机时区。 ### （可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 @@ -217,7 +217,7 @@ ifconfig 网卡编号 mtu 值 ssh xxx.xxx.xxx.xxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > xxx.xxx.xxx.xxx为安装MogDB环境的IP地址。 diff --git a/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/deployment-faqs.md b/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/deployment-faqs.md index 984468c3..85fda904 100644 --- a/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/deployment-faqs.md +++ b/product/zh/docs-mogdb/v2.0.0/installation-guide/standard-installation/deployment-faqs.md @@ -272,7 +272,7 @@ date: 2021-09-07 print(staticConfigPath_dn) ``` - > **说明：**需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 + > **说明**: 需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 2. 执行如下命令生成集群静态配置文件。 diff --git a/product/zh/docs-mogdb/v2.0.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md b/product/zh/docs-mogdb/v2.0.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md index 2f9e08bc..3d9278d5 100644 --- a/product/zh/docs-mogdb/v2.0.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md +++ b/product/zh/docs-mogdb/v2.0.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md @@ -64,7 +64,7 @@ Data Studio还提供SQL助手用于在SQL终端和PL/SQLViewer中执行各种查 Java 1.8.0_181或更高版本。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > * 请参阅[https://java.com/en/download/help/path.xml](https://java.com/en/download/help/path.xml)以设置Java Home路径。 > * 保证最佳体验的情况下，推荐的最小屏幕分辨率是1080 x 768。低于此分辨率，界面会异常。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md index 6b547bbe..ad78e07f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md @@ -57,7 +57,7 @@ date: 2021-06-07 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 - hll_hash_smallint(smallint, int32) @@ -480,7 +480,7 @@ HLL（HyperLogLog）主要存在三种模式Explicit，Sparse，Full。当数据 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 ## 功能函数 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md index 4de03389..dabcd944 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md @@ -355,7 +355,7 @@ date: 2021-04-20 返回值类型：Boolean - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见[表6](#cuowubiao)。 > - 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/25-statistics-information-functions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/25-statistics-information-functions.md index 792f4aef..3518d225 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/25-statistics-information-functions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/25-statistics-information-functions.md @@ -966,7 +966,7 @@ date: 2021-04-20 返回值类型：record - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 - DBE_PERF.get_global_session_time() diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/28-ai-feature-functions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/28-ai-feature-functions.md index d689cc76..fdd8a54c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/28-ai-feature-functions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/functions-and-operators/28-ai-feature-functions.md @@ -77,7 +77,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - encode_plan_node(optname text, orientation text, strategy text, options text, dop int8, quals text, projection text) @@ -87,7 +87,7 @@ date: 2021-04-20 返回值类型：text。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数为内部功能调用函数，不建议用户直接使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数为内部功能调用函数，不建议用户直接使用。 - model_train_opt(template text, model text) @@ -99,7 +99,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - track_model_train_opt(ip text, port text) @@ -111,7 +111,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - encode_feature_perf_hist(datname text) diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md index f80b8ad6..38fe73a1 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 有效值为stderr、csvlog、syslog。 @@ -27,7 +27,7 @@ date: 2021-04-20 local0.* /var/log/postgresql ``` -**默认值:**stderr +**默认值**: stderr ## logging_collector @@ -40,12 +40,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 将服务器日志发送到stderr时可以不使用logging_collector参数，此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难，只适用于较小的日志容量。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启日志收集功能。 - off表示关闭日志收集功能。 -**默认值:**on +**默认值**: on ## log_directory @@ -62,9 +62,9 @@ date: 2021-04-20 > 合法路径: 用户对此路径有读写权限 > 非法路径: 用户对此路径无读写权限 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**安装时指定。 +**默认值**: 安装时指定。 ## log_filename @@ -77,13 +77,13 @@ date: 2021-04-20 > - 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 > - 当log_destination设为csvlog时，系统会生成附加了时间戳的日志文件名，文件格式为csv格式，例如"server_log.1093827753.csv"。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgresql-%Y-%m-%d_%H%M%S.log +**默认值**: postgresql-%Y-%m-%d_%H%M%S.log ## log_file_mode -**参数说明:**[logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 +**参数说明:** [logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -92,14 +92,14 @@ date: 2021-04-20 > - 使用此选项前请设置log_directory，将日志存储到数据目录之外的地方。 > - 因日志文件可能含有敏感数据，故不能将其设为对外可读。 -**取值范围:**整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 +**取值范围**: 整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 0600表示只允许服务器管理员读写日志文件。 > - 0640表示允许管理员所在用户组成员只能读日志文件。 -**默认值:**0600 +**默认值**: 0600 ## log_truncate_on_rotation @@ -111,12 +111,12 @@ date: 2021-04-20 假设日志需要保留7天，每天生成一个日志文件，日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。设置方法: 将log_filename设置为server_log.%a ，log_truncate_on_rotation设置为on，log_rotation_age设置为1440，即日志有效时间为1天。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on表示MogDB以覆盖写入的方式写服务器日志消息。 - off表示MogDB将日志消息附加到同名的现有日志文件上。 -**默认值:**off +**默认值**: off ## log_rotation_age @@ -124,9 +124,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 +**取值范围**: 整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 -**默认值:**1440(min) +**默认值**: 1440(min) ## log_rotation_size @@ -134,13 +134,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX / 1024，单位为kB。 +**取值范围**: 整型，0 ~ INT_MAX / 1024，单位为kB。 0表示关闭基于容量的新日志文件的创建。 建议该值大小设置级别至少为MB级,利于日志文件的及时划分。 -**默认值:**20MB +**默认值**: 20MB ## syslog_facility @@ -148,19 +148,19 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 +**取值范围**: 枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 -**默认值:**local0 +**默认值**: local0 ## syslog_ident -**参数说明:**[log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 +**参数说明:** [log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## event_source @@ -168,6 +168,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PostgreSQL +**默认值**: PostgreSQL diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md index 22059d3d..8aec66b7 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md @@ -16,9 +16,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当client_min_messages和[log_min_messages](#log_min_messages)取相同值时，其值所代表的级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 -**默认值:**notice +**默认值**: notice ## log_min_messages @@ -29,9 +29,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当[client_min_messages](#client_min_messages)和log_min_messages取相同值log时所代表的消息级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**warning +**默认值**: warning ## log_min_error_statement @@ -39,14 +39,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为error ，表示导致错误、日志消息、致命错误、panic的语句都将被记录。 > - 设置为panic，表示关闭此特性。 -**默认值:**error +**默认值**: error ## log_min_duration_statement @@ -59,13 +59,13 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当此选项与log_statement同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用log_line_prefix记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。 -**取值范围:**整型，-1 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，-1 ~ INT_MAX，单位为毫秒。 - 设置为250，所有运行时间不短于250ms的SQL语句都会被记录。 - 设置为0，输出所有语句的持续时间。 - 设置为-1，关闭此功能。 -**默认值:**30min +**默认值**: 30min ## backtrace_min_messages @@ -76,11 +76,11 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**panic +**默认值**: panic [表1](#信息严重程度分类)解释MogDB中使用的消息安全级别。当日志输出到syslog或者eventlog(仅windows环境下, MogDB版本不涉及该参数)时，MogDB进行如表中的转换。 @@ -106,10 +106,10 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数以毫秒为单位的，建议在使用过程中设置值为1000的整数倍，即设置值以秒为最小单位。该参数所控制的性能日志文件以prf为扩展名，文件放置在$GAUSSLOG/gs_profile/ 目录下面，其中node_name是由postgres.conf文件中的pgxc_node_name的值，不建议外部使用该参数。 -**取值范围:**0~2147483647，单位为毫秒（ms）。 +**取值范围**: 0~2147483647，单位为毫秒（ms）。 当设置为0时，当前会话不再输出性能日志数据。当设置为非0时，当前会话按照指定的时间周期进行输出性能日志数据。 该参数设置得越小，输出的日志数据越多，对性能的负面影响越大。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md index de73e1e2..be2c1862 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_rewritten @@ -26,12 +26,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_plan @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示进行缩进。 - off表示不进行缩进。 -**默认值:**on +**默认值**: on ## log_checkpoints @@ -71,12 +71,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量。 - off表示关闭此参数时，服务器日志消息包含不涉及检查点和重启点的统计量。 -**默认值:**off +**默认值**: off ## log_connections @@ -87,12 +87,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 有些客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中重复的"connection receive"（收到连接请求）并不意味着一定是问题。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_disconnections @@ -100,12 +100,12 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_duration @@ -113,12 +113,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - 设置为off ，该选项与log_min_duration_statement的不同之处在于log_min_duration_statement强制记录查询文本。 - 设置为on并且log_min_duration_statement大于零，记录所有持续时间，但是仅记录超过阈值的语句。这可用于在高负载情况下搜集统计信息。 -**默认值:**on +**默认值**: on ## log_error_verbosity @@ -126,13 +126,13 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - terse输出不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose输出包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 - default输出包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录，不包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 -**默认值:**default +**默认值**: default ## log_hostname @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以同时记录主机名。 - off表示不可以同时记录主机名。 -**默认值:**on +**默认值**: on ## log_line_prefix @@ -188,9 +188,9 @@ FROM pg_stat_activity; - 当log_line_prefix设置为非空值时，请将其最后一个字符作为一个独立的段，以此来直观地与后续的日志进行区分，也可以使用一个标点符号。 - Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**%m %c %d %p %a %x %n %e +**默认值**: %m %c %d %p %a %x %n %e ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -202,12 +202,12 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录此信息。 - off表示不记录此信息。 -**默认值:**off +**默认值**: off ## log_statement @@ -219,14 +219,14 @@ FROM pg_stat_activity; 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，在执行阶段之前（语法分析或规划阶段）同样不会记录。将log_min_error_statement设为ERROR或更低才能记录这些语句。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - none表示不记录语句。 - ddl表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 - mod表示记录所有DDL语句，还包括数据修改语句INSERT、UPDATE、DELETE、TRUNCATE和COPY FROM 。 - all表示记录所有语句，PREPARE、EXECUTE和EXPLAIN ANALYZE语句也同样被记录。 -**默认值:**none +**默认值**: none ## log_temp_files @@ -234,13 +234,13 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为-1，最大值2147483647，单位KB。 +**取值范围**: 整型，最小值为-1，最大值2147483647，单位KB。 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 值0 表示记录所有的临时文件的删除信息。 - 值-1 表示不记录任何临时文件的删除信息。 -**默认值:**-1 +**默认值**: -1 ## log_timezone @@ -248,9 +248,9 @@ FROM pg_stat_activity; 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PRC +**默认值**: PRC ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -262,9 +262,9 @@ gs_initdb进行相应系统环境设置时会对默认值进行修改。 该参数属于USERSET类型参数，设置请参考表[GUC参数分类](30-appendix)中对应设置的方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 +**默认值**: 所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 **设置方法**: 首先，可以通过SHOW logging_module来查看哪些模块是支持可控制的。例如，查询输出结果为: @@ -312,7 +312,7 @@ mogdb=# show logging_module; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - off表示不打开该功能。 - log表示打开该功能，可以在数据库节点的执行计划中看到没有查询优化的具体原因。 @@ -321,7 +321,7 @@ mogdb=# show logging_module; 提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，log_min_messages设置成debug4级别，logging_module设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。 -**默认值:**off +**默认值**: off ## enable_debug_vacuum diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/11-alarm-detection.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/11-alarm-detection.md index 1ec65098..a19abebb 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/11-alarm-detection.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/11-alarm-detection.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许打开告警检测线程。 - off表示不允许打开告警检测线程。 -**默认值:**on +**默认值**: on ## connection_alarm_rate @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0~1.0 +**取值范围**: 浮点型，0.0~1.0 -**默认值:**0.9 +**默认值**: 0.9 ## alarm_report_interval @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为秒。 +**取值范围**: 整型，单位为秒。 -**默认值:**10 +**默认值**: 10 ## alarm_component @@ -48,26 +48,26 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**/opt/huawei/snas/bin/snas_cm_cmd +**默认值**: /opt/huawei/snas/bin/snas_cm_cmd ## table_skewness_warning_threshold -**参数说明**：设置用于表倾斜告警的阈值。 +**参数说明**: 设置用于表倾斜告警的阈值。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～1 +**取值范围**: 浮点型，0～1 -**默认值**：1 +**默认值**: 1 ## table_skewness_warning_rows -**参数说明**：设置用于表倾斜告警的行数。 +**参数说明**: 设置用于表倾斜告警的行数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：100000 +**默认值**: 100000 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md index f536426c..4481362a 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 -**默认值:**on +**默认值**: on ## track_counts @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 在AutoVacuum自动清理进程中选择清理的数据库时，需要数据库的统计数据，故默认值设为on。 -**默认值:**on +**默认值**: on ## track_io_timing @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 - off表示关闭收集功能。 -**默认值:**off +**默认值**: off ## track_functions @@ -62,13 +62,13 @@ date: 2021-04-20 > > 当SQL语言函数设置为调用查询的"内联"函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - pl表示只追踪过程语言函数。 - all表示追踪SQL语言函数。 - none表示关闭函数追踪功能。 -**默认值:**none +**默认值**: none ## track_activity_query_size @@ -76,9 +76,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～102400 +**取值范围**: 整型，100～102400 -**默认值:**1024 +**默认值**: 1024 ## stats_temp_directory @@ -90,9 +90,9 @@ date: 2021-04-20 > > 将其设置为一个基于RAM的文件系统目录会减少实际的I/O开销并可以提升其性能。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_stat_tmp +**默认值**: pg_stat_tmp ## track_thread_wait_status_interval @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0～1天，单位为min。 +**取值范围**: 0～1天，单位为min。 -**默认值:**30min +**默认值**: 30min ## enable_save_datachanged_timestamp @@ -110,12 +110,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许收集相关操作对表数据改动的时间。 - off表示禁止收集相关操作对表数据改动的时间。 -**默认值:**on +**默认值**: on ## track_sql_count @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启计数功能。 - off表示关闭计数功能。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md index 9952a976..023ffa7e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md @@ -27,7 +27,7 @@ date: 2021-04-20 > - log_statement_stats记录总的语句统计数据，而其他的只记录针对每个模块的统计数据。 > - log_statement_stats不能和其他任何针对每个模块统计的选项一起打开。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启记录性能统计数据的功能。 - off表示关闭记录性能统计数据的功能。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/13-load-management.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/13-load-management.md index a681044e..a0fec023 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/13-load-management.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/13-load-management.md @@ -30,7 +30,7 @@ date: 2021-04-20 > select gs_wlm_readjust_user_space(0); > ``` -**默认值:**off +**默认值**: off ## cgroup_name @@ -46,7 +46,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**InvalidGroup +**默认值**: InvalidGroup ## cpu_collect_timer @@ -58,7 +58,7 @@ date: 2021-04-20 **取值范围**: 整型，1 ～ INT_MAX， 单位为秒。 -**默认值:**30 +**默认值**: 30 ## memory_tracking_mode @@ -73,7 +73,7 @@ date: 2021-04-20 - executor，生成统计文件，包含执行层使用过的所有已分配内存的上下文信息。 - fullexec，生成文件包含执行层申请过的所有内存上下文信息。 -**默认值:**none +**默认值**: none ## memory_detail_tracking @@ -83,7 +83,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -100,7 +100,7 @@ date: 2021-04-20 - on表示打开资源监控。 - off表示关闭资源监控。 -**默认值:**on +**默认值**: on ## enable_resource_record @@ -113,7 +113,7 @@ date: 2021-04-20 - on表示开启资源监控记录归档功能。 - off表示关闭资源监控记录归档功能。 -**默认值:**off +**默认值**: off ## enable_logical_io_statistics @@ -126,7 +126,7 @@ date: 2021-04-20 - on表示开启资源监控逻辑IO统计功能。 - off表示关闭资源监控逻辑IO统计功能。 -**默认值:**on +**默认值**: on ## enable_user_metric_persistent @@ -167,7 +167,7 @@ date: 2021-04-20 - on表示开启实例资源监控转存功能。 - off表示关闭实例资源监控转存功能。 -**默认值:**on +**默认值**: on ## instance_metric_retention_time @@ -180,7 +180,7 @@ date: 2021-04-20 - 值等于0时，实例历史资源监控数据将永久保存。 - 值大于0时，实例历史资源监控数据将保存对应设置天数。 -**默认值:**7 +**默认值**: 7 ## resource_track_level @@ -194,7 +194,7 @@ date: 2021-04-20 - query，开启query级别资源监控功能。 - operator，开启query级别和算子级别资源监控功能。 -**默认值:**query +**默认值**: query ## resource_track_cost @@ -208,7 +208,7 @@ date: 2021-04-20 - 值大于或等于0时，值大于或等于0且小于等于9时，对执行代价大于等于10的语句进行资源监控。 - 值大于或等于10时，对执行代价超过该参数值的语句进行资源监控。 -**默认值:**100000 +**默认值**: 100000 ## resource_track_duration @@ -221,7 +221,7 @@ date: 2021-04-20 - 值为0时，资源监控实时视图中记录的所有语句都进行历史信息归档。 - 值大于0时，资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。 -**默认值:**1min +**默认值**: 1min ## disable_memory_protect @@ -234,7 +234,7 @@ date: 2021-04-20 - on表示禁止内存保护功能。 - off表示启动内存保护功能。 -**默认值:**off +**默认值**: off ## query_band @@ -244,7 +244,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 ## enable_bbox_dump @@ -257,7 +257,7 @@ date: 2021-04-20 - on表示打开黑匣子功能。 - off表示关闭黑匣子功能。 -**默认值:**off +**默认值**: off ## bbox_dump_count @@ -267,7 +267,7 @@ date: 2021-04-20 **取值范围**: 整型，1～20 -**默认值:**8 +**默认值**: 8 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -281,7 +281,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 +**默认值**: 空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 ## enable_ffic_log @@ -294,7 +294,7 @@ date: 2021-04-20 - on表示打开FFIC功能。 - off表示关闭FFIC功能。 -**默认值:**on +**默认值**: on ## io_limits @@ -304,7 +304,7 @@ date: 2021-04-20 **取值范围**: 整型，0～1073741823 -**默认值:**0 +**默认值**: 0 ## io_priority @@ -319,7 +319,7 @@ date: 2021-04-20 - Medium: 表示限制iops为该作业原始触发数值的20%。 - High: 表示限制iops为该作业原始触发数值的50%。 -**默认值:**None +**默认值**: None ## io_control_unit @@ -331,7 +331,7 @@ date: 2021-04-20 **取值范围**: 整型，1000~1000000 -**默认值:**6000 +**默认值**: 6000 ## session_respool @@ -347,7 +347,7 @@ date: 2021-04-20 **取值范围**: string类型，通过create resource pool所设置的资源池。 -**默认值:**invalid_pool +**默认值**: invalid_pool ## session_statistics_memory @@ -357,7 +357,7 @@ date: 2021-04-20 **取值范围**: 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**5MB +**默认值**: 5MB ## topsql_retention_time @@ -380,7 +380,7 @@ date: 2021-04-20 **取值范围**: 整型，10 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**10MB +**默认值**: 10MB ## transaction_pending_time @@ -393,4 +393,4 @@ date: 2021-04-20 - 值为-1或0: 事务块语句和存储过程语句无超时判断，排队至资源满足可执行条件。 - 值大于0: 事务块语句和存储过程语句排队超过所设数值的时间后，无视当前资源情况强制执行。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/14-automatic-vacuuming.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/14-automatic-vacuuming.md index 87905df1..1f0ad172 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/14-automatic-vacuuming.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/14-automatic-vacuuming.md @@ -24,12 +24,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理进程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启数据库自动清理进程。 - off表示关闭数据库自动清理进程。 -**默认值:**on +**默认值**: on ## autovacuum_mode @@ -37,14 +37,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - analyze表示只做autoanalyze。 - vacuum表示只做autovacuum。 - mix表示autoanalyze和autovacuum都做。 - none表示二者都不做。 -**默认值:**mix +**默认值**: mix ## autoanalyze_timeout @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**int类型，单位是s，0~2147483。 +**取值范围**: int类型，单位是s，0~2147483。 -**默认值:**5min（即300s） +**默认值**: 5min（即300s） ## autovacuum_io_limits @@ -62,9 +62,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 +**取值范围**: 整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 -**默认值:**-1 +**默认值**: -1 ## log_autovacuum_min_duration @@ -76,13 +76,13 @@ date: 2021-04-20 将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。 -**取值范围:**整型，最小值为-1，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为-1，最大值为2147483647，单位为毫秒。 - 当参数设置为0时，表示所有的自动清理操作都记录到日志中。 - 当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。 - 当参数设置为非-1时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。 -**默认值:**-1 +**默认值**: -1 ## autovacuum_max_workers @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 +**取值范围**: 整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 -**默认值:**3 +**默认值**: 3 ## autovacuum_naptime @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为s，最小值为1，最大值为2147483。 +**取值范围**: 整型，单位为s，最小值为1，最大值为2147483。 -**默认值:**10min（即600s） +**默认值**: 10min（即600s） ## autovacuum_vacuum_threshold @@ -110,9 +110,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_analyze_threshold @@ -120,9 +120,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_vacuum_scale_factor @@ -130,9 +130,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.2 +**默认值**: 0.2 ## autovacuum_analyze_scale_factor @@ -140,9 +140,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.1 +**默认值**: 0.1 ## autovacuum_freeze_max_age @@ -155,7 +155,7 @@ date: 2021-04-20 **取值范围: 长**整型，100 000～576 460 752 303 423 487 -**默认值:**20000000000 +**默认值**: 20000000000 ## autovacuum_vacuum_cost_delay @@ -163,9 +163,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 +**取值范围**: 整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 -**默认值:**20ms +**默认值**: 20ms ## autovacuum_vacuum_cost_limit @@ -173,14 +173,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 +**取值范围**: 整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 -**默认值:**-1 +**默认值**: -1 ## defer_csn_cleanup_time **参数说明:**用来指定本地回收时间间隔，单位为毫秒（ms）。 -**取值范围:**整型，0~INT_MAX。 +**取值范围**: 整型，0~INT_MAX。 **默认值**: 5s（即5000ms） diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md index 6670e91c..fef11502 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md @@ -20,7 +20,7 @@ date: 2021-04-20 - 当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。 - 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -28,7 +28,7 @@ date: 2021-04-20 > - 设置为空串（"）的时候，系统会自动转换成一对双引号。 > - 设置的内容中包含双引号，系统会认为是不安全字符，会将每个双引号转换成一对双引号。 -**默认值:**\"$user",public +**默认值**: \"$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -39,9 +39,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**"\$user",public +**默认值**: "\$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -58,9 +58,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空表示使用默认表空间。 +**取值范围**: 字符串，其中空表示使用默认表空间。 -**默认值:**空 +**默认值**: 空 ## default_storage_nodegroup @@ -71,9 +71,9 @@ date: 2021-04-20 - 值为"installation"表示建表会默认建在安装的Node Group上。 - 值为其他字符串表示建表会默认建在设置的Node Group上。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**installation +**默认值**: installation ## temp_tablespaces @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 +**取值范围**: 字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 -**默认值:**空 +**默认值**: 空 ## check_function_bodies @@ -93,12 +93,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 - off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 -**默认值:**on +**默认值**: on ## default_transaction_isolation @@ -106,13 +106,13 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - read committed表示事务读已提交。 - repeatable read表示事务可重复读。 - serializable，MogDB目前功能上不支持此隔离级别，等价于repeatable read。 -**默认值:**read committed +**默认值**: read committed ## default_transaction_read_only @@ -120,12 +120,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示只读状态。 - off表示非只读状态。 -**默认值:**off +**默认值**: off ## default_transaction_deferrable @@ -135,12 +135,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示默认延迟。 - off表示默认不延迟。 -**默认值:**off +**默认值**: off ## session_replication_role @@ -151,13 +151,13 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 设置此参数会丢弃之前任何缓存的执行计划。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - origin表示从当前会话中复制插入、删除、更新等操作。 - replica表示从其他地方复制插入、删除、更新等操作到当前会话。 - local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。 -**默认值:**origin +**默认值**: origin ## statement_timeout @@ -165,9 +165,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为0，最大值为2147483647，单位为毫秒。 -**默认值:**0 +**默认值**: 0 ## vacuum_freeze_min_age @@ -175,12 +175,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为0到10亿之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 -**默认值:**5000000000 +**默认值**: 5000000000 ## vacuum_freeze_table_age @@ -188,12 +188,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为零到20亿之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。 -**默认值:**15000000000 +**默认值**: 15000000000 ## bytea_output @@ -201,12 +201,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - hex: 将二进制数据编码为每字节2位十六进制数字。 - escape: 传统化的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法，同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 -**默认值:**hex +**默认值**: hex ## xmlbinary @@ -214,12 +214,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - base64 - hex -**默认值:**base64 +**默认值**: base64 ## xmloption @@ -227,12 +227,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - document: 表示HTML格式的文档。 - content: 普通的字符串。 -**默认值:**content +**默认值**: content ## max_compile_functions @@ -240,9 +240,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，取值必须大于等于1。 +**取值范围**: 整型，取值必须大于等于1。 -**默认值:**1000 +**默认值**: 1000 ## gin_pending_list_limit @@ -250,6 +250,6 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为64，最大值为INT_MAX，单位为KB。 +**取值范围**: 整型，最小值为64，最大值为INT_MAX，单位为KB。 -**默认值:**4MB +**默认值**: 4MB diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md index 5e5009cd..59b85cb1 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请**参考表GUC参数设置方式**中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**ISO, MDY +**默认值**: ISO, MDY > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb会将这个参数初始化成与[lc_time](#lc_time)一致的值。 @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - sql_standard表示产生与SQL标准规定匹配的输出。 - postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当[DateStyle](#DateStyle)参数被设为ISO时。 @@ -43,7 +43,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > IntervalStyle参数也会影响不明确的间隔输入的说明。 -**默认值:**postgres +**默认值**: postgres ## TimeZone @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 -**默认值:**PRC +**默认值**: PRC > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb将设置一个与其系统环境一致的时区值。 @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图pg_timezone_names获得。 +**取值范围**: 字符串，可查询视图pg_timezone_names获得。 -**默认值:**Default +**默认值**: Default > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。 @@ -77,14 +77,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-15～3 +**取值范围**: 整型，-15～3 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。 > - 设置为负数，表示消除不需要的数据位。 -**默认值:**0 +**默认值**: 0 ## client_encoding @@ -94,7 +94,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 +**取值范围**: 兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -102,7 +102,7 @@ date: 2021-04-20 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 > - 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证MogDB内部通信编码格式一致。 -**默认值:**UTF8 +**默认值**: UTF8 **推荐值:**SQL_ASCII/UTF8 @@ -116,14 +116,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_monetary @@ -131,14 +131,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_numeric @@ -146,14 +146,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_time @@ -161,14 +161,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## default_text_search_config @@ -182,9 +182,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > MogDB支持pg_catalog.english，pg_catalog.simple两种配置。 -**默认值:**pg_catalog.english +**默认值**: pg_catalog.english diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md index 86e28546..4dab1265 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md @@ -26,7 +26,7 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 设置为空字符串，表示关闭自动路径搜索。 -**默认值:** \$libdir +**默认值**: \$libdir ## gin_fuzzy_search_limit @@ -34,9 +34,9 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值:**0 +**默认值**: 0 ## local_preload_libraries @@ -49,6 +49,6 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于BACKEND类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/16-lock-management.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/16-lock-management.md index 68622a4c..c580221b 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/16-lock-management.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/16-lock-management.md @@ -18,9 +18,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~2147483647，单位为毫秒（ms）。 +**取值范围**: 整型，1~2147483647，单位为毫秒（ms）。 -**默认值:**1s +**默认值**: 1s ## lockwait_timeout @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**20min +**默认值**: 20min ## update_lockwait_timeout @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**2min +**默认值**: 2min ## max_locks_per_transaction @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**256 +**默认值**: 256 ## max_pred_locks_per_transaction @@ -65,9 +65,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**64 +**默认值**: 64 ## partition_lock_upgrade_timeout @@ -83,17 +83,17 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值-1，最大值3000，单位为秒（s）。 +**取值范围**: 整型，最小值-1，最大值3000，单位为秒（s）。 -**默认值:**1800 +**默认值**: 1800 ## fault_mon_timeout **参数说明:**轻量级死锁检测周期。该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值0，最大值1440，单位为分钟（min） +**取值范围**: 整型，最小值0，最大值1440，单位为分钟（min） -**默认值:**5min +**默认值**: 5min ## enable_online_ddl_waitlock @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启。 - off表示关闭。 -**默认值:**off +**默认值**: off ## xloginsert_locks diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md index 8efb7b8d..b3a1826c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md @@ -15,12 +15,12 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许向数组中输入空元素。 - off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。 -**默认值:**on +**默认值**: on ## backslash_quote @@ -31,13 +31,13 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'…'）。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - on表示一直允许使用\'表示。 - off表示拒绝使用\'表示。 - safe_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\\的ASCII值时允许。 -**默认值:**safe_encoding +**默认值**: safe_encoding ## escape_string_warning @@ -48,9 +48,9 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## lo_compat_privileges @@ -58,11 +58,11 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。 -**默认值:**off +**默认值**: off ## quote_all_identifiers @@ -70,12 +70,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开强制引用。 - off表示关闭强制引用。 -**默认值:**off +**默认值**: off ## sql_inheritance @@ -83,12 +83,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以访问子表。 - off表示不访问子表。 -**默认值:**on +**默认值**: on ## standard_conforming_strings @@ -99,12 +99,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**on +**默认值**: on ## synchronize_seqscans @@ -112,12 +112,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示扫描可能从表的中间开始，然后选择"环绕"方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 - off表示确保顺序扫描是从表头开始的。 -**默认值:**on +**默认值**: on ## enable_beta_features @@ -125,9 +125,9 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 - off表示禁止使用这些特性。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md index 7c5c2f68..a23ef72a 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## convert_string_to_digit -**参数说明**：设置隐式转换优先级，是否优先将字符串转为数字。 +**参数说明**: 设置隐式转换优先级，是否优先将字符串转为数字。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -20,29 +20,29 @@ date: 2021-04-20 - on表示优先将字符串转为数字。 - off表示不优先将字符串转为数字。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎调操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎调操作。 ## nls_timestamp_format -**参数说明**：设置时间戳默认格式。 +**参数说明**: 设置时间戳默认格式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：DD-Mon-YYYY HH:MI:SS.FF AM +**默认值**: DD-Mon-YYYY HH:MI:SS.FF AM ## max_function_args -**参数说明**：函数参数最大个数。 +**参数说明**: 函数参数最大个数。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型 +**取值范围**: 整型 -**默认值**：666 +**默认值**: 666 ## transform_null_equals @@ -60,7 +60,7 @@ date: 2021-04-20 **默认值：**off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 ## support_extended_features @@ -88,7 +88,7 @@ date: 2021-04-20 **默认值：**A -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 该参数只能在执行**CREATE DATABASE**命令创建数据库的时候设置。 > - 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。 @@ -103,7 +103,7 @@ date: 2021-04-20 **默认值：**空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前只支持[表1](#jianrongxing)。 > - 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set behavior_compat_options='end_month_calculate,display_leading_zero'; @@ -128,7 +128,7 @@ date: 2021-04-20 **参数说明：**控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/18-fault-tolerance.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/18-fault-tolerance.md index 8db1bb57..a1178345 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/18-fault-tolerance.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/18-fault-tolerance.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示ERROR级别报错会升级为PANIC报错。 - off表示不会对ERROR级别报错进行升级。 -**默认值:**off +**默认值**: off ## restart_after_crash @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示能够最大限度地提高数据库的可用性。 @@ -36,7 +36,7 @@ date: 2021-04-20 - off表示能够使得管理工具在后端进程崩溃时获取控制权并采取适当的措施进行处理。 -**默认值:**on +**默认值**: on ## omit_encoding_error @@ -44,12 +44,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 - off表示有转换错误的字符不能被转换，打印错误信息到终端。 -**默认值:**off +**默认值**: off ## max_query_retry_times @@ -57,9 +57,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~20。 +**取值范围**: 整型，0~20。 -**默认值:**0 +**默认值**: 0 ## cn_send_buffer_size @@ -67,9 +67,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~128， 单位为KB。 +**取值范围**: 整型，8~128， 单位为KB。 -**默认值:**8KB +**默认值**: 8KB ## max_cn_temp_file_size @@ -77,9 +77,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~10485760， 单位为KB。 +**取值范围**: 整型，0~10485760， 单位为KB。 -**默认值:**5GB +**默认值**: 5GB ## retry_ecode_list @@ -87,9 +87,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 +**默认值**: YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 ## data_sync_retry @@ -97,23 +97,23 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 - off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 -**默认值:**off +**默认值**: off ## remote_read_mode -**参数说明**：远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 +**参数说明**: 远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - off表示关闭远程读功能。 - non_authentication表示开启远程读功能，但不进行证书认证。 - authentication表示开启远程读功能，但要进行证书认证。 -**默认值**：authentication +**默认值**: authentication diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/19-connection-pool-parameters.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/19-connection-pool-parameters.md index 239290f1..9ca00093 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/19-connection-pool-parameters.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/19-connection-pool-parameters.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为INT_MAX，最小单位为秒。 +**取值范围**: 整型，最小值为0，最大值为INT_MAX，最小单位为秒。 -**默认值:**10min +**默认值**: 10min ## minimum_pool_size @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为65535 +**取值范围**: 整型，最小值为1，最大值为65535 -**默认值:**50 +**默认值**: 50 ## cache_connection @@ -35,9 +35,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示回收连接池的连接。 - off表示不回收连接池的连接。 -**默认值:**on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/2-file-location.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/2-file-location.md index 18da5061..0cd7836e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/2-file-location.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/2-file-location.md @@ -21,9 +21,9 @@ date: 2021-04-20 - 在安装MogDB时指定。 - 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**安装时指定，如果在安装时不指定，则默认不初始化数据库。 +**默认值**: 安装时指定，如果在安装时不指定，则默认不初始化数据库。 ## config_file @@ -31,9 +31,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置，不支持使用表[GUC参数设置方式](30-appendix)中的方式四进行修改。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**postgresql.conf(实际安装可能带有绝对目录) +**默认值**: postgresql.conf(实际安装可能带有绝对目录) ## hba_file @@ -41,9 +41,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_hba.conf(实际安装可能带有绝对目录) +**默认值**: pg_hba.conf(实际安装可能带有绝对目录) ## ident_file @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_ident.conf(实际安装可能带有绝对目录) +**默认值**: pg_ident.conf(实际安装可能带有绝对目录) ## external_pid_file @@ -64,6 +64,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 这个参数只能在数据库服务重新启动后生效。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/20-MogDB-transaction.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/20-MogDB-transaction.md index b1e9820d..dbcbe4ff 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/20-MogDB-transaction.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/20-MogDB-transaction.md @@ -15,14 +15,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，只识别以下字符串，大小写空格敏感: +**取值范围**: 字符串，只识别以下字符串，大小写空格敏感: - serializable: MogDB中等价于REPEATABLE READ。 - read committed: 只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 - repeatable read: 仅能读取事务开始之前提交的数据，不能读取未提交的数据以及在事务执行期间由其它并发事务提交的修改。 - default: 设置为default_transaction_isolation所设隔离级别。 -**默认值:**read committed +**默认值**: read committed ## transaction_read_only @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示设置当前事务为只读事务。 - off表示该事务可以是非只读事务。 -**默认值:**off +**默认值**: off ## xc_maintenance_mode @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，仅支持表[GUC参数分类](30-appendix)中的方式三进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -54,7 +54,7 @@ date: 2021-04-20 > > 谨慎打开这个开关，避免引起MogDB数据不一致。 -**默认值:**off +**默认值**: off ## allow_concurrent_tuple_update @@ -62,12 +62,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 -**默认值:**on +**默认值**: on ## transaction_deferrable @@ -75,12 +75,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许执行。 - off表示不允许执行。 -**默认值:**off +**默认值**: off ## enforce_two_phase_commit @@ -88,12 +88,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示强制使用两阶段提交。 - off表示不强制使用两阶段提交。 -**默认值:**on +**默认值**: on ## enable_show_any_tuples @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示表中元组的所有版本都会可见。 - off/false表示表中元组的所有版本都不可见。 -**默认值:**off +**默认值**: off ## replication_type @@ -116,13 +116,13 @@ date: 2021-04-20 该参数用户不能自己去设置参数值。 -**取值范围:**0~2 +**取值范围**: 0~2 - 2 表示单主机模式，此模式无法扩展备机。 - 1 表示使用一主多备模式，全场景覆盖，推荐使用。 - 0 表示主备从模式，目前此模式暂不支持。 -**默认值:**1 +**默认值**: 1 ## pgxc_node_name diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/21-developer-options.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/21-developer-options.md index 2d607db5..671e6481 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/21-developer-options.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/21-developer-options.md @@ -15,12 +15,12 @@ date: 2021-04-20 不建议修改该参数默认值，如果设置为on，可能导致系统表损坏，甚至数据库无法启动。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许修改系统表的结构。 - off表示不允许修改系统表的结构。 -**默认值:**off +**默认值**: off ## debug_assertions @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开断言检查。 - off表示不打开断言检查。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 当启用断言选项编译MogDB时，debug_assertions缺省值为on 。 -**默认值:**off +**默认值**: off ## ignore_checksum_failure @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略数据校验错误。 - off表示数据校验错误正常报错。 -**默认值:**off +**默认值**: off ## ignore_system_indexes @@ -62,12 +62,12 @@ date: 2021-04-20 > > 这个参数在从系统索引被破坏的表中恢复数据的时候非常有用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略系统索引。 - off表示不忽略系统索引。 -**默认值:**off +**默认值**: off ## post_auth_delay @@ -75,9 +75,9 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147，单位为秒。 +**取值范围**: 整型，最小值为0，最大值为2147，单位为秒。 -**默认值:**0 +**默认值**: 0 ## pre_auth_delay @@ -85,9 +85,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0～60，单位为秒。 +**取值范围**: 整型，最小值为0～60，单位为秒。 -**默认值:**0 +**默认值**: 0 ## trace_notify @@ -95,12 +95,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开输出功能。 - off表示关闭输出功能。 -**默认值:**off +**默认值**: off ## trace_recovery_messages @@ -108,9 +108,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 +**取值范围**: 枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 -**默认值:**log +**默认值**: log > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -123,12 +123,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**off +**默认值**: off ## zero_damaged_pages @@ -136,11 +136,11 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 -**默认值:**off +**默认值**: off ## remotetype @@ -168,12 +168,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启Numeric优化。 - off/false表示关闭Numeric优化。 -**默认值:**on +**默认值**: on ## enable_compress_spill @@ -181,12 +181,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启下盘优化。 - off/false表示关闭下盘优化。 -**默认值:**on +**默认值**: on ## resource_track_log @@ -194,14 +194,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 - summary: 显示简略的诊断信息。 - detail: 显示详细的诊断信息。 目前这两个参数值只在显示多列统计信息未收集的告警的情况下有差别，summary不显示未收集多列统计信息的告警，detail会显示这类告警。 -**默认值:**summary +**默认值**: summary ## show_acce_estimate_detail diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md index 9effc9ff..5a410a50 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启动审计功能。 - off表示关闭审计功能。 -**默认值:**on +**默认值**: on ## audit_directory @@ -26,9 +26,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 +**默认值**: pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 ## audit_data_format @@ -36,9 +36,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**binary +**默认值**: binary ## audit_rotation_interval @@ -72,12 +72,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示采用空间优先策略，最多存储[audit_space_limit](#audit_space_limit)大小的日志。 - off表示采用时间优先策略，最少存储[audit_file_remain_time](#audit_file_remain_time)长度时间的日志。 -**默认值:**on +**默认值**: on ## audit_file_remain_time @@ -95,9 +95,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024KB~1024GB，单位为KB。 +**取值范围**: 整型，1024KB~1024GB，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## audit_file_remain_threshold @@ -105,9 +105,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~1048576 +**取值范围**: 整型，1~1048576 -**默认值:**1048576 +**默认值**: 1048576 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 请尽量保证此参数为1048576，并不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md index 71096b2e..73f0fbaf 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~7。 +**取值范围**: 整型，0~7。 - 0表示关闭用户登录、注销审计功能。 - 1表示只审计用户登录成功。 @@ -24,7 +24,7 @@ date: 2021-04-20 - 6表示只审计用户注销和登录失败。 - 7表示审计用户登录成功、失败和注销。 -**默认值:**7 +**默认值**: 7 ## audit_database_process @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭MogDB启动、停止、恢复和切换审计功能。 - 1表示开启MogDB启动、停止、恢复和切换审计功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_locked @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户锁定和解锁审计功能。 - 1表示开启审计用户锁定和解锁功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_violation @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户越权操作审计功能。 - 1表示开启用户越权操作审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_grant_revoke @@ -71,9 +71,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计用户权限授予和回收功能。 - 1表示开启审计用户权限授予和回收功能。 -**默认值:**1 +**默认值**: 1 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md index 538d46f5..71e694c5 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～524287 +**取值范围**: 整型，0～524287 - 0代表关闭MogDB数据库对象的CREATE、DROP、ALTER操作审计功能。 - 非0代表只审计MogDB的某类或者某些数据库对象的CREATE、DROP、ALTER操作。 @@ -22,7 +22,7 @@ date: 2021-04-20 该参数的值由19个二进制位的组合求出，这19个二进制位分别代表MogDB的19类数据库对象。如果对应的二进制位取值为0，表示不审计对应的数据库对象的CREATE、DROP、ALTER操作；取值为1，表示审计对应的数据库对象的CREATE、DROP、ALTER操作。这19个二进制位代表的具体审计内容请参见[表1](#audit_system_object)。 -**默认值:**12295 +**默认值**: 12295 **表 1** audit_system_object取值含义说明 @@ -56,12 +56,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭具体表的DML操作（SELECT除外）审计功能。 - 1表示开启具体表的DML操作（SELECT除外）审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_dml_state_select @@ -69,12 +69,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SELECT操作审计功能。 - 1表示开启SELECT审计操作功能。 -**默认值:**0 +**默认值**: 0 ## audit_function_exec @@ -82,12 +82,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭过程或函数执行的审计功能。 - 1表示开启过程或函数执行的审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_copy_exec @@ -95,12 +95,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭COPY审计功能。 - 1表示开启COPY审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_set_parameter @@ -108,12 +108,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SET审计功能。 - 1表示开启SET审计功能。 -**默认值:**1 +**默认值**: 1 ## enableSeparationOfDuty @@ -121,12 +121,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启三权分立。 - off表示不开启三权分立。 -**默认值:**off +**默认值**: off ## enable_nonsysadmin_execute_direct @@ -134,12 +134,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许任意用户执行EXECUTE DIRECT ON语句。 - off表示只允许系统管理员执行EXECUTE DIRECT ON语句。 -**默认值:**off +**默认值**: off ## enable_copy_server_files @@ -147,12 +147,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启copy服务端文件的权限。 - off表示不开启copy服务端文件的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** copy from/to file要求具有系统管理员权限的用户或初始用户才能使用，但是，在三权分立开启的状态下，系统管理员与初始用户的权限不同，可以通过使用enable_copy_server_file控制系统管理员的copy权限，当前默认不允许系统管理员权限用户进行对文件的copy操作，此参数打开后系统管理员方可执行该类型操作。 @@ -162,12 +162,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启系统管理员用户创建和删除DIRECTORY的权限。 - off表示不开启系统管理员用户创建和删除DIRECTORY的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/23-upgrade-parameters.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/23-upgrade-parameters.md index 2a9adf13..40a5632e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/23-upgrade-parameters.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/23-upgrade-parameters.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在升级过程中。 - off表示不在升级过程中。 -**默认值:**off +**默认值**: off ## inplace_upgrade_next_system_object_oids @@ -26,15 +26,15 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## upgrade_mode **参数说明**: 标示升级模式。该参数不建议用户自己修改。 -**取值范围:**整数，0~INT_MAX +**取值范围**: 整数，0~INT_MAX - 0表示不在升级过程中。 - 1表示在就地升级过程中。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md index 5a0e956e..1909fd76 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md @@ -13,9 +13,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**9.2.4 +**默认值**: 9.2.4 ## server_version_num @@ -23,9 +23,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整数 +**取值范围**: 整数 -**默认值:**90204 +**默认值**: 90204 ## block_size @@ -33,9 +33,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**8192 +**取值范围**: 8192 -**默认值:**8192 +**默认值**: 8192 ## segment_size @@ -45,7 +45,7 @@ date: 2021-04-20 **单位**: 8KB -**默认值:**131072, 即1GB +**默认值**: 131072, 即1GB ## max_index_keys @@ -53,7 +53,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**32 +**默认值**: 32 ## integer_datetimes @@ -61,12 +61,12 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示支持。 - off表示不支持。 -**默认值:**on +**默认值**: on ## lc_collate @@ -74,7 +74,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## lc_ctype @@ -82,7 +82,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## max_identifier_length @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整型 +**取值范围**: 整型 -**默认值:**63 +**默认值**: 63 ## server_encoding @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**在创建数据库的时候由当前系统环境决定的。 +**默认值**: 在创建数据库的时候由当前系统环境决定的。 ## enable_upgrade_merge_lock_mode @@ -110,20 +110,20 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 - off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 -**默认值:**off +**默认值**: off ## transparent_encrypted_string **参数说明:**它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，设置为空表示MogDB非加密。 +**取值范围**: 字符串，设置为空表示MogDB非加密。 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** 请勿手动设置该参数，设置不当将导致MogDB不可用。 @@ -133,9 +133,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## transparent_encrypt_kms_region @@ -143,9 +143,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## basebackup_timeout diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/25-wait-events.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/25-wait-events.md index 65a819a2..81796520 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/25-wait-events.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/25-wait-events.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开等待事件信息收集功能。 - off: 表示关闭等待事件信息收集功能。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/26-query.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/26-query.md index fa84d45b..8c2e98b2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/26-query.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/26-query.md @@ -27,7 +27,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - top: 只记录顶层SQL。 @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开sql响应时间信息计算功能。 - off: 表示关闭sql响应时间信息计算功能。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 **默认值**: 80,95 @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～3600（秒）。 +**取值范围**: 整型，0～3600（秒）。 **默认值**: 10s @@ -72,7 +72,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示捕获sql执行的cpu时间消耗。 - off: 表示不捕获sql执行的cpu时间消耗。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/27-system-performance-snapshot.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/27-system-performance-snapshot.md index 1083ca06..1e34b13e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/27-system-performance-snapshot.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/27-system-performance-snapshot.md @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1～8。 +**取值范围**: 整型，1～8。 **默认值**: 8 @@ -36,7 +36,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～INT_MAX（秒）。 +**取值范围**: 整型，100～INT_MAX（秒）。 **默认值**: 100s @@ -46,6 +46,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10～60（分钟）。 +**取值范围**: 整型，10～60（分钟）。 **默认值**: 1h diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md index 43908674..9a5f9a63 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md @@ -15,7 +15,7 @@ date: 2021-04-20 enable_full_encryption设置为on后，使用gsql连接数据库时需要输入"-C"参数，或"-enable-client-encryption"，否则连接不成功。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 全密态数据库开关打开。 - off: 全密态数据库开关关闭。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/29-global-temporary-table.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/29-global-temporary-table.md index 4f3d346c..275de54e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/29-global-temporary-table.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/29-global-temporary-table.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 - 0: 全局临时表功能关闭。 - > 0: 全局临时表功能打开。 @@ -26,6 +26,6 @@ date: 2021-04-20 该参数USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 **默认值**: 10000 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md index 89c3f55a..3c528d02 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md @@ -17,13 +17,13 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** +**取值范围**: - 主机名或IP地址，多个值之间用英文逗号分隔。 - 星号"*"或"0.0.0.0"表示侦听所有IP地址。配置侦听所有IP地址存在安全风险，不推荐用户使用。必须与有效地址结合使用（比如本地IP等），否则，可能造成Build失败的问题。 - 置空则服务器不会侦听任何IP地址，这种情况下，只有Unix域套接字可以用于连接数据库。 -**默认值:**数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 ## local_bind_address @@ -31,7 +31,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值:**数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 ## port @@ -44,15 +44,15 @@ date: 2021-04-20 > 该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。 > -**取值范围:**整型，1～65535 +**取值范围**: 整型，1～65535 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置端口号时，请设置一个未被占用的端口号。设置多个实例的端口号，不可冲突。 > - 1~1023为操作系统保留端口号，请不要使用。 > - 通过配置文件安装数据库实例时，配置文件中的端口号需要注意通信矩阵预留端口。如：DN还需保留dataPortBase+1作为内部工具使用端口，保留dataPortBase+6作为流引擎消息队列通信端口等。故数据库实例安装阶段，port最大值为：DN可设置65529，同时需要保证端口号不冲突。 -**默认值:**5432（实际值由安装时的配置文件指定） +**默认值**: 5432（实际值由安装时的配置文件指定） ## max_connections @@ -60,20 +60,20 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”，job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数固定为2。 +**取值范围**: 整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”，job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数固定为2。 -**默认值:**200 +**默认值**: 200 **设置建议:** 数据库主节点中此参数建议保持默认值。 -**配置不当时影响：** +**配置不当时影响**: - 若配置max_connections过大，超过计算公式所描述的最大动态值，会出现节点拉起失败问题，报错提示“invalid value for parameter “max_connections””。 - 若未按照对外出口规格配置仅调大max_connections参数值，未同比例调整内存参数。业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于管理员用户的连接数限制会略超过max_connections设置，目的是为了让管理员在链接被普通用户占满后仍可以连接上数据库，再超过一定范围（sysadmin_reserved_connections参数）后才会报错。即管理员用户的最大连接数等于max_connections + sysadmin_reserved_connections。 > - 对于普通用户来说，由于内部作业也会使用一些链接，因此会略小于max_connections，具体值取决于内部链接个数。 @@ -84,9 +84,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 +**默认值**: 数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 **设置建议:** @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**3 +**默认值**: 3 ## unix_socket_directory @@ -112,9 +112,9 @@ date: 2021-04-20 该参数的长度限制于操作系统的长度，超过该限制将会导致Unix-domain socket path "xxx" is too long的问题。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空字符串（实际值由安装时配置文件指定） +**默认值**: 空字符串（实际值由安装时配置文件指定） ## unix_socket_group @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空字符串表示当前用户的缺省组。 +**取值范围**: 字符串，其中空字符串表示当前用户的缺省组。 -**默认值:**空字符串 +**默认值**: 空字符串 ## unix_socket_permissions @@ -136,9 +136,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0000-0777 +**取值范围**: 0000-0777 -**默认值:**0777 +**默认值**: 0777 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -170,9 +170,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串(连接到后端的应用名，以实际安装为准) +**默认值**: 空字符串(连接到后端的应用名，以实际安装为准) ## connection_info @@ -180,9 +180,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于USERSET类型参数，属于运维类参数，不建议用户设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串**。** +**默认值**: 空字符串**。** > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md index a2df6959..af0b6ec8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为600，最小单位为s。 +**取值范围**: 整型，最小值为1，最大值为600，最小单位为s。 -**默认值:**1min +**默认值**: 1min ## auth_iteration_count @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2048-134217728。 +**取值范围**: 整型，2048-134217728。 -**默认值:**10000 +**默认值**: 10000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化，请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。 @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0-86400，最小单位为s，0表示关闭超时设置。 +**取值范围**: 整型，0-86400，最小单位为s，0表示关闭超时设置。 -**默认值:**10min +**默认值**: 10min > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用SSL连接。 - off表示不启用SSL连接。 @@ -59,7 +59,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启，数据库节点默认值为off。开启此参数需要同时配置ssl_cert_file、ssl_key_file和ssl_ca_file等参数及对应文件，不正确的配置可能会导致MogDB无法正常启动。 -**默认值:**off +**默认值**: off ## require_ssl @@ -67,7 +67,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示服务器端强制要求SSL连接。 - off表示服务器端对是否通过SSL连接不作强制要求。 @@ -75,7 +75,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。 -**默认值:**off +**默认值**: off ## ssl_ciphers @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 +**取值范围**: 字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 -**默认值:**ALL +**默认值**: ALL ## ssl_renegotiation_limit @@ -93,9 +93,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 +**取值范围**: 整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 -**默认值:**0 +**默认值**: 0 ## ssl_cert_file @@ -103,9 +103,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**server.crt +**默认值**: server.crt ## ssl_key_file @@ -115,7 +115,7 @@ date: 2021-04-20 取值范围:字符串 -**默认值:**server.key +**默认值**: server.key ## ssl_ca_file @@ -123,9 +123,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**cacert.pem +**默认值**: cacert.pem ## ssl_crl_file @@ -143,9 +143,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## krb_srvname @@ -153,9 +153,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## krb_caseins_users @@ -163,12 +163,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示大小写不敏感 - off表示大小写敏感 -**默认值:**off +**默认值**: off ## modify_initial_password @@ -178,12 +178,12 @@ date: 2021-04-20 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示MogDB安装成功后初始用户首次登录操作前需要修改初始密码。 - off表示MogDB安装成功后初始用户无需修改初始密码即可进行操作。 -**默认值:**off +**默认值**: off ## password_policy @@ -194,12 +194,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 从安全性考虑，请勿关闭密码复杂度策略。 -**取值范围:**0、1 +**取值范围**: 0、1 - 0表示不采用任何密码复杂度策略。 - 1表示采用默认密码复杂度校验策略。 -**默认值:**1 +**默认值**: 1 ## password_reuse_time @@ -215,12 +215,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**浮点型（天），最小值为0，最大值为3650。 +**取值范围**: 浮点型（天），最小值为0，最大值为3650。 - 0表示不检查密码可重用的天数。 - 正数表示新密码不能为该值指定的天数内使用过的密码。 -**默认值:**60 +**默认值**: 60 ## password_reuse_max @@ -236,12 +236,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示不检查密码可重用次数。 - 正整数表示新密码不能为该值指定的次数内使用过的密码。 -**默认值:**0 +**默认值**: 0 ## password_lock_time @@ -252,12 +252,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > password_lock_time和[failed_login_attempts](#failed_login_attempts)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**浮点型，最小值为0，最大值为365，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为365，单位为天。 - 0表示密码验证失败时，自动锁定功能不生效。 - 正数表示帐户被锁定后，当锁定时间超过password_lock_time设定的值时，帐户将会被自行解锁。 -**默认值:**1d +**默认值**: 1d ## failed_login_attempts @@ -268,12 +268,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > failed_login_attempts和[password_lock_time](#password_lock_time)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示自动锁定功能不生效。 - 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前帐户将被锁定。 -**默认值:**10 +**默认值**: 10 ## password_encryption_type @@ -281,7 +281,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0、1、2 +**取值范围**: 0、1、2 - 0表示采用md5方式对密码加密。 - 1表示采用sha256和md5两种方式分别对密码加密。 @@ -290,7 +290,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > md5加密算法安全性低，存在安全风险，不建议用户使用。 -**默认值:**2 +**默认值**: 2 ## password_min_length @@ -298,9 +298,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**8 +**默认值**: 8 ## password_max_length @@ -308,9 +308,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**32 +**默认值**: 32 ## password_min_uppercase @@ -318,12 +318,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建账户所指定的密码中至少需要包含大写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_lowercase @@ -331,12 +331,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含小写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_digital @@ -344,12 +344,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含数字个数。 -**默认值:**0 +**默认值**: 0 ## password_min_special @@ -357,12 +357,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含特殊字符个数。 -**默认值:**0 +**默认值**: 0 ## password_effect_time @@ -370,12 +370,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，最小值为0，最大值为999，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为999，单位为天。 - 0表示不开启有效期限制功能。 - 1~999表示创建帐户所指定的密码有效期，临近或超过有效期系统会提示用户修改密码。 -**默认值:**90 +**默认值**: 90 ## password_notify_time @@ -383,9 +383,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为999，单位为天。 +**取值范围**: 整型，最小值为0，最大值为999，单位为天。 - 0表示不开启提醒功能。 - 1~999表示帐户密码到期前提醒的天数。 -**默认值:**7 +**默认值**: 7 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md index 6751202e..b525c870 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md @@ -20,9 +20,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPIDLE选项 ，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-3600，单位为s。 +**取值范围**: 0-3600，单位为s。 -**默认值:**60 +**默认值**: 60 ## tcp_keepalives_interval @@ -30,9 +30,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0-180，单位为s。 +**取值范围**: 0-180，单位为s。 -**默认值:**30 +**默认值**: 30 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -50,9 +50,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 +**取值范围**: 0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 -**默认值:**20 +**默认值**: 20 ## comm_tcp_mode @@ -63,9 +63,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SCTP协议的连接不再提供支持，为了保持兼容，提供此参数的接口，但此参数会在设置过程中强制改为on。 -**取值范围:**布尔型，设置为on表示使用TCP模式连接数据库节点。 +**取值范围**: 布尔型，设置为on表示使用TCP模式连接数据库节点。 -**默认值:**on +**默认值**: on ## comm_sctp_port @@ -76,9 +76,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7000 +**默认值**: 7000 ## comm_control_port @@ -89,9 +89,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7001 +**默认值**: 7001 ## comm_max_receiver @@ -99,9 +99,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为50。 +**取值范围**: 整型，最小值为1，最大值为50。 -**默认值:**4 +**默认值**: 4 ## comm_quota_size @@ -109,9 +109,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2048000，默认单位为KB。 +**取值范围**: 整型，最小值为0，最大值为2048000，默认单位为KB。 -**默认值:**1MB +**默认值**: 1MB ## comm_usable_memory @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**4000MB +**默认值**: 4000MB ## comm_memory_pool @@ -135,9 +135,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**2000MB +**默认值**: 2000MB ## comm_memory_pool_percent @@ -148,9 +148,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为100。 +**取值范围**: 整型，最小值为0，最大值为100。 -**默认值:**0 +**默认值**: 0 ## comm_no_delay @@ -158,12 +158,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 如果MogDB出现因每秒接收数据包过多导致的丢包时，需设置为off，以便小包合并成大包发送，减少数据包总数。 -**默认值:**off +**默认值**: off ## comm_debug_mode @@ -174,12 +174,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细debug日志。 - off表示不打印通信库详细debug日志。 -**默认值:**off +**默认值**: off ## comm_ackchk_time @@ -187,9 +187,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 +**取值范围**: 整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 -**默认值:**2000 +**默认值**: 2000 ## comm_timer_mode @@ -200,12 +200,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细时间桩日志。 - off表示不打印通信库详细时间桩日志。 -**默认值:**off +**默认值**: off ## comm_stat_mode @@ -216,9 +216,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库统计信息日志。 - off表示不打印通信库统计信息日志。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/31-scheduled-task.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/31-scheduled-task.md index 1325e937..8bc2d6dd 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/31-scheduled-task.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/31-scheduled-task.md @@ -30,13 +30,13 @@ date: 2021-06-07 ## enable_prevent_job_task_startup -**参数说明**：控制是否启动job线程。 +**参数说明**: 控制是否启动job线程。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示不能启动job线程。 - off表示可以启动job线程。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/32-thread-pool.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/32-thread-pool.md index 30ad6f07..802b27ae 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/32-thread-pool.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/32-thread-pool.md @@ -9,20 +9,20 @@ date: 2021-06-07 ## enable_thread_pool -**参数说明**：控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启线程池功能。 - off表示不开启线程池功能。 -**默认值**：off +**默认值**: off ## thread_pool_attr -**参数说明**：用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 该参数分为3个部分，'thread_num, group_num, cpubind_info'，这3个部分的具体含义如下： @@ -30,4 +30,4 @@ date: 2021-06-07 - group_num：线程池中的线程分组个数，取值范围是0~64。其中0的含义是数据库根据系统NUMA组的个数来自动配置线程池的线程分组个数，如果参数值大于0，线程池中的线程组个数等于group_num。 - cpubind_info：线程池是否绑核的配置参数。可选择的配置方式有集中：1. '(nobind)' ，线程不做绑核；2. '(allbind)'，利用当前系统所有能查询到的CPU core做线程绑核；3. '(nodebind: 1, 2)'，利用NUMA组1,2中的CPU core进行绑核；4. '(cpubind: 0-30)'，利用0-30号CPU core进行绑核。该参数不区分大小写。 -**默认值**：'16, 2, (nobind)' +**默认值**: '16, 2, (nobind)' diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md index 5f527e6f..2b3ead92 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md @@ -46,7 +46,7 @@ date: 2021-04-20 - on表示启用逻辑内存管理模块。 - off表示不启用逻辑内存管理模块。 -**默认值:**on +**默认值**: on > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 若max_process_memory-shared_buffers-cstore_buffers-元数据少于2G，MogDB强制把enable_memory_limit设置为off。（注: 实际上shared_buffers不直接参与计算，而是由shared_buffers通过一系列计算得到的数值更大的shared_memory。） @@ -59,7 +59,7 @@ date: 2021-04-20 **取值范围**: 整型，2\*1024\*1024～INT_MAX，单位为KB。 -**默认值:**12GB。 +**默认值**: 12GB。 **设置建议:** @@ -76,7 +76,7 @@ date: 2021-04-20 - on表示启用最大内存上下文限制检查功能。 - off表示关闭最大内存上下文限制检查功能。 -**默认值:**off +**默认值**: off ## uncontrolled_memory_context @@ -88,7 +88,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## shared_buffers @@ -96,11 +96,11 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16 ~ 1073741823 ，单位为KB。 +**取值范围**: 整型，16 ~ 1073741823 ，单位为KB。 shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 -**默认值:**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 +**默认值**: 数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 **设置建议:** @@ -114,9 +114,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384 ~ 2147483647，单位为KB。 +**取值范围**: 整型，16384 ~ 2147483647，单位为KB。 -**默认值:**2GB +**默认值**: 2GB **设置建议:**建议导入压力大的场景中增加数据库节点中此参数配置。 @@ -126,9 +126,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**双精度类型，0.1~1.0 +**取值范围**: 双精度类型，0.1~1.0 -**默认值:**0.3 +**默认值**: 0.3 ## temp_buffers @@ -140,9 +140,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 -**取值范围:**整型，100~1073741823，单位为8KB。 +**取值范围**: 整型，100~1073741823，单位为8KB。 -**默认值:**1MB +**默认值**: 1MB ## max_prepared_transactions @@ -152,9 +152,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。0~536870911。 +**取值范围**: 整型。0~536870911。 -**默认值:**800 +**默认值**: 800 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 为避免在准备步骤失败，此参数的值不能小于max_connections。 @@ -167,9 +167,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，64~2147483647，单位为KB。 +**取值范围**: 整型，64~2147483647，单位为KB。 -**默认值:**64MB +**默认值**: 64MB **设置建议:** @@ -185,9 +185,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 -**默认值:**0 +**默认值**: 0 ## query_max_mem @@ -195,9 +195,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 -**默认值:**0 +**默认值**: 0 ## maintenance_work_mem @@ -205,9 +205,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024~INT_MAX，单位为KB。 +**取值范围**: 整型，1024~INT_MAX，单位为KB。 -**默认值:**128MB +**默认值**: 128MB **设置建议:** @@ -224,9 +224,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 同样，好几个正在运行的会话可能会同时进行表的局部排序操作。因此使用的总内存可能是psort_work_mem的好几倍。 -**取值范围:**整型64~2147483647，单位为KB。 +**取值范围**: 整型64~2147483647，单位为KB。 -**默认值:**512MB +**默认值**: 512MB ## max_loaded_cudesc @@ -237,9 +237,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > max_loaded_cudesc设置过高时，有可能引起内存分配不足。 -**取值范围:**100~1073741823。 +**取值范围**: 100~1073741823。 -**默认值:**1024 +**默认值**: 1024 ## max_stack_depth @@ -253,9 +253,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 - 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在MogDB能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 - 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 -**取值范围:**整型，100~INT_MAX，单位为KB。 +**取值范围**: 整型，100~INT_MAX，单位为KB。 -**默认值:**2MB +**默认值**: 2MB > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。 @@ -266,9 +266,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384～1073741823，单位为KB。 +**取值范围**: 整型，16384～1073741823，单位为KB。 -**默认值:**1GB +**默认值**: 1GB **设置建议**: @@ -280,19 +280,19 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，256~2147483647，单位为KB。 +**取值范围**: 整型，256~2147483647，单位为KB。 -**默认值:**16MB +**默认值**: 16MB ## enable_early_free -**参数说明**：控制是否可以实现算子内存的提前释放。 +**参数说明**: 控制是否可以实现算子内存的提前释放。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持算子内存提前释放。 - off表示不支持算子内存提前释放。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md index 39732fdf..98c8c5fa 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 **默认值: -1** @@ -30,6 +30,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SQL查询执行时使用的临时表空间不在此限制。 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 -**默认值:**-1 +**默认值**: -1 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md index e889ba86..e8eecfe3 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，25~2147483647。 +**取值范围**: 整型，25~2147483647。 -**默认值:**1000 +**默认值**: 1000 ## shared_preload_libraries @@ -36,6 +36,6 @@ date: 2021-04-20 > - 如果被声明的库不存在，MogDB服务将会启动失败。 > - 每一个支持MogDB的库都有一个特殊的标记用于保证兼容性。因此，不支持MogDB的库不能用这种方法加载。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md index 558ccc71..0ccd969f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md @@ -31,9 +31,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 +**取值范围**: integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 -**默认值:**0 +**默认值**: 0 ## vacuum_cost_page_hit @@ -41,9 +41,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**1 +**默认值**: 1 ## vacuum_cost_page_miss @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**10 +**默认值**: 10 ## vacuum_cost_page_dirty @@ -61,9 +61,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~1000 +**取值范围**: integer，0~1000 -**默认值:**20 +**默认值**: 20 ## vacuum_cost_limit @@ -71,6 +71,6 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，1~10000。 +**取值范围**: integer，1~10000。 -**默认值:**200 +**默认值**: 200 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md index d38b0640..69266da2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md @@ -13,16 +13,16 @@ date: 2021-04-20 ## bgwriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～8 +**取值范围**: 整型，0～8 - 开发期间为测试关闭该特性的效果，可以设置为0，但是当前如果设置为0，会在代码中修正为1，不再支持关闭该特性。 - 当参数设置为1~8时，表示会启动相对应数量的background线程，用于维护候选buffer链，将满足条件的脏页刷盘，不脏的页放入到候选list中。 -**默认值**：2 +**默认值**: 2 ## bgwriter_delay @@ -32,21 +32,21 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10~10000，单位为毫秒。 +**取值范围**: 整型，10~10000，单位为毫秒。 -**默认值:**2s +**默认值**: 2s **设置建议:**在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 ## candidate_buf_percent_target -**参数说明**：设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 +**参数说明**: 设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度浮点类型，0.1～0.85 +**取值范围**: 双精度浮点类型，0.1～0.85 -**默认值**：0.3 +**默认值**: 0.3 ## bgwriter_lru_maxpages @@ -54,13 +54,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000 +**取值范围**: 整型，0～1000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > 此参数设置为0表示禁用后端写功能，禁用后端写功能不会对checkpoints产生影响。 -**默认值:**100 +**默认值**: 100 ## bgwriter_lru_multiplier @@ -74,39 +74,39 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0~10。 +**取值范围**: 浮点型，0~10。 -**默认值:**2 +**默认值**: 2 ## pagewriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～8 +**取值范围**: 整型，1～8 -**默认值**：2 +**默认值**: 2 ## dirty_page_percent_max -**参数说明**：设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 +**参数说明**: 设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.1～1 +**取值范围**: 浮点型，0.1～1 -**默认值**：0.9 +**默认值**: 0.9 ## pagewriter_sleep -**参数说明**：设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 +**参数说明**: 设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～3600000（毫秒） +**取值范围**: 整型，0～3600000（毫秒） -**默认值**：2000ms +**默认值**: 2000ms ## max_io_capacity @@ -114,6 +114,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，30720~10485760。单位是KB。 +**取值范围**: 整型，30720~10485760。单位是KB。 -**默认值:**512000KB（500MB） +**默认值**: 512000KB（500MB） diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md index 03d2a38e..b29c6ccb 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值:**off +**默认值**: off ## enable_adio_function @@ -26,12 +26,12 @@ date: 2021-04-20 当前版本暂不支持开启异步IO功能，默认该功能关闭，请勿自行修改。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## enable_fast_allocate @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。只有在XFS文件系统上才能开启该开关。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## prefetch_quantity @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**32MB (4096 * 8KB) +**默认值**: 32MB (4096 * 8KB) ## backwrite_quantity @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**8MB (1024 * 8KB) +**默认值**: 8MB (1024 * 8KB) ## cstore_prefetch_quantity @@ -74,9 +74,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**32MB +**默认值**: 32MB ## cstore_backwrite_quantity @@ -84,9 +84,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## cstore_backwrite_max_threshold @@ -94,9 +94,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096～INT_MAX/2，单位为KB。 +**取值范围**: 整型，4096～INT_MAX/2，单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## fast_extend_file_size @@ -104,9 +104,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## effective_io_concurrency @@ -114,36 +114,36 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型 ，0~1000 +**取值范围**: 整型 ，0~1000 -**默认值:**1 +**默认值**: 1 ## checkpoint_flush_after -**参数说明**：设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 -**默认值**：32 +**默认值**: 32 ## bgwriter_flush_after -**参数说明**：设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：512KB（即64个页面） +**默认值**: 512KB（即64个页面） ## backend_flush_after -**参数说明**：设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/5-parallel-import.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/5-parallel-import.md index 623f1f8c..b27d3fee 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/5-parallel-import.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/5-parallel-import.md @@ -20,7 +20,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示导入时区分"导入文件记录数为空"和"导入文件不存在"。 - off表示导入时不区分"导入文件记录数为空"和"导入文件不存在"。 -**默认值:**off +**默认值**: off ## partition_mem_batch @@ -30,7 +30,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 **取值范围**: 1~ 65535 -**默认值:**256 +**默认值**: 256 ## partition_max_cache_size @@ -42,7 +42,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 列存分区表: 4096~ INT_MAX / 2，最小单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## enable_delta_store @@ -55,4 +55,4 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示开启列存delta表功能。 - off表示不开启列存delta表功能。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md index f863c89d..0166ec42 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md @@ -40,7 +40,7 @@ date: 2021-04-20 这个参数表示WAL日志支持逻辑复制。 -**默认值:**hot_standby +**默认值**: hot_standby ## fsync @@ -53,12 +53,12 @@ date: 2021-04-20 > - 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 > - 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示使用fsync()系统函数。 - off表示不使用fsync()系统函数。 -**默认值:**on +**默认值**: on ## synchronous_commit @@ -82,7 +82,7 @@ date: 2021-04-20 - 0表示异步提交。 - 2表示将备机同步日志回放完成。 -**默认值:**off +**默认值**: off ## wal_sync_method @@ -114,7 +114,7 @@ date: 2021-04-20 > > 不是所有的平台都支持以上参数。 -**默认值:**fdatasync +**默认值**: fdatasync ## full_page_writes @@ -127,12 +127,12 @@ date: 2021-04-20 > - 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 > - 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用此特性。 - off表示关闭此特性。 -**默认值:**on +**默认值**: on ## wal_log_hints @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示整个页面全部内容写到WAL日志中。 - off表示整个页面内容不会写到WAL日志中。 -**默认值:**on +**默认值**: on ## wal_buffers @@ -153,12 +153,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**-1~218 +**取值范围**: -1~218 - 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，为shared_buffers的1/32，最小值为8个XLOG_BLCKSZ，最大值为2048个XLOG_BLCKSZ。 - 如果设置为其他值，当小于4时，会被默认设置为4。 -**默认值:**16MB +**默认值**: 16MB **设置建议:**每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 @@ -174,7 +174,7 @@ date: 2021-04-20 **取值范围**: 整型， 1～10000（毫秒） -**默认值:**200ms +**默认值**: 200ms ## commit_delay @@ -189,7 +189,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～100000（微秒），其中0表示无延迟。 -**默认值:**0 +**默认值**: 0 ## commit_siblings @@ -199,7 +199,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～1000 -**默认值:**5 +**默认值**: 5 ## wal_block_size @@ -209,7 +209,7 @@ date: 2021-04-20 **取值范围**: 整型，单位为Byte。 -**默认值:**8192 +**默认值**: 8192 ## wal_segment_size @@ -219,4 +219,4 @@ date: 2021-04-20 **取值范围**: 整型，单位为8KB。 -**默认值:**16MB (2048 * 8KB) +**默认值**: 16MB (2048 * 8KB) diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md index 864a9644..5617970b 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md @@ -17,7 +17,7 @@ date: 2021-04-20 提升此参数可加快大数据的导入速度，但需要结合[checkpoint_timeout](#checkpoint_timeout)、shared_buffers这两个参数统一考虑。这个参数同时影响WAL日志段文件复用数量，通常情况下pg_xlog文件夹下最大的复用文件个数为2倍的checkpoint_segments个，复用的文件被改名为后续即将使用的WAL日志段文件，不会被真正删除。 -**默认值:**64 +**默认值**: 64 ## checkpoint_timeout @@ -29,7 +29,7 @@ date: 2021-04-20 在提升[checkpoint_segments](#checkpoint_segments)以加快大数据导入的场景也需将此参数调大，同时这两个参数提升会加大shared_buffers的负担，需要综合考虑。 -**默认值:**15min +**默认值**: 15min ## checkpoint_completion_target @@ -39,7 +39,7 @@ date: 2021-04-20 **取值范围**: 0.0～1.0 -**默认值:**0.5 +**默认值**: 0.5 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值0.5表示: 每个checkpoint需要在checkpoints间隔时间的50%内完成。 @@ -52,7 +52,7 @@ date: 2021-04-20 **取值范围**: 整型，0~INT_MAX（秒），其中0表示关闭警告。 -**默认值:**5min +**默认值**: 5min **推荐值:**5min @@ -64,7 +64,7 @@ date: 2021-04-20 **取值范围**: 整型，2～3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_incremental_checkpoint @@ -74,7 +74,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## enable_double_write @@ -84,7 +84,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## incremental_checkpoint_timeout @@ -94,7 +94,7 @@ date: 2021-04-20 **取值范围**: 整型，1~3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_xlog_prune @@ -107,7 +107,7 @@ date: 2021-04-20 - 设置为on时，如果任一备机断联时，主机不回收日志。 - 设置为off时，如果任一备机断联时，主机回收日志。 -**默认值:**on +**默认值**: on ## max_redo_log_size @@ -117,7 +117,7 @@ date: 2021-04-20 **取值范围**: 整型，163840 ~ 2147483647，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## max_size_for_xlog_prune @@ -127,4 +127,4 @@ date: 2021-04-20 **取值范围**: 整型，0～2147483647，单位为KB -**默认值:**2147483647，单位KB +**默认值**: 2147483647，单位KB diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md index 86f0d4b5..f55aec38 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md @@ -17,7 +17,7 @@ date: 2021-04-20 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 -**默认值:**0 +**默认值**: 0 ## recovery_max_workers @@ -27,7 +27,7 @@ date: 2021-04-20 **取值范围**: 整型，0~20 -**默认值:**1 （安装工具默认将设置为4以获得更好的性能） +**默认值**: 1 （安装工具默认将设置为4以获得更好的性能） ## recovery_parse_workers @@ -39,7 +39,7 @@ date: 2021-04-20 仅在开启极致RTO情况下可以设置recovery_parse_workers为>1。需要配合recovery_redo_workers使用。若同时开启recovery_parse_workers和recovery_max_workers，以开启极致RTO的recovery_parse_workers为准，并行回放特性失效。因极致RTO不支持hot standby模式和主备从模式, 仅在参数hot_standby设置成off，replication_type设置成1时可以设置recovery_parse_workers为>1。另外，极致RTO也不支持列存，在已经使用列存表或者即将使用列存表的系统中，请关闭极致RTO. -**默认值:**1 +**默认值**: 1 ## recovery_redo_workers @@ -51,7 +51,7 @@ date: 2021-04-20 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于0，recovery_redo_workers参数才生效。 -**默认值:**1 +**默认值**: 1 ## recovery_parallelism @@ -61,7 +61,7 @@ date: 2021-04-20 该参数受参数: recovery_max_workers及参数: recovery_parse_workers影响，上述任意一参数值大于0时，该参数值将重新计算。 -**默认值:**1 +**默认值**: 1 ## enable_page_lsn_check @@ -71,7 +71,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## recovery_min_apply_delay @@ -79,7 +79,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数主节点设置无效，必须设置在需要延迟的备节点上。 > - 延迟时间是根据主服务器上事物提交的时间戳与备机上的当前时间来计算，因此需要保证主备系统时钟一致。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md index c78b1fa9..8ac7a0c2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md @@ -21,7 +21,7 @@ date: 2021-04-20 - on表示进行归档。 - off表示不进行归档。 -**默认值:**off +**默认值**: off ## archive_command @@ -56,7 +56,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**(disabled) +**默认值**: (disabled) ## archive_dest @@ -74,7 +74,7 @@ date: 2021-04-20 > archive_dest = '/mnt/server/archivedir/' > ``` -**默认值:**空字符串 +**默认值**: 空字符串 ## archive_timeout diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md index a18cdf80..1e09f49d 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md @@ -17,7 +17,7 @@ date: 2021-04-20 **取值范围**: 整型，0～262143 -**默认值:**16 +**默认值**: 16 ## wal_keep_segments @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2 ~ INT_MAX +**取值范围**: 整型，2 ~ INT_MAX -**默认值:**16 +**默认值**: 16 **设置建议:** @@ -47,9 +47,9 @@ date: 2021-04-20 > - 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为 600s。 > - 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**6s +**默认值**: 6s ## max_replication_slots @@ -57,9 +57,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0~262143。 +**取值范围**: 整型， 0~262143。 -**默认值:**8 +**默认值**: 8 **设置建议**: @@ -109,9 +109,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第一个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第一个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo2 @@ -119,9 +119,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第二个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第二个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo3 @@ -129,9 +129,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第三个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第三个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo4 @@ -139,9 +139,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第四个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第四个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo5 @@ -149,9 +149,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第五个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第五个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo6 @@ -159,9 +159,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第六个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第六个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo7 @@ -169,9 +169,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第七个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第七个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo8 @@ -179,9 +179,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第八个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第八个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## available_zone @@ -189,6 +189,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md index bf3362da..194bc682 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md @@ -24,7 +24,7 @@ date: 2021-04-20 - [FIRST] **num_sync (standby_name** [, …]) - **standby_name** [, …] -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 其中 **num_sync** 是事务需要等待其回复的同步复制的备机的数量，**standby_name** 是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略 > @@ -54,7 +54,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在有同步备机故障时，不阻塞主机。 - off表示在有同步备机故障时，阻塞主机。 @@ -72,7 +72,7 @@ date: 2021-04-20 > - 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 > - 此参数属于受控参数，不建议正常业务场景下关闭此参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开主备、主从同步。 - off表示关闭主备、主从同步。 @@ -89,7 +89,7 @@ date: 2021-04-20 > > 此参数目前不允许正常业务场景下改变其值，即关闭WAL日志、数据页混合复制模式。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开WAL日志、数据页混合复制模式。 - off表示关闭WAL日志、数据页混合复制模式。 @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000000，值为0表示不延迟。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。 **默认值**: 0 @@ -112,9 +112,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1072693248，单位为KB。 +**取值范围**: 整型，4096~1072693248，单位为KB。 -**默认值:**16MB（即16448KB） +**默认值**: 16MB（即16448KB） ## walsender_max_send_size @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~INT_MAX，单位为KB。 +**取值范围**: 整型，8~INT_MAX，单位为KB。 -**默认值:**8M（即8192KB） +**默认值**: 8M（即8192KB） ## enable_data_replicate @@ -132,12 +132,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 - off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 -**默认值:**off +**默认值**: off ## ha_module_debug @@ -145,12 +145,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示日志中将打印数据复制时每个数据块的状态。 - off表示日志中不打印数据复制时每个数据块的状态。 -**默认值:**off +**默认值**: off ## enable_incremental_catchup @@ -158,7 +158,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示备机catchup时用增量catchup方式，即从从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 - off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 @@ -171,7 +171,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围1~INT_MAX，单位为秒 +**取值范围**: 整型，范围1~INT_MAX，单位为秒 **默认值**: 300 @@ -185,7 +185,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围-1~10000，单位为毫秒。 +**取值范围**: 整型，范围-1~10000，单位为毫秒。 - -1表示主机阻塞直到备机数据追赶完成。 - 0表示备机数据追赶时始终不阻塞主机。 @@ -199,7 +199,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 - only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 @@ -207,7 +207,7 @@ date: 2021-04-20 **默认值：**all_node -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 在一个包含了主机、备机和级联备的MogDB集群中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。 > - 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要将集群中所有节点的sync_config_strategy参数配置为none_node；若仅希望主机与同步备机同步配置文件，则需要将主机的sync_config_strategy参数配置为only_sync_node，其余节点配置为none_node；若希望所有节点同步配置文件，则需要将所有节点的sync_config_strategy参数配置为all_node。目前暂不支持自定义指定任意节点间的同步策略。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md index 0dc392ca..68f4e507 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md @@ -18,12 +18,12 @@ date: 2021-04-20 > - 如果此参数设置为on，wal_level必须设置为hot_standby，否则将导致数据库无法启动。 > - 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许备机在恢复过程中连接和查询。 - off表示不允许备机在恢复过程中连接和查询。 -**默认值:**on +**默认值**: on ## max_standby_archive_delay @@ -35,9 +35,9 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型，范围: -1~INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围: -1~INT_MAX，单位为毫秒。 -**默认值:**3s**（即**3000ms） +**默认值**: 3s**（即**3000ms） ## max_standby_streaming_delay @@ -49,7 +49,7 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型（毫秒），范围: -1~INT_MAX +**取值范围**: 整型（毫秒），范围: -1~INT_MAX **默认值: 3s（即**3000ms） @@ -59,9 +59,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围: 0 ~ INT_MAX ，单位为毫秒。 +**取值范围**: 整型，范围: 0 ~ INT_MAX ，单位为毫秒。 -**默认值:**5s**（即**5000ms） +**默认值**: 5s**（即**5000ms） ## hot_standby_feedback @@ -69,12 +69,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许将备机上执行查询的最小事务号反馈给主机。 - off表示不允许将备机上执行查询的最小事务号反馈给主机。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -86,9 +86,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒。 -**默认值:**6s（即6000ms） +**默认值**: 6s（即6000ms） ## wal_receiver_connect_timeout @@ -96,9 +96,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX / 1000，单位为秒。 +**取值范围**: 整型， 0 ~ INT_MAX / 1000，单位为秒。 -**默认值:**2s +**默认值**: 2s ## wal_receiver_connect_retries @@ -106,9 +106,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 1~ INT_MAX。 +**取值范围**: 整型， 1~ INT_MAX。 -**默认值:**1 +**默认值**: 1 ## wal_receiver_buffer_size @@ -116,9 +116,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1047552，单位为KB。 +**取值范围**: 整型，4096~1047552，单位为KB。 -**默认值:**64MB（即65536KB） +**默认值**: 64MB（即65536KB） ## primary_slotname @@ -126,9 +126,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符型 +**取值范围**: 字符型 -**默认值:**空字符串 +**默认值**: 空字符串 ## config_sync_interval diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md index 9b557680..6946d1d0 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md @@ -197,12 +197,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示正则表达式采用A格式的匹配规则。 - off表示正则表达式采用POSIX格式的匹配规则。 -**默认值:**on +**默认值**: on ## max_recursive_times @@ -246,12 +246,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以使用绝对路径。 - off表示不可以使用绝对路径。 -**默认值:**on +**默认值**: on ## enable_valuepartition_pruning @@ -259,12 +259,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示对DFS分区表进行静态/动态优化。 - off表示不对DFS分区表进行静态/动态优化。 -**默认值:**on +**默认值**: on ## expected_computing_nodegroup @@ -337,13 +337,13 @@ date: 2021-04-20 ## check_implicit_conversions -**参数说明**：控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 +**参数说明**: 控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 - off表示不进行相关检查。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md index 84123b97..058f9800 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这个参数的取值必须是绝对路径加上.csv格式的文件名。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这个参数的取值必须是绝对路径加上.csv格式的文件名。 **取值范围**: 字符串 @@ -21,18 +21,18 @@ date: 2021-04-20 ## explain_perf_mode -**参数说明**：此参数用来指定explain的显示格式。 +**参数说明**: 此参数用来指定explain的显示格式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：normal、pretty、summary、run +**取值范围**: normal、pretty、summary、run - normal：代表使用默认的打印格式。 - pretty：代表使用MogDB改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 - summary：是在pretty的基础上增加了对打印信息的分析。 - run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。 -**默认值**：normal +**默认值**: normal ## analysis_options @@ -48,13 +48,13 @@ date: 2021-04-20 - STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pretty模式当前版本不支持。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pretty模式当前版本不支持。 **默认值：**ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 ## cost_param -**参数说明**：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 +**参数说明**: 该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1 不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确。目前，已弃用cost_param & 1 不为0时的路径，默认选择更优的估算公式； @@ -62,26 +62,26 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：0 +**默认值**: 0 ## enable_partitionwise -**参数说明**：分区表连接操作是否选择智能算法。 +**参数说明**: 分区表连接操作是否选择智能算法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示选择智能算法。 - off表示不选择智能算法。 -**默认值**：off +**默认值**: off ## rewrite_rule -**参数说明**：标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 +**参数说明**: 标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 此参数可以控制查询重写规则的组合，比如有多个重写规则：rule1、rule2、rule3、rule4。可以设置： @@ -93,7 +93,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何可选查询重写规则。 - lazyagg：使用Lazy Agg查询重写规则（消除子查询中的聚集运算）。 @@ -106,48 +106,48 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 - predpushforce：使用Predicate Push查询重写规则（下推谓词条件到子查询中，尽可能的利用索引加速）。 - predpush：在predpushnormal和predpushforce中根据代价选择最优计划。 -**默认值**：magicset +**默认值**: magicset ## enable_pbe_optimization -**参数说明**：设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 +**参数说明**: 设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化PBE语句的查询计划。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_light_proxy -**参数说明**：设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 +**参数说明**: 设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化数据库主节点上简单查询的执行。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_global_plancache -**参数说明**：设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 +**参数说明**: 设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示对PBE查询的执行计划进行缓存共享。 - off表示不共享。 -**默认值**：off +**默认值**: off ## enable_global_stats @@ -164,7 +164,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 ## enable_opfusion -**参数说明**：控制是否对简单增删改查进行优化。 +**参数说明**: 控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -214,29 +214,29 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 c3列修改的值可以是常量和参数，也可以是一个简单的表达式，c1和c2列为索引列，后边可以是常量或者参数。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_partition_opfusion -**参数说明**：在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 +**参数说明**: 在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## sql_beta_feature -**参数说明**：标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 +**参数说明**: 标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 开启它们可以对特定的场景进行优化，但也可能会导致部分没有被测试覆盖的场景发生性能劣化。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 @@ -253,7 +253,7 @@ set sql_beta_feature=none; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何Beta优化器特性。 - sel_semi_poisson：使用泊松分布对等值的半连接和反连接选择率进行校准。 @@ -264,7 +264,7 @@ set sql_beta_feature=none; - page_est_opt：优化对非列存表索引analyze信息的relpages估算。 - no_unique_index_first：关闭主键索引扫描路径优先的优化。 -**默认值**：none +**默认值**: none ## ngram_gram_size @@ -304,28 +304,28 @@ set sql_beta_feature=none; ## default_statistics_target -**参数说明**：为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 +**参数说明**: 为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-100～10000。 +**取值范围**: 整型，-100～10000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 比默认值大的正数数值增加了ANALYZE所需的时间，但是可能会改善优化器的估计质量。 > - 调整此参数可能存在性能劣化的风险，如果某个查询劣化，可以考虑 1. 恢复默认的统计信息。 2. 使用plan hint来调整到之前的查询计划。（详细参见**使用Plan Hint进行调优**） > - 当此guc参数设置为负数时，如果计算的采样样本数大于等于总数据量的2%，且用户表的数据量小于1600000时，ANALYZE所需时间相比guc参数为默认值的时间会有所增加。 > - 当此guc参数设置为负数时，则autoanalyze不生效。 -**默认值**：100 +**默认值**: 100 ## constraint_exclusion -**参数说明**：控制查询优化器使用表约束查询的优化。 +**参数说明**: 控制查询优化器使用表约束查询的优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on表示检查所有表的约束。 @@ -333,75 +333,75 @@ set sql_beta_feature=none; - partition表示只检查继承的子表和UNION ALL子查询。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 -**默认值**：partition +**默认值**: partition -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 ## cursor_tuple_fraction -**参数说明**：优化器估计游标获取行数在总行数中的占比。 +**参数说明**: 优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～1.0。 +**取值范围**: 浮点型，0.0～1.0。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 -**默认值**：0.1 +**默认值**: 0.1 ## from_collapse_limit -**参数说明**：根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 +**参数说明**: 根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 -**默认值**：8 +**默认值**: 8 ## join_collapse_limit -**参数说明**：根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 +**参数说明**: 根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。 > - 比默认值小的数值减少规划时间但也降低了执行计划的质量。 -**默认值**：8 +**默认值**: 8 ## plan_mode_seed -**参数说明**：该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 +**参数说明**: 该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~ 2147483647 +**取值范围**: 整型，-1~ 2147483647 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 > - 当该参数不为0时，查询指定的plan hint不会生效。 ## hashagg_table_size -**参数说明**：用于设置执行HASH JOIN操作时HASH表的大小。 +**参数说明**: 用于设置执行HASH JOIN操作时HASH表的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX/2。 +**取值范围**: 整型，0～INT_MAX/2。 -**默认值**：0 +**默认值**: 0 ## enable_codegen @@ -415,7 +415,7 @@ set sql_beta_feature=none; - off表示不允许开启代码生成优化。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 **默认值：**on @@ -431,7 +431,7 @@ set sql_beta_feature=none; - pure表示当所计算表达式整体可被codegen化时，才考虑调用LLVM动态编译优化策略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 **默认值：**partial @@ -515,7 +515,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。 - off表示不使用面向列的hash表设计的Hash Agg算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景enable_codegen打开后获得较大性能提升)，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为“Sonic Hash Aggregation”，而未达到该约束条件时，算子名称将显示为“Hash Aggregation”，Explain详解请参见详解。 @@ -533,7 +533,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。 - off表示不使用面向列的hash表设计的Hash Join算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前开关仅适用于Inner Join的场景。 > - 在开启enable_sonic_hashjoin，查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景，对应的算子查询性能可能会出现劣化。 @@ -556,118 +556,118 @@ set sql_beta_feature=none; ## log_parser_stats -**参数说明**：控制优化器输出parser模块的性能日志。 +**参数说明**: 控制优化器输出parser模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_planner_stats -**参数说明**：控制优化器输出planner模块的性能日志。 +**参数说明**: 控制优化器输出planner模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_executor_stats -**参数说明**：控制优化器输出executor模块的性能日志。 +**参数说明**: 控制优化器输出executor模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_statement_stats -**参数说明**：控制优化器输出该语句的性能日志。 +**参数说明**: 控制优化器输出该语句的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## plan_cache_mode -**参数说明**：标识在prepare语句中，选择生成执行计划的策略。 +**参数说明**: 标识在prepare语句中，选择生成执行计划的策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - auto表示按照默认的方式选择custom plan或者generic plan。 - force_generic_plan表示强制走generic plan。 - force_custom_plan表示强制走custom plan。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 > - custom plan是指对于preapre语句，在执行execute的时候，把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划，这种方案的优点是每次都按照具体的参数生成优选计划，执行性能比较好；缺点是每次执行前都需要重新生成计划，存在大量的重复的优化器开销。 > - generic plan是指对于preapre语句生成计划，该计划策略会在执行execute语句的时候把参数bind到plan中，然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销；缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的，部分bind参数场景下执行性能较差。 -**默认值**：auto +**默认值**: auto ## enable_hypo_index -**参数说明**：控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 +**参数说明**: 控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_force_vector_engine -**参数说明**：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 +**参数说明**: 对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以向量化的算子强制生成向量化。 - off表示由向量化算子优化器决定是否向量化。 -**默认值**：off +**默认值**: off ## enable_auto_explain -**参数说明**：控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 +**参数说明**: 控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，true表示开启，false表示关闭。 +**取值范围**: 布尔型，true表示开启，false表示关闭。 -**默认值**：false +**默认值**: false ## auto_explain_level -**参数说明**：控制自动打印执行计划的日志等级。 +**参数说明**: 控制自动打印执行计划的日志等级。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 +**取值范围**: 枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 -**默认值**：LOG +**默认值**: LOG diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/2-keywords.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/2-keywords.md index fb74cb82..25d93a78 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/2-keywords.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/2-keywords.md @@ -15,7 +15,7 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 - 标识符必须以字母（a-z）或下划线（_）开头。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此命名规范为建议项，非强制项。 > - 特殊情况下可以使用双引号规避特殊字符报错。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md index 67c7f7a4..66e5041f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md @@ -35,7 +35,7 @@ date: 2021-05-17 expression NOTNULL - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 不要写expression=NULL或expression<>(!=)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md index a08bf6f0..301178b7 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md @@ -43,7 +43,7 @@ mogdb=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; 如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 ## ANY/SOME (array) @@ -70,7 +70,7 @@ mogdb=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - 如果对比结果没有真值，则ANY的结果为false。 - 如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** SOME是ANY的同义词。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: SOME是ANY的同义词。 ## ALL (array) diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/2-operators.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/2-operators.md index f010ccc7..514c9535 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/2-operators.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/2-operators.md @@ -63,7 +63,7 @@ mogdb=# SELECT 'abc' || 'def' AS "unspecified"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 因为查询中没有声明任何类型，所以本例中对类型没有任何初始提示。因此，分析器查找所有候选操作符，发现既存在接受字符串类型范畴的操作符也存在接受位串类型范畴的操作符。因为字符串类型范畴是首选，所以选择字符串类型范畴的首选类型text作为解析未知类型文本的声明类型。 示例3：绝对值和取反操作符类型分析。MogDB操作符表里面有几条记录对应于前缀操作符@，它们都用于为各种数值类型实现绝对值操作。其中之一用于float8类型，它是数值类型范畴中的首选类型。因此，在面对unknown输入的时候， MogDB会使用该类型： @@ -88,5 +88,5 @@ mogdb=# SELECT array[1,2] <@ '{1,2,3}' as "is subset"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB操作符表有几条记录对应于中缀操作符<@，但是只有两个可以在左侧接受一个整数数组的操作符是数组包含(anyarray <@ anyarray) 和范围包含(anyelement <@ anyrange)的。因为没有多态的伪类型(参阅伪类型)是首选的，所以解析器不能解决这个基础上的歧义。然而，最后一个解析规则告诉用户，假设未知类型的文字是和另外一个输入相同的类型，也就是，整数数组。现在只有两个操作符中的一个可以匹配，所以选择数组包含。（如果用户选择了范围包含，用户将得到一个错误，因为字符串没有正确的格式成为范围的文字。） diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/3-functions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/3-functions.md index bb5f329a..83eddbd5 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/3-functions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/3-functions.md @@ -79,7 +79,7 @@ mogdb=# SELECT substr(varchar '1234', 3); mogdb=# SELECT substr(CAST (varchar '1234' AS text), 3); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 分析器从pg_cast表中了解到text和varchar是二进制兼容的，意思是说一个可以传递给接受另一个的函数而不需要做任何物理转换。因此，在这种情况下，实际上没有做任何类型转换。 而且，如果以integer为参数调用函数，分析器将试图将其转换成text类型： diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md index da6d1dd4..f8727d5d 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md @@ -32,5 +32,5 @@ mogdb=# SELECT VS_COL1, octet_length(VS_COL1) FROM tpcds.value_storage_t1; mogdb=# DROP TABLE tpcds.value_storage_t1; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这里真正发生的事情是两个unknown文本缺省解析成text，这样就允许||操作符解析成text连接。然后操作符的text结果转换成bpchar(“空白填充的字符型”， character类型内部名称)以匹配目标字段类型。不过，从text到bpchar的转换是二进制兼容的，这样的转换是隐含的并且实际上不做任何函数调用。最后，在系统表里找到长度转换函数bpchar(bpchar, integer, Boolean) 并且应用于该操作符的结果和存储的字段长。这个类型相关的函数执行所需的长度检查和额外的空白填充。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md index c53583f7..d351a6b8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md @@ -19,7 +19,7 @@ SQL UNION构造必须把那些可能不太相似的类型匹配起来成为一 - 如果输入类型是同一个类型范畴，则选择该类型范畴的首选类型。（例外：union操作会选择第一个分支的类型作为所选类型。） - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 系统表pg_type中typcategory表示数据类型范畴， typispreferred表示是否是typcategory分类中的首选类型。 - 把所有输入转换为所选的类型（对于字符串保持原有长度）。如果从给定的输入到所选的类型没有隐式转换则失败。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md index 0f1388ec..5ba969c3 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md @@ -25,7 +25,7 @@ identify_serials (7 rows) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 实际上，在这些示例查询中，应该使用coalesce防止一个独立的NULL属性导致整个文档的NULL结果。 另外一种可能是：文档在文件系统中作为简单的文本文件存储。在这种情况下，数据库可以用于存储全文索引并且执行搜索，同时可以使用一些唯一标识从文件系统中检索文档。然而，从数据库外部检索文件需要拥有系统管理员权限或者特殊函数支持。因此，还是将所有数据保存在数据库中比较方便。同时，将所有数据保存在数据库中可以方便地访问文档元数据以便于索引和显示。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md index 72583ded..13dbea3c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md @@ -19,7 +19,7 @@ MogDB提供了用来操作tsvector类型的函数和操作符。 setweight返回一个输入tsvector的副本，其中每一个位置都使用给定的权重做了标记。权值可以为A、B、C或D（D是tsvector副本的默认权重，并且不在输出中呈现）。当对tsvector进行连接操作时，这些权重标签将会被保留，文档不同部分以不同的权重进行排序。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 权重标签作用于位置，而不是词素。如果传入的tsvector已经被剥离了位置信息，那么setweight函数将什么都不做。 - length(vector tsvector) returns integer diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md index 06712a09..331941f2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md @@ -24,7 +24,7 @@ ts_rewrite函数族可以从tsquery中搜索一个特定的目标子查询，并 ts_rewrite的这种形式接受一个起始查询和SQL查询命令。 这里的查询命令是文本字串形式，必须产生两个tsquery列。查询结果的每一行，第一个字段的值（目标子查询） 都会被第二个字段（替代子查询）替换。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 当多个规则需要重写时，重写顺序非常重要； 因此在实践中需要使用ORDER BY将源查询按照某些字段进行排序。 例如：举一个现实生活中天文学上的例子。我们将使用表驱动的重写规则扩大supernovae的查询范围： diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md index 8e6d7d0f..122c26a5 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md @@ -25,5 +25,5 @@ mogdb=# SELECT ts_lexize('english_stem', 'a'); {} ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > ts_lexize函数支持单一token，不支持文本。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/8-controlling-transactions.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/8-controlling-transactions.md index a839b24a..41dcf68b 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/8-controlling-transactions.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/8-controlling-transactions.md @@ -25,5 +25,5 @@ MogDB通过COMMIT或者END可完成提交事务的功能，即提交事务的所 回滚是在事务运行的过程中发生了某种故障，事务不能继续执行，系统将事务中对数据库的所有已完成的操作全部撤销。请参考**ROLLBACK**。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，如果其中有一个语句失败，那么整个请求都将会被回滚。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/9-ddl-syntax-overview.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/9-ddl-syntax-overview.md index 4e0d7c52..5a7d7678 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/9-ddl-syntax-overview.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-reference/9-ddl-syntax-overview.md @@ -9,7 +9,7 @@ date: 2021-05-17 DDL（Data Definition Language数据定义语言），用于定义或修改数据库中的对象。如：表、索引、视图等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB不支持数据库主节点不完整时进行DDL操作。例如：MogDB中有1个数据库主节点故障时执行新建数据库、表等操作都会失败。 ## 定义数据库 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/101-DROP-USER.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/101-DROP-USER.md index eae9d608..f898459f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/101-DROP-USER.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/101-DROP-USER.md @@ -44,7 +44,7 @@ DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; - RESTRICT：如果用户还有任何依赖的对象，则拒绝删除该用户（缺省行为）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在MogDB中，存在一个配置参数enable_kill_query，此参数在配置文件postgresql.conf中。此参数影响级联删除用户对象的行为： > > - 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的进程，并删除用户。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md index 9cb11740..0208daf9 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md @@ -25,7 +25,7 @@ FOR statement ; - STATEMENT_ID用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。 ## 注意事项 @@ -40,7 +40,7 @@ FOR statement ; 1. 执行EXPLAN PLAN。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。 > PLAN_TABLE详细介绍见**PLAN_TABLE**。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/108-GRANT.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/108-GRANT.md index 06a5255b..b55879e6 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/108-GRANT.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/108-GRANT.md @@ -99,7 +99,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予域的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予域的访问权限。 - 将客户端加密主密钥CMK的访问权限赋予指定的用户或角色。 @@ -165,7 +165,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持大对象。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持大对象。 - 将模式的访问权限赋予指定的用户或角色。 @@ -176,7 +176,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 - 将表空间的访问权限赋予指定的用户或角色。 @@ -196,7 +196,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予类型的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予类型的访问权限。 - 将角色的权限赋予其他用户或角色的语法。 @@ -408,7 +408,7 @@ GRANT的参数说明如下所示。 - 如果用户有该对象上的部分权限，则GRANT命令只授予他有授权选项的权限。 - 如果用户没有可用的授权选项，GRANT ALL PRIVILEGES形式将发出一个警告信息，其他命令形式将发出在命令中提到的且没有授权选项的相关警告信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/109-INSERT.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/109-INSERT.md index e215661e..d704732d 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/109-INSERT.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/109-INSERT.md @@ -23,7 +23,7 @@ date: 2021-05-18 - 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的insert语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 ## 语法格式 @@ -58,7 +58,7 @@ INSERT INTO table_name [ ( column_name [, ...] ) ] - 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。 - **table_name** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/111-MOVE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/111-MOVE.md index 79ae2107..551ecd16 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/111-MOVE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/111-MOVE.md @@ -44,7 +44,7 @@ NEXT MOVE命令的参数与FETCH的相同，详细请参见FETCH的参数说明。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 成功完成时，MOVE命令将返回一个“MOVE count”的标签，count是一个使用相同参数的FETCH命令会返回的行数（可能为零）。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/117-REINDEX.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/117-REINDEX.md index 606d151c..11b8ab0a 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/117-REINDEX.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/117-REINDEX.md @@ -63,7 +63,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 - **FORCE** @@ -80,7 +80,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 - 如果前面是REINDEX TABLE，则这里应该指定分区的名称； - 如果前面是REINDEX INTERNAL TABLE，则这里应该指定列存分区表的分区的名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/125-SELECT.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/125-SELECT.md index fac0d9f1..2a2cbee0 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/125-SELECT.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/125-SELECT.md @@ -39,7 +39,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > condition和expression中可以使用targetlist中表达式的别名。 - 只能同一层引用。 > @@ -87,7 +87,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 FOR ( partition_value [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定分区只适合普通表。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定分区只适合普通表。 - 其中设置排序方式nlssort_expression_clause为： @@ -133,7 +133,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 ON ( expression [, …] ) 只保留那些在给出的表达式上运算出相同结果的行集合中的第一行。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 - **SELECT列表** @@ -224,7 +224,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 CROSS JOIN等效于INNER JOIN ON（TRUE） ，即没有被条件删除的行。这种连接类型只是符号上的方便，因为它们与简单的FROM和WHERE的效果相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 其中CROSS JOIN和INNER JOIN生成一个简单的笛卡尔积，和在FROM的顶层列出两个项的结果相同。 @@ -261,7 +261,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 9. “(+)“只能出现”比较表达式”，”NOT表达式”，“ANY表达式”，“ALL表达式”，“IN表达式”，“NULLIF表达式”，“IS DISTINCT FROM表达式”，“IS OF”表达式。”(+)“不能出现在其他类型表达式中，并且这些表达式中不允许出现通过“AND”和“OR”连接的表达式。 10. “(+)“只能转化为左外连接或者右外连接，不能转化为全连接，即不能在一个表达式的两个表上同时指定”(+)“。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 - **GROUP BY子句** @@ -275,7 +275,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 GROUPING SETS子句是GROUP BY子句的进一步扩展，它可以使用户指定多个GROUP BY选项。 这样做可以通过裁剪用户不需要的数据组来提高效率。 当用户指定了所需的数据组时，数据库不需要执行完整CUBE或ROLLUP生成的聚合集合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 - **HAVING子句** @@ -315,7 +315,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 UNBOUNDED FOLLOWING ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 - **UNION子句** @@ -379,7 +379,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 - 如果对于所有声明的表达式都相同，则按随机顺序返回。 - ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: > > ```bash > initdb -E UTF8 -D ../data -locale=zh_CN.UTF-8或initdb -E GBK -D ../data -locale=zh_CN.GBK。 @@ -421,7 +421,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 如果一个表中同时出现（或隐含同时出现）在FOR UPDATE和FOR SHARE子句中，则按照FOR UPDATE处理。类似的，如果影响一个表的任意子句中出现了NOWAIT，该表将按照NOWAIT处理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询不支持for update/share。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询不支持for update/share。 - **NLS_SORT** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/126-SELECT-INTO.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/126-SELECT-INTO.md index 433e4bc9..213847bc 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/126-SELECT-INTO.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/126-SELECT-INTO.md @@ -64,14 +64,14 @@ new_table指定新建表的名称。 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > SELECT INTO的其它参数可参考SELECT的参数说明。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md index 6df84df0..563806f8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/131-SET-TRANSACTION.md @@ -41,7 +41,7 @@ date: 2021-05-18 指定事务隔离级别，该参数决定当一个事务中存在其他并发运行事务时能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/134-START-TRANSACTION.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/134-START-TRANSACTION.md index 2d16fb53..dfd449f0 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/134-START-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/134-START-TRANSACTION.md @@ -51,7 +51,7 @@ BEGIN [ WORK | TRANSACTION ] 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/135-TRUNCATE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/135-TRUNCATE.md index 9838e84a..f346296f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/135-TRUNCATE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/135-TRUNCATE.md @@ -78,7 +78,7 @@ date: 2021-05-18 取值范围: 需要进行删除数据分区的分区键的取值范围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 使用PARTITION FOR子句时，partition_value所在的整个分区会被清空。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/136-UPDATE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/136-UPDATE.md index 015c3891..9ea76fd2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/136-UPDATE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/136-UPDATE.md @@ -83,7 +83,7 @@ SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 - **condition** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/137-VACUUM.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/137-VACUUM.md index 136610a5..9162707e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/137-VACUUM.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/137-VACUUM.md @@ -55,7 +55,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 - **FREEZE** @@ -93,7 +93,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 只针对列存表，将列存表的delta table中的数据转移到主表存储上。对列存表而言，此操作受enable_delta_store和参数说明中的deltarow_threshold控制。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 为了检查列存delta表中的信息，提供下述DFX函数，用于获取某个列存表的delta表中数据存储情况： > > - pgxc_get_delta_info(TEXT)，传入参数为列存表名，搜集并显示各个节点上的对应delta表信息，包括当前存活tuple数量、表大小、使用的最大block ID。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md index 7a7e6efc..53b4120c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/2-ALTER-DATABASE.md @@ -69,7 +69,7 @@ date: 2021-05-17 ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。 > - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，普通用户只能查看有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。 @@ -126,7 +126,7 @@ date: 2021-05-17 重置全部的数据库会话参数值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。 > - 修改的数据库会话参数值，将在下一次会话中生效。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/22-ALTER-TABLE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/22-ALTER-TABLE.md index f74cfae3..52eaa2b0 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/22-ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/22-ALTER-TABLE.md @@ -67,7 +67,7 @@ date: 2021-05-17 | REPLICA IDENTITY {DEFAULT | USING INDEX index_name | FULL | NOTHING} ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD table_constraint [ NOT VALID ]** 给表增加一个新的约束。 @@ -132,7 +132,7 @@ date: 2021-05-17 | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 @@ -240,7 +240,7 @@ date: 2021-05-17 SET SCHEMA new_schema; ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。 - 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。 @@ -314,7 +314,7 @@ date: 2021-05-17 USING子句声明如何从旧的字段值里计算新的字段值；如果省略，缺省从旧类型向新类型的赋值转换。如果从旧数据类型到新类型没有隐含或者赋值的转换，则必须提供一个USING子句。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 - **NOT NULL | NULL** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md index 8f5f0cd2..480d1411 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md @@ -104,7 +104,7 @@ date: 2021-05-17 AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 列存分区表不支持切割分区。 > - 切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。 @@ -115,7 +115,7 @@ date: 2021-05-17 INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。 > - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。 @@ -154,7 +154,7 @@ date: 2021-05-17 [ TABLESPACE tablespacename ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - partition_list_item仅支持的1个分区键，其支持的数据类型参见**PARTITION BY LIST(partit…**。 > - 间隔/哈希分区表不支持添加分区。 @@ -165,7 +165,7 @@ date: 2021-05-17 DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 哈希分区表不支持删除分区。 > - 列表分区表仅支持通过子分区名称删除子分区。 @@ -249,7 +249,7 @@ date: 2021-05-17 在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 - **partition_new_name** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md index 8338ee78..8f518c8c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md @@ -17,7 +17,7 @@ date: 2021-05-17 - 要修改表空间的所有者A为B，则A必须是B的直接或者间接成员。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 ## 语法格式 @@ -88,7 +88,7 @@ date: 2021-05-17 - random_page_cost：设置优化器计算一次非顺序获取磁盘页面的开销。缺省为4.0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - random_page_cost是相对于seq_page_cost的取值，等于或者小于seq_page_cost时毫无意义。 > - 默认值为4.0的前提条件是，优化器采用索引来扫描表数据，并且表数据在cache中命中率可以90%左右。 @@ -107,7 +107,7 @@ date: 2021-05-17 - 由space_size来确定，其格式参考**CREATE TABLESPACE**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若调整后的限额值比当前表空间实际使用的值小，调整操作可以执行成功。后续用户需要将该表空间的使用值降低至新限额值之下，才能继续往该表空间中写入数据。 > diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md index 5bee39a5..7c3a6b1a 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md @@ -57,7 +57,7 @@ date: 2021-05-17 要修改的参数名。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不支持修改词典的TEMPLATE参数值。 > - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/28-ALTER-TYPE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/28-ALTER-TYPE.md index 387ed8c8..26e34f8c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/28-ALTER-TYPE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/28-ALTER-TYPE.md @@ -133,7 +133,7 @@ date: 2021-05-17 如果需联动更新类型是已更新类型的关联记录，则拒绝更新。这是缺省选项。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - ADD ATTRIBUTE、DROP ATTRIBUTE和ALTER ATTRIBUTE选项可以组合成一个列表同时处理。 例如，在一条命令中同时增加几个属性或是更改几个属性的类型是可以实现的。 > - 要修改一个类型的模式，还必须在新模式上拥有CREATE权限。 要修改所有者，必须是新的所有角色的直接或间接成员， 并且该成员必须在此类型的模式上有CREATE权限。 （这些限制强制了修改所有者不会做任何通过删除和重建类型不能做的事情。 不过，系统管理员可以以任何方式修改任意类型的所有权。） 要增加一个属性或是修改一个属性的类型，也必须有该类型的USAGE权限。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md index bfcd6f44..3db177f2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md @@ -39,7 +39,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 PARTITION ( patrition_name ) ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 - 收集多列统计信息 @@ -48,7 +48,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 table_name (( column_1_name, column_2_name [, ...] )); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 收集多列统计信息时，请设置GUC参数default_statistics_target为负数，以使用百分比采样方式。 > - 每组多列统计信息最多支持32列。 @@ -60,7 +60,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - Fast模式校验时，需要对校验的表有并发的DML操作，会导致校验过程中有误报的问题，因为当前Fast模式是直接从磁盘上读取，并发有其他线程修改文件时，会导致获取的数据不准确，建议离线操作。 > - 支持对全库进行操作，由于涉及的表较多，建议以重定向保存结果**gsql -d database -p port -f “verify.sql”> verify_warning.txt 2>&1**。 @@ -74,7 +74,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持对普通表的操作和索引表的操作，但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表，当单独对索引表进行检测时，无需使用CASCADE模式。 > - 对于主表的检测会同步检测主表的内部表，例如toast表、cudesc表等。 @@ -86,7 +86,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 ## 参数说明 @@ -94,7 +94,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 启用显示进度信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 - **table_name** @@ -182,7 +182,7 @@ INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若环境若有故障，需查看数据库主节点的log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若环境若有故障，需查看数据库主节点的log。 - 删除表。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/34-CALL.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/34-CALL.md index d6828893..a8b418bc 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/34-CALL.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/34-CALL.md @@ -39,7 +39,7 @@ CALL [schema.] {func_name| procedure_name} ( param_expr ); 取值范围: 已存在的函数参数名称或存储过程参数名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见示例。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md index 40561fcd..929179f1 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md @@ -139,7 +139,7 @@ ALTER DEFAULT PRIVILEGES 取值范围: 已存在的角色名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/41-COPY.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/41-COPY.md index 292ef555..18cf97cb 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/41-COPY.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/41-COPY.md @@ -43,7 +43,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 语法中的FIXED、FORMATTER ( { column_name( offset, length ) } [, …] )以及copy_option [ …]可以任意排列组合，但FIXED和FORMATTER必须配合使用。 - 把一个表的数据拷贝到一个文件。 @@ -65,7 +65,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. COPY TO语法形式约束如下： > (query)与[USING] DELIMITER不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。 @@ -156,7 +156,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 打开字段固定长度模式。在字段固定长度模式下，不能声明DELIMITER，NULL，CSV选项。指定FIXED类型后，不能再通过copy_option指定BINARY、CSV、TEXT等类型。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 定长格式定义如下： > > 1. 每条记录的每个字段长度相同。 @@ -183,7 +183,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 仅支持导入（即COPY FROM）时指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 此容错选项的使用限制如下： > > - 此容错机制仅捕捉COPY FROM过程中数据库主节点上数据解析过程中相关的数据类型错误（DATA_EXCEPTION）。 @@ -210,7 +210,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：若未指定LOG ERRORS，则会报错；若指定LOG ERRORS，则默认为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如上述LOG ERRORS中描述的容错机制，REJECT LIMIT的计数也是按照执行COPY FROM的数据库主节点上遇到的解析错误数量计算，而不是数据库节点的错误数量。 - **FORMATTER** @@ -247,7 +247,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 指定数据文件行数据的字段分隔符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 分隔符不能是\r和\n。 > - 分隔符不能和null参数相同，CSV格式数据的分隔符不能和quote参数相同。 @@ -295,7 +295,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -313,7 +313,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式导入。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -351,7 +351,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果行尾换行符丢失，使两行变成一行时，设置此参数为true将导致后一行数据被忽略掉。 - COMPATIBLE_ILLEGAL_CHARS @@ -365,7 +365,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -385,7 +385,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT @@ -414,7 +414,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 用来指定数据文件中空值的表示。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以应该确保指定的字符串和COPY TO相同。 取值范围: @@ -439,7 +439,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 导出数据时用于定义标题行的文件，一般用来描述每一列的数据信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 仅在header为on或true的情况下有效。 > - fileheader指定的是绝对路径。 @@ -456,7 +456,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 - 当前事务中没有打开的游标。 - 当前事务中没有原有的快照。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - FORCE NOT NULL column_name [, …] @@ -485,7 +485,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -503,7 +503,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -533,7 +533,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 若不使用该参数，导入时遇到非法字符进行报错，中断导入。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -547,7 +547,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目前COPY指定此Option实际不会生效，即不会有相应的容错处理效果（不生效）。需要额外注意的是，打开此选项会导致解析器在数据库主节点数据解析阶段（即COPY错误表容错的涵盖范围）忽略此数据问题，而到数据库节点重新报错，从而使得COPY错误表（打开LOG ERRORS REJECT LIMIT）在此选项打开的情况下无法成功捕获这类少列的数据异常。因此请不要指定此选项。 - DATE_FORMAT 'date_format_string' @@ -556,7 +556,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT 'time_format_string' diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md index 230fba31..e155fb68 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md @@ -55,7 +55,7 @@ KEY_STORE '=' key_store_value ',' KEY_PATH '=' key_path_value ',' ALGORITHM '=' - ALGORITHM：cmk用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值：目前仅支持RSA_2048。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** **密钥存储路径：**默认情况下，localkms将在$LOCALKMS_FILE_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS_FILE_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub，key_path_value.pub.rand， key_path_value.priv， key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: **密钥存储路径：**默认情况下，localkms将在$LOCALKMS_FILE_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS_FILE_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub，key_path_value.pub.rand， key_path_value.priv， key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md index c3e4f4f7..5652c29d 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/44-CREATE-DATABASE.md @@ -108,7 +108,7 @@ CREATE DATABASE database_name > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为MogDB将无法帮助你转换或者校验非ASCII字符。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 > - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[]^_`a-z{|}重叠。其中@[]^_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 @@ -131,7 +131,7 @@ CREATE DATABASE database_name 指定兼容的数据库的类型。取值范围: A、B、C、PG。分别表示兼容Oracle、MySQL、Teradata和PostgreSQL。但是C目前已经放弃支持。因此常用的取值是A、B、PG。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 > - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 @@ -147,7 +147,7 @@ CREATE DATABASE database_name 数据库可以接受的并发连接数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，数据库MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md index d9493581..5d3680e2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/48-CREATE-FUNCTION.md @@ -99,7 +99,7 @@ date: 2021-05-10 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。并且OUT和INOUT模式的参数不能用在RETURNS TABLE的函数定义中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: VARIADIC用于声明数组类型的参数。 - **argtype** @@ -141,7 +141,7 @@ date: 2021-05-10 表示该函数是窗口函数。替换函数定义时不能改变WINDOW属性。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 - **IMMUTABLE** @@ -243,7 +243,7 @@ date: 2021-05-10 PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/50-CREATE-INDEX.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/50-CREATE-INDEX.md index 701a82f5..603e6ddb 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/50-CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/50-CREATE-INDEX.md @@ -66,7 +66,7 @@ date: 2021-05-10 - 普通CREATE INDEX命令可以在事务内执行，但是CREATE INDEX CONCURRENTLY不可以在事务内执行。 - 列存表、分区表和临时表不支持CONCURRENTLY方式创建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > - 由于需要执行两次对表的扫描和build，而且必须等待现有的所有可能对该表执行修改的事务结束。这意味着该索引的创建比正常耗时更长，同时因此带来的CPU和I/O消耗对其他业务也会造成影响。 @@ -107,7 +107,7 @@ date: 2021-05-10 行存表支持的索引类型：btree（行存表缺省值）、gin、gist。列存表支持的索引类型：Psort（列存表缺省值）、btree、gin。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 - **column_name** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md index 6e56b42e..d0415f32 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -91,7 +91,7 @@ CREATE [ ROW LEVEL SECURITY ] POLICY policy_name ON table_name 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 系统管理员不受行访问控制特性影响。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 系统管理员不受行访问控制特性影响。 - **using_expression** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md index 8b5f3915..1226bde9 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md @@ -57,7 +57,7 @@ plsql_body 参数的模式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: VARIADIC用于声明数组类型的参数。 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。 @@ -97,9 +97,9 @@ plsql_body PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 ## 优化建议 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/54-CREATE-ROLE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/54-CREATE-ROLE.md index 6e102b06..9bd2f3a2 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/54-CREATE-ROLE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/54-CREATE-ROLE.md @@ -67,7 +67,7 @@ CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { 取值范围: 字符串，要符合标识符的命名规范，且最多为63个字符。若超过63个字符，数据库会截断并保留前63个字符当做角色名称。在创建角色时，数据库的时候会给出提示信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 - **password** @@ -157,7 +157,7 @@ CREATE ROLE role_name [ [ WITH ] option [ ... ] ] [ ENCRYPTED | UNENCRYPTED ] { 声明该角色可以使用的并发连接数量。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md index 0172dad6..331fb928 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/56-CREATE-SCHEMA.md @@ -41,7 +41,7 @@ date: 2021-05-10 模式名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 模式名不能和当前数据库里其他的模式重名。 > 模式的名称不可以“pg_”开头。 @@ -59,7 +59,7 @@ date: 2021-05-10 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md index 2ce55430..5bb1e95c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md @@ -58,7 +58,7 @@ CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为1，表示一次只能生成一个值，也就是没有缓存。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 不建议同时定义cache和maxvalue或minvalue。因为定义cache后不能保证序列的连续性，可能会产生空洞，造成序列号段浪费。 - **CYCLE** @@ -79,7 +79,7 @@ CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为OWNED BY NONE，表示不存在这样的关联。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过OWNED BY创建的Sequence不建议用于其他表，如果希望多个表共享Sequence，该Sequence不应该从属于特定表。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md index 19bd23a4..b4b40052 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/59-CREATE-SYNONYM.md @@ -40,7 +40,7 @@ CREATE [ OR REPLACE ] SYNONYM synonym_name 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > object_name可以是不存在的对象名称。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/60-CREATE-TABLE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/60-CREATE-TABLE.md index dd2feea5..a18f4d78 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/60-CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/60-CREATE-TABLE.md @@ -109,7 +109,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 @@ -162,7 +162,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）会复制到新表中。默认情况下，不复制源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果源表包含serial、bigserial、smallserial类型，或者源表字段的默认值是sequence，且sequence属于源表（通过CREATE SEQUENCE … OWNED BY创建），这些Sequence不会关联到新表中，新表中会重新创建属于自己的sequence。这和之前版本的处理逻辑不同。如果用户希望源表和新表共享Sequence，需要首先创建一个共享的Sequence（避免使用OWNED BY），并配置为源表字段默认值，这样创建的新表会和源表共享该Sequence。 > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 @@ -171,7 +171,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 这个子句为表或索引指定一个可选的存储参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 参数的详细描述如下所示。 @@ -282,7 +282,7 @@ CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TABLE [ IF NOT EXI 声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 - **DEFAULT default_expr** @@ -957,7 +957,7 @@ mogdb=# DROP SCHEMA IF EXISTS joe CASCADE; - 如果指定了INCLUDING PARTITION，则源表的分区定义会复制到新表中，同时新表将不能再使用PARTITION BY子句。默认情况下，不拷贝源表的分区定义。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 - LIKE INCLUDING RELOPTIONS diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md index 49d5d776..87ca38e0 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md @@ -54,7 +54,7 @@ CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE table_name 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md index cde7ae64..d14509f8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md @@ -194,7 +194,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -235,19 +235,19 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name （1）对于从句是VALUES LESS THAN的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、CHARACTER VARYING(n)、VARCHAR(n)、CHARACTER(n)、CHAR(n)、CHARACTER、CHAR、TEXT、NVARCHAR2、NAME、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （2）对于从句是START END的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （3）对于指定了INTERVAL子句的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 @@ -255,7 +255,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name 指定各分区的信息。partition_name为范围分区的名称。partition_value为范围分区的上边界，取值依赖于partition_key的类型。MAXVALUE表示分区的上边界，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 每个分区都需要指定一个上边界。 > - 分区上边界的类型应当和分区键的类型一致。 @@ -272,7 +272,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_value：对[START，END) 表示的范围进行切分，interval_value是指定切分后每个分区的宽度，不可是MAXVALUE；如果（END-START）值不能整除以EVERY值，则仅最后一个分区的宽度小于EVERY值。 - MAXVALUE：表示最大值，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 1. 在创建分区表若第一个分区定义含START值，则范围（MINVALUE，START）将自动作为实际的第一个分区。 > 2. START END语法需要遵循以下限制： @@ -292,7 +292,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - STORE IN (tablespace_name [, … ] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列存表不支持间隔分区。 - **PARTITION BY LIST(partition_key)** @@ -322,7 +322,7 @@ CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ENABLE（缺省值）：行迁移开关打开。 - DISABLE：行迁移开关关闭。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持ROW MOVEMENT。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持ROW MOVEMENT。 - **NOT NULL** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md index d2b89cfc..30e62cd8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md @@ -136,7 +136,7 @@ CREATE TEXT SEARCH DICTIONARY name ( 词典定义文件所在目录。可以指定为本地目录或者OBS目录（只能在安全模式下指定OBS目录，通过启动时添加securitymode选项进入安全模式）。其中，本地目录格式为”file://absolute_path”，OBS目录格式为”obs://bucket_name/path accesskey=ak secretkey=sk region=rg”。默认值为预定义词典文件所在目录。FILEPATH参数必须和STOPWORDS参数同时指定，不允许单独指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 词典定义文件的文件名仅支持小写字母、数据、下划线混合。 - **value** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md index 19faba3d..da43a174 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/66-CREATE-TRIGGER.md @@ -127,7 +127,7 @@ CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | INSTEAD OF } { eve 执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关于触发器种类： > > - INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/67-CREATE-TYPE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/67-CREATE-TYPE.md index f105eecf..9810667f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/67-CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/67-CREATE-TYPE.md @@ -107,7 +107,7 @@ CREATE TYPE name AS ENUM 输入函数必须返回一个该数据类型本身的值。通常，一个输入函数应该被声明为STRICT。 如果不是这样，在读到一个NULL输入值时，调用输入函数时第一个参数会是NULL。在这种情况下，该函数必须仍然返回NULL，除非调用函数发生了错误（这种情况主要是想支持域输入函数，域输入函数可能需要拒绝NULL输入）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 输入和输出函数能被声明为具有新类型的结果或参数是因为：必须在创建新类型之前创建这两个函数。而新类型应该首先被定义为一种shell type，它是一种占位符类型，除了名称和拥有者之外它没有其他属性。这可以通过不带额外参数的命令CREATE TYPE name做到。然后用C写的I/O函数可以被定义为引用这种shell type。最后，用带有完整定义的CREATE TYPE把该shell type替换为一个完全的、合法的类型定义，之后新类型就可以正常使用了。 - **output_function** @@ -143,7 +143,7 @@ CREATE TYPE name AS ENUM 可选参数。将类型的修饰符的内部形式转换为外部文本形式的函数名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果该类型支持修饰符（附加在类型声明上的可选约束，例如，char(5)或numeric(30,2)），则需要可选的type_modifier_input_function以及type_modifier_output_function。MogDB允许用户定义的类型有一个或者多个简单常量或者标识符作为修饰符。不过，为了存储在系统目录中，该信息必须能被打包到一个非负整数值中。所声明的修饰符会被以cstring数组的形式传递给type_modifier_input_function。 type_modifier_input_function必须检查该值的合法性（如果值错误就抛出一个错误），如果值正确，要返回一个非负integer值，该值将被存储在“typmod”列中。如果类型没有 type_modifier_input_function则类型修饰符将被拒绝。type_modifier_output_function把内部的整数typmod值转换回正确的形式用于用户显示。type_modifier_output_function必须返回一个cstring值，该值就是追加到类型名称后的字符串。例如，numeric的函数可能会返回(30,2)。如果默认的显示格式就是只把存储的typmod整数值放在圆括号内，则允许省略type_modifier_output_function。 - **analyze_function** @@ -198,7 +198,7 @@ CREATE TYPE name AS ENUM 可选参数。如果这种类型是其类型分类中的优先类型则为TRUE，否则为FALSE。默认为假。在一个现有类型分类中创建一种新的优先类型要非常谨慎， 因为这可能会导致很大的改变。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > category和preferred参数可以被用来帮助控制在混淆的情况下应用哪一种隐式造型。每一种数据类型都属于一个用单个ASCII 字符命名的分类，并且每一种类型可以是其所属分类中的“首选”。当有助于解决重载函数或操作符时，解析器将优先造型到首选类型（但是只能从同类的其他类型造型）。对于没有隐式转换到或来自任意其他类型的类型，让这些设置保持默认即可。不过，对于有隐式转换的相关类型的组，把它们都标记为属于同一个类别并且选择一种或两种“最常用”的类型作为该类别的首选通常是很有用的。在把一种用户定义的类型增加到一个现有的内建类别（例如，数字或者字符串类型）中时，category参数特别有用。不过，也可以创建新的全部是用户定义类型的类别。对这样的类别，可选择除大写字母之外的任何ASCII 字符。 - **default** @@ -227,7 +227,7 @@ CREATE TYPE name AS ENUM 可选参数。与枚举类型的一个值相关的文本标签，其值为长度不超过63个字符的非空字符串。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在创建用户定义类型的时候， MogDB会自动创建一个与之关联的数组类型，其名称由该元素类型的名称前缀一个下划线组成。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/70-CREATE-VIEW.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/70-CREATE-VIEW.md index b1c2b49c..bd4ee0b5 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/70-CREATE-VIEW.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/70-CREATE-VIEW.md @@ -23,7 +23,7 @@ CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( column_name [, ... AS query; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 创建视图时使用WITH(security_barriers)可以创建一个相对安全的视图，避免攻击者利用低成本函数的RAISE语句打印出隐藏的基表数据。 ## 参数说明 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/78-DROP-DATABASE.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/78-DROP-DATABASE.md index d5d11115..578d2e5e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/78-DROP-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/78-DROP-DATABASE.md @@ -19,7 +19,7 @@ date: 2021-05-10 - 不能在事务块中执行DROP DATABASE命令。 - 如果执行DROP DATABASE失败，事务回滚，需要再次执行一次DROP DATABASE IF EXISTS。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DROP DATABASE一旦执行将无法撤销，请谨慎使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DROP DATABASE一旦执行将无法撤销，请谨慎使用。 ## 语法格式 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/9-ALTER-INDEX.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/9-ALTER-INDEX.md index 08e090fd..b0d62014 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/9-ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/9-ALTER-INDEX.md @@ -90,7 +90,7 @@ ALTER INDEX用于修改现有索引的定义。 [ MODIFY PARTITION index_partition_name ] UNUSABLE; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表不支持该语法。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表不支持该语法。 - 重建表索引或索引分区。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md index 379cfa21..c64abe0f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/sql-syntax/91-DROP-SCHEMA.md @@ -38,9 +38,9 @@ DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRICT ]; - CASCADE：自动删除包含在模式中的对象。 - RESTRICT：如果模式包含任何对象，则删除失败（缺省行为）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/client-tool.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/client-tool.md index d1b12c0c..16d60496 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/client-tool.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/client-tool.md @@ -19,7 +19,7 @@ gsql是MogDB提供在命令行下运行的数据库连接工具，可以通过 - **连接数据库：**详细操作请参见《开发者指南》中“数据库使用 > 连接数据库 > 使用gsql连接 > 远程连接数据库”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考**常见问题处理**。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考**常见问题处理**。 - **执行SQL语句：**支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 @@ -58,7 +58,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql预定义了一些特殊变量，同时也规划了变量的取值。为了保证和后续版本最大限度地兼容，请避免以其他目的使用这些变量。所有特殊变量见[表2](#teshubian)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 所有特殊变量都由大写字母、数字和下划线组成。 > - 要查看特殊变量的默认值，请使用元命令**\echo :**_varname_（例如\echo :DBNAME）。 @@ -99,7 +99,7 @@ gsql的高级特性如[表1](#gsql)所示。 执行以上命令，将会查询HR.areaS表。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 - 提示符 @@ -165,7 +165,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 示例1，使用omm用户连接到本机mogdb数据库的15400端口。 @@ -536,7 +536,7 @@ omm@[local] mogdb=# 元命令的详细说明请参见表 一般的元命令、表 查询缓存区元命令、表 输入/输出元命令、表 显示信息元命令、表 格式化元命令、表 连接元命令、表 操作系统元命令、表 变量元命令和表 大对象元命令。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 **表 11** 一般的元命令 @@ -571,7 +571,7 @@ omm@[local] mogdb=# | \o [FILE] | 把所有的查询结果发送到文件里。 | | \qecho [STRING] | 把字符串写到查询结果输出流里。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** [表 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: [表 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 **表 14** 显示信息元命令 @@ -783,7 +783,7 @@ omm@[local] mogdb=# 数据库由于安全问题，禁止远程登录时使用trust模式。这时需要修改pg_hba.conf里的连接认证信息。具体的设置信息请参见：《开发者指南》中“管理数据库安全 > 客户端接入认证 > 配置文件参考”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 - 连接数据库，添加“-h 127.0.0.1”可以连接，去掉后无法连接问题。 @@ -834,7 +834,7 @@ omm@[local] mogdb=# GRANT CONNECT ON DATABASE mogdb TO user1; - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 > > ``` > gsql -d mogdb -p 15400 @@ -900,7 +900,7 @@ omm@[local] mogdb=# 目标数据库主节点的pg_hba.conf里配置了当前客户端IP使用”gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到”sha256”后再试。配置方法见《开发者指南》中“管理数据库安全 > 客户端接入认证 > 配置文件参考”章节 。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。 > - 建议业务应用部署在MogDB之外，而非MogDB内部。 @@ -913,4 +913,4 @@ omm@[local] mogdb=# 解决此问题，重试便可。同时请尽可能避免在升级等运维操作过程中，在MogDB内部运行业务程序，避免升级时因替换文件产生此问题。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/1-gs_check.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/1-gs_check.md index 74ef25ee..7638337e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/1-gs_check.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/1-gs_check.md @@ -213,7 +213,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 | CheckNetSpeed(检查网卡接收带宽，ping值，丢包率) | 网络满载时，检查网卡平均接收带宽大于600MB通过;
网络满载时，检查网络ping值，小于1秒通过;
网络满载时，检查网卡丢包率，小于1%通过。 | 否 | | | other | CheckDataDiskUsage(检查数据库节点磁盘空间使用率) | 检查磁盘数据库节点目录使用率，如果使用率低于90%则检查项通过，否则检查项不通过。 | 否 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** CheckNetSpeed检查项： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: CheckNetSpeed检查项： > > - CheckNetSpeed不支持-L本地检查模式，-L模式无法构造网络压力，检查的结果不准确。 > - 在节点数小于6时，speed_test构造的网络压力可能无法跑满带宽，可能会造成检查结果不准确。 @@ -247,7 +247,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 scp scene_upgrade.xml SIA1000068994：home/package/script/gspylib/inspection/config/ ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 5. 换至omm用户，执行以下命令查看检查结果。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md index 3d3d28d5..113ee1c7 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md @@ -45,7 +45,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 取值范围: A1…A14、B1…B8 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 详细的检查项请参见[表1](#gs_checkos)。 @@ -53,7 +53,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 主机名称列表文件。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称的列表。 @@ -118,7 +118,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 | B7 | 设置欧拉系统属性（Set RemoveIPC value） | 欧拉系统属性检查：检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service，/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no，当不为no时，对其进行修改设置。 | | B8 | 设置sshd服务应用pam模块（Set Session Process） | 远程设备继承系统默认资源：修改/etc/pam.d/sshd服务文件，添加配置项session required pam_limits.so，来控制用户使用的资源。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A6选项检查标准来自配置文件check_list.conf下[/etc/sysctl.conf]、[SUGGEST:/etc/sysctl.conf]域： 若[/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Abnormal，可以使用B1参数进行设置。 若[SUGGEST:/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Warning，B1参数不会进行设置，需根据实际情况进行手动设置。 > - A7选项检查系统文件句柄标准来自配置文件check_list.conf下[/etc/security/limits.conf]域open file参数，可以使用B2参数进行设置。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/4-gs_collector.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/4-gs_collector.md index 35d48996..65340c6c 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/4-gs_collector.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/4-gs_collector.md @@ -60,7 +60,7 @@ date: 2021-06-07 主机名称列表文件。该文件为纯文本格式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称列表。 @@ -97,7 +97,7 @@ date: 2021-06-07 } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 默认配置文件内容如下： { “Collect”: [ {“TypeName”: “System”, “Content”:“RunTimeInfo, HardWareInfo”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Log”, “Content” : “DataNode,ClusterManager”, “Interval”:“0”, “Count”:“1”}, {“TypeName”: “Database”, “Content”: “pg_locks,pg_stat_activity,pg_thread_wait_status”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Config”, “Content”: “DataNode”, “Interval”:“0”, “Count”:“1”} ] } TypeName和对应的Content取值范围见表1gs_collector内容收集对照表。 对于Log，CoreDump，Config，XLog四种类型，Interval和Count参数不生效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 默认配置文件内容如下： { “Collect”: [ {“TypeName”: “System”, “Content”:“RunTimeInfo, HardWareInfo”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Log”, “Content” : “DataNode,ClusterManager”, “Interval”:“0”, “Count”:“1”}, {“TypeName”: “Database”, “Content”: “pg_locks,pg_stat_activity,pg_thread_wait_status”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Config”, “Content”: “DataNode”, “Interval”:“0”, “Count”:“1”} ] } TypeName和对应的Content取值范围见表1gs_collector内容收集对照表。 对于Log，CoreDump，Config，XLog四种类型，Interval和Count参数不生效。 - -keyword=KEYWORD @@ -105,7 +105,7 @@ date: 2021-06-07 若关键字KEYWORD中含有空格，需要使用双引号包围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 - -begin-time diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/5-gs_dump.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/5-gs_dump.md index e0096937..4b0488a8 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/5-gs_dump.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/5-gs_dump.md @@ -35,7 +35,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者-forma | 目录归档格式 | d | 该格式会创建一个目录，该目录包含两类文件，一类是目录文件，另一类是每个表和blob对象对应的数据文件。 | - | | | tar归档格式 | t | tar归档文件支持从导出文件中恢复所有或所选数据库对象。tar归档格式不支持压缩且对于单独表大小应小于8GB。 | - | | -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以使用gs_dump程序将文件压缩为纯文本或自定义归档导出文件，减少导出文件的大小。生成纯文本导出文件时，默认不压缩。生成自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。通过压缩方式导出纯文本格式文件，gsql无法成功导入数据对象。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以使用gs_dump程序将文件压缩为纯文本或自定义归档导出文件，减少导出文件的大小。生成纯文本导出文件时，默认不压缩。生成自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。通过压缩方式导出纯文本格式文件，gsql无法成功导入数据对象。 ## 注意事项 @@ -49,7 +49,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者-forma gs_dump [OPTION]... [DBNAME] ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 ```bash gs_dump -p port_number postgres -f dump1.sql @@ -144,7 +144,7 @@ export PGDATABASE=postgres 只转储与模式名称匹配的模式，此选项包括模式本身和所有它包含的对象。如果该选项没有指定，所有在目标数据库中的非系统模式将会被转储。写入多个-n选项来选择多个模式。此外，根据gsql的\d命令所使用的相同规则，模式参数可被理解成一个pattern，所以多个模式也可以通过在该pattern中写入通配符来选择。使用通配符时，注意给pattern打引号，防止shell扩展通配符。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 当-n已指定时，gs_dump不会转储已选模式所附着的任何其他数据库对象。因此，无法保证某个指定模式的转储结果能够自行成功地储存到一个空数据库中。 - 当-n指定时，非模式对象不会被转储。 @@ -203,7 +203,7 @@ export PGDATABASE=postgres 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数-include-table-file来替换。 @@ -241,7 +241,7 @@ export PGDATABASE=postgres 指定不需要dump的表文件。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… - -x, -no-privileges|-no-acl @@ -331,7 +331,7 @@ export PGDATABASE=postgres AES128密钥长度必须是16字节。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 - 不支持加密导出存储过程和函数。 @@ -362,7 +362,7 @@ AES128密钥长度必须是16字节。 gs_dump -p port_number postgres -f backup.sql -F plain --dont-overwrite-file ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -s/-schema-only和-a/-data-only不能同时使用。 - -c/-clean和-a/-data-only不能同时使用。 @@ -432,7 +432,7 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中“Bigdata@123”表示数据库用户密码；“backup/MPPDB_backup.sql”表示导出的文件，其中backup表示相对于当前目录的相对目录；“37300”表示数据库服务器端口；“postgres”表示要访问的数据库名。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1：执行gs_dump，导出postgres数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md index 6be238a8..8ac78815 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md @@ -182,7 +182,7 @@ gs_dumpall [OPTION]... 指定备份进程并发数，取值范围为1~1000。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -g/-globals-only和-r/-roles-only不能同时使用。 - -g/-globals-only和-t/-tablespaces-only不能同时使用。 @@ -251,7 +251,7 @@ gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则， 使用gs_dumpall一次导出MogDB的所有数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 ```bash gs_dumpall -f backup/bkp2.sql -p 37300 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/7-gs_guc.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/7-gs_guc.md index 8e113038..edccf660 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/7-gs_guc.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/7-gs_guc.md @@ -31,7 +31,7 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为client，则会生成这两个文件。其中“client.key.cipher”存储用户密码的密文，“client.key.rand”存储的是加密因子。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 @@ -39,7 +39,7 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为source，则会生成这两个文件。其中“datasource.key.cipher”存储用户密码的密文，“datasource.key.rand”存储的是加密因子。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “datasource.key.cipher”和“datasource.key.rand”是创建Data Source对象时调用的密钥文件。gs_guc生成时即有读权限。使用前需将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。 @@ -75,7 +75,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc [ set | reload ] [-N NODE-NAME] [-I INSTANCE-NAME | -D DATADIR] -h "HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD authentication-options" ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: authentication-options支持以下选项： @@ -92,7 +92,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc [ set | reload ] [-N NODE-NAME] [-I INSTANCE-NAME | -D DATADIR] -h "HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD" ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要注释已经设置的认证策略，请使用-h “HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD”，不需要指定authentication-options。 @@ -114,7 +114,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc encrypt [-M keymode] -K password [-U username] -D DATADIR ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -K是用户指定的密码，gs_guc会对该密码进行长度（8<=len<=16）和密码复杂度要求，如果不满足，将会报错。 - -M是加密类型，当前仅支持server、client和source。默认值为server。 @@ -125,12 +125,12 @@ gs_guc工具由操作系统用户omm执行。 gs_guc generate [-o prefix] [-S cipherkey] -D DATADIR ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -o是输出的OBS类型的cipher和rand文件前缀名称，默认输出文件名前缀为obsserver。其内容仅支持数字、字母和下划线。 - -S是用户指定的密码，密码需要满足长度要求（8<=len<=16）和复杂度要求，如不满足将会报错。当其值为default时，会随机生成一段字符串作为密码，该密码长度为13。如果不带-S参数则会提示交互式输入密码。为了系统安全，推荐使用交互式输入密码方式。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - gs_guc工具不支持参数值中包含'#'的设置。可以使用vi工具通过手工修改配置文件来设置。 - 如果已经在环境变量中设置PGDATA，则可以省略-D参数。否则提示设置参数失败。 @@ -180,7 +180,7 @@ gs_guc工具由操作系统用户omm执行。 需要执行命令的MogDB实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 与”-I” 不能一块使用 @@ -188,7 +188,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的MogDB配置参数的名称和参数值。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 如果参数是一个字符串变量，则使用-c parameter=“'value'“或者使用-c “parameter = 'value'“。 - 当使用gs_guc set/reload为”log_directory” 恢复默认值时，其默认值会被置为具体的data目录。 @@ -243,7 +243,7 @@ gs_guc工具由操作系统用户omm执行。 设定该密码在数据库运行过程中，用于服务端(server)、客户端(client)还是创建Data Source对象时调用。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 @@ -263,7 +263,7 @@ gs_guc工具由操作系统用户omm执行。 指定要加密的用户，隶属于OS用户。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 @@ -285,7 +285,7 @@ gs_guc工具由操作系统用户omm执行。 取值范围: datanode。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。openGauss只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/8-gs_om.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/8-gs_om.md index c8f665a9..afc86e88 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/8-gs_om.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/8-gs_om.md @@ -202,13 +202,13 @@ gs_om参数可以分为如下几类： 显示详细信息。如果不指定，只提示该服务器是否正常。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 -all 显示MogDB所有节点信息。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 - 生成配置文件参数： diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/9-gs_restore.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/9-gs_restore.md index 1e462864..6a3a6a03 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/9-gs_restore.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/server-tools/9-gs_restore.md @@ -29,7 +29,7 @@ gs_restore工具由操作系统用户omm执行。 gs_restore [OPTION]... FILE ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - FILE没有短选项或长选项。用来指定归档文件所处的位置。 - 作为前提条件，需输入dbname或-l选项。不允许用户同时输入dbname和-l选项。 @@ -50,7 +50,7 @@ gs_restore [OPTION]... FILE 默认是标准输出。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f不能同-d一起使用。 @@ -194,7 +194,7 @@ gs_restore [OPTION]... FILE gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 -t table1 backup/MPPDB_backup.tar ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -t参数不支持schema_name.table_name的输入格式。 @@ -240,7 +240,7 @@ gs_restore [OPTION]... FILE 输出SET SESSION AUTHORIZATION命令，而非ALTER OWNER命令，用以决定对象归属。该选项使转储更加兼容标准，但通过参考转储中对象的记录，导入过程可能会有问题。使用SET SESSION AUTHORIZATION的转储要求必须是系统管理员，同时在导入前还需参考”SET SESSION AUTHORIZATION”，手工对导出文件的密码进行修改验证，只有这样才能进行正确的导入操作，相比之下，ALTER OWNER对权限要求较低。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: - 如果安装过程中有任何本地数据要添加到template1数据库，请谨慎将gs_restore的输出载入到一个真正的空数据库中；否则可能会因为被添加对象的定义被复制，而出现错误。要创建一个无本地添加的空数据库，需从template0而非template1复制，例如： @@ -250,7 +250,7 @@ gs_restore [OPTION]... FILE - gs_restore不能选择性地导入大对象；例如只能导入那些指定表的对象。如果某个归档形式包含大对象，那所有大对象都会被导入，或一个都不会被导入，如果它们通过-L、-t或其他选项被排除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1. -d/-dbname 和 -f/-file 不能同时使用； 2. -s/-schema-only 和 -a/-data-only不能同时使用； diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index e62fb15c..fceafe09 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -21,7 +21,7 @@ gaussdb [OPTION]... 客户端应用程序为了访问数据库，将连接（通过网络或本地）到一个正在运行的gaussdb进程。然后该进程实例会启动一个独立的线程来处理这个连接。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 一个gaussdb进程总是管理来自同一个数据库的数据。一个系统上可以同时运行多个gaussdb进程，只要使用不同的数据目录和不同的端口号。gaussdb启动时需要知道数据目录的位置，该位置必须通过-D指定。通常，-D直接指向由gs_initdb创建的数据库目录。 @@ -131,7 +131,7 @@ ps -ef | grep gaussdb 无法绑定端口的错误信息可能表明该端口已经被其他非MogDB进程使用。如果终止gaussdb后又马上用同一端口号运行它，也可能得到错误信息。这时，必须多等几秒，等操作系统关闭了该端口再试。最后，如果使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如：Unix版本认为低于1024的端口号是“可信任的”，因而只有Unix系统管理员可以使用它们。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果有可能，不要使用SIGKILL杀死主进程。这样会阻止gaussdb在退出前释放它持有的系统资源（例如共享内存和信号灯）。这样可能会影响到将来启动新的进程。 > - 可以使用SIGTERM，SIGINT，SIGQUIT信号正常结束服务器进程。第一个信号将等待所有的客户端退出后才退出。第二个将强制断开所有客户端，而第三个将不停止立刻退出，导致在重启时的恢复运行。 @@ -149,7 +149,7 @@ gaussdb --single -D /usr/local/pgsql/data other-options my_database 用-D给服务器提供正确的数据库目录的路径。同时还要声名已存在的特定数据库名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 通常，独立运行的服务器把换行符当做命令输入完成字符；要想把一行分成多行写，必需在除最后一个换行符以外的每个换行符前面敲一个反斜杠。 > - 如果使用了-j命令行选项，新行将不被当作命令结束符。此时服务器将从标准输入一直读取到EOF标志为止，然后把所有读到的内容当作一个完整的命令字符串看待，并且反斜杠与换行符也被当作普通字符来看待。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md index 400a0b5f..dfcb241e 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md @@ -11,7 +11,7 @@ date: 2021-06-07 通过gs_basebackup的压缩格式备份，主数据目录将被写入到一个名为 base.tar 的文件中，并且其他表空间将被以其 OID 命名。生成的数据文件，需要通过gs_tar命令作解压。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_tar命令当前仅支持解压通过gs_basebackup生成的归档文件。 > - 如果gs_basebackup制定了压缩等级，会生成以gz结尾的文件。此时需要使用gzip命令先解压缩生成tar包，之后才可以使用gs_tar命令解压生成的tar文件。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md index ff981a2a..7e7377e7 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md @@ -41,7 +41,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 只卸载本地主机。如果MogDB内某主机做单点卸载后，MogDB不能再做全量卸载。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_uninstall时，系统自动会删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 @@ -51,7 +51,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** 由于在执行gs_uninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: 由于在执行gs_uninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md index 84446687..b8c2e4a6 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md @@ -81,7 +81,7 @@ date: 2021-06-07 gs_upgradectl -t commit-upgrade -X XMLFILE [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一旦提交操作完成，则不能再执行回滚操作。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md index 98d6bdfb..60a4de5f 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md @@ -161,7 +161,7 @@ Expansion results: Expansion Finish. ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 对数据库集群进行扩容前，需要关注主机及新扩容节点cpu、io、网络等情况，不建议在硬件压力较大时执行扩容，否则可能导致扩容耗时较长甚至扩容失败。 > - 当原集群数据量较大时，在进行扩容操作前应当在主机上先执行checkpoint，否则可能导致扩容耗时较长甚至扩容失败。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md index 58ca858c..34dc5b48 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md @@ -329,7 +329,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **恢复目标相关参数(recovery_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： @@ -366,7 +366,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **留存相关参数(retention_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup和delete命令一起使用这些参数。 @@ -406,7 +406,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **固定备份相关参数(pinning_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -480,7 +480,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **连接相关参数(connection_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 @@ -522,7 +522,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **压缩相关参数(compression_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 @@ -551,7 +551,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **远程模式相关参数(remote_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md index 9c450a26..3c9634fa 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md @@ -11,7 +11,7 @@ date: 2021-06-07 gstrace是MogDB提供的用来跟踪内核代码执行路径，记录内核数据结构，分析代码性能的工具。Trace的有限点位和数据在版本中被固化，无法动态添加和删除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告**: 1. 对内核dump指定内存变量的数据用于诊断分析，不存在直接指定任意寄存器或者内存地址的行为。读取的内存地址均是在开发阶段硬编码，没有任意地读取或者修改寄存器或内存的操作。 2. Trace点可能涉及敏感数据，收集trace信息前需要同用户协商，授权和许可后方可收集。 @@ -19,7 +19,7 @@ gstrace是MogDB提供的用来跟踪内核代码执行路径，记录内核数 4. Trace仅用于诊断目的，开启trace将对性能产生一定影响，影响的大小视负载的高低，trace的模块而不同。 5. Trace工具的权限为0700，仅限于数据库用户读、写和执行。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md index 6fa8c2ff..5c52e3bc 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB部署成功后，在数据库运行的过程中，会遇到各种问题及异常状态。MogDB提供了gs_basebackup工具做基础的物理备份。gs_basebackup的实现目标是对服务器数据库文件的二进制进行拷贝，其实现原理使用了复制协议。远程执行gs_basebackup时，需要使用系统管理员账户。gs_basebackup当前支持热备份模式和压缩格式备份模式。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_basebackup仅支持主机和备机的全量备份，不支持增量。 > - gs_basebackup当前支持热备份模式和压缩格式备份模式。 @@ -143,7 +143,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 当数据库发生故障时需要从备份文件进行恢复。因为gs_basebackup是对数据库按二进制进行备份，因此恢复时可以直接拷贝替换原有的文件，或者直接在备份的库上启动数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若当前数据库实例正在运行，直接从备份文件启动数据库可能会存在端口冲突，这时需要修改配置文件的port参数，或者在启动数据库时指定一下端口。 > - 若当前备份文件为主备数据库，可能需要修改一下主备之间的复制连接。即配置文件中的postgresql.conf中的replconninfo1，replconninfo2等。 @@ -157,7 +157,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 5. 若数据库中存在链接文件，需要修改使其链接到正确的文件。 6. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 暂不支持备份文件增量恢复。 > - 恢复后需要检查数据库中的链接文件是否链接到正确的文件。 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md index 7cd3e7ab..6493861a 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md @@ -17,7 +17,7 @@ gs_initdb初始化数据库时，会创建数据库目录、生成系统表、 初始化数据库时会生成大量的系统表和视图，其中绝大部分都对任何数据库用户开放查看权限。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 **生成的数据库** diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md index b802abf5..09471a41 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md @@ -27,7 +27,7 @@ MogDB安装部署，要求用户指定配置文件，配置文件中会指定程 gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 - 显示帮助信息 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md index f653e2f5..57fa8098 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md @@ -73,7 +73,7 @@ MogDB提供了gs_postuninstall工具来帮助清理准备MogDB环境阶段所做 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md index d4ca6adc..9cc61d2d 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md @@ -57,7 +57,7 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 配置-U参数值时，字符串中不能包含”|“,”;“,”&“,”$“,”<“,”>”,”`”,”\\”,“'”,”\”,”{”,”}”,”(”,”)”,”[”,”]”,”~”,”*”,“?“特殊字符。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 配置-U参数值时，字符串中不能包含”|“,”;“,”&“,”$“,”<“,”>”,”`”,”\\”,“'”,”\”,”{”,”}”,”(”,”)”,”[”,”]”,”~”,”*”,“?“特殊字符。 - -G @@ -90,13 +90,13 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 - -sep-env-file=MPPRCFILE 保存环境变量的文件。如果指定该参数，表示将使用环境变量分离的版本。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 - -skip-hostname-set @@ -161,7 +161,7 @@ SYSLOGD_OPTIONS="-r -m 0" KLOGD_OPTIONS="-x" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该配置需要在MogDB每台机器上都要修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该配置需要在MogDB每台机器上都要修改。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md index 2c354529..ef47bfa1 100644 --- a/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md +++ b/product/zh/docs-mogdb/v2.0.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文件等操作。因此，安装前需要确保互信是连通的。MogDB提供了gs_sshexkey工具来帮助用户建立互信。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 ## 前提条件 @@ -75,7 +75,7 @@ MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文 主机列表，列出所有需要建立互信主机的IP。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 - -h diff --git a/product/zh/docs-mogdb/v2.0.0/security-guide/security/1-client-access-authentication.md b/product/zh/docs-mogdb/v2.0.0/security-guide/security/1-client-access-authentication.md index d918499e..0bf28a7a 100644 --- a/product/zh/docs-mogdb/v2.0.0/security-guide/security/1-client-access-authentication.md +++ b/product/zh/docs-mogdb/v2.0.0/security-guide/security/1-client-access-authentication.md @@ -219,13 +219,13 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | 参数 | 描述 | 取值范围 | | :------------ | :------------------------------------ | :-----------------------------------| -| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值:**on | -| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值:**off | +| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值**: on | +| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值**: off | | ssl_cert_file | 指定服务器证书文件，包含服务器端的公钥。服务器证书用以表明服务器身份的合法性，公钥将发送给对端用来对数据进行加密。 | 请以实际的证书名为准。其相对路径是相对于数据目录的。
**默认值**: server.crt | | ssl_key_file | 指定服务器私钥文件，用以对公钥加密的数据进行解密。 | 请以实际的服务器私钥名称为准。其相对路径是相对于数据目录的。
**默认值**: server.key | | ssl_ca_file | CA服务器的根证书。此参数可选择配置，需要验证客户端证书的合法性时才需要配置。 | 请以实际的CA服务器根证书名称为准。
**默认值**: cacert.pem | | ssl_crl_file | 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。 | 请以实际的证书吊销列表名称为准。
**默认值**: 空，表示没有吊销列表。 | -| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值:**ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | +| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值**: ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | 在客户端配置SSL认证相关的环境变量，详细信息请参见[表3](#表1.3.3)。 @@ -238,9 +238,9 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | :------------ | :---------------------------------------------------------- | :--------------------------------------------------------- | | PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如:
**`export PGSSLCERT='/home/omm/client.crt'`**
**默认值**: 空 | | PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如:
**`export PGSSLKEY='/home/omm/client.key'`**
**默认值**: 空 | -| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值:**prefer | -| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值:**空 | -| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值:**空 | +| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值**: prefer | +| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值**: 空 | +| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值**: 空 | 服务器端参数ssl、require_ssl与客户端参数sslmode配置组合结果如下: diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-2-br.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-2-br.md index 2d4cd4c4..4de25b01 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-2-br.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-2-br.md @@ -493,7 +493,7 @@ PTRACK：创建PTRACK增量备份。 **恢复目标相关参数(recovery_options)** - **说明：** + **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： @@ -530,7 +530,7 @@ PTRACK：创建PTRACK增量备份。 **留存相关参数(retention_options)** -**说明：** +**说明**: 可以和backup和delete命令一起使用这些参数。 @@ -570,7 +570,7 @@ PTRACK：创建PTRACK增量备份。 **固定备份相关参数(pinning_options)** -**说明：** +**说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -644,7 +644,7 @@ PTRACK：创建PTRACK增量备份。 **连接相关参数(connection_options)** -**说明：** +**说明**: 可以和backup命令一起使用这些参数。 @@ -686,7 +686,7 @@ PTRACK：创建PTRACK增量备份。 **压缩相关参数(compression_options)** - **说明：** + **说明**: 可以和backup命令一起使用这些参数。 @@ -715,7 +715,7 @@ PTRACK：创建PTRACK增量备份。 **远程模式相关参数(remote_options)** -**说明：** +**说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-3-br.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-3-br.md index 8fd404a9..6e605fdb 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-3-br.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/br/1-3-br.md @@ -387,7 +387,7 @@ gs_dump -p port_number -f dump1.sql AES128密钥长度必须是16字节。 -**说明：** +**说明**: 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md index 96f9fe71..6aae374b 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md @@ -11,7 +11,7 @@ date: 2021-03-04 测试使用了BenchmarkSQL（请参见**MOT样例TPC-C基准**），并且使用交互式SQL命令而不是存储过程来生成工作负载。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 评估MogDB MOT性能和磁盘性能的所有测试都使用了同步日志记录和在MOT中优化的group-commit=on版本。 @@ -134,7 +134,7 @@ MOT高吞吐量测试结果如下。 MOT的平均事务速度为2.5倍，MOT延迟为10.5ms，而基于磁盘的表延迟为23至25ms。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 **图 2** 低延迟（90th%，事务平均）性能基准 @@ -152,7 +152,7 @@ MOT完全集成到MogDB中，包括支持主备部署的高可用场景。WAL重 **MogDB（包括MOT）的RTO小于10秒。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ 另外，从[MOT高吞吐量](#MOT高吞吐量)的MOT中可以看出，在Arm/鲲鹏架构下，主从高可用场景复制开销仅为7%，在x86架构下仅为2%，而基于磁盘的表复制开销为2%。Arm/鲲鹏机型为20%，x86机型为15%。 @@ -173,7 +173,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。
diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md index e2f6c514..a5c02b38 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md @@ -74,7 +74,7 @@ MOT不需要任何特殊修改或安装新软件。但是，一些优化可以 MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完全驻留在内存中。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 服务器上必须有足够的物理内存以维持内存表的状态，并满足工作负载和数据的增长。所有这些都是在传统的基于磁盘的引擎、表和会话所需的内存之外的要求。因此，提前规划好足够的内存来容纳这些内容是非常有必要的。 @@ -94,7 +94,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 如果违反此限制，则调整MOT内存内部限制，最大可能地满足上述限制范围。该调整在启动时进行，并据此计算MOT最大内存值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 此时，会向服务器日志发出警告，如下所示： @@ -181,7 +181,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 在配置max_mot_local_memory设置和应用程序开发时，请考虑此场景。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**内存（MOT）**部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**内存（MOT）**部分。
@@ -209,7 +209,7 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 检查点之所以需要两倍大小，是因为快照会保存数据的全部大小到磁盘上，此外还应该为正在进行的检查点分配同样数量的空间。当检查点进程结束时，以前的检查点文件将被删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 - **日志记录** @@ -223,4 +223,4 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低延迟的驱动器上。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**存储（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**存储（MOT）**。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md index 3ff75fa1..654ded43 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md @@ -297,7 +297,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 阅读**总体原则**，根据需要查看和配置mot.conf文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 以下介绍了mot.conf文件中的各个部分，其包含的设置以及默认值。 @@ -395,7 +395,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 检查点由多个MOT引擎工作线程并行执行。工作线程的数量可能会大大影响整个检查点操作的整体性能，以及其它正在运行的事务的操作。为了实现较短的检查点持续时间，应使用更多线程，直至达到最佳数量（根据硬件和工作负载的不同而不同）。但请注意，如果这个数目太大，可能会对其他正在运行的事务的执行时间产生负面影响。尽可能低这个数字，以最小化对其他运行事务的运行时的影响。当此数目过高时，检查点持续时间会较长。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**MOT检查点**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**MOT检查点**。
@@ -405,7 +405,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 指定在检查点数据恢复期间要使用的工作线程数。每个MOT引擎工作线程在自己的核上运行，通过将不同的表读入内存，可以并行处理不同的表。缺省值为3，可将此参数设置为可处理的核数。恢复后，将停止并杀死这些线程。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**MOT恢复**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**MOT恢复**。
diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md index 3b987d89..ea3b811c 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md @@ -30,7 +30,7 @@ MogDB允许应用程序使用MOT和基于标准磁盘的表。MOT适用于最活 以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次： @@ -96,7 +96,7 @@ create FOREIGN table bmsql_oorder ( create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 有关MOT索引限制，请参见“MOT SQL覆盖和限制”的索引部分内容。 @@ -134,7 +134,7 @@ create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) 6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。 7. 恢复应用程序活动。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
@@ -301,7 +301,7 @@ MOT编译支持的特性和不支持的特性见下文。 在乐观并发控制（OCC）中，在COMMIT阶段前的事务期间（使用任何隔离级别）不会对记录进行锁定。这是一个能显著提高性能的强大优势。它的缺点是，如果另一个会话尝试更新相同的记录，则更新可能会失败。所以必须中止整个事务。这些所谓的更新冲突是由MOT在提交时通过版本检查机制检测到的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 这种更新冲突在常见的OLTP场景中非常少见，在使用MOT时尤其少见。但是，由于仍有可能发生这种情况，开发人员应该考虑使用事务重试代码来解决此问题。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md index ba7acdb6..0b3f1a37 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md @@ -133,7 +133,7 @@ WAL重做日志将保留所有表行修改，直到执行检查点（如上所 - group_commit_size：一组已提交的事务数。例如，16表示当同一组中的16个事务已由它们的客户端应用程序提交时，则针对16个事务中的每个事务，在磁盘的WAL重做日志中写入一个条目。 - group_commit_timeout：超时时间，单位为毫秒。例如，10表示在10毫秒之后，为同一组由客户端应用程序在最近10毫秒内提交的每个事务，在磁盘的WAL重做日志中写入一个条目。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**重做日志（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**重做日志（MOT）**。
@@ -414,7 +414,7 @@ MOT使用返回码（Return Code，RC）返回Postgres标准错误代码至封 MOT从内部返回Postgres代码（见下文）到数据库包，数据库封装根据标准的Postgres行为对其做出反应。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 **表 2** 返回给用户并记录到日志文件的错误 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md index 74790a9e..906bdff5 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md @@ -47,7 +47,7 @@ tpm-C指标是每分钟执行的新订单事务数。考虑到事务中所需的 tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 ## 系统级优化 @@ -65,7 +65,7 @@ tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 在下载的Java文件（与原始文件相比）中所做的唯一更改是注释错误日志打印，以进行序列化和重复键错误。这些错误在MOT中是正常的，因为MOT使用的是乐观并发控制（OCC）机制。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 基准测试使用标准交互式SQL模式执行，没有存储过程。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 基准测试使用标准交互式SQL模式执行，没有存储过程。 ## 运行基准 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md index a8ebefc5..fe966232 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md @@ -17,7 +17,7 @@ MOT旨在实现以下目标： - **线性扩容**：MOT提供事务性存储引擎，利用单个NUMA架构服务器的所有核，以提供近线性的扩容性能。这意味着MOT的目标是在机器的核数和性能提升倍数之间实现直接的、近线性的关系。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md index c7fa4915..529afcc5 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md @@ -9,7 +9,7 @@ date: 2021-03-04 通过大量研究，我们找到了最佳的并发控制机制，结论为：基于SILO的OCC算法是MOT中最符合ACID特性的OCC算法。SILO为满足MOT的挑战性需求提供了最好的基础。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 下面介绍MOT的并发控制机制。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md index f76fd7d2..11d0fb72 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md @@ -40,7 +40,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 - 在恢复期间，从最后一个已知或特定检查点加载数据；然后使用WAL重做日志完成从该点开始发生的数据更改。 - WAL重做日志将保留所有表行修改，直到执行一个检查点为止（如上所述）。然后可以截断日志，以减少恢复时间和节省磁盘空间。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。
@@ -86,7 +86,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 这样，将事务写入WAL更为有效，因为来自同一个槽位的所有缓冲区都一起写入磁盘。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 2. 在事务完成并且客户端应用程序发送Commit命令之后，事务重做日志条目将与属于同一组的其他事务一起序列化。 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md index e87cb814..2b1d3598 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md @@ -17,7 +17,7 @@ date: 2021-06-24 gs_om -t start ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 双机启动必须以双机模式启动, 若中间过程以单机模式启动, 则必须修复才能恢复双机关系, 用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 双机启动必须以双机模式启动, 若中间过程以单机模式启动, 则必须修复才能恢复双机关系, 用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 ## 停止MogDB @@ -29,7 +29,7 @@ date: 2021-06-24 gs_om -t stop ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 启停节点及AZ的操作请参见“参考指南 > 工具参考 > 服务端工具 > [gs_om](8-gs_om)”章节。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 启停节点及AZ的操作请参见“参考指南 > 工具参考 > 服务端工具 > [gs_om](8-gs_om)”章节。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/11-log-reference.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/11-log-reference.md index 818f1547..d27b6e17 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/11-log-reference.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/11-log-reference.md @@ -61,7 +61,7 @@ postgresql-创建时间.log 其中$GAUSSLOG默认为“/var/log/mogdb/_用户名_”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果使用om脚本部署时，则日志路径为 “/var/log/mogdb/_用户名_”。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果使用om脚本部署时，则日志路径为 “/var/log/mogdb/_用户名_”。 **日志文件命名格式** @@ -102,7 +102,7 @@ postgresql-创建时间.log 例如，系统中的第一个事务日志文件是000000010000000000000000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 **日志内容说明** diff --git a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md index 6686092c..89edf5f0 100644 --- a/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md +++ b/product/zh/docs-mogdb/v2.0.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md @@ -63,7 +63,7 @@ date: 2021-12-2 3. 获取软件安装包中的"MogDB-2.0.1-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -102,7 +102,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -144,7 +144,7 @@ date: 2021-12-2 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -155,7 +155,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -197,7 +197,7 @@ date: 2021-12-2 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > + 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md index ce91e6c2..108b333e 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md @@ -22,7 +22,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 2. 信息收集： @@ -68,7 +68,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 - Cgroups功能正常加载。 2. 执行业务查询语句。 @@ -84,7 +84,7 @@ date: 2021-05-19 ## 模型管理（系统管理员用户） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 模型管理操作需要在数据库正常的状态下进行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 模型管理操作需要在数据库正常的状态下进行。 1. 新增模型： @@ -96,7 +96,7 @@ date: 2021-05-19 INSERT INTO gs_opt_model values('rlstm', 'model_name', 'datname', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text'); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 具体模型参数设置请参考GS_OPT_MODEL。 - 目前 “template_name” 列只支持 “rlstm”; - “datname” 列请和用于模型使用和训练的数据库保持一致，否则无法使用。 - “model_name” 一列需要满足unique约束。 - 其他参数设置见产品文档最佳实践部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 具体模型参数设置请参考GS_OPT_MODEL。 - 目前 “template_name” 列只支持 “rlstm”; - “datname” 列请和用于模型使用和训练的数据库保持一致，否则无法使用。 - “model_name” 一列需要满足unique约束。 - 其他参数设置见产品文档最佳实践部分。 2. 修改模型参数： @@ -174,7 +174,7 @@ date: 2021-05-19 ## 模型预测 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 - 目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。 例：INSERT INTO gs_opt_model values('rlstm', 'default', 'mogdb', '127.0.0.1', 5000, 1000, 1, -1, 50, 500, 0 , false, false, '{**S**, T}', '{0,0}', '{0,0}', 'Text'); +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 - 目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。 例：INSERT INTO gs_opt_model values('rlstm', 'default', 'mogdb', '127.0.0.1', 5000, 1000, 1, -1, 50, 500, 0 , false, false, '{**S**, T}', '{0,0}', '{0,0}', 'Text'); 1. 调用explain接口： diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md index 90af6911..5cf3eec5 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-usage-guide.md @@ -25,7 +25,7 @@ date: 2021-05-19 调优程序是一个独立于数据库内核之外的工具，需要提供数据库及其所在实例的用户名和登录密码信息，以便控制数据库执行benchmark进行性能测试；在启动调优程序前，要求用户测试环境交互正常，能够正常跑通benchmark测试脚本、能够正常连接数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 调优程序X-Tuner包含三种运行模式，分别是: @@ -33,7 +33,7 @@ date: 2021-05-19 - train: 通过用户提供的benchmark信息，不断地进行参数修改和benchmark的执行。通过反复的迭代过程，训练强化学习模型，以便用户在后面通过tune模式加载该模型进行调优。 - tune: 使用优化算法进行数据库参数的调优，当前支持两大类算法，一种是深度强化学习，另一种是全局搜索算法（全局优化算法）。深度强化学习模式要求先运行train模式，生成训练后的调优模型，而使用全局搜索算法则不需要提前进行训练，可以直接进行搜索调优。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 **图 1** X-Tuner 结构图
@@ -46,7 +46,7 @@ X-Tuner 的整体架构如图1 X-Tuner 结构图所示，系统可以分为： - X-Tuner 主体逻辑模块：通过Enviroment模块进行封装，每一个step 就是一次调优过程。整个调优过程通过多个step进行迭代； - benchmark: 由用户指定的benchmark性能测试脚本，用于运行benchmark作业，通过跑分结果反映数据库系统性能优劣。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPCH这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPCH这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。
diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md index bf04caa3..c9a88102 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md @@ -40,7 +40,7 @@ X-Tuner 支持三种模式，分别是获取参数诊断报告的recommend模式 则可通过 -f connection.json 传递。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。
@@ -70,7 +70,7 @@ gs_xtuner recommend -f connection.json - checkpoint_avg_sync_time：数据库在checkpoint 时，平均每次同步刷新数据到磁盘的时长，单位是毫秒。 - load_average：平均**每个CPU核心**在1分钟、5分钟以及15分钟内的负载。一般地，该数值在1左右表明当前硬件比较匹配workload、在3左右表明运行当前作业压力比较大，大于5则表示当前硬件环境运行该workload压力过大（此时一般建议减少负载或升级硬件）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限）。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。清除统计信息的方法为： select pg_stat_reset_shared('bgwriter'); select pg_stat_reset(); +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限）。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。清除统计信息的方法为： select pg_stat_reset_shared('bgwriter'); select pg_stat_reset();
diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md index f05ba6bf..dae57f15 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/4-sqldiag-slow-sql-discovery/4-2-usage-guide.md @@ -61,7 +61,7 @@ gensim SQL语句执行耗时,SQL语句文本 ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 列之间的分隔符为',' + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 列之间的分隔符为',' 测试数据格式为： diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md index 9ccf5bd6..8c121e15 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/5-a-detection-status-monitoring/5-2-preparations.md @@ -133,7 +133,7 @@ forecast_interval = 100S forecast_period = 60S ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持的时间单位： 'S' -> second, 秒 'M' -> minute, 分 'H' -> hour,小时 'D' -> day,天 'W' -> week,周 > - minimum和maximum至少提供一个，不能都不提供。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md index bb6c009a..4748f6b2 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md @@ -15,7 +15,7 @@ date: 2021-05-19 | :-------------- | :------------ | :----------------------------- | | gs_index_advise | SQL语句字符串 | 针对单条查询语句生成推荐索引。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。
@@ -55,4 +55,4 @@ mogdb=# select * from gs_index_advise('select name, age, sex from t1 where age > CREATE INDEX idx1 on t1(age, sex); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md index 5e9661cc..70d49de3 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md @@ -118,7 +118,7 @@ date: 2021-05-19 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 执行EXPLAIN ANALYZE不会涉及虚拟索引功能。 > - 创建的虚拟索引是数据库实例级别的，各个会话（session)之间可共享设置，关闭会话后虚拟索引仍可存在，但是重启数据库后将被清空。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md index d47abd54..0f5b7e23 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-2-environment-deployment.md @@ -36,7 +36,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 pip install scipy ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果自行编译python，需要在**configure**脚本执行时加入**-enable-shared**参数； > - 如果系统中的python2使用的UCS4编码，自行编译python2时，还需要加入**-enable-unicode=ucs4**参数。 可以在系统中自带的python2下执行：“import sys；print sys.maxunicode”并查看结果，如果结果是65535，说明系统默认的是ucs2；如果结果是1114111，说明用的ucs4编码。 @@ -78,7 +78,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 其中， {YOUR_MADLIB_INSTALL_FOLDER}需要改为用户的实际安装路径。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： > > ```bash > ./configure -DCMAKE_INSTALL_PREFIX={YOUR_MADLIB_INSTALL_FOLDER} # your install folder @@ -111,7 +111,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 install为安装的命令，除此之外，还有reinstall（重新安装），uninstall（卸载）等命令可用。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 目标数据库必须存在。 > - IP请使用127.0.0.1，不要使用localhost。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md index 7a43305c..50de1436 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-3-usage-guide.md @@ -196,7 +196,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考审计。 当前PL/Python存储过程对并发执行不友好，建议串行执行。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。
@@ -204,7 +204,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考审计。 具体库内算法介绍和使用，可参考MADlib官方网站（MADlib文档）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当前仅支持机器学习算法，不支持深度学习（deep learning)模块。 > - 当前数据库不支持xml，所以pmml模块和相关功能不支持。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-4-best-practices.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-4-best-practices.md index ce0bd99f..906c3eb3 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-4-best-practices.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/AI-features/7-deepsql/7-4-best-practices.md @@ -161,7 +161,7 @@ create database test1 dbcompatibility='B'; 除了指定不同的核方法外，还可以指定迭代次数，初始参数，比如init_stepsize, max_iter, class_weight等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > ```sql > SET search_path="$user",public,madlib; diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/autonomous-transaction/4-restrictions.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/autonomous-transaction/4-restrictions.md index cbc933e0..32e3e04b 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/autonomous-transaction/4-restrictions.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/autonomous-transaction/4-restrictions.md @@ -42,7 +42,7 @@ $$; - 自治事务不支持执行嵌套 - **须知：** 在一个包含自治事务的函数中，通过perform、select、call等来显式执行另一个包含自治事务的函数或者存储过程是不被允许的，但是可以在最后return里显式调用另一个包含自治事务的函数或者存储过程。 + **须知**: 在一个包含自治事务的函数中，通过perform、select、call等来显式执行另一个包含自治事务的函数或者存储过程是不被允许的，但是可以在最后return里显式调用另一个包含自治事务的函数或者存储过程。 - 包含自治事务的函数，不支持参数传递的返回值 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md index 47294767..fd3efa67 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md @@ -28,5 +28,5 @@ java.sql.Connection是数据库连接接口。 | setClientInfo(Properties properties) | void | Yes | | setClientInfo(String name,String value) | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 接口内部默认使用自动提交模式，若通过setAutoCommit(false)关闭自动提交，将会导致后面执行的语句都受到显式事务包裹，数据库中不支持事务中执行的语句不能在此模式下执行。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md index 3a46627b..ad1d10ac 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md @@ -30,7 +30,7 @@ java.sql.CallableStatement是存储过程执行接口。 | getTimestamp(int parameterIndex) | Timestamp | Yes | | getObject(int parameterIndex) | Object | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不允许含有OUT参数的语句执行批量操作。 > - 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows , setFetchSize。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md index e1b33038..9aa8ee6b 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md @@ -33,7 +33,7 @@ java.sql.PreparedStatement是预处理语句接口。 | executeBatch() | int[] | Yes | | clearBatch() | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - addBatch()、execute()必须在clearBatch()之后才能执行。 > - 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除 。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md index a2e9c0b9..210e674e 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md @@ -45,7 +45,7 @@ java.sql.ResultSet是执行结果集接口。 | isFirst() | Boolean | Yes | | next() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一个Statement不能有多个处于"open"状态的ResultSet。 > - 用于遍历结果集(ResultSet)的游标(Cursor)在被提交后不能保持“open”的状态。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md index 1598a2a3..b19cd3f5 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md @@ -26,7 +26,7 @@ java.sql.Statement是SQL语句接口。 | setFetchSize(int rows) | void | Yes | | cancel() | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，会有性能损耗。 > - 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/4-loading-the-driver.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/4-loading-the-driver.md index e80994f3..72934f1b 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/4-loading-the-driver.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/4-loading-the-driver.md @@ -15,5 +15,5 @@ date: 2021-04-26 - 在JVM启动时参数传递: java -Djdbc.drivers=org.postgresql.Driver jdbctest - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 上述jdbctest为测试用例程序的名称。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/6-connecting-to-a-database-using-ssl.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/6-connecting-to-a-database-using-ssl.md index 75dec7a3..24d4d7ee 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/6-connecting-to-a-database-using-ssl.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/6-connecting-to-a-database-using-ssl.md @@ -50,7 +50,7 @@ date: 2021-04-26 表示允许127.0.0.1/32网段的客户端以ssl认证方式连接到MogDB服务器。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果服务端pg_hba.conf文件中METHOD配置为cert，则只有客户端使用证书（client.crt）中所设置的用户名（common name）才能够成功连接数据库。如果设置为md5、sm3或sha256则对连接数据库的用户没有限制。 > - MD5加密算法安全性低，存在安全风险，建议使用更安全的加密算法。 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md index d5dca34b..93c32080 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md @@ -135,7 +135,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: > > - MogDB数据库不支持带有输出参数的函数，也不支持存储过程和函数参数默认值。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 > diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md index 7dbb5a0a..fefdd9f3 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md @@ -42,7 +42,7 @@ PGresult：包含查询结果的对象指针。 - PQprepare创建一个为PQexecPrepared执行用的预备语句，本特性支持命令的重复执行，不需要每次都进行解析和规划。PQprepare仅在协议3.0及以后的连接中支持，使用协议2.0时，PQprepare将失败。 - 该函数从查询字符串创建一个名为stmtName的预备语句，该查询字符串必须包含一个SQL命令。stmtName可以是”“来创建一个未命名的语句，在这种情况下，任何预先存在的未命名的语句都将被自动替换；否则，如果在当前会话中已经定义了语句名称，则这是一个错误。如果使用了任何参数，那么在查询中将它们称为$1,$2等。nParams是在paramTypes[]数组中预先指定类型的参数的数量。（当nParams为0时，数组指针可以为NULL） paramTypes[]通过OID指定要分配给参数符号的数据类型。如果paramTypes为NULL ，或者数组中的任何特定元素为零，服务器将按照对非类型化字面字符串的相同方式为参数符号分配数据类型。另外，查询可以使用数字高于nParams的参数符号；还将推断这些符号的数据类型。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过执行SQLPREPARE语句，还可以创建与PQexecPrepared一起使用的预备语句。此外，虽然没有用于删除预备语句的libpq函数，但是SQL DEALLOCATE语句可用于此目的。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md index 40b9d44f..01bbbdfd 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md @@ -34,7 +34,7 @@ PGresult：包含查询结果的对象指针。 应该调用PQresultStatus函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回PGRES_FATAL_ERROR）。使用PQerrorMessage获取有关错误的更多信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 命令字符串可以包括多个SQL命令（用分号分隔）。在一个PQexec调用中发送的多个查询是在一个事务里处理的，除非在查询字符串里有明确的BEGIN/COMMIT命令把整个字符串分隔成多个事务。请注意，返回的PGresult结构只描述字符串里执行的最后一条命令的结果，如果有一个命令失败，那么字符串处理的过程就会停止，并且返回的PGresult会描述错误条件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md index 0283e578..6c55cfff 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md @@ -11,7 +11,7 @@ postgres_fdw是一款开源插件，其代码随PostgreSQL源码一同发布。M postgres_fdw插件默认参与编译，使用安装包安装好MogDB后，可直接使用postgres_fdw，无须其他操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 ## 使用postgres_fdw diff --git a/product/zh/docs-mogdb/v2.0.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md b/product/zh/docs-mogdb/v2.0.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md index fc7fac0c..a8519147 100644 --- a/product/zh/docs-mogdb/v2.0.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md +++ b/product/zh/docs-mogdb/v2.0.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md @@ -13,7 +13,7 @@ MogDB可以通过调用SQL函数，进行创建、删除、推进逻辑复制槽 - 逻辑日志目前从主机节点中抽取，默认关闭SSL连接，如果进行逻辑复制，需要先上配置GUC参数ssl=on。 - > **说明：** 为避免安全风险，请保证启用SSL连接。 + > **说明**: 为避免安全风险，请保证启用SSL连接。 - 设置GUC参数wal_level=logical。 diff --git a/product/zh/docs-mogdb/v2.0.1/faqs/deployment-and-maintenance-faqs.md b/product/zh/docs-mogdb/v2.0.1/faqs/deployment-and-maintenance-faqs.md index b3e87570..5a9a2773 100644 --- a/product/zh/docs-mogdb/v2.0.1/faqs/deployment-and-maintenance-faqs.md +++ b/product/zh/docs-mogdb/v2.0.1/faqs/deployment-and-maintenance-faqs.md @@ -285,7 +285,7 @@ Checking directory. print(staticConfigPath_dn) ``` - > **说明：**需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 + > **说明**: 需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 2. 执行如下命令生成集群静态配置文件。 diff --git a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/1-installation-preparation.md b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/1-installation-preparation.md index e155a3a7..4e6cbf7f 100644 --- a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/1-installation-preparation.md +++ b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/1-installation-preparation.md @@ -200,7 +200,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** *\$地区/\$时区*为需要设置时区的信息，例如：Asia/Shanghai。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: *\$地区/\$时区*为需要设置时区的信息，例如：Asia/Shanghai。 3. 使用**date -s**命令将各数据库节点的时间设置为统一时间，举例如下。 @@ -210,7 +210,7 @@ vim /etc/profile **(可选）关闭swap交换内存** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 diff --git a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md index ceac75a4..65d92e7c 100644 --- a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md @@ -37,7 +37,7 @@ date: 2021-06-11 sh install.sh -w xxxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。密码应包括大小写、字符、数字。 > - -p：指定的MogDB端口号, 如不指定，默认为5432。 diff --git a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md index 70d1ba1d..99d73d68 100644 --- a/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md +++ b/product/zh/docs-mogdb/v2.0.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md @@ -37,7 +37,7 @@ date: 2021-06-11 sh install.sh -w xxxx --multinode ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。 密码应包括大小写、字符、数字。 > - -p：指定的MogDB主节点端口号, 默认5432。备节点端口号会使用主端口号+200，默认5632。 diff --git a/product/zh/docs-mogdb/v2.0.1/installation-guide/standard-installation/3-modifying-os-configuration.md b/product/zh/docs-mogdb/v2.0.1/installation-guide/standard-installation/3-modifying-os-configuration.md index 669ed0d7..fd02ecae 100644 --- a/product/zh/docs-mogdb/v2.0.1/installation-guide/standard-installation/3-modifying-os-configuration.md +++ b/product/zh/docs-mogdb/v2.0.1/installation-guide/standard-installation/3-modifying-os-configuration.md @@ -82,7 +82,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `\$地区/$时区`为需要设置时区的信息，例如：Asia_Shanghai。 使用date -s命令将各主机的时间设置为统一时间，举例如下。 @@ -91,11 +91,11 @@ cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime date -s "Sat Sep 27 16:00:07 CST 2020" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以通过date命令查询主机时区。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以通过date命令查询主机时区。 ## （可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 @@ -217,7 +217,7 @@ ifconfig 网卡编号 mtu 值 ssh xxx.xxx.xxx.xxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > xxx.xxx.xxx.xxx为安装MogDB环境的IP地址。 diff --git a/product/zh/docs-mogdb/v2.0.1/performance-tuning/1-system/4-configuring-smp.md b/product/zh/docs-mogdb/v2.0.1/performance-tuning/1-system/4-configuring-smp.md index 55136378..d8b0f2c9 100644 --- a/product/zh/docs-mogdb/v2.0.1/performance-tuning/1-system/4-configuring-smp.md +++ b/product/zh/docs-mogdb/v2.0.1/performance-tuning/1-system/4-configuring-smp.md @@ -105,7 +105,7 @@ SMP架构是一种利用富余资源来换取时间的方案，计划并行之 mogdb=# SET query_dop = 1; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 资源许可的情况下，并行度越高，性能提升效果越好。 > - SMP并行度支持会话级设置，推荐客户在执行符合要求的查询前，打开smp，执行结束后，关闭smp。以免在业务峰值时，对业务造成冲击。 diff --git a/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-cli-to-access-mogdb.md b/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-cli-to-access-mogdb.md index 913aa86e..e0f297dd 100644 --- a/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-cli-to-access-mogdb.md +++ b/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-cli-to-access-mogdb.md @@ -67,7 +67,7 @@ date: 2021-12-1 3. 获取软件安装包中的"MogDB-2.0.1-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -106,7 +106,7 @@ date: 2021-12-1
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -148,7 +148,7 @@ date: 2021-12-1 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -159,7 +159,7 @@ date: 2021-12-1
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -201,7 +201,7 @@ date: 2021-12-1 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md b/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md index 11b9bfbb..1c64faa8 100644 --- a/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md +++ b/product/zh/docs-mogdb/v2.0.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb.md @@ -64,7 +64,7 @@ Data Studio还提供SQL助手用于在SQL终端和PL/SQLViewer中执行各种查 Java 1.8.0_181或更高版本。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > * 请参阅[https://java.com/en/download/help/path.xml](https://java.com/en/download/help/path.xml)以设置Java Home路径。 > * 保证最佳体验的情况下，推荐的最小屏幕分辨率是1080 x 768。低于此分辨率，界面会异常。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md index 6b547bbe..ad78e07f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md @@ -57,7 +57,7 @@ date: 2021-06-07 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 - hll_hash_smallint(smallint, int32) @@ -480,7 +480,7 @@ HLL（HyperLogLog）主要存在三种模式Explicit，Sparse，Full。当数据 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 ## 功能函数 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md index 4de03389..dabcd944 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md @@ -355,7 +355,7 @@ date: 2021-04-20 返回值类型：Boolean - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见[表6](#cuowubiao)。 > - 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/25-statistics-information-functions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/25-statistics-information-functions.md index 792f4aef..3518d225 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/25-statistics-information-functions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/25-statistics-information-functions.md @@ -966,7 +966,7 @@ date: 2021-04-20 返回值类型：record - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 - DBE_PERF.get_global_session_time() diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/28-ai-feature-functions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/28-ai-feature-functions.md index d689cc76..fdd8a54c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/28-ai-feature-functions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/functions-and-operators/28-ai-feature-functions.md @@ -77,7 +77,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - encode_plan_node(optname text, orientation text, strategy text, options text, dop int8, quals text, projection text) @@ -87,7 +87,7 @@ date: 2021-04-20 返回值类型：text。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数为内部功能调用函数，不建议用户直接使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数为内部功能调用函数，不建议用户直接使用。 - model_train_opt(template text, model text) @@ -99,7 +99,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - track_model_train_opt(ip text, port text) @@ -111,7 +111,7 @@ date: 2021-04-20 示例请参见使用指导。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数当前版本不可用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数当前版本不可用。 - encode_feature_perf_hist(datname text) diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md index f80b8ad6..38fe73a1 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 有效值为stderr、csvlog、syslog。 @@ -27,7 +27,7 @@ date: 2021-04-20 local0.* /var/log/postgresql ``` -**默认值:**stderr +**默认值**: stderr ## logging_collector @@ -40,12 +40,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 将服务器日志发送到stderr时可以不使用logging_collector参数，此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难，只适用于较小的日志容量。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启日志收集功能。 - off表示关闭日志收集功能。 -**默认值:**on +**默认值**: on ## log_directory @@ -62,9 +62,9 @@ date: 2021-04-20 > 合法路径: 用户对此路径有读写权限 > 非法路径: 用户对此路径无读写权限 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**安装时指定。 +**默认值**: 安装时指定。 ## log_filename @@ -77,13 +77,13 @@ date: 2021-04-20 > - 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 > - 当log_destination设为csvlog时，系统会生成附加了时间戳的日志文件名，文件格式为csv格式，例如"server_log.1093827753.csv"。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgresql-%Y-%m-%d_%H%M%S.log +**默认值**: postgresql-%Y-%m-%d_%H%M%S.log ## log_file_mode -**参数说明:**[logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 +**参数说明:** [logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -92,14 +92,14 @@ date: 2021-04-20 > - 使用此选项前请设置log_directory，将日志存储到数据目录之外的地方。 > - 因日志文件可能含有敏感数据，故不能将其设为对外可读。 -**取值范围:**整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 +**取值范围**: 整型，0000～0777 （8进制计数，转化为十进制 0 ~ 511）。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 0600表示只允许服务器管理员读写日志文件。 > - 0640表示允许管理员所在用户组成员只能读日志文件。 -**默认值:**0600 +**默认值**: 0600 ## log_truncate_on_rotation @@ -111,12 +111,12 @@ date: 2021-04-20 假设日志需要保留7天，每天生成一个日志文件，日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。设置方法: 将log_filename设置为server_log.%a ，log_truncate_on_rotation设置为on，log_rotation_age设置为1440，即日志有效时间为1天。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on表示MogDB以覆盖写入的方式写服务器日志消息。 - off表示MogDB将日志消息附加到同名的现有日志文件上。 -**默认值:**off +**默认值**: off ## log_rotation_age @@ -124,9 +124,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 +**取值范围**: 整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 -**默认值:**1440(min) +**默认值**: 1440(min) ## log_rotation_size @@ -134,13 +134,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX / 1024，单位为kB。 +**取值范围**: 整型，0 ~ INT_MAX / 1024，单位为kB。 0表示关闭基于容量的新日志文件的创建。 建议该值大小设置级别至少为MB级,利于日志文件的及时划分。 -**默认值:**20MB +**默认值**: 20MB ## syslog_facility @@ -148,19 +148,19 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 +**取值范围**: 枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 -**默认值:**local0 +**默认值**: local0 ## syslog_ident -**参数说明:**[log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 +**参数说明:** [log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## event_source @@ -168,6 +168,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PostgreSQL +**默认值**: PostgreSQL diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md index 22059d3d..8aec66b7 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md @@ -16,9 +16,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当client_min_messages和[log_min_messages](#log_min_messages)取相同值时，其值所代表的级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 -**默认值:**notice +**默认值**: notice ## log_min_messages @@ -29,9 +29,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当[client_min_messages](#client_min_messages)和log_min_messages取相同值log时所代表的消息级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**warning +**默认值**: warning ## log_min_error_statement @@ -39,14 +39,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为error ，表示导致错误、日志消息、致命错误、panic的语句都将被记录。 > - 设置为panic，表示关闭此特性。 -**默认值:**error +**默认值**: error ## log_min_duration_statement @@ -59,13 +59,13 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当此选项与log_statement同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用log_line_prefix记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。 -**取值范围:**整型，-1 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，-1 ~ INT_MAX，单位为毫秒。 - 设置为250，所有运行时间不短于250ms的SQL语句都会被记录。 - 设置为0，输出所有语句的持续时间。 - 设置为-1，关闭此功能。 -**默认值:**30min +**默认值**: 30min ## backtrace_min_messages @@ -76,11 +76,11 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 -**默认值:**panic +**默认值**: panic [表1](#信息严重程度分类)解释MogDB中使用的消息安全级别。当日志输出到syslog或者eventlog(仅windows环境下, MogDB版本不涉及该参数)时，MogDB进行如表中的转换。 @@ -106,10 +106,10 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数以毫秒为单位的，建议在使用过程中设置值为1000的整数倍，即设置值以秒为最小单位。该参数所控制的性能日志文件以prf为扩展名，文件放置在$GAUSSLOG/gs_profile/ 目录下面，其中node_name是由postgres.conf文件中的pgxc_node_name的值，不建议外部使用该参数。 -**取值范围:**0~2147483647，单位为毫秒（ms）。 +**取值范围**: 0~2147483647，单位为毫秒（ms）。 当设置为0时，当前会话不再输出性能日志数据。当设置为非0时，当前会话按照指定的时间周期进行输出性能日志数据。 该参数设置得越小，输出的日志数据越多，对性能的负面影响越大。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md index de73e1e2..be2c1862 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_rewritten @@ -26,12 +26,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ## debug_print_plan @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值:**off +**默认值**: off ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示进行缩进。 - off表示不进行缩进。 -**默认值:**on +**默认值**: on ## log_checkpoints @@ -71,12 +71,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量。 - off表示关闭此参数时，服务器日志消息包含不涉及检查点和重启点的统计量。 -**默认值:**off +**默认值**: off ## log_connections @@ -87,12 +87,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 有些客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中重复的"connection receive"（收到连接请求）并不意味着一定是问题。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_disconnections @@ -100,12 +100,12 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值:**off +**默认值**: off ## log_duration @@ -113,12 +113,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - 设置为off ，该选项与log_min_duration_statement的不同之处在于log_min_duration_statement强制记录查询文本。 - 设置为on并且log_min_duration_statement大于零，记录所有持续时间，但是仅记录超过阈值的语句。这可用于在高负载情况下搜集统计信息。 -**默认值:**on +**默认值**: on ## log_error_verbosity @@ -126,13 +126,13 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - terse输出不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose输出包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 - default输出包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录，不包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 -**默认值:**default +**默认值**: default ## log_hostname @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以同时记录主机名。 - off表示不可以同时记录主机名。 -**默认值:**on +**默认值**: on ## log_line_prefix @@ -188,9 +188,9 @@ FROM pg_stat_activity; - 当log_line_prefix设置为非空值时，请将其最后一个字符作为一个独立的段，以此来直观地与后续的日志进行区分，也可以使用一个标点符号。 - Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**%m %c %d %p %a %x %n %e +**默认值**: %m %c %d %p %a %x %n %e ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -202,12 +202,12 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录此信息。 - off表示不记录此信息。 -**默认值:**off +**默认值**: off ## log_statement @@ -219,14 +219,14 @@ FROM pg_stat_activity; 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，在执行阶段之前（语法分析或规划阶段）同样不会记录。将log_min_error_statement设为ERROR或更低才能记录这些语句。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - none表示不记录语句。 - ddl表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 - mod表示记录所有DDL语句，还包括数据修改语句INSERT、UPDATE、DELETE、TRUNCATE和COPY FROM 。 - all表示记录所有语句，PREPARE、EXECUTE和EXPLAIN ANALYZE语句也同样被记录。 -**默认值:**none +**默认值**: none ## log_temp_files @@ -234,13 +234,13 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为-1，最大值2147483647，单位KB。 +**取值范围**: 整型，最小值为-1，最大值2147483647，单位KB。 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 值0 表示记录所有的临时文件的删除信息。 - 值-1 表示不记录任何临时文件的删除信息。 -**默认值:**-1 +**默认值**: -1 ## log_timezone @@ -248,9 +248,9 @@ FROM pg_stat_activity; 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**PRC +**默认值**: PRC ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** @@ -262,9 +262,9 @@ gs_initdb进行相应系统环境设置时会对默认值进行修改。 该参数属于USERSET类型参数，设置请参考表[GUC参数分类](30-appendix)中对应设置的方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 +**默认值**: 所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,OPFUSION,VEC_EXECUTOR,LLVM,OPT,OPT_REWRITE,OPT_JOIN,OPT_AGG,OPT_SUBPLAN,OPT_SETOP,OPT_SKEW,UDF,COOP_ANALYZE,WLMCP,ACCELERATE,,PLANHINT,SNAPSHOT,XACT,HANDLE,CLOG,EC,REMOTE,CN_RETRY,PLSQL,TEXTSEARCH,SEQ,REDO,FUNCTION,PARSER,INSTR,INCRE_CKPT,DBL_WRT,RTO,HEARTBEAT)。 **设置方法**: 首先，可以通过SHOW logging_module来查看哪些模块是支持可控制的。例如，查询输出结果为: @@ -312,7 +312,7 @@ mogdb=# show logging_module; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - off表示不打开该功能。 - log表示打开该功能，可以在数据库节点的执行计划中看到没有查询优化的具体原因。 @@ -321,7 +321,7 @@ mogdb=# show logging_module; 提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，log_min_messages设置成debug4级别，logging_module设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。 -**默认值:**off +**默认值**: off ## enable_debug_vacuum diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/11-alarm-detection.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/11-alarm-detection.md index 1ec65098..a19abebb 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/11-alarm-detection.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/11-alarm-detection.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许打开告警检测线程。 - off表示不允许打开告警检测线程。 -**默认值:**on +**默认值**: on ## connection_alarm_rate @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0~1.0 +**取值范围**: 浮点型，0.0~1.0 -**默认值:**0.9 +**默认值**: 0.9 ## alarm_report_interval @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为秒。 +**取值范围**: 整型，单位为秒。 -**默认值:**10 +**默认值**: 10 ## alarm_component @@ -48,26 +48,26 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**/opt/huawei/snas/bin/snas_cm_cmd +**默认值**: /opt/huawei/snas/bin/snas_cm_cmd ## table_skewness_warning_threshold -**参数说明**：设置用于表倾斜告警的阈值。 +**参数说明**: 设置用于表倾斜告警的阈值。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～1 +**取值范围**: 浮点型，0～1 -**默认值**：1 +**默认值**: 1 ## table_skewness_warning_rows -**参数说明**：设置用于表倾斜告警的行数。 +**参数说明**: 设置用于表倾斜告警的行数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：100000 +**默认值**: 100000 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md index f536426c..4481362a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 -**默认值:**on +**默认值**: on ## track_counts @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 在AutoVacuum自动清理进程中选择清理的数据库时，需要数据库的统计数据，故默认值设为on。 -**默认值:**on +**默认值**: on ## track_io_timing @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 - off表示关闭收集功能。 -**默认值:**off +**默认值**: off ## track_functions @@ -62,13 +62,13 @@ date: 2021-04-20 > > 当SQL语言函数设置为调用查询的"内联"函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - pl表示只追踪过程语言函数。 - all表示追踪SQL语言函数。 - none表示关闭函数追踪功能。 -**默认值:**none +**默认值**: none ## track_activity_query_size @@ -76,9 +76,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～102400 +**取值范围**: 整型，100～102400 -**默认值:**1024 +**默认值**: 1024 ## stats_temp_directory @@ -90,9 +90,9 @@ date: 2021-04-20 > > 将其设置为一个基于RAM的文件系统目录会减少实际的I/O开销并可以提升其性能。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_stat_tmp +**默认值**: pg_stat_tmp ## track_thread_wait_status_interval @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0～1天，单位为min。 +**取值范围**: 0～1天，单位为min。 -**默认值:**30min +**默认值**: 30min ## enable_save_datachanged_timestamp @@ -110,12 +110,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许收集相关操作对表数据改动的时间。 - off表示禁止收集相关操作对表数据改动的时间。 -**默认值:**on +**默认值**: on ## track_sql_count @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启计数功能。 - off表示关闭计数功能。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md index 9952a976..023ffa7e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md @@ -27,7 +27,7 @@ date: 2021-04-20 > - log_statement_stats记录总的语句统计数据，而其他的只记录针对每个模块的统计数据。 > - log_statement_stats不能和其他任何针对每个模块统计的选项一起打开。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启记录性能统计数据的功能。 - off表示关闭记录性能统计数据的功能。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/13-load-management.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/13-load-management.md index a681044e..a0fec023 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/13-load-management.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/13-load-management.md @@ -30,7 +30,7 @@ date: 2021-04-20 > select gs_wlm_readjust_user_space(0); > ``` -**默认值:**off +**默认值**: off ## cgroup_name @@ -46,7 +46,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**InvalidGroup +**默认值**: InvalidGroup ## cpu_collect_timer @@ -58,7 +58,7 @@ date: 2021-04-20 **取值范围**: 整型，1 ～ INT_MAX， 单位为秒。 -**默认值:**30 +**默认值**: 30 ## memory_tracking_mode @@ -73,7 +73,7 @@ date: 2021-04-20 - executor，生成统计文件，包含执行层使用过的所有已分配内存的上下文信息。 - fullexec，生成文件包含执行层申请过的所有内存上下文信息。 -**默认值:**none +**默认值**: none ## memory_detail_tracking @@ -83,7 +83,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -100,7 +100,7 @@ date: 2021-04-20 - on表示打开资源监控。 - off表示关闭资源监控。 -**默认值:**on +**默认值**: on ## enable_resource_record @@ -113,7 +113,7 @@ date: 2021-04-20 - on表示开启资源监控记录归档功能。 - off表示关闭资源监控记录归档功能。 -**默认值:**off +**默认值**: off ## enable_logical_io_statistics @@ -126,7 +126,7 @@ date: 2021-04-20 - on表示开启资源监控逻辑IO统计功能。 - off表示关闭资源监控逻辑IO统计功能。 -**默认值:**on +**默认值**: on ## enable_user_metric_persistent @@ -167,7 +167,7 @@ date: 2021-04-20 - on表示开启实例资源监控转存功能。 - off表示关闭实例资源监控转存功能。 -**默认值:**on +**默认值**: on ## instance_metric_retention_time @@ -180,7 +180,7 @@ date: 2021-04-20 - 值等于0时，实例历史资源监控数据将永久保存。 - 值大于0时，实例历史资源监控数据将保存对应设置天数。 -**默认值:**7 +**默认值**: 7 ## resource_track_level @@ -194,7 +194,7 @@ date: 2021-04-20 - query，开启query级别资源监控功能。 - operator，开启query级别和算子级别资源监控功能。 -**默认值:**query +**默认值**: query ## resource_track_cost @@ -208,7 +208,7 @@ date: 2021-04-20 - 值大于或等于0时，值大于或等于0且小于等于9时，对执行代价大于等于10的语句进行资源监控。 - 值大于或等于10时，对执行代价超过该参数值的语句进行资源监控。 -**默认值:**100000 +**默认值**: 100000 ## resource_track_duration @@ -221,7 +221,7 @@ date: 2021-04-20 - 值为0时，资源监控实时视图中记录的所有语句都进行历史信息归档。 - 值大于0时，资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。 -**默认值:**1min +**默认值**: 1min ## disable_memory_protect @@ -234,7 +234,7 @@ date: 2021-04-20 - on表示禁止内存保护功能。 - off表示启动内存保护功能。 -**默认值:**off +**默认值**: off ## query_band @@ -244,7 +244,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空 +**默认值**: 空 ## enable_bbox_dump @@ -257,7 +257,7 @@ date: 2021-04-20 - on表示打开黑匣子功能。 - off表示关闭黑匣子功能。 -**默认值:**off +**默认值**: off ## bbox_dump_count @@ -267,7 +267,7 @@ date: 2021-04-20 **取值范围**: 整型，1～20 -**默认值:**8 +**默认值**: 8 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -281,7 +281,7 @@ date: 2021-04-20 **取值范围**: 字符型 -**默认值:**空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 +**默认值**: 空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 ## enable_ffic_log @@ -294,7 +294,7 @@ date: 2021-04-20 - on表示打开FFIC功能。 - off表示关闭FFIC功能。 -**默认值:**on +**默认值**: on ## io_limits @@ -304,7 +304,7 @@ date: 2021-04-20 **取值范围**: 整型，0～1073741823 -**默认值:**0 +**默认值**: 0 ## io_priority @@ -319,7 +319,7 @@ date: 2021-04-20 - Medium: 表示限制iops为该作业原始触发数值的20%。 - High: 表示限制iops为该作业原始触发数值的50%。 -**默认值:**None +**默认值**: None ## io_control_unit @@ -331,7 +331,7 @@ date: 2021-04-20 **取值范围**: 整型，1000~1000000 -**默认值:**6000 +**默认值**: 6000 ## session_respool @@ -347,7 +347,7 @@ date: 2021-04-20 **取值范围**: string类型，通过create resource pool所设置的资源池。 -**默认值:**invalid_pool +**默认值**: invalid_pool ## session_statistics_memory @@ -357,7 +357,7 @@ date: 2021-04-20 **取值范围**: 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**5MB +**默认值**: 5MB ## topsql_retention_time @@ -380,7 +380,7 @@ date: 2021-04-20 **取值范围**: 整型，10 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值:**10MB +**默认值**: 10MB ## transaction_pending_time @@ -393,4 +393,4 @@ date: 2021-04-20 - 值为-1或0: 事务块语句和存储过程语句无超时判断，排队至资源满足可执行条件。 - 值大于0: 事务块语句和存储过程语句排队超过所设数值的时间后，无视当前资源情况强制执行。 -**默认值:**0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/14-automatic-vacuuming.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/14-automatic-vacuuming.md index 87905df1..1f0ad172 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/14-automatic-vacuuming.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/14-automatic-vacuuming.md @@ -24,12 +24,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理进程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启数据库自动清理进程。 - off表示关闭数据库自动清理进程。 -**默认值:**on +**默认值**: on ## autovacuum_mode @@ -37,14 +37,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - analyze表示只做autoanalyze。 - vacuum表示只做autovacuum。 - mix表示autoanalyze和autovacuum都做。 - none表示二者都不做。 -**默认值:**mix +**默认值**: mix ## autoanalyze_timeout @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**int类型，单位是s，0~2147483。 +**取值范围**: int类型，单位是s，0~2147483。 -**默认值:**5min（即300s） +**默认值**: 5min（即300s） ## autovacuum_io_limits @@ -62,9 +62,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 +**取值范围**: 整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 -**默认值:**-1 +**默认值**: -1 ## log_autovacuum_min_duration @@ -76,13 +76,13 @@ date: 2021-04-20 将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。 -**取值范围:**整型，最小值为-1，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为-1，最大值为2147483647，单位为毫秒。 - 当参数设置为0时，表示所有的自动清理操作都记录到日志中。 - 当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。 - 当参数设置为非-1时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。 -**默认值:**-1 +**默认值**: -1 ## autovacuum_max_workers @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 +**取值范围**: 整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 -**默认值:**3 +**默认值**: 3 ## autovacuum_naptime @@ -100,9 +100,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为s，最小值为1，最大值为2147483。 +**取值范围**: 整型，单位为s，最小值为1，最大值为2147483。 -**默认值:**10min（即600s） +**默认值**: 10min（即600s） ## autovacuum_vacuum_threshold @@ -110,9 +110,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_analyze_threshold @@ -120,9 +120,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值:**50 +**默认值**: 50 ## autovacuum_vacuum_scale_factor @@ -130,9 +130,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.2 +**默认值**: 0.2 ## autovacuum_analyze_scale_factor @@ -140,9 +140,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值:**0.1 +**默认值**: 0.1 ## autovacuum_freeze_max_age @@ -155,7 +155,7 @@ date: 2021-04-20 **取值范围: 长**整型，100 000～576 460 752 303 423 487 -**默认值:**20000000000 +**默认值**: 20000000000 ## autovacuum_vacuum_cost_delay @@ -163,9 +163,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 +**取值范围**: 整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 -**默认值:**20ms +**默认值**: 20ms ## autovacuum_vacuum_cost_limit @@ -173,14 +173,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 +**取值范围**: 整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 -**默认值:**-1 +**默认值**: -1 ## defer_csn_cleanup_time **参数说明:**用来指定本地回收时间间隔，单位为毫秒（ms）。 -**取值范围:**整型，0~INT_MAX。 +**取值范围**: 整型，0~INT_MAX。 **默认值**: 5s（即5000ms） diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md index 6670e91c..fef11502 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md @@ -20,7 +20,7 @@ date: 2021-04-20 - 当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。 - 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -28,7 +28,7 @@ date: 2021-04-20 > - 设置为空串（"）的时候，系统会自动转换成一对双引号。 > - 设置的内容中包含双引号，系统会认为是不安全字符，会将每个双引号转换成一对双引号。 -**默认值:**\"$user",public +**默认值**: \"$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -39,9 +39,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**"\$user",public +**默认值**: "\$user",public > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，\$user将被忽略。 @@ -58,9 +58,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空表示使用默认表空间。 +**取值范围**: 字符串，其中空表示使用默认表空间。 -**默认值:**空 +**默认值**: 空 ## default_storage_nodegroup @@ -71,9 +71,9 @@ date: 2021-04-20 - 值为"installation"表示建表会默认建在安装的Node Group上。 - 值为其他字符串表示建表会默认建在设置的Node Group上。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**installation +**默认值**: installation ## temp_tablespaces @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 +**取值范围**: 字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 -**默认值:**空 +**默认值**: 空 ## check_function_bodies @@ -93,12 +93,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 - off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 -**默认值:**on +**默认值**: on ## default_transaction_isolation @@ -106,13 +106,13 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - read committed表示事务读已提交。 - repeatable read表示事务可重复读。 - serializable，MogDB目前功能上不支持此隔离级别，等价于repeatable read。 -**默认值:**read committed +**默认值**: read committed ## default_transaction_read_only @@ -120,12 +120,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示只读状态。 - off表示非只读状态。 -**默认值:**off +**默认值**: off ## default_transaction_deferrable @@ -135,12 +135,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示默认延迟。 - off表示默认不延迟。 -**默认值:**off +**默认值**: off ## session_replication_role @@ -151,13 +151,13 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 设置此参数会丢弃之前任何缓存的执行计划。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - origin表示从当前会话中复制插入、删除、更新等操作。 - replica表示从其他地方复制插入、删除、更新等操作到当前会话。 - local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。 -**默认值:**origin +**默认值**: origin ## statement_timeout @@ -165,9 +165,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为0，最大值为2147483647，单位为毫秒。 -**默认值:**0 +**默认值**: 0 ## vacuum_freeze_min_age @@ -175,12 +175,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为0到10亿之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 -**默认值:**5000000000 +**默认值**: 5000000000 ## vacuum_freeze_table_age @@ -188,12 +188,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为零到20亿之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。 -**默认值:**15000000000 +**默认值**: 15000000000 ## bytea_output @@ -201,12 +201,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - hex: 将二进制数据编码为每字节2位十六进制数字。 - escape: 传统化的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法，同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 -**默认值:**hex +**默认值**: hex ## xmlbinary @@ -214,12 +214,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - base64 - hex -**默认值:**base64 +**默认值**: base64 ## xmloption @@ -227,12 +227,12 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - document: 表示HTML格式的文档。 - content: 普通的字符串。 -**默认值:**content +**默认值**: content ## max_compile_functions @@ -240,9 +240,9 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，取值必须大于等于1。 +**取值范围**: 整型，取值必须大于等于1。 -**默认值:**1000 +**默认值**: 1000 ## gin_pending_list_limit @@ -250,6 +250,6 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为64，最大值为INT_MAX，单位为KB。 +**取值范围**: 整型，最小值为64，最大值为INT_MAX，单位为KB。 -**默认值:**4MB +**默认值**: 4MB diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md index 5e5009cd..59b85cb1 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请**参考表GUC参数设置方式**中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**ISO, MDY +**默认值**: ISO, MDY > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb会将这个参数初始化成与[lc_time](#lc_time)一致的值。 @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - sql_standard表示产生与SQL标准规定匹配的输出。 - postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当[DateStyle](#DateStyle)参数被设为ISO时。 @@ -43,7 +43,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > IntervalStyle参数也会影响不明确的间隔输入的说明。 -**默认值:**postgres +**默认值**: postgres ## TimeZone @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 -**默认值:**PRC +**默认值**: PRC > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > gs_initdb将设置一个与其系统环境一致的时区值。 @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图pg_timezone_names获得。 +**取值范围**: 字符串，可查询视图pg_timezone_names获得。 -**默认值:**Default +**默认值**: Default > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。 @@ -77,14 +77,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-15～3 +**取值范围**: 整型，-15～3 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。 > - 设置为负数，表示消除不需要的数据位。 -**默认值:**0 +**默认值**: 0 ## client_encoding @@ -94,7 +94,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 +**取值范围**: 兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -102,7 +102,7 @@ date: 2021-04-20 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 > - 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证MogDB内部通信编码格式一致。 -**默认值:**UTF8 +**默认值**: UTF8 **推荐值:**SQL_ASCII/UTF8 @@ -116,14 +116,14 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_monetary @@ -131,14 +131,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_numeric @@ -146,14 +146,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## lc_time @@ -161,14 +161,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值:**C +**默认值**: C ## default_text_search_config @@ -182,9 +182,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > MogDB支持pg_catalog.english，pg_catalog.simple两种配置。 -**默认值:**pg_catalog.english +**默认值**: pg_catalog.english diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md index 86e28546..4dab1265 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md @@ -26,7 +26,7 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 设置为空字符串，表示关闭自动路径搜索。 -**默认值:** \$libdir +**默认值**: \$libdir ## gin_fuzzy_search_limit @@ -34,9 +34,9 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值:**0 +**默认值**: 0 ## local_preload_libraries @@ -49,6 +49,6 @@ dynamic_library_path = '/usr/local/lib/postgresql:/opt/testgs/lib:$libdir' 该参数属于BACKEND类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/16-lock-management.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/16-lock-management.md index 68622a4c..c580221b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/16-lock-management.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/16-lock-management.md @@ -18,9 +18,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~2147483647，单位为毫秒（ms）。 +**取值范围**: 整型，1~2147483647，单位为毫秒（ms）。 -**默认值:**1s +**默认值**: 1s ## lockwait_timeout @@ -28,9 +28,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**20min +**默认值**: 20min ## update_lockwait_timeout @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**2min +**默认值**: 2min ## max_locks_per_transaction @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**256 +**默认值**: 256 ## max_pred_locks_per_transaction @@ -65,9 +65,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值:**64 +**默认值**: 64 ## partition_lock_upgrade_timeout @@ -83,17 +83,17 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值-1，最大值3000，单位为秒（s）。 +**取值范围**: 整型，最小值-1，最大值3000，单位为秒（s）。 -**默认值:**1800 +**默认值**: 1800 ## fault_mon_timeout **参数说明:**轻量级死锁检测周期。该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值0，最大值1440，单位为分钟（min） +**取值范围**: 整型，最小值0，最大值1440，单位为分钟（min） -**默认值:**5min +**默认值**: 5min ## enable_online_ddl_waitlock @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启。 - off表示关闭。 -**默认值:**off +**默认值**: off ## xloginsert_locks diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md index 8efb7b8d..b3a1826c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md @@ -15,12 +15,12 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许向数组中输入空元素。 - off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。 -**默认值:**on +**默认值**: on ## backslash_quote @@ -31,13 +31,13 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'…'）。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - on表示一直允许使用\'表示。 - off表示拒绝使用\'表示。 - safe_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\\的ASCII值时允许。 -**默认值:**safe_encoding +**默认值**: safe_encoding ## escape_string_warning @@ -48,9 +48,9 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## lo_compat_privileges @@ -58,11 +58,11 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。 -**默认值:**off +**默认值**: off ## quote_all_identifiers @@ -70,12 +70,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开强制引用。 - off表示关闭强制引用。 -**默认值:**off +**默认值**: off ## sql_inheritance @@ -83,12 +83,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以访问子表。 - off表示不访问子表。 -**默认值:**on +**默认值**: on ## standard_conforming_strings @@ -99,12 +99,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**on +**默认值**: on ## synchronize_seqscans @@ -112,12 +112,12 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示扫描可能从表的中间开始，然后选择"环绕"方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 - off表示确保顺序扫描是从表头开始的。 -**默认值:**on +**默认值**: on ## enable_beta_features @@ -125,9 +125,9 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 - off表示禁止使用这些特性。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md index dcd985a7..65d6290f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## convert_string_to_digit -**参数说明**：设置隐式转换优先级，是否优先将字符串转为数字。 +**参数说明**: 设置隐式转换优先级，是否优先将字符串转为数字。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -20,29 +20,29 @@ date: 2021-04-20 - on表示优先将字符串转为数字。 - off表示不优先将字符串转为数字。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎调操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎调操作。 ## nls_timestamp_format -**参数说明**：设置时间戳默认格式。 +**参数说明**: 设置时间戳默认格式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：DD-Mon-YYYY HH:MI:SS.FF AM +**默认值**: DD-Mon-YYYY HH:MI:SS.FF AM ## max_function_args -**参数说明**：函数参数最大个数。 +**参数说明**: 函数参数最大个数。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型 +**取值范围**: 整型 -**默认值**：666 +**默认值**: 666 ## transform_null_equals @@ -60,7 +60,7 @@ date: 2021-04-20 **默认值：**off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 ## support_extended_features @@ -88,7 +88,7 @@ date: 2021-04-20 **默认值：**A -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 该参数只能在执行**CREATE DATABASE**命令创建数据库的时候设置。 > - 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。 @@ -103,7 +103,7 @@ date: 2021-04-20 **默认值：**空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前只支持[表1](#jianrongxing)。 > - 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set behavior_compat_options='end_month_calculate,display_leading_zero'; @@ -128,7 +128,7 @@ date: 2021-04-20 **参数说明：**控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/18-fault-tolerance.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/18-fault-tolerance.md index 8db1bb57..a1178345 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/18-fault-tolerance.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/18-fault-tolerance.md @@ -15,12 +15,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示ERROR级别报错会升级为PANIC报错。 - off表示不会对ERROR级别报错进行升级。 -**默认值:**off +**默认值**: off ## restart_after_crash @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示能够最大限度地提高数据库的可用性。 @@ -36,7 +36,7 @@ date: 2021-04-20 - off表示能够使得管理工具在后端进程崩溃时获取控制权并采取适当的措施进行处理。 -**默认值:**on +**默认值**: on ## omit_encoding_error @@ -44,12 +44,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 - off表示有转换错误的字符不能被转换，打印错误信息到终端。 -**默认值:**off +**默认值**: off ## max_query_retry_times @@ -57,9 +57,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~20。 +**取值范围**: 整型，0~20。 -**默认值:**0 +**默认值**: 0 ## cn_send_buffer_size @@ -67,9 +67,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~128， 单位为KB。 +**取值范围**: 整型，8~128， 单位为KB。 -**默认值:**8KB +**默认值**: 8KB ## max_cn_temp_file_size @@ -77,9 +77,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~10485760， 单位为KB。 +**取值范围**: 整型，0~10485760， 单位为KB。 -**默认值:**5GB +**默认值**: 5GB ## retry_ecode_list @@ -87,9 +87,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 +**默认值**: YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 ## data_sync_retry @@ -97,23 +97,23 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 - off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 -**默认值:**off +**默认值**: off ## remote_read_mode -**参数说明**：远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 +**参数说明**: 远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - off表示关闭远程读功能。 - non_authentication表示开启远程读功能，但不进行证书认证。 - authentication表示开启远程读功能，但要进行证书认证。 -**默认值**：authentication +**默认值**: authentication diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/19-connection-pool-parameters.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/19-connection-pool-parameters.md index 239290f1..9ca00093 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/19-connection-pool-parameters.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/19-connection-pool-parameters.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为INT_MAX，最小单位为秒。 +**取值范围**: 整型，最小值为0，最大值为INT_MAX，最小单位为秒。 -**默认值:**10min +**默认值**: 10min ## minimum_pool_size @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为65535 +**取值范围**: 整型，最小值为1，最大值为65535 -**默认值:**50 +**默认值**: 50 ## cache_connection @@ -35,9 +35,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示回收连接池的连接。 - off表示不回收连接池的连接。 -**默认值:**on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/2-file-location.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/2-file-location.md index 18da5061..0cd7836e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/2-file-location.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/2-file-location.md @@ -21,9 +21,9 @@ date: 2021-04-20 - 在安装MogDB时指定。 - 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**安装时指定，如果在安装时不指定，则默认不初始化数据库。 +**默认值**: 安装时指定，如果在安装时不指定，则默认不初始化数据库。 ## config_file @@ -31,9 +31,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置，不支持使用表[GUC参数设置方式](30-appendix)中的方式四进行修改。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值:**postgresql.conf(实际安装可能带有绝对目录) +**默认值**: postgresql.conf(实际安装可能带有绝对目录) ## hba_file @@ -41,9 +41,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_hba.conf(实际安装可能带有绝对目录) +**默认值**: pg_hba.conf(实际安装可能带有绝对目录) ## ident_file @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_ident.conf(实际安装可能带有绝对目录) +**默认值**: pg_ident.conf(实际安装可能带有绝对目录) ## external_pid_file @@ -64,6 +64,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 这个参数只能在数据库服务重新启动后生效。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/20-MogDB-transaction.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/20-MogDB-transaction.md index b1e9820d..dbcbe4ff 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/20-MogDB-transaction.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/20-MogDB-transaction.md @@ -15,14 +15,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，只识别以下字符串，大小写空格敏感: +**取值范围**: 字符串，只识别以下字符串，大小写空格敏感: - serializable: MogDB中等价于REPEATABLE READ。 - read committed: 只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 - repeatable read: 仅能读取事务开始之前提交的数据，不能读取未提交的数据以及在事务执行期间由其它并发事务提交的修改。 - default: 设置为default_transaction_isolation所设隔离级别。 -**默认值:**read committed +**默认值**: read committed ## transaction_read_only @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示设置当前事务为只读事务。 - off表示该事务可以是非只读事务。 -**默认值:**off +**默认值**: off ## xc_maintenance_mode @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，仅支持表[GUC参数分类](30-appendix)中的方式三进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -54,7 +54,7 @@ date: 2021-04-20 > > 谨慎打开这个开关，避免引起MogDB数据不一致。 -**默认值:**off +**默认值**: off ## allow_concurrent_tuple_update @@ -62,12 +62,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 -**默认值:**on +**默认值**: on ## transaction_deferrable @@ -75,12 +75,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许执行。 - off表示不允许执行。 -**默认值:**off +**默认值**: off ## enforce_two_phase_commit @@ -88,12 +88,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示强制使用两阶段提交。 - off表示不强制使用两阶段提交。 -**默认值:**on +**默认值**: on ## enable_show_any_tuples @@ -101,12 +101,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示表中元组的所有版本都会可见。 - off/false表示表中元组的所有版本都不可见。 -**默认值:**off +**默认值**: off ## replication_type @@ -116,13 +116,13 @@ date: 2021-04-20 该参数用户不能自己去设置参数值。 -**取值范围:**0~2 +**取值范围**: 0~2 - 2 表示单主机模式，此模式无法扩展备机。 - 1 表示使用一主多备模式，全场景覆盖，推荐使用。 - 0 表示主备从模式，目前此模式暂不支持。 -**默认值:**1 +**默认值**: 1 ## pgxc_node_name diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/21-developer-options.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/21-developer-options.md index 2d607db5..671e6481 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/21-developer-options.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/21-developer-options.md @@ -15,12 +15,12 @@ date: 2021-04-20 不建议修改该参数默认值，如果设置为on，可能导致系统表损坏，甚至数据库无法启动。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许修改系统表的结构。 - off表示不允许修改系统表的结构。 -**默认值:**off +**默认值**: off ## debug_assertions @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开断言检查。 - off表示不打开断言检查。 @@ -37,7 +37,7 @@ date: 2021-04-20 > > 当启用断言选项编译MogDB时，debug_assertions缺省值为on 。 -**默认值:**off +**默认值**: off ## ignore_checksum_failure @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略数据校验错误。 - off表示数据校验错误正常报错。 -**默认值:**off +**默认值**: off ## ignore_system_indexes @@ -62,12 +62,12 @@ date: 2021-04-20 > > 这个参数在从系统索引被破坏的表中恢复数据的时候非常有用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略系统索引。 - off表示不忽略系统索引。 -**默认值:**off +**默认值**: off ## post_auth_delay @@ -75,9 +75,9 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147，单位为秒。 +**取值范围**: 整型，最小值为0，最大值为2147，单位为秒。 -**默认值:**0 +**默认值**: 0 ## pre_auth_delay @@ -85,9 +85,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0～60，单位为秒。 +**取值范围**: 整型，最小值为0～60，单位为秒。 -**默认值:**0 +**默认值**: 0 ## trace_notify @@ -95,12 +95,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开输出功能。 - off表示关闭输出功能。 -**默认值:**off +**默认值**: off ## trace_recovery_messages @@ -108,9 +108,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 +**取值范围**: 枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 -**默认值:**log +**默认值**: log > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -123,12 +123,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值:**off +**默认值**: off ## zero_damaged_pages @@ -136,11 +136,11 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 -**默认值:**off +**默认值**: off ## remotetype @@ -168,12 +168,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启Numeric优化。 - off/false表示关闭Numeric优化。 -**默认值:**on +**默认值**: on ## enable_compress_spill @@ -181,12 +181,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启下盘优化。 - off/false表示关闭下盘优化。 -**默认值:**on +**默认值**: on ## resource_track_log @@ -194,14 +194,14 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 - summary: 显示简略的诊断信息。 - detail: 显示详细的诊断信息。 目前这两个参数值只在显示多列统计信息未收集的告警的情况下有差别，summary不显示未收集多列统计信息的告警，detail会显示这类告警。 -**默认值:**summary +**默认值**: summary ## show_acce_estimate_detail diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md index 9effc9ff..5a410a50 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启动审计功能。 - off表示关闭审计功能。 -**默认值:**on +**默认值**: on ## audit_directory @@ -26,9 +26,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 +**默认值**: pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 ## audit_data_format @@ -36,9 +36,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**binary +**默认值**: binary ## audit_rotation_interval @@ -72,12 +72,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示采用空间优先策略，最多存储[audit_space_limit](#audit_space_limit)大小的日志。 - off表示采用时间优先策略，最少存储[audit_file_remain_time](#audit_file_remain_time)长度时间的日志。 -**默认值:**on +**默认值**: on ## audit_file_remain_time @@ -95,9 +95,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024KB~1024GB，单位为KB。 +**取值范围**: 整型，1024KB~1024GB，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## audit_file_remain_threshold @@ -105,9 +105,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~1048576 +**取值范围**: 整型，1~1048576 -**默认值:**1048576 +**默认值**: 1048576 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 请尽量保证此参数为1048576，并不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md index 34e3f3bd..a5c5202c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~7。 +**取值范围**: 整型，0~7。 - 0表示关闭用户登录、注销审计功能。 - 1表示只审计用户登录成功。 @@ -24,7 +24,7 @@ date: 2021-04-20 - 6表示只审计用户注销和登录失败。 - 7表示审计用户登录成功、失败和注销。 -**默认值:**7 +**默认值**: 7 ## audit_database_process @@ -32,12 +32,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭MogDB启动、停止、恢复和切换审计功能。 - 1表示开启MogDB启动、停止、恢复和切换审计功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_locked @@ -45,12 +45,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户锁定和解锁审计功能。 - 1表示开启审计用户锁定和解锁功能。 -**默认值:**1 +**默认值**: 1 ## audit_user_violation @@ -58,12 +58,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户越权操作审计功能。 - 1表示开启用户越权操作审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_grant_revoke @@ -71,9 +71,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计用户权限授予和回收功能。 - 1表示开启审计用户权限授予和回收功能。 -**默认值:**. +**默认值**: . diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md index 538d46f5..71e694c5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～524287 +**取值范围**: 整型，0～524287 - 0代表关闭MogDB数据库对象的CREATE、DROP、ALTER操作审计功能。 - 非0代表只审计MogDB的某类或者某些数据库对象的CREATE、DROP、ALTER操作。 @@ -22,7 +22,7 @@ date: 2021-04-20 该参数的值由19个二进制位的组合求出，这19个二进制位分别代表MogDB的19类数据库对象。如果对应的二进制位取值为0，表示不审计对应的数据库对象的CREATE、DROP、ALTER操作；取值为1，表示审计对应的数据库对象的CREATE、DROP、ALTER操作。这19个二进制位代表的具体审计内容请参见[表1](#audit_system_object)。 -**默认值:**12295 +**默认值**: 12295 **表 1** audit_system_object取值含义说明 @@ -56,12 +56,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭具体表的DML操作（SELECT除外）审计功能。 - 1表示开启具体表的DML操作（SELECT除外）审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_dml_state_select @@ -69,12 +69,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SELECT操作审计功能。 - 1表示开启SELECT审计操作功能。 -**默认值:**0 +**默认值**: 0 ## audit_function_exec @@ -82,12 +82,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭过程或函数执行的审计功能。 - 1表示开启过程或函数执行的审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_copy_exec @@ -95,12 +95,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭COPY审计功能。 - 1表示开启COPY审计功能。 -**默认值:**0 +**默认值**: 0 ## audit_set_parameter @@ -108,12 +108,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SET审计功能。 - 1表示开启SET审计功能。 -**默认值:**1 +**默认值**: 1 ## enableSeparationOfDuty @@ -121,12 +121,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启三权分立。 - off表示不开启三权分立。 -**默认值:**off +**默认值**: off ## enable_nonsysadmin_execute_direct @@ -134,12 +134,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许任意用户执行EXECUTE DIRECT ON语句。 - off表示只允许系统管理员执行EXECUTE DIRECT ON语句。 -**默认值:**off +**默认值**: off ## enable_copy_server_files @@ -147,12 +147,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启copy服务端文件的权限。 - off表示不开启copy服务端文件的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** copy from/to file要求具有系统管理员权限的用户或初始用户才能使用，但是，在三权分立开启的状态下，系统管理员与初始用户的权限不同，可以通过使用enable_copy_server_file控制系统管理员的copy权限，当前默认不允许系统管理员权限用户进行对文件的copy操作，此参数打开后系统管理员方可执行该类型操作。 @@ -162,12 +162,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启系统管理员用户创建和删除DIRECTORY的权限。 - off表示不开启系统管理员用户创建和删除DIRECTORY的权限。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/23-upgrade-parameters.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/23-upgrade-parameters.md index 2a9adf13..40a5632e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/23-upgrade-parameters.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/23-upgrade-parameters.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在升级过程中。 - off表示不在升级过程中。 -**默认值:**off +**默认值**: off ## inplace_upgrade_next_system_object_oids @@ -26,15 +26,15 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## upgrade_mode **参数说明**: 标示升级模式。该参数不建议用户自己修改。 -**取值范围:**整数，0~INT_MAX +**取值范围**: 整数，0~INT_MAX - 0表示不在升级过程中。 - 1表示在就地升级过程中。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md index 5a0e956e..1909fd76 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md @@ -13,9 +13,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**9.2.4 +**默认值**: 9.2.4 ## server_version_num @@ -23,9 +23,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整数 +**取值范围**: 整数 -**默认值:**90204 +**默认值**: 90204 ## block_size @@ -33,9 +33,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**8192 +**取值范围**: 8192 -**默认值:**8192 +**默认值**: 8192 ## segment_size @@ -45,7 +45,7 @@ date: 2021-04-20 **单位**: 8KB -**默认值:**131072, 即1GB +**默认值**: 131072, 即1GB ## max_index_keys @@ -53,7 +53,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**32 +**默认值**: 32 ## integer_datetimes @@ -61,12 +61,12 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示支持。 - off表示不支持。 -**默认值:**on +**默认值**: on ## lc_collate @@ -74,7 +74,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## lc_ctype @@ -82,7 +82,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## max_identifier_length @@ -90,9 +90,9 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整型 +**取值范围**: 整型 -**默认值:**63 +**默认值**: 63 ## server_encoding @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值:**在创建数据库的时候由当前系统环境决定的。 +**默认值**: 在创建数据库的时候由当前系统环境决定的。 ## enable_upgrade_merge_lock_mode @@ -110,20 +110,20 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 - off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 -**默认值:**off +**默认值**: off ## transparent_encrypted_string **参数说明:**它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，设置为空表示MogDB非加密。 +**取值范围**: 字符串，设置为空表示MogDB非加密。 -**默认值:**空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** 请勿手动设置该参数，设置不当将导致MogDB不可用。 @@ -133,9 +133,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## transparent_encrypt_kms_region @@ -143,9 +143,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## basebackup_timeout diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/25-wait-events.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/25-wait-events.md index 65a819a2..81796520 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/25-wait-events.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/25-wait-events.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开等待事件信息收集功能。 - off: 表示关闭等待事件信息收集功能。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/26-query.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/26-query.md index 09aafc22..628b3323 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/26-query.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/26-query.md @@ -27,7 +27,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - top: 只记录顶层SQL。 @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开sql响应时间信息计算功能。 - off: 表示关闭sql响应时间信息计算功能。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 **默认值**: 80,95 @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～3600（秒）。 +**取值范围**: 整型，0～3600（秒）。 **默认值**: 10s @@ -72,7 +72,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示捕获sql执行的cpu时间消耗。 - off: 表示不捕获sql执行的cpu时间消耗。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/27-system-performance-snapshot.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/27-system-performance-snapshot.md index 1083ca06..1e34b13e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/27-system-performance-snapshot.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/27-system-performance-snapshot.md @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1～8。 +**取值范围**: 整型，1～8。 **默认值**: 8 @@ -36,7 +36,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～INT_MAX（秒）。 +**取值范围**: 整型，100～INT_MAX（秒）。 **默认值**: 100s @@ -46,6 +46,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10～60（分钟）。 +**取值范围**: 整型，10～60（分钟）。 **默认值**: 1h diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md index 43908674..9a5f9a63 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md @@ -15,7 +15,7 @@ date: 2021-04-20 enable_full_encryption设置为on后，使用gsql连接数据库时需要输入"-C"参数，或"-enable-client-encryption"，否则连接不成功。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 全密态数据库开关打开。 - off: 全密态数据库开关关闭。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/29-global-temporary-table.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/29-global-temporary-table.md index 4f3d346c..275de54e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/29-global-temporary-table.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/29-global-temporary-table.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 - 0: 全局临时表功能关闭。 - > 0: 全局临时表功能打开。 @@ -26,6 +26,6 @@ date: 2021-04-20 该参数USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 **默认值**: 10000 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md index 89c3f55a..31b3669a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md @@ -11,31 +11,31 @@ date: 2021-04-20 ## listen_addresses -**参数说明:**声明服务器侦听客户端的TCP/IP地址。 +**参数说明:** 声明服务器侦听客户端的TCP/IP地址。 该参数指定MogDB服务器使用哪些IP地址进行侦听，如IPV4或IPV6（若支持）。服务器主机上可能存在多个网卡，每个网卡可以绑定多个IP地址，该参数就是控制MogDB到底绑定在哪个或者哪几个IP地址上。而客户端则可以通过该参数中指定的IP地址来连接MogDB或者给MogDB发送请求。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** +**取值范围**: - 主机名或IP地址，多个值之间用英文逗号分隔。 - 星号"*"或"0.0.0.0"表示侦听所有IP地址。配置侦听所有IP地址存在安全风险，不推荐用户使用。必须与有效地址结合使用（比如本地IP等），否则，可能造成Build失败的问题。 - 置空则服务器不会侦听任何IP地址，这种情况下，只有Unix域套接字可以用于连接数据库。 -**默认值:**数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 ## local_bind_address -**参数说明:**声明当前节点连接MogDB其他节点绑定的本地IP地址。 +**参数说明:** 声明当前节点连接MogDB其他节点绑定的本地IP地址。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值:**数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 ## port -**参数说明:**MogDB服务侦听的TCP端口号。 +**参数说明:** MogDB服务侦听的TCP端口号。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -44,49 +44,49 @@ date: 2021-04-20 > 该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。 > -**取值范围:**整型，1～65535 +**取值范围**: 整型，1～65535 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置端口号时，请设置一个未被占用的端口号。设置多个实例的端口号，不可冲突。 > - 1~1023为操作系统保留端口号，请不要使用。 > - 通过配置文件安装数据库实例时，配置文件中的端口号需要注意通信矩阵预留端口。如：DN还需保留dataPortBase+1作为内部工具使用端口，保留dataPortBase+6作为流引擎消息队列通信端口等。故数据库实例安装阶段，port最大值为：DN可设置65529，同时需要保证端口号不冲突。 -**默认值:**5432（实际值由安装时的配置文件指定） +**默认值**: 5432（实际值由安装时的配置文件指定） ## max_connections -**参数说明:**允许和数据库连接的最大并发连接数。此参数会影响MogDB的并发能力。 +**参数说明:** 允许和数据库连接的最大并发连接数。此参数会影响MogDB的并发能力。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”，job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数固定为2。 +**取值范围**: 整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”，job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数固定为2。 -**默认值:**200 +**默认值**: 200 **设置建议:** 数据库主节点中此参数建议保持默认值。 -**配置不当时影响：** +**配置不当时影响**: - 若配置max_connections过大，超过计算公式所描述的最大动态值，会出现节点拉起失败问题，报错提示“invalid value for parameter “max_connections””。 - 若未按照对外出口规格配置仅调大max_connections参数值，未同比例调整内存参数。业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于管理员用户的连接数限制会略超过max_connections设置，目的是为了让管理员在链接被普通用户占满后仍可以连接上数据库，再超过一定范围（sysadmin_reserved_connections参数）后才会报错。即管理员用户的最大连接数等于max_connections + sysadmin_reserved_connections。 > - 对于普通用户来说，由于内部作业也会使用一些链接，因此会略小于max_connections，具体值取决于内部链接个数。 ## max_inner_tool_connections -**参数说明:**允许和数据库连接的工具的最大并发连接数。此参数会影响MogDB的工具连接并发能力。 +**参数说明:** 允许和数据库连接的工具的最大并发连接数。此参数会影响MogDB的工具连接并发能力。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 +**默认值**: 数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 **设置建议:** @@ -96,39 +96,39 @@ date: 2021-04-20 ## sysadmin_reserved_connections -**参数说明:**为管理员用户预留的最少连接数, 不建议设置过大。该参数和max_connections参数配合使用，管理员用户的最大连接数等于max_connections+sysadmin_reserved_connections。 +**参数说明:** 为管理员用户预留的最少连接数, 不建议设置过大。该参数和max_connections参数配合使用，管理员用户的最大连接数等于max_connections+sysadmin_reserved_connections。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值:**3 +**默认值**: 3 ## unix_socket_directory -**参数说明:**设置MogDB服务器侦听客户端连接的Unix域套接字目录。 +**参数说明:** 设置MogDB服务器侦听客户端连接的Unix域套接字目录。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 该参数的长度限制于操作系统的长度，超过该限制将会导致Unix-domain socket path "xxx" is too long的问题。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空字符串（实际值由安装时配置文件指定） +**默认值**: 空字符串（实际值由安装时配置文件指定） ## unix_socket_group -**参数说明:**设置Unix域套接字的所属组（套接字的所属用户总是启动服务器的用户）。可以与选项[unix_socket_permissions](#unix_socket_permissions)一起用于对套接字进行访问控制。 +**参数说明:** 设置Unix域套接字的所属组（套接字的所属用户总是启动服务器的用户）。可以与选项[unix_socket_permissions](#unix_socket_permissions)一起用于对套接字进行访问控制。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空字符串表示当前用户的缺省组。 +**取值范围**: 字符串，其中空字符串表示当前用户的缺省组。 -**默认值:**空字符串 +**默认值**: 空字符串 ## unix_socket_permissions -**参数说明:**设置Unix域套接字的访问权限。 +**参数说明:** 设置Unix域套接字的访问权限。 Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应该是数值的格式（chmod和umask命令可接受的格式）。如果使用自定义的八进制格式，数字必须以0开头。 @@ -136,9 +136,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0000-0777 +**取值范围**: 0000-0777 -**默认值:**0777 +**默认值**: 0777 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -166,23 +166,23 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 ## application_name -**参数说明:**当前连接请求当中，所使用的客户端名称。 +**参数说明:** 当前连接请求当中，所使用的客户端名称。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串(连接到后端的应用名，以实际安装为准) +**默认值**: 空字符串(连接到后端的应用名，以实际安装为准) ## connection_info -**参数说明:**连接数据库的驱动类型、驱动版本号、当前驱动的部署路径和进程属主用户。 +**参数说明:** 连接数据库的驱动类型、驱动版本号、当前驱动的部署路径和进程属主用户。 该参数属于USERSET类型参数，属于运维类参数，不建议用户设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 -**默认值:**空字符串**。** +**默认值**: 空字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md index dd0e2a9f..de09b43f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md @@ -15,9 +15,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为600，最小单位为s。 +**取值范围**: 整型，最小值为1，最大值为600，最小单位为s。 -**默认值:**1min +**默认值**: 1min ## auth_iteration_count @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2048-134217728。 +**取值范围**: 整型，2048-134217728。 -**默认值:**10000 +**默认值**: 10000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化，请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。 @@ -38,9 +38,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0-86400，最小单位为s，0表示关闭超时设置。 +**取值范围**: 整型，0-86400，最小单位为s，0表示关闭超时设置。 -**默认值:**10min +**默认值**: 10min > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用SSL连接。 - off表示不启用SSL连接。 @@ -59,7 +59,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启，数据库节点默认值为off。开启此参数需要同时配置ssl_cert_file、ssl_key_file和ssl_ca_file等参数及对应文件，不正确的配置可能会导致MogDB无法正常启动。 -**默认值:**off +**默认值**: off ## require_ssl @@ -67,7 +67,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示服务器端强制要求SSL连接。 - off表示服务器端对是否通过SSL连接不作强制要求。 @@ -75,7 +75,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。 -**默认值:**off +**默认值**: off ## ssl_ciphers @@ -83,9 +83,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 +**取值范围**: 字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 -**默认值:**ALL +**默认值**: ALL ## ssl_renegotiation_limit @@ -93,9 +93,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 +**取值范围**: 整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 -**默认值:**0 +**默认值**: 0 ## ssl_cert_file @@ -103,9 +103,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**server.crt +**默认值**: server.crt ## ssl_key_file @@ -115,7 +115,7 @@ date: 2021-04-20 取值范围:字符串 -**默认值:**server.key +**默认值**: server.key ## ssl_ca_file @@ -123,9 +123,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**cacert.pem +**默认值**: cacert.pem ## ssl_crl_file @@ -143,9 +143,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## krb_srvname @@ -153,9 +153,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**postgres +**默认值**: postgres ## krb_caseins_users @@ -163,12 +163,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示大小写不敏感 - off表示大小写敏感 -**默认值:**off +**默认值**: off ## modify_initial_password @@ -178,12 +178,12 @@ date: 2021-04-20 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示MogDB安装成功后初始用户首次登录操作前需要修改初始密码。 - off表示MogDB安装成功后初始用户无需修改初始密码即可进行操作。 -**默认值:**off +**默认值**: off ## password_policy @@ -194,12 +194,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 从安全性考虑，请勿关闭密码复杂度策略。 -**取值范围:**0、1 +**取值范围**: 0、1 - 0表示不采用任何密码复杂度策略。 - 1表示采用默认密码复杂度校验策略。 -**默认值:**1 +**默认值**: 1 ## password_reuse_time @@ -215,12 +215,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**浮点型（天），最小值为0，最大值为3650。 +**取值范围**: 浮点型（天），最小值为0，最大值为3650。 - 0表示不检查密码可重用的天数。 - 正数表示新密码不能为该值指定的天数内使用过的密码。 -**默认值:**60 +**默认值**: 60 ## password_reuse_max @@ -236,12 +236,12 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示不检查密码可重用次数。 - 正整数表示新密码不能为该值指定的次数内使用过的密码。 -**默认值:**0 +**默认值**: 0 ## password_lock_time @@ -252,12 +252,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > password_lock_time和[failed_login_attempts](#failed_login_attempts)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**浮点型，最小值为0，最大值为365，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为365，单位为天。 - 0表示密码验证失败时，自动锁定功能不生效。 - 正数表示帐户被锁定后，当锁定时间超过password_lock_time设定的值时，帐户将会被自行解锁。 -**默认值:**1d +**默认值**: 1d ## failed_login_attempts @@ -268,12 +268,12 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > failed_login_attempts和[password_lock_time](#password_lock_time)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示自动锁定功能不生效。 - 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前帐户将被锁定。 -**默认值:**10 +**默认值**: 10 ## password_encryption_type @@ -281,7 +281,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0、1、2 +**取值范围**: 0、1、2 - 0表示采用md5方式对密码加密。 - 1表示采用sha256和md5两种方式分别对密码加密。 @@ -290,7 +290,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > md5加密算法安全性低，存在安全风险，不建议用户使用。 -**默认值:**2 +**默认值**: 2 ## password_min_length @@ -298,9 +298,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**8 +**默认值**: 8 ## password_max_length @@ -308,9 +308,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值:**32 +**默认值**: 32 ## password_min_uppercase @@ -318,12 +318,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建账户所指定的密码中至少需要包含大写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_lowercase @@ -331,12 +331,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含小写字母个数。 -**默认值:**0 +**默认值**: 0 ## password_min_digital @@ -344,12 +344,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含数字个数。 -**默认值:**0 +**默认值**: 0 ## password_min_special @@ -357,12 +357,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含特殊字符个数。 -**默认值:**0 +**默认值**: 0 ## password_effect_time @@ -370,12 +370,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，最小值为0，最大值为999，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为999，单位为天。 - 0表示不开启有效期限制功能。 - 1~999表示创建帐户所指定的密码有效期，临近或超过有效期系统会提示用户修改密码。 -**默认值:**90 +**默认值**: 90 ## password_notify_time @@ -383,9 +383,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为999，单位为天。 +**取值范围**: 整型，最小值为0，最大值为999，单位为天。 - 0表示不开启提醒功能。 - 1~999表示帐户密码到期前提醒的天数。 -**默认值:**. +**默认值**: . diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md index 6751202e..b525c870 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md @@ -20,9 +20,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPIDLE选项 ，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-3600，单位为s。 +**取值范围**: 0-3600，单位为s。 -**默认值:**60 +**默认值**: 60 ## tcp_keepalives_interval @@ -30,9 +30,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0-180，单位为s。 +**取值范围**: 0-180，单位为s。 -**默认值:**30 +**默认值**: 30 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -50,9 +50,9 @@ date: 2021-04-20 > - 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 -**取值范围:**0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 +**取值范围**: 0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 -**默认值:**20 +**默认值**: 20 ## comm_tcp_mode @@ -63,9 +63,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SCTP协议的连接不再提供支持，为了保持兼容，提供此参数的接口，但此参数会在设置过程中强制改为on。 -**取值范围:**布尔型，设置为on表示使用TCP模式连接数据库节点。 +**取值范围**: 布尔型，设置为on表示使用TCP模式连接数据库节点。 -**默认值:**on +**默认值**: on ## comm_sctp_port @@ -76,9 +76,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7000 +**默认值**: 7000 ## comm_control_port @@ -89,9 +89,9 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > MogDB部署时会自动分配此端口号，请不要轻易修改此参数，如端口号配置不正确会导致数据库通信失败。 -**取值范围:**整型，最小值为0，最大值为65535。 +**取值范围**: 整型，最小值为0，最大值为65535。 -**默认值:**7001 +**默认值**: 7001 ## comm_max_receiver @@ -99,9 +99,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为50。 +**取值范围**: 整型，最小值为1，最大值为50。 -**默认值:**4 +**默认值**: 4 ## comm_quota_size @@ -109,9 +109,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2048000，默认单位为KB。 +**取值范围**: 整型，最小值为0，最大值为2048000，默认单位为KB。 -**默认值:**1MB +**默认值**: 1MB ## comm_usable_memory @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**4000MB +**默认值**: 4000MB ## comm_memory_pool @@ -135,9 +135,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 +**取值范围**: 整型，最小值为100*1024，最大值为INT_MAX/2，默认单位为KB。 -**默认值:**2000MB +**默认值**: 2000MB ## comm_memory_pool_percent @@ -148,9 +148,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为100。 +**取值范围**: 整型，最小值为0，最大值为100。 -**默认值:**0 +**默认值**: 0 ## comm_no_delay @@ -158,12 +158,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 如果MogDB出现因每秒接收数据包过多导致的丢包时，需设置为off，以便小包合并成大包发送，减少数据包总数。 -**默认值:**off +**默认值**: off ## comm_debug_mode @@ -174,12 +174,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细debug日志。 - off表示不打印通信库详细debug日志。 -**默认值:**off +**默认值**: off ## comm_ackchk_time @@ -187,9 +187,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 +**取值范围**: 整型，最小值为0，最大值为20000，单位为毫秒。取值为0表示关闭此功能。 -**默认值:**2000 +**默认值**: 2000 ## comm_timer_mode @@ -200,12 +200,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库详细时间桩日志。 - off表示不打印通信库详细时间桩日志。 -**默认值:**off +**默认值**: off ## comm_stat_mode @@ -216,9 +216,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打印通信库统计信息日志。 - off表示不打印通信库统计信息日志。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/31-scheduled-task.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/31-scheduled-task.md index 1325e937..8bc2d6dd 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/31-scheduled-task.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/31-scheduled-task.md @@ -30,13 +30,13 @@ date: 2021-06-07 ## enable_prevent_job_task_startup -**参数说明**：控制是否启动job线程。 +**参数说明**: 控制是否启动job线程。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示不能启动job线程。 - off表示可以启动job线程。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/32-thread-pool.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/32-thread-pool.md index 30ad6f07..802b27ae 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/32-thread-pool.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/32-thread-pool.md @@ -9,20 +9,20 @@ date: 2021-06-07 ## enable_thread_pool -**参数说明**：控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启线程池功能。 - off表示不开启线程池功能。 -**默认值**：off +**默认值**: off ## thread_pool_attr -**参数说明**：用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 该参数分为3个部分，'thread_num, group_num, cpubind_info'，这3个部分的具体含义如下： @@ -30,4 +30,4 @@ date: 2021-06-07 - group_num：线程池中的线程分组个数，取值范围是0~64。其中0的含义是数据库根据系统NUMA组的个数来自动配置线程池的线程分组个数，如果参数值大于0，线程池中的线程组个数等于group_num。 - cpubind_info：线程池是否绑核的配置参数。可选择的配置方式有集中：1. '(nobind)' ，线程不做绑核；2. '(allbind)'，利用当前系统所有能查询到的CPU core做线程绑核；3. '(nodebind: 1, 2)'，利用NUMA组1,2中的CPU core进行绑核；4. '(cpubind: 0-30)'，利用0-30号CPU core进行绑核。该参数不区分大小写。 -**默认值**：'16, 2, (nobind)' +**默认值**: '16, 2, (nobind)' diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md index ae07c6b6..66fe020b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md @@ -46,7 +46,7 @@ date: 2021-04-20 - on表示启用逻辑内存管理模块。 - off表示不启用逻辑内存管理模块。 -**默认值:**on +**默认值**: on > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 若max_process_memory-shared_buffers-cstore_buffers-元数据少于2G，MogDB强制把enable_memory_limit设置为off。（注: 实际上shared_buffers不直接参与计算，而是由shared_buffers通过一系列计算得到的数值更大的shared_memory。） @@ -59,7 +59,7 @@ date: 2021-04-20 **取值范围**: 整型，2\*1024\*1024～INT_MAX，单位为KB。 -**默认值:**12GB。 +**默认值**: 12GB。 **设置建议:** @@ -76,7 +76,7 @@ date: 2021-04-20 - on表示启用最大内存上下文限制检查功能。 - off表示关闭最大内存上下文限制检查功能。 -**默认值:**off +**默认值**: off ## uncontrolled_memory_context @@ -88,7 +88,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 ## shared_buffers @@ -96,11 +96,11 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16 ~ 1073741823 ，单位为KB。 +**取值范围**: 整型，16 ~ 1073741823 ，单位为KB。 shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 -**默认值:**数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 +**默认值**: 数据库节点为1GB。如果操作系统支持的共享内存小于32MB，则在初始化数据存储区时会自动调整为操作系统支持的最大值。 **设置建议:** @@ -114,9 +114,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384 ~ 2147483647，单位为KB。 +**取值范围**: 整型，16384 ~ 2147483647，单位为KB。 -**默认值:**2GB +**默认值**: 2GB **设置建议:**建议导入压力大的场景中增加数据库节点中此参数配置。 @@ -126,9 +126,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**双精度类型，0.1~1.0 +**取值范围**: 双精度类型，0.1~1.0 -**默认值:**0.3 +**默认值**: 0.3 ## temp_buffers @@ -140,9 +140,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 -**取值范围:**整型，100~1073741823，单位为8KB。 +**取值范围**: 整型，100~1073741823，单位为8KB。 -**默认值:**1MB +**默认值**: 1MB ## max_prepared_transactions @@ -152,9 +152,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。0~536870911。 +**取值范围**: 整型。0~536870911。 -**默认值:**800 +**默认值**: 800 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 为避免在准备步骤失败，此参数的值不能小于max_connections。 @@ -167,9 +167,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，64~2147483647，单位为KB。 +**取值范围**: 整型，64~2147483647，单位为KB。 -**默认值:**64MB +**默认值**: 64MB **设置建议:** @@ -185,9 +185,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 -**默认值:**0 +**默认值**: 0 ## query_max_mem @@ -195,9 +195,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 -**默认值:**0 +**默认值**: 0 ## maintenance_work_mem @@ -205,9 +205,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024~INT_MAX，单位为KB。 +**取值范围**: 整型，1024~INT_MAX，单位为KB。 -**默认值:**128MB +**默认值**: 128MB **设置建议:** @@ -224,9 +224,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 同样，好几个正在运行的会话可能会同时进行表的局部排序操作。因此使用的总内存可能是psort_work_mem的好几倍。 -**取值范围:**整型64~2147483647，单位为KB。 +**取值范围**: 整型64~2147483647，单位为KB。 -**默认值:**512MB +**默认值**: 512MB ## max_loaded_cudesc @@ -237,9 +237,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > max_loaded_cudesc设置过高时，有可能引起内存分配不足。 -**取值范围:**100~1073741823。 +**取值范围**: 100~1073741823。 -**默认值:**1024 +**默认值**: 1024 ## max_stack_depth @@ -253,9 +253,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 - 如果设置此参数的值大于实际的内核限制，则一个正在运行的递归函数可能会导致一个独立的服务器进程崩溃。在MogDB能够检测内核限制的操作系统上（SLES上），将自动限制设置为一个不安全的值。 - 因为并非所有的操作都能够检测，所以建议用户在此设置一个明确的值。 -**取值范围:**整型，100~INT_MAX，单位为KB。 +**取值范围**: 整型，100~INT_MAX，单位为KB。 -**默认值:**2MB +**默认值**: 2MB > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值2MB，这个值相对比较小，不容易导致系统崩溃。但是可能会因为该值较小，导致无法执行复杂的函数。 @@ -266,9 +266,9 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384～1073741823，单位为KB。 +**取值范围**: 整型，16384～1073741823，单位为KB。 -**默认值:**1GB +**默认值**: 1GB **设置建议**: @@ -280,19 +280,19 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，256~2147483647，单位为KB。 +**取值范围**: 整型，256~2147483647，单位为KB。 -**默认值:**16MB +**默认值**: 16MB ## enable_early_free -**参数说明**：控制是否可以实现算子内存的提前释放。 +**参数说明**: 控制是否可以实现算子内存的提前释放。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持算子内存提前释放。 - off表示不支持算子内存提前释放。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md index 39732fdf..98c8c5fa 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 **默认值: -1** @@ -30,6 +30,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SQL查询执行时使用的临时表空间不在此限制。 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 -**默认值:**-1 +**默认值**: -1 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md index e889ba86..e8eecfe3 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，25~2147483647。 +**取值范围**: 整型，25~2147483647。 -**默认值:**1000 +**默认值**: 1000 ## shared_preload_libraries @@ -36,6 +36,6 @@ date: 2021-04-20 > - 如果被声明的库不存在，MogDB服务将会启动失败。 > - 每一个支持MogDB的库都有一个特殊的标记用于保证兼容性。因此，不支持MogDB的库不能用这种方法加载。 -**取值范围:**字符串 +**取值范围**: 字符串 -**默认值:**空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md index 558ccc71..0ccd969f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md @@ -31,9 +31,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 +**取值范围**: integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 -**默认值:**0 +**默认值**: 0 ## vacuum_cost_page_hit @@ -41,9 +41,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**1 +**默认值**: 1 ## vacuum_cost_page_miss @@ -51,9 +51,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 -**默认值:**10 +**默认值**: 10 ## vacuum_cost_page_dirty @@ -61,9 +61,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~1000 +**取值范围**: integer，0~1000 -**默认值:**20 +**默认值**: 20 ## vacuum_cost_limit @@ -71,6 +71,6 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，1~10000。 +**取值范围**: integer，1~10000。 -**默认值:**200 +**默认值**: 200 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md index d38b0640..69266da2 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md @@ -13,16 +13,16 @@ date: 2021-04-20 ## bgwriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～8 +**取值范围**: 整型，0～8 - 开发期间为测试关闭该特性的效果，可以设置为0，但是当前如果设置为0，会在代码中修正为1，不再支持关闭该特性。 - 当参数设置为1~8时，表示会启动相对应数量的background线程，用于维护候选buffer链，将满足条件的脏页刷盘，不脏的页放入到候选list中。 -**默认值**：2 +**默认值**: 2 ## bgwriter_delay @@ -32,21 +32,21 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10~10000，单位为毫秒。 +**取值范围**: 整型，10~10000，单位为毫秒。 -**默认值:**2s +**默认值**: 2s **设置建议:**在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 ## candidate_buf_percent_target -**参数说明**：设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 +**参数说明**: 设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度浮点类型，0.1～0.85 +**取值范围**: 双精度浮点类型，0.1～0.85 -**默认值**：0.3 +**默认值**: 0.3 ## bgwriter_lru_maxpages @@ -54,13 +54,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000 +**取值范围**: 整型，0～1000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > > 此参数设置为0表示禁用后端写功能，禁用后端写功能不会对checkpoints产生影响。 -**默认值:**100 +**默认值**: 100 ## bgwriter_lru_multiplier @@ -74,39 +74,39 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0~10。 +**取值范围**: 浮点型，0~10。 -**默认值:**2 +**默认值**: 2 ## pagewriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～8 +**取值范围**: 整型，1～8 -**默认值**：2 +**默认值**: 2 ## dirty_page_percent_max -**参数说明**：设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 +**参数说明**: 设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.1～1 +**取值范围**: 浮点型，0.1～1 -**默认值**：0.9 +**默认值**: 0.9 ## pagewriter_sleep -**参数说明**：设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 +**参数说明**: 设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～3600000（毫秒） +**取值范围**: 整型，0～3600000（毫秒） -**默认值**：2000ms +**默认值**: 2000ms ## max_io_capacity @@ -114,6 +114,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，30720~10485760。单位是KB。 +**取值范围**: 整型，30720~10485760。单位是KB。 -**默认值:**512000KB（500MB） +**默认值**: 512000KB（500MB） diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md index 03d2a38e..b29c6ccb 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值:**off +**默认值**: off ## enable_adio_function @@ -26,12 +26,12 @@ date: 2021-04-20 当前版本暂不支持开启异步IO功能，默认该功能关闭，请勿自行修改。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## enable_fast_allocate @@ -39,12 +39,12 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。只有在XFS文件系统上才能开启该开关。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值:**off +**默认值**: off ## prefetch_quantity @@ -52,9 +52,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**32MB (4096 * 8KB) +**默认值**: 32MB (4096 * 8KB) ## backwrite_quantity @@ -64,9 +64,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值:**8MB (1024 * 8KB) +**默认值**: 8MB (1024 * 8KB) ## cstore_prefetch_quantity @@ -74,9 +74,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**32MB +**默认值**: 32MB ## cstore_backwrite_quantity @@ -84,9 +84,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## cstore_backwrite_max_threshold @@ -94,9 +94,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096～INT_MAX/2，单位为KB。 +**取值范围**: 整型，4096～INT_MAX/2，单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## fast_extend_file_size @@ -104,9 +104,9 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值:**8MB +**默认值**: 8MB ## effective_io_concurrency @@ -114,36 +114,36 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型 ，0~1000 +**取值范围**: 整型 ，0~1000 -**默认值:**1 +**默认值**: 1 ## checkpoint_flush_after -**参数说明**：设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 -**默认值**：32 +**默认值**: 32 ## bgwriter_flush_after -**参数说明**：设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：512KB（即64个页面） +**默认值**: 512KB（即64个页面） ## backend_flush_after -**参数说明**：设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8K）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/5-parallel-import.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/5-parallel-import.md index 623f1f8c..b27d3fee 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/5-parallel-import.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/5-parallel-import.md @@ -20,7 +20,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示导入时区分"导入文件记录数为空"和"导入文件不存在"。 - off表示导入时不区分"导入文件记录数为空"和"导入文件不存在"。 -**默认值:**off +**默认值**: off ## partition_mem_batch @@ -30,7 +30,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 **取值范围**: 1~ 65535 -**默认值:**256 +**默认值**: 256 ## partition_max_cache_size @@ -42,7 +42,7 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 列存分区表: 4096~ INT_MAX / 2，最小单位为KB。 -**默认值:**2GB +**默认值**: 2GB ## enable_delta_store @@ -55,4 +55,4 @@ MogDB提供了并行导入功能，以快速、高效地完成大量数据导入 - on表示开启列存delta表功能。 - off表示不开启列存delta表功能。 -**默认值:**off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md index f863c89d..0166ec42 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md @@ -40,7 +40,7 @@ date: 2021-04-20 这个参数表示WAL日志支持逻辑复制。 -**默认值:**hot_standby +**默认值**: hot_standby ## fsync @@ -53,12 +53,12 @@ date: 2021-04-20 > - 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 > - 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示使用fsync()系统函数。 - off表示不使用fsync()系统函数。 -**默认值:**on +**默认值**: on ## synchronous_commit @@ -82,7 +82,7 @@ date: 2021-04-20 - 0表示异步提交。 - 2表示将备机同步日志回放完成。 -**默认值:**off +**默认值**: off ## wal_sync_method @@ -114,7 +114,7 @@ date: 2021-04-20 > > 不是所有的平台都支持以上参数。 -**默认值:**fdatasync +**默认值**: fdatasync ## full_page_writes @@ -127,12 +127,12 @@ date: 2021-04-20 > - 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 > - 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用此特性。 - off表示关闭此特性。 -**默认值:**on +**默认值**: on ## wal_log_hints @@ -140,12 +140,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示整个页面全部内容写到WAL日志中。 - off表示整个页面内容不会写到WAL日志中。 -**默认值:**on +**默认值**: on ## wal_buffers @@ -153,12 +153,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**-1~218 +**取值范围**: -1~218 - 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，为shared_buffers的1/32，最小值为8个XLOG_BLCKSZ，最大值为2048个XLOG_BLCKSZ。 - 如果设置为其他值，当小于4时，会被默认设置为4。 -**默认值:**16MB +**默认值**: 16MB **设置建议:**每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 @@ -174,7 +174,7 @@ date: 2021-04-20 **取值范围**: 整型， 1～10000（毫秒） -**默认值:**200ms +**默认值**: 200ms ## commit_delay @@ -189,7 +189,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～100000（微秒），其中0表示无延迟。 -**默认值:**0 +**默认值**: 0 ## commit_siblings @@ -199,7 +199,7 @@ date: 2021-04-20 **取值范围**: 整型， 0～1000 -**默认值:**5 +**默认值**: 5 ## wal_block_size @@ -209,7 +209,7 @@ date: 2021-04-20 **取值范围**: 整型，单位为Byte。 -**默认值:**8192 +**默认值**: 8192 ## wal_segment_size @@ -219,4 +219,4 @@ date: 2021-04-20 **取值范围**: 整型，单位为8KB。 -**默认值:**16MB (2048 * 8KB) +**默认值**: 16MB (2048 * 8KB) diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md index 864a9644..5617970b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md @@ -17,7 +17,7 @@ date: 2021-04-20 提升此参数可加快大数据的导入速度，但需要结合[checkpoint_timeout](#checkpoint_timeout)、shared_buffers这两个参数统一考虑。这个参数同时影响WAL日志段文件复用数量，通常情况下pg_xlog文件夹下最大的复用文件个数为2倍的checkpoint_segments个，复用的文件被改名为后续即将使用的WAL日志段文件，不会被真正删除。 -**默认值:**64 +**默认值**: 64 ## checkpoint_timeout @@ -29,7 +29,7 @@ date: 2021-04-20 在提升[checkpoint_segments](#checkpoint_segments)以加快大数据导入的场景也需将此参数调大，同时这两个参数提升会加大shared_buffers的负担，需要综合考虑。 -**默认值:**15min +**默认值**: 15min ## checkpoint_completion_target @@ -39,7 +39,7 @@ date: 2021-04-20 **取值范围**: 0.0～1.0 -**默认值:**0.5 +**默认值**: 0.5 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 默认值0.5表示: 每个checkpoint需要在checkpoints间隔时间的50%内完成。 @@ -52,7 +52,7 @@ date: 2021-04-20 **取值范围**: 整型，0~INT_MAX（秒），其中0表示关闭警告。 -**默认值:**5min +**默认值**: 5min **推荐值:**5min @@ -64,7 +64,7 @@ date: 2021-04-20 **取值范围**: 整型，2～3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_incremental_checkpoint @@ -74,7 +74,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## enable_double_write @@ -84,7 +84,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## incremental_checkpoint_timeout @@ -94,7 +94,7 @@ date: 2021-04-20 **取值范围**: 整型，1~3600（秒） -**默认值:**1min +**默认值**: 1min ## enable_xlog_prune @@ -107,7 +107,7 @@ date: 2021-04-20 - 设置为on时，如果任一备机断联时，主机不回收日志。 - 设置为off时，如果任一备机断联时，主机回收日志。 -**默认值:**on +**默认值**: on ## max_redo_log_size @@ -117,7 +117,7 @@ date: 2021-04-20 **取值范围**: 整型，163840 ~ 2147483647，单位为KB。 -**默认值:**1GB +**默认值**: 1GB ## max_size_for_xlog_prune @@ -127,4 +127,4 @@ date: 2021-04-20 **取值范围**: 整型，0～2147483647，单位为KB -**默认值:**2147483647，单位KB +**默认值**: 2147483647，单位KB diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md index 86f0d4b5..f55aec38 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md @@ -17,7 +17,7 @@ date: 2021-04-20 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。 -**默认值:**0 +**默认值**: 0 ## recovery_max_workers @@ -27,7 +27,7 @@ date: 2021-04-20 **取值范围**: 整型，0~20 -**默认值:**1 （安装工具默认将设置为4以获得更好的性能） +**默认值**: 1 （安装工具默认将设置为4以获得更好的性能） ## recovery_parse_workers @@ -39,7 +39,7 @@ date: 2021-04-20 仅在开启极致RTO情况下可以设置recovery_parse_workers为>1。需要配合recovery_redo_workers使用。若同时开启recovery_parse_workers和recovery_max_workers，以开启极致RTO的recovery_parse_workers为准，并行回放特性失效。因极致RTO不支持hot standby模式和主备从模式, 仅在参数hot_standby设置成off，replication_type设置成1时可以设置recovery_parse_workers为>1。另外，极致RTO也不支持列存，在已经使用列存表或者即将使用列存表的系统中，请关闭极致RTO. -**默认值:**1 +**默认值**: 1 ## recovery_redo_workers @@ -51,7 +51,7 @@ date: 2021-04-20 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于0，recovery_redo_workers参数才生效。 -**默认值:**1 +**默认值**: 1 ## recovery_parallelism @@ -61,7 +61,7 @@ date: 2021-04-20 该参数受参数: recovery_max_workers及参数: recovery_parse_workers影响，上述任意一参数值大于0时，该参数值将重新计算。 -**默认值:**1 +**默认值**: 1 ## enable_page_lsn_check @@ -71,7 +71,7 @@ date: 2021-04-20 **取值范围**: 布尔型 -**默认值:**on +**默认值**: on ## recovery_min_apply_delay @@ -79,7 +79,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数主节点设置无效，必须设置在需要延迟的备节点上。 > - 延迟时间是根据主服务器上事物提交的时间戳与备机上的当前时间来计算，因此需要保证主备系统时钟一致。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md index c78b1fa9..8ac7a0c2 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md @@ -21,7 +21,7 @@ date: 2021-04-20 - on表示进行归档。 - off表示不进行归档。 -**默认值:**off +**默认值**: off ## archive_command @@ -56,7 +56,7 @@ date: 2021-04-20 **取值范围**: 字符串 -**默认值:**(disabled) +**默认值**: (disabled) ## archive_dest @@ -74,7 +74,7 @@ date: 2021-04-20 > archive_dest = '/mnt/server/archivedir/' > ``` -**默认值:**空字符串 +**默认值**: 空字符串 ## archive_timeout diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md index a18cdf80..1e09f49d 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md @@ -17,7 +17,7 @@ date: 2021-04-20 **取值范围**: 整型，0～262143 -**默认值:**16 +**默认值**: 16 ## wal_keep_segments @@ -25,9 +25,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2 ~ INT_MAX +**取值范围**: 整型，2 ~ INT_MAX -**默认值:**16 +**默认值**: 16 **设置建议:** @@ -47,9 +47,9 @@ date: 2021-04-20 > - 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为 600s。 > - 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值:**6s +**默认值**: 6s ## max_replication_slots @@ -57,9 +57,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0~262143。 +**取值范围**: 整型， 0~262143。 -**默认值:**8 +**默认值**: 8 **设置建议**: @@ -109,9 +109,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第一个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第一个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo2 @@ -119,9 +119,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第二个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第二个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo3 @@ -129,9 +129,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第三个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第三个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo4 @@ -139,9 +139,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第四个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第四个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo5 @@ -149,9 +149,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第五个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第五个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo6 @@ -159,9 +159,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第六个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第六个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo7 @@ -169,9 +169,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第七个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第七个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## replconninfo8 @@ -179,9 +179,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第八个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第八个节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 ## available_zone @@ -189,6 +189,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置节点信息。 -**默认值:**空字符串 +**默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md index bf3362da..194bc682 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md @@ -24,7 +24,7 @@ date: 2021-04-20 - [FIRST] **num_sync (standby_name** [, …]) - **standby_name** [, …] -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 其中 **num_sync** 是事务需要等待其回复的同步复制的备机的数量，**standby_name** 是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略 > @@ -54,7 +54,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在有同步备机故障时，不阻塞主机。 - off表示在有同步备机故障时，阻塞主机。 @@ -72,7 +72,7 @@ date: 2021-04-20 > - 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 > - 此参数属于受控参数，不建议正常业务场景下关闭此参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开主备、主从同步。 - off表示关闭主备、主从同步。 @@ -89,7 +89,7 @@ date: 2021-04-20 > > 此参数目前不允许正常业务场景下改变其值，即关闭WAL日志、数据页混合复制模式。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开WAL日志、数据页混合复制模式。 - off表示关闭WAL日志、数据页混合复制模式。 @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000000，值为0表示不延迟。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。 **默认值**: 0 @@ -112,9 +112,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1072693248，单位为KB。 +**取值范围**: 整型，4096~1072693248，单位为KB。 -**默认值:**16MB（即16448KB） +**默认值**: 16MB（即16448KB） ## walsender_max_send_size @@ -122,9 +122,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~INT_MAX，单位为KB。 +**取值范围**: 整型，8~INT_MAX，单位为KB。 -**默认值:**8M（即8192KB） +**默认值**: 8M（即8192KB） ## enable_data_replicate @@ -132,12 +132,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 - off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 -**默认值:**off +**默认值**: off ## ha_module_debug @@ -145,12 +145,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示日志中将打印数据复制时每个数据块的状态。 - off表示日志中不打印数据复制时每个数据块的状态。 -**默认值:**off +**默认值**: off ## enable_incremental_catchup @@ -158,7 +158,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示备机catchup时用增量catchup方式，即从从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 - off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 @@ -171,7 +171,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围1~INT_MAX，单位为秒 +**取值范围**: 整型，范围1~INT_MAX，单位为秒 **默认值**: 300 @@ -185,7 +185,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围-1~10000，单位为毫秒。 +**取值范围**: 整型，范围-1~10000，单位为毫秒。 - -1表示主机阻塞直到备机数据追赶完成。 - 0表示备机数据追赶时始终不阻塞主机。 @@ -199,7 +199,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 - only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 @@ -207,7 +207,7 @@ date: 2021-04-20 **默认值：**all_node -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 在一个包含了主机、备机和级联备的MogDB集群中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。 > - 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要将集群中所有节点的sync_config_strategy参数配置为none_node；若仅希望主机与同步备机同步配置文件，则需要将主机的sync_config_strategy参数配置为only_sync_node，其余节点配置为none_node；若希望所有节点同步配置文件，则需要将所有节点的sync_config_strategy参数配置为all_node。目前暂不支持自定义指定任意节点间的同步策略。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md index 0dc392ca..68f4e507 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md @@ -18,12 +18,12 @@ date: 2021-04-20 > - 如果此参数设置为on，wal_level必须设置为hot_standby，否则将导致数据库无法启动。 > - 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许备机在恢复过程中连接和查询。 - off表示不允许备机在恢复过程中连接和查询。 -**默认值:**on +**默认值**: on ## max_standby_archive_delay @@ -35,9 +35,9 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型，范围: -1~INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围: -1~INT_MAX，单位为毫秒。 -**默认值:**3s**（即**3000ms） +**默认值**: 3s**（即**3000ms） ## max_standby_streaming_delay @@ -49,7 +49,7 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型（毫秒），范围: -1~INT_MAX +**取值范围**: 整型（毫秒），范围: -1~INT_MAX **默认值: 3s（即**3000ms） @@ -59,9 +59,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围: 0 ~ INT_MAX ，单位为毫秒。 +**取值范围**: 整型，范围: 0 ~ INT_MAX ，单位为毫秒。 -**默认值:**5s**（即**5000ms） +**默认值**: 5s**（即**5000ms） ## hot_standby_feedback @@ -69,12 +69,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许将备机上执行查询的最小事务号反馈给主机。 - off表示不允许将备机上执行查询的最小事务号反馈给主机。 -**默认值:**off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > @@ -86,9 +86,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型， 0 ~ INT_MAX，单位为毫秒。 -**默认值:**6s（即6000ms） +**默认值**: 6s（即6000ms） ## wal_receiver_connect_timeout @@ -96,9 +96,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0 ~ INT_MAX / 1000，单位为秒。 +**取值范围**: 整型， 0 ~ INT_MAX / 1000，单位为秒。 -**默认值:**2s +**默认值**: 2s ## wal_receiver_connect_retries @@ -106,9 +106,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 1~ INT_MAX。 +**取值范围**: 整型， 1~ INT_MAX。 -**默认值:**1 +**默认值**: 1 ## wal_receiver_buffer_size @@ -116,9 +116,9 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1047552，单位为KB。 +**取值范围**: 整型，4096~1047552，单位为KB。 -**默认值:**64MB（即65536KB） +**默认值**: 64MB（即65536KB） ## primary_slotname @@ -126,9 +126,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符型 +**取值范围**: 字符型 -**默认值:**空字符串 +**默认值**: 空字符串 ## config_sync_interval diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md index 9b557680..6946d1d0 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md @@ -197,12 +197,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示正则表达式采用A格式的匹配规则。 - off表示正则表达式采用POSIX格式的匹配规则。 -**默认值:**on +**默认值**: on ## max_recursive_times @@ -246,12 +246,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以使用绝对路径。 - off表示不可以使用绝对路径。 -**默认值:**on +**默认值**: on ## enable_valuepartition_pruning @@ -259,12 +259,12 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示对DFS分区表进行静态/动态优化。 - off表示不对DFS分区表进行静态/动态优化。 -**默认值:**on +**默认值**: on ## expected_computing_nodegroup @@ -337,13 +337,13 @@ date: 2021-04-20 ## check_implicit_conversions -**参数说明**：控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 +**参数说明**: 控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 - off表示不进行相关检查。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md index 84123b97..058f9800 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这个参数的取值必须是绝对路径加上.csv格式的文件名。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这个参数的取值必须是绝对路径加上.csv格式的文件名。 **取值范围**: 字符串 @@ -21,18 +21,18 @@ date: 2021-04-20 ## explain_perf_mode -**参数说明**：此参数用来指定explain的显示格式。 +**参数说明**: 此参数用来指定explain的显示格式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：normal、pretty、summary、run +**取值范围**: normal、pretty、summary、run - normal：代表使用默认的打印格式。 - pretty：代表使用MogDB改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 - summary：是在pretty的基础上增加了对打印信息的分析。 - run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。 -**默认值**：normal +**默认值**: normal ## analysis_options @@ -48,13 +48,13 @@ date: 2021-04-20 - STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pretty模式当前版本不支持。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pretty模式当前版本不支持。 **默认值：**ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 ## cost_param -**参数说明**：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 +**参数说明**: 该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1 不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确。目前，已弃用cost_param & 1 不为0时的路径，默认选择更优的估算公式； @@ -62,26 +62,26 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：0 +**默认值**: 0 ## enable_partitionwise -**参数说明**：分区表连接操作是否选择智能算法。 +**参数说明**: 分区表连接操作是否选择智能算法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示选择智能算法。 - off表示不选择智能算法。 -**默认值**：off +**默认值**: off ## rewrite_rule -**参数说明**：标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 +**参数说明**: 标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 此参数可以控制查询重写规则的组合，比如有多个重写规则：rule1、rule2、rule3、rule4。可以设置： @@ -93,7 +93,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何可选查询重写规则。 - lazyagg：使用Lazy Agg查询重写规则（消除子查询中的聚集运算）。 @@ -106,48 +106,48 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 - predpushforce：使用Predicate Push查询重写规则（下推谓词条件到子查询中，尽可能的利用索引加速）。 - predpush：在predpushnormal和predpushforce中根据代价选择最优计划。 -**默认值**：magicset +**默认值**: magicset ## enable_pbe_optimization -**参数说明**：设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 +**参数说明**: 设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化PBE语句的查询计划。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_light_proxy -**参数说明**：设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 +**参数说明**: 设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化数据库主节点上简单查询的执行。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_global_plancache -**参数说明**：设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 +**参数说明**: 设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示对PBE查询的执行计划进行缓存共享。 - off表示不共享。 -**默认值**：off +**默认值**: off ## enable_global_stats @@ -164,7 +164,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 ## enable_opfusion -**参数说明**：控制是否对简单增删改查进行优化。 +**参数说明**: 控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -214,29 +214,29 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 c3列修改的值可以是常量和参数，也可以是一个简单的表达式，c1和c2列为索引列，后边可以是常量或者参数。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_partition_opfusion -**参数说明**：在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 +**参数说明**: 在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## sql_beta_feature -**参数说明**：标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 +**参数说明**: 标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 开启它们可以对特定的场景进行优化，但也可能会导致部分没有被测试覆盖的场景发生性能劣化。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 @@ -253,7 +253,7 @@ set sql_beta_feature=none; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何Beta优化器特性。 - sel_semi_poisson：使用泊松分布对等值的半连接和反连接选择率进行校准。 @@ -264,7 +264,7 @@ set sql_beta_feature=none; - page_est_opt：优化对非列存表索引analyze信息的relpages估算。 - no_unique_index_first：关闭主键索引扫描路径优先的优化。 -**默认值**：none +**默认值**: none ## ngram_gram_size @@ -304,28 +304,28 @@ set sql_beta_feature=none; ## default_statistics_target -**参数说明**：为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 +**参数说明**: 为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-100～10000。 +**取值范围**: 整型，-100～10000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 比默认值大的正数数值增加了ANALYZE所需的时间，但是可能会改善优化器的估计质量。 > - 调整此参数可能存在性能劣化的风险，如果某个查询劣化，可以考虑 1. 恢复默认的统计信息。 2. 使用plan hint来调整到之前的查询计划。（详细参见**使用Plan Hint进行调优**） > - 当此guc参数设置为负数时，如果计算的采样样本数大于等于总数据量的2%，且用户表的数据量小于1600000时，ANALYZE所需时间相比guc参数为默认值的时间会有所增加。 > - 当此guc参数设置为负数时，则autoanalyze不生效。 -**默认值**：100 +**默认值**: 100 ## constraint_exclusion -**参数说明**：控制查询优化器使用表约束查询的优化。 +**参数说明**: 控制查询优化器使用表约束查询的优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on表示检查所有表的约束。 @@ -333,75 +333,75 @@ set sql_beta_feature=none; - partition表示只检查继承的子表和UNION ALL子查询。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 -**默认值**：partition +**默认值**: partition -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 ## cursor_tuple_fraction -**参数说明**：优化器估计游标获取行数在总行数中的占比。 +**参数说明**: 优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～1.0。 +**取值范围**: 浮点型，0.0～1.0。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 -**默认值**：0.1 +**默认值**: 0.1 ## from_collapse_limit -**参数说明**：根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 +**参数说明**: 根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 -**默认值**：8 +**默认值**: 8 ## join_collapse_limit -**参数说明**：根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 +**参数说明**: 根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。 > - 比默认值小的数值减少规划时间但也降低了执行计划的质量。 -**默认值**：8 +**默认值**: 8 ## plan_mode_seed -**参数说明**：该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 +**参数说明**: 该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~ 2147483647 +**取值范围**: 整型，-1~ 2147483647 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 > - 当该参数不为0时，查询指定的plan hint不会生效。 ## hashagg_table_size -**参数说明**：用于设置执行HASH JOIN操作时HASH表的大小。 +**参数说明**: 用于设置执行HASH JOIN操作时HASH表的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX/2。 +**取值范围**: 整型，0～INT_MAX/2。 -**默认值**：0 +**默认值**: 0 ## enable_codegen @@ -415,7 +415,7 @@ set sql_beta_feature=none; - off表示不允许开启代码生成优化。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 **默认值：**on @@ -431,7 +431,7 @@ set sql_beta_feature=none; - pure表示当所计算表达式整体可被codegen化时，才考虑调用LLVM动态编译优化策略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 **默认值：**partial @@ -515,7 +515,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。 - off表示不使用面向列的hash表设计的Hash Agg算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景enable_codegen打开后获得较大性能提升)，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为“Sonic Hash Aggregation”，而未达到该约束条件时，算子名称将显示为“Hash Aggregation”，Explain详解请参见详解。 @@ -533,7 +533,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。 - off表示不使用面向列的hash表设计的Hash Join算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前开关仅适用于Inner Join的场景。 > - 在开启enable_sonic_hashjoin，查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景，对应的算子查询性能可能会出现劣化。 @@ -556,118 +556,118 @@ set sql_beta_feature=none; ## log_parser_stats -**参数说明**：控制优化器输出parser模块的性能日志。 +**参数说明**: 控制优化器输出parser模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_planner_stats -**参数说明**：控制优化器输出planner模块的性能日志。 +**参数说明**: 控制优化器输出planner模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_executor_stats -**参数说明**：控制优化器输出executor模块的性能日志。 +**参数说明**: 控制优化器输出executor模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_statement_stats -**参数说明**：控制优化器输出该语句的性能日志。 +**参数说明**: 控制优化器输出该语句的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## plan_cache_mode -**参数说明**：标识在prepare语句中，选择生成执行计划的策略。 +**参数说明**: 标识在prepare语句中，选择生成执行计划的策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - auto表示按照默认的方式选择custom plan或者generic plan。 - force_generic_plan表示强制走generic plan。 - force_custom_plan表示强制走custom plan。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 > - custom plan是指对于preapre语句，在执行execute的时候，把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划，这种方案的优点是每次都按照具体的参数生成优选计划，执行性能比较好；缺点是每次执行前都需要重新生成计划，存在大量的重复的优化器开销。 > - generic plan是指对于preapre语句生成计划，该计划策略会在执行execute语句的时候把参数bind到plan中，然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销；缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的，部分bind参数场景下执行性能较差。 -**默认值**：auto +**默认值**: auto ## enable_hypo_index -**参数说明**：控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 +**参数说明**: 控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_force_vector_engine -**参数说明**：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 +**参数说明**: 对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以向量化的算子强制生成向量化。 - off表示由向量化算子优化器决定是否向量化。 -**默认值**：off +**默认值**: off ## enable_auto_explain -**参数说明**：控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 +**参数说明**: 控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，true表示开启，false表示关闭。 +**取值范围**: 布尔型，true表示开启，false表示关闭。 -**默认值**：false +**默认值**: false ## auto_explain_level -**参数说明**：控制自动打印执行计划的日志等级。 +**参数说明**: 控制自动打印执行计划的日志等级。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 +**取值范围**: 枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 -**默认值**：LOG +**默认值**: LOG diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/2-keywords.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/2-keywords.md index fb74cb82..25d93a78 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/2-keywords.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/2-keywords.md @@ -15,7 +15,7 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 - 标识符必须以字母（a-z）或下划线（_）开头。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此命名规范为建议项，非强制项。 > - 特殊情况下可以使用双引号规避特殊字符报错。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md index 67c7f7a4..66e5041f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md @@ -35,7 +35,7 @@ date: 2021-05-17 expression NOTNULL - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 不要写expression=NULL或expression<>(!=)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md index a08bf6f0..301178b7 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md @@ -43,7 +43,7 @@ mogdb=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; 如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 ## ANY/SOME (array) @@ -70,7 +70,7 @@ mogdb=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - 如果对比结果没有真值，则ANY的结果为false。 - 如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** SOME是ANY的同义词。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: SOME是ANY的同义词。 ## ALL (array) diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/2-operators.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/2-operators.md index f010ccc7..514c9535 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/2-operators.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/2-operators.md @@ -63,7 +63,7 @@ mogdb=# SELECT 'abc' || 'def' AS "unspecified"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 因为查询中没有声明任何类型，所以本例中对类型没有任何初始提示。因此，分析器查找所有候选操作符，发现既存在接受字符串类型范畴的操作符也存在接受位串类型范畴的操作符。因为字符串类型范畴是首选，所以选择字符串类型范畴的首选类型text作为解析未知类型文本的声明类型。 示例3：绝对值和取反操作符类型分析。MogDB操作符表里面有几条记录对应于前缀操作符@，它们都用于为各种数值类型实现绝对值操作。其中之一用于float8类型，它是数值类型范畴中的首选类型。因此，在面对unknown输入的时候， MogDB会使用该类型： @@ -88,5 +88,5 @@ mogdb=# SELECT array[1,2] <@ '{1,2,3}' as "is subset"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB操作符表有几条记录对应于中缀操作符<@，但是只有两个可以在左侧接受一个整数数组的操作符是数组包含(anyarray <@ anyarray) 和范围包含(anyelement <@ anyrange)的。因为没有多态的伪类型(参阅伪类型)是首选的，所以解析器不能解决这个基础上的歧义。然而，最后一个解析规则告诉用户，假设未知类型的文字是和另外一个输入相同的类型，也就是，整数数组。现在只有两个操作符中的一个可以匹配，所以选择数组包含。（如果用户选择了范围包含，用户将得到一个错误，因为字符串没有正确的格式成为范围的文字。） diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/3-functions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/3-functions.md index bb5f329a..83eddbd5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/3-functions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/3-functions.md @@ -79,7 +79,7 @@ mogdb=# SELECT substr(varchar '1234', 3); mogdb=# SELECT substr(CAST (varchar '1234' AS text), 3); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 分析器从pg_cast表中了解到text和varchar是二进制兼容的，意思是说一个可以传递给接受另一个的函数而不需要做任何物理转换。因此，在这种情况下，实际上没有做任何类型转换。 而且，如果以integer为参数调用函数，分析器将试图将其转换成text类型： diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md index da6d1dd4..f8727d5d 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md @@ -32,5 +32,5 @@ mogdb=# SELECT VS_COL1, octet_length(VS_COL1) FROM tpcds.value_storage_t1; mogdb=# DROP TABLE tpcds.value_storage_t1; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这里真正发生的事情是两个unknown文本缺省解析成text，这样就允许||操作符解析成text连接。然后操作符的text结果转换成bpchar(“空白填充的字符型”， character类型内部名称)以匹配目标字段类型。不过，从text到bpchar的转换是二进制兼容的，这样的转换是隐含的并且实际上不做任何函数调用。最后，在系统表里找到长度转换函数bpchar(bpchar, integer, Boolean) 并且应用于该操作符的结果和存储的字段长。这个类型相关的函数执行所需的长度检查和额外的空白填充。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md index c53583f7..d351a6b8 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md @@ -19,7 +19,7 @@ SQL UNION构造必须把那些可能不太相似的类型匹配起来成为一 - 如果输入类型是同一个类型范畴，则选择该类型范畴的首选类型。（例外：union操作会选择第一个分支的类型作为所选类型。） - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 系统表pg_type中typcategory表示数据类型范畴， typispreferred表示是否是typcategory分类中的首选类型。 - 把所有输入转换为所选的类型（对于字符串保持原有长度）。如果从给定的输入到所选的类型没有隐式转换则失败。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md index 0f1388ec..5ba969c3 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md @@ -25,7 +25,7 @@ identify_serials (7 rows) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 实际上，在这些示例查询中，应该使用coalesce防止一个独立的NULL属性导致整个文档的NULL结果。 另外一种可能是：文档在文件系统中作为简单的文本文件存储。在这种情况下，数据库可以用于存储全文索引并且执行搜索，同时可以使用一些唯一标识从文件系统中检索文档。然而，从数据库外部检索文件需要拥有系统管理员权限或者特殊函数支持。因此，还是将所有数据保存在数据库中比较方便。同时，将所有数据保存在数据库中可以方便地访问文档元数据以便于索引和显示。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md index 72583ded..13dbea3c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md @@ -19,7 +19,7 @@ MogDB提供了用来操作tsvector类型的函数和操作符。 setweight返回一个输入tsvector的副本，其中每一个位置都使用给定的权重做了标记。权值可以为A、B、C或D（D是tsvector副本的默认权重，并且不在输出中呈现）。当对tsvector进行连接操作时，这些权重标签将会被保留，文档不同部分以不同的权重进行排序。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 权重标签作用于位置，而不是词素。如果传入的tsvector已经被剥离了位置信息，那么setweight函数将什么都不做。 - length(vector tsvector) returns integer diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md index 06712a09..331941f2 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md @@ -24,7 +24,7 @@ ts_rewrite函数族可以从tsquery中搜索一个特定的目标子查询，并 ts_rewrite的这种形式接受一个起始查询和SQL查询命令。 这里的查询命令是文本字串形式，必须产生两个tsquery列。查询结果的每一行，第一个字段的值（目标子查询） 都会被第二个字段（替代子查询）替换。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 当多个规则需要重写时，重写顺序非常重要； 因此在实践中需要使用ORDER BY将源查询按照某些字段进行排序。 例如：举一个现实生活中天文学上的例子。我们将使用表驱动的重写规则扩大supernovae的查询范围： diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md index 8e6d7d0f..122c26a5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md @@ -25,5 +25,5 @@ mogdb=# SELECT ts_lexize('english_stem', 'a'); {} ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > ts_lexize函数支持单一token，不支持文本。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/8-controlling-transactions.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/8-controlling-transactions.md index a839b24a..41dcf68b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/8-controlling-transactions.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/8-controlling-transactions.md @@ -25,5 +25,5 @@ MogDB通过COMMIT或者END可完成提交事务的功能，即提交事务的所 回滚是在事务运行的过程中发生了某种故障，事务不能继续执行，系统将事务中对数据库的所有已完成的操作全部撤销。请参考**ROLLBACK**。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，如果其中有一个语句失败，那么整个请求都将会被回滚。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/9-ddl-syntax-overview.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/9-ddl-syntax-overview.md index 4e0d7c52..5a7d7678 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/9-ddl-syntax-overview.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-reference/9-ddl-syntax-overview.md @@ -9,7 +9,7 @@ date: 2021-05-17 DDL（Data Definition Language数据定义语言），用于定义或修改数据库中的对象。如：表、索引、视图等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB不支持数据库主节点不完整时进行DDL操作。例如：MogDB中有1个数据库主节点故障时执行新建数据库、表等操作都会失败。 ## 定义数据库 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/101-DROP-USER.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/101-DROP-USER.md index 2294559e..3591d210 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/101-DROP-USER.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/101-DROP-USER.md @@ -44,7 +44,7 @@ DropUser ::= DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; - RESTRICT：如果用户还有任何依赖的对象，则拒绝删除该用户（缺省行为）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在MogDB中，存在一个配置参数enable_kill_query，此参数在配置文件postgresql.conf中。此参数影响级联删除用户对象的行为： > > - 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的进程，并删除用户。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md index 1ff98cb6..f1b3e9c5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md @@ -25,7 +25,7 @@ FOR statement ; - STATEMENT_ID用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。 ## 注意事项 @@ -40,7 +40,7 @@ FOR statement ; 1. 执行EXPLAN PLAN。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。 > PLAN_TABLE详细介绍见**PLAN_TABLE**。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/108-GRANT.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/108-GRANT.md index 886bc45c..9bd38cac 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/108-GRANT.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/108-GRANT.md @@ -99,7 +99,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予域的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予域的访问权限。 - 将客户端加密主密钥CMK的访问权限赋予指定的用户或角色。 @@ -165,7 +165,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持大对象。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持大对象。 - 将模式的访问权限赋予指定的用户或角色。 @@ -176,7 +176,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。 - 将表空间的访问权限赋予指定的用户或角色。 @@ -196,7 +196,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予类型的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予类型的访问权限。 - 将角色的权限赋予其他用户或角色的语法。 @@ -408,7 +408,7 @@ GRANT的参数说明如下所示。 - 如果用户有该对象上的部分权限，则GRANT命令只授予他有授权选项的权限。 - 如果用户没有可用的授权选项，GRANT ALL PRIVILEGES形式将发出一个警告信息，其他命令形式将发出在命令中提到的且没有授权选项的相关警告信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/109-INSERT.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/109-INSERT.md index 67622892..97820a0f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/109-INSERT.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/109-INSERT.md @@ -23,7 +23,7 @@ date: 2021-05-18 - 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的insert语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 ## 语法格式 @@ -58,7 +58,7 @@ INSERT INTO table_name [ ( column_name [, ...] ) ] - 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。 - **table_name** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/111-MOVE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/111-MOVE.md index 9ce53e57..147a1016 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/111-MOVE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/111-MOVE.md @@ -44,7 +44,7 @@ direction ::= NEXT MOVE命令的参数与FETCH的相同，详细请参见FETCH的参数说明。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 成功完成时，MOVE命令将返回一个“MOVE count”的标签，count是一个使用相同参数的FETCH命令会返回的行数（可能为零）。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/117-REINDEX.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/117-REINDEX.md index 5aa2f3a6..b855a24c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/117-REINDEX.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/117-REINDEX.md @@ -63,7 +63,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 - **FORCE** @@ -80,7 +80,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 - 如果前面是REINDEX TABLE，则这里应该指定分区的名称； - 如果前面是REINDEX INTERNAL TABLE，则这里应该指定列存分区表的分区的名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/125-SELECT.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/125-SELECT.md index 36add37f..2907f4b3 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/125-SELECT.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/125-SELECT.md @@ -39,7 +39,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > condition和expression中可以使用targetlist中表达式的别名。 - 只能同一层引用。 > @@ -87,7 +87,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 FOR ( partition_value [, ...] ) }; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定分区只适合普通表。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定分区只适合普通表。 - 其中设置排序方式nlssort_expression_clause为： @@ -133,7 +133,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 ON ( expression [, …] ) 只保留那些在给出的表达式上运算出相同结果的行集合中的第一行。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 - **SELECT列表** @@ -224,7 +224,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 CROSS JOIN等效于INNER JOIN ON（TRUE） ，即没有被条件删除的行。这种连接类型只是符号上的方便，因为它们与简单的FROM和WHERE的效果相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 其中CROSS JOIN和INNER JOIN生成一个简单的笛卡尔积，和在FROM的顶层列出两个项的结果相同。 @@ -261,7 +261,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 9. “(+)“只能出现”比较表达式”，”NOT表达式”，“ANY表达式”，“ALL表达式”，“IN表达式”，“NULLIF表达式”，“IS DISTINCT FROM表达式”，“IS OF”表达式。”(+)“不能出现在其他类型表达式中，并且这些表达式中不允许出现通过“AND”和“OR”连接的表达式。 10. “(+)“只能转化为左外连接或者右外连接，不能转化为全连接，即不能在一个表达式的两个表上同时指定”(+)“。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 - **GROUP BY子句** @@ -275,7 +275,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 GROUPING SETS子句是GROUP BY子句的进一步扩展，它可以使用户指定多个GROUP BY选项。 这样做可以通过裁剪用户不需要的数据组来提高效率。 当用户指定了所需的数据组时，数据库不需要执行完整CUBE或ROLLUP生成的聚合集合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 - **HAVING子句** @@ -315,7 +315,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 UNBOUNDED FOLLOWING ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 - **UNION子句** @@ -379,7 +379,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 - 如果对于所有声明的表达式都相同，则按随机顺序返回。 - ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果要支持中文拼音排序和不区分大小写排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: > > ```bash > initdb -E UTF8 -D ../data -locale=zh_CN.UTF-8或initdb -E GBK -D ../data -locale=zh_CN.GBK。 @@ -421,7 +421,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 如果一个表中同时出现（或隐含同时出现）在FOR UPDATE和FOR SHARE子句中，则按照FOR UPDATE处理。类似的，如果影响一个表的任意子句中出现了NOWAIT，该表将按照NOWAIT处理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询不支持for update/share。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询不支持for update/share。 - **NLS_SORT** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/126-SELECT-INTO.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/126-SELECT-INTO.md index 3041785b..1a49dfe5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/126-SELECT-INTO.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/126-SELECT-INTO.md @@ -64,14 +64,14 @@ new_table指定新建表的名称。 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > SELECT INTO的其它参数可参考SELECT的参数说明。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md index 25ca7d3f..cb68f594 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md @@ -41,7 +41,7 @@ SetTransaction ::= { SET [ LOCAL ] TRANSACTION|SET SESSION CHARACTERISTICS AS TR 指定事务隔离级别，该参数决定当一个事务中存在其他并发运行事务时能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/134-START-TRANSACTION.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/134-START-TRANSACTION.md index 7eb111ee..c9b164fd 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/134-START-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/134-START-TRANSACTION.md @@ -51,7 +51,7 @@ Begin ::= BEGIN [ WORK | TRANSACTION ] 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/135-TRUNCATE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/135-TRUNCATE.md index efecad65..56fe1cb8 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/135-TRUNCATE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/135-TRUNCATE.md @@ -78,7 +78,7 @@ date: 2021-05-18 取值范围: 需要进行删除数据分区的分区键的取值范围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 使用PARTITION FOR子句时，partition_value所在的整个分区会被清空。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/136-UPDATE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/136-UPDATE.md index 1cfc3bc9..5f9dc3c8 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/136-UPDATE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/136-UPDATE.md @@ -86,7 +86,7 @@ sub_query ::= SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 - **condition** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/137-VACUUM.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/137-VACUUM.md index bd706763..75e545cd 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/137-VACUUM.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/137-VACUUM.md @@ -55,7 +55,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 - **FREEZE** @@ -93,7 +93,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 只针对列存表，将列存表的delta table中的数据转移到主表存储上。对列存表而言，此操作受enable_delta_store和参数说明中的deltarow_threshold控制。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 为了检查列存delta表中的信息，提供下述DFX函数，用于获取某个列存表的delta表中数据存储情况： > > - pgxc_get_delta_info(TEXT)，传入参数为列存表名，搜集并显示各个节点上的对应delta表信息，包括当前存活tuple数量、表大小、使用的最大block ID。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md index 88bcb60e..c712a79e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md @@ -69,7 +69,7 @@ date: 2021-05-17 AlterDatabase ::= ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。 > - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，普通用户只能查看有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。 @@ -126,7 +126,7 @@ date: 2021-05-17 重置全部的数据库会话参数值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。 > - 修改的数据库会话参数值，将在下一次会话中生效。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/22-ALTER-TABLE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/22-ALTER-TABLE.md index 388abe20..97febb5f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/22-ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/22-ALTER-TABLE.md @@ -67,7 +67,7 @@ date: 2021-05-17 | REPLICA IDENTITY {DEFAULT | USING INDEX index_name | FULL | NOTHING} ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD table_constraint [ NOT VALID ]** 给表增加一个新的约束。 @@ -132,7 +132,7 @@ date: 2021-05-17 | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 @@ -240,7 +240,7 @@ date: 2021-05-17 SET SCHEMA new_schema; ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。 - 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。 @@ -314,7 +314,7 @@ date: 2021-05-17 USING子句声明如何从旧的字段值里计算新的字段值；如果省略，缺省从旧类型向新类型的赋值转换。如果从旧数据类型到新类型没有隐含或者赋值的转换，则必须提供一个USING子句。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话），结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 - **NOT NULL | NULL** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md index 7c5679a6..c402a799 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md @@ -104,7 +104,7 @@ date: 2021-05-17 split_point_clause ::= AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 列存分区表不支持切割分区。 > - 切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。 @@ -115,7 +115,7 @@ date: 2021-05-17 no_split_point_clause ::= INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。 > - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。 @@ -154,7 +154,7 @@ date: 2021-05-17 [ TABLESPACE tablespacename ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - partition_list_item仅支持的1个分区键，其支持的数据类型参见**PARTITION BY LIST(partit…**。 > - 间隔/哈希分区表不支持添加分区。 @@ -165,7 +165,7 @@ date: 2021-05-17 drop_clause ::= DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 哈希分区表不支持删除分区。 > - 列表分区表仅支持通过子分区名称删除子分区。 @@ -249,7 +249,7 @@ date: 2021-05-17 在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 - **partition_new_name** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md index c5e2cb07..f5dfe971 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md @@ -17,7 +17,7 @@ date: 2021-05-17 - 要修改表空间的所有者A为B，则A必须是B的直接或者间接成员。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 ## 语法格式 @@ -88,7 +88,7 @@ date: 2021-05-17 - random_page_cost：设置优化器计算一次非顺序获取磁盘页面的开销。缺省为4.0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - random_page_cost是相对于seq_page_cost的取值，等于或者小于seq_page_cost时毫无意义。 > - 默认值为4.0的前提条件是，优化器采用索引来扫描表数据，并且表数据在cache中命中率可以90%左右。 @@ -107,7 +107,7 @@ date: 2021-05-17 - 由space_size来确定，其格式参考**CREATE TABLESPACE**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若调整后的限额值比当前表空间实际使用的值小，调整操作可以执行成功。后续用户需要将该表空间的使用值降低至新限额值之下，才能继续往该表空间中写入数据。 > diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md index 3637e8be..42c852e5 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md @@ -57,7 +57,7 @@ date: 2021-05-17 要修改的参数名。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不支持修改词典的TEMPLATE参数值。 > - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/28-ALTER-TYPE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/28-ALTER-TYPE.md index 4c03068b..58786464 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/28-ALTER-TYPE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/28-ALTER-TYPE.md @@ -163,7 +163,7 @@ date: 2021-05-17 如果需联动更新类型是已更新类型的关联记录，则拒绝更新。这是缺省选项。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - ADD ATTRIBUTE、DROP ATTRIBUTE和ALTER ATTRIBUTE选项可以组合成一个列表同时处理。 例如，在一条命令中同时增加几个属性或是更改几个属性的类型是可以实现的。 > - 要修改一个类型的模式，还必须在新模式上拥有CREATE权限。 要修改所有者，必须是新的所有角色的直接或间接成员， 并且该成员必须在此类型的模式上有CREATE权限。 （这些限制强制了修改所有者不会做任何通过删除和重建类型不能做的事情。 不过，系统管理员可以以任何方式修改任意类型的所有权。） 要增加一个属性或是修改一个属性的类型，也必须有该类型的USAGE权限。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md index bcb02868..f8d488e3 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md @@ -39,7 +39,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 PARTITION ( patrition_name ) ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 - 收集多列统计信息 @@ -48,7 +48,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 table_name (( column_1_name, column_2_name [, ...] )); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 收集多列统计信息时，请设置GUC参数default_statistics_target为负数，以使用百分比采样方式。 > - 每组多列统计信息最多支持32列。 @@ -60,7 +60,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - Fast模式校验时，需要对校验的表有并发的DML操作，会导致校验过程中有误报的问题，因为当前Fast模式是直接从磁盘上读取，并发有其他线程修改文件时，会导致获取的数据不准确，建议离线操作。 > - 支持对全库进行操作，由于涉及的表较多，建议以重定向保存结果**gsql -d database -p port -f “verify.sql”> verify_warning.txt 2>&1**。 @@ -74,7 +74,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持对普通表的操作和索引表的操作，但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表，当单独对索引表进行检测时，无需使用CASCADE模式。 > - 对于主表的检测会同步检测主表的内部表，例如toast表、cudesc表等。 @@ -86,7 +86,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 ## 参数说明 @@ -94,7 +94,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 启用显示进度信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 - **table_name** @@ -182,7 +182,7 @@ INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若环境若有故障，需查看数据库主节点的log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若环境若有故障，需查看数据库主节点的log。 - 删除表。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/34-CALL.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/34-CALL.md index 11ea27b3..ea284fb6 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/34-CALL.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/34-CALL.md @@ -40,7 +40,7 @@ Call ::= CALL [schema'.']{func_name| procedure_name} ( param_expr ); 取值范围: 已存在的函数参数名称或存储过程参数名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见示例。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md index 715f58af..dd0a9ad3 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md @@ -139,7 +139,7 @@ AlterDafaultPrivileges ::= ALTER DEFAULT PRIVILEGES 取值范围: 已存在的角色名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/41-COPY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/41-COPY.md index 2c008d59..1a9138d2 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/41-COPY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/41-COPY.md @@ -43,7 +43,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 语法中的FIXED、FORMATTER ( { column_name( offset, length ) } [, …] )以及copy_option [ …]可以任意排列组合，但FIXED和FORMATTER必须配合使用。 - 把一个表的数据拷贝到一个文件。 @@ -65,7 +65,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ copy_option [ ...] ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. COPY TO语法形式约束如下： > (query)与[USING] DELIMITER不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。 @@ -156,7 +156,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 打开字段固定长度模式。在字段固定长度模式下，不能声明DELIMITER，NULL，CSV选项。指定FIXED类型后，不能再通过copy_option指定BINARY、CSV、TEXT等类型。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 定长格式定义如下： > > 1. 每条记录的每个字段长度相同。 @@ -183,7 +183,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 仅支持导入（即COPY FROM）时指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 此容错选项的使用限制如下： > > - 此容错机制仅捕捉COPY FROM过程中数据库主节点上数据解析过程中相关的数据类型错误（DATA_EXCEPTION）。 @@ -210,7 +210,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：若未指定LOG ERRORS，则会报错；若指定LOG ERRORS，则默认为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如上述LOG ERRORS中描述的容错机制，REJECT LIMIT的计数也是按照执行COPY FROM的数据库主节点上遇到的解析错误数量计算，而不是数据库节点的错误数量。 - **FORMATTER** @@ -247,7 +247,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 指定数据文件行数据的字段分隔符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 分隔符不能是\r和\n。 > - 分隔符不能和null参数相同，CSV格式数据的分隔符不能和quote参数相同。 @@ -295,7 +295,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -313,7 +313,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式导入。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -351,7 +351,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果行尾换行符丢失，使两行变成一行时，设置此参数为true将导致后一行数据被忽略掉。 - COMPATIBLE_ILLEGAL_CHARS @@ -365,7 +365,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -385,7 +385,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT @@ -414,7 +414,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 用来指定数据文件中空值的表示。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以应该确保指定的字符串和COPY TO相同。 取值范围: @@ -439,7 +439,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 导出数据时用于定义标题行的文件，一般用来描述每一列的数据信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 仅在header为on或true的情况下有效。 > - fileheader指定的是绝对路径。 @@ -456,7 +456,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 - 当前事务中没有打开的游标。 - 当前事务中没有原有的快照。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - FORCE NOT NULL column_name [, …] @@ -485,7 +485,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -503,7 +503,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\r、\n、\r\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -533,7 +533,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 若不使用该参数，导入时遇到非法字符进行报错，中断导入。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -547,7 +547,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目前COPY指定此Option实际不会生效，即不会有相应的容错处理效果（不生效）。需要额外注意的是，打开此选项会导致解析器在数据库主节点数据解析阶段（即COPY错误表容错的涵盖范围）忽略此数据问题，而到数据库节点重新报错，从而使得COPY错误表（打开LOG ERRORS REJECT LIMIT）在此选项打开的情况下无法成功捕获这类少列的数据异常。因此请不要指定此选项。 - DATE_FORMAT 'date_format_string' @@ -556,7 +556,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考**时间和日期处理函数和操作符**。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT 'time_format_string' diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md index 136c9f9d..ddfd9b7e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md @@ -55,7 +55,7 @@ KEY_STORE '=' key_store_value ',' KEY_PATH '=' key_path_value ',' ALGORITHM '=' - ALGORITHM：cmk用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值：目前仅支持RSA_2048。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** **密钥存储路径：**默认情况下，localkms将在$LOCALKMS_FILE_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS_FILE_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub，key_path_value.pub.rand， key_path_value.priv， key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: **密钥存储路径：**默认情况下，localkms将在$LOCALKMS_FILE_PATH路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取$LOCALKMS_FILE_PATH失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub，key_path_value.pub.rand， key_path_value.priv， key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md index 1ff9cb21..c52fcd0b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md @@ -108,7 +108,7 @@ CreateDatabase ::= CREATE DATABASE database_name > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为MogDB将无法帮助你转换或者校验非ASCII字符。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 > - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[]^_`a-z{|}重叠。其中@[]^_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 @@ -131,7 +131,7 @@ CreateDatabase ::= CREATE DATABASE database_name 指定兼容的数据库的类型。取值范围: A、B、C、PG。分别表示兼容Oracle、MySQL、Teradata和PostgreSQL。但是C目前已经放弃支持。因此常用的取值是A、B、PG。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 > - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 @@ -147,7 +147,7 @@ CreateDatabase ::= CREATE DATABASE database_name 数据库可以接受的并发连接数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，数据库MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md index 35762c06..2c1d3e4c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md @@ -104,7 +104,7 @@ date: 2021-05-10 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。并且OUT和INOUT模式的参数不能用在RETURNS TABLE的函数定义中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: VARIADIC用于声明数组类型的参数。 - **argtype** @@ -146,7 +146,7 @@ date: 2021-05-10 表示该函数是窗口函数。替换函数定义时不能改变WINDOW属性。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 - **IMMUTABLE** @@ -248,7 +248,7 @@ date: 2021-05-10 PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/50-CREATE-INDEX.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/50-CREATE-INDEX.md index 2d3d3c68..362ea451 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/50-CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/50-CREATE-INDEX.md @@ -66,7 +66,7 @@ date: 2021-05-10 - 普通CREATE INDEX命令可以在事务内执行，但是CREATE INDEX CONCURRENTLY不可以在事务内执行。 - 列存表、分区表和临时表不支持CONCURRENTLY方式创建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > - 由于需要执行两次对表的扫描和build，而且必须等待现有的所有可能对该表执行修改的事务结束。这意味着该索引的创建比正常耗时更长，同时因此带来的CPU和I/O消耗对其他业务也会造成影响。 @@ -107,7 +107,7 @@ date: 2021-05-10 行存表支持的索引类型：btree（行存表缺省值）、gin、gist。列存表支持的索引类型：Psort（列存表缺省值）、btree、gin。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 - **column_name** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md index 692b1496..28015b2f 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -91,7 +91,7 @@ CreateRowLevelSecurityPolicy ::= CREATE [ ROW LEVEL SECURITY ] POLICY policy_nam 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 系统管理员不受行访问控制特性影响。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 系统管理员不受行访问控制特性影响。 - **using_expression** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md index e612133d..164d6975 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md @@ -56,7 +56,7 @@ plsql_body 参数的模式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: VARIADIC用于声明数组类型的参数。 取值范围: IN，OUT，INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。 @@ -96,9 +96,9 @@ plsql_body PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 ## 优化建议 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/54-CREATE-ROLE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/54-CREATE-ROLE.md index 32e7e04b..85e320ec 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/54-CREATE-ROLE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/54-CREATE-ROLE.md @@ -67,7 +67,7 @@ option ::= {SYSADMIN | NOSYSADMIN} 取值范围: 字符串，要符合标识符的命名规范，且最多为63个字符。若超过63个字符，数据库会截断并保留前63个字符当做角色名称。在创建角色时，数据库的时候会给出提示信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 - **password** @@ -157,7 +157,7 @@ option ::= {SYSADMIN | NOSYSADMIN} 声明该角色可以使用的并发连接数量。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md index 023ade71..0fac0e52 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md @@ -41,7 +41,7 @@ date: 2021-05-10 模式名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 模式名不能和当前数据库里其他的模式重名。 > 模式的名称不可以“pg_”开头。 @@ -59,7 +59,7 @@ date: 2021-05-10 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md index fbd92898..cdbbffbf 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md @@ -58,7 +58,7 @@ CreateSequence ::= CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为1，表示一次只能生成一个值，也就是没有缓存。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 不建议同时定义cache和maxvalue或minvalue。因为定义cache后不能保证序列的连续性，可能会产生空洞，造成序列号段浪费。 - **CYCLE** @@ -79,7 +79,7 @@ CreateSequence ::= CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为OWNED BY NONE，表示不存在这样的关联。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过OWNED BY创建的Sequence不建议用于其他表，如果希望多个表共享Sequence，该Sequence不应该从属于特定表。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md index 2d83c361..ce350b54 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md @@ -40,7 +40,7 @@ CreateSynonym ::= CREATE [ OR REPLACE ] SYNONYM synonym_name 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > object_name可以是不存在的对象名称。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/60-CREATE-TABLE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/60-CREATE-TABLE.md index f29f9ce1..10bf4721 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/60-CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/60-CREATE-TABLE.md @@ -109,7 +109,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 @@ -162,7 +162,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）会复制到新表中。默认情况下，不复制源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果源表包含serial、bigserial、smallserial类型，或者源表字段的默认值是sequence，且sequence属于源表（通过CREATE SEQUENCE … OWNED BY创建），这些Sequence不会关联到新表中，新表中会重新创建属于自己的sequence。这和之前版本的处理逻辑不同。如果用户希望源表和新表共享Sequence，需要首先创建一个共享的Sequence（避免使用OWNED BY），并配置为源表字段默认值，这样创建的新表会和源表共享该Sequence。 > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 @@ -171,7 +171,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 这个子句为表或索引指定一个可选的存储参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 参数的详细描述如下所示。 @@ -282,7 +282,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 - **DEFAULT default_expr** @@ -957,7 +957,7 @@ mogdb=# DROP SCHEMA IF EXISTS joe CASCADE; - 如果指定了INCLUDING PARTITION，则源表的分区定义会复制到新表中，同时新表将不能再使用PARTITION BY子句。默认情况下，不拷贝源表的分区定义。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 - LIKE INCLUDING RELOPTIONS diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md index ea2aa316..c449eac8 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md @@ -54,7 +54,7 @@ CreateTableAs ::= CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md index 1f31e323..909dff02 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md @@ -194,7 +194,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -235,19 +235,19 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name （1）对于从句是VALUES LESS THAN的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、CHARACTER VARYING(n)、VARCHAR(n)、CHARACTER(n)、CHAR(n)、CHARACTER、CHAR、TEXT、NVARCHAR2、NAME、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （2）对于从句是START END的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （3）对于指定了INTERVAL子句的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 @@ -255,7 +255,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 指定各分区的信息。partition_name为范围分区的名称。partition_value为范围分区的上边界，取值依赖于partition_key的类型。MAXVALUE表示分区的上边界，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 每个分区都需要指定一个上边界。 > - 分区上边界的类型应当和分区键的类型一致。 @@ -272,7 +272,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_value：对[START，END) 表示的范围进行切分，interval_value是指定切分后每个分区的宽度，不可是MAXVALUE；如果（END-START）值不能整除以EVERY值，则仅最后一个分区的宽度小于EVERY值。 - MAXVALUE：表示最大值，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 1. 在创建分区表若第一个分区定义含START值，则范围（MINVALUE，START）将自动作为实际的第一个分区。 > 2. START END语法需要遵循以下限制： @@ -292,7 +292,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - STORE IN (tablespace_name [, … ] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列存表不支持间隔分区。 - **PARTITION BY LIST(partition_key)** @@ -322,7 +322,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ENABLE（缺省值）：行迁移开关打开。 - DISABLE：行迁移开关关闭。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持ROW MOVEMENT。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持ROW MOVEMENT。 - **NOT NULL** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md index b5740bba..fedc7fe4 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md @@ -136,7 +136,7 @@ CreateTextSearchDictionary ::= CREATE TEXT SEARCH DICTIONARY name ( 词典定义文件所在目录。可以指定为本地目录或者OBS目录（只能在安全模式下指定OBS目录，通过启动时添加securitymode选项进入安全模式）。其中，本地目录格式为”file://absolute_path”，OBS目录格式为”obs://bucket_name/path accesskey=ak secretkey=sk region=rg”。默认值为预定义词典文件所在目录。FILEPATH参数必须和STOPWORDS参数同时指定，不允许单独指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 词典定义文件的文件名仅支持小写字母、数据、下划线混合。 - **value** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md index bd301fa3..49568518 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md @@ -127,7 +127,7 @@ CreateTrigger ::= CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | 执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关于触发器种类： > > - INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/67-CREATE-TYPE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/67-CREATE-TYPE.md index ae72ec4c..942b1daa 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/67-CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/67-CREATE-TYPE.md @@ -113,7 +113,7 @@ CreateType ::= CREATE TYPE name AS ENUM 输入函数必须返回一个该数据类型本身的值。通常，一个输入函数应该被声明为STRICT。 如果不是这样，在读到一个NULL输入值时，调用输入函数时第一个参数会是NULL。在这种情况下，该函数必须仍然返回NULL，除非调用函数发生了错误（这种情况主要是想支持域输入函数，域输入函数可能需要拒绝NULL输入）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 输入和输出函数能被声明为具有新类型的结果或参数是因为：必须在创建新类型之前创建这两个函数。而新类型应该首先被定义为一种shell type，它是一种占位符类型，除了名称和拥有者之外它没有其他属性。这可以通过不带额外参数的命令CREATE TYPE name做到。然后用C写的I/O函数可以被定义为引用这种shell type。最后，用带有完整定义的CREATE TYPE把该shell type替换为一个完全的、合法的类型定义，之后新类型就可以正常使用了。 - **output_function** @@ -149,7 +149,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。将类型的修饰符的内部形式转换为外部文本形式的函数名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果该类型支持修饰符（附加在类型声明上的可选约束，例如，char(5)或numeric(30,2)），则需要可选的type_modifier_input_function以及type_modifier_output_function。MogDB允许用户定义的类型有一个或者多个简单常量或者标识符作为修饰符。不过，为了存储在系统目录中，该信息必须能被打包到一个非负整数值中。所声明的修饰符会被以cstring数组的形式传递给type_modifier_input_function。 type_modifier_input_function必须检查该值的合法性（如果值错误就抛出一个错误），如果值正确，要返回一个非负integer值，该值将被存储在“typmod”列中。如果类型没有 type_modifier_input_function则类型修饰符将被拒绝。type_modifier_output_function把内部的整数typmod值转换回正确的形式用于用户显示。type_modifier_output_function必须返回一个cstring值，该值就是追加到类型名称后的字符串。例如，numeric的函数可能会返回(30,2)。如果默认的显示格式就是只把存储的typmod整数值放在圆括号内，则允许省略type_modifier_output_function。 - **analyze_function** @@ -204,7 +204,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。如果这种类型是其类型分类中的优先类型则为TRUE，否则为FALSE。默认为假。在一个现有类型分类中创建一种新的优先类型要非常谨慎， 因为这可能会导致很大的改变。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > category和preferred参数可以被用来帮助控制在混淆的情况下应用哪一种隐式造型。每一种数据类型都属于一个用单个ASCII 字符命名的分类，并且每一种类型可以是其所属分类中的“首选”。当有助于解决重载函数或操作符时，解析器将优先造型到首选类型（但是只能从同类的其他类型造型）。对于没有隐式转换到或来自任意其他类型的类型，让这些设置保持默认即可。不过，对于有隐式转换的相关类型的组，把它们都标记为属于同一个类别并且选择一种或两种“最常用”的类型作为该类别的首选通常是很有用的。在把一种用户定义的类型增加到一个现有的内建类别（例如，数字或者字符串类型）中时，category参数特别有用。不过，也可以创建新的全部是用户定义类型的类别。对这样的类别，可选择除大写字母之外的任何ASCII 字符。 - **default** @@ -233,7 +233,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。与枚举类型的一个值相关的文本标签，其值为长度不超过63个字符的非空字符串。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在创建用户定义类型的时候， MogDB会自动创建一个与之关联的数组类型，其名称由该元素类型的名称前缀一个下划线组成。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/70-CREATE-VIEW.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/70-CREATE-VIEW.md index 3de146b9..1874b0bf 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/70-CREATE-VIEW.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/70-CREATE-VIEW.md @@ -23,7 +23,7 @@ CreateView ::= CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( col AS query; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 创建视图时使用WITH(security_barriers)可以创建一个相对安全的视图，避免攻击者利用低成本函数的RAISE语句打印出隐藏的基表数据。 ## 参数说明 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md index 65febec8..7f06a51a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md @@ -38,7 +38,7 @@ DropClientMasterKey ::= DROP CLIENT MASTER KEY [ IF EXISTS ] client_master_key_n - **CASCADE**：表示允许级联删除依赖于客户端加密主密钥的对象。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 ## **示例** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/78-DROP-DATABASE.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/78-DROP-DATABASE.md index 18aec9b0..621676a1 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/78-DROP-DATABASE.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/78-DROP-DATABASE.md @@ -19,7 +19,7 @@ date: 2021-05-10 - 不能在事务块中执行DROP DATABASE命令。 - 如果执行DROP DATABASE失败，事务回滚，需要再次执行一次DROP DATABASE IF EXISTS。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DROP DATABASE一旦执行将无法撤销，请谨慎使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DROP DATABASE一旦执行将无法撤销，请谨慎使用。 ## 语法格式 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/9-ALTER-INDEX.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/9-ALTER-INDEX.md index 58d85f29..47bfd083 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/9-ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/9-ALTER-INDEX.md @@ -90,7 +90,7 @@ ALTER INDEX用于修改现有索引的定义。 [ MODIFY PARTITION index_partition_name ] UNUSABLE; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表不支持该语法。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表不支持该语法。 - 重建表索引或索引分区。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md index e9e41551..2b5ccca9 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md @@ -38,9 +38,9 @@ DropSchema ::= DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRIC - CASCADE：自动删除包含在模式中的对象。 - RESTRICT：如果模式包含任何对象，则删除失败（缺省行为）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/client-tool.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/client-tool.md index e22b2855..874f08f6 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/client-tool.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/client-tool.md @@ -19,7 +19,7 @@ gsql是MogDB提供在命令行下运行的数据库连接工具，可以通过 - **连接数据库：**详细操作请参见《管理指南》中“日常运维 > [gsql客户端连接](using-the-gsql-client-for-connection)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 - **执行SQL语句：**支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 @@ -58,7 +58,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql预定义了一些特殊变量，同时也规划了变量的取值。为了保证和后续版本最大限度地兼容，请避免以其他目的使用这些变量。所有特殊变量见[表2](#teshubian)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 所有特殊变量都由大写字母、数字和下划线组成。 > - 要查看特殊变量的默认值，请使用元命令**\echo :**_varname_（例如\echo :DBNAME）。 @@ -99,7 +99,7 @@ gsql的高级特性如[表1](#gsql)所示。 执行以上命令，将会查询HR.areaS表。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 - 提示符 @@ -165,7 +165,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 示例1，使用omm用户连接到本机mogdb数据库的15400端口。 @@ -536,7 +536,7 @@ omm@[local] mogdb=# 元命令的详细说明请参见下表。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 **表 11** 一般的元命令 @@ -571,7 +571,7 @@ omm@[local] mogdb=# | \o [FILE] | 把所有的查询结果发送到文件里。 | | \qecho [STRING] | 把字符串写到查询结果输出流里。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 **表 14** 显示信息元命令 @@ -783,7 +783,7 @@ omm@[local] mogdb=# 数据库由于安全问题，禁止远程登录时使用trust模式。这时需要修改pg_hba.conf里的连接认证信息。具体的设置信息请参见：《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 - 连接数据库，添加“-h 127.0.0.1”可以连接，去掉后无法连接问题。 @@ -834,7 +834,7 @@ omm@[local] mogdb=# GRANT CONNECT ON DATABASE mogdb TO user1; - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 > > ``` > gsql -d mogdb -p 15400 @@ -900,7 +900,7 @@ omm@[local] mogdb=# 目标数据库主节点的pg_hba.conf里配置了当前客户端IP使用”gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到”sha256”后再试。配置方法见《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。 > - 建议业务应用部署在MogDB之外，而非MogDB内部。 @@ -913,4 +913,4 @@ omm@[local] mogdb=# 解决此问题，重试便可。同时请尽可能避免在升级等运维操作过程中，在MogDB内部运行业务程序，避免升级时因替换文件产生此问题。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/1-gs_check.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/1-gs_check.md index f0ad28f6..46593e91 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/1-gs_check.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/1-gs_check.md @@ -213,7 +213,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 | CheckNetSpeed(检查网卡接收带宽，ping值，丢包率) | 网络满载时，检查网卡平均接收带宽大于600MB通过;
网络满载时，检查网络ping值，小于1秒通过;
网络满载时，检查网卡丢包率，小于1%通过。 | 否 | | | other | CheckDataDiskUsage(检查数据库节点磁盘空间使用率) | 检查磁盘数据库节点目录使用率，如果使用率低于90%则检查项通过，否则检查项不通过。 | 否 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** CheckNetSpeed检查项： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: CheckNetSpeed检查项： > > - CheckNetSpeed不支持-L本地检查模式，-L模式无法构造网络压力，检查的结果不准确。 > - 在节点数小于6时，speed_test构造的网络压力可能无法跑满带宽，可能会造成检查结果不准确。 @@ -247,7 +247,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 scp scene_upgrade.xml SIA1000068994：home/package/script/gspylib/inspection/config/ ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 5. 换至omm用户，执行以下命令查看检查结果。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md index 5a092f85..b42d7df4 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md @@ -45,7 +45,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 取值范围: A1…A14、B1…B8 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 详细的检查项请参见[表1](#gs_checkos)。 @@ -53,7 +53,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 主机名称列表文件。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称的列表。 @@ -118,7 +118,7 @@ gs_checkos工具来帮助检查操作系统、控制参数、磁盘配置等内 | B7 | 设置欧拉系统属性（Set RemoveIPC value） | 欧拉系统属性检查：检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service，/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no，当不为no时，对其进行修改设置。 | | B8 | 设置sshd服务应用pam模块（Set Session Process） | 远程设备继承系统默认资源：修改/etc/pam.d/sshd服务文件，添加配置项session required pam_limits.so，来控制用户使用的资源。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A6选项检查标准来自配置文件check_list.conf下[/etc/sysctl.conf]、[SUGGEST:/etc/sysctl.conf]域： 若[/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Abnormal，可以使用B1参数进行设置。 若[SUGGEST:/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Warning，B1参数不会进行设置，需根据实际情况进行手动设置。 > - A7选项检查系统文件句柄标准来自配置文件check_list.conf下[/etc/security/limits.conf]域open file参数，可以使用B2参数进行设置。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/4-gs_collector.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/4-gs_collector.md index 35d48996..65340c6c 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/4-gs_collector.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/4-gs_collector.md @@ -60,7 +60,7 @@ date: 2021-06-07 主机名称列表文件。该文件为纯文本格式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称列表。 @@ -97,7 +97,7 @@ date: 2021-06-07 } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 默认配置文件内容如下： { “Collect”: [ {“TypeName”: “System”, “Content”:“RunTimeInfo, HardWareInfo”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Log”, “Content” : “DataNode,ClusterManager”, “Interval”:“0”, “Count”:“1”}, {“TypeName”: “Database”, “Content”: “pg_locks,pg_stat_activity,pg_thread_wait_status”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Config”, “Content”: “DataNode”, “Interval”:“0”, “Count”:“1”} ] } TypeName和对应的Content取值范围见表1gs_collector内容收集对照表。 对于Log，CoreDump，Config，XLog四种类型，Interval和Count参数不生效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 默认配置文件内容如下： { “Collect”: [ {“TypeName”: “System”, “Content”:“RunTimeInfo, HardWareInfo”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Log”, “Content” : “DataNode,ClusterManager”, “Interval”:“0”, “Count”:“1”}, {“TypeName”: “Database”, “Content”: “pg_locks,pg_stat_activity,pg_thread_wait_status”,“Interval”:“0”, “Count”:“1”}, {“TypeName”: “Config”, “Content”: “DataNode”, “Interval”:“0”, “Count”:“1”} ] } TypeName和对应的Content取值范围见表1gs_collector内容收集对照表。 对于Log，CoreDump，Config，XLog四种类型，Interval和Count参数不生效。 - -keyword=KEYWORD @@ -105,7 +105,7 @@ date: 2021-06-07 若关键字KEYWORD中含有空格，需要使用双引号包围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 - -begin-time diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/5-gs_dump.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/5-gs_dump.md index ebd9c383..b756a4de 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/5-gs_dump.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/5-gs_dump.md @@ -35,7 +35,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者-forma | 目录归档格式 | d | 该格式会创建一个目录，该目录包含两类文件，一类是目录文件，另一类是每个表和blob对象对应的数据文件。 | - | | | tar归档格式 | t | tar归档文件支持从导出文件中恢复所有或所选数据库对象。tar归档格式不支持压缩且对于单独表大小应小于8GB。 | - | | -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以使用gs_dump程序将文件压缩为纯文本或自定义归档导出文件，减少导出文件的大小。生成纯文本导出文件时，默认不压缩。生成自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。通过压缩方式导出纯文本格式文件，gsql无法成功导入数据对象。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以使用gs_dump程序将文件压缩为纯文本或自定义归档导出文件，减少导出文件的大小。生成纯文本导出文件时，默认不压缩。生成自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。通过压缩方式导出纯文本格式文件，gsql无法成功导入数据对象。 ## 注意事项 @@ -49,7 +49,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者-forma gs_dump [OPTION]... [DBNAME] ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 ```bash gs_dump -p port_number postgres -f dump1.sql @@ -144,7 +144,7 @@ export PGDATABASE=postgres 只转储与模式名称匹配的模式，此选项包括模式本身和所有它包含的对象。如果该选项没有指定，所有在目标数据库中的非系统模式将会被转储。写入多个-n选项来选择多个模式。此外，根据gsql的\d命令所使用的相同规则，模式参数可被理解成一个pattern，所以多个模式也可以通过在该pattern中写入通配符来选择。使用通配符时，注意给pattern打引号，防止shell扩展通配符。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 当-n已指定时，gs_dump不会转储已选模式所附着的任何其他数据库对象。因此，无法保证某个指定模式的转储结果能够自行成功地储存到一个空数据库中。 - 当-n指定时，非模式对象不会被转储。 @@ -203,7 +203,7 @@ export PGDATABASE=postgres 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数-include-table-file来替换。 @@ -241,7 +241,7 @@ export PGDATABASE=postgres 指定不需要dump的表文件。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… - -x, -no-privileges|-no-acl @@ -331,7 +331,7 @@ export PGDATABASE=postgres AES128密钥长度必须是16字节。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 - 不支持加密导出存储过程和函数。 @@ -362,7 +362,7 @@ AES128密钥长度必须是16字节。 gs_dump -p port_number postgres -f backup.sql -F plain --dont-overwrite-file ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -s/-schema-only和-a/-data-only不能同时使用。 - -c/-clean和-a/-data-only不能同时使用。 @@ -432,7 +432,7 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中“Bigdata@123”表示数据库用户密码；“backup/MPPDB_backup.sql”表示导出的文件，其中backup表示相对于当前目录的相对目录；“37300”表示数据库服务器端口；“postgres”表示要访问的数据库名。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1：执行gs_dump，导出postgres数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md index d96772ac..dffbd10a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md @@ -182,7 +182,7 @@ gs_dumpall [OPTION]... 指定备份进程并发数，取值范围为1~1000。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -g/-globals-only和-r/-roles-only不能同时使用。 - -g/-globals-only和-t/-tablespaces-only不能同时使用。 @@ -251,7 +251,7 @@ gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则， 使用gs_dumpall一次导出MogDB的所有数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 ```bash gs_dumpall -f backup/bkp2.sql -p 37300 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/7-gs_guc.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/7-gs_guc.md index 8e113038..edccf660 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/7-gs_guc.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/7-gs_guc.md @@ -31,7 +31,7 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为client，则会生成这两个文件。其中“client.key.cipher”存储用户密码的密文，“client.key.rand”存储的是加密因子。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 @@ -39,7 +39,7 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为source，则会生成这两个文件。其中“datasource.key.cipher”存储用户密码的密文，“datasource.key.rand”存储的是加密因子。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “datasource.key.cipher”和“datasource.key.rand”是创建Data Source对象时调用的密钥文件。gs_guc生成时即有读权限。使用前需将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。 @@ -75,7 +75,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc [ set | reload ] [-N NODE-NAME] [-I INSTANCE-NAME | -D DATADIR] -h "HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD authentication-options" ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: authentication-options支持以下选项： @@ -92,7 +92,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc [ set | reload ] [-N NODE-NAME] [-I INSTANCE-NAME | -D DATADIR] -h "HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD" ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要注释已经设置的认证策略，请使用-h “HOSTTYPE DATABASE USERNAME IPADDR-WITH-IPMASK AUTHMEHOD”，不需要指定authentication-options。 @@ -114,7 +114,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc encrypt [-M keymode] -K password [-U username] -D DATADIR ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -K是用户指定的密码，gs_guc会对该密码进行长度（8<=len<=16）和密码复杂度要求，如果不满足，将会报错。 - -M是加密类型，当前仅支持server、client和source。默认值为server。 @@ -125,12 +125,12 @@ gs_guc工具由操作系统用户omm执行。 gs_guc generate [-o prefix] [-S cipherkey] -D DATADIR ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -o是输出的OBS类型的cipher和rand文件前缀名称，默认输出文件名前缀为obsserver。其内容仅支持数字、字母和下划线。 - -S是用户指定的密码，密码需要满足长度要求（8<=len<=16）和复杂度要求，如不满足将会报错。当其值为default时，会随机生成一段字符串作为密码，该密码长度为13。如果不带-S参数则会提示交互式输入密码。为了系统安全，推荐使用交互式输入密码方式。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - gs_guc工具不支持参数值中包含'#'的设置。可以使用vi工具通过手工修改配置文件来设置。 - 如果已经在环境变量中设置PGDATA，则可以省略-D参数。否则提示设置参数失败。 @@ -180,7 +180,7 @@ gs_guc工具由操作系统用户omm执行。 需要执行命令的MogDB实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 与”-I” 不能一块使用 @@ -188,7 +188,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的MogDB配置参数的名称和参数值。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 如果参数是一个字符串变量，则使用-c parameter=“'value'“或者使用-c “parameter = 'value'“。 - 当使用gs_guc set/reload为”log_directory” 恢复默认值时，其默认值会被置为具体的data目录。 @@ -243,7 +243,7 @@ gs_guc工具由操作系统用户omm执行。 设定该密码在数据库运行过程中，用于服务端(server)、客户端(client)还是创建Data Source对象时调用。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 @@ -263,7 +263,7 @@ gs_guc工具由操作系统用户omm执行。 指定要加密的用户，隶属于OS用户。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 @@ -285,7 +285,7 @@ gs_guc工具由操作系统用户omm执行。 取值范围: datanode。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。openGauss只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/8-gs_om.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/8-gs_om.md index bc16b97a..5e931973 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/8-gs_om.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/8-gs_om.md @@ -202,13 +202,13 @@ gs_om参数可以分为如下几类： 显示详细信息。如果不指定，只提示该服务器是否正常。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 - -all 显示MogDB所有节点信息。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 - 生成配置文件参数： diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/9-gs_restore.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/9-gs_restore.md index a1ca64d6..01604863 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/9-gs_restore.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/server-tools/9-gs_restore.md @@ -29,7 +29,7 @@ gs_restore工具由操作系统用户omm执行。 gs_restore [OPTION]... FILE ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - FILE没有短选项或长选项。用来指定归档文件所处的位置。 - 作为前提条件，需输入dbname或-l选项。不允许用户同时输入dbname和-l选项。 @@ -50,7 +50,7 @@ gs_restore [OPTION]... FILE 默认是标准输出。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f不能同-d一起使用。 @@ -194,7 +194,7 @@ gs_restore [OPTION]... FILE gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 -t table1 backup/MPPDB_backup.tar ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -t参数不支持schema_name.table_name的输入格式。 @@ -240,7 +240,7 @@ gs_restore [OPTION]... FILE 输出SET SESSION AUTHORIZATION命令，而非ALTER OWNER命令，用以决定对象归属。该选项使转储更加兼容标准，但通过参考转储中对象的记录，导入过程可能会有问题。使用SET SESSION AUTHORIZATION的转储要求必须是系统管理员，同时在导入前还需参考”SET SESSION AUTHORIZATION”，手工对导出文件的密码进行修改验证，只有这样才能进行正确的导入操作，相比之下，ALTER OWNER对权限要求较低。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: - 如果安装过程中有任何本地数据要添加到template1数据库，请谨慎将gs_restore的输出载入到一个真正的空数据库中；否则可能会因为被添加对象的定义被复制，而出现错误。要创建一个无本地添加的空数据库，需从template0而非template1复制，例如： @@ -250,7 +250,7 @@ gs_restore [OPTION]... FILE - gs_restore不能选择性地导入大对象；例如只能导入那些指定表的对象。如果某个归档形式包含大对象，那所有大对象都会被导入，或一个都不会被导入，如果它们通过-L、-t或其他选项被排除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1. -d/-dbname 和 -f/-file 不能同时使用； 2. -s/-schema-only 和 -a/-data-only不能同时使用； diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index e62fb15c..fceafe09 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -21,7 +21,7 @@ gaussdb [OPTION]... 客户端应用程序为了访问数据库，将连接（通过网络或本地）到一个正在运行的gaussdb进程。然后该进程实例会启动一个独立的线程来处理这个连接。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 一个gaussdb进程总是管理来自同一个数据库的数据。一个系统上可以同时运行多个gaussdb进程，只要使用不同的数据目录和不同的端口号。gaussdb启动时需要知道数据目录的位置，该位置必须通过-D指定。通常，-D直接指向由gs_initdb创建的数据库目录。 @@ -131,7 +131,7 @@ ps -ef | grep gaussdb 无法绑定端口的错误信息可能表明该端口已经被其他非MogDB进程使用。如果终止gaussdb后又马上用同一端口号运行它，也可能得到错误信息。这时，必须多等几秒，等操作系统关闭了该端口再试。最后，如果使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如：Unix版本认为低于1024的端口号是“可信任的”，因而只有Unix系统管理员可以使用它们。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果有可能，不要使用SIGKILL杀死主进程。这样会阻止gaussdb在退出前释放它持有的系统资源（例如共享内存和信号灯）。这样可能会影响到将来启动新的进程。 > - 可以使用SIGTERM，SIGINT，SIGQUIT信号正常结束服务器进程。第一个信号将等待所有的客户端退出后才退出。第二个将强制断开所有客户端，而第三个将不停止立刻退出，导致在重启时的恢复运行。 @@ -149,7 +149,7 @@ gaussdb --single -D /usr/local/pgsql/data other-options my_database 用-D给服务器提供正确的数据库目录的路径。同时还要声名已存在的特定数据库名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 通常，独立运行的服务器把换行符当做命令输入完成字符；要想把一行分成多行写，必需在除最后一个换行符以外的每个换行符前面敲一个反斜杠。 > - 如果使用了-j命令行选项，新行将不被当作命令结束符。此时服务器将从标准输入一直读取到EOF标志为止，然后把所有读到的内容当作一个完整的命令字符串看待，并且反斜杠与换行符也被当作普通字符来看待。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md index 400a0b5f..dfcb241e 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md @@ -11,7 +11,7 @@ date: 2021-06-07 通过gs_basebackup的压缩格式备份，主数据目录将被写入到一个名为 base.tar 的文件中，并且其他表空间将被以其 OID 命名。生成的数据文件，需要通过gs_tar命令作解压。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_tar命令当前仅支持解压通过gs_basebackup生成的归档文件。 > - 如果gs_basebackup制定了压缩等级，会生成以gz结尾的文件。此时需要使用gzip命令先解压缩生成tar包，之后才可以使用gs_tar命令解压生成的tar文件。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md index 37498d2a..4a7a7d1b 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md @@ -41,7 +41,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 只卸载本地主机。如果MogDB内某主机做单点卸载后，MogDB不能再做全量卸载。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_uninstall时，系统自动会删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 @@ -51,7 +51,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** 由于在执行gs_uninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: 由于在执行gs_uninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md index 84446687..b8c2e4a6 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md @@ -81,7 +81,7 @@ date: 2021-06-07 gs_upgradectl -t commit-upgrade -X XMLFILE [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一旦提交操作完成，则不能再执行回滚操作。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md index dbb94ad6..ea34aa55 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md @@ -161,7 +161,7 @@ Expansion results: Expansion Finish. ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 对数据库集群进行扩容前，需要关注主机及新扩容节点cpu、io、网络等情况，不建议在硬件压力较大时执行扩容，否则可能导致扩容耗时较长甚至扩容失败。 > - 当原集群数据量较大时，在进行扩容操作前应当在主机上先执行checkpoint，否则可能导致扩容耗时较长甚至扩容失败。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md index 58ca858c..34dc5b48 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md @@ -329,7 +329,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **恢复目标相关参数(recovery_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： @@ -366,7 +366,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **留存相关参数(retention_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup和delete命令一起使用这些参数。 @@ -406,7 +406,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **固定备份相关参数(pinning_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -480,7 +480,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **连接相关参数(connection_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 @@ -522,7 +522,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **压缩相关参数(compression_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 @@ -551,7 +551,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **远程模式相关参数(remote_options)** -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md index 9c450a26..3c9634fa 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md @@ -11,7 +11,7 @@ date: 2021-06-07 gstrace是MogDB提供的用来跟踪内核代码执行路径，记录内核数据结构，分析代码性能的工具。Trace的有限点位和数据在版本中被固化，无法动态添加和删除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告**: 1. 对内核dump指定内存变量的数据用于诊断分析，不存在直接指定任意寄存器或者内存地址的行为。读取的内存地址均是在开发阶段硬编码，没有任意地读取或者修改寄存器或内存的操作。 2. Trace点可能涉及敏感数据，收集trace信息前需要同用户协商，授权和许可后方可收集。 @@ -19,7 +19,7 @@ gstrace是MogDB提供的用来跟踪内核代码执行路径，记录内核数 4. Trace仅用于诊断目的，开启trace将对性能产生一定影响，影响的大小视负载的高低，trace的模块而不同。 5. Trace工具的权限为0700，仅限于数据库用户读、写和执行。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md index 58e8832c..44fb2427 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB部署成功后，在数据库运行的过程中，会遇到各种问题及异常状态。MogDB提供了gs_basebackup工具做基础的物理备份。gs_basebackup的实现目标是对服务器数据库文件的二进制进行拷贝，其实现原理使用了复制协议。远程执行gs_basebackup时，需要使用系统管理员账户。gs_basebackup当前支持热备份模式和压缩格式备份模式。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_basebackup仅支持主机和备机的全量备份，不支持增量。 > - gs_basebackup当前支持热备份模式和压缩格式备份模式。 @@ -143,7 +143,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 当数据库发生故障时需要从备份文件进行恢复。因为gs_basebackup是对数据库按二进制进行备份，因此恢复时可以直接拷贝替换原有的文件，或者直接在备份的库上启动数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若当前数据库实例正在运行，直接从备份文件启动数据库可能会存在端口冲突，这时需要修改配置文件的port参数，或者在启动数据库时指定一下端口。 > - 若当前备份文件为主备数据库，可能需要修改一下主备之间的复制连接。即配置文件中的postgresql.conf中的replconninfo1，replconninfo2等。 @@ -157,7 +157,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 5. 若数据库中存在链接文件，需要修改使其链接到正确的文件。 6. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 暂不支持备份文件增量恢复。 > - 恢复后需要检查数据库中的链接文件是否链接到正确的文件。 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md index 7cd3e7ab..6493861a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md @@ -17,7 +17,7 @@ gs_initdb初始化数据库时，会创建数据库目录、生成系统表、 初始化数据库时会生成大量的系统表和视图，其中绝大部分都对任何数据库用户开放查看权限。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 **生成的数据库** diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md index d69a82f4..b2aa0030 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md @@ -27,7 +27,7 @@ MogDB安装部署，要求用户指定配置文件，配置文件中会指定程 gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 - 显示帮助信息 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md index a050ab1c..0730cd3a 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md @@ -73,7 +73,7 @@ MogDB提供了gs_postuninstall工具来帮助清理准备MogDB环境阶段所做 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md index 9f6a6cf5..fcdeacdf 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md @@ -57,7 +57,7 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 配置-U参数值时，字符串中不能包含”|“,”;“,”&“,”$“,”<“,”>”,”`”,”\\”,“'”,”\”,”{”,”}”,”(”,”)”,”[”,”]”,”~”,”*”,“?“特殊字符。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 配置-U参数值时，字符串中不能包含”|“,”;“,”&“,”$“,”<“,”>”,”`”,”\\”,“'”,”\”,”{”,”}”,”(”,”)”,”[”,”]”,”~”,”*”,“?“特殊字符。 - -G @@ -90,13 +90,13 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 - -sep-env-file=MPPRCFILE 保存环境变量的文件。如果指定该参数，表示将使用环境变量分离的版本。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 - -skip-hostname-set @@ -161,7 +161,7 @@ SYSLOGD_OPTIONS="-r -m 0" KLOGD_OPTIONS="-x" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该配置需要在MogDB每台机器上都要修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该配置需要在MogDB每台机器上都要修改。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md index 2c354529..ef47bfa1 100644 --- a/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md +++ b/product/zh/docs-mogdb/v2.0.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文件等操作。因此，安装前需要确保互信是连通的。MogDB提供了gs_sshexkey工具来帮助用户建立互信。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 ## 前提条件 @@ -75,7 +75,7 @@ MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文 主机列表，列出所有需要建立互信主机的IP。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 - -h diff --git a/product/zh/docs-mogdb/v2.0.1/security-guide/security/1-client-access-authentication.md b/product/zh/docs-mogdb/v2.0.1/security-guide/security/1-client-access-authentication.md index 5570e5f4..75b7023a 100644 --- a/product/zh/docs-mogdb/v2.0.1/security-guide/security/1-client-access-authentication.md +++ b/product/zh/docs-mogdb/v2.0.1/security-guide/security/1-client-access-authentication.md @@ -222,13 +222,13 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | 参数 | 描述 | 取值范围 | | :------------ | :------------------------------------ | :-----------------------------------| -| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值:**on | -| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值:**off | +| ssl | 表示是否启动SSL功能。 | - on: 开启SSL功能。
- off: 关闭SSL功能。
**默认值**: on | +| require_ssl | 设置服务器端是否强制要求SSL连接。该参数只有当参数ssl为on时才有效。 | - on: 服务器端强制要求SSL连接。
- off: 服务器端对是否通过SSL连接不作强制要求。
**默认值**: off | | ssl_cert_file | 指定服务器证书文件，包含服务器端的公钥。服务器证书用以表明服务器身份的合法性，公钥将发送给对端用来对数据进行加密。 | 请以实际的证书名为准。其相对路径是相对于数据目录的。
**默认值**: server.crt | | ssl_key_file | 指定服务器私钥文件，用以对公钥加密的数据进行解密。 | 请以实际的服务器私钥名称为准。其相对路径是相对于数据目录的。
**默认值**: server.key | | ssl_ca_file | CA服务器的根证书。此参数可选择配置，需要验证客户端证书的合法性时才需要配置。 | 请以实际的CA服务器根证书名称为准。
**默认值**: cacert.pem | | ssl_crl_file | 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。 | 请以实际的证书吊销列表名称为准。
**默认值**: 空，表示没有吊销列表。 | -| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值:**ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | +| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值**: ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | 在客户端配置SSL认证相关的环境变量，详细信息请参见[表3](#表1.3.3)。 @@ -241,9 +241,9 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | :------------ | :---------------------------------------------------------- | :--------------------------------------------------------- | | PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如:
**`export PGSSLCERT='/home/omm/client.crt'`**
**默认值**: 空 | | PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如:
**`export PGSSLKEY='/home/omm/client.key'`**
**默认值**: 空 | -| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值:**prefer | -| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值:**空 | -| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值:**空 | +| PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义:**
- disable: 只尝试非SSL连接。
- allow: 首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer: 首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require: 只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full: 只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值**: prefer | +| PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如:
**`export PGSSLROOTCERT='/home/omm/certca.pem'`**
**默认值**: 空 | +| PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如:
**`export PGSSLCRL='/home/omm/sslcrl-file.crl'`**
**默认值**: 空 | 服务器端参数ssl、require_ssl与客户端参数sslmode配置组合结果如下: diff --git a/product/zh/docs-mogdb/v2.1/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md b/product/zh/docs-mogdb/v2.1/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md index d753bdba..997d0971 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/2-predictor-ai-query-time-forecasting/2-3-usage-guide.md @@ -22,7 +22,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 > - Cgroups功能正常加载。 @@ -71,7 +71,7 @@ date: 2021-05-19 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 > - Cgroups功能正常加载。 @@ -90,7 +90,7 @@ date: 2021-05-19 ## 模型管理（系统管理员用户） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 模型管理操作需要在数据库正常的状态下进行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 模型管理操作需要在数据库正常的状态下进行。 1. 新增模型： @@ -102,7 +102,7 @@ date: 2021-05-19 INSERT INTO gs_opt_model values('rlstm', 'model_name', 'datname', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text'); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 具体模型参数设置请参考[GS_OPT_MODEL](GS_OPT_MODEL)。 > - 目前“template_name”列只支持“rlstm”。 @@ -186,7 +186,7 @@ date: 2021-05-19 ## 模型预测 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 > - 目前，模型训练参数的标签设置中需要包含“S”标签，explain中才可显示“p-time”预测值。 例：INSERT INTO gs_opt_model values('rlstm', 'default', 'mogdb', '127.0.0.1', 5000, 1000, 1, -1, 50, 500, 0 , false, false, '{**S**, T}', '{0,0}', '{0,0}', 'Text'); diff --git a/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-preparations.md b/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-preparations.md index e9193e85..e5a192e0 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-preparations.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-2-preparations.md @@ -25,7 +25,7 @@ date: 2021-05-19 调优程序是一个独立于数据库内核之外的工具，需要提供数据库及其所在实例的用户名和登录密码信息，以便控制数据库执行benchmark进行性能测试；在启动调优程序前，要求用户测试环境交互正常，能够正常跑通benchmark测试脚本、能够正常连接数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 调优程序X-Tuner包含三种运行模式，分别是: @@ -33,7 +33,7 @@ date: 2021-05-19 - train：通过用户提供的benchmark信息，不断地进行参数修改和benchmark的执行。通过反复的迭代过程，训练强化学习模型，以便用户在后面通过tune模式加载该模型进行调优。 - tune：使用优化算法进行数据库参数的调优，当前支持两大类算法，一种是深度强化学习，另一种是全局搜索算法（全局优化算法）。深度强化学习模式要求先运行train模式，生成训练后的调优模型，而使用全局搜索算法则不需要提前进行训练，可以直接进行搜索调优。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 **图 1** X-Tuner 结构图
@@ -46,7 +46,7 @@ X-Tuner 的整体架构如图1 X-Tuner 结构图所示，系统可以分为： - X-Tuner 主体逻辑模块：通过Enviroment模块进行封装，每一个step 就是一次调优过程。整个调优过程通过多个step进行迭代； - benchmark：由用户指定的benchmark性能测试脚本，用于运行benchmark作业，通过跑分结果反映数据库系统性能优劣。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPC-H这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPC-H这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。
diff --git a/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md b/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md index 7d81dc93..6ccfd858 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/3-x-tuner-parameter-optimization-and-diagnosis/3-3-examples.md @@ -40,7 +40,7 @@ X-Tuner 支持三种模式，分别是获取参数诊断报告的recommend模式 则可通过 -f connection.json 传递。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。
@@ -71,7 +71,7 @@ gs_xtuner recommend -f connection.json - checkpoint_avg_sync_time：数据库在checkpoint 时，平均每次同步刷新数据到磁盘的时长，单位是毫秒。 - load_average：平均**每个CPU核心**在1分钟、5分钟以及15分钟内的负载。一般地，该数值在1左右表明当前硬件比较匹配workload、在3左右表明运行当前作业压力比较大，大于5则表示当前硬件环境运行该workload压力过大（此时一般建议减少负载或升级硬件）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限)。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。使用如下命令清除统计信息： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: recommend 模式会读取数据库中的pg_stat_database以及 pg_stat_bgwriter等系统表中的信息，需要登录到数据库上的用户具有足够的权限（建议为**管理员权限**，可通过alter user username sysadmin；授予username相应的权限)。 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。使用如下命令清除统计信息： > > `select pg_stat_reset_shared('bgwriter');` > diff --git a/product/zh/docs-mogdb/v2.1/AI-features/5-a-detection-status-monitoring/5-2-preparations.md b/product/zh/docs-mogdb/v2.1/AI-features/5-a-detection-status-monitoring/5-2-preparations.md index 425a08bc..7d71965b 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/5-a-detection-status-monitoring/5-2-preparations.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/5-a-detection-status-monitoring/5-2-preparations.md @@ -160,7 +160,7 @@ freq = 3S # 趋势预测频率 period = 2 # 趋势预测长度 ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持的时间单位： > - 'S'：second，秒。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md index b24139d0..147f84db 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-1-single-query-index-recommendation.md @@ -15,7 +15,7 @@ date: 2021-05-19 | :-------------- | :------------ | :----------------------------- | | gs_index_advise | SQL语句字符串 | 针对单条查询语句生成推荐索引。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。 > - 本功能暂不支持分区表、列存表、段页式表、普通视图、物化视图、全局临时表以及密态数据库。 @@ -58,4 +58,4 @@ mogdb=# select "table", "column" from gs_index_advise('select name, age, sex fro CREATE INDEX idx1 on t1(age, sex); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（'） 进行转义，可参考上述示例。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md index 5c212af6..a9ae4e19 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-2-virtual-index.md @@ -118,7 +118,7 @@ date: 2021-05-19 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 执行EXPLAIN ANALYZE不会涉及虚拟索引功能。 > - 创建的虚拟索引是数据库实例级别的，各个会话（session）之间可共享设置，关闭会话后虚拟索引仍可存在，但是重启数据库后将被清空。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-3-workload-level-index-recommendation.md b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-3-workload-level-index-recommendation.md index b3c1a085..e4808e45 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-3-workload-level-index-recommendation.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/6-index-advisor-index-recommendation/6-3-workload-level-index-recommendation.md @@ -25,7 +25,7 @@ date: 2021-05-19 - log_statement= 'all' - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 业务数据抽取完毕建议将上述GUC参数复原，否则容易导致日志文件膨胀。
@@ -109,4 +109,4 @@ date: 2021-05-19 create index ind9 on public.bmsql_district(d_w_id); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** multi_node参数需严格按照当前数据库架构进行指定，否则推荐结果不全，甚至导致无推荐结果。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: multi_node参数需严格按照当前数据库架构进行指定，否则推荐结果不全，甚至导致无推荐结果。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-2-environment-deployment.md b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-2-environment-deployment.md index 2898d749..97ae9ec0 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-2-environment-deployment.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-2-environment-deployment.md @@ -36,7 +36,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 pip install scipy ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果自行编译python，需要在**configure**脚本执行时加入**-enable-shared**参数； > - 如果系统中的python2使用的是UCS4编码，自行编译python2时，还需要加入**-enable-unicode=ucs4**参数。 可以在系统中自带的python2下执行：“import sys；print sys.maxunicode”并查看结果，如果结果是65535，说明系统默认的是ucs2；如果结果是1114111，说明用的ucs4编码。 @@ -78,7 +78,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 其中， {YOUR_MADLIB_INSTALL_FOLDER}需要改为用户的实际安装路径。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 编译MADlib时，会联网下载依赖软件。无法联网时，需要手动下载依赖包“PyXB-1.2.6.tar.gz”，“eigen-branches-3.2.tar.gz”和“boost_1_61_0.tar.gz”放在本地。使用的configure命令如下： > > ```bash > ./configure -DCMAKE_INSTALL_PREFIX={YOUR_MADLIB_INSTALL_FOLDER} # your install folder @@ -111,7 +111,7 @@ DeepSQL环境包括编译数据库和安装算法库两个部分。 install为安装的命令，除此之外，还有reinstall（重新安装），uninstall（卸载）等命令可用。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 目标数据库必须存在。 > - IP请使用127.0.0.1，不要使用localhost。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-3-usage-guide.md b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-3-usage-guide.md index 5233799a..c73261a0 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-3-usage-guide.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-3-usage-guide.md @@ -196,7 +196,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考[审计](1-aud 当前PL/Python存储过程对并发执行不友好，建议串行执行。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于MogDB是多线程架构，C-python中，由于GIL锁（Global Interpreter Lock)的限制，多线程在Python中只能交替执行，无法做到真正的并发。
@@ -204,7 +204,7 @@ PL/Python存储过程支持审计功能。具体设置可以参考[审计](1-aud 具体库内算法介绍和使用，可参考MADlib官方网站（[MADlib文档](http://madlib.apache.org/docs/latest/index.html)）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当前仅支持机器学习算法，不支持深度学习（deep learning)模块。 > - 当前数据库不支持xml，所以pmml模块和相关功能不支持。 diff --git a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-4-best-practices.md b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-4-best-practices.md index 502bad89..293cc565 100644 --- a/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-4-best-practices.md +++ b/product/zh/docs-mogdb/v2.1/AI-features/7-deepsql/7-4-best-practices.md @@ -161,7 +161,7 @@ create database test1 dbcompatibility='B'; 除了指定不同的核方法外，还可以指定迭代次数，初始参数，比如init_stepsize, max_iter, class_weight等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > ```sql > SET search_path="$user",public,madlib; diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-2-br.md b/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-2-br.md index 1da9f77f..e2ac6d4a 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-2-br.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-2-br.md @@ -497,7 +497,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **恢复目标相关参数(recovery_options)** -> **说明：** +> **说明**: > > 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： > @@ -534,7 +534,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **留存相关参数(retention_options)** -> **说明：** +> **说明**: > > 可以和backup和delete命令一起使用这些参数。 @@ -574,7 +574,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **固定备份相关参数(pinning_options)** -> **说明：** +> **说明**: > > 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -648,7 +648,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **连接相关参数(connection_options)** -> **说明：** +> **说明**: > > 可以和backup命令一起使用这些参数。 @@ -690,7 +690,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **压缩相关参数(compression_options)** -> **说明：** +> **说明**: > > 可以和backup命令一起使用这些参数。 @@ -719,7 +719,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **远程模式相关参数(remote_options)** -> **说明：** +> **说明**: > > 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 @@ -765,7 +765,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 例如：-ssh-options='-c cipher_spec -F configfile' ->**说明：** +>**说明**: > >* 如果因为网络临时故障等原因导致server端无应答，gs_probackup将在等待archive-timeout（默认300秒）后退出。 > diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-3-br.md b/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-3-br.md index 051a5c12..4ad405b3 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-3-br.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/br/1-3-br.md @@ -387,7 +387,7 @@ gs_dump -p port_number -f dump1.sql AES128密钥长度必须是16字节。 -**说明：** +**说明**: 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md b/product/zh/docs-mogdb/v2.1/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md index 6319837c..592d897e 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md @@ -37,7 +37,7 @@ not null column_list ] ] 在任何gsql客户端登录数据库成功后，可以使用该命令进行数据的导入/导出。但是与SQL的COPY命令不同，该命令读取/写入的文件是本地文件，而非数据库服务器端文件；所以，要操作的文件的可访问性、权限等，都是受限于本地用户的权限。 -> **说明：** +> **说明**: > > \\COPY只适合小批量、格式良好的数据导入，不会对非法字符做预处理，也无容错能力，无法适用于含有异常数据的场景。导入数据应优先选择GDS或COPY。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md index a436f76c..f89beced 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md @@ -11,7 +11,7 @@ date: 2021-03-04 测试使用了BenchmarkSQL（请参见**MOT样例TPC-C基准**），并且使用交互式SQL命令而不是存储过程来生成工作负载。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 评估MogDB MOT性能和磁盘性能的所有测试都使用了同步日志记录和在MOT中优化的group-commit=on版本。 @@ -134,7 +134,7 @@ MOT高吞吐量测试结果如下。 MOT的平均事务速度为2.5倍，MOT延迟为10.5ms，而基于磁盘的表延迟为23至25ms。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅**MOT样例TPC-C基准**中关于TPC-C事务的说明。 **图 2** 低延迟（90th%，事务平均）性能基准 @@ -152,7 +152,7 @@ MOT完全集成到MogDB中，包括支持主备部署的高可用场景。WAL重 **MogDB（包括MOT）的RTO小于10秒。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ 另外，从[MOT高吞吐量](#MOT高吞吐量)的MOT中可以看出，在Arm/鲲鹏架构下，主从高可用场景复制开销仅为7%，在x86架构下仅为2%，而基于磁盘的表复制开销为2%。Arm/鲲鹏机型为20%，x86机型为15%。 @@ -173,7 +173,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴**时间（秒）**表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴**吞吐量GB/秒**表示。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。
diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md index 28cb92be..c6c4dac2 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md @@ -74,7 +74,7 @@ MOT不需要任何特殊修改或安装新软件。但是，一些优化可以 MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完全驻留在内存中。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 服务器上必须有足够的物理内存以维持内存表的状态，并满足工作负载和数据的增长。所有这些都是在传统的基于磁盘的引擎、表和会话所需的内存之外的要求。因此，提前规划好足够的内存来容纳这些内容是非常有必要的。 @@ -94,7 +94,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 如果违反此限制，则调整MOT内存内部限制，最大可能地满足上述限制范围。该调整在启动时进行，并据此计算MOT最大内存值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 此时，会向服务器日志发出警告，如下所示： @@ -181,7 +181,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 在配置max_mot_local_memory设置和应用程序开发时，请考虑此场景。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**内存（MOT）**部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**内存（MOT）**部分。
@@ -209,7 +209,7 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 检查点之所以需要两倍大小，是因为快照会保存数据的全部大小到磁盘上，此外还应该为正在进行的检查点分配同样数量的空间。当检查点进程结束时，以前的检查点文件将被删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 - **日志记录** @@ -223,4 +223,4 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低延迟的驱动器上。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**存储（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**存储（MOT）**。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md index 43fca0ac..ec03c066 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md @@ -297,7 +297,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 阅读**总体原则**，根据需要查看和配置mot.conf文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，**MOT恢复**说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的**MOT恢复**。下文各相关章节中还提供了参考链接。 以下介绍了mot.conf文件中的各个部分，其包含的设置以及默认值。 @@ -395,7 +395,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 检查点由多个MOT引擎工作线程并行执行。工作线程的数量可能会大大影响整个检查点操作的整体性能，以及其它正在运行的事务的操作。为了实现较短的检查点持续时间，应使用更多线程，直至达到最佳数量（根据硬件和工作负载的不同而不同）。但请注意，如果这个数目太大，可能会对其他正在运行的事务的执行时间产生负面影响。尽可能低这个数字，以最小化对其他运行事务的运行时的影响。当此数目过高时，检查点持续时间会较长。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅**MOT检查点**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅**MOT检查点**。
@@ -405,7 +405,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 指定在检查点数据恢复期间要使用的工作线程数。每个MOT引擎工作线程在自己的核上运行，通过将不同的表读入内存，可以并行处理不同的表。缺省值为3，可将此参数设置为可处理的核数。恢复后，将停止并杀死这些线程。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**MOT恢复**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**MOT恢复**。
diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md index 379cebb1..34298b51 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md @@ -30,7 +30,7 @@ MogDB允许应用程序使用MOT和基于标准磁盘的表。MOT适用于最活 以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次： @@ -96,7 +96,7 @@ create FOREIGN table bmsql_oorder ( create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 有关MOT索引限制，请参见“MOT SQL覆盖和限制”的索引部分内容。 @@ -134,7 +134,7 @@ create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) 6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。 7. 恢复应用程序活动。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
@@ -301,7 +301,7 @@ MOT编译支持的特性和不支持的特性见下文。 在乐观并发控制（OCC）中，在COMMIT阶段前的事务期间（使用任何隔离级别）不会对记录进行锁定。这是一个能显著提高性能的强大优势。它的缺点是，如果另一个会话尝试更新相同的记录，则更新可能会失败。所以必须中止整个事务。这些所谓的更新冲突是由MOT在提交时通过版本检查机制检测到的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 这种更新冲突在常见的OLTP场景中非常少见，在使用MOT时尤其少见。但是，由于仍有可能发生这种情况，开发人员应该考虑使用事务重试代码来解决此问题。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md index c6afa608..288e13b4 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md @@ -133,7 +133,7 @@ WAL重做日志将保留所有表行修改，直到执行检查点（如上所 - group_commit_size：一组已提交的事务数。例如，16表示当同一组中的16个事务已由它们的客户端应用程序提交时，则针对16个事务中的每个事务，在磁盘的WAL重做日志中写入一个条目。 - group_commit_timeout：超时时间，单位为毫秒。例如，10表示在10毫秒之后，为同一组由客户端应用程序在最近10毫秒内提交的每个事务，在磁盘的WAL重做日志中写入一个条目。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅**重做日志（MOT）**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅**重做日志（MOT）**。
@@ -414,7 +414,7 @@ MOT使用返回码（Return Code，RC）返回Postgres标准错误代码至封 MOT从内部返回Postgres代码（见下文）到数据库包，数据库封装根据标准的Postgres行为对其做出反应。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 **表 2** 返回给用户并记录到日志文件的错误 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md index b2710b30..ecc825e3 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md @@ -47,7 +47,7 @@ tpm-C指标是每分钟执行的新订单事务数。考虑到事务中所需的 tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 ## 系统级优化 @@ -65,7 +65,7 @@ tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 在下载的Java文件（与原始文件相比）中所做的唯一更改是注释错误日志打印，以进行序列化和重复键错误。这些错误在MOT中是正常的，因为MOT使用的是乐观并发控制（OCC）机制。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 基准测试使用标准交互式SQL模式执行，没有存储过程。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 基准测试使用标准交互式SQL模式执行，没有存储过程。 ## 运行基准 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md index e4c75101..d7ba450d 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md @@ -17,7 +17,7 @@ MOT旨在实现以下目标： - **线性扩容**：MOT提供事务性存储引擎，利用单个NUMA架构服务器的所有核，以提供近线性的扩容性能。这意味着MOT的目标是在机器的核数和性能提升倍数之间实现直接的、近线性的关系。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md index dd2a665e..85a7bbbc 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md @@ -9,7 +9,7 @@ date: 2021-03-04 通过大量研究，我们找到了最佳的并发控制机制，结论为：基于SILO的OCC算法是MOT中最符合ACID特性的OCC算法。SILO为满足MOT的挑战性需求提供了最好的基础。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如**MOT简介**所述。 下面介绍MOT的并发控制机制。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md index f76fd7d2..11d0fb72 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md @@ -40,7 +40,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 - 在恢复期间，从最后一个已知或特定检查点加载数据；然后使用WAL重做日志完成从该点开始发生的数据更改。 - WAL重做日志将保留所有表行修改，直到执行一个检查点为止（如上所述）。然后可以截断日志，以减少恢复时间和节省磁盘空间。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。
@@ -86,7 +86,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 这样，将事务写入WAL更为有效，因为来自同一个槽位的所有缓冲区都一起写入磁盘。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 2. 在事务完成并且客户端应用程序发送Commit命令之后，事务重做日志条目将与属于同一组的其他事务一起序列化。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md index 41ad61ff..269a64b4 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md @@ -17,7 +17,7 @@ date: 2021-06-24 gs_om -t start ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 双机启动必须以双机模式启动，若中间过程以单机模式启动，则必须修复才能恢复双机关系，用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 双机启动必须以双机模式启动，若中间过程以单机模式启动，则必须修复才能恢复双机关系，用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 ## 停止MogDB @@ -29,7 +29,7 @@ date: 2021-06-24 gs_om -t stop ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 启停节点及AZ的操作请参见“参考指南 > 工具参考 > 服务端工具 > [gs_om](8-gs_om)”章节。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/11-log-reference.md b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/11-log-reference.md index 39cf9567..bcb11bf2 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/11-log-reference.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/11-log-reference.md @@ -61,7 +61,7 @@ postgresql-创建时间.log 其中`$GAUSSLOG`默认为`/var/log/mogdb/_用户名_`。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果使用om脚本部署时，则日志路径为 `/var/log/mogdb/_用户名_`。 **日志文件命名格式** @@ -103,7 +103,7 @@ postgresql-创建时间.log 例如，系统中的第一个事务日志文件是000000010000000000000000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 **日志内容说明** diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md index d64a7bea..c18f8ba5 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md @@ -63,7 +63,7 @@ date: 2021-12-2 3. 获取软件安装包中的"MogDB-x.x.x-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -102,7 +102,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -144,7 +144,7 @@ date: 2021-12-2 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -155,7 +155,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -197,7 +197,7 @@ date: 2021-12-2 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > + 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v2.1/administrator-guide/upgrade-guide.md b/product/zh/docs-mogdb/v2.1/administrator-guide/upgrade-guide.md index b633513d..57bb3988 100644 --- a/product/zh/docs-mogdb/v2.1/administrator-guide/upgrade-guide.md +++ b/product/zh/docs-mogdb/v2.1/administrator-guide/upgrade-guide.md @@ -302,7 +302,7 @@ root用户密码 3. 重置控制文件格式以兼容2.1.0版本中新增的ustore存储引擎（仅限于2.0.1升级到2.1）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**警告：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**警告**: > > - 此操作不可回退，执行后无法再降级回2.0.1版本。 > - 执行此操作前，建议参考[逻辑备份恢复](1-3-br)做一次数据全备份。 diff --git a/product/zh/docs-mogdb/v2.1/characteristic-description/database-security/11-password-strength-verification.md b/product/zh/docs-mogdb/v2.1/characteristic-description/database-security/11-password-strength-verification.md index 1bf5f492..df379ca7 100644 --- a/product/zh/docs-mogdb/v2.1/characteristic-description/database-security/11-password-strength-verification.md +++ b/product/zh/docs-mogdb/v2.1/characteristic-description/database-security/11-password-strength-verification.md @@ -34,7 +34,7 @@ date: 2022-05-07 - 不能和当前密码、当前密码的倒写相同。 - 不能是弱口令。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 弱口令指的是强度较低，容易被破解的密码，对于不同的用户或群体，弱口令的定义可能会有所区别，用户需要自己添加定制化的弱口令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 弱口令指的是强度较低，容易被破解的密码，对于不同的用户或群体，弱口令的定义可能会有所区别，用户需要自己添加定制化的弱口令。 参数password_policy设置为1时表示采用密码复杂度校验，默认值为1。 @@ -68,4 +68,4 @@ MogDB 1.1.0版本实现了弱口令字典功能。 ## 依赖关系 -无。 \ No newline at end of file +无。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md index 689df80e..1411fd50 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md @@ -7,7 +7,7 @@ date: 2021-10-11 # 示例：不同场景下连接数据库参数配置 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以下示例场景中node代表“host:port”，host为数据库服务器名称或IP地址，port为数据库服务器端口。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以下示例场景中node代表“host:port”，host为数据库服务器名称或IP地址，port为数据库服务器端口。 ## 容灾场景 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md index 0c36598e..b90cd0c0 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md @@ -63,5 +63,5 @@ java.sql.Connection是数据库连接接口。 | setTransactionIsolation(int level) | void | Yes | | setTypeMap(Map<String,Class<?>> map) | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 接口内部默认使用自动提交模式，若通过setAutoCommit(false)关闭自动提交，将会导致后面执行的语句都受到显式事务包裹，数据库中不支持事务中执行的语句不能在此模式下执行。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md index dbb92d0e..f74ce9f4 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md @@ -39,7 +39,7 @@ java.sql.CallableStatement是存储过程执行接口。 | registerOutParameter(int parameterIndex, int type) | void | Yes | | wasNull() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不允许含有OUT参数的语句执行批量操作。 > - 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows , setFetchSize。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md index 19a170d4..238f803f 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md @@ -61,7 +61,7 @@ java.sql.PreparedStatement是预处理语句接口。 | addBatch() | void | Yes | | executeBatch() | int[] | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - addBatch()、execute()必须在clearBatch()之后才能执行。 > - 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除 。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md index 1daf58a3..5a009523 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md @@ -148,7 +148,7 @@ java.sql.ResultSet是执行结果集接口。 | updateTimestamp(String columnLabel, Timestamp x) | void | Yes | | wasNull() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一个Statement不能有多个处于"open"状态的ResultSet。 > - 用于遍历结果集(ResultSet)的游标(Cursor)在被提交后不能保持“open”的状态。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md index 1b50c614..0fe3fbb1 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md @@ -62,7 +62,7 @@ java.sql.Statement是SQL语句接口。 | executeLargeUpdate(String sql, int[] columnIndexes) | long | No | | executeLargeUpdate(String sql, String[] columnNames) | long | No | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，会有性能损耗。 > - 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md index a4ee1896..91847a52 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md @@ -135,7 +135,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: > > - MogDB数据库不支持带有输出参数的函数，也不支持存储过程和函数参数默认值。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 > diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md index 07c3729b..de4a3c87 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md @@ -33,7 +33,7 @@ Servername=10.10.0.13（数据库Server IP） Debug=1（打开驱动端debug日志） ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** unixODBC日志将会生成在TraceFile配置的路径下，psqlODBC会在系统/tmp/下生成mylog_xxx.log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: unixODBC日志将会生成在TraceFile配置的路径下，psqlODBC会在系统/tmp/下生成mylog_xxx.log。 ## 高性能场景 @@ -493,4 +493,4 @@ int main() } ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 上述用例中定义了number列，调用SQLBindParameter接口时，绑定SQL_NUMERIC会比SQL_LONG性能高一些。因为如果是char，在数据库服务端插入数据时需要进行数据类型转换，从而引发性能瓶颈。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 上述用例中定义了number列，调用SQLBindParameter接口时，绑定SQL_NUMERIC会比SQL_LONG性能高一些。因为如果是char，在数据库服务端插入数据时需要进行数据类型转换，从而引发性能瓶颈。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md index 7dbb5a0a..fefdd9f3 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md @@ -42,7 +42,7 @@ PGresult：包含查询结果的对象指针。 - PQprepare创建一个为PQexecPrepared执行用的预备语句，本特性支持命令的重复执行，不需要每次都进行解析和规划。PQprepare仅在协议3.0及以后的连接中支持，使用协议2.0时，PQprepare将失败。 - 该函数从查询字符串创建一个名为stmtName的预备语句，该查询字符串必须包含一个SQL命令。stmtName可以是”“来创建一个未命名的语句，在这种情况下，任何预先存在的未命名的语句都将被自动替换；否则，如果在当前会话中已经定义了语句名称，则这是一个错误。如果使用了任何参数，那么在查询中将它们称为$1,$2等。nParams是在paramTypes[]数组中预先指定类型的参数的数量。（当nParams为0时，数组指针可以为NULL） paramTypes[]通过OID指定要分配给参数符号的数据类型。如果paramTypes为NULL ，或者数组中的任何特定元素为零，服务器将按照对非类型化字面字符串的相同方式为参数符号分配数据类型。另外，查询可以使用数字高于nParams的参数符号；还将推断这些符号的数据类型。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过执行SQLPREPARE语句，还可以创建与PQexecPrepared一起使用的预备语句。此外，虽然没有用于删除预备语句的libpq函数，但是SQL DEALLOCATE语句可用于此目的。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md b/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md index 40b9d44f..01bbbdfd 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md @@ -34,7 +34,7 @@ PGresult：包含查询结果的对象指针。 应该调用PQresultStatus函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回PGRES_FATAL_ERROR）。使用PQerrorMessage获取有关错误的更多信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 命令字符串可以包括多个SQL命令（用分号分隔）。在一个PQexec调用中发送的多个查询是在一个事务里处理的，除非在查询字符串里有明确的BEGIN/COMMIT命令把整个字符串分隔成多个事务。请注意，返回的PGresult结构只描述字符串里执行的最后一条命令的结果，如果有一个命令失败，那么字符串处理的过程就会停止，并且返回的PGresult会描述错误条件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md b/product/zh/docs-mogdb/v2.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md index 0283e578..6c55cfff 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/foreign-data-wrapper/3-postgres_fdw.md @@ -11,7 +11,7 @@ postgres_fdw是一款开源插件，其代码随PostgreSQL源码一同发布。M postgres_fdw插件默认参与编译，使用安装包安装好MogDB后，可直接使用postgres_fdw，无须其他操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。 ## 使用postgres_fdw diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md b/product/zh/docs-mogdb/v2.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md index fc7fac0c..a8519147 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/logical-replication/2-logical-decoding-by-sql-function-interfaces.md @@ -13,7 +13,7 @@ MogDB可以通过调用SQL函数，进行创建、删除、推进逻辑复制槽 - 逻辑日志目前从主机节点中抽取，默认关闭SSL连接，如果进行逻辑复制，需要先上配置GUC参数ssl=on。 - > **说明：** 为避免安全风险，请保证启用SSL连接。 + > **说明**: 为避免安全风险，请保证启用SSL连接。 - 设置GUC参数wal_level=logical。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-11-cursors.md b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-11-cursors.md index 119557d5..e6a5d90b 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-11-cursors.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-11-cursors.md @@ -11,7 +11,7 @@ date: 2021-03-04 为了处理SQL语句，存储过程进程分配一段内存区域来保存上下文联系。游标是指向上下文区域的句柄或指针。借助游标，存储过程可以控制上下文区域的变化。 -> **须知：** +> **须知**: > 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 游标的使用分为显式游标和隐式游标。对于不同的SQL语句，游标的使用情况不同，详细信息请参见[表1](#游标使用情况)。 @@ -52,7 +52,7 @@ date: 2021-03-04 - select_statement：查询语句。 - > **说明：** + > **说明**: > 根据执行计划的不同，系统会自动判断该游标是否可以用于以倒序的方式检索数据行。 **定义动态游标：**指ref游标，可以通过一组静态的SQL语句动态的打开游标。首先定义ref游标类型，然后定义该游标类型的游标变量，在打开游标时通过OPEN FOR动态绑定SELECT语句。 @@ -124,7 +124,7 @@ date: 2021-03-04 **格式调用为**： SQL% -> **说明：** +> **说明**: > INSERT、UPDATE、DELETE、SELECT语句中不必明确定义游标。 **属性** diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-13-debugging.md b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-13-debugging.md index 8fe9e9f3..780f0d35 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-13-debugging.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-13-debugging.md @@ -55,10 +55,10 @@ RAISE有以下五种语法格式： 如果在RAISE EXCEPTION命令中既没有指定条件名也没有指定SQLSTATE，默认用RAISE EXCEPTION (P0001)。如果没有指定消息文本，默认用条件名或者SQLSTATE作为消息文本。 -> **须知：** +> **须知**: > 当由SQLSTATE指定了错误码，则不局限于已定义的错误码，可以选择任意包含五个数字或者大写的ASCII字母的错误码，而不是00000。建议避免使用以三个0结尾的错误码，因为这种错误码是类别码，会被整个种类捕获。 > -> **说明：** +> **说明**: > [图5](#raise::=)所示的语法不接任何参数。这种形式仅用于一个BEGIN块中的EXCEPTION语句，它使得错误重新被处理。 ## **示例** diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-5-declare-syntax.md b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-5-declare-syntax.md index 77a4bfce..b204032e 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-5-declare-syntax.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-5-declare-syntax.md @@ -70,7 +70,7 @@ PL/SQL块可以分为以下几类： - 匿名块程序实施部分，以BEGIN语句开始，以END语句停顿，以一个分号结束。输入“/”按回车执行它。 - > **须知：** + > **须知**: > 最后的结束符”/“必须独占一行，不能直接跟在END后面。 - 声明部分包括变量定义、类型、游标定义等。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-6-basic-statements.md b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-6-basic-statements.md index abf3c088..af46748a 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-6-basic-statements.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-6-basic-statements.md @@ -9,7 +9,7 @@ date: 2021-03-04 在编写PL/SQL过程中，会定义一些变量，给变量赋值，调用其他存储过程等。介绍PL/SQL中的基本语句，包括定义变量、赋值语句、调用语句以及返回语句。 -> **说明：** +> **说明**: > 尽量不要在存储过程中调用包含密码的SQL语句，因为存储在数据库中的存储过程文本可能被其他有权限的用户看到导致密码信息被泄漏。如果存储过程中包含其他敏感信息也需要配置存储过程的访问权限，保证敏感信息不会泄漏。 ## 定义变量 @@ -76,7 +76,7 @@ my_employee cur%ROWTYPE my_name cur.firstname%TYPE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - %TYPE不支持引用复合类型或RECORD类型变量的类型、RECORD类型的某列类型。 > - %ROWTYPE不支持引用复合类型或RECORD类型变量的类型。 @@ -145,7 +145,7 @@ END; / ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - INTO 方式赋值仅支持对第一层列赋值，且不支持二维及以上数组； > - 引用嵌套的列值时，若存在数组下标，目前仅支持在前三层列中只存在一个小括号情况，建议使用方括号[ ]引用下标； diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-8-control-statements.md b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-8-control-statements.md index c3848946..19ddce54 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-8-control-statements.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/plpgsql/1-8-control-statements.md @@ -228,7 +228,7 @@ AS CALL proc_loop(10,5); ``` -> **须知：** +> **须知**: > 该循环必须要结合EXIT使用，否则将陷入死循环。 **WHILE_LOOP语句** @@ -483,7 +483,7 @@ DROP TABLE mytab; 当控制到达给y赋值的地方时，会有一个division_by_zero错误失败。这个错误将被EXCEPTION子句捕获。而在RETURN语句里返回的数值将是x的增量值。 -> **说明：** +> **说明**: > 进入和退出一个包含EXCEPTION子句的块要比不包含的块开销大的多。因此，不必要的时候不要使用EXCEPTION。 > 在下列场景中，无法捕获处理异常，整个存储过程回滚：节点故障、网络故障引起的存储过程参与节点线程退出以及COPY FROM操作中源数据与目标表的表结构不一致造成的异常。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md index 8ac3dc5d..43641be3 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md @@ -36,7 +36,7 @@ MogDB支持通过创建资源池对主机资源进行划分。开启资源负载 | nodegroup | installation | 资源池所在的逻辑集群的名称。 | | is_foreign | f | 资源池不用于逻辑集群之外的用户。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** MogDB不允许对default_pool参数进行修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: MogDB不允许对default_pool参数进行修改。 ## 前提条件 @@ -91,14 +91,14 @@ mogdb=# DROP RESOURCE POOL resource_pool_a2; DROP RESOURCE POOL ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果某个角色已关联到该资源池，无法删除。 > - 多租户场景下，如果删除组资源池，其业务资源池都将被删除。只有不关联用户时，资源池才能被删除。 ## 查看资源池的信息 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不允许使用INSERT、UPDATE、DELETE、TRUNCATE操作资源负载管理的系统表pg_resource_pool。 > - 不允许修改资源池的memory_limit和cpu_affinity属性。 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md index ed97d4b1..70c5178d 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md @@ -34,7 +34,7 @@ date: 2021-10-22 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果一个用户的login权限被取消，那么他的resource pool将会自动修改为default_pool。default_pool的详细介绍请参见[创建资源池](creating-a-resource-pool)中的表2。 ## 操作步骤 diff --git a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md index 89f42dae..69c977ee 100644 --- a/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md +++ b/product/zh/docs-mogdb/v2.1/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md @@ -19,7 +19,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 ## 操作步骤 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在MogDB中，需要在每个集群节点上执行控制组的创建、更新、删除操作，才能实现对整个集群资源的控制，所以下述步骤中都使用《工具参考》中“服务端工具 > gs_ssh”命令执行。 > - 控制组的命名要求如下： @@ -74,7 +74,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 gs_ssh -c "gs_cgroup -u -S class_a -G workload_a1 -g 30" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 调整后的Workload控制组“workload_a1”占有的CPU资源不应大于其对应的子Class控制组“class_a”。并且，此名称不能是Timeshare Cgroup的默认名称，如“Low”、“Medium”、“High”或“Rush”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 调整后的Workload控制组“workload_a1”占有的CPU资源不应大于其对应的子Class控制组“class_a”。并且，此名称不能是Timeshare Cgroup的默认名称，如“Low”、“Medium”、“High”或“Rush”。 **删除控制组** @@ -86,7 +86,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 以上操作可以删除控制组“class_a”。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** root用户或者具有root访问权限的用户指定“-d” 和“-U username”删除普通用户“username”可访问的默认Cgroups。普通用户指定“-d”和“-S classname”可以删除已有的Class Cgroups。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: root用户或者具有root访问权限的用户指定“-d” 和“-U username”删除普通用户“username”可访问的默认Cgroups。普通用户指定“-d”和“-S classname”可以删除已有的Class Cgroups。 ## 查看控制组的信息 diff --git a/product/zh/docs-mogdb/v2.1/faqs/deployment-and-maintenance-faqs.md b/product/zh/docs-mogdb/v2.1/faqs/deployment-and-maintenance-faqs.md index c5b699c3..83c71904 100644 --- a/product/zh/docs-mogdb/v2.1/faqs/deployment-and-maintenance-faqs.md +++ b/product/zh/docs-mogdb/v2.1/faqs/deployment-and-maintenance-faqs.md @@ -293,7 +293,7 @@ Checking directory. print(staticConfigPath_dn) ``` - > **说明：**需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 + > **说明**: 需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 2. 执行如下命令生成集群静态配置文件。 diff --git a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/1-installation-preparation.md b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/1-installation-preparation.md index a9673a0c..39e34930 100644 --- a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/1-installation-preparation.md +++ b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/1-installation-preparation.md @@ -216,7 +216,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `$地区/$时区`为需要设置时区的信息，例如：Asia/Shanghai。 3. 使用**date -s**命令将各数据库节点的时间设置为统一时间，举例如下。 @@ -227,7 +227,7 @@ vim /etc/profile ### (可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 diff --git a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md index 08acecda..4f44be4e 100644 --- a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md @@ -38,7 +38,7 @@ date: 2021-06-11 sh install.sh -w xxxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定）,安全需要必须设置。密码应包括大小写、字符、数字。 > - -p：指定的MogDB端口号, 如不指定，默认为5432。 @@ -69,10 +69,10 @@ date: 2021-06-11 static_connections : 0 db_state : Normal detail_information : Normal - + Senders info: No information - + Receiver info: No information ``` @@ -93,4 +93,4 @@ date: 2021-06-11 Type "help" for help. MogDB=# - ``` \ No newline at end of file + ``` diff --git a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md index 8e1cfd59..9a7e2549 100644 --- a/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md +++ b/product/zh/docs-mogdb/v2.1/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md @@ -38,7 +38,7 @@ date: 2021-06-11 sh install.sh -w xxxx --multinode ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 密码应包括大小写、字符、数字。 > - -p：指定的MogDB主节点端口号，默认5432。备节点端口号会使用主端口号+200，默认5632。 @@ -61,7 +61,7 @@ date: 2021-06-11 omm 5083 1.1 0.9 1819988 327200 pts/0 Sl 14:26 0:49 /opt/software/mogdb/bin/mogdb -D /opt/software/mogdb/data/slave -M standby omm 20377 0.0 0.0 119880 1216 pts/0 S+ 15:37 0:00 grep --color=auto mogdb ``` - + 执行gs_ctl命令，显示类似如下信息： ``` @@ -71,7 +71,7 @@ date: 2021-06-11 static_connections : 1 db_state : Normal detail_information : Normal - + Senders info: sender_pid : 5165 local_role : Primary @@ -91,7 +91,7 @@ date: 2021-06-11 sync_priority : 1 sync_most_available : Off channel : 10.244.44.52:27001-->10.244.44.52:35912 - + Receiver info: No information ``` @@ -112,4 +112,4 @@ date: 2021-06-11 Type "help" for help. MogDB=# - ``` \ No newline at end of file + ``` diff --git a/product/zh/docs-mogdb/v2.1/installation-guide/standard-installation/3-modifying-os-configuration.md b/product/zh/docs-mogdb/v2.1/installation-guide/standard-installation/3-modifying-os-configuration.md index 9749e943..ebc6ac93 100644 --- a/product/zh/docs-mogdb/v2.1/installation-guide/standard-installation/3-modifying-os-configuration.md +++ b/product/zh/docs-mogdb/v2.1/installation-guide/standard-installation/3-modifying-os-configuration.md @@ -82,7 +82,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `$地区/$时区`为需要设置时区的信息，例如：Asia/Shanghai。 使用date -s命令将各主机的时间设置为统一时间，举例如下。 @@ -91,12 +91,12 @@ cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime date -s "Sat Sep 27 16:00:07 CST 2020" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 可以通过date命令查询主机时区。 ## （可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 @@ -219,7 +219,7 @@ ifconfig 网卡编号 mtu 值 ssh xxx.xxx.xxx.xxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > xxx.xxx.xxx.xxx为安装MogDB环境的IP地址。 diff --git a/product/zh/docs-mogdb/v2.1/performance-tuning/1-system/4-configuring-smp.md b/product/zh/docs-mogdb/v2.1/performance-tuning/1-system/4-configuring-smp.md index 04e72743..553284ce 100644 --- a/product/zh/docs-mogdb/v2.1/performance-tuning/1-system/4-configuring-smp.md +++ b/product/zh/docs-mogdb/v2.1/performance-tuning/1-system/4-configuring-smp.md @@ -105,7 +105,7 @@ SMP架构是一种利用富余资源来换取时间的方案，计划并行之 mogdb=# SET query_dop = 1; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 资源许可的情况下，并行度越高，性能提升效果越好。 > - SMP并行度支持会话级设置，推荐客户在执行符合要求的查询前，打开smp，执行结束后，关闭smp。以免在业务峰值时，对业务造成冲击。 diff --git a/product/zh/docs-mogdb/v2.1/performance-tuning/2-sql/9-hint-based-tuning.md b/product/zh/docs-mogdb/v2.1/performance-tuning/2-sql/9-hint-based-tuning.md index 4f34de75..176498ad 100644 --- a/product/zh/docs-mogdb/v2.1/performance-tuning/2-sql/9-hint-based-tuning.md +++ b/product/zh/docs-mogdb/v2.1/performance-tuning/2-sql/9-hint-based-tuning.md @@ -635,7 +635,7 @@ set(param value) cost_weight_index, default_limit_rows, seq_page_cost, random_page_cost, cpu_tuple_cost, cpu_index_tuple_cost, cpu_operator_cost, effective_cache_size -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置不在白名单中的参数，参数取值不合法，或hint语法错误时，不会影响查询执行的正确性。使用explain(verbose on)执行可以看到hint解析错误的报错提示。 > - GUC参数的hint只在最外层查询生效——子查询内的GUC参数hint不生效。 @@ -662,7 +662,7 @@ set(param value) use_gplan ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于非PBE方式执行的SQL语句，设置本hint不会影响执行方式。 > - 本Hint的优先级仅高于基于代价的选择和plan_cache_mode参数，即plan_cache_mode无法强制选择执行方式的语句本hint也无法生效。 @@ -740,7 +740,7 @@ explain select * from t1 where t1.a in (select /*+ no_expand*/ t2.a from t2); no_gpc ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数仅在enable_global_plancache=on时对PBE执行的语句生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数仅在enable_global_plancache=on时对PBE执行的语句生效。 ### 示例 diff --git a/product/zh/docs-mogdb/v2.1/performance-tuning/wdr-snapshot-schema.md b/product/zh/docs-mogdb/v2.1/performance-tuning/wdr-snapshot-schema.md index 87e40cd1..6490b387 100644 --- a/product/zh/docs-mogdb/v2.1/performance-tuning/wdr-snapshot-schema.md +++ b/product/zh/docs-mogdb/v2.1/performance-tuning/wdr-snapshot-schema.md @@ -87,7 +87,7 @@ WDR Snasphot启动（即参数enable_wdr_snapshot）为on时， 且快照数量 select create_wdr_snapshot(); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 执行“cm_ctl query -Cdvi”，回显中“Central Coordinator State”下显示的信息即为CCN信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 执行“cm_ctl query -Cdvi”，回显中“Central Coordinator State”下显示的信息即为CCN信息。 4. 执行如下步骤生成性能报告。 diff --git a/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md b/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md index 15cc3397..92543243 100644 --- a/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md +++ b/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md @@ -37,7 +37,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 ```bash cat /mogdb/data/db1/postgresql.conf | grep port - + port = 26000 # (change requires restart) #comm_sctp_port = 1024 # Assigned by installation (change requires restart) #comm_control_port = 10001 # Assigned by installation (change requires restart) @@ -67,7 +67,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 3. 获取软件安装包中的"MogDB-x.x.x-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -106,7 +106,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -148,7 +148,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -159,7 +159,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -201,7 +201,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md b/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md index aa4c979a..4b0502f3 100644 --- a/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md +++ b/product/zh/docs-mogdb/v2.1/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md @@ -62,7 +62,7 @@ Data Studio还提供SQL助手用于在SQL终端和PL/SQLViewer中执行各种查 Java 1.8.0_181或更高版本。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > * 请参阅[https://java.com/en/download/help/path.xml](https://java.com/en/download/help/path.xml)以设置Java Home路径。 > * 保证最佳体验的情况下，推荐的最小屏幕分辨率是1080 x 768。低于此分辨率，界面会异常。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md index 04bdb9a0..cf6df42c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md @@ -57,7 +57,7 @@ date: 2021-06-07 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 - hll_hash_smallint(smallint, int32) @@ -724,7 +724,7 @@ hll主要存在三种模式Explicit、Sparse、Full。当数据规模比较小 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/14-sequence-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/14-sequence-functions.md index 7262605f..8939a108 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/14-sequence-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/14-sequence-functions.md @@ -13,10 +13,10 @@ date: 2021-04-20 描述：递增序列并返回新值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 为了避免从同一个序列获取值的并发事务被阻塞， nextval操作不会回滚；也就是说，一旦一个值已经被抓取， 那么就认为它已经被用过了，并且不会再被返回。 即使该操作处于事务中，当事务之后中断，或者如果调用查询结束不使用该值，也是如此。这种情况将在指定值的顺序中留下未使用的“空洞”。 因此，MogDB序列对象不能用于获得“无间隙”序列。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > nextval函数只能在主机上执行，备机不支持执行此函数。 返回类型：bigint @@ -119,9 +119,9 @@ date: 2021-04-20 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > Setval后当前会话会立刻生效，但如果其他会话有缓存的序列值，只能等到缓存值用尽才能感知Setval的作用。所以为了避免序列值冲突，setval要谨慎使用。 > 因为序列是非事务的，setval造成的改变不会由于事务的回滚而撤销。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > nextval函数只能在主机上执行，备机不支持执行此函数。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/18-window-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/18-window-functions.md index 15f65f01..7fd98e1e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/18-window-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/18-window-functions.md @@ -11,7 +11,7 @@ date: 2021-04-20 窗口函数与OVER语句一起使用。OVER语句用于对数据进行分组，并对组内元素进行排序。窗口函数用于给组内的值生成序号。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 窗口函数中的order by后面必须跟字段名，若order by后面跟数字，该数字会被按照常量处理，因此对目标列没有起到排序的作用。 - RANK() diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/19-security-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/19-security-functions.md index 5e9bb93b..55d05e2b 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/19-security-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/19-security-functions.md @@ -26,7 +26,7 @@ mogdb=# SELECT gs_encrypt_aes128('MPPDB','Asdf1234'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史。即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -46,7 +46,7 @@ mogdb=# SELECT gs_encrypt('MPPDB','Asdf1234','sm4'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史。即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -54,7 +54,7 @@ mogdb=# SELECT gs_encrypt('MPPDB','Asdf1234','sm4'); 描述：以keystr为密钥对decrypt字符串进行解密，返回解密后的字符串。解密使用的keystr必须保证与加密时使用的keystr一致才能正常解密。keystr不得为空。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 此参数需要结合gs_encrypt_aes128加密函数共同使用。 @@ -70,7 +70,7 @@ mogdb=# SELECT gs_decrypt_aes128('gwditQLQG8NhFw4OuoKhhQJoXojhFlYkjeG0aYdSCtLCnI (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史；即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -92,7 +92,7 @@ mogdb=# select gs_decrypt('ZBzOmaGA4Bb+coyucJ0B8AkIShqc','Asdf1234','sm4'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史；即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -212,7 +212,7 @@ mogdb=# SELECT inet_server_addr(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 上面是以客户端在10.10.0.50上，服务器端在10.10.0.13上为例。 > - 如果是通过本地连接，使用此接口显示为空。 @@ -233,7 +233,7 @@ mogdb=# SELECT inet_client_addr(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 上面是以客户端在10.10.0.50上，服务器端在10.10.0.13上为例。 > - 如果是通过本地连接，使用此接口显示为空。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/23-system-information-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/23-system-information-functions.md index 5b988a92..740c6d2a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/23-system-information-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/23-system-information-functions.md @@ -95,7 +95,7 @@ date: 2021-04-20 current_schemas(Boolean)返回搜索路径中所有模式名称的数组。布尔选项决定像pg_catalog这样隐含包含的系统模式是否包含在返回的搜索路径中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 搜索路径可以通过运行时设置更改。命令是： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 搜索路径可以通过运行时设置更改。命令是： > > ```sql > SET search_path TO schema [, schema, ...] @@ -222,7 +222,7 @@ date: 2021-04-20 描述：连接的远端地址。inet_client_addr返回当前客户端的IP地址。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：inet @@ -240,7 +240,7 @@ date: 2021-04-20 描述：连接的远端端口。inet_client_port返回当前客户端的端口号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：int @@ -258,7 +258,7 @@ date: 2021-04-20 描述：连接的本地地址。inet_server_addr返回服务器接收当前连接用的IP地址。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：inet @@ -276,7 +276,7 @@ date: 2021-04-20 描述：连接的本地端口。inet_server_port返回接收当前连接的端口号。如果是通过Unix-domain socket连接的，则所有这些函数都返回NULL。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：int @@ -626,7 +626,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 备注：has_any_column_privilege检查用户是否以特定方式访问表的任何列。其参数可能与has_table_privilege类似，除了访问权限类型必须是SELECT、INSERT、UPDATE、COMMENT或REFERENCES的一些组合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 拥有表的表级别权限则隐含的拥有该表每列的列级权限，因此如果与has_table_privilege参数相同，has_any_column_privilege总是返回true。但是如果授予至少一列的列级权限也返回成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 拥有表的表级别权限则隐含的拥有该表每列的列级权限，因此如果与has_table_privilege参数相同，has_any_column_privilege总是返回true。但是如果授予至少一列的列级权限也返回成功。 - has_column_privilege(user, table, column, privilege) @@ -651,7 +651,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 备注：has_column_privilege检查用户是否以特定方式访问一列。其参数类似于has_table_privilege，可以通过列名或属性号添加列。想要的访问权限类型必须是SELECT、INSERT、UPDATE、COMMENT或REFERENCES的一些组合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 拥有表的表级别权限则隐含的拥有该表每列的列级权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 拥有表的表级别权限则隐含的拥有该表每列的列级权限。 - has_cek_privilege(user, cek, privilege) diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md index 7f76eb8d..6be2088c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md @@ -131,7 +131,7 @@ date: 2021-04-20 | clean_type | text | 'BY_USERID'：按用户ID来进行清理Unique SQL。'BY_CNID'：按主节点的ID来进行清理Unique SQL。'ALL'：全部清理。 | | clean_value | int8 | 具体清理type对应的清理值。 | - > **须知：** + > **须知**: > > - scope的取值GLOBAL和LOCAL针对分布式，对于MogDB而言两者意义相同，均表示清理本节点。 > - clean_type的值BY_CNID仅针对分布式，对于MogDB无效。 @@ -440,7 +440,7 @@ date: 2021-04-20 返回值类型：Boolean - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见表6。 > - 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。 @@ -467,6 +467,6 @@ date: 2021-04-20 返回值类型：record - >**说明：** + >**说明**: > >- 此函数的查询仅在集中式环境开始部署用户态网络，且comm_proxy_attr参数中enable_dfx配置为true的条件下显示具体信息。其他场景报错不支持查询。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/25-statistics-information-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/25-statistics-information-functions.md index 10978bc9..1319ce60 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/25-statistics-information-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/25-statistics-information-functions.md @@ -967,7 +967,7 @@ date: 2021-04-20 返回值类型：boolean -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 此函数中所说节点指分布式节点，当前MogDB为集中式数据库，global与local功能一致，取值范围不支持BY_CNID。 @@ -1031,7 +1031,7 @@ date: 2021-04-20 返回值类型：record -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 @@ -1718,7 +1718,7 @@ date: 2021-04-20 描述：统计Session级别的内存使用情况，包含执行作业在数据节点上Postgres线程和Stream线程分配的所有内存。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 若GUC参数enable_memory_limit=off，该函数不能使用。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/28-ai-feature-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/28-ai-feature-functions.md index ac88e818..8f337390 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/28-ai-feature-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/28-ai-feature-functions.md @@ -85,7 +85,7 @@ date: 2021-04-20 返回值类型：text。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数为内部功能调用函数，不建议用户直接使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数为内部功能调用函数，不建议用户直接使用。 - model_train_opt(template text, model text) diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md index 73f3748b..a9664305 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md @@ -7,7 +7,7 @@ date: 2021-10-28 # 动态数据脱敏函数 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 该函数为内部功能调用函数，详见“数据库安全-动态数据脱敏机制”章节。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md index 5a0ddfe2..0cdf7d4e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md @@ -121,7 +121,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 如果是查询bytea类型的长度，指定utf8编码时，最大长度只能为536870888。 @@ -474,7 +474,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果POSIX正则表达式模式包含任何圆括号，那么将返回匹配第一对子表达式（对应第一个左圆括号的) 的文本。如果你想在表达式里使用圆括号而又不想导致这个例外，那么你可以在整个表达式外边放上一对圆括号。 - substring(string from *pattern* for *escape*) @@ -547,7 +547,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 flags参数为可选参数，包含零个或多个改变函数行为的单字母标记。i表示进行大小写无关的匹配，g表示替换每一个匹配的子字符串而不仅仅是第一个。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果提供了最后一个参数，但参数值是空字符串（")，且数据库SQL兼容模式设置为A的情况下，会导致返回结果为空集。这是因为A兼容模式将"作为NULL处理，避免此类行为的方式有如下几种： > > - 将数据库SQL兼容模式改为C； @@ -627,7 +627,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 由于数据库内存分配机制限制单次内存分配不可超过1GB，因此number最大值不应超过(1G-x)/lengthb(string) - 1。x为头信息长度，通常大于4字节，其具体值在不同的场景下存在差异。 - replace(string text, from text, to text) @@ -1228,7 +1228,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：将字符串str1和str2连接并返回。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**数据库SQL兼容模式设置为MY的情况下，参数str1或str2为NULL会导致返回结果为NULL。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:数据库SQL兼容模式设置为MY的情况下，参数str1或str2为NULL会导致返回结果为NULL。 返回值类型：varchar @@ -1308,7 +1308,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：以第一个参数为分隔符，链接第二个以后的所有参数。NULL参数被忽略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果第一个参数值是NULL，会导致返回结果为NULL。 > - 如果第一个参数值是空字符串（"），且数据库SQL兼容模式设置为A的情况下，会导致返回结果为NULL。这是因为A兼容模式>将"作为NULL处理，避免此类行为，可以将数据库SQL兼容模式改为B、C或者PG。 @@ -1341,7 +1341,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果源编码格式到目标编码格式的转化规则不存在，则字符串不进行任何转换直接返回，如GBK和LATIN1之间的转换规则是不存在的，具体转换规则可以通过查看系统表pg_conversion获得。 > 示例： > @@ -1499,7 +1499,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：将string使用MD5加密，并以16进制数作为返回值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MD5加密算法安全性低，存在安全风险，不建议使用。 返回值类型：text @@ -1594,7 +1594,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若字符串中存在换行符，如字符串由一个换行符和一个空格组成，在MogDB中LENGTH和LENGTHB的值为2。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md index de6a6c9a..e1a59ddd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md @@ -25,7 +25,7 @@ date: 2021-04-20 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 单字段内部连续连接操作不建议超过180次。如果超过180次，需拆分为多个连续连接的字符串，在它们之间再执行连接操作。 > 例如：str1||str2||str3||str4 拆分为 (str1||str2)||(str3||str4)。 @@ -151,5 +151,5 @@ mogdb=# select substring('10101111'::bit(8), 2); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 只是转换为“bit”的意思是转换成bit(1)，因此只会转换成整数的最低位。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/6-mode-matching-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/6-mode-matching-operators.md index 4c19d859..a02f72ea 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/6-mode-matching-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/6-mode-matching-operators.md @@ -23,7 +23,7 @@ date: 2021-04-20 4. 要匹配逃逸字符本身，写两个逃逸字符。例如要写一个包含反斜线的模式常量，那你就要在SQL语句里写两个反斜线。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > 参数standard_conforming_strings设置为off时，在文串常量中写的任何反斜线都需要被双写。因此，写一个匹配单个反斜线的模式实际上要在语句里写四个反斜线（你可以通过用ESCAPE选择一个不同的逃逸字符来避免这种情况，这样反斜线就不再是LIKE的特殊字符了。但仍然是字符文本分析器的特殊字符，所以你还是需要两个反斜线)。 > > 在兼容MYSQL数据模式时，您也可以通过写ESCAPE ''的方式不选择逃逸字符，这样可以有效地禁用逃逸机制，但是没有办法关闭下划线和百分号在模式中的特殊含义。 @@ -160,7 +160,7 @@ date: 2021-04-20 - [regexp_split_to_array(string text, pattern text [, flags text ])](3-character-processing-functions-and-operators)和regexp_split_to_table类似，是一个正则表达式分离函数，不过它的结果以一个text数组的形式返回。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 正则表达式分离函数会忽略零长度的匹配，这种匹配发生在串的开头或结尾或者正好发生在前一个匹配之后。这和正则表达式匹配的严格定义是相悖的，后者由regexp_matches实现，但是通常前者是实际中最常用的行为。 示例： diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md index 7db33232..4740fc36 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md @@ -784,7 +784,7 @@ date: 2021-04-20 返回值类型：character varying - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 获取当前时间有多种方式，请根据实际业务从场景选择合适的接口： > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md index cab9bdbf..3b09c8c5 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 有效值为stderr、csvlog、syslog。 @@ -40,7 +40,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 将服务器日志发送到stderr时可以不使用logging_collector参数，此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难，只适用于较小的日志容量。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启日志收集功能。 - off表示关闭日志收集功能。 @@ -64,7 +64,7 @@ date: 2021-04-20 > - 合法路径: 用户对此路径有读写权限 > - 非法路径: 用户对此路径无读写权限 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 安装时指定。 @@ -79,7 +79,7 @@ date: 2021-04-20 > - 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 > - 当log_destination设为csvlog时，系统会生成附加了时间戳的日志文件名，文件格式为csv格式，例如"server_log.1093827753.csv"。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: postgresql-%Y-%m-%d_%H%M%S.log @@ -94,7 +94,7 @@ date: 2021-04-20 > - 使用此选项前请设置log_directory，将日志存储到数据目录之外的地方。 > - 因日志文件可能含有敏感数据，故不能将其设为对外可读。 -**取值范围:**整型，0000～0777（8进制计数，转化为十进制 0 ~ 511）。 +**取值范围**: 整型，0000～0777（8进制计数，转化为十进制 0 ~ 511）。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -113,7 +113,7 @@ date: 2021-04-20 假设日志需要保留7天，每天生成一个日志文件，日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。设置方法: 将log_filename设置为server_log.%a ，log_truncate_on_rotation设置为on，log_rotation_age设置为1440，即日志有效时间为1天。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on表示MogDB以覆盖写入的方式写服务器日志消息。 - off表示MogDB将日志消息附加到同名的现有日志文件上。 @@ -126,7 +126,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 +**取值范围**: 整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 **默认值**: 1440(min) @@ -136,7 +136,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX / 1024，单位为kB。 +**取值范围**: 整型，0 ~ INT_MAX / 1024，单位为kB。 0表示关闭基于容量的新日志文件的创建。 @@ -150,7 +150,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 +**取值范围**: 枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 **默认值**: local0 @@ -160,7 +160,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: postgres @@ -170,6 +170,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: PostgreSQL diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md index 6d627746..53263005 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md @@ -16,7 +16,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当client_min_messages和[log_min_messages](#log_min_messages)取相同值时，其值所代表的级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 **默认值**: notice @@ -29,7 +29,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当[client_min_messages](#client_min_messages)和log_min_messages取相同值log时所代表的消息级别不同。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 **默认值**: warning @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -59,7 +59,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 当此选项与log_statement同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用log_line_prefix记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。 -**取值范围:**整型，-1 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，-1 ~ INT_MAX，单位为毫秒。 - 设置为250，所有运行时间不短于250ms的SQL语句都会被记录。 - 设置为0，输出所有语句的持续时间。 @@ -76,7 +76,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表**信息严重程度分类**。 @@ -106,7 +106,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 该参数以毫秒为单位的，建议在使用过程中设置值为1000的整数倍，即设置值以秒为最小单位。该参数所控制的性能日志文件以prf为扩展名，文件放置在$GAUSSLOG/gs_profile/目录下面，其中node_name是由postgres.conf文件中的pgxc_node_name的值，不建议外部使用该参数。 -**取值范围:**0~2147483647，单位为毫秒（ms）。 +**取值范围**: 0~2147483647，单位为毫秒（ms）。 当设置为0时，当前会话不再输出性能日志数据。当设置为非0时，当前会话按照指定的时间周期进行输出性能日志数据。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md index b83bc75b..e50edb7a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 @@ -58,7 +58,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示进行缩进。 - off表示不进行缩进。 @@ -71,7 +71,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量。 - off表示关闭此参数时，服务器日志消息包含不涉及检查点和重启点的统计量。 @@ -87,7 +87,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 有些客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中重复的"connection receive"（收到连接请求）并不意味着一定是问题。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 @@ -100,7 +100,7 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 @@ -113,7 +113,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - 设置为off，该选项与log_min_duration_statement的不同之处在于log_min_duration_statement强制记录查询文本。 - 设置为on并且log_min_duration_statement大于零，记录所有持续时间，但是仅记录超过阈值的语句。这可用于在高负载情况下搜集统计信息。 @@ -126,7 +126,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - terse输出不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose输出包括SQLSTATE错误代码、源代码文件名、函数名及产生错误所在的行号。 @@ -140,7 +140,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以同时记录主机名。 - off表示不可以同时记录主机名。 @@ -189,7 +189,7 @@ FROM pg_stat_activity; - 当log_line_prefix设置为非空值时，请将其最后一个字符作为一个独立的段，以此来直观地与后续的日志进行区分，也可以使用一个标点符号。 - Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: %m %c %d %p %a %x %n %e @@ -203,7 +203,7 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示记录此信息。 - off表示不记录此信息。 @@ -220,7 +220,7 @@ FROM pg_stat_activity; 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，在执行阶段之前（语法分析或规划阶段）同样不会记录。将log_min_error_statement设为ERROR或更低才能记录这些语句。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - none表示不记录语句。 - ddl表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 @@ -235,7 +235,7 @@ FROM pg_stat_activity; 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为-1，最大值2147483647，单位KB。 +**取值范围**: 整型，最小值为-1，最大值2147483647，单位KB。 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 值0 表示记录所有的临时文件的删除信息。 @@ -249,7 +249,7 @@ FROM pg_stat_activity; 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: PRC @@ -263,7 +263,7 @@ gs_initdb进行相应系统环境设置时会对默认值进行修改。 该参数属于USERSET类型参数，设置请参考表[GUC参数分类](30-appendix)中对应设置的方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 所有模块日志在服务端是不输出的，可由SHOW logging_module查看 @@ -323,7 +323,7 @@ ALL,on(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,VEC_E 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - off表示不打开该功能。 - log表示打开该功能，可以在数据库节点的执行计划中看到没有查询优化的具体原因。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/11-alarm-detection.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/11-alarm-detection.md index 7a97fa12..558c4965 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/11-alarm-detection.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/11-alarm-detection.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许打开告警检测线程。 - off表示不允许打开告警检测线程。 @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0~1.0 +**取值范围**: 浮点型，0.0~1.0 **默认值**: 0.9 @@ -38,7 +38,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为秒。 +**取值范围**: 整型，单位为秒。 **默认值**: 10 @@ -48,26 +48,26 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: /opt/huawei/snas/bin/snas_cm_cmd ## table_skewness_warning_threshold -**参数说明**：设置用于表倾斜告警的阈值。 +**参数说明**: 设置用于表倾斜告警的阈值。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～1 +**取值范围**: 浮点型，0～1 -**默认值**：1 +**默认值**: 1 ## table_skewness_warning_rows -**参数说明**：设置用于表倾斜告警的行数。 +**参数说明**: 设置用于表倾斜告警的行数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：100000 +**默认值**: 100000 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md index 8eb2c847..b33d6ecc 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 - off表示关闭收集功能。 @@ -62,7 +62,7 @@ date: 2021-04-20 > > 当SQL语言函数设置为调用查询的"内联"函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - pl表示只追踪过程语言函数。 - all表示追踪SQL语言函数。 @@ -76,7 +76,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～102400 +**取值范围**: 整型，100～102400 **默认值**: 1024 @@ -90,7 +90,7 @@ date: 2021-04-20 > > 将其设置为一个基于RAM的文件系统目录会减少实际的I/O开销并可以提升其性能。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: pg_stat_tmp @@ -100,7 +100,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0～1天，单位为min。 +**取值范围**: 0～1天，单位为min。 **默认值**: 30min @@ -110,7 +110,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许收集相关操作对表数据改动的时间。 - off表示禁止收集相关操作对表数据改动的时间。 @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启计数功能。 - off表示关闭计数功能。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md index 69ad2352..a8b5a8a8 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md @@ -27,7 +27,7 @@ date: 2021-04-20 > - log_statement_stats记录总的语句统计数据，而其他的只记录针对每个模块的统计数据。 > - log_statement_stats不能和其他任何针对每个模块统计的选项一起打开。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启记录性能统计数据的功能。 - off表示关闭记录性能统计数据的功能。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/13-load-management.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/13-load-management.md index 08282f5d..c53f8289 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/13-load-management.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/13-load-management.md @@ -15,13 +15,13 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开资源管理。 - off表示关闭资源管理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当使用表[GUC参数设置方式](30-appendix)中的方式二来修改参数值时，新参数值只能对更改操作执行后启动的线程生效。此外，对于后台线程以及线程复用执行的新作业，该参数值的改动不会生效。如果希望这类线程即时识别参数变化，可以使用kill session或重启节点的方式来实现。 > - use_workload_manager参数由off变为on状态后，不会统计off时的存储资源。如果需要统计off时用户使用的存储资源，请在数据库中执行以下命令： @@ -44,7 +44,7 @@ date: 2021-04-20 建议尽量不要混合使用cgroup_name和session_respool。 -**取值范围**： 字符串 +**取值范围**: 字符串 **默认值**: InvalidGroup @@ -56,7 +56,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，1~INT_MAX， 单位为秒。 +**取值范围**: 整型，1~INT_MAX， 单位为秒。 **默认值**: 30 @@ -66,7 +66,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： +**取值范围**: - none，不启动内存统计功能。 - peak：表示统计query级内存peak值，此数值计入数据库日志，也可以由explain analyze输出。 @@ -82,11 +82,11 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 **默认值**: 空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 该参数不允许用户进行设置，建议保持默认值。 @@ -96,7 +96,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开资源监控。 - off表示关闭资源监控。 @@ -109,7 +109,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启资源监控记录归档功能。 - off表示关闭资源监控记录归档功能。 @@ -122,7 +122,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启资源监控逻辑IO统计功能。 - off表示关闭资源监控逻辑IO统计功能。 @@ -131,31 +131,31 @@ date: 2021-04-20 ## enable_user_metric_persistent -**参数说明**：设置是否开启用户历史资源监控转存功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中数据，会定期采样保存到GS_WLM_USER_RESOURCE_HISTORY系统表中。 +**参数说明**: 设置是否开启用户历史资源监控转存功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中数据，会定期采样保存到GS_WLM_USER_RESOURCE_HISTORY系统表中。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 ● on表示开启用户历史资源监控转存功能。 ● off表示关闭用户历史资源监控转存功能。 -**默认值**： on +**默认值**: on ## user_metric_retention_time -**参数说明**：设置用户历史资源监控数据的保存天数。该参数仅在 enable_user_metric_persistent为on时有效。 +**参数说明**: 设置用户历史资源监控数据的保存天数。该参数仅在 enable_user_metric_persistent为on时有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中的方法一和方法二进行设置。 -**取值范围**： 整型，0～730，单位为天。 +**取值范围**: 整型，0～730，单位为天。 ● 值等于0时，用户历史资源监控数据将永久保存。 ● 值大于0时，用户历史资源监控数据将保存对应天数。 -**默认值**： 7 +**默认值**: 7 ## enable_instance_metric_persistent @@ -163,7 +163,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启实例资源监控转存功能。 - off表示关闭实例资源监控转存功能。 @@ -176,7 +176,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中的方法一和方法二进行设置。 -**取值范围**： 整型，0～3650，单位为天。 +**取值范围**: 整型，0～3650，单位为天。 - 值等于0时，实例历史资源监控数据将永久保存。 - 值大于0时，实例历史资源监控数据将保存对应设置天数。 @@ -189,7 +189,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 枚举型 +**取值范围**: 枚举型 - none，不开启资源监控功能。 - query，开启query级别资源监控功能。 @@ -203,7 +203,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，-1～INT_MAX +**取值范围**: 整型，-1～INT_MAX - 值为-1时，不进行资源监控。 - 值大于或等于0时，值大于或等于0且小于等于9时，对执行代价大于等于10的语句进行资源监控。 @@ -217,7 +217,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，0～INT_MAX，单位为秒。 +**取值范围**: 整型，0～INT_MAX，单位为秒。 - 值为0时，资源监控实时视图中记录的所有语句都进行历史信息归档。 - 值大于0时，资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。 @@ -230,7 +230,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，且只对当前会话有效。请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示禁止内存保护功能。 - off表示启动内存保护功能。 @@ -243,27 +243,27 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 **默认值**: 空 ## memory_fault_percent -**参数说明**：内存故障测试时内存申请失败的比例，仅用在DEBUG版本。 +**参数说明**: 内存故障测试时内存申请失败的比例，仅用在DEBUG版本。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～2147483647 +**取值范围**: 整型，0～2147483647 -**默认值**：0 +**默认值**: 0 ## enable_bbox_dump -**参数说明**： 是否开启黑匣子功能，在系统不配置core机制的时候仍可产生core文件。 +**参数说明**: 是否开启黑匣子功能，在系统不配置core机制的时候仍可产生core文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开黑匣子功能。 - off表示关闭黑匣子功能。 @@ -276,11 +276,11 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，1～20 +**取值范围**: 整型，1～20 **默认值**: 8 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 在并发产生core文件时，core文件的产生个数可能大于bbox_dump_count。 @@ -290,17 +290,17 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 **默认值**: 空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 ## enable_ffic_log -**参数说明**： 是否开启FFIC（First Failure Info Capture）功能。 +**参数说明**: 是否开启FFIC（First Failure Info Capture）功能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开FFIC功能。 - off表示关闭FFIC功能。 @@ -309,21 +309,21 @@ date: 2021-04-20 ## io_limits -**参数说明**： 每秒触发IO的上限。 +**参数说明**: 每秒触发IO的上限。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置的方法进行设置。 -**取值范围**： 整型，0～1073741823 +**取值范围**: 整型，0～1073741823 **默认值**: 0 ## io_priority -**参数说明**： IO利用率高达50%时，重消耗IO作业进行IO资源管控时关联的优先级等级。 +**参数说明**: IO利用率高达50%时，重消耗IO作业进行IO资源管控时关联的优先级等级。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置的方法进行设置。 -**取值范围**： 枚举型 +**取值范围**: 枚举型 - None：表示不受控。 - Low：表示限制iops为该作业原始触发数值的10%。 @@ -334,19 +334,19 @@ date: 2021-04-20 ## io_control_unit -**参数说明**： 行存场景下，io管控时用来对io次数进行计数的单位。 +**参数说明**: 行存场景下，io管控时用来对io次数进行计数的单位。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置方法进行设置。 记多少次io触发为一计数单位，通过此计数单位所记录的次数进行io管控。 -**取值范围**： 整型，1000~1000000 +**取值范围**: 整型，1000~1000000 **默认值**: 6000 ## session_respool -**参数说明**： 当前的session关联的resource pool。 +**参数说明**: 当前的session关联的resource pool。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置方法进行设置。 @@ -356,23 +356,23 @@ date: 2021-04-20 建议尽量不要混合使用cgroup_name和session_respool。 -**取值范围**： string类型，通过create resource pool所设置的资源池。 +**取值范围**: string类型，通过create resource pool所设置的资源池。 **默认值**: invalid_pool ## session_statistics_memory -**参数说明**： 设置实时查询视图的内存大小。 +**参数说明**: 设置实时查询视图的内存大小。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 +**取值范围**: 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 **默认值**: 5MB ## topsql_retention_time -**参数说明**： 设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。 +**参数说明**: 设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -385,21 +385,21 @@ date: 2021-04-20 ## session_history_memory -**参数说明**： 设置历史查询视图的内存大小。 +**参数说明**: 设置历史查询视图的内存大小。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，10 * 1024～max_process_memory的50%，单位KB。 +**取值范围**: 整型，10 * 1024～max_process_memory的50%，单位KB。 **默认值**: 10MB ## transaction_pending_time -**参数说明**： 事务块语句和存储过程语句排队的最大时间。 +**参数说明**: 事务块语句和存储过程语句排队的最大时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，-1～INT_MAX/2，单位为秒。 +**取值范围**: 整型，-1～INT_MAX/2，单位为秒。 - 值为-1或0： 事务块语句和存储过程语句无超时判断，排队至资源满足可执行条件。 - 值大于0： 事务块语句和存储过程语句排队超过所设数值的时间后，无视当前资源情况强制执行。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/14-automatic-vacuuming.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/14-automatic-vacuuming.md index 4f2fa9c2..c9bc355a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/14-automatic-vacuuming.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/14-automatic-vacuuming.md @@ -24,7 +24,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理线程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启数据库自动清理线程。 - off表示关闭数据库自动清理线程。 @@ -37,7 +37,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - analyze表示只做autoanalyze。 - vacuum表示只做autovacuum。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**int类型，单位是s，0~2147483。 +**取值范围**: int类型，单位是s，0~2147483。 **默认值**: 5min（即300s） @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 +**取值范围**: 整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 **默认值**: -1 @@ -76,7 +76,7 @@ date: 2021-04-20 将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。 -**取值范围:**整型，最小值为-1，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为-1，最大值为2147483647，单位为毫秒。 - 当参数设置为0时，表示所有的自动清理操作都记录到日志中。 - 当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。 @@ -90,7 +90,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 +**取值范围**: 整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为"262143 - max_connections - job_queue_processes - 辅助线程数 - autovacuum的lancher线程数 - 1"，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 **默认值**: 3 @@ -100,7 +100,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，单位为s，最小值为1，最大值为2147483。 +**取值范围**: 整型，单位为s，最小值为1，最大值为2147483。 **默认值**: 10min（即600s） @@ -110,7 +110,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 **默认值**: 50 @@ -120,7 +120,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 **默认值**: 50 @@ -130,7 +130,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 **默认值**: 0.2 @@ -140,7 +140,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 **默认值**: 0.1 @@ -163,7 +163,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 +**取值范围**: 整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 **默认值**: 20ms @@ -173,7 +173,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 +**取值范围**: 整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 **默认值**: -1 @@ -181,6 +181,6 @@ date: 2021-04-20 **参数说明**: 用来指定本地回收时间间隔，单位为毫秒（ms）。 -**取值范围:**整型，0~INT_MAX。 +**取值范围**: 整型，0~INT_MAX。 **默认值**: 5s（即5000ms） diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md index 1ba03642..5c187c69 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md @@ -20,7 +20,7 @@ date: 2021-04-20 - 当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。 - 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: `"$user",public` @@ -58,7 +58,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，其中空表示使用默认表空间。 +**取值范围**: 字符串，其中空表示使用默认表空间。 **默认值**: 空 @@ -71,7 +71,7 @@ date: 2021-04-20 - 值为"installation"表示建表会默认建在安装的Node Group上。 - 值为其他字符串表示建表会默认建在设置的Node Group上。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: installation @@ -83,7 +83,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 +**取值范围**: 字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 **默认值**: 空 @@ -93,7 +93,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 - off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 @@ -106,7 +106,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - read committed表示事务读已提交。 - repeatable read表示事务可重复读。 @@ -120,7 +120,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示只读状态。 - off表示非只读状态。 @@ -135,7 +135,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示默认延迟。 - off表示默认不延迟。 @@ -151,7 +151,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 设置此参数会丢弃之前任何缓存的执行计划。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - origin表示从当前会话中复制插入、删除、更新等操作。 - replica表示从其他地方复制插入、删除、更新等操作到当前会话。 @@ -165,7 +165,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为0，最大值为2147483647，单位为毫秒。 **默认值**: 0 @@ -175,7 +175,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为0到10亿之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 @@ -188,7 +188,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 尽管随时可以将此参数设为零到20亿之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。 @@ -201,7 +201,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - hex: 将二进制数据编码为每字节2位十六进制数字。 - escape: 传统化的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法，同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 @@ -214,7 +214,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - base64 - hex @@ -227,7 +227,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - document: 表示HTML格式的文档。 - content: 普通的字符串。 @@ -240,7 +240,7 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，取值必须大于等于1。 +**取值范围**: 整型，取值必须大于等于1。 **默认值**: 1000 @@ -250,6 +250,6 @@ MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为64，最大值为INT_MAX，单位为KB。 +**取值范围**: 整型，最小值为64，最大值为INT_MAX，单位为KB。 **默认值**: 4MB diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md index 6c2b5dc0..6140cf33 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md @@ -17,7 +17,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请**参考表GUC参数设置方式**中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: ISO，MDY @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - sql_standard表示产生与SQL标准规定匹配的输出。 - postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当[DateStyle](#DateStyle)参数被设为ISO时。 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 **默认值**: PRC @@ -64,7 +64,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，可查询视图pg_timezone_names获得。 +**取值范围**: 字符串，可查询视图pg_timezone_names获得。 **默认值**: Default @@ -77,7 +77,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，-15～3 +**取值范围**: 整型，-15～3 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -94,7 +94,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 +**取值范围**: 兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -116,7 +116,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -131,7 +131,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -146,7 +146,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -161,7 +161,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -182,7 +182,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > MogDB支持pg_catalog.english，pg_catalog.simple两种配置。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md index e5abb7a1..eff4cdc1 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md @@ -34,7 +34,7 @@ dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir' 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~2147483647 +**取值范围**: 整型，0~2147483647 **默认值**: 0 @@ -49,6 +49,6 @@ dynamic_library_path = '/usr/local/lib/gaussdb:/opt/testgs/lib:$libdir' 该参数属于BACKEND类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/16-lock-management.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/16-lock-management.md index 5c21e89e..985df815 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/16-lock-management.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/16-lock-management.md @@ -123,13 +123,13 @@ date: 2021-04-20 ## xloginsert_locks -**参数说明**：控制用于并发写预写式日志锁的个数。主要用于提高写预写式日志的效率。 +**参数说明**: 控制用于并发写预写式日志锁的个数。主要用于提高写预写式日志的效率。 该参数属于POSTMASTER类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，最小值1，最大值1000 +**取值范围**: 整型，最小值1，最大值1000 -**默认值**：8 +**默认值**: 8 ## num_internal_lock_partitions diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md index bbb33521..9bcd74fb 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md @@ -15,7 +15,7 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许向数组中输入空元素。 - off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。 @@ -31,7 +31,7 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'…'）。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - on表示一直允许使用\'表示。 - off表示拒绝使用\'表示。 @@ -48,7 +48,7 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 **默认值**: on @@ -58,7 +58,7 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。 @@ -70,7 +70,7 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开强制引用。 - off表示关闭强制引用。 @@ -83,7 +83,7 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以访问子表。 - off表示不访问子表。 @@ -99,7 +99,7 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 @@ -112,7 +112,7 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示扫描可能从表的中间开始，然后选择"环绕"方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 - off表示确保顺序扫描是从表头开始的。 @@ -125,7 +125,7 @@ on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 - off表示禁止使用这些特性。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md index 4c192bdb..8d676867 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## convert_string_to_digit -**参数说明**：设置隐式转换优先级，是否优先将字符串转为数字。 +**参数说明**: 设置隐式转换优先级，是否优先将字符串转为数字。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -20,29 +20,29 @@ date: 2021-04-20 - on表示优先将字符串转为数字。 - off表示不优先将字符串转为数字。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎操作。 ## nls_timestamp_format -**参数说明**：设置时间戳默认格式。 +**参数说明**: 设置时间戳默认格式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：DD-Mon-YYYY HH:MI:SS.FF AM +**默认值**: DD-Mon-YYYY HH:MI:SS.FF AM ## max_function_args -**参数说明**：函数参数最大个数。 +**参数说明**: 函数参数最大个数。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型 +**取值范围**: 整型 -**默认值**：8192 +**默认值**: 8192 ## transform_null_equals @@ -60,7 +60,7 @@ date: 2021-04-20 **默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 ## support_extended_features @@ -88,7 +88,7 @@ date: 2021-04-20 **默认值**: A -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 该参数只能在执行**CREATE DATABASE**命令创建数据库的时候设置。 > - 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。 @@ -103,7 +103,7 @@ date: 2021-04-20 **默认值**: 空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前只支持[表1](#jianrongxing)。 > - 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set behavior_compat_options='end_month_calculate,display_leading_zero'; @@ -127,23 +127,23 @@ date: 2021-04-20 ## plpgsql.variable_conflict -**参数说明**：设置同名的存储过程变量和表的列的使用优先级。 +**参数说明**: 设置同名的存储过程变量和表的列的使用优先级。 该参数属于USERSET类型参数，仅支持表[GUC参数设置方式](30-appendix)中对应设置方法3进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - error表示遇到存储过程变量和表的列名同名则编译报错。 - use_variable表示存储过程变量和表的列名同名则优先使用变量。 - use_column表示存储过程变量和表的列名同名则优先使用列名。 -**默认值**：error +**默认值**: error ## td_compatible_truncation **参数说明**: 控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 超长字符串自动截断功能不适用于insert语句包含外表的场景。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/18-fault-tolerance.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/18-fault-tolerance.md index 3b529c83..1b70dba1 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/18-fault-tolerance.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/18-fault-tolerance.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示ERROR级别报错会升级为PANIC报错。 - off表示不会对ERROR级别报错进行升级。 @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示能够最大限度地提高数据库的可用性。 @@ -44,7 +44,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示有转换错误的字符将被忽略，以"?"代替，打印错误信息到日志中。 - off表示有转换错误的字符不能被转换，打印错误信息到终端。 @@ -57,7 +57,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~20。 +**取值范围**: 整型，0~20。 **默认值**: 0 @@ -67,7 +67,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~128， 单位为KB。 +**取值范围**: 整型，8~128， 单位为KB。 **默认值**: 8KB @@ -77,7 +77,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。 +**取值范围**: 字符串。 **默认值**: YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 @@ -87,7 +87,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 - off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 @@ -96,14 +96,14 @@ date: 2021-04-20 ## remote_read_mode -**参数说明**：远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 +**参数说明**: 远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - off表示关闭远程读功能。 - non_authentication表示开启远程读功能，但不进行证书认证。 - authentication表示开启远程读功能，但要进行证书认证。 -**默认值**：authentication +**默认值**: authentication diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/2-file-location.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/2-file-location.md index d9b660ca..07bfdbe8 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/2-file-location.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/2-file-location.md @@ -21,7 +21,7 @@ date: 2021-04-20 - 在安装MogDB时指定。 - 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 **默认值**: 安装时指定，如果在安装时不指定，则默认不初始化数据库。 @@ -31,7 +31,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置，不支持使用表[GUC参数设置方式](30-appendix)中的方式四进行修改。 -**取值范围:**字符串，长度大于0 +**取值范围**: 字符串，长度大于0 **默认值**: postgresql.conf（实际安装可能带有绝对目录） @@ -41,7 +41,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: pg_hba.conf（实际安装可能带有绝对目录） @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: pg_ident.conf（实际安装可能带有绝对目录） @@ -64,6 +64,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 这个参数只能在数据库服务重新启动后生效。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/20-MogDB-transaction.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/20-MogDB-transaction.md index 972ebf0d..104f7a03 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/20-MogDB-transaction.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/20-MogDB-transaction.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，只识别以下字符串，大小写空格敏感: +**取值范围**: 字符串，只识别以下字符串，大小写空格敏感: - serializable: MogDB中等价于REPEATABLE READ。 - read committed: 只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示设置当前事务为只读事务。 - off表示该事务可以是非只读事务。 @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，仅支持表[GUC参数分类](30-appendix)中的方式三进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -75,7 +75,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许执行。 - off表示不允许执行。 @@ -88,7 +88,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示表中元组的所有版本都会可见。 - off/false表示表中元组的所有版本都不可见。 @@ -103,7 +103,7 @@ date: 2021-04-20 该参数用户不能自己去设置参数值。 -**取值范围:**0~2 +**取值范围**: 0~2 - 2 表示单主机模式，此模式无法扩展备机。 - 1 表示使用一主多备模式，全场景覆盖，推荐使用。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/21-developer-options.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/21-developer-options.md index a9b146af..b6b4bf1b 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/21-developer-options.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/21-developer-options.md @@ -15,7 +15,7 @@ date: 2021-04-20 不建议修改该参数默认值，如果设置为on，可能导致系统表损坏，甚至数据库无法启动。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许修改系统表的结构。 - off表示不允许修改系统表的结构。 @@ -28,7 +28,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开断言检查。 - off表示不打开断言检查。 @@ -45,7 +45,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略数据校验错误。 - off表示数据校验错误正常报错。 @@ -62,7 +62,7 @@ date: 2021-04-20 > > 这个参数在从系统索引被破坏的表中恢复数据的时候非常有用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示忽略系统索引。 - off表示不忽略系统索引。 @@ -75,7 +75,7 @@ date: 2021-04-20 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147，单位为秒。 +**取值范围**: 整型，最小值为0，最大值为2147，单位为秒。 **默认值**: 0 @@ -85,7 +85,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0～60，单位为秒。 +**取值范围**: 整型，最小值为0～60，单位为秒。 **默认值**: 0 @@ -95,7 +95,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开输出功能。 - off表示关闭输出功能。 @@ -108,7 +108,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 +**取值范围**: 枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见log_min_messages。 **默认值**: log @@ -123,7 +123,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 @@ -136,7 +136,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 @@ -168,7 +168,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启Numeric优化。 - off/false表示关闭Numeric优化。 @@ -181,7 +181,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启下盘优化。 - off/false表示关闭下盘优化。 @@ -194,7 +194,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 - summary: 显示简略的诊断信息。 - detail: 显示详细的诊断信息。 @@ -240,7 +240,7 @@ date: 2021-04-20 - none: 表示不启用本特性。 - all: 表示将部分共享数据和线程分布到不同的NUMA节点下，减少远端访存次数，提高性能。目前仅适用于拥有多个NUMA节点的ARM服务器，并且要求全部NUMA节点都可用于数据库进程，不支持仅选择一部分NUMA节点。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前版本x86平台下不支持numa_distribute_mode设置为all。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前版本x86平台下不支持numa_distribute_mode设置为all。 **默认值**: 'none' @@ -278,11 +278,11 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示计算方式相同，不需要进行重分布。 - off表示计算方式不同，需要进行重分布。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算方式的不同主要体现在字符串计算hash值时传入的字节长度上。（如果为char，则会忽略字符串后面空格的长度，如果为text或varchar，则会保留字符串后面空格的长度。）hash值的计算会影响到查询的计算结果，因此此参数一旦设置后，在整个数据库使用过程中不能再对其进行修改，以避免查询错误。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算方式的不同主要体现在字符串计算hash值时传入的字节长度上。（如果为char，则会忽略字符串后面空格的长度，如果为text或varchar，则会保留字符串后面空格的长度。）hash值的计算会影响到查询的计算结果，因此此参数一旦设置后，在整个数据库使用过程中不能再对其进行修改，以避免查询错误。 **默认值**: off diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md index e47124e5..5e3455ed 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/1-audit-switch.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启动审计功能。 - off表示关闭审计功能。 @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 @@ -36,7 +36,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: binary @@ -72,7 +72,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示采用空间优先策略，最多存储[audit_space_limit](#audit_space_limit)大小的日志。 - off表示采用时间优先策略，最少存储[audit_file_remain_time](#audit_file_remain_time)长度时间的日志。 @@ -95,7 +95,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024KB~1024GB，单位为KB。 +**取值范围**: 整型，1024KB~1024GB，单位为KB。 **默认值**: 1GB @@ -105,7 +105,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~1048576 +**取值范围**: 整型，1~1048576 **默认值**: 1048576 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md index 8d262b3d..e7811eaf 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~7。 +**取值范围**: 整型，0~7。 - 0表示关闭用户登录、注销审计功能。 - 1表示只审计用户登录成功。 @@ -32,14 +32,14 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭MogDB启动、停止、恢复和切换审计功能。 - 1表示开启MogDB启动、停止、恢复和切换审计功能。 **默认值**: 1 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > MogDB启动时DN执行备升主流程，因此DN启动时审计日志中类型为system_switch。 @@ -49,7 +49,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户锁定和解锁审计功能。 - 1表示开启审计用户锁定和解锁功能。 @@ -62,7 +62,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户越权操作审计功能。 - 1表示开启用户越权操作审计功能。 @@ -75,7 +75,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计用户权限授予和回收功能。 - 1表示开启审计用户权限授予和回收功能。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md index 789d2818..9e9c196c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/22-auditing/3-operation-audit.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～524287 +**取值范围**: 整型，0～524287 - 0代表关闭MogDB数据库对象的CREATE、DROP、ALTER操作审计功能。 - 非0代表只审计MogDB的某类或者某些数据库对象的CREATE、DROP、ALTER操作。 @@ -56,7 +56,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭具体表的DML操作（SELECT除外）审计功能。 - 1表示开启具体表的DML操作（SELECT除外）审计功能。 @@ -69,7 +69,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SELECT操作审计功能。 - 1表示开启SELECT审计操作功能。 @@ -82,7 +82,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭过程或函数执行的审计功能。 - 1表示开启过程或函数执行的审计功能。 @@ -95,7 +95,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭COPY审计功能。 - 1表示开启COPY审计功能。 @@ -108,7 +108,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SET审计功能。 - 1表示开启SET审计功能。 @@ -121,7 +121,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示开启三权分立。 - off表示不开启三权分立。 @@ -134,7 +134,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许任意用户执行EXECUTE DIRECT ON语句。 - off表示只允许系统管理员执行EXECUTE DIRECT ON语句。 @@ -154,7 +154,7 @@ date: 2021-04-20 **默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 出于安全考虑，默认情况下，只有初始用户才能够创建、修改和删除DIRECTORY对象。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/23-upgrade-parameters.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/23-upgrade-parameters.md index 9780d6e6..9143cfcd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/23-upgrade-parameters.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/23-upgrade-parameters.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示在升级过程中。 - off表示不在升级过程中。 @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 @@ -34,7 +34,7 @@ date: 2021-04-20 **参数说明**: 标示升级模式。该参数不建议用户自己修改。 -**取值范围:**整数，0~INT_MAX +**取值范围**: 整数，0~INT_MAX - 0表示不在升级过程中。 - 1表示在就地升级过程中。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md index 7d9d198b..622eb18e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/24-miscellaneous-parameters.md @@ -41,7 +41,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version版本，无实际含义，为保持北向对外工具接口的生态兼容性（工具连接时查询），保留该参数。该参数不推荐使用，如想查询服务器版本号，可通过函数opengauss_version()获取。 -**取值范围:** 字符串 +**取值范围**: 字符串 **默认值**: 9.2.4 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version_num版本，无实际含义，为保持北向对外工具接口的生态兼容性（工具连接时查询），保留该参数。 -**取值范围:**整数 +**取值范围**: 整数 **默认值**: 90204 @@ -61,7 +61,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**8192 +**取值范围**: 8192 **默认值**: 8192 @@ -89,7 +89,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示支持。 - off表示不支持。 @@ -118,7 +118,7 @@ date: 2021-04-20 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围:**整型 +**取值范围**: 整型 **默认值**: 63 @@ -138,7 +138,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 布尔型 +**取值范围**: 布尔型 - on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 - off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 @@ -149,7 +149,7 @@ date: 2021-04-20 **参数说明**: 它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，设置为空表示MogDB非加密。 +**取值范围**: 字符串，设置为空表示MogDB非加密。 **默认值**: 空 @@ -161,7 +161,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 @@ -171,7 +171,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 @@ -195,10 +195,10 @@ date: 2021-04-20 ## max_concurrent_autonomous_transactions -**参数说明**：自治事务最大链接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 +**参数说明**: 自治事务最大链接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0-1024 +**取值范围**: 0-1024 -**默认值**：10 +**默认值**: 10 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/25-wait-events.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/25-wait-events.md index e50c3c56..ca59fe03 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/25-wait-events.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/25-wait-events.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 表示打开等待事件信息收集功能。 - off: 表示关闭等待事件信息收集功能。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/26-query.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/26-query.md index b4fd3418..15f10131 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/26-query.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/26-query.md @@ -17,9 +17,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：100 +**默认值**: 100 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** > @@ -37,7 +37,7 @@ date: 2021-04-20 top：只记录顶层SQL。 -**默认值**：top +**默认值**: top ## enable_instr_rt_percentile @@ -50,7 +50,7 @@ top：只记录顶层SQL。 - on：表示打开sql响应时间信息计算功能。 - off：表示关闭sql响应时间信息计算功能。 -**默认值**：on +**默认值**: on ## percentile @@ -60,7 +60,7 @@ top：只记录顶层SQL。 **取值范围**: 字符串。 -**默认值**：80,95 +**默认值**: 80,95 ## instr_rt_percentile_interval @@ -70,7 +70,7 @@ top：只记录顶层SQL。 **取值范围**: 整型，0～3600（秒）。 -**默认值**：10s +**默认值**: 10s ## enable_instr_cpu_timer @@ -83,7 +83,7 @@ top：只记录顶层SQL。 - on：表示捕获sql执行的cpu时间消耗。 - off：表示不捕获sql执行的cpu时间消耗。 -**默认值**：on +**默认值**: on ## enable_stmt_track @@ -148,7 +148,7 @@ slow sql retention time为慢SQL的保留时间，取值范围为0 ~ 604800 第二部分为慢SQL的跟踪级别，取值范围为OFF、L0、L1、L2 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若全量SQL跟踪级别值为非OFF时，当前SQL跟踪级别值为全量SQL和慢SQL的较高级别（L2 > L1 > L0），级别说明请参见表[GUC参数分类](30-appendix)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若全量SQL跟踪级别值为非OFF时，当前SQL跟踪级别值为全量SQL和慢SQL的较高级别（L2 > L1 > L0），级别说明请参见表[GUC参数分类](30-appendix)。 **默认值**: OFF,L0 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27-system-performance-snapshot.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27-system-performance-snapshot.md index 93fb5c67..e6777df0 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27-system-performance-snapshot.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27-system-performance-snapshot.md @@ -26,7 +26,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1～8。 +**取值范围**: 整型，1～8。 **默认值**: 8 @@ -36,7 +36,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100～INT_MAX（秒）。 +**取值范围**: 整型，100～INT_MAX（秒）。 **默认值**: 100s @@ -46,7 +46,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10～60（分钟）。 +**取值范围**: 整型，10～60（分钟）。 **默认值**: 1h @@ -58,7 +58,7 @@ date: 2021-04-20 **取值范围**: 字符串，‘table’、‘file’、‘all’。 -**默认值**：‘table’ +**默认值**: ‘table’ ## asp_flush_rate @@ -68,7 +68,7 @@ date: 2021-04-20 **取值范围**: 整型，1~10。 -**默认值**：10 +**默认值**: 10 ## asp_log_filename @@ -78,7 +78,7 @@ date: 2021-04-20 **取值范围**: 字符串。 -**默认值**：“asp-%Y-%m-%d_%H%M%S.log” +**默认值**: “asp-%Y-%m-%d_%H%M%S.log” ## asp_retention_days @@ -88,7 +88,7 @@ date: 2021-04-20 **取值范围**: 整型，1~7。 -**默认值**：2 +**默认值**: 2 ## asp_sample_interval @@ -98,7 +98,7 @@ date: 2021-04-20 **取值范围**: 整型，1~10，单位为秒。 -**默认值**：1s +**默认值**: 1s ## asp_sample_num @@ -108,7 +108,7 @@ date: 2021-04-20 **取值范围**: 整型，10000～100000。 -**默认值**：100000 +**默认值**: 100000 ## enable_asp @@ -121,4 +121,4 @@ date: 2021-04-20 - on：打开active session profile功能。 - off：关闭active session profile功能。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27.1-security-configuration.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27.1-security-configuration.md index f6ee251f..2ce5da3a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27.1-security-configuration.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/27.1-security-configuration.md @@ -15,7 +15,7 @@ date: 2021-11-08 **取值范围**: 字符串。 -**默认值**：'https:127.0.0.1' +**默认值**: 'https:127.0.0.1' ## enable_security_policy @@ -29,7 +29,7 @@ on：安全策略开关打开。 off：安全策略开关关闭。 -**默认值**：off +**默认值**: off ## use_elastic_search @@ -43,7 +43,7 @@ on：使能统一审计日志发送至Elastic Search。 off：关闭统一审计日志发送至Elastic Search。 -**默认值**：off +**默认值**: off ## is_sysadmin @@ -57,7 +57,7 @@ on表示是初始用户。 off表示不是初始用户。 -**默认值**：off +**默认值**: off ## enable_tde @@ -71,7 +71,7 @@ on：开启透明数据加密功能。 off：关闭透明数据加密功能。 -**默认值**：off +**默认值**: off ## tde_cmk_id @@ -81,4 +81,4 @@ off：关闭透明数据加密功能。 **取值范围**: 字符串。 -**默认值**：”” +**默认值**: ”” diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md index 44d96084..51d38e30 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/28-equality-query-in-a-fully-encrypted-database.md @@ -15,7 +15,7 @@ date: 2021-04-20 enable_full_encryption设置为on后，使用gsql连接数据库时需要输入"-C"参数，或"-enable-client-encryption"，否则连接不成功。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on: 全密态数据库开关打开。 - off: 全密态数据库开关关闭。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/29-global-temporary-table.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/29-global-temporary-table.md index 740311c8..3a6f4edb 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/29-global-temporary-table.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/29-global-temporary-table.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 - 0: 全局临时表功能关闭。 - > 0: 全局临时表功能打开。 @@ -26,6 +26,6 @@ date: 2021-04-20 该参数USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 **默认值**: 10000 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md index c255db0b..a4f2bc32 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md @@ -39,14 +39,14 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。 > **取值范围**: 整型，1～65535 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置端口号时，请设置一个未被占用的端口号。设置多个实例的端口号，不可冲突。 > - 1~1023为操作系统保留端口号，请不要使用。 @@ -64,18 +64,18 @@ date: 2021-04-20 **默认值**: 200 -**设置建议：** +**设置建议**: 数据库主节点中此参数建议保持默认值。 当修改此默认值时，请同时修改undo_zone_count取值，具体设置原则请参见[undo章节](35-undo)。 -**配置不当时影响：** +**配置不当时影响**: - 若配置max_connections过大，超过计算公式所描述的最大动态值，会出现节点拉起失败问题，报错提示“invalid value for parameter “max_connections””。 - 若未按照对外出口规格配置仅调大max_connections参数值，未同比例调整内存参数。业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于管理员用户的连接数限制会略超过max_connections设置，目的是为了让管理员在链接被普通用户占满后仍可以连接上数据库，再超过一定范围（sysadmin_reserved_connections参数）后才会报错。即管理员用户的最大连接数等于max_connections + sysadmin_reserved_connections。 > - 对于普通用户来说，由于内部作业也会使用一些链接，因此会略小于max_connections，具体值取决于内部链接个数。 @@ -90,7 +90,7 @@ date: 2021-04-20 **默认值**: 数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 -**设置建议：** +**设置建议**: 数据库主节点中此参数建议保持默认值。 @@ -142,7 +142,7 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 **默认值**: 0777 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 在Linux中，文档具有十个属性，其中第一个属性为文档类型，后面九个为权限属性，分别为Owner，Group及Others这三个组别的read、write、execute属性。 文档的权限属性分别简写为r，w，x，这九个属性三个为一组，也可以使用数字来表示文档的权限，对照表如下： > @@ -184,9 +184,9 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 **取值范围**: 字符串。 -**默认值**: 空字符串**。** +**默认值**: 空字符串 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 空字符串，表示当前连接数据库的驱动不支持自动设置connection_info参数或应用程序未设置。 > - 驱动连接数据库的时候自行拼接的connection_info参数格式如下： diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md index 2413f38f..62f897dd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为1，最大值为600，最小单位为s。 +**取值范围**: 整型，最小值为1，最大值为600，最小单位为s。 **默认值**: 1min @@ -25,7 +25,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2048-134217728。 +**取值范围**: 整型，2048-134217728。 **默认值**: 10000 @@ -48,7 +48,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0-86400，最小单位为s，0表示关闭超时设置。 +**取值范围**: 整型，0-86400，最小单位为s，0表示关闭超时设置。 **默认值**: 10min @@ -61,7 +61,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用SSL连接。 - off表示不启用SSL连接。 @@ -77,7 +77,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示服务器端强制要求SSL连接。 - off表示服务器端对是否通过SSL连接不作强制要求。 @@ -93,7 +93,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 +**取值范围**: 字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见**用SSL进行安全的TCP/IP连接**获取支持的加密算法。 **默认值**: ALL @@ -103,7 +103,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 +**取值范围**: 整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 **默认值**: 0 @@ -113,7 +113,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: server.crt @@ -133,7 +133,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: cacert.pem @@ -153,7 +153,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 @@ -163,7 +163,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: postgres @@ -173,7 +173,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示大小写不敏感。 - off表示大小写敏感。 @@ -188,7 +188,7 @@ date: 2021-04-20 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示MogDB安装成功后初始用户首次登录操作前需要修改初始密码。 - off表示MogDB安装成功后初始用户无需修改初始密码即可进行操作。 @@ -204,7 +204,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 从安全性考虑，请勿关闭密码复杂度策略。 -**取值范围:**0、1 +**取值范围**: 0、1 - 0表示不采用任何密码复杂度策略。 - 1表示采用默认密码复杂度校验策略。 @@ -225,7 +225,7 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**浮点型，最小值为0，最大值为3650，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为3650，单位为天。 - 0表示不检查密码可重用的天数。 - 正数表示新密码不能为该值指定的天数内使用过的密码。 @@ -246,7 +246,7 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示不检查密码可重用次数。 - 正整数表示新密码不能为该值指定的次数内使用过的密码。 @@ -262,7 +262,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > password_lock_time和[failed_login_attempts](#failed_login_attempts)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**浮点型，最小值为0，最大值为365，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为365，单位为天。 - 0表示密码验证失败时，自动锁定功能不生效。 - 正数表示帐户被锁定后，当锁定时间超过password_lock_time设定的值时，帐户将会被自行解锁。 @@ -278,7 +278,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > failed_login_attempts和[password_lock_time](#password_lock_time)必须都为正数时锁定和解锁功能才能生效。 -**取值范围:**整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示自动锁定功能不生效。 - 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前帐户将被锁定。 @@ -291,7 +291,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0、1、2、3 +**取值范围**: 0、1、2、3 - 0表示采用md5方式对密码加密。 - 1表示采用sha256和md5两种方式分别对密码加密。 @@ -309,7 +309,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 **默认值**: 8 @@ -319,7 +319,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 **默认值**: 32 @@ -329,7 +329,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建账户所指定的密码中至少需要包含大写字母个数。 @@ -342,7 +342,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含小写字母个数。 @@ -355,7 +355,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含数字个数。 @@ -368,7 +368,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含特殊字符个数。 @@ -381,7 +381,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，最小值为0，最大值为999，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为999，单位为天。 - 0表示不开启有效期限制功能。 - 1~999表示创建帐户所指定的密码有效期，临近或超过有效期系统会提示用户修改密码。 @@ -394,7 +394,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，最小值为0，最大值为999，单位为天。 +**取值范围**: 整型，最小值为0，最大值为999，单位为天。 - 0表示不开启提醒功能。 - 1~999表示帐户密码到期前提醒的天数。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md index 2b51a7f2..a793e9b9 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPIDLE选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 @@ -38,7 +38,7 @@ date: 2021-04-20 **默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPINTVL选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 @@ -68,7 +68,7 @@ date: 2021-04-20 **参数说明**: 通信代理库相关参数配置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该参数仅支持欧拉2.9系统下的集中式ARM单机。 > - 本功能在线程池开启状态下生效，即enable_thread_pool为on。 @@ -82,6 +82,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0。 +**取值范围**: 字符串，长度大于0。 **默认值**: 'none' diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/31-scheduled-task.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/31-scheduled-task.md index dca858ae..7c24dae9 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/31-scheduled-task.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/31-scheduled-task.md @@ -30,13 +30,13 @@ date: 2021-06-07 ## enable_prevent_job_task_startup -**参数说明**：控制是否启动job线程。 +**参数说明**: 控制是否启动job线程。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示不能启动job线程。 - off表示可以启动job线程。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/32-thread-pool.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/32-thread-pool.md index 0c272653..cb0c5cca 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/32-thread-pool.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/32-thread-pool.md @@ -9,20 +9,20 @@ date: 2021-06-07 ## enable_thread_pool -**参数说明**：控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启线程池功能。 - off表示不开启线程池功能。 -**默认值**：off +**默认值**: off ## thread_pool_attr -**参数说明**：用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 该参数分为3个部分，'thread_num, group_num, cpubind_info'，这3个部分的具体含义如下： @@ -34,4 +34,4 @@ date: 2021-06-07 3. '(nodebind: 1, 2)'，利用NUMA组1，2中的CPU core进行绑核； 4. '(cpubind: 0-30)'，利用0-30号CPU core进行绑核。该参数不区分大小写。 -**默认值**：'16, 2, (nobind)' +**默认值**: '16, 2, (nobind)' diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/33-user-defined-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/33-user-defined-functions.md index 940b19cd..7ae35419 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/33-user-defined-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/33-user-defined-functions.md @@ -39,7 +39,7 @@ date: 2021-11-08 ## pljava_vmoptions -**参数说明**：用户自定义设置PL/Java函数所使用的JVM虚拟机的启动参数，仅sysadmin用户可以访问。 +**参数说明**: 用户自定义设置PL/Java函数所使用的JVM虚拟机的启动参数，仅sysadmin用户可以访问。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -49,7 +49,7 @@ date: 2021-11-08 - JDK8 JVM系统属性参数（以-D开头如-Djava.ext.dirs，可参见JDK[官方](https://docs.oracle.com/javase/tutorial/deployment/doingMoreWithRIA/properties.html)说明） - 用户自定义参数（以-D开头，如-Duser.defined.option） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: >如果用户在pljava_vmoptions中设置参数不满足上述取值范围，会在使用PL/Java语言函数时报错。 **默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/34-backup-and-restoration.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/34-backup-and-restoration.md index 347be8f0..d472ec73 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/34-backup-and-restoration.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/34-backup-and-restoration.md @@ -35,12 +35,12 @@ date: 2021-11-08 ## hadr_max_size_for_xlog_receiver -**参数说明**：该参数为异地容灾参数，表示灾备数据库实例中实例获取obs端日志和本地回放日志的最大允许差距，若差距大于此值时停止获取obs端日志。 +**参数说明**: 该参数为异地容灾参数，表示灾备数据库实例中实例获取obs端日志和本地回放日志的最大允许差距，若差距大于此值时停止获取obs端日志。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中方式对应设置方法进行设置。 **修改建议：**该参数的取值应和本地磁盘大小相关，建议设置为磁盘大小的50%。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：256GB +**默认值**: 256GB diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/37-flashback.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/37-flashback.md index 2d2fc020..df6546bd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/37-flashback.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/37-flashback.md @@ -11,13 +11,13 @@ date: 2021-11-08 ## enable_recyclebin -**参数说明**：用来控制回收站的实时打开和关闭。 +**参数说明**: 用来控制回收站的实时打开和关闭。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：off +**默认值**: off ## recyclebin_retention_time @@ -31,22 +31,22 @@ date: 2021-11-08 ## version_retention_age -**参数说明**：设置旧版本保留的事务数，超过该事务数的旧版本将被回收清理。 +**参数说明**: 设置旧版本保留的事务数，超过该事务数的旧版本将被回收清理。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～576460752303423487，值为0表示不延迟。 +**取值范围**: 整型，0～576460752303423487，值为0表示不延迟。 -**默认值**：0 +**默认值**: 0 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 因系统表采用Heap引擎，为避免不必要的系统表膨胀问题（如业务上只是用Uheap闪回功能），在配置version_retention_age的同时，还需同值配置vacuum_defer_cleanup_age，才能有效保留旧版本。 ## vacuum_defer_cleanup_age -**参数说明**：指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。也可以通过设置该参数，配置闪回功能旧版本保留期限。 +**参数说明**: 指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。也可以通过设置该参数，配置闪回功能旧版本保留期限。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～1000000，值为0表示不延迟。取值范围需要扩展到1亿。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。取值范围需要扩展到1亿。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/39-reserved-parameters.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/39-reserved-parameters.md index de8e5fda..7fceb53f 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/39-reserved-parameters.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/39-reserved-parameters.md @@ -7,7 +7,7 @@ date: 2021-11-08 # 预留参数 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 下列参数为预留参数，该版本不生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 下列参数为预留参数，该版本不生效。 acce_min_datasize_per_thread @@ -23,4 +23,4 @@ enable_orc_cache schedule_splits_threshold -backend_version \ No newline at end of file +backend_version diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md index 0b98baa9..2965041f 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/1-memory.md @@ -98,7 +98,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16 ~ 1073741823 ，单位为KB。 +**取值范围**: 整型，16 ~ 1073741823 ，单位为KB。 shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 @@ -122,7 +122,7 @@ segment_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB， **默认值**: 8MB -**设置建议：** +**设置建议**: segment_buffers 用来缓存段页式段头的内容，属于关键元数据信息，为了提高性能建议常用的表的段头都能缓存在buffer中，不被置换出去。建议按照`表的个数（包括索引和toast表）* 分区数 * 3 + 128` 来设置。乘以3是因为每个表（分区）会有一些额外的元数据段，一般一个表有3个段。最后+128因为段页式表空间管理需要一定数量的buffer。 @@ -132,7 +132,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384 ~ 2147483647，单位为KB。 +**取值范围**: 整型，16384 ~ 2147483647，单位为KB。 **默认值**: 2GB @@ -144,7 +144,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**双精度类型，0.1~1.0 +**取值范围**: 双精度类型，0.1~1.0 **默认值**: 0.3 @@ -158,7 +158,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 -**取值范围:**整型，100~1073741823，单位为8KB。 +**取值范围**: 整型，100~1073741823，单位为8KB。 **默认值**: 1MB @@ -170,7 +170,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型。0~262143。 +**取值范围**: 整型。0~262143。 **默认值**: 800 @@ -185,7 +185,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 整型，64~2147483647，单位为KB。 +**取值范围**: 整型，64~2147483647，单位为KB。 **默认值**: 64MB @@ -203,11 +203,11 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:** 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 **默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果设置的query_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。 > - 如果设置值为负数或小于32MB，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 @@ -218,11 +218,11 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 **默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果设置的query_max_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。 > - 如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 @@ -233,7 +233,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024~INT_MAX，单位为KB。 +**取值范围**: 整型，1024~INT_MAX，单位为KB。 **默认值**: 16MB @@ -252,7 +252,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > 同样，多个正在运行的会话可能会同时进行表的局部排序操作。因此，使用的总内存可能是psort_work_mem的几倍。 -**取值范围:**整型64~2147483647，单位为KB。 +**取值范围**: 整型64~2147483647，单位为KB。 **默认值**: 512MB @@ -265,7 +265,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > max_loaded_cudesc设置过高时，有可能引起内存分配不足。 -**取值范围:**100~1073741823。 +**取值范围**: 100~1073741823。 **默认值**: 1024 @@ -275,7 +275,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，100~INT_MAX，单位为KB。 +**取值范围**: 整型，100~INT_MAX，单位为KB。 **默认值**: 2MB @@ -294,7 +294,7 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，16384～1073741823，单位为KB。 +**取值范围**: 整型，16384～1073741823，单位为KB。 **默认值**: 1GB @@ -308,19 +308,19 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，256~2147483647，单位为KB。 +**取值范围**: 整型，256~2147483647，单位为KB。 **默认值**: 16MB ## enable_early_free -**参数说明**：控制是否可以实现算子内存的提前释放。 +**参数说明**: 控制是否可以实现算子内存的提前释放。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持算子内存提前释放。 - off表示不支持算子内存提前释放。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md index ac29f8e1..6bbffc6a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md @@ -15,7 +15,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 **默认值**: -1 @@ -30,6 +30,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** > SQL查询执行时使用的临时表空间不在此限制。 -**取值范围:**整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 **默认值**: -1 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md index fb8ddeda..29da3e72 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md @@ -17,7 +17,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，25~2147483647。 +**取值范围**: 整型，25~2147483647。 **默认值**: 1000 @@ -36,6 +36,6 @@ date: 2021-04-20 > - 如果被声明的库不存在，MogDB服务将会启动失败。 > - 每一个支持MogDB的库都有一个特殊的标记用于保证兼容性。因此，不支持MogDB的库不能用这种方法加载。 -**取值范围:**字符串 +**取值范围**: 字符串 **默认值**: 空 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md index 5761a33c..7873a693 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md @@ -31,7 +31,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 +**取值范围**: integer（毫秒），0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 **默认值**: 0 @@ -41,7 +41,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 **默认值**: 1 @@ -51,7 +51,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~10000。 +**取值范围**: integer，0~10000。 **默认值**: 10 @@ -61,7 +61,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，0~1000 +**取值范围**: integer，0~1000 **默认值**: 20 @@ -71,6 +71,6 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**integer，1~10000。 +**取值范围**: integer，1~10000。 **默认值**: 200 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md index 0ca5f021..ae37bbd3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md @@ -13,16 +13,16 @@ date: 2021-04-20 ## bgwriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～8 +**取值范围**: 整型，0～8 - 开发期间为测试关闭该特性的效果，可以设置为0，但是当前如果设置为0，会在代码中修正为1，不再支持关闭该特性。 - 当参数设置为1~8时，表示会启动相对应数量的background线程，用于维护候选buffer链，将满足条件的脏页刷盘，不脏的页放入到候选list中。 -**默认值**：2 +**默认值**: 2 ## bgwriter_delay @@ -32,7 +32,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，10~10000，单位为毫秒。 +**取值范围**: 整型，10~10000，单位为毫秒。 **默认值**: 2s @@ -40,13 +40,13 @@ date: 2021-04-20 ## candidate_buf_percent_target -**参数说明**：设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 +**参数说明**: 设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度浮点类型，0.1～0.85 +**取值范围**: 双精度浮点类型，0.1～0.85 -**默认值**：0.3 +**默认值**: 0.3 ## bgwriter_lru_maxpages @@ -54,7 +54,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000 +**取值范围**: 整型，0～1000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > @@ -74,39 +74,39 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**浮点型，0~10。 +**取值范围**: 浮点型，0~10。 **默认值**: 2 ## pagewriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～16 +**取值范围**: 整型，1～16 -**默认值**：4 +**默认值**: 4 ## dirty_page_percent_max -**参数说明**：设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 +**参数说明**: 设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.1～1 +**取值范围**: 浮点型，0.1～1 -**默认值**：0.9 +**默认值**: 0.9 ## pagewriter_sleep -**参数说明**：设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 +**参数说明**: 设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～3600000（毫秒） +**取值范围**: 整型，0～3600000（毫秒） -**默认值**：2000ms +**默认值**: 2000ms ## max_io_capacity @@ -114,7 +114,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，30720~10485760。单位是KB。 +**取值范围**: 整型，30720~10485760。单位是KB。 **默认值**: 512000KB（500MB） diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md index f862334f..8c0d2692 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 @@ -26,7 +26,7 @@ date: 2021-04-20 当前版本暂不支持开启异步IO功能，默认该功能关闭，请勿自行修改。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 @@ -39,7 +39,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。只有在XFS文件系统上才能开启该开关。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 @@ -52,7 +52,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 **默认值**: 32MB (4096 * 8KB) @@ -64,7 +64,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 **默认值**: 8MB (1024 * 8KB) @@ -74,7 +74,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 **默认值**: 32MB @@ -84,7 +84,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 **默认值**: 8MB @@ -94,7 +94,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096～INT_MAX/2，单位为KB。 +**取值范围**: 整型，4096～INT_MAX/2，单位为KB。 **默认值**: 2GB @@ -104,7 +104,7 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 **默认值**: 8MB @@ -114,36 +114,36 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型 ，0~1000 +**取值范围**: 整型 ，0~1000 **默认值**: 1 ## checkpoint_flush_after -**参数说明**：设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 -**默认值**：32 +**默认值**: 32 ## bgwriter_flush_after -**参数说明**：设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：512KB（即64个页面） +**默认值**: 512KB（即64个页面） ## backend_flush_after -**参数说明**：设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md index 6a97c9dc..9de9198e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md @@ -53,7 +53,7 @@ date: 2021-04-20 > - 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 > - 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示使用fsync()系统函数。 - off表示不使用fsync()系统函数。 @@ -127,7 +127,7 @@ date: 2021-04-20 > - 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 > - 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示启用此特性。 - off表示关闭此特性。 @@ -140,7 +140,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示整个页面全部内容写到WAL日志中。 - off表示整个页面内容不会写到WAL日志中。 @@ -153,7 +153,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**-1~218 +**取值范围**: -1~218 - 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，为shared_buffers的1/32，最小值为8个XLOG_BLCKSZ，最大值为2048个XLOG_BLCKSZ。 - 如果设置为其他值，当小于4时，会被默认设置为4。 @@ -227,7 +227,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~核数减1。 +**取值范围**: 整型，-1~核数减1。 **默认值**: -1 @@ -237,7 +237,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~50000。 +**取值范围**: 整型，1~50000。 **默认值**: 500 @@ -247,7 +247,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1000000。 +**取值范围**: 整型，0~1000000。 **默认值**: 10 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md index 8f39c5a2..552a10f9 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md @@ -79,7 +79,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数主节点设置无效，必须设置在需要延迟的备节点上。 > - 延迟时间是根据主服务器上事物提交的时间戳与备机上的当前时间来计算，因此需要保证主备系统时钟一致。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md index aaa04d42..e0efb4fb 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md @@ -25,7 +25,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，2 ~ INT_MAX +**取值范围**: 整型，2 ~ INT_MAX **默认值**: 16 @@ -47,7 +47,7 @@ date: 2021-04-20 > - 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为600s。 > - 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 **默认值**: 6s @@ -57,7 +57,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型， 0~262143。 +**取值范围**: 整型， 0~262143。 **默认值**: 8 @@ -109,7 +109,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第一个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第一个节点信息。 **默认值**: 空字符串 @@ -119,7 +119,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第二个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第二个节点信息。 **默认值**: 空字符串 @@ -129,7 +129,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第三个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第三个节点信息。 **默认值**: 空字符串 @@ -139,7 +139,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第四个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第四个节点信息。 **默认值**: 空字符串 @@ -149,7 +149,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第五个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第五个节点信息。 **默认值**: 空字符串 @@ -159,7 +159,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第六个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第六个节点信息。 **默认值**: 空字符串 @@ -169,7 +169,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第七个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第七个节点信息。 **默认值**: 空字符串 @@ -179,7 +179,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置第八个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第八个节点信息。 **默认值**: 空字符串 @@ -369,6 +369,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符串。其中空字符串表示没有配置节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置节点信息。 **默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md index 370325a6..5dd4506e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md @@ -24,7 +24,7 @@ date: 2021-04-20 - [FIRST] **num_sync (standby_name** [, …]) - **standby_name** [, …] -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 其中 **num_sync** 是事务需要等待其回复的同步复制的备机的数量，**standby_name** 是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略。 > @@ -67,12 +67,12 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 > - 此参数属于受控参数，不建议正常业务场景下关闭此参数。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开主备、主从同步。 - off表示关闭主备、主从同步。 @@ -89,7 +89,7 @@ date: 2021-04-20 > > 此参数目前不允许正常业务场景下改变其值，即关闭WAL日志、数据页混合复制模式。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示打开WAL日志、数据页混合复制模式。 - off表示关闭WAL日志、数据页混合复制模式。 @@ -102,7 +102,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0～1000000，值为0表示不延迟。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。 **默认值**: 0 @@ -112,7 +112,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1072693248，单位为KB。 +**取值范围**: 整型，4096~1072693248，单位为KB。 **默认值**: 16MB（即16448KB） @@ -122,7 +122,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，8~INT_MAX，单位为KB。 +**取值范围**: 整型，8~INT_MAX，单位为KB。 **默认值**: 8M（即8192KB） @@ -132,7 +132,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 - off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 @@ -145,7 +145,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示日志中将打印数据复制时每个数据块的状态。 - off表示日志中不打印数据复制时每个数据块的状态。 @@ -158,7 +158,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示备机catchup时用增量catchup方式，即从从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 - off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 @@ -171,7 +171,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围1~INT_MAX，单位为秒 +**取值范围**: 整型，范围1~INT_MAX，单位为秒 **默认值**: 300 @@ -185,7 +185,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围-1~10000，单位为毫秒。 +**取值范围**: 整型，范围-1~10000，单位为毫秒。 - -1表示主机阻塞直到备机数据追赶完成。 - 0表示备机数据追赶时始终不阻塞主机。 @@ -199,7 +199,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**枚举类型 +**取值范围**: 枚举类型 - all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 - only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 @@ -207,7 +207,7 @@ date: 2021-04-20 **默认值**: all_node -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 在一个包含了主机、备机和级联备的MogDB集群中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。 > - 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要将集群中所有节点的sync_config_strategy参数配置为none_node；若仅希望主机与同步备机同步配置文件，则需要将主机的sync_config_strategy参数配置为only_sync_node，其余节点配置为none_node；若希望所有节点同步配置文件，则需要将所有节点的sync_config_strategy参数配置为all_node。目前暂不支持自定义指定任意节点间的同步策略。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md index 7d3e8e61..a1cb8c70 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md @@ -13,12 +13,12 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果此参数设置为on，wal_level必须设置为hot_standby，否则将导致数据库无法启动。 > - 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许备机在恢复过程中连接和查询。 - off表示不允许备机在恢复过程中连接和查询。 @@ -35,7 +35,7 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型，范围: -1~INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围: -1~INT_MAX，单位为毫秒。 **默认值**: 3s（即3000ms） @@ -49,7 +49,7 @@ date: 2021-04-20 > > -1表示允许备机一直等待冲突的查询完成。 -**取值范围:**整型（毫秒），范围: -1~INT_MAX。 +**取值范围**: 整型（毫秒），范围: -1~INT_MAX。 **默认值**: 3s（即3000ms） @@ -59,11 +59,11 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，范围: 0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围: 0 ~ INT_MAX，单位为毫秒。 **默认值**: 5s（即5000ms） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 当该参数设置为0时，表示关闭备机向主机反馈日志接收位置等信息，可能会导致主机事务提交阻塞、switchover操作失败等异常现象。正常业务场景，不建议将该参数设置为0。 ## hot_standby_feedback @@ -72,7 +72,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示允许将备机上执行查询的最小事务号反馈给主机。 - off表示不允许将备机上执行查询的最小事务号反馈给主机。 @@ -89,7 +89,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒。 **默认值**: 6s（即6000ms） @@ -99,7 +99,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，0 ~ INT_MAX / 1000，单位为秒。 +**取值范围**: 整型，0 ~ INT_MAX / 1000，单位为秒。 **默认值**: 2s @@ -109,7 +109,7 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，1~ INT_MAX。 +**取值范围**: 整型，1~ INT_MAX。 **默认值**: 1 @@ -119,7 +119,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**整型，4096~1047552，单位为KB。 +**取值范围**: 整型，4096~1047552，单位为KB。 **默认值**: 64MB（即65536KB） @@ -129,6 +129,6 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**字符型 +**取值范围**: 字符型 **默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md index be3f0d2b..fa5915a1 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md @@ -197,7 +197,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示正则表达式采用A格式的匹配规则。 - off表示正则表达式采用POSIX格式的匹配规则。 @@ -246,7 +246,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示可以使用绝对路径。 - off表示不可以使用绝对路径。 @@ -259,7 +259,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围:**布尔型 +**取值范围**: 布尔型 - on表示对DFS分区表进行静态/动态优化。 - off表示不对DFS分区表进行静态/动态优化。 @@ -305,13 +305,13 @@ date: 2021-04-20 ## check_implicit_conversions -**参数说明**：控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 +**参数说明**: 控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 - off表示不进行相关检查。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md index 18ef5818..ce48e0ae 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md @@ -13,7 +13,7 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这个参数的取值必须是绝对路径加上.csv格式的文件名。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这个参数的取值必须是绝对路径加上.csv格式的文件名。 **取值范围**: 字符串 @@ -21,18 +21,18 @@ date: 2021-04-20 ## explain_perf_mode -**参数说明**：此参数用来指定explain的显示格式。 +**参数说明**: 此参数用来指定explain的显示格式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：normal、pretty、summary、run +**取值范围**: normal、pretty、summary、run - normal：代表使用默认的打印格式。 - pretty：代表使用MogDB改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 - summary：是在pretty的基础上增加了对打印信息的分析。 - run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。 -**默认值**：pretty（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal） +**默认值**: pretty（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal） ## analysis_options @@ -48,13 +48,13 @@ date: 2021-04-20 - STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pretty模式当前版本不支持。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pretty模式当前版本不支持。 **默认值**: ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 ## cost_param -**参数说明**：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 +**参数说明**: 该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确。目前，已弃用cost_param & 1不为0时的路径，默认选择更优的估算公式； @@ -62,26 +62,26 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：0 +**默认值**: 0 ## enable_partitionwise -**参数说明**：分区表连接操作是否选择智能算法。 +**参数说明**: 分区表连接操作是否选择智能算法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示选择智能算法。 - off表示不选择智能算法。 -**默认值**：off +**默认值**: off ## rewrite_rule -**参数说明**：标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 +**参数说明**: 标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 此参数可以控制查询重写规则的组合，比如有多个重写规则：rule1、rule2、rule3、rule4。可以设置： @@ -93,7 +93,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何可选查询重写规则。 - lazyagg：使用Lazy Agg查询重写规则（消除子查询中的聚集运算）。 @@ -106,58 +106,58 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 - predpushforce：使用Predicate Push查询重写规则（下推谓词条件到子查询中，尽可能的利用索引加速）。 - predpush：在predpushnormal和predpushforce中根据代价选择最优计划。 -**默认值**：magicset +**默认值**: magicset ## enable_pbe_optimization -**参数说明**：设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 +**参数说明**: 设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化PBE语句的查询计划。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_light_proxy -**参数说明**：设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 +**参数说明**: 设置优化器是否对简单查询在数据库主节点上优化执行，应用端和内核端字符集不匹配时，该参数不生效，建议建库时将字符集设为UTF8。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化数据库主节点上简单查询的执行。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_global_plancache -**参数说明**：设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 +**参数说明**: 设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示对PBE查询的执行计划进行缓存共享。 - off表示不共享。 -**默认值**：off +**默认值**: off ## gpc_clean_timeout -**参数说明**：开启enable_global_plancache的情况下，如果共享计划列表里的计划超过gpc_clean_timeout的时间没有被使用，则会被清理掉。本参数用于控制没有使用的共享计划的保留时间。 +**参数说明**: 开启enable_global_plancache的情况下，如果共享计划列表里的计划超过gpc_clean_timeout的时间没有被使用，则会被清理掉。本参数用于控制没有使用的共享计划的保留时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，300~86400，单位为秒 +**取值范围**: 整型，300~86400，单位为秒 -**默认值**：1800，即30min +**默认值**: 1800，即30min ## enable_global_stats @@ -174,7 +174,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 ## enable_opfusion -**参数说明**：控制是否对简单增删改查进行优化。 +**参数说明**: 控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -224,29 +224,29 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 c3列修改的值可以是常量和参数，也可以是一个简单的表达式，c1和c2列为索引列，后边可以是常量或者参数。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_partition_opfusion -**参数说明**：在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 +**参数说明**: 在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## sql_beta_feature -**参数说明**：标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 +**参数说明**: 标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 开启它们可以对特定的场景进行优化，但也可能会导致部分没有被测试覆盖的场景发生性能劣化。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 @@ -263,7 +263,7 @@ set sql_beta_feature=none; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何Beta优化器特性。 - sel_semi_poisson：使用泊松分布对等值的半连接和反连接选择率进行校准。 @@ -278,7 +278,7 @@ set sql_beta_feature=none; - index_cost_with_leaf_pages_only：估算索引代价时考虑索引叶子结点。 - partition_opfusion：开启分区表优化。 -**默认值**：none +**默认值**: none ## ngram_gram_size @@ -318,13 +318,13 @@ set sql_beta_feature=none; ## default_statistics_target -**参数说明**：为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 +**参数说明**: 为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数是代表统计信息的样本数量，为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-100～10000。 +**取值范围**: 整型，-100～10000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 比默认值大的正数数值增加了ANALYZE所需的时间，但是可能会改善优化器的估计质量。 > - 调整此参数可能存在性能劣化的风险，如果某个查询劣化，可以考虑 @@ -333,15 +333,15 @@ set sql_beta_feature=none; > - 当此guc参数设置为负数时，如果计算的采样样本数大于等于总数据量的2%，且用户表的数据量小于1600000时，ANALYZE所需时间相比guc参数为默认值的时间会有所增加。 > - 当此guc参数设置为负数时，则autoanalyze不生效。 -**默认值**：100 +**默认值**: 100 ## constraint_exclusion -**参数说明**：控制查询优化器使用表约束查询的优化。 +**参数说明**: 控制查询优化器使用表约束查询的优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on表示检查所有表的约束。 @@ -349,75 +349,75 @@ set sql_beta_feature=none; - partition表示只检查继承的子表和UNION ALL子查询。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 -**默认值**：partition +**默认值**: partition -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 ## cursor_tuple_fraction -**参数说明**：优化器估计游标获取行数在总行数中的占比。 +**参数说明**: 优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～1.0。 +**取值范围**: 浮点型，0.0～1.0。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 -**默认值**：0.1 +**默认值**: 0.1 ## from_collapse_limit -**参数说明**：根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 +**参数说明**: 根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 -**默认值**：8 +**默认值**: 8 ## join_collapse_limit -**参数说明**：根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 +**参数说明**: 根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。 > - 比默认值小的数值减少规划时间但也降低了执行计划的质量。 -**默认值**：8 +**默认值**: 8 ## plan_mode_seed -**参数说明**：该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 +**参数说明**: 该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中：OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划；如果用户指定guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~ 2147483647 +**取值范围**: 整型，-1~ 2147483647 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 > - 当该参数不为0时，查询指定的plan hint不会生效。 ## hashagg_table_size -**参数说明**：用于设置执行HASH JOIN操作时HASH表的大小。 +**参数说明**: 用于设置执行HASH JOIN操作时HASH表的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX/2。 +**取值范围**: 整型，0～INT_MAX/2。 -**默认值**：0 +**默认值**: 0 ## enable_codegen @@ -431,7 +431,7 @@ set sql_beta_feature=none; - off表示不允许开启代码生成优化。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 **默认值**: off @@ -447,7 +447,7 @@ set sql_beta_feature=none; - pure表示当所计算表达式整体可被codegen化时，才考虑调用LLVM动态编译优化策略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 **默认值**: partial @@ -531,7 +531,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。 - off表示不使用面向列的hash表设计的Hash Agg算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景enable_codegen打开后获得较大性能提升)，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为“Sonic Hash Aggregation”，而未达到该约束条件时，算子名称将显示为“Hash Aggregation”，Explain详解请参见详解。 @@ -549,7 +549,7 @@ set sql_beta_feature=none; - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。 - off表示不使用面向列的hash表设计的Hash Join算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前开关仅适用于Inner Join的场景。 > - 在开启enable_sonic_hashjoin，查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景，对应的算子查询性能可能会出现劣化。 @@ -572,121 +572,121 @@ set sql_beta_feature=none; ## log_parser_stats -**参数说明**：控制优化器输出parser模块的性能日志。 +**参数说明**: 控制优化器输出parser模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_planner_stats -**参数说明**：控制优化器输出planner模块的性能日志。 +**参数说明**: 控制优化器输出planner模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_executor_stats -**参数说明**：控制优化器输出executor模块的性能日志。 +**参数说明**: 控制优化器输出executor模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_statement_stats -**参数说明**：控制优化器输出该语句的性能日志。 +**参数说明**: 控制优化器输出该语句的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## plan_cache_mode -**参数说明**：标识在prepare语句中，选择生成执行计划的策略。 +**参数说明**: 标识在prepare语句中，选择生成执行计划的策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - auto表示按照默认的方式选择custom plan或者generic plan。 - force_generic_plan表示强制走generic plan。 - force_custom_plan表示强制走custom plan。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 > - custom plan是指对于preapre语句，在执行execute的时候，把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划，这种方案的优点是每次都按照具体的参数生成优选计划，执行性能比较好；缺点是每次执行前都需要重新生成计划，存在大量的重复的优化器开销。 > - generic plan是指对于preapre语句生成计划，该计划策略会在执行execute语句的时候把参数bind到plan中，然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销；缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的，部分bind参数场景下执行性能较差。 -**默认值**：auto +**默认值**: auto ## enable_hypo_index -**参数说明**：控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 +**参数说明**: 控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_force_vector_engine -**参数说明**：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 +**参数说明**: 对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以向量化的算子强制生成向量化。 - off表示由向量化算子优化器决定是否向量化。 -**默认值**：off +**默认值**: off ## enable_auto_explain -**参数说明**：控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 +**参数说明**: 控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，true表示开启，false表示关闭。 +**取值范围**: 布尔型，true表示开启，false表示关闭。 -**默认值**：false +**默认值**: false ## auto_explain_level -**参数说明**：控制自动打印执行计划的日志等级。 +**参数说明**: 控制自动打印执行计划的日志等级。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 +**取值范围**: 枚举型，LOG或NOTICE，LOG表示在日志中打印执行计划，NOTICE表示以提示知的形式打印出计划。 -**默认值**：LOG +**默认值**: LOG ## query_dop @@ -694,16 +694,16 @@ set sql_beta_feature=none; **取值范围**: 整型，1~64。打开固定SMP功能，系统会使用固定并行度。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在开启并行查询后，请保证系统CPU、内存、网络等资源充足，以达到最佳效果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在开启并行查询后，请保证系统CPU、内存、网络等资源充足，以达到最佳效果。 **默认值**: 1 ## enable_startwith_debug -**参数说明**：该参数为start with/connect by用于debug的参数，打开参数可以显示start with特性所有涉及的尾列相关信息。 +**参数说明**: 该参数为start with/connect by用于debug的参数，打开参数可以显示start with特性所有涉及的尾列相关信息。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，true表示开启，false表示关闭。 +**取值范围**: 布尔型，true表示开启，false表示关闭。 -**默认值**：false +**默认值**: false diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md b/product/zh/docs-mogdb/v2.1/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md index 9b906dc0..96d7a4c3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md @@ -9,7 +9,7 @@ date: 2021-11-15 DBE_PLDEBUGGER下系统函数用于单机下调试存储过程，目前支持的接口及其描述如下所示。仅管理员有权限执行这些调试接口。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，调用attach、next、continue、 info_code、step、info_breakpoint、backtrace、 finish中会返回密码的明文。因此不建议用户在函数体中创建用户。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，调用attach、next、continue、 info_code、step、info_breakpoint、backtrace、 finish中会返回密码的明文。因此不建议用户在函数体中创建用户。 对应权限角色为gs_role_pldebugger，可以由管理员用户通过如下命令将debugger权限赋权给该用户。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/2-keywords.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/2-keywords.md index 31abca86..225dc298 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/2-keywords.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/2-keywords.md @@ -15,7 +15,7 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 - 标识符必须以字母（a-z）或下划线（_）开头。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此命名规范为建议项，非强制项。 > - 特殊情况下可以使用双引号规避特殊字符报错。 @@ -207,4 +207,4 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 | XMLPARSE | col-name | | XMLPI | col-name | | XMLROOT | col-name | -| XMLSERIALIZE | col-name | \ No newline at end of file +| XMLSERIALIZE | col-name | diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md index 53fd89c4..f1d09b0c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/1-simple-expressions.md @@ -35,7 +35,7 @@ date: 2021-05-17 expression NOTNULL - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 不要写expression=NULL或expression<>(!=)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 - is distinct from/is not distinct from diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md index a08bf6f0..301178b7 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/4-expressions/4-array-expressions.md @@ -43,7 +43,7 @@ mogdb=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; 如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 ## ANY/SOME (array) @@ -70,7 +70,7 @@ mogdb=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - 如果对比结果没有真值，则ANY的结果为false。 - 如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** SOME是ANY的同义词。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: SOME是ANY的同义词。 ## ALL (array) diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/2-operators.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/2-operators.md index 5812536c..f27e383b 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/2-operators.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/2-operators.md @@ -63,7 +63,7 @@ mogdb=# SELECT 'abc' || 'def' AS "unspecified"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 因为查询中没有声明任何类型，所以本例中对类型没有任何初始提示。因此，分析器查找所有候选操作符，发现既存在接受字符串类型范畴的操作符也存在接受位串类型范畴的操作符。因为字符串类型范畴是首选，所以选择字符串类型范畴的首选类型text作为解析未知类型文本的声明类型。 示例3：绝对值和取反操作符类型分析。MogDB操作符表里面有几条记录对应于前缀操作符@，它们都用于为各种数值类型实现绝对值操作。其中之一用于float8类型，它是数值类型范畴中的首选类型。因此，在面对unknown输入的时候， MogDB会使用该类型： @@ -88,5 +88,5 @@ mogdb=# SELECT array[1,2] <@ '{1,2,3}' as "is subset"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB操作符表有几条记录对应于中缀操作符<@，但是只有两个可以在左侧接受一个整数数组的操作符是数组包含（anyarray <@ anyarray）和范围包含（anyelement <@ anyrange）的。因为没有多态的伪类型（参阅[伪类型](15-pseudo-types)）是首选的，所以解析器不能解决这个基础上的歧义。然而，最后一个解析规则告诉用户，假设未知类型的文字是和另外一个输入相同的类型，也就是，整数数组。现在只有两个操作符中的一个可以匹配，所以选择数组包含。（如果用户选择了范围包含，用户将得到一个错误，因为字符串没有正确的格式成为范围的文字。) diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/3-functions.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/3-functions.md index d94e7cd0..401cda0d 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/3-functions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/3-functions.md @@ -79,7 +79,7 @@ mogdb=# SELECT substr(varchar '1234', 3); mogdb=# SELECT substr(CAST (varchar '1234' AS text), 3); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 分析器从pg_cast表中了解到text和varchar是二进制兼容的，意思是说一个可以传递给接受另一个的函数而不需要做任何物理转换。因此，在这种情况下，实际上没有做任何类型转换。 而且，如果以integer为参数调用函数，分析器将试图将其转换成text类型： diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md index da6d1dd4..f8727d5d 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/4-value-storage.md @@ -32,5 +32,5 @@ mogdb=# SELECT VS_COL1, octet_length(VS_COL1) FROM tpcds.value_storage_t1; mogdb=# DROP TABLE tpcds.value_storage_t1; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这里真正发生的事情是两个unknown文本缺省解析成text，这样就允许||操作符解析成text连接。然后操作符的text结果转换成bpchar(“空白填充的字符型”， character类型内部名称)以匹配目标字段类型。不过，从text到bpchar的转换是二进制兼容的，这样的转换是隐含的并且实际上不做任何函数调用。最后，在系统表里找到长度转换函数bpchar(bpchar, integer, Boolean) 并且应用于该操作符的结果和存储的字段长。这个类型相关的函数执行所需的长度检查和额外的空白填充。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md index 4ea7771e..a80753fc 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md @@ -19,7 +19,7 @@ SQL UNION构造必须把那些可能不太相似的类型匹配起来成为一 - 如果输入类型是同一个类型范畴，则选择该类型范畴的首选类型。（例外：union操作会选择第一个分支的类型作为所选类型。） - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 系统表pg_type中typcategory表示数据类型范畴， typispreferred表示是否是typcategory分类中的首选类型。 - 把所有输入转换为所选的类型（对于字符串保持原有长度）。如果从给定的输入到所选的类型没有隐式转换则失败。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md index 0f1388ec..5ba969c3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md @@ -25,7 +25,7 @@ identify_serials (7 rows) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 实际上，在这些示例查询中，应该使用coalesce防止一个独立的NULL属性导致整个文档的NULL结果。 另外一种可能是：文档在文件系统中作为简单的文本文件存储。在这种情况下，数据库可以用于存储全文索引并且执行搜索，同时可以使用一些唯一标识从文件系统中检索文档。然而，从数据库外部检索文件需要拥有系统管理员权限或者特殊函数支持。因此，还是将所有数据保存在数据库中比较方便。同时，将所有数据保存在数据库中可以方便地访问文档元数据以便于索引和显示。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md index 72583ded..13dbea3c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md @@ -19,7 +19,7 @@ MogDB提供了用来操作tsvector类型的函数和操作符。 setweight返回一个输入tsvector的副本，其中每一个位置都使用给定的权重做了标记。权值可以为A、B、C或D（D是tsvector副本的默认权重，并且不在输出中呈现）。当对tsvector进行连接操作时，这些权重标签将会被保留，文档不同部分以不同的权重进行排序。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 权重标签作用于位置，而不是词素。如果传入的tsvector已经被剥离了位置信息，那么setweight函数将什么都不做。 - length(vector tsvector) returns integer diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md index 06712a09..331941f2 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md @@ -24,7 +24,7 @@ ts_rewrite函数族可以从tsquery中搜索一个特定的目标子查询，并 ts_rewrite的这种形式接受一个起始查询和SQL查询命令。 这里的查询命令是文本字串形式，必须产生两个tsquery列。查询结果的每一行，第一个字段的值（目标子查询） 都会被第二个字段（替代子查询）替换。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 当多个规则需要重写时，重写顺序非常重要； 因此在实践中需要使用ORDER BY将源查询按照某些字段进行排序。 例如：举一个现实生活中天文学上的例子。我们将使用表驱动的重写规则扩大supernovae的查询范围： diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md index 8e6d7d0f..122c26a5 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md @@ -25,5 +25,5 @@ mogdb=# SELECT ts_lexize('english_stem', 'a'); {} ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > ts_lexize函数支持单一token，不支持文本。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/8-controlling-transactions.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/8-controlling-transactions.md index 80e31f3f..6736db1f 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/8-controlling-transactions.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/8-controlling-transactions.md @@ -25,5 +25,5 @@ MogDB通过COMMIT或者END可完成提交事务的功能，即提交事务的所 回滚是在事务运行的过程中发生了某种故障，事务不能继续执行，系统将事务中对数据库的所有已完成的操作全部撤销。请参考[ROLLBACK](121-ROLLBACK)。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，如果其中有一个语句失败，那么整个请求都将会被回滚。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/9-ddl-syntax-overview.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/9-ddl-syntax-overview.md index 6a25f1f5..837e6da7 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/9-ddl-syntax-overview.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-reference/9-ddl-syntax-overview.md @@ -9,7 +9,7 @@ date: 2021-05-17 DDL（Data Definition Language数据定义语言），用于定义或修改数据库中的对象。如：表、索引、视图等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > MogDB不支持数据库主节点不完整时进行DDL操作。例如：MogDB中有1个数据库主节点故障时执行新建数据库、表等操作都会失败。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/101-DROP-USER.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/101-DROP-USER.md index 77e042ea..83a5042a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/101-DROP-USER.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/101-DROP-USER.md @@ -44,7 +44,7 @@ DropUser ::= DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; - RESTRICT：如果用户还有任何依赖的对象，则拒绝删除该用户（缺省行为）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在MogDB中，存在一个配置参数enable_kill_query，此参数在配置文件postgresql.conf中。此参数影响级联删除用户对象的行为： > > - 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的进程，并删除用户。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md index 1ff98cb6..f1b3e9c5 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/106-EXPLAIN-PLAN.md @@ -25,7 +25,7 @@ FOR statement ; - STATEMENT_ID用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。 ## 注意事项 @@ -40,7 +40,7 @@ FOR statement ; 1. 执行EXPLAN PLAN。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。 > PLAN_TABLE详细介绍见**PLAN_TABLE**。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/108-GRANT.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/108-GRANT.md index a54c0ada..92e18e21 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/108-GRANT.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/108-GRANT.md @@ -99,7 +99,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予域的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予域的访问权限。 - 将客户端加密主密钥CMK的访问权限赋予指定的用户或角色。 @@ -165,7 +165,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持大对象。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持大对象。 - 将模式的访问权限赋予指定的用户或角色。 @@ -176,7 +176,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。同名模式下创建表的权限无法通过此语法赋予，可以通过将角色的权限赋予其他用户或角色的语法，赋予同名模式下创建表的权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。同名模式下创建表的权限无法通过此语法赋予，可以通过将角色的权限赋予其他用户或角色的语法，赋予同名模式下创建表的权限。 - 将表空间的访问权限赋予指定的用户或角色。 @@ -196,7 +196,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予类型的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予类型的访问权限。 - 将Data Source对象的权限赋予指定的角色。 @@ -419,7 +419,7 @@ GRANT的参数说明如下所示。 - 如果用户有该对象上的部分权限，则GRANT命令只授予他有授权选项的权限。 - 如果用户没有可用的授权选项，GRANT ALL PRIVILEGES形式将发出一个警告信息，其他命令形式将发出在命令中提到的且没有授权选项的相关警告信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/109-INSERT.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/109-INSERT.md index 4e39da66..27460171 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/109-INSERT.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/109-INSERT.md @@ -23,7 +23,7 @@ date: 2021-05-18 - 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的insert语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 ## 语法格式 @@ -56,7 +56,7 @@ INSERT INTO table_name [ ( column_name [, ...] ) ] - 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/11.3-ALTER-RESOURCE-POOL.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/11.3-ALTER-RESOURCE-POOL.md index f80d3fbe..6c040653 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/11.3-ALTER-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/11.3-ALTER-RESOURCE-POOL.md @@ -36,7 +36,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 控制组名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置控制组名称时，语法可以使用双引号，也可以使用单引号。 > @@ -73,7 +73,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 在普通场景下，普通用户的mem_percent范围为0-100的整数，默认值为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** mem_percent和memory_limit同时指定时，只有mem_percent起作用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: mem_percent和memory_limit同时指定时，只有mem_percent起作用。 - **io_limits** @@ -87,7 +87,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 包括三档可选：Low、Medium和High。不控制时可设置为None，默认为None。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT，COPY FROM，CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT，COPY FROM，CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/111-MOVE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/111-MOVE.md index 62b62221..cb43fccb 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/111-MOVE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/111-MOVE.md @@ -44,7 +44,7 @@ direction ::= NEXT MOVE命令的参数与FETCH的相同，详细请参见FETCH的参数说明。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 成功完成时，MOVE命令将返回一个“MOVE count”的标签，count是一个使用相同参数的FETCH命令会返回的行数（可能为零）。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/117-REINDEX.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/117-REINDEX.md index 8909d872..930f6e77 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/117-REINDEX.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/117-REINDEX.md @@ -67,7 +67,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 - **FORCE** @@ -84,7 +84,7 @@ REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行 - 如果前面是REINDEX TABLE，则这里应该指定分区的名称； - 如果前面是REINDEX INTERNAL TABLE，则这里应该指定列存分区表的分区的名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/125-SELECT.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/125-SELECT.md index bb7a3be1..c02afeda 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/125-SELECT.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/125-SELECT.md @@ -39,7 +39,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 [ {FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > condition和expression中可以使用targetlist中表达式的别名。 > @@ -90,7 +90,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 FOR ( partition_value [, ...] ) }; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定分区只适合普通表。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定分区只适合普通表。 - 其中设置排序方式nlssort_expression_clause为： @@ -136,7 +136,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 ON ( expression [, …] ) 只保留那些在给出的表达式上运算出相同结果的行集合中的第一行。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 - **SELECT列表** @@ -185,7 +185,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 关键字，闪回查询的标识，根据表的CSN闪回查询指定CSN点的结果集。其中CSN可从gs_txn_snapshot记录的snpcsn号查得。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 闪回查询不能跨越影响表结构或物理存储的语句，否则会报错。即闪回点和当前点之间，如果执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL），则闪回失败，报错:“ERROR: The table definition of T1 has been changed.”。 > - 闪回点过旧时，因闪回版本被回收等导致无法获取旧版本会导致闪回失败，报错：Restore point too old。可通过将version_retention_age和vacuum_defer_cleanup_age设置成同值，配置闪回功能旧版本保留期限，取值范围是0~1000000，值为0表示VACUUM不会延迟清除无效的行存记录。 @@ -247,7 +247,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 CROSS JOIN等效于INNER JOIN ON（TRUE） ，即没有被条件删除的行。这种连接类型只是符号上的方便，因为它们与简单的FROM和WHERE的效果相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [， …]) 之一。但是它们不能出现在CROSS JOIN中。 其中CROSS JOIN和INNER JOIN生成一个简单的笛卡尔积，和在FROM的顶层列出两个项的结果相同。 @@ -284,7 +284,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 9. “(+)“只能出现”比较表达式”，”NOT表达式”，“ANY表达式”，“ALL表达式”，“IN表达式”，“NULLIF表达式”，“IS DISTINCT FROM表达式”，“IS OF”表达式。”(+)“不能出现在其他类型表达式中，并且这些表达式中不允许出现通过“AND”和“OR”连接的表达式。 10. “(+)“只能转化为左外连接或者右外连接，不能转化为全连接，即不能在一个表达式的两个表上同时指定”(+)“ - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 - **START WITH** @@ -302,7 +302,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 GROUPING SETS子句是GROUP BY子句的进一步扩展，它可以使用户指定多个GROUP BY选项。 这样做可以通过裁剪用户不需要的数据组来提高效率。 当用户指定了所需的数据组时，数据库不需要执行完整CUBE或ROLLUP生成的聚合集合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 - **HAVING子句** @@ -342,7 +342,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 UNBOUNDED FOLLOWING ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 - **UNION子句** @@ -405,7 +405,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 - 在与DISTINCT关键字一起使用的情况下，ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - 在与GROUP BY子句一起使用的情况下，ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果要支持中文拼音排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: initdb -E UTF8 -D ../data -locale=zh_CN.UTF-8或initdb -E GBK -D ../data -locale=zh_CN.GBK。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果要支持中文拼音排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: initdb -E UTF8 -D ../data -locale=zh_CN.UTF-8或initdb -E GBK -D ../data -locale=zh_CN.GBK。 - **LIMIT子句** @@ -443,7 +443,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 如果一个表中同时出现（或隐含同时出现）在FOR UPDATE和FOR SHARE子句中，则按照FOR UPDATE处理。类似的，如果影响一个表的任意子句中出现了NOWAIT，该表将按照NOWAIT处理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询不支持for update/share。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询不支持for update/share。 - **NLS_SORT** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/126-SELECT-INTO.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/126-SELECT-INTO.md index e7058d3a..78363f92 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/126-SELECT-INTO.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/126-SELECT-INTO.md @@ -64,14 +64,14 @@ new_table指定新建表的名称。 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > SELECT INTO的其它参数可参考SELECT的参数说明。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/127-SET.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/127-SET.md index eae68cc4..aa66bc7d 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/127-SET.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/127-SET.md @@ -101,7 +101,7 @@ date: 2021-05-18 可设置的运行时参数的名称。可用的运行时参数可以使用SHOW ALL命令查看。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 部分通过SHOW ALL查看的参数不能通过SET设置。如max_datanodes。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 部分通过SHOW ALL查看的参数不能通过SET设置。如max_datanodes。 - **value** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md index 1db8cb9a..b4b0c70e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/131-SET-TRANSACTION.md @@ -41,7 +41,7 @@ SetTransaction ::= { SET [ LOCAL ] TRANSACTION|SET SESSION CHARACTERISTICS AS TR 指定事务隔离级别，该参数决定当一个事务中存在其他并发运行事务时能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/134-START-TRANSACTION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/134-START-TRANSACTION.md index 512b4c4c..240bef1a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/134-START-TRANSACTION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/134-START-TRANSACTION.md @@ -51,7 +51,7 @@ Begin ::= BEGIN [ WORK | TRANSACTION ] 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/135-TRUNCATE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/135-TRUNCATE.md index d00febbb..8457f332 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/135-TRUNCATE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/135-TRUNCATE.md @@ -80,7 +80,7 @@ date: 2021-05-18 取值范围: 需要进行删除数据分区的分区键的取值范围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 使用PARTITION FOR子句时，partition_value所在的整个分区会被清空。 - **UPDATE GLOBAL INDEX** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/136-UPDATE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/136-UPDATE.md index 9632080b..46961522 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/136-UPDATE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/136-UPDATE.md @@ -90,7 +90,7 @@ sub_query ::= SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 - **condition** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/137-VACUUM.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/137-VACUUM.md index 8c899975..231c0f79 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/137-VACUUM.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/137-VACUUM.md @@ -57,7 +57,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 - **FREEZE** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md index 65445262..e6aca200 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/2-ALTER-DATABASE.md @@ -69,7 +69,7 @@ date: 2021-05-17 AlterDatabase ::= ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。 > - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，普通用户只能查看有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。 @@ -130,7 +130,7 @@ date: 2021-05-17 重置全部的数据库会话参数值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。 > - 修改的数据库会话参数值，将在下一次会话中生效。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/22-ALTER-TABLE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/22-ALTER-TABLE.md index 9422d65e..a9d49a62 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/22-ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/22-ALTER-TABLE.md @@ -72,7 +72,7 @@ date: 2021-05-17 | REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - **ADD table_constraint [ NOT VALID ]** 给表增加一个新的约束。 > - **ADD table_constraint_using_index** 根据已有唯一索引为表增加主键约束或唯一约束。 @@ -124,7 +124,7 @@ date: 2021-05-17 | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ … ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 > @@ -231,7 +231,7 @@ date: 2021-05-17 SET SCHEMA new_schema; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。 > - 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。 @@ -315,7 +315,7 @@ date: 2021-05-17 USING子句声明如何从旧的字段值里计算新的字段值；如果省略，缺省从旧类型向新类型的赋值转换。如果从旧数据类型到新类型没有隐含或者赋值的转换，则必须提供一个USING子句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话)，结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md index 564f986d..d636de54 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23-ALTER-TABLE-PARTITION.md @@ -73,7 +73,7 @@ date: 2021-05-17 - 普通表和分区表上不可以有动态数据脱敏，行访问控制约束。 - 列表分区表，哈希分区表不能是列存储。 - > **须知：** + > **须知**: > > - 完成交换后，普通表和分区的数据被置换，同时普通表和分区的表空间信息被置换。此时，普通表和分区的统计信息变得不可靠，需要对普通表和分区重新执行analyze。 > - 由于非分区键不能建立本地唯一索引，只能建立全局唯一索引，所以如果普通表含有唯一索引时，会导致不能交换数据。 @@ -109,7 +109,7 @@ date: 2021-05-17 split_point_clause ::= AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 列存分区表不支持切割分区。 > - 切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。 @@ -120,7 +120,7 @@ date: 2021-05-17 no_split_point_clause ::= INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。 > - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。 @@ -163,7 +163,7 @@ date: 2021-05-17 [ TABLESPACE tablespacename ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - partition_list_item仅支持的1个分区键，其支持的数据类型参见**PARTITION BY LIST(partit…**。 > - 间隔/哈希分区表不支持添加分区。 @@ -174,7 +174,7 @@ date: 2021-05-17 drop_clause ::= DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } [ UPDATE GLOBAL INDEX ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 哈希分区表不支持删除分区。 > - 列表分区表仅支持通过子分区名称删除子分区。 @@ -264,7 +264,7 @@ date: 2021-05-17 在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 - **partition_new_name** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23.1-ALTER-TABLE-SUBPARTITION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23.1-ALTER-TABLE-SUBPARTITION.md index 92798922..25721ad3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23.1-ALTER-TABLE-SUBPARTITION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/23.1-ALTER-TABLE-SUBPARTITION.md @@ -45,7 +45,7 @@ date: 2021-11-01 split_point_clause ::= AT ( subpartition_value ) INTO ( SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] , SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 切割点的大小要位于正在被切割的分区的分区键范围内。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md index e8780b8f..6638e9f3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/24-ALTER-TABLESPACE.md @@ -17,7 +17,7 @@ date: 2021-05-17 - 要修改表空间的所有者A为B，则A必须是B的直接或者间接成员。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 ## 语法格式 @@ -88,7 +88,7 @@ date: 2021-05-17 - random_page_cost：设置优化器计算一次非顺序获取磁盘页面的开销。缺省为4.0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - random_page_cost是相对于seq_page_cost的取值，等于或者小于seq_page_cost时毫无意义。 > - 默认值为4.0的前提条件是，优化器采用索引来扫描表数据，并且表数据在cache中命中率可以90%左右。 @@ -107,7 +107,7 @@ date: 2021-05-17 - 由space_size来确定，其格式参考[CREATE TABLESPACE](63-CREATE-TABLESPACE)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若调整后的限额值比当前表空间实际使用的值要小，调整操作可以执行成功，后续用户需要将该表空间的使用值降低到新限额值之下，才能继续往该表空间中写入数据。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md index d5e2277a..a2438be5 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/26-ALTER-TEXT-SEARCH-DICTIONARY.md @@ -57,7 +57,7 @@ date: 2021-05-17 要修改的参数名。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不支持修改词典的TEMPLATE参数值。 > - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/28-ALTER-TYPE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/28-ALTER-TYPE.md index 4bbc18aa..7d9c6e02 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/28-ALTER-TYPE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/28-ALTER-TYPE.md @@ -163,7 +163,7 @@ date: 2021-05-17 如果需联动更新类型是已更新类型的关联记录，则拒绝更新。这是缺省选项。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - ADD ATTRIBUTE、DROP ATTRIBUTE和ALTER ATTRIBUTE选项可以组合成一个列表同时处理。 例如，在一条命令中同时增加几个属性或是更改几个属性的类型是可以实现的。 > - 要修改一个类型的模式，必须在新模式上拥有CREATE权限。 要修改所有者，必须是新的所有角色的直接或间接成员， 并且该成员必须在此类型的模式上有CREATE权限。 （这些限制强制了修改所有者不会做任何通过删除和重建类型不能做的事情。 不过，系统管理员可以以任何方式修改任意类型的所有权。） 要增加一个属性或是修改一个属性的类型，也必须有该类型的USAGE权限。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md index 4be3ed5c..a422ef67 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/32-ANALYZE-ANALYSE.md @@ -39,7 +39,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 PARTITION ( patrition_name ) ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 - 收集多列统计信息。 @@ -48,7 +48,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 table_name (( column_1_name, column_2_name [, ...] )); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 收集多列统计信息时，请设置GUC参数default_statistics_target为负数，以使用百分比采样方式。 > - 每组多列统计信息最多支持32列。 @@ -60,7 +60,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - Fast模式校验时，需要对校验的表有并发的DML操作，会导致校验过程中有误报的问题，因为当前Fast模式是直接从磁盘上读取，并发有其他线程修改文件时，会导致获取的数据不准确，建议离线操作。 > - 支持对全库进行操作，由于涉及的表较多，建议以重定向保存结果**gsql -d database -p port -f “verify.sql”> verify_warning.txt 2>&1**。 @@ -74,7 +74,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持对普通表的操作和索引表的操作，但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表，当单独对索引表进行检测时，无需使用CASCADE模式。 > - 对于主表的检测会同步检测主表的内部表，例如toast表、cudesc表等。 @@ -86,7 +86,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 ## 参数说明 @@ -94,7 +94,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 启用显示进度信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 - **table_name** @@ -182,7 +182,7 @@ INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若环境若有故障，需查看数据库主节点的log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若环境若有故障，需查看数据库主节点的log。 - 删除表。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/34-CALL.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/34-CALL.md index 21957f8a..75092d6f 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/34-CALL.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/34-CALL.md @@ -43,7 +43,7 @@ Call ::= CALL [schema'.'|package'.'] {func_name| procedure_name} ( param_expr ); 取值范围: 已存在的函数参数名称或存储过程参数名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见示例。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md index 3620dec3..a4688eba 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/4-ALTER-DEFAULT-PRIVILEGES.md @@ -181,7 +181,7 @@ AlterDafaultPrivileges ::= ALTER DEFAULT PRIVILEGES 取值范围: 已存在的角色名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/41-COPY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/41-COPY.md index 08c59c3c..565d3ca8 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/41-COPY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/41-COPY.md @@ -45,7 +45,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 语法中的FIXED FORMATTER ( { column_name( offset, length ) } [, ...] )以及 [ ( option [, ...] ) | copy_option [ ...] ] 可以任意排列组合。 @@ -70,7 +70,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. COPY TO语法形式约束如下： > (query)与[USING] DELIMITER不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。 @@ -161,7 +161,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 打开字段固定长度模式。在字段固定长度模式下，不能声明DELIMITER，NULL，CSV选项。指定FIXED类型后，不能再通过option或copy_option指定BINARY、CSV、TEXT等类型。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 定长格式定义如下： > > 1. 每条记录的每个字段长度相同。 @@ -188,7 +188,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 仅支持导入（即COPY FROM）时指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 此容错选项的使用限制如下： > > - 此容错机制仅捕捉COPY FROM过程中数据库主节点上数据解析过程中相关的数据类型错误（DATA_EXCEPTION）。 @@ -213,7 +213,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：若未指定LOG ERRORS，则会报错；若指定LOG ERRORS，则默认为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如上述LOG ERRORS中描述的容错机制，REJECT LIMIT的计数也是按照执行COPY FROM的数据库主节点上遇到的解析错误数量计算，而不是数据库节点的错误数量。 - **FORMATTER** @@ -250,7 +250,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 指定数据文件行数据的字段分隔符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 分隔符不能是\\r和\\n。 > - 分隔符不能和null参数相同，CSV格式数据的分隔符不能和quote参数相同。 @@ -298,7 +298,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -316,7 +316,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\\r、\\n、\\r\\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式导入。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -354,7 +354,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果行尾换行符丢失，使两行变成一行时，设置此参数为true将导致后一行数据被忽略掉。 - COMPATIBLE_ILLEGAL_CHARS @@ -368,7 +368,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -388,7 +388,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考[时间和日期处理函数和操作符](8-date-and-time-processing-functions-and-operators)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT @@ -417,7 +417,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 用来指定数据文件中空值的表示。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以应该确保指定的字符串和COPY TO相同。 取值范围: @@ -442,7 +442,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 导出数据时用于定义标题行的文件，一般用来描述每一列的数据信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 仅在header为on或true的情况下有效。 > - fileheader指定的是绝对路径。 @@ -459,7 +459,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 - 当前事务中没有打开的游标。 - 当前事务中没有原有的快照。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - FORCE NOT NULL column_name [, …] @@ -488,7 +488,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -506,7 +506,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\\r、\\n、\\r\\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -536,7 +536,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 若不使用该参数，导入时遇到非法字符进行报错，中断导入。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -550,7 +550,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目前COPY指定此Option实际不会生效，即不会有相应的容错处理效果（不生效）。需要额外注意的是，打开此选项会导致解析器在数据库主节点数据解析阶段（即COPY错误表容错的涵盖范围）忽略此数据问题，而到数据库节点重新报错，从而使得COPY错误表（打开LOG ERRORS REJECT LIMIT）在此选项打开的情况下无法成功捕获这类少列的数据异常。因此请不要指定此选项。 - DATE_FORMAT 'date_format_string' @@ -559,7 +559,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考[时间和日期处理函数和操作符](8-date-and-time-processing-functions-and-operators)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT 'time_format_string' diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md index f13ee4b1..87622acd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/42-CREATE-CLIENT-MASTER-KEY.md @@ -45,7 +45,7 @@ CreateClientMasterKey ::= CREATE CLIENT MASTER KEY client_master_key_name WITH ( 由本语法创建的用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值范围: RSA_2048、RSA3072和SM2。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** **密钥存储路径：**默认情况下，localkms将在`$LOCALKMS_FILE_PATH`路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取`$LOCALKMS_FILE_PATH`失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub、key_path_value.pub.rand、 key_path_value.priv、 key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: **密钥存储路径：**默认情况下，localkms将在`$LOCALKMS_FILE_PATH`路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取`$LOCALKMS_FILE_PATH`失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub、key_path_value.pub.rand、 key_path_value.priv、 key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/43-CREATE-COLUMN-ENCRYPTION-KEY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/43-CREATE-COLUMN-ENCRYPTION-KEY.md index 4dc914ac..da0c80a3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/43-CREATE-COLUMN-ENCRYPTION-KEY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/43-CREATE-COLUMN-ENCRYPTION-KEY.md @@ -45,7 +45,7 @@ CreateColumnEncryption ::= CREATE COLUMN ENCRYPTION KEY column_encryption_key_na 该值为用户指定的密钥口令，密钥口令长度范围为28 ~ 256位，28位派生出来的密钥安全强度满足AES128，若用户需要用AES256，密钥口令的长度需要39位，如果不指定，则会自动生成256比特的密钥。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 国密算法约束：由于SM2、SM3、SM4等算法属于中国国家密码标准算法，为规避法律风险，需配套使用。即如果将CEK用于SM4_SM3算法，则仅能使用SM4算法来对该CEK进行加密。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 国密算法约束：由于SM2、SM3、SM4等算法属于中国国家密码标准算法，为规避法律风险，需配套使用。即如果将CEK用于SM4_SM3算法，则仅能使用SM4算法来对该CEK进行加密。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md index e77a621c..05b300d3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/44-CREATE-DATABASE.md @@ -108,7 +108,7 @@ CreateDatabase ::= CREATE DATABASE database_name > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为MogDB将无法帮助你转换或者校验非ASCII字符。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 > - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[]\^_`a-z{|}重叠。其中@[]^_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 @@ -132,7 +132,7 @@ CreateDatabase ::= CREATE DATABASE database_name 指定兼容的数据库的类型。取值范围: A、B、C、PG。分别表示兼容Oracle、MySQL、Teradata和PostgreSQL。但是C目前已经放弃支持，因此常用的取值是A、B、PG，默认兼容A。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 > - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 @@ -148,7 +148,7 @@ CreateDatabase ::= CREATE DATABASE database_name 数据库可以接受的并发连接数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/47-CREATE-FOREIGN-TABLE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/47-CREATE-FOREIGN-TABLE.md index 4b6f2d21..9f4b15dc 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/47-CREATE-FOREIGN-TABLE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/47-CREATE-FOREIGN-TABLE.md @@ -140,7 +140,7 @@ column_constraint ::= [ CONSTRAINT constraint_name ] 这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是， 文件级别null选项）。与COPY的 FORCE_NOT_NULL选项里的字段相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 更多使用说明请参见[file_fdw](file_fdw)、[oracle_fdw](1-oracle_fdw)、[mysql_fdw](2-mysql_fdw)、[postgres_fdw](3-postgres_fdw)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 更多使用说明请参见[file_fdw](file_fdw)、[oracle_fdw](1-oracle_fdw)、[mysql_fdw](2-mysql_fdw)、[postgres_fdw](3-postgres_fdw)。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md index a77ef2b3..b84d1b83 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/48-CREATE-FUNCTION.md @@ -106,7 +106,7 @@ date: 2021-05-10 取值范围: IN、OUT、INOUT或VARIADIC。缺省值是IN。并且OUT和INOUT模式的参数不能用在RETURNS TABLE的函数定义中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: VARIADIC用于声明数组类型的参数。 - **argtype** @@ -150,7 +150,7 @@ date: 2021-05-10 表示该函数是窗口函数。替换函数定义时不能改变WINDOW属性。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 - **IMMUTABLE** @@ -252,7 +252,7 @@ date: 2021-05-10 PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/50-CREATE-INDEX.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/50-CREATE-INDEX.md index b8ea6724..05b37c30 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/50-CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/50-CREATE-INDEX.md @@ -67,7 +67,7 @@ date: 2021-05-10 - 普通CREATE INDEX命令可以在事务内执行，但是CREATE INDEX CONCURRENTLY不可以在事务内执行。 - 列存表、分区表和临时表不支持CONCURRENTLY方式创建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > - 由于需要执行两次对表的扫描和build，而且必须等待现有的所有可能对该表执行修改的事务结束。这意味着该索引的创建比正常耗时更长，同时因此带来的CPU和I/O消耗对其他业务也会造成影响。 @@ -111,7 +111,7 @@ date: 2021-05-10 行存表（ASTORE存储引擎）支持的索引类型：btree（行存表缺省值）、hash、gin、gist。行存表（USTORE存储引擎）支持的索引类型：ubtree。列存表支持的索引类型：Psort（列存表缺省值）、btree、gin。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 - **column_name** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md index 03a330df..11fda99b 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/52-CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -91,7 +91,7 @@ CreateRowLevelSecurityPolicy ::= CREATE [ ROW LEVEL SECURITY ] POLICY policy_nam 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 系统管理员不受行访问控制特性影响。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 系统管理员不受行访问控制特性影响。 - **using_expression** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md index 01036ab5..2e863a47 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53-CREATE-PROCEDURE.md @@ -58,7 +58,7 @@ plsql_body 参数的模式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: VARIADIC用于声明数组类型的参数。 取值范围: IN、OUT、INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。 @@ -98,9 +98,9 @@ plsql_body PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: argument_name和argmode的顺序没有严格要求，推荐按照argument_name、argmode、argument_type的顺序使用。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53.2-CREATE-RESOURCE-POOL.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53.2-CREATE-RESOURCE-POOL.md index 211b8f52..f4df4edc 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53.2-CREATE-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/53.2-CREATE-RESOURCE-POOL.md @@ -36,7 +36,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 控制组名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置控制组名称时，语法可以使用双引号，也可以使用单引号。 > - group_name对大小写敏感。 @@ -72,7 +72,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 在普通场景下，普通用户的mem_percent范围为0-100，默认值为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** mem_percent和memory_limit同时指定时，只有mem_percent起作用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: mem_percent和memory_limit同时指定时，只有mem_percent起作用。 - **io_limits** @@ -86,7 +86,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 包括三档可选：Low、Medium和High。不控制时可设置为None。默认为None。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT、COPY FROM、CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT、COPY FROM、CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 - **nodegroup** @@ -98,7 +98,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 在逻辑集群模式下，指定当前资源池用于控制没有关联本逻辑集群的普通用户的资源。这里的逻辑集群是由资源池nodegroup字段指定的。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - nodegroup必须是存在的逻辑集群，不能是elastic_group和安装的nodegroup (group_version1)。 > - 如果指定了is_foreign为true，则资源池不能再关联用户，即不允许通过CREATE USER … RESOURCE POOL语句来将该资源池配置给用户。该资源池自动检查用户是否关联到资源池指定的逻辑集群，如果用户没有关联到该逻辑集群，则这些用户在逻辑集群所包含的DN上运行将受到该资源池的资源控制。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/54-CREATE-ROLE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/54-CREATE-ROLE.md index 4621d638..c4b509f4 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/54-CREATE-ROLE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/54-CREATE-ROLE.md @@ -67,7 +67,7 @@ option ::= {SYSADMIN | NOSYSADMIN} 取值范围: 字符串，要符合标识符的命名规范，且最多为63个字符。若超过63个字符，数据库会截断并保留前63个字符当做角色名称。在创建角色时，数据库的时候会给出提示信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 - **password** @@ -157,7 +157,7 @@ option ::= {SYSADMIN | NOSYSADMIN} 声明该角色可以使用的并发连接数量。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md index 43f32930..0641ae11 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/56-CREATE-SCHEMA.md @@ -41,7 +41,7 @@ date: 2021-05-10 模式名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 模式名不能和当前数据库里其他的模式重名。 > 模式的名称不可以“pg_”开头。 @@ -63,7 +63,7 @@ date: 2021-05-10 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md index 3e80288e..e724030a 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/57-CREATE-SEQUENCE.md @@ -58,7 +58,7 @@ CreateSequence ::= CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为1，表示一次只能生成一个值，也就是没有缓存。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 不建议同时定义cache和maxvalue或minvalue。因为定义cache后不能保证序列的连续性，可能会产生空洞，造成序列号段浪费。 - **CYCLE** @@ -79,7 +79,7 @@ CreateSequence ::= CREATE SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为OWNED BY NONE，表示不存在这样的关联。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过OWNED BY创建的Sequence不建议用于其他表，如果希望多个表共享Sequence，该Sequence不应该从属于特定表。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md index e946e50a..7a638611 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/59-CREATE-SYNONYM.md @@ -41,7 +41,7 @@ CreateSynonym ::= CREATE [ OR REPLACE ] SYNONYM synonym_name 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > object_name可以是不存在的对象名称。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/6-ALTER-FOREIGN-TABLE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/6-ALTER-FOREIGN-TABLE.md index fb1c04bf..4f4293dc 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/6-ALTER-FOREIGN-TABLE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/6-ALTER-FOREIGN-TABLE.md @@ -107,7 +107,7 @@ AlterForeignTable ::= ALTER FOREIGN TABLE [ IF EXISTS ] table_name 这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是， 文件级别null选项）。与COPY的 FORCE_NOT_NULL选项里的字段相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** file_fdw更多使用请参见[file_fdw](file_fdw)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: file_fdw更多使用请参见[file_fdw](file_fdw)。 - **value** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/60-CREATE-TABLE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/60-CREATE-TABLE.md index 18d387d9..35902d28 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/60-CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/60-CREATE-TABLE.md @@ -111,7 +111,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 @@ -164,7 +164,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）会复制到新表中。默认情况下，不复制源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果源表包含serial、bigserial、smallserial类型，或者源表字段的默认值是sequence，且sequence属于源表（通过CREATE SEQUENCE … OWNED BY创建），这些Sequence不会关联到新表中，新表中会重新创建属于自己的sequence。这和之前版本的处理逻辑不同。如果用户希望源表和新表共享Sequence，需要首先创建一个共享的Sequence（避免使用OWNED BY），并配置为源表字段默认值，这样创建的新表会和源表共享该Sequence。 > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 @@ -174,7 +174,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 这个子句为表或索引指定一个可选的存储参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 参数的详细描述如下所示。 @@ -314,7 +314,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 - **DEFAULT default_expr** @@ -1034,7 +1034,7 @@ mogdb=# DROP SCHEMA IF EXISTS joe CASCADE; - 如果指定了INCLUDING PARTITION，则源表的分区定义会复制到新表中，同时新表将不能再使用PARTITION BY子句。默认情况下，不拷贝源表的分区定义。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 - LIKE INCLUDING RELOPTIONS diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md index 88c5e9de..b360f1ac 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/61-CREATE-TABLE-AS.md @@ -54,7 +54,7 @@ CreateTableAs ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md index 0fbc4c77..a93877e6 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62-CREATE-TABLE-PARTITION.md @@ -196,7 +196,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -237,19 +237,19 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name （1）对于从句是VALUES LESS THAN的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、CHARACTER VARYING(n)、VARCHAR(n)、CHARACTER(n)、CHAR(n)、CHARACTER、CHAR、TEXT、NVARCHAR2、NAME、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （2）对于从句是START END的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （3）对于指定了INTERVAL子句的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 @@ -257,7 +257,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 指定各分区的信息。partition_name为范围分区的名称。partition_value为范围分区的上边界，取值依赖于partition_key的类型。MAXVALUE表示分区的上边界，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 每个分区都需要指定一个上边界。 > - 分区上边界的类型应当和分区键的类型一致。 @@ -274,7 +274,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_value：对[START，END) 表示的范围进行切分，interval_value是指定切分后每个分区的宽度，不可是MAXVALUE；如果（END-START）值不能整除以EVERY值，则仅最后一个分区的宽度小于EVERY值。 - MAXVALUE：表示最大值，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 1. 在创建分区表若第一个分区定义含START值，则范围（MINVALUE，START）将自动作为实际的第一个分区。 > 2. START END语法需要遵循以下限制： @@ -294,7 +294,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - STORE IN (tablespace_name [, … ] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列存表不支持间隔分区。 - **PARTITION BY LIST(partition_key)** @@ -324,7 +324,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ENABLE（缺省值）：行迁移开关打开。 - DISABLE：行迁移开关关闭。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持ROW MOVEMENT。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持ROW MOVEMENT。 - **NOT NULL** @@ -356,7 +356,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 该子句将字段创建为生成列，生成列的值在写入（插入或更新）数据时由generation_expr计算得到，STORED表示像普通列一样存储生成列的值。 - >**说明：** + >**说明**: > >- 生成表达式不能以任何方式引用当前行以外的其他数据。生成表达式不能引用其他生成列，不能引用系统列。生成表达式不能返回结果集，不能使用子查询，不能使用聚集函数，不能使用窗口函数。生成表达式调用的函数只能是不可变（IMMUTABLE）函数。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62.1-CREATE-TABLE-SUBPARTITION.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62.1-CREATE-TABLE-SUBPARTITION.md index b84b77c8..c2897399 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62.1-CREATE-TABLE-SUBPARTITION.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/62.1-CREATE-TABLE-SUBPARTITION.md @@ -148,7 +148,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -234,7 +234,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 该子句将字段创建为生成列，生成列的值在写入（插入或更新）数据时由generation_expr计算得到，STORED表示像普通列一样存储生成列的值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 生成表达式不能以任何方式引用当前行以外的其他数据。生成表达式不能引用其他生成列，不能引用系统列。生成表达式不能返回结果集，不能使用子查询，不能使用聚集函数，不能使用窗口函数。生成表达式调用的函数只能是不可变（IMMUTABLE）函数。 > - 不能为生成列指定默认值。 @@ -325,7 +325,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + drop table list_list; CREATE TABLE list_hash ( @@ -363,7 +363,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 3 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + drop table list_hash; CREATE TABLE list_range ( @@ -401,7 +401,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 2 | 1 | 1 201902 | 3 | 1 | 1 (5 rows) - + drop table list_range; CREATE TABLE range_list ( @@ -439,7 +439,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (6 rows) - + drop table range_list; CREATE TABLE range_hash ( @@ -477,7 +477,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (6 rows) - + drop table range_hash; CREATE TABLE range_range ( @@ -515,10 +515,10 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (6 rows) - + drop table range_range; ``` - + - 示例2：对二级分区表进行truncate操作 ```sql @@ -558,7 +558,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -566,13 +566,13 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (3 rows) - + alter table list_list truncate partition p_201901; select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list partition (p_201902); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -580,18 +580,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (3 rows) - + alter table list_list truncate partition p_201902; select * from list_list partition (p_201902); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list; month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + insert into list_list values('201902', '1', '1', 1); insert into list_list values('201902', '2', '1', 1); insert into list_list values('201902', '1', '1', 1); @@ -604,58 +604,58 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + alter table list_list truncate subpartition p_201901_a; select * from list_list subpartition (p_201901_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + alter table list_list truncate subpartition p_201901_b; select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + alter table list_list truncate subpartition p_201902_a; select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + alter table list_list truncate subpartition p_201902_b; select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list; month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + drop table list_list; ``` - + - 示例3：对二级分区表进行split操作 ```sql @@ -695,20 +695,20 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + select * from list_list subpartition (p_201901_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + alter table list_list split subpartition p_201901_b values (2) into ( subpartition p_201901_b, @@ -720,18 +720,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201901_c); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -739,20 +739,20 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (3 rows) - + select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + alter table list_list split subpartition p_201902_b values (3) into ( subpartition p_201902_b, @@ -763,18 +763,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_c); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + drop table list_list; ``` diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md index 778b2837..e2bd1326 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/65-CREATE-TEXT-SEARCH-DICTIONARY.md @@ -136,7 +136,7 @@ CreateTextSearchDictionary ::= CREATE TEXT SEARCH DICTIONARY name ( 词典定义文件所在目录。可以指定为本地目录或者OBS目录（只能在安全模式下指定OBS目录，通过启动时添加securitymode选项进入安全模式）。其中，本地目录格式为”file://absolute_path”，OBS目录格式为”obs://bucket_name/path accesskey=ak secretkey=sk region=rg”。默认值为预定义词典文件所在目录。FILEPATH参数必须和STOPWORDS参数同时指定，不允许单独指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 词典定义文件的文件名仅支持小写字母、数据、下划线混合。 - **value** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md index c60fd1d2..a6c6b341 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/66-CREATE-TRIGGER.md @@ -127,7 +127,7 @@ CreateTrigger ::= CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | 执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关于触发器种类： > > - INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/67-CREATE-TYPE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/67-CREATE-TYPE.md index 2581c37a..a9d92e6f 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/67-CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/67-CREATE-TYPE.md @@ -113,7 +113,7 @@ CreateType ::= CREATE TYPE name AS ENUM 输入函数必须返回一个该数据类型本身的值。通常，一个输入函数应该被声明为STRICT。 如果不是这样，在读到一个NULL输入值时，调用输入函数时第一个参数会是NULL。在这种情况下，该函数必须仍然返回NULL，除非调用函数发生了错误（这种情况主要是想支持域输入函数，域输入函数可能需要拒绝NULL输入）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 输入和输出函数能被声明为具有新类型的结果或参数是因为：必须在创建新类型之前创建这两个函数。而新类型应该首先被定义为一种shell type，它是一种占位符类型，除了名称和拥有者之外它没有其他属性。这可以通过不带额外参数的命令CREATE TYPE name做到。然后用C写的I/O函数可以被定义为引用这种shell type。最后，用带有完整定义的CREATE TYPE把该shell type替换为一个完全的、合法的类型定义，之后新类型就可以正常使用了。 - **output_function** @@ -149,7 +149,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。将类型的修饰符的内部形式转换为外部文本形式的函数名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果该类型支持修饰符（附加在类型声明上的可选约束，例如，char(5)或numeric(30,2)），则需要可选的type_modifier_input_function以及type_modifier_output_function。MogDB允许用户定义的类型有一个或者多个简单常量或者标识符作为修饰符。不过，为了存储在系统目录中，该信息必须能被打包到一个非负整数值中。所声明的修饰符会被以cstring数组的形式传递给type_modifier_input_function。 type_modifier_input_function必须检查该值的合法性（如果值错误就抛出一个错误），如果值正确，要返回一个非负integer值，该值将被存储在“typmod”列中。如果类型没有 type_modifier_input_function则类型修饰符将被拒绝。type_modifier_output_function把内部的整数typmod值转换回正确的形式用于用户显示。type_modifier_output_function必须返回一个cstring值，该值就是追加到类型名称后的字符串。例如，numeric的函数可能会返回(30,2)。如果默认的显示格式就是只把存储的typmod整数值放在圆括号内，则允许省略type_modifier_output_function。 - **analyze_function** @@ -204,7 +204,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。如果这种类型是其类型分类中的优先类型则为TRUE，否则为FALSE。默认为假。在一个现有类型分类中创建一种新的优先类型要非常谨慎， 因为这可能会导致很大的改变。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > category和preferred参数可以被用来帮助控制在混淆的情况下应用哪一种隐式造型。每一种数据类型都属于一个用单个ASCII 字符命名的分类，并且每一种类型可以是其所属分类中的“首选”。当有助于解决重载函数或操作符时，解析器将优先造型到首选类型（但是只能从同类的其他类型造型）。对于没有隐式转换到或来自任意其他类型的类型，让这些设置保持默认即可。不过，对于有隐式转换的相关类型的组，把它们都标记为属于同一个类别并且选择一种或两种“最常用”的类型作为该类别的首选通常是很有用的。在把一种用户定义的类型增加到一个现有的内建类别（例如，数字或者字符串类型）中时，category参数特别有用。不过，也可以创建新的全部是用户定义类型的类别。对这样的类别，可选择除大写字母之外的任何ASCII 字符。 - **default** @@ -233,7 +233,7 @@ CreateType ::= CREATE TYPE name AS ENUM 可选参数。与枚举类型的一个值相关的文本标签，其值为长度不超过63个字符的非空字符串。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在创建用户定义类型的时候， MogDB会自动创建一个与之关联的数组类型，其名称由该元素类型的名称前缀一个下划线组成。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/69-CREATE-USER-MAPPING.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/69-CREATE-USER-MAPPING.md index 431654fd..71f54430 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/69-CREATE-USER-MAPPING.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/69-CREATE-USER-MAPPING.md @@ -37,7 +37,7 @@ CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER 这个子句指定用户映射的选项。这些选项通常定义该映射实际的用户名和口令。选项名必须唯一。允许的选项名和值与该服务器的外部数据包装器有关。 - >**说明：** + >**说明**: > >- 用户的口令会加密后保存到系统表[PG_USER_MAPPING](PG_USER_MAPPING)中，加密时需要使用usermapping.key.cipher和usermapping.key.rand作为加密密码文件和加密因子。首次使用前需要通过如下命令创建这两个文件，并将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。gs_ssh工具可以协助您快速将文件放入各节点对应目录下。 > @@ -77,7 +77,7 @@ CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER 远端MogDB用户对应的密码。 - > **说明：** + > **说明**: > MogDB在后台会对用户输入的password加密以保证安全性。该加密所需密钥文件需要使用gs_guc工具生成并使用gs_ssh工具发布到MogDB每个节点的`$GAUSSHOME/bin`目录下。password不应当包含'encryptOpt'前缀，否则会被认为是加密后的密文。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/70-CREATE-VIEW.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/70-CREATE-VIEW.md index b282c8ea..861dbf53 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/70-CREATE-VIEW.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/70-CREATE-VIEW.md @@ -23,7 +23,7 @@ CreateView ::= CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( col AS query; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建视图时使用WITH(security_barriers)可以创建一个相对安全的视图，避免攻击者利用低成本函数的RAISE语句打印出隐藏的基表数据。 > - 旧版MogDB在create or replace创建视图的时候，如果存在同名视图，则replace时不可以更改列信息或者删除列，只能追加列。2.1版之后的MogDB支持REPLACE VIEW语法更新或者删除列信息。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md index 9698ee8b..6e569e9b 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/76-DROP-CLIENT-MASTER-KEY.md @@ -38,7 +38,7 @@ DropClientMasterKey ::= DROP CLIENT MASTER KEY [ IF EXISTS ] client_master_key_n - **CASCADE**：表示允许级联删除依赖于客户端加密主密钥的对象。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 ## **示例** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/78-DROP-DATABASE.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/78-DROP-DATABASE.md index 78a9bd94..16b47365 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/78-DROP-DATABASE.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/78-DROP-DATABASE.md @@ -19,7 +19,7 @@ date: 2021-05-10 - 不能在事务块中执行DROP DATABASE命令。 - 如果执行DROP DATABASE失败，事务回滚，需要再次执行一次DROP DATABASE IF EXISTS。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DROP DATABASE一旦执行将无法撤销，请谨慎使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DROP DATABASE一旦执行将无法撤销，请谨慎使用。 ## 语法格式 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/86.2-DROP-RESOURCE-POOL.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/86.2-DROP-RESOURCE-POOL.md index 74b5510d..6b6f1f31 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/86.2-DROP-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/86.2-DROP-RESOURCE-POOL.md @@ -11,7 +11,7 @@ date: 2021-11-01 删除一个资源池。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果某个角色已关联到该资源池，无法删除。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果某个角色已关联到该资源池，无法删除。 ## 注意事项 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/9-ALTER-INDEX.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/9-ALTER-INDEX.md index 51559d97..d9c85e95 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/9-ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/9-ALTER-INDEX.md @@ -90,7 +90,7 @@ ALTER INDEX用于修改现有索引的定义。 [ MODIFY PARTITION index_partition_name ] UNUSABLE; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表不支持该语法。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表不支持该语法。 - 重建表索引或索引分区。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md index d4ce5925..ae54502c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/sql-syntax/91-DROP-SCHEMA.md @@ -38,9 +38,9 @@ DropSchema ::= DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRIC - CASCADE：自动删除包含在模式中的对象。 - RESTRICT：如果模式包含任何对象，则删除失败（缺省行为）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/13-HLL.md b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/13-HLL.md index 1878adb1..a7dad4b8 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/13-HLL.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/13-HLL.md @@ -22,7 +22,7 @@ HLL与其他算法的比较请参见[表1](#biao11)。 HLL在计算速度和所占存储空间上都占优势。在时间复杂度上，Sort算法需要排序至少O(nlogn)的时间，虽说Hash算法和HLL一样扫描一次全表O(n)的时间就可以得出结果，但是存储空间上，Sort算法和Hash算法都需要先把原始数据存起来再进行统计，会导致存储空间消耗巨大，而对HLL来说不需要存原始数据，只需要维护HLL数据结构，故占用空间有很大的压缩，默认规格下HLL数据结构的最大空间约为16KB。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当前默认规格下可计算最大distinct值的数量约为1.1e+15个，误差率为0.8%。用户应注意如果计算结果超过当前规格下distinct最大值会导致计算结果误差率变大，或导致计算结果失败并报错。 > - 用户在首次使用该特性时，应该对业务的distinct value做评估，选取适当的配置参数并做验证，以确保精度符合要求： @@ -39,7 +39,7 @@ HLL中主要的数据结构，请参见[表2](#hyper)。 创建HLL数据类型时，可以支持0~4个参数入参，具体的参数含义与参数规格同函数hll_empty一致。第一个参数为log2m，表示分桶数的对数值，取值范围10~16；第二个参数为log2explicit，表示Explicit模式的阈值大小，取值范围0~12；第三个参数为log2sparse，表示Sparse模式的阈值大小，取值范围0~14；第四个参数为duplicatecheck，表示是否启用duplicatecheck，取值范围为0~1。当入参输入值为-1时，会采用默认值设定HLL的参数。可以通过\d或\d+查看HLL类型的参数。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 创建HLL数据类型时，根据入参的行为不同，结果不同： > @@ -79,7 +79,7 @@ mogdb=# create table t4(id int, set hll(5,-1)); ERROR: log2m = 5 is out of range, it should be in range 10 to 16, or set -1 as default ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 对含有HLL类型的表插入HLL对象时，HLL类型的设定参数须同插入对象的设定参数一致，否则报错。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/17-xml-type.md b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/17-xml-type.md index 84dfee7f..c1699bed 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/17-xml-type.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/17-xml-type.md @@ -27,7 +27,7 @@ xmlconcat (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该功能默认未开启，如需使用，需要重新使用build.sh脚本编译数据库，修改./configure配置参数，在其中加入-with-libxml参数。 > - 在执行编译之前，需要先执行yum install -y libxml2-devel，否则会有”configure: error: library 'xml2' (version >= 2.6.23) is required for XML support”的报错。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/5-binary-data-types.md b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/5-binary-data-types.md index 3321a1d7..7482f956 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/5-binary-data-types.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/supported-data-types/5-binary-data-types.md @@ -21,7 +21,7 @@ MogDB支持的二进制类型请参见[表1](#biao1)。 | _BYTEAWITHOUTORDERWITHEQUALCOL | 变长的二进制字符串，密态特性新增的类型 | 4字节加上实际的二进制字符串。最大为1GB减去53字节（即1073741771字节）。 | | _BYTEAWITHOUTORDERCOL | 变长的二进制字符串，密态特性新增的类型 | 4字节加上实际的二进制字符串。最大为1GB减去53字节（即1073741771字节）。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-8203字节（即1073733621字节）。 > - 不支持直接使用BYTEAWITHOUTORDERWITHEQUALCOL和BYTEAWITHOUTORDERCOL，_BYTEAWITHOUTORDERWITHEQUALCOL，_BYTEAWITHOUTORDERCOL类型创建表。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md b/product/zh/docs-mogdb/v2.1/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md index 43fddeaa..85ddd143 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md @@ -15,7 +15,7 @@ date: 2021-04-19 用户可以删除后重新创建这些表、增加列、插入和更新数值，但是用户修改系统表会导致系统信息的不一致，从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图，或者手工重命名系统表或系统视图所在的模式，而是由SQL语句关联的系统表操作自动维护系统表信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 用户应该禁止对系统表进行增删改等操作，人为对系统表的修改或破坏可能会导致系统各种异常情况甚至MogDB不可用。 ## 支持updatable-views @@ -45,7 +45,7 @@ date: 2021-04-19 + 多表连接的视图做DML的时候必须存在不少于1张带有唯一键或者主键的基表 + 多表连接的视图上的任何INSERT、UPDATE或DELETE操作一次只能修改一个基表 - + ## 示例 ### INSERT VIEW @@ -59,10 +59,10 @@ INSERT INTO table1 VALUES(3, reverse('HHiiw6'), 'Hiw6', '23fdsg'); CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; -INSERT INTO test_view VALUES(4, '2sdafd', '23ata', 'dstsee'); +INSERT INTO test_view VALUES(4, '2sdafd', '23ata', 'dstsee'); SELECT * FROM table1 WHERE id = 4; - id | a | b | c + id | a | b | c ----+--------+-------+-------- 4 | 2sdafd | 23ata | dstsee (1 row) @@ -84,7 +84,7 @@ CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; UPDATE test_view SET a = '2222' WHERE id = 2; SELECT * FROM table1; - id | a | b | c + id | a | b | c ----+--------+--------+-------- 1 | 87A321 | 123A78 | 1sdfBB 3 | 6wiiHH | Hiw6 | 23fdsg @@ -106,14 +106,14 @@ INSERT INTO table1 VALUES(3, reverse('HHiiw6'), 'Hiw6', '23fdsg'); CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; -DELETE FROM test_view WHERE id = 2; +DELETE FROM test_view WHERE id = 2; SELECT * FROM table1 WHERE id > 1; - id | a | b | c + id | a | b | c ----+--------+------+-------- 3 | 6wiiHH | Hiw6 | 23fdsg (1 row) DROP VIEW IF EXISTS test_view; DROP TABLE IF EXISTS table1; -``` \ No newline at end of file +``` diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/FAQ.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/FAQ.md index 11474752..b2f55aea 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/FAQ.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/FAQ.md @@ -78,7 +78,7 @@ read cipher file or random parameter file failed. gs_ctl build -D data_dir ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若备机数据库已停止，需要重新生成证书文件或者复制证书文件（$GAUSSHOME/share下的证书文件）到数据目录，启动备机并重建备实例。生成证书文件的相关操作请参见《开发者指南》。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若备机数据库已停止，需要重新生成证书文件或者复制证书文件（$GAUSSHOME/share下的证书文件）到数据目录，启动备机并重建备实例。生成证书文件的相关操作请参见《开发者指南》。 ## 使用gs_om -t status --all查询集群状态，长时间没有响应 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/client-tool.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/client-tool.md index a222e142..7a944b70 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/client-tool.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/client-tool.md @@ -19,7 +19,7 @@ gsql是MogDB提供在命令行下运行的数据库连接工具，可以通过 - **连接数据库：**详细操作请参见《管理指南》中“日常运维 > [gsql客户端连接](using-the-gsql-client-for-connection)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 - **执行SQL语句：**支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 @@ -58,7 +58,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql预定义了一些特殊变量，同时也规划了变量的取值。为了保证和后续版本最大限度地兼容，请避免以其他目的使用这些变量。所有特殊变量见[表2](#teshubian)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 所有特殊变量都由大写字母、数字和下划线组成。 > - 要查看特殊变量的默认值，请使用元命令`\echo : _varname_`（例如`\echo :DBNAME`）。 @@ -98,7 +98,7 @@ gsql的高级特性如[表1](#gsql)所示。 执行以上命令，将会查询HR.areaS表。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 - 提示符 @@ -164,7 +164,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 示例1，使用omm用户连接到本机mogdb数据库的15400端口。 @@ -535,7 +535,7 @@ omm@[local] mogdb=# 元命令的详细说明请参见下表。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 **表 11** 一般的元命令 @@ -570,7 +570,7 @@ omm@[local] mogdb=# | \\o [FILE] | 把所有的查询结果发送到文件里。 | | \\qecho [STRING] | 把字符串写到查询结果输出流里。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 **表 14** 显示信息元命令 @@ -786,7 +786,7 @@ omm@[local] mogdb=# 数据库由于安全问题，禁止远程登录时使用trust模式。这时需要修改pg_hba.conf里的连接认证信息。具体的设置信息请参见：《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 - 连接数据库，添加“-h 127.0.0.1”可以连接，去掉后无法连接问题。 @@ -839,7 +839,7 @@ omm@[local] mogdb=# GRANT CONNECT ON DATABASE mogdb TO user1; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 > > ```bash > gsql -d mogdb -p 15400 @@ -925,7 +925,7 @@ omm@[local] mogdb=# 目标数据库主节点的pg_hba.conf里配置了当前客户端IP使用”gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到”sha256”后再试。配置方法见《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。 > - 建议业务应用部署在MogDB之外，而非MogDB内部。 @@ -938,4 +938,4 @@ omm@[local] mogdb=# 解决此问题，重试便可。同时请尽可能避免在升级等运维操作过程中，在MogDB内部运行业务程序，避免升级时因替换文件产生此问题。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/0-gs_cgroup.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/0-gs_cgroup.md index cb54bcbe..25c7bff3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/0-gs_cgroup.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/0-gs_cgroup.md @@ -51,7 +51,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 删除当前用户已建的`class1`Cgroups。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果删除Class控制组，则Workload控制组也被删除。 3. 更新已创建控制组的资源配额。 @@ -80,7 +80,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 更新Gaussdb进程使用的CPU核数为0-20。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > -f参数只适用于对Gaussdb设置核数范围。对于其他各控制组，如需设置核数范围，需要使用-fixed参数。 5. 设置异常处理信息（class:wg组需存在）。 @@ -109,7 +109,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup -S class -E "qualificationtime=2400,cpuskewpercnt=90" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 给控制组设置异常处理信息，需要确保对应的控制组已经创建。指定多个阈值时用“，”分隔，不指定任何动作时默认为“penalty”操作。 6. 设置控制组使用的核数范围。 @@ -120,7 +120,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup -S class -G wg -g 20 --fixed -u ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > Class或Workload核数范围必须通过指定-fixed参数设置。 7. 回退上一个步骤。 @@ -129,7 +129,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup --recover ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > -recover只支持对Class控制组和Workload控制组的增删改操作进行回退，且只支持回退一次操作。 8. 查看已创建的控制组信息。 @@ -405,7 +405,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 取值范围: 字符串，最长为32个字符。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 对于磁盘major:minor的编号获取，可以通过下面方式。如获取/mpp目录对应的磁盘编号： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 对于磁盘major:minor的编号获取，可以通过下面方式。如获取/mpp目录对应的磁盘编号： > > ```bash > df @@ -421,4 +421,4 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 > brw-rw---- 1 root disk 8, 48 Feb 26 11:20 /dev/sdd > ``` > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这里一定要查sdd的磁盘号，不能是sdd1的磁盘号。否则执行时会报错。 如果更新IO的限额配置信息超过了可允许的最大配置字串，则新的更新不存储在配置文件中。如当前设置的字串长度为96，更新IO的磁盘数量大于8个，则有可能超出字串限制，更新成功，但是不存储在配置文件中。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这里一定要查sdd的磁盘号，不能是sdd1的磁盘号。否则执行时会报错。 如果更新IO的限额配置信息超过了可允许的最大配置字串，则新的更新不存储在配置文件中。如当前设置的字串长度为96，更新IO的磁盘数量大于8个，则有可能超出字串限制，更新成功，但是不存储在配置文件中。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/1-gs_check.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/1-gs_check.md index 5d299333..f24f962c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/1-gs_check.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/1-gs_check.md @@ -835,7 +835,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** CheckNetSpeed检查项： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: CheckNetSpeed检查项： > > - CheckNetSpeed不支持-L本地检查模式，-L模式无法构造网络压力，检查的结果不准确。 > - 在节点数小于6时，speed_test构造的网络压力可能无法跑满带宽，可能会造成检查结果不准确。 @@ -869,7 +869,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 scp scene_upgrade.xml SIA1000068994：home/package/script/gspylib/inspection/config/ ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 5. 换至omm用户，执行以下命令查看检查结果。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md index 3bdccb40..ee75adb1 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/2-gs_checkos.md @@ -45,7 +45,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 取值范围: A1…A14、B1…B8。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 详细的检查项请参见[表1](#gs_checkos)。 @@ -53,7 +53,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 主机名称列表文件。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称的列表。 @@ -118,7 +118,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 | B7 | 设置欧拉系统属性（Set RemoveIPC value） | 欧拉系统属性检查：检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service，/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no，当不为no时，对其进行修改设置。 | | B8 | 设置sshd服务应用pam模块（Set Session Process） | 远程设备继承系统默认资源：修改/etc/pam.d/sshd服务文件，添加配置项session required pam_limits.so，来控制用户使用的资源。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A6选项检查标准来自配置文件check_list.conf下[/etc/sysctl.conf]、[SUGGEST:/etc/sysctl.conf]域： 若[/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Abnormal，可以使用B1参数进行设置。 若[SUGGEST:/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Warning，B1参数不会进行设置，需根据实际情况进行手动设置。 > - A7选项检查系统文件句柄标准来自配置文件check_list.conf下[/etc/security/limits.conf]域open file参数，可以使用B2参数进行设置。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/4-gs_collector.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/4-gs_collector.md index ef9b557a..2fcba5f3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/4-gs_collector.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/4-gs_collector.md @@ -60,7 +60,7 @@ date: 2021-06-07 主机名称列表文件。该文件为纯文本格式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称列表。 @@ -97,7 +97,7 @@ date: 2021-06-07 } ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: TypeName和对应的Content取值范围见表1gs_collector内容收集对照表。 对于Log、CoreDump、Config和XLog四种类型，Interval和Count参数不生效。 @@ -120,7 +120,7 @@ date: 2021-06-07 若关键字KEYWORD中含有空格，需要使用双引号包围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 - -begin-time diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/5-gs_dump.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/5-gs_dump.md index b11ae09e..9fcacb37 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/5-gs_dump.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/5-gs_dump.md @@ -39,7 +39,7 @@ gs_dump可以创建四种不同的导出文件格式，通过“-F”或者“-f | 目录归档格式 | d | 该格式会创建一个目录，该目录包含两类文件，一类是目录文件，另一类是每个表和blob对象对应的数据文件。 | - | | | tar归档格式 | t | tar归档文件支持从导出文件中恢复所有或所选数据库对象。tar归档格式不支持压缩且对于单独表大小应小于8GB。 | - | | -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 ## 注意事项 @@ -53,7 +53,7 @@ gs_dump可以创建四种不同的导出文件格式，通过“-F”或者“-f gs_dump [OPTION]... [DBNAME] ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 ```bash gs_dump -p port_number postgres -f dump1.sql @@ -148,7 +148,7 @@ gs_dump -p port_number -f dump1.sql 只转储与模式名称匹配的模式，此选项包括模式本身和所有它包含的对象。如果该选项没有指定，所有在目标数据库中的非系统模式将会被转储。写入多个-n选项来选择多个模式。此外，根据gsql的\d命令所使用的相同规则，模式参数可被理解成一个pattern，所以多个模式也可以通过在该pattern中写入通配符来选择。使用通配符时，注意给pattern打引号，防止shell扩展通配符。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 当-n已指定时，gs_dump不会转储已选模式所附着的任何其他数据库对象。因此，无法保证某个指定模式的转储结果能够自行成功地储存到一个空数据库中。 - 当-n指定时，非模式对象不会被转储。 @@ -207,7 +207,7 @@ gs_dump -p port_number -f dump1.sql 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数-include-table-file来替换。 @@ -245,7 +245,7 @@ gs_dump -p port_number -f dump1.sql 指定不需要dump的表文件。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 同-include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… - -x, -no-privileges|-no-acl @@ -357,7 +357,7 @@ gs_dump -p port_number -f dump1.sql - 至少包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）、非字母数字字符（限定为~!@#$%^&*()-_=+|[]{};:,<.>/?）四类字符中的三类字符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 > - 不支持加密导出存储过程和函数。 @@ -392,7 +392,7 @@ gs_dump -p port_number -f dump1.sql gs_dump -p port_number postgres -f backup.sql -F plain --dont-overwrite-file ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -s/-schema-only和-a/-data-only不能同时使用。 - -c/-clean和-a/-data-only不能同时使用。 @@ -462,7 +462,7 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中“Bigdata@123”表示数据库用户密码；“backup/MPPDB_backup.sql”表示导出的文件，其中backup表示相对于当前目录的相对目录；“37300”表示数据库服务器端口；“postgres”表示要访问的数据库名。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1：执行gs_dump，导出postgres数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md index b6a82a58..b52092f9 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/6-gs_dumpall.md @@ -187,7 +187,7 @@ gs_dumpall [OPTION]... 指定备份进程并发数，取值范围为1~1000。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -g/-globals-only和-r/-roles-only不能同时使用。 - -g/-globals-only和-t/-tablespaces-only不能同时使用。 @@ -256,7 +256,7 @@ gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则， 使用gs_dumpall一次导出MogDB的所有数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 ```bash gs_dumpall -f backup/bkp2.sql -p 37300 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7-gs_guc.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7-gs_guc.md index e60c6cba..684b3508 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7-gs_guc.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7-gs_guc.md @@ -31,13 +31,13 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为client，则会生成这两个文件。其中“client.key.cipher”存储用户密码的密文，“client.key.rand”存储的是加密因子。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 - “datasource.key.cipher”，“datasource.key.rand” 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为source，则会生成这两个文件。其中“datasource.key.cipher”存储用户密码的密文，“datasource.key.rand”存储的是加密因子。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - “datasource.key.cipher”和“datasource.key.rand”是创建Data Source对象时调用的密钥文件。gs_guc生成时即有读权限。使用前需将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。gs_ssh工具可以协助您快速将文件放入集群各节点对应目录下。 > @@ -77,7 +77,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc {set | reload} -Z NODE-TYPE [-N NODE-NAME] {-I INSTANCE-NAME | -D DATADIR} -h "HOSTTYPE DATABASE USERNAME HOSTNAME AUTHMEHOD authentication-options" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - AUTHMEHOD后的authentication-options为可选参数，AUTHMEHOD支持以下选项： > @@ -118,7 +118,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc encrypt [-M keymode] -K password [-U username] -D DATADIR ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -K是用户指定的密码，gs_guc会对该密码进行长度（8<=len<=16）和密码复杂度要求，如果不满足，将会报错。此密码用于保证生成密码文件的安全性和唯一性，用户无需保存或记忆。 > @@ -130,14 +130,14 @@ gs_guc工具由操作系统用户omm执行。 gs_guc generate [-o prefix] [-S cipherkey] -D DATADIR ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -o是输出cipher和rand文件前缀名称，默认输出文件名前缀为obsserver。其内容仅支持数字、字母和下划线。 > > - -S是用户指定的密码，密码需要满足长度要求（8<=len<=16）和复杂度要求，如不满足将会报错。当其值为default时，会随机生成一段字符串作为密码，该密码长度为13。如果不带-S参数则会提示交互式输入密码。为了系统安全，推荐使用交互式输入密码方式。 > - 使用gs_guc encrypt或generate命令生成加密密码和加密因子文件时只是参数不同，本质上是一样的。生成过程中会使用随机数作为加密密钥材料和盐值，因此是每次生成的文件都是不同的。每次生成的加密密码和加密因子文件需要成对使用，不能更换或交替使用，加密和解密时需要使用相同的加密密码和加密因子文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_guc工具不支持参数值中包含'#'的设置。可以使用vi工具通过手工修改配置文件来设置。 > @@ -176,7 +176,7 @@ gs_guc工具由操作系统用户omm执行。 当参数取值为ALL时，表示设置MogDB中所有的主机。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 - -I INSTANCE-NAME @@ -186,13 +186,13 @@ gs_guc工具由操作系统用户omm执行。 当参数取值为ALL时，表示设置主机中所有的实例。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 - -D 需要执行命令的MogDB实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 与“-I” 不能一块使用 @@ -200,7 +200,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的MogDB配置参数的名称和参数值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果参数是一个字符串变量，则使用-c parameter=“'value'“或者使用-c “parameter = 'value'“。 > @@ -214,7 +214,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的逻辑数据库名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该参数必需同-Z datanode一起使用。即gs_guc只允许作用于逻辑数据库的DN实例。 > @@ -257,7 +257,7 @@ authmehod-options是可选输入，取值： 详细的参数说明请参见“pg_hba.conf”配置文件中的描述。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定-h的情况下，默认会尝试修改所有节点的pg_hba文件，但是如果是编译安装，由于没有静态文件，可以成功修改本节点的pg_hba文件，但是会提示静态文件不存在。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定-h的情况下，默认会尝试修改所有节点的pg_hba文件，但是如果是编译安装，由于没有静态文件，可以成功修改本节点的pg_hba文件，但是会提示静态文件不存在。 - -?, -help @@ -271,7 +271,7 @@ authmehod-options是可选输入，取值： 设定该密码在数据库运行过程中，用于服务端(server)、客户端(client)还是创建Data Source对象时调用。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 取值范围: @@ -289,7 +289,7 @@ authmehod-options是可选输入，取值： 指定要加密的用户，隶属于OS用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 - -S CIPHERKEY @@ -309,7 +309,7 @@ authmehod-options是可选输入，取值： 取值范围: datanode。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。MogDB只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。MogDB只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md index 404bffab..cb608cdb 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md @@ -17,7 +17,7 @@ MogDB提供了gs_encrypt工具为输入的明文字符串进行加密操作。 gs_encrypt [OPTION]... PLAINTEXT ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - “PLAINTEXT”前不需要加短选项或长选项。 > @@ -53,7 +53,7 @@ gs_encrypt [OPTION]... PLAINTEXT 加密时使用的随机数，以base64编码。base64编码前的字符串长度必须为16。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 出于安全考虑，建议用户在使用gs_encrypt工具前设置HISTCONTROL=ignorespace，强制不记录敏感历史命令，然后在执行gs_encrypt命令行前面加空格。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 出于安全考虑，建议用户在使用gs_encrypt工具前设置HISTCONTROL=ignorespace，强制不记录敏感历史命令，然后在执行gs_encrypt命令行前面加空格。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/8-gs_om.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/8-gs_om.md index cd3a7257..2fbdd9a3 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/8-gs_om.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/8-gs_om.md @@ -208,13 +208,13 @@ gs_om参数可以分为如下几类： 显示详细信息。如果不指定，只提示该服务器是否正常。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 - -all 显示MogDB所有节点信息。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 - 生成配置文件参数： diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/9-gs_restore.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/9-gs_restore.md index fd076ac3..938ff8be 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/9-gs_restore.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/server-tools/9-gs_restore.md @@ -29,7 +29,7 @@ gs_restore工具由操作系统用户omm执行。 gs_restore [OPTION]... FILE ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - FILE没有短选项或长选项。用来指定归档文件所处的位置。 - 作为前提条件，需输入dbname或-l选项。不允许用户同时输入dbname和-l选项。 @@ -50,7 +50,7 @@ gs_restore [OPTION]... FILE 默认是标准输出。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f不能同-d一起使用。 @@ -194,7 +194,7 @@ gs_restore -h host_name -p port_number -d postgres -n test1 -t test1 -n test2 -t gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 -t table1 backup/MPPDB_backup.tar ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -t参数不支持schema_name.table_name的输入格式。 @@ -240,7 +240,7 @@ gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 输出SET SESSION AUTHORIZATION命令，而非ALTER OWNER命令，用以决定对象归属。该选项使转储更加兼容标准，但通过参考转储中对象的记录，导入过程可能会有问题。使用SET SESSION AUTHORIZATION的转储要求必须是系统管理员，同时在导入前还需参考”SET SESSION AUTHORIZATION”，手工对导出文件的密码进行修改验证，只有这样才能进行正确的导入操作，相比之下，ALTER OWNER对权限要求较低。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: - 如果安装过程中有任何本地数据要添加到template1数据库，请谨慎将gs_restore的输出载入到一个真正的空数据库中；否则可能会因为被添加对象的定义被复制，而出现错误。要创建一个无本地添加的空数据库，需从template0而非template1复制，例如： @@ -250,7 +250,7 @@ gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 - gs_restore不能选择性地导入大对象；例如只能导入那些指定表的对象。如果某个归档形式包含大对象，那所有大对象都会被导入，或一个都不会被导入，如果它们通过-L、-t或其他选项被排除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1. -d/-dbname 和 -f/-file 不能同时使用； 2. -s/-schema-only 和 -a/-data-only不能同时使用； diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index 617c8deb..cfd51600 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -21,7 +21,7 @@ gaussdb [OPTION]... 客户端应用程序为了访问数据库，将连接（通过网络或本地）到一个正在运行的gaussdb进程。然后该进程实例会启动一个独立的线程来处理这个连接。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 一个gaussdb进程总是管理来自同一个数据库的数据。一个系统上可以同时运行多个gaussdb进程，只要使用不同的数据目录和不同的端口号。gaussdb启动时需要知道数据目录的位置，该位置必须通过-D指定。通常，-D直接指向由gs_initdb创建的数据库目录。 @@ -130,7 +130,7 @@ ps -ef | grep gaussdb 无法绑定端口的错误信息可能表明该端口已经被其他非MogDB进程使用。如果终止gaussdb后又马上用同一端口号运行它，也可能得到错误信息。这时，必须多等几秒，等操作系统关闭了该端口再试。最后，如果使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如：Unix版本认为低于1024的端口号是“可信任的”，因而只有Unix系统管理员可以使用它们。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果有可能，不要使用SIGKILL杀死主进程。这样会阻止gaussdb在退出前释放它持有的系统资源（例如共享内存和信号灯）。这样可能会影响到将来启动新的进程。 > - 可以使用SIGTERM，SIGINT，SIGQUIT信号正常结束服务器进程。第一个信号将等待所有的客户端退出后才退出。第二个将强制断开所有客户端，而第三个将不停止立刻退出，导致在重启时的恢复运行。 @@ -148,7 +148,7 @@ gaussdb --single -D /usr/local/pgsql/data other-options my_database 用-D给服务器提供正确的数据库目录的路径。同时还要声名已存在的特定数据库名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 通常，独立运行的服务器把换行符当做命令输入完成字符；要想把一行分成多行写，必需在除最后一个换行符以外的每个换行符前面敲一个反斜杠。 > - 如果使用了-j命令行选项，新行将不被当作命令结束符。此时服务器将从标准输入一直读取到EOF标志为止，然后把所有读到的内容当作一个完整的命令字符串看待，并且反斜杠与换行符也被当作普通字符来看待。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md index 21357ff9..8abf5435 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md @@ -11,7 +11,7 @@ date: 2021-06-07 通过gs_basebackup的压缩格式备份，主数据目录将被写入到一个名为 base.tar 的文件中，并且其他表空间将被以其 OID 命名。生成的数据文件，需要通过gs_tar命令作解压。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_tar命令当前仅支持解压通过gs_basebackup生成的归档文件。 > - 如果gs_basebackup制定了压缩等级，会生成以gz结尾的文件。此时需要使用gzip命令先解压缩生成tar包，之后才可以使用gs_tar命令解压生成的tar文件。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md index 5214bfc6..448b9cc6 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md @@ -49,7 +49,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 - 当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为“gaussdbLogPath/用户名/om/gs_uninstall-YYYY-MM-DD_hhmmss.log”。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_uninstall时，系统会自动删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_uninstall时，系统会自动删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md index 3d87ed41..7a3668a8 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md @@ -82,7 +82,7 @@ date: 2021-06-07 gs_upgradectl -t commit-upgrade -X XMLFILE [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一旦提交操作完成，则不能再执行回滚操作。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md index 0abc4f31..0d26dd2e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md @@ -163,7 +163,7 @@ Expansion results: Expansion Finish. ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 对数据库集群进行扩容前，需要关注主机及新扩容节点cpu、io、网络等情况，不建议在硬件压力较大时执行扩容，否则可能导致扩容耗时较长甚至扩容失败。 > - 当原集群数据量较大时，在进行扩容操作前应当在主机上先执行checkpoint，否则可能导致扩容耗时较长甚至扩容失败。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md index fc0d4339..12d9ff52 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md @@ -326,7 +326,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **恢复目标相关参数(recovery_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： 1. 将物理备份的文件替换目标数据库目录。 2. 删除数据库目录下pg_xlog/中的所有文件。 3. 将归档的WAL日志文件复制到pg_xlog文件中（此步骤可以省略，通过配置recovery.conf恢复命令文件中的restore_command项替代）。 4. 在数据库目录下创建恢复命令文件recovery.conf，指定数据库恢复的程度。 5. 启动数据库。 6. 连接数据库，查看是否恢复到希望预期的状态。若已经恢复到预期状态，通过pg_xlog_replay_resume()指令使主节点对外提供服务。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： 1. 将物理备份的文件替换目标数据库目录。 2. 删除数据库目录下pg_xlog/中的所有文件。 3. 将归档的WAL日志文件复制到pg_xlog文件中（此步骤可以省略，通过配置recovery.conf恢复命令文件中的restore_command项替代）。 4. 在数据库目录下创建恢复命令文件recovery.conf，指定数据库恢复的程度。 5. 启动数据库。 6. 连接数据库，查看是否恢复到希望预期的状态。若已经恢复到预期状态，通过pg_xlog_replay_resume()指令使主节点对外提供服务。 - -recovery-target-lsn=*lsn* @@ -354,7 +354,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **留存相关参数(retention_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup和delete命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup和delete命令一起使用这些参数。 - -retention-redundancy=*retention-redundancy* @@ -392,7 +392,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **固定备份相关参数(pinning_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 - -ttl=*interval* @@ -464,7 +464,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **连接相关参数(connection_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 - -d *dbname*, -pgdatabase=*dbname* @@ -504,7 +504,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **压缩相关参数(compression_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 - -compress-algorithm=*compress-algorithm* @@ -531,7 +531,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **远程模式相关参数(remote_options)** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 - -remote-proto=*protocol* @@ -575,7 +575,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 例如：-ssh-options='-c cipher_spec -F configfile' - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果因为网络临时故障等原因导致server端无应答,gs_probackup将在等待archive-timeout（默认300秒）后退出。 > diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md index b42fdcf4..02495310 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md @@ -11,7 +11,7 @@ date: 2021-06-07 gstrace是MogDB提供的用来跟踪内核代码执行路径、记录内核数据结构、分析代码性能的工具。Trace的有限点位和数据在版本中被固化，无法动态添加和删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告**: > > 1. 对内核dump指定内存变量的数据用于诊断分析，不存在直接指定任意寄存器或者内存地址的行为。读取的内存地址均是在开发阶段硬编码，没有任意地读取或者修改寄存器或内存的操作。 > 2. Trace点可能涉及敏感数据，收集trace信息前需要同用户协商，授权和许可后方可收集。 @@ -19,7 +19,7 @@ gstrace是MogDB提供的用来跟踪内核代码执行路径、记录内核数 > 4. Trace仅用于诊断目的，开启trace将对性能产生一定影响，影响的大小视负载的高低，trace的模块而不同。 > 5. Trace工具的权限为0700，仅限于数据库用户读、写和执行。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 ## 语法 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md index a3c30c7a..857d0078 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB部署成功后，在数据库运行的过程中，会遇到各种问题及异常状态。MogDB提供了gs_basebackup工具做基础的物理备份。gs_basebackup的实现目标是对服务器数据库文件的二进制进行拷贝，其实现原理使用了复制协议。远程执行gs_basebackup时，需要使用系统管理员账户。gs_basebackup当前支持热备份模式和压缩格式备份模式。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_basebackup仅支持主机和备机的全量备份，不支持增量。 > - gs_basebackup当前支持热备份模式和压缩格式备份模式。 @@ -143,7 +143,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 当数据库发生故障时需要从备份文件进行恢复。因为gs_basebackup是对数据库按二进制进行备份，因此恢复时可以直接拷贝替换原有的文件，或者直接在备份的库上启动数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若当前数据库实例正在运行，直接从备份文件启动数据库可能会存在端口冲突，这时需要修改配置文件的port参数，或者在启动数据库时指定一下端口。 > - 若当前备份文件为主备数据库，可能需要修改一下主备之间的复制连接。即配置文件中的postgresql.conf中的replconninfo1，replconninfo2等。 @@ -158,7 +158,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 5. 若数据库中存在链接文件，需要修改使其链接到正确的文件。 6. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 暂不支持备份文件增量恢复。 > - 恢复后需要检查数据库中的链接文件是否链接到正确的文件。 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md index bff57171..536bb44e 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md @@ -17,7 +17,7 @@ gs_initdb初始化数据库时，会创建数据库目录、生成系统表、 初始化数据库时会生成大量的系统表和视图，其中绝大部分都对任何数据库用户开放查看权限。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 **生成的数据库** diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md index 604cd9f7..b37566cd 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md @@ -27,7 +27,7 @@ MogDB安装部署，要求用户指定配置文件，配置文件中会指定程 gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数-gsinit-parameter=“-locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 - 显示帮助信息 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md index 8e6a0c24..08dc0697 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md @@ -73,7 +73,7 @@ MogDB提供了gs_postuninstall工具来帮助清理准备MogDB环境阶段所做 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, -help diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md index 3e36184e..44c5eb49 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md @@ -57,7 +57,7 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 配置-U参数值时，字符串中不能包含“|”、“;”、“&”、“$”、“<”、“>”、“`”、“\\”、“'”、“\”、“{”、“}”、“(”、“)”、“[”、“]”、“~”、“*”、“?”特殊字符。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 配置-U参数值时，字符串中不能包含“|”、“;”、“&”、“$”、“<”、“>”、“`”、“\\”、“'”、“\”、“{”、“}”、“(”、“)”、“[”、“]”、“~”、“*”、“?”特殊字符。 - -G @@ -90,13 +90,13 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 - -sep-env-file=MPPRCFILE 保存环境变量的文件。如果指定该参数，表示将使用环境变量分离的版本。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 - -skip-hostname-set @@ -161,7 +161,7 @@ SYSLOGD_OPTIONS="-r -m 0" KLOGD_OPTIONS="-x" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该配置需要在MogDB每台机器上都要修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该配置需要在MogDB每台机器上都要修改。 ## 示例 diff --git a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md index 3bf145d4..0adac56c 100644 --- a/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md +++ b/product/zh/docs-mogdb/v2.1/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文件等操作。因此，安装前需要确保互信是连通的。MogDB提供了gs_sshexkey工具来帮助用户建立互信。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: root用户互信可能会存在安全隐患，因此建议用户在使用完成后，立即删除各主机上root用户的互信。 ## 前提条件 @@ -75,7 +75,7 @@ MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文 主机列表，列出所有需要建立互信主机的IP。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 确保hostfile文件中只配置正确的主机IP，不包含其它信息。 - -h diff --git a/product/zh/docs-mogdb/v2.1/security-guide/security/1-client-access-authentication.md b/product/zh/docs-mogdb/v2.1/security-guide/security/1-client-access-authentication.md index 45e07cc7..0d03fd39 100644 --- a/product/zh/docs-mogdb/v2.1/security-guide/security/1-client-access-authentication.md +++ b/product/zh/docs-mogdb/v2.1/security-guide/security/1-client-access-authentication.md @@ -230,8 +230,8 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | ssl_key_file | 指定服务器私钥文件，用以对公钥加密的数据进行解密。 | 请以实际的服务器私钥名称为准。其相对路径是相对于数据目录的。
**默认值** : server.key | | ssl_ca_file | CA服务器的根证书。此参数可选择配置，需要验证客户端证书的合法性时才需要配置。 | 请以实际的CA服务器根证书名称为准。
**默认值** : cacert.pem | | ssl_crl_file | 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。 | 请以实际的证书吊销列表名称为准。
**默认值** : 空，表示没有吊销列表。 | -| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值:** ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | -| ssl_cert_notify_time | SSL服务器证书到期前提醒的天数。 | 请按照需求配置证书过期前提醒天数。
**默认值:** 90 | +| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值**: ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | +| ssl_cert_notify_time | SSL服务器证书到期前提醒的天数。 | 请按照需求配置证书过期前提醒天数。
**默认值**: 90 | 在客户端配置SSL认证相关的环境变量，详细信息请参见[表6](#表1.3.3)。 @@ -242,8 +242,8 @@ MogDB在MogDB部署完成后，默认已开启SSL认证模式。服务器端证 | 环境变量 | 描述 | 取值范围 | | :------------ | :--------------------------- | :-------------------------- | -| PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如：
`export PGSSLCERT='/home/omm/client.crt'`
**默认值**：空 | -| PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如：
`export PGSSLKEY='/home/omm/client.key'`
**默认值**：空 | +| PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如：
`export PGSSLCERT='/home/omm/client.crt'`
**默认值**: 空 | +| PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如：
`export PGSSLKEY='/home/omm/client.key'`
**默认值**: 空 | | PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义：**
- disable：只尝试非SSL连接。
- allow：首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer：首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require：只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值：**prefer | | PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如：
`export PGSSLROOTCERT='/home/omm/certca.pem'`
**默认值：**空 | | PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如：
`export PGSSLCRL='/home/omm/sslcrl-file.crl'`
**默认值：**空 | diff --git a/product/zh/docs-mogdb/v2.1/security-guide/security/2-managing-users-and-their-permissions.md b/product/zh/docs-mogdb/v2.1/security-guide/security/2-managing-users-and-their-permissions.md index 29e7d364..d571df31 100644 --- a/product/zh/docs-mogdb/v2.1/security-guide/security/2-managing-users-and-their-permissions.md +++ b/product/zh/docs-mogdb/v2.1/security-guide/security/2-managing-users-and-their-permissions.md @@ -796,7 +796,7 @@ DROP ROLE gs_guc reload -N all -I all -c "password_policy=1" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 帐户密码的复杂度要求如下： > @@ -978,7 +978,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 1234@abc、5678@def分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1234@abc、5678@def分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 - 管理员可以修改自己的或者其他帐户的密码。通过修改其他帐户的密码，解决用户密码遗失所造成无法登录的问题。 @@ -989,7 +989,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 系统管理员之间不允许互相修改对方密码。 > @@ -1045,7 +1045,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 密码失效的用户登录数据库后，当执行简单查询或者扩展查询时，会提示用户修改密码。修改密码后可以正常执行语句。 > - 只有初始用户、系统管理员（sysadmin）或拥有创建用户（CREATEROLE）权限的用户才可以设置用户密码失效，其中系统管理员也可以设置自己或其他系统管理员密码失效。不允许设置初始用户密码失效。 diff --git a/product/zh/docs-mogdb/v2.1/security-guide/security/4-setting-encrypted-equality-query.md b/product/zh/docs-mogdb/v2.1/security-guide/security/4-setting-encrypted-equality-query.md index 19df6f9d..57aa6be5 100644 --- a/product/zh/docs-mogdb/v2.1/security-guide/security/4-setting-encrypted-equality-query.md +++ b/product/zh/docs-mogdb/v2.1/security-guide/security/4-setting-encrypted-equality-query.md @@ -161,7 +161,7 @@ public static Connection getConnect(String username, String passwd) }; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 【建议】使用JDBC操作密态数据库时，一个数据库连接对象对应一个线程，否则，不同线程变更可能导致冲突。 > - 【建议】使用JDBC操作密态数据库时，不同connection对密态配置数据有变更，由客户端调用isvalid方法保证connection能够持有变更后的密态配置数据，此时需要保证参数refreshClientEncryption为1(默认值为1)，在单客户端操作密态数据场景下，refreshClientEncryption参数可以设置为0。 @@ -193,7 +193,7 @@ int rc = stmt.executeUpdate("CREATE CLIENT MASTER KEY ImgCMK1 WITH ( KEY_STORE = int rc = stmt.executeUpdate("CREATE CLIENT MASTER KEY ImgCMK1 WITH ( KEY_STORE = localkms, KEY_PATH = \"key_path_value\" , ALGORITHM = RSA_2048); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 创建密钥之前需要使用gs_ktool工具提前生成密钥，才能创建CMK成功。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 创建密钥之前需要使用gs_ktool工具提前生成密钥，才能创建CMK成功。 ```java // 创建列加密密钥 @@ -304,7 +304,7 @@ pstmt.close(); ------------------ Avi (1 row) - + mogdb=# SELECT f_encrypt_in_plpgsql('Avi', val2=>'1234567890123456'); f_encrypt_in_plpgsql ---------------------- @@ -312,7 +312,7 @@ pstmt.close(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 函数/存储过程中的“执行动态查询语句”中的查询是在执行过程中编译，因此函数/存储过程中的表名、列名不能在创建阶段未知，输入参数不能用于表名、列名或以任何方式连接。 > - 在RETURNS、IN和OUT的参数中，不支持混合使用加密和非加密类型参数。虽然参数类型都是原始数据类型，但实际类型不同。 diff --git a/product/zh/docs-mogdb/v2.1/security-guide/security/5-setting-a-ledger-database.md b/product/zh/docs-mogdb/v2.1/security-guide/security/5-setting-a-ledger-database.md index 95e504e2..35e834ad 100644 --- a/product/zh/docs-mogdb/v2.1/security-guide/security/5-setting-a-ledger-database.md +++ b/product/zh/docs-mogdb/v2.1/security-guide/security/5-setting-a-ledger-database.md @@ -96,7 +96,7 @@ date: 2021-10-11 Options: internal_mask=263 ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 防篡改表不支持非行存表、临时表、外表、unlog表、非行存表均无防篡改属性。 > - 防篡改表在创建时会自动增加一个名为hash的系统列，所以防篡改表单表最大列数为1599。 @@ -173,7 +173,7 @@ date: 2021-10-11 用户历史表有4个字段，每个字段的含义见[表1](#table1)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 用户历史表的表名一般为blockchain.hist形式。当防篡改用户表模式名或者表名过长导致前述方式生成的表名超出表名长度限制，则会采用blockchain.hist的方式命名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 用户历史表的表名一般为blockchain.hist形式。当防篡改用户表模式名或者表名过长导致前述方式生成的表名超出表名长度限制，则会采用blockchain.hist的方式命名。 ### 操作步骤 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai-in-db/intelligence-explain/intelligence-explain-user-guide.md b/product/zh/docs-mogdb/v3.0/AI-features/ai-in-db/intelligence-explain/intelligence-explain-user-guide.md index cd96f612..d975055c 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai-in-db/intelligence-explain/intelligence-explain-user-guide.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai-in-db/intelligence-explain/intelligence-explain-user-guide.md @@ -20,7 +20,7 @@ date: 2022-05-06 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集。 > - Cgroups功能正常加载。 @@ -69,7 +69,7 @@ date: 2022-05-06 resource_track_cost=10（默认值为100000） ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - resource_track_cost需设置为小于需要收集的查询总代价，满足条件的信息才能被收集 > - Cgroups功能正常加载。 @@ -86,7 +86,7 @@ date: 2022-05-06 ## 模型管理（系统管理员用户） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 模型管理操作需要在数据库正常的状态下进行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 模型管理操作需要在数据库正常的状态下进行。 1. 新增模型： @@ -98,7 +98,7 @@ date: 2022-05-06 INSERT INTO gs_opt_model values('rlstm', 'model_name', 'datname', '127.0.0.1', 5000, 2000, 1, -1, 64, 512, 0 , false, false, '{S, T}', '{0,0}', '{0,0}', 'Text'); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 具体模型参数设置请参考[GS_OPT_MODEL](GS_OPT_MODEL)。 > - 目前 “template_name” 列只支持 “rlstm”。 @@ -170,7 +170,7 @@ date: 2022-05-06 ## 模型预测 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 模型预测功能需在数据库状态正常、指定模型已被训练且收敛的条件下进行。 > @@ -204,4 +204,4 @@ date: 2022-05-06 ``` MogDB=# select track_model_train_opt('template_name', 'model_name'); - ``` \ No newline at end of file + ``` diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-2-preparations.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-2-preparations.md index 0936c553..b2f48b73 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-2-preparations.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-2-preparations.md @@ -24,7 +24,7 @@ date: 2021-05-19 调优程序是一个独立于数据库内核之外的工具，需要提供数据库及其所在实例的用户名和登录密码信息，以便控制数据库执行benchmark进行性能测试；在启动调优程序前，要求用户测试环境交互正常，能够正常跑通benchmark测试脚本、能够正常连接数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果需要调优的参数中，包含重启数据库后才能使修改生效的参数，那么在调优过程中数据库将会重启多次。如果用户的数据库正在执行作业，请慎用train与tune模式。 调优程序X-Tuner包含三种运行模式，分别是: @@ -32,7 +32,7 @@ date: 2021-05-19 - train：通过用户提供的benchmark信息，不断地进行参数修改和benchmark的执行。通过反复的迭代过程，训练强化学习模型，以便用户在后面通过tune模式加载该模型进行调优。 - tune：使用优化算法进行数据库参数的调优，当前支持两大类算法，一种是深度强化学习，另一种是全局搜索算法（全局优化算法）。深度强化学习模式要求先运行train模式，生成训练后的调优模型，而使用全局搜索算法则不需要提前进行训练，可以直接进行搜索调优。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果在tune模式下，使用深度强化学习算法，要求必须有一个训练好的模型，且要求**训练该模型时的参数与进行调优时的参数列表（包括max与min）必须一致**。 **图 1** X-Tuner 结构图
@@ -45,7 +45,7 @@ X-Tuner 的整体架构如图1 X-Tuner 结构图所示，系统可以分为： - X-Tuner 主体逻辑模块：通过Enviroment模块进行封装，每一个step 就是一次调优过程。整个调优过程通过多个step进行迭代； - benchmark：由用户指定的benchmark性能测试脚本，用于运行benchmark作业，通过跑分结果反映数据库系统性能优劣。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPC-H这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 应确保benchmark脚本跑分结果越大表示性能越好。 例如TPC-H这种衡量SQL语句整体执行时长的benchmark，可以通过取总体执行时间的相反数作为benchmark的输出分数。
@@ -54,7 +54,7 @@ X-Tuner 的整体架构如图1 X-Tuner 结构图所示，系统可以分为： 执行下述命令即可获取xtuner功能帮助 ``` -gs_dbmind component xtuner --help +gs_dbmind component xtuner --help ``` 用户可据此给定不同的命令行执行相应的功能。 @@ -66,7 +66,7 @@ gs_dbmind component xtuner --help X-Tuner在运行前需要加载配置文件，用户可以通过**--help**命令查看默认加载的配置文件绝对路径： ```bash -... +... -x TUNER_CONFIG_FILE, --tuner-config-file TUNER_CONFIG_FILE This is the path of the core configuration file of the X-Tuner. You can specify the path of the new @@ -131,15 +131,15 @@ Benchmark驱动脚本示例说明 ``` from tuner.exceptions import ExecutionError - + # WARN: You need to download the benchmark-sql test tool to the system, # replace the PostgreSQL JDBC driver with the openGauss driver, # and configure the benchmark-sql configuration file. # The program starts the test by running the following command: path = '/path/to/benchmarksql/run' # TPC-C测试脚本benchmark-sql 的存放路径 cmd = "./runBenchmark.sh props.gs" # 自定义一个名为 props.gs 的benchmark-sql测试配置文件 - - + + def run(remote_server, local_host): # 切换到 TPC-C 脚本目录下，清除历史错误日志，然后运行测试命令。 # 此处最好等待几秒钟，因为benchmark-sql 测试脚本生成最终测试报告是通过一个shell脚本实现的，整个过程会有延迟， @@ -148,7 +148,7 @@ Benchmark驱动脚本示例说明 # 如果标准错误流中有数据，则报异常退出。 if len(stderr) > 0: raise ExecutionError(stderr) - + # 寻找最终tpmC结果 tpmC = None split_string = stdout.split() # 对标准输出流结果进行分词。 @@ -161,22 +161,22 @@ Benchmark驱动脚本示例说明 "cat %s/benchmarksql-error.log" % path) nb_err = stdout.count("ERROR:") # 判断整个benchmark运行过程中，是否有报错，记录报错的错误数 return float(tpmC) - 10 * nb_err # 这里将报错的错误数作为一个惩罚项，惩罚系数为10，越高的惩罚系数表示越看中报错的数量. - + ``` 2. TPC-H驱动脚本 ``` import time - + from tuner.exceptions import ExecutionError - + # WARN: You need to import data into the database and SQL statements in the following path will be executed. # The program automatically collects the total execution duration of these SQL statements. path = '/path/to/tpch/queries' # 存放TPC-H测试用的SQL脚本目录 cmd = "gsql -U {user} -W {password} -d {db} -p {port} -f {file}" # 需要运行TPC-H测试脚本的命令，一般使用'gsql -f 脚本文件' 来运行 - - + + def run(remote_server, local_host): # 遍历当前目录下所有的测试用例文件名 find_file_cmd = "find . -type f -name '*.sql'" diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-3-examples.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-3-examples.md index 5d9acca5..388b5f41 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-3-examples.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/1-x-tuner-parameter-optimization-and-diagnosis/1-3-examples.md @@ -40,7 +40,7 @@ X-Tuner支持三种模式，分别是获取参数诊断报告的recommend模式 则可通过 -f connection.json 传递。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了防止密码泄露，配置文件和命令行参数中默认都不包含密码信息，用户在输入上述连接信息后，程序会采用交互式的方式要求用户输数据库密码以及操作系统登录用户的密码。
@@ -71,7 +71,7 @@ gs_dbmind component xtuner recommend -f connection.json - checkpoint_avg_sync_time：数据库在checkpoint 时，平均每次同步刷新数据到磁盘的时长，单位是毫秒。 - load_average：平均**每个CPU核心**在1分钟、5分钟以及15分钟内的负载。一般地，该数值在1左右表明当前硬件比较匹配workload、在3左右表明运行当前作业压力比较大，大于5则表示当前硬件环境运行该workload压力过大（此时一般建议减少负载或升级硬件）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于某些系统表会一直记录统计信息，这可能会对负载特征识别造成干扰，因此建议最好先清空某些系统表的统计信息，运行一段时间的workload后再使用recommend模式进行诊断，以便获得更准确的结果。清除统计信息的方法为： > diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-1-single-query-index-recommendation.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-1-single-query-index-recommendation.md index 01224e9f..4c079d93 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-1-single-query-index-recommendation.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-1-single-query-index-recommendation.md @@ -15,7 +15,7 @@ date: 2021-05-19 | :-------------- | :------------ | :----------------------------- | | gs_index_advise | SQL语句字符串 | 针对单条查询语句生成推荐索引。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 本功能仅支持单条SELECT类型的语句，不支持其他类型的SQL语句。 > - 本功能暂不支持分区表、列存表、段页式表、普通视图、物化视图、全局临时表以及密态数据库。 @@ -68,4 +68,4 @@ MogDB=# select "table", "column", "indextype" from gs_index_advise('select name, (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（') 进行转义，可参考上述示例。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 系统函数 gs_index_advise() 的参数是文本型，如果参数中存在如单引号（'） 等特殊字符，可以使用单引号（') 进行转义，可参考上述示例。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-2-virtual-index.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-2-virtual-index.md index 5c212af6..a9ae4e19 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-2-virtual-index.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-2-virtual-index.md @@ -118,7 +118,7 @@ date: 2021-05-19 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 执行EXPLAIN ANALYZE不会涉及虚拟索引功能。 > - 创建的虚拟索引是数据库实例级别的，各个会话（session）之间可共享设置，关闭会话后虚拟索引仍可存在，但是重启数据库后将被清空。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-3-workload-level-index-recommendation.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-3-workload-level-index-recommendation.md index 410140dc..280d921f 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-3-workload-level-index-recommendation.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/ai-sub-functions-of-the-dbmind/2-index-advisor-index-recommendation/2-3-workload-level-index-recommendation.md @@ -23,7 +23,7 @@ date: 2021-05-19 - log_statement= 'all' - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 业务数据抽取完毕建议将上述GUC参数复原，否则容易导致日志文件膨胀。 @@ -59,7 +59,7 @@ date: 2021-05-19 gs_dbmind component extract_log $GAUSSLOG/pg_log/dn_6001 sql_log.txt '%m %c %d %p %a %x %n %e' -d postgres -U omm --start_time '2021-07-06 00:00:00' --statement ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若指定-d/-U参数，日志打印每条日志信息的前缀格式需包含%d、%u，若需要抽取事务，必须指定%p，详见log_line_prefix参数。max_template_num参数设置建议不超5000条，避免workload索引推荐执行时间过长。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若指定-d/-U参数，日志打印每条日志信息的前缀格式需包含%d、%u，若需要抽取事务，必须指定%p，详见log_line_prefix参数。max_template_num参数设置建议不超5000条，避免workload索引推荐执行时间过长。 3. 将步骤1中设置的GUC参数还原为设置前的值。 @@ -75,9 +75,9 @@ date: 2021-05-19 gs_dbmind component index_advisor [p PORT] [d DATABASE] [f FILE] [--h HOST] [-U USERNAME] [-W PASSWORD][--schema SCHEMA] [--max_index_num MAX_INDEX_NUM][--max_index_storage MAX_INDEX_STORAGE] [--multi_iter_mode] [--multi_node] [--json] [--driver] [--show_detail] ``` - + 其中的输入参数依次为： - + - PORT：连接数据库的端口号。 - DATABASE：连接数据库的名字。 - FILE：包含workload语句的文件路径。 @@ -92,15 +92,15 @@ date: 2021-05-19 - json：（可选）指定workload语句的文件路径格式为SQL归一化后的json，默认格式每条SQL占一行。 - driver：（可选）指定是否使用python驱动器连接数据库，默认gsql连接。 - show_detail：（可选）是否显示当前推荐索引集合的详细优化信息。 - + 例如： - + ```python gs_dbmind component index_advisor 6001 postgres tpcc_log.txt --schema public --max_index_num 10 --multi_iter_mode ``` - + 推荐结果为一批索引，以多个创建索引语句的格式显示在屏幕上，结果示例。 - + ```sql create index ind0 on public.bmsql_stock(s_i_id,s_w_id); create index ind1 on public.bmsql_customer(c_w_id,c_id,c_d_id); @@ -113,5 +113,5 @@ date: 2021-05-19 create index ind8 on public.bmsql_oorder(o_w_id,o_c_id,o_d_id); create index ind9 on public.bmsql_district(d_w_id); ``` - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** multi_node参数需严格按照当前数据库架构进行指定，否则推荐结果不全，甚至导致无推荐结果。 + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: multi_node参数需严格按照当前数据库架构进行指定，否则推荐结果不全，甚至导致无推荐结果。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-environment-deployment.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-environment-deployment.md index 18f86eb0..46c2b79f 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-environment-deployment.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-environment-deployment.md @@ -22,7 +22,7 @@ date: 2022-05-06 其中，提供的exporter组件默认采用Https通信协议，因此需要用户默认提供ssl证书和秘钥文件，并通过--ssl-keyfile以及--ssl-certfile提供。若用户不希望使用Https协议，则可以通过--disable-https选项禁用该模式。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于MogDB默认模式下的通信加密协议与PostgreSQL不兼容，故导致通过PyPI源安装的基于PostgreSQL编译的Python驱动psycopg2-binary默认无法连接至MogDB数据库。 > 因此，需要用户自行编译psycopg2或修改GUC参数进行适配。也可通过openGauss官方网站下载基于openGauss编译的psycopg2（官方网站仅提供部分Python版本的编译包，一般为Python3.6版本，需要用户鉴别)。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-overview.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-overview.md index 4c0e9cbb..cc81bb3a 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-overview.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/components-that-support-dbmind/prometheus-exporter/prometheus-exporter-overview.md @@ -9,4 +9,4 @@ date: 2022-05-06 Prometheus是业内非常流行的开源监控系统，同时本身也是一款时序数据库。Prometheus的采集端称之为exporter，用来收集被监控模块的指标项。为了与Prometheus平台完成对接，AI工具分别实现了两款exporter，分别是用来采集数据库指标的openGauss-exporter，以及对采集到的指标进行二次加工的reprocessing-exporter。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** Prometheus 和exporter是业内流行的监控和采集平台，部署在内网环境中，不对外部暴露接口，仅供内部监控平台使用。因此，为了增强该平台的安全性，一般需要用户或运维人员配置防火墙等，以便隔离外部访问，从而增强监控平台的安全性。 Prometheus平台在默认情况下，采用Http协议、并且没有任何安全访问限制。这是因为，该平台一般部署在内网环境中，攻击风险可控。如果用户希望提高安全性，可自行修改Prometheus的TLS配置选项，但仍不建议对外部直接暴露访问接口。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: Prometheus 和exporter是业内流行的监控和采集平台，部署在内网环境中，不对外部暴露接口，仅供内部监控平台使用。因此，为了增强该平台的安全性，一般需要用户或运维人员配置防火墙等，以便隔离外部访问，从而增强监控平台的安全性。 Prometheus平台在默认情况下，采用Http协议、并且没有任何安全访问限制。这是因为，该平台一般部署在内网环境中，攻击风险可控。如果用户希望提高安全性，可自行修改Prometheus的TLS配置选项，但仍不建议对外部直接暴露访问接口。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/1-service.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/1-service.md index 61e6fc10..311fa434 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/1-service.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/1-service.md @@ -45,7 +45,7 @@ gs_dbmind service setup -c confpath --interactive name = prometheus # 时序数据库类型. 当前仅支持选择'prometheus'. host = # 时序数据库IP地址. port = # 时序数据库端口号. - + [METADATABASE] # 元数据库相关信息，及预测结果存储方式 dbtype = # 元数据库类型. 可选择: sqlite, mogdb, postgresql。若该配置项名为mogdb, 需关注Python驱动事宜，可参考下文中关于Python驱动的提示。 host = # 元数据库地址. @@ -53,14 +53,14 @@ gs_dbmind service setup -c confpath --interactive username = # 元数据库用户信息. password = # 元数据库密码，将会被加密存储 database = # 元数据库库名. 如果选择的数据库类型为SQLite, 则无需填写上述配置项，仅需填写此处。DBMind会根据database配置项的内容，在配置目录中生成对应文件名的SQLite数据库文件。 - + [SELF-MONITORING] # 自监控参数配置 detection_interval = 600 # 单位秒. 对mogdb进行健康检查的时间间隔（仅慢SQL根因诊断使用）. last_detection_time = 600 # 单位秒. 用于健康检查的监控数据长度（仅慢SQL根因诊断使用）. forecasting_future_time = 3600 # 单位秒，时序预测的长度（供时序预测特性使用），同时也是预测功能调度周期 # 待时序预测进行预测的关键指标项（仅供时序预测特性使用） golden_kpi = os_cpu_usage, os_mem_usage, gaussdb_qps_by_instance - + [LOG] # 日志相关信息 maxbytes = 10485760 # 默认值为 10Mb, 单个日志文件的最大大小.如果 maxbytes 为零，则文件无限增长（建议该值不要设置太小，默认即可）. backupcount = 1 # 日志文件最大数量. @@ -75,7 +75,7 @@ gs_dbmind service setup -c confpath --interactive 4. 完成配置目录初始化过程，可基于该配置目录启动DBMind后台服务。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. 配置文件注释信息用于在交互模式下对用户进行提示，有特殊含义不要手动修改或删除； > 2. 需要确保配置项的值与注释信息之间通过空格符分割，否则系统会将注释信息识别为配置项的值； @@ -105,7 +105,7 @@ gs_dbmind service stop -c confpath DBMind服务会在后台执行完正在运行的任务后自行退出。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** > > - [METADATABASE]中的元数据库用户需要具有在该数据库下的创表和数据插入更新权限，否则工具执行会出现异常。 > - 当前不支持同一配置文件下分开启动多个服务。 @@ -145,4 +145,4 @@ optional arguments: | --initialize | 配置参数初始化 | - | | --interactive | 交互式输入配置参数 | - | | --only-run | 选择只运行的模块 | - forecast：预测模块。
- slow_query_diagnosis：慢SQL根因分析模块。 | -| -h, --help | 帮助命令 | - | \ No newline at end of file +| -h, --help | 帮助命令 | - | diff --git a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/3-set.md b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/3-set.md index 5ebf2a8f..1951d088 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/3-set.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/ai4db/dbmind-mode/3-set.md @@ -19,7 +19,7 @@ gs_dbmind set TSDB host 127.0.0.1 -c confpath gs_dbmind set METADATABASE password xxxxxx -c confpath ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该命令对于字符串是大小写敏感的，如果输错则可能出现执行过程错误。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该命令对于字符串是大小写敏感的，如果输错则可能出现执行过程错误。 ## 命令参考 @@ -51,4 +51,4 @@ optional arguments: | -c，--conf | 配置文件目录confpath | - | | section | 设置区 | - | | option | 设置项 | - | -| target | 设置值 | - | \ No newline at end of file +| target | 设置值 | - | diff --git a/product/zh/docs-mogdb/v3.0/AI-features/db4ai/full-process-ai/db4ai-snapshots-for-data-version-management.md b/product/zh/docs-mogdb/v3.0/AI-features/db4ai/full-process-ai/db4ai-snapshots-for-data-version-management.md index 135caea7..5fc37a70 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/db4ai/full-process-ai/db4ai-snapshots-for-data-version-management.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/db4ai/full-process-ai/db4ai-snapshots-for-data-version-management.md @@ -206,7 +206,7 @@ DB4AI-Snapshots的状态包括published、archived以及purged。其中，publis --------- ERROR: snapshot public."s1nick@2.0" does not exist CONTEXT: PL/pgSQL function db4ai.publish_snapshot(name,name) line 11 at assignment - + archive snapshot s1nick@2.0; ---------- ERROR: snapshot public."s1nick@2.0" does not exist @@ -263,4 +263,4 @@ DB4AI-Snapshots的状态包括published、archived以及purged。其中，publis "snapshot_id_key" UNIQUE CONSTRAINT, btree (id) TABLESPACE pg_default ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 命名空间DB4AI是本功能的私有域，不支持在DB4AI的命令空间下创建函数索引（functional index)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 命名空间DB4AI是本功能的私有域，不支持在DB4AI的命令空间下创建函数索引（functional index)。 diff --git a/product/zh/docs-mogdb/v3.0/AI-features/db4ai/native-db4ai-engine.md b/product/zh/docs-mogdb/v3.0/AI-features/db4ai/native-db4ai-engine.md index fa445a4e..77ea6fe0 100644 --- a/product/zh/docs-mogdb/v3.0/AI-features/db4ai/native-db4ai-engine.md +++ b/product/zh/docs-mogdb/v3.0/AI-features/db4ai/native-db4ai-engine.md @@ -180,7 +180,7 @@ MogDB当前版本支持了原生DB4AI能力，通过引入原生AI算子，简 ``` MogDB=# SELECT id, PREDICT BY iris_classification (FEATURES sepal_length,sepal_width,petal_length,petal_width) as "PREDICT" FROM tb_iris limit 3; - + id | PREDICT -----+--------- 84 | 2 @@ -257,7 +257,7 @@ MogDB当前版本支持了原生DB4AI能力，通过引入原生AI算子，简 MogDB=# CREATE MODEL patient_linear_regression USING linear_regression FEATURES second_attack,treatment FROM patients; ERROR: Supervised ML algorithms require TARGET clause ----------------------------------------------------------------------------------------------------------------------------- - CREATE MODEL patient_linear_regression USING linear_regression TARGET trait_anxiety FROM patients; + CREATE MODEL patient_linear_regression USING linear_regression TARGET trait_anxiety FROM patients; ERROR: Supervised ML algorithms require FEATURES clause ``` @@ -314,4 +314,4 @@ MogDB当前版本支持了原生DB4AI能力，通过引入原生AI算子，简 CONTEXT: referenced column: patient_linear_regression_pre ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** DB4AI特性需要读取数据参与计算，不适用于密态数据库等情况。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: DB4AI特性需要读取数据参与计算，不适用于密态数据库等情况。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-2-br.md b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-2-br.md index 88992a67..9d53c878 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-2-br.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-2-br.md @@ -624,7 +624,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **恢复目标相关参数(recovery_options)** -> **说明：** +> **说明**: > > 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： > @@ -661,7 +661,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **留存相关参数(retention_options)** -> **说明：** +> **说明**: > > 可以和backup和delete命令一起使用这些参数。 @@ -701,7 +701,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **固定备份相关参数(pinning_options)** -> **说明：** +> **说明**: > > 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 @@ -775,7 +775,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **连接相关参数(connection_options)** -> **说明：** +> **说明**: > > 可以和backup命令一起使用这些参数。 @@ -817,7 +817,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **压缩相关参数(compression_options)** -> **说明：** +> **说明**: > > 可以和backup命令一起使用这些参数。 @@ -846,7 +846,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 **远程模式相关参数(remote_options)** -> **说明：** +> **说明**: > > 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 @@ -892,7 +892,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 例如：--ssh-options='-c cipher_spec -F configfile' ->**说明：** +>**说明**: > >* 如果因为网络临时故障等原因导致server端无应答，gs_probackup将在等待archive-timeout（默认300秒）后退出。 > @@ -938,4 +938,4 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 | 问题描述 | 原因和解决方案 | | :----------------------------------------------------------- | :----------------------------------------------------------- | -| ERROR: query failed: ERROR: canceling statement due to conflict with recovery（错误：查询失败：由于与恢复操作冲突，正在取消语句命令） | 原因：在备机上执行的操作正在访问存储行，主机上更改或者删除了对应的行，并将xlog在备机上重放，迫使备机上操作取消。
解决方案：
1. 适当增加如下配置参数的值：max_standby_archive_delaymax_standby_streaming_delay
2. 增加如下配置：hot_standby_feedback = on | \ No newline at end of file +| ERROR: query failed: ERROR: canceling statement due to conflict with recovery（错误：查询失败：由于与恢复操作冲突，正在取消语句命令） | 原因：在备机上执行的操作正在访问存储行，主机上更改或者删除了对应的行，并将xlog在备机上重放，迫使备机上操作取消。
解决方案：
1. 适当增加如下配置参数的值：max_standby_archive_delaymax_standby_streaming_delay
2. 增加如下配置：hot_standby_feedback = on | diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-3-br.md b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-3-br.md index f4fb4d56..fe1c6f04 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-3-br.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-3-br.md @@ -258,7 +258,7 @@ gs_dump -p port_number -f dump1.sql 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数-include-table-file来替换。 @@ -296,7 +296,7 @@ gs_dump -p port_number -f dump1.sql 指定不需要dump的表文件。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: ``` 同--include-table-file，其内容格式如下： @@ -422,7 +422,7 @@ gs_dump -p port_number -f dump1.sql - 钥长度为8\~16个字符。 - 至少包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）、非字母数字字符（限定为\~!@\#$%^&\*\(\)-\_=+\\|\[\{\}\];:,<.\>/?）四类字符中的三类字符。 -> **说明：** +> **说明**: > > - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定-with-key参数。 > - 不支持加密导出存储过程和函数。 @@ -461,8 +461,8 @@ gs_dump -p port_number -f dump1.sql gs_dump -p port_number mogdb -f backup.sql -F plain --dont-overwrite-file ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -> +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: +> > - -s/--schema-only和-a/--data-only不能同时使用。 > - -c/--clean和-a/--data-only不能同时使用。 > - --inserts/--column-inserts和-o/--oids不能同时使用，因为INSERT命令不能设置OIDS。 @@ -533,8 +533,8 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中"Bigdata@123"表示数据库用户密码；"backup/MPPDB_backup.sql"表示导出的文件，其中backup表示相对于当前目录的相对目录；"37300"表示数据库服务器端口；"mogdb"表示要访问的数据库名。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -> +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: +> > 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1: 执行gs_dump，导出mogdb数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 @@ -822,7 +822,7 @@ gs_dumpall [OPTION]... 使用管道传输密码，禁止在终端使用。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** -> +> > - -g/--globals-only和-r/--roles-only不能同时使用。 > - -g/--globals-only和-t/--tablespaces-only不能同时使用。 > - -r/--roles-only和-t/--tablespaces-only不能同时使用。 @@ -894,8 +894,8 @@ gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则， 使用gs_dumpall一次导出MogDB的所有数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -> +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: +> > gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 ```bash @@ -937,7 +937,7 @@ gs_restore [OPTION]... FILE ``` > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** -> +> > - FILE没有短选项或长选项。用来指定归档文件所处的位置。 > - 作为前提条件，需输入dbname或-l选项。不允许用户同时输入dbname和-l选项。 > - gs_restore默认是以追加的方式进行数据导入。为避免多次导入造成数据异常，在进行导入时，建议使用“-c”参数，在重新创建数据库对象前，清理（删除）已存在于将要还原的数据库中的数据库对象。 @@ -960,7 +960,7 @@ gs_restore [OPTION]... FILE 默认是标准输出。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** - > + > > -f不能同-d一起使用。 - -F, --format=c|d|t @@ -1103,8 +1103,8 @@ gs_restore [OPTION]... FILE gs_restore -h host_name -p port_number -d mogdb -n PUBLIC -t table1 -n test1 -t table1 backup/MPPDB_backup.tar ``` -> **说明：** -> +> **说明**: +> > -t不支持schema_name.table_name的输入格式。 - -T, --trigger=NAME @@ -1162,17 +1162,17 @@ gs_restore [OPTION]... FILE 使用管道传输密码，禁止在终端使用。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知:** -> +> > - 如果安装过程中有任何本地数据要添加到template1数据库，请谨慎将gs_restore的输出载入到一个真正的空数据库中；否则可能会因为被添加对象的定义被复制，而出现错误。要创建一个无本地添加的空数据库，需从template0而非template1复制，例如: -> +> > ``` > CREATE DATABASE foo WITH TEMPLATE template0; > ``` -> +> > - gs_restore不能选择性地导入大对象；例如只能导入那些指定表的对象。如果某个归档形式包含大对象，那所有大对象都会被导入或一个都不会被导入，如果它们通过-L、-t或其他选项被排除。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** -> +> > 1. -d/--dbname 和 -f/--file 不能同时使用。 > 2. -s/--schema-only 和 -a/--data-only不能同时使用。 > 3. -c/--clean 和 -a/--data-only不能同时使用。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-4-br.md b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-4-br.md index 5bd9f6f3..11893424 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-4-br.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/br/1-4-br.md @@ -9,7 +9,7 @@ date: 2021-10-12 闪回恢复功能是数据库恢复技术的一环，可以有选择性的撤销一个已提交事务的影响，将数据从人为不正确的操作中进行恢复。在采用闪回技术之前，只能通过备份恢复、PITR等手段找回已提交的数据库修改，恢复时长需要数分钟甚至数小时。采用闪回技术后，恢复已提交的数据库修改前的数据，只需要秒级，而且恢复时间和数据库大小无关。 -> **说明：** +> **说明**: > ASTORE引擎暂不支持闪回DROP/TRUNCATE。 **闪回支持两种恢复模式：** @@ -212,4 +212,4 @@ TIMECAPSULE TABLE t1 TO BEFORE DROP; TIMECAPSULE TABLE t1 TO BEFORE DROP RENAME TO new_t1; TIMECAPSULE TABLE "BIN$04LhcpndanfgMAAAAAANPw==$0" TO BEFORE DROP; TIMECAPSULE TABLE "BIN$04LhcpndanfgMAAAAAANPw==$0" TO BEFORE DROP RENAME TO new_t1; -``` \ No newline at end of file +``` diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md b/product/zh/docs-mogdb/v3.0/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md index 00a0c03b..78047055 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/importing-and-exporting-data/importing-data/4-using-a-gsql-meta-command-to-import-data.md @@ -37,7 +37,7 @@ not null column_list ] ] 在任何gsql客户端登录数据库成功后，可以使用该命令进行数据的导入/导出。但是与SQL的COPY命令不同，该命令读取/写入的文件是本地文件，而非数据库服务器端文件；所以，要操作的文件的可访问性、权限等，都是受限于本地用户的权限。 -> **说明：** +> **说明**: > > \\COPY只适合小批量、格式良好的数据导入，不会对非法字符做预处理，也无容错能力，无法适用于含有异常数据的场景。导入数据应优先选择GDS或COPY。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md index 1f618991..bf540708 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/1-introducing-mot/5-mot-performance-benchmarks.md @@ -11,7 +11,7 @@ date: 2021-03-04 测试使用了BenchmarkSQL（请参见[MOT样例TPC-C基准](6-mot-sample-tpcc-benchmark)），并且使用交互式SQL命令而不是存储过程来生成工作负载。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用存储过程方法可能会产生更高的性能结果，因为它需要大大减少网络往返和数据库封装SQL处理周期。 评估MogDB MOT性能和磁盘性能的所有测试都使用了同步日志记录和在MOT中优化的group-commit=on版本。 @@ -134,7 +134,7 @@ MOT高吞吐量测试结果如下。 MOT的平均事务速度为2.5倍，MOT延迟为10.5ms，而基于磁盘的表延迟为23至25ms。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅[MOT样例TPC-C基准](6-mot-sample-tpcc-benchmark)中关于TPC-C事务的说明。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算平均数时，已考虑TPC-C的5个事务分布占比。有关更多信息，请参阅[MOT样例TPC-C基准](6-mot-sample-tpcc-benchmark)中关于TPC-C事务的说明。 **图 2** 低延迟（90th%，事务平均）性能基准 @@ -152,7 +152,7 @@ MOT完全集成到MogDB中，包括支持主备部署的高可用场景。WAL重 **MogDB（包括MOT）的RTO小于10秒。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 灾难发生后必须恢复业务流程，避免导致连续性中断相关的不可接受的后果，而RTO表示的就是这段流程的持续时间和业务级别。换句话说，RTO就是在回答这个问题：在通知业务流程中断后，需要多长时间才能恢复？ 另外，从[MOT高吞吐量](#mot高吞吐量)的MOT中可以看出，在Arm/鲲鹏架构下，主从高可用场景复制开销仅为7%，在x86架构下仅为2%，而基于磁盘的表复制开销为2%。Arm/鲲鹏机型为20%，x86机型为15%。 @@ -173,7 +173,7 @@ MOT测试使用40 GB/s的ARM磁盘测试，可以在100 GB/s的时间内加载 - 数据库大小：加载整个数据库（每数据库GB）的总时间由蓝色线条和左侧的Y轴“时间（秒）”表示。 - 吞吐量：数据库每秒GB吞吐量由橙色线和右侧的Y轴“吞吐量GB/秒”表示。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 测试过程中表现的性能与SSD硬件的带宽非常接近。因此，可以在不同的平台上实现更高（或更低）的性能。
diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md index 984a76a6..63d22d96 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/2-mot-preparation.md @@ -74,7 +74,7 @@ MOT不需要任何特殊修改或安装新软件。但是，一些优化可以 MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完全驻留在内存中。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 内存存储是易失的，需要电力来维护所存储的信息。磁盘存储是持久的，写入磁盘是非易失性存储。MOT使用两种存储，既把所有数据保存在内存中，也把事务性更改同步（通过WAL日志记录）到磁盘上以保持严格一致性（使用同步日志记录模式）。 服务器上必须有足够的物理内存以维持内存表的状态，并满足工作负载和数据的增长。所有这些都是在传统的基于磁盘的引擎、表和会话所需的内存之外的要求。因此，提前规划好足够的内存来容纳这些内容是非常有必要的。 @@ -94,7 +94,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 如果违反此限制，则调整MOT内存内部限制，最大可能地满足上述限制范围。该调整在启动时进行，并据此计算MOT最大内存值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT最大内存值是配置或调整值（max_mot_global_memory + max_mot_local_memory）的逻辑计算值。 此时，会向服务器日志发出警告，如下所示： @@ -181,7 +181,7 @@ MOT是一种内存数据库存储引擎（IMDB），其中所有表和索引完 在配置max_mot_local_memory设置和应用程序开发时，请考虑此场景。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅[内存（MOT）](3-mot-deployment#内存mot)部分。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅[内存（MOT）](3-mot-deployment#内存mot)部分。
@@ -209,7 +209,7 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 检查点之所以需要两倍大小，是因为快照会保存数据的全部大小到磁盘上，此外还应该为正在进行的检查点分配同样数量的空间。当检查点进程结束时，以前的检查点文件将被删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在下一个MogDB版本中，MOT将有一个增量检查点特性，这将大大降低存储容量需求。 - **日志记录** @@ -223,4 +223,4 @@ MOT是一个内存优化的持久化数据库存储引擎。需要磁盘驱动 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低延迟的驱动器上。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅[存储（MOT）](3-mot-deployment#存储mot)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅[存储（MOT）](3-mot-deployment#存储mot)。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md index 07e972bf..3face88d 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/3-mot-deployment.md @@ -297,7 +297,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 阅读[总体原则](#总体原则)，根据需要查看和配置mot.conf文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，[MOT恢复](5-mot-administration#mot恢复)说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的[MOT恢复](5-mot-administration#mot恢复)。下文各相关章节中还提供了参考链接。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以上描述了mot.conf文件中的各个设置。除上述内容外，要了解特定MOT功能（如恢复），可参考本用户手册的相关章节。例如，[MOT恢复](5-mot-administration#mot恢复)说明了mot.conf文件的恢复，包含影响MOT恢复的设置。此外，有关恢复的完整说明，请参阅“MOT管理”章节的[MOT恢复](5-mot-administration#mot恢复)。下文各相关章节中还提供了参考链接。 以下介绍了mot.conf文件中的各个部分，其包含的设置以及默认值。 @@ -395,7 +395,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 检查点由多个MOT引擎工作线程并行执行。工作线程的数量可能会大大影响整个检查点操作的整体性能，以及其它正在运行的事务的操作。为了实现较短的检查点持续时间，应使用更多线程，直至达到最佳数量（根据硬件和工作负载的不同而不同）。但请注意，如果这个数目太大，可能会对其他正在运行的事务的执行时间产生负面影响。尽可能低这个数字，以最小化对其他运行事务的运行时的影响。当此数目过高时，检查点持续时间会较长。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的更多信息，请参阅[MOT检查点](5-mot-administration#mot检查点)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的更多信息，请参阅[MOT检查点](5-mot-administration#mot检查点)。
@@ -405,7 +405,7 @@ mot.conf文件与postgres.conf配置文件在同一文件夹下。 指定在检查点数据恢复期间要使用的工作线程数。每个MOT引擎工作线程在自己的核上运行，通过将不同的表读入内存，可以并行处理不同的表。缺省值为3，可将此参数设置为可处理的核数。恢复后，将停止并杀死这些线程。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅[MOT恢复](5-mot-administration#mot恢复)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅[MOT恢复](5-mot-administration#mot恢复)。
diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md index 2a1e83ee..f7f87e7d 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/4-mot-usage.md @@ -30,7 +30,7 @@ MogDB允许应用程序使用MOT和基于标准磁盘的表。MOT适用于最活 以授予数据库用户对MOT存储引擎的访问权限为例。每个数据库用户仅执行一次，通常在初始配置阶段完成。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT通过外部数据封装器（Foreign Data Wrapper，FDW）机制与MogDB数据库集成，所以需要授权用户权限。 要使特定用户能够创建和访问MOT（DDL、DML、SELECT），以下语句只执行一次： @@ -96,7 +96,7 @@ create FOREIGN table bmsql_oorder ( create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) ; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在MOT名字之前不需要指定FOREIGN关键字，因为它仅用于创建和删除表的命令。 有关MOT索引限制，请参见[MOT SQL覆盖和限制](#mot-sql覆盖和限制)的索引部分内容。 @@ -134,7 +134,7 @@ create index bmsql_oorder_index1 on bmsql_oorder(o_w_id, o_d_id, o_c_id, o_id) 6. 浏览或手动验证所有原始数据是否正确导入到新的MOT中。下面将举例说明。 7. 恢复应用程序活动。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 由于表名称保持不变，应用程序查询和相关数据库存储过程将能够无缝访问新的MOT，而无需更改代码。请注意，MOT目前不支持跨引擎多表查询（如使用Join、Union和子查询）和跨引擎多表事务。因此，如果在多表查询、存储过程或事务中访问原始表，则必须将所有相关的磁盘表转换为MOT，或者更改应用程序或数据库中的相关代码。
@@ -301,7 +301,7 @@ MOT编译支持的特性和不支持的特性见下文。 在乐观并发控制（OCC）中，在COMMIT阶段前的事务期间（使用任何隔离级别）不会对记录进行锁定。这是一个能显著提高性能的强大优势。它的缺点是，如果另一个会话尝试更新相同的记录，则更新可能会失败。所以必须中止整个事务。这些所谓的更新冲突是由MOT在提交时通过版本检查机制检测到的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用悲观并发控制的引擎，如标准Postgres和MogDB基于磁盘的表，当使用SERIALIZABLE或REPEATABLE-READ隔离级别时，也会发生类似的异常中止。 这种更新冲突在常见的OLTP场景中非常少见，在使用MOT时尤其少见。但是，由于仍有可能发生这种情况，开发人员应该考虑使用事务重试代码来解决此问题。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md index a9733c97..902fc841 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/5-mot-administration.md @@ -133,7 +133,7 @@ WAL重做日志将保留所有表行修改，直到执行检查点（如上所 - group_commit_size：一组已提交的事务数。例如，16表示当同一组中的16个事务已由它们的客户端应用程序提交时，则针对16个事务中的每个事务，在磁盘的WAL重做日志中写入一个条目。 - group_commit_timeout：超时时间，单位为毫秒。例如，10表示在10毫秒之后，为同一组由客户端应用程序在最近10毫秒内提交的每个事务，在磁盘的WAL重做日志中写入一个条目。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 有关配置的详细信息，请参阅[重做日志（MOT）](3-mot-deployment#重做日志mot)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 有关配置的详细信息，请参阅[重做日志（MOT）](3-mot-deployment#重做日志mot)。
@@ -408,7 +408,7 @@ MOT使用返回码（Return Code，RC）返回Postgres标准错误代码至封 MOT从内部返回Postgres代码（见下文）到数据库包，数据库封装根据标准的Postgres行为对其做出反应。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 提示信息中的%s、%u、%lu指代相应的错误信息（如查询、表名或其他信息）。 - %s：字符串 - %u：数字 - %lu：数字 **表 2** 返回给用户并记录到日志文件的错误 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md index 5a5eee2a..6aa4b1d4 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/2-using-mot/6-mot-sample-tpcc-benchmark.md @@ -47,7 +47,7 @@ tpm-C指标是每分钟执行的新订单事务数。考虑到事务中所需的 tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 官方TPC-C基准规范可访问[此页面](http://www.tpc.org/tpc_documents_current_versions/pdf/tpc-c_v5.11.0.pdf)。本规范中的一些规则在行业中难以实现，因为对行业现状来说这些规则太严格了。例如：扩容规则（a） tpm-C/Warehouse必须大于9且小于12.86（要达到较高的tpm-C率，需要很高的仓库费率。这就意味着需要非常大的数据库和内存容量）以及规则（b）10倍终端*仓库（意味着大量的模拟客户端）。 ## 系统级优化 @@ -65,7 +65,7 @@ tpm-C指标单位表示为每分钟事务数-C，而C表示TPC-C特定基准。 在下载的Java文件（与原始文件相比）中所做的唯一更改是注释错误日志打印，以进行序列化和重复键错误。这些错误在MOT中是正常的，因为MOT使用的是乐观并发控制（OCC）机制。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 基准测试使用标准交互式SQL模式执行，没有存储过程。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 基准测试使用标准交互式SQL模式执行，没有存储过程。 ## 运行基准 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md index a3b7c461..0784b7a6 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-1.md @@ -17,7 +17,7 @@ MOT旨在实现以下目标： - **线性扩容**：MOT提供事务性存储引擎，利用单个NUMA架构服务器的所有核，以提供近线性的扩容性能。这意味着MOT的目标是在机器的核数和性能提升倍数之间实现直接的、近线性的关系。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT的近线性扩容效果明显优于所有现有方案，并且尽可能接近于获得最佳效果，因现有方案皆受限于硬件（如电线）的物理限制和局限性。 - **无最大核数限制**：MOT对最大核数不做任何限制。这意味着MOT可从单核扩展到高达1000秒的多核，并且新增的核退化速度最小，即便是在跨NUMA槽位边界的情况下。 - **极高的事务性吞吐量**：MOT提供了一个事务性存储引擎，与市场上任何其他OLTP供应商相比，它能够实现极高的事务性吞吐量。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md index 34723536..c0796f30 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-2.md @@ -9,7 +9,7 @@ date: 2021-03-04 通过大量研究，我们找到了最佳的并发控制机制，结论为：基于SILO的OCC算法是MOT中最符合ACID特性的OCC算法。SILO为满足MOT的挑战性需求提供了最好的基础。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如[MOT简介](1-mot-introduction)所述。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MOT完全符合原子性、一致性、隔离性、持久性（ACID）特性，如[MOT简介](1-mot-introduction)所述。 下面介绍MOT的并发控制机制。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md index 21161c18..0525485d 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/mot-engine/3-concepts-of-mot/3-6.md @@ -40,7 +40,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 - 在恢复期间，从最后一个已知或特定检查点加载数据；然后使用WAL重做日志完成从该点开始发生的数据更改。 - WAL重做日志将保留所有表行修改，直到执行一个检查点为止（如上所述）。然后可以截断日志，以减少恢复时间和节省磁盘空间。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 为了确保日志IO设备不会成为瓶颈，日志文件必须放在具有低时延的驱动器上。
@@ -86,7 +86,7 @@ MOT全面集成MogDB的封装日志记录设施。除持久性外，这种方法 这样，将事务写入WAL更为有效，因为来自同一个槽位的所有缓冲区都一起写入磁盘。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 每个线程在属于单个槽位的单核/CPU上运行，每个线程只写运行于其上的核的槽位。 2. 在事务完成并且客户端应用程序发送Commit命令之后，事务重做日志条目将与属于同一组的其他事务一起序列化。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md index 41ad61ff..269a64b4 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/0-starting-and-stopping-mogdb.md @@ -17,7 +17,7 @@ date: 2021-06-24 gs_om -t start ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 双机启动必须以双机模式启动，若中间过程以单机模式启动，则必须修复才能恢复双机关系，用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 双机启动必须以双机模式启动，若中间过程以单机模式启动，则必须修复才能恢复双机关系，用gs_ctl build进行修复，gs_ctl的使用方法参见“参考指南 > 工具参考 > 系统内部使用的工具 > [gs_ctl](4-gs_ctl)”章节。 ## 停止MogDB @@ -29,7 +29,7 @@ date: 2021-06-24 gs_om -t stop ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 启停节点及AZ的操作请参见“参考指南 > 工具参考 > 服务端工具 > [gs_om](8-gs_om)”章节。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/11-log-reference.md b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/11-log-reference.md index c69810ae..9a5ade00 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/11-log-reference.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/11-log-reference.md @@ -75,7 +75,7 @@ OM MogDB安装卸载时产生的日志放在“/var/log/mogdb/用户名/om”目 其中`$GAUSSLOG`默认为`/var/log/mogdb/_用户名_`。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果使用om脚本部署时，则日志路径为`/var/log/mogdb/_用户名_`。 **日志文件命名格式** @@ -117,7 +117,7 @@ OM MogDB安装卸载时产生的日志放在“/var/log/mogdb/用户名/om”目 例如，系统中的第一个事务日志文件是000000010000000000000000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这些数字一般情况下是顺序增长使用的（要把所有可用数字都用光也需要非常长的时间），但也存在循环使用的情况。 **日志内容说明** @@ -150,4 +150,4 @@ postgresql-创建时间.prf 数据库节点每一行日志内容的默认格式： -主机名称+日期+时间+实例名称+线程号+日志内容。 \ No newline at end of file +主机名称+日期+时间+实例名称+线程号+日志内容。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md index d64a7bea..c18f8ba5 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/routine-maintenance/using-the-gsql-client-for-connection.md @@ -63,7 +63,7 @@ date: 2021-12-2 3. 获取软件安装包中的"MogDB-x.x.x-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -102,7 +102,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -144,7 +144,7 @@ date: 2021-12-2 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -155,7 +155,7 @@ date: 2021-12-2
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -197,7 +197,7 @@ date: 2021-12-2 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > + 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v3.0/administrator-guide/upgrade-guide.md b/product/zh/docs-mogdb/v3.0/administrator-guide/upgrade-guide.md index 1c73b822..1425a506 100644 --- a/product/zh/docs-mogdb/v3.0/administrator-guide/upgrade-guide.md +++ b/product/zh/docs-mogdb/v3.0/administrator-guide/upgrade-guide.md @@ -302,7 +302,7 @@ root用户密码 3. 重置控制文件格式以兼容2.1.0版本中新增的ustore存储引擎（仅限于2.0.1升级到2.1）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**警告：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif)**警告**: > > - 此操作不可回退，执行后无法再降级回2.0.1版本。 > - 执行此操作前，建议参考[逻辑备份恢复](1-3-br)做一次数据全备份。 diff --git a/product/zh/docs-mogdb/v3.0/characteristic-description/database-security/11-password-strength-verification.md b/product/zh/docs-mogdb/v3.0/characteristic-description/database-security/11-password-strength-verification.md index 1bf5f492..df379ca7 100644 --- a/product/zh/docs-mogdb/v3.0/characteristic-description/database-security/11-password-strength-verification.md +++ b/product/zh/docs-mogdb/v3.0/characteristic-description/database-security/11-password-strength-verification.md @@ -34,7 +34,7 @@ date: 2022-05-07 - 不能和当前密码、当前密码的倒写相同。 - 不能是弱口令。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 弱口令指的是强度较低，容易被破解的密码，对于不同的用户或群体，弱口令的定义可能会有所区别，用户需要自己添加定制化的弱口令。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 弱口令指的是强度较低，容易被破解的密码，对于不同的用户或群体，弱口令的定义可能会有所区别，用户需要自己添加定制化的弱口令。 参数password_policy设置为1时表示采用密码复杂度校验，默认值为1。 @@ -68,4 +68,4 @@ MogDB 1.1.0版本实现了弱口令字典功能。 ## 依赖关系 -无。 \ No newline at end of file +无。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14-example-logic-replication-code.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14-example-logic-replication-code.md index 4f91937c..f31674f0 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14-example-logic-replication-code.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14-example-logic-replication-code.md @@ -19,7 +19,7 @@ date: 2021-04-26 通过配置选项decode-style，指定解码格式。其取值为char型的字符'j'、't'或'b'，分别代表json格式、text格式及二进制格式。默认值为'b'即二进制格式解码。该选项仅允许并行解码时设置，且二进制格式解码仅在并行解码场景下支持。 -> **说明：** +> **说明**: > 二进制格式编码规则如下所示： > > 1. 前4字节代表接下来到语句级别分隔符字母P（不含）或者该批次结束符F（不含）的解码结果的总字节数，该值如果为0代表本批次解码结束。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md index aa525374..7f719831 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/14.1-example-parameters-for-connecting-to-the-database-in-different-scenarios.md @@ -7,7 +7,7 @@ date: 2021-10-11 # 示例：不同场景下连接数据库参数配置 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 以下示例场景中node代表“host:port”，host为数据库服务器名称或IP地址，port为数据库服务器端口。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 以下示例场景中node代表“host:port”，host为数据库服务器名称或IP地址，port为数据库服务器端口。 ## 容灾场景 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md index 0c36598e..b90cd0c0 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/1-java-sql-Connection.md @@ -63,5 +63,5 @@ java.sql.Connection是数据库连接接口。 | setTransactionIsolation(int level) | void | Yes | | setTypeMap(Map<String,Class<?>> map) | void | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 接口内部默认使用自动提交模式，若通过setAutoCommit(false)关闭自动提交，将会导致后面执行的语句都受到显式事务包裹，数据库中不支持事务中执行的语句不能在此模式下执行。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md index dbb92d0e..f74ce9f4 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/2-java-sql-CallableStatement.md @@ -39,7 +39,7 @@ java.sql.CallableStatement是存储过程执行接口。 | registerOutParameter(int parameterIndex, int type) | void | Yes | | wasNull() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不允许含有OUT参数的语句执行批量操作。 > - 以下方法是从java.sql.Statement继承而来：close，execute，executeQuery，executeUpdate，getConnection，getResultSet，getUpdateCount，isClosed，setMaxRows , setFetchSize。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/3-java-sql-DatabaseMetaData.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/3-java-sql-DatabaseMetaData.md index d84faf52..8616361c 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/3-java-sql-DatabaseMetaData.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/3-java-sql-DatabaseMetaData.md @@ -189,22 +189,22 @@ java.sql.DatabaseMetaData是数据库对象定义接口。 | getJDBCMajorVersion() | int | Yes | | getJDBCMinorVersion() | int | Yes | -> **说明：** +> **说明**: > -> uppercaseAttributeName为true时，以下接口会将查询结果转为大写，可转换范围与java中的toUpperCase方法一致。 +> uppercaseAttributeName为true时，以下接口会将查询结果转为大写，可转换范围与java中的toUpperCase方法一致。 > -> - public ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) -> - public ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) -> - public ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) -> - public ResultSet getSchemas(String catalog, String schemaPattern) -> - public ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) -> - public ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) -> - public ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) -> - public ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) -> - public ResultSet getPrimaryKeys(String catalog, String schema, String table) -> - protected ResultSet getImportedExportedKeys(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) -> - public ResultSet getIndexInfo(String catalog, String schema, String tableName, boolean unique, boolean approximate) -> - public ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) +> - public ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) +> - public ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) +> - public ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) +> - public ResultSet getSchemas(String catalog, String schemaPattern) +> - public ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) +> - public ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) +> - public ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) +> - public ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) +> - public ResultSet getPrimaryKeys(String catalog, String schema, String table) +> - protected ResultSet getImportedExportedKeys(String primaryCatalog, String primarySchema, String primaryTable, String foreignCatalog, String foreignSchema, String foreignTable) +> - public ResultSet getIndexInfo(String catalog, String schema, String tableName, boolean unique, boolean approximate) +> - public ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) > - public ResultSet getFunctions(String catalog, String schemaPattern, String functionNamePattern) > **注意：** diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md index 19a170d4..238f803f 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/5-java-sql-PreparedStatement.md @@ -61,7 +61,7 @@ java.sql.PreparedStatement是预处理语句接口。 | addBatch() | void | Yes | | executeBatch() | int[] | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - addBatch()、execute()必须在clearBatch()之后才能执行。 > - 调用executeBatch()方法并不会清除batch。用户必须显式使用clearBatch()清除 。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md index 1daf58a3..5a009523 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/6-java-sql-ResultSet.md @@ -148,7 +148,7 @@ java.sql.ResultSet是执行结果集接口。 | updateTimestamp(String columnLabel, Timestamp x) | void | Yes | | wasNull() | Boolean | Yes | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一个Statement不能有多个处于"open"状态的ResultSet。 > - 用于遍历结果集(ResultSet)的游标(Cursor)在被提交后不能保持“open”的状态。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/7-java-sql-ResultSetMetaData.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/7-java-sql-ResultSetMetaData.md index d7ce03f2..6894afc1 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/7-java-sql-ResultSetMetaData.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/7-java-sql-ResultSetMetaData.md @@ -35,9 +35,9 @@ java.sql.ResultSetMetaData是对ResultSet对象相关信息的具体描述。 | isSigned(int column) | boolean | Yes | | isWritable(int column) | boolean | Yes | -> **说明：** +> **说明**: > -> uppercaseAttributeName为true时，下面接口会将查询结果转为大写，可转换范围为26个英文字母。 +> uppercaseAttributeName为true时，下面接口会将查询结果转为大写，可转换范围为26个英文字母。 > -> - public String getColumnName(int column) +> - public String getColumnName(int column) > - public String getColumnLabel(int column) diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md index 1b50c614..0fe3fbb1 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/15-JDBC/8-java-sql-Statement.md @@ -62,7 +62,7 @@ java.sql.Statement是SQL语句接口。 | executeLargeUpdate(String sql, int[] columnIndexes) | long | No | | executeLargeUpdate(String sql, String[] columnNames) | long | No | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 通过setFetchSize可以减少结果集在客户端的内存占用情况。它的原理是通过将结果集打包成游标，然后分段处理，所以会加大数据库与客户端的通信量，会有性能损耗。 > - 由于数据库游标是事务内有效，所以，在设置setFetchSize的同时，需要将连接设置为非自动提交模式，setAutoCommit(false)。同时在业务数据需要持久化到数据库中时，在连接上执行提交操作。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md index 70a66c6c..1e41522a 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/2-development-based-on-jdbc/7-running-sql-statements.md @@ -28,8 +28,8 @@ date: 2021-06-07 > **说明:** > - > - 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，事务块中不支持vacuum操作。如果其中有一个语句失败，那么整个请求都将会被回滚。 - > - 使用Statement执行多语句时应以“;”作为各语句间的分隔符，存储过程、函数、匿名块不支持多语句执行。 + > - 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，事务块中不支持vacuum操作。如果其中有一个语句失败，那么整个请求都将会被回滚。 + > - 使用Statement执行多语句时应以“;”作为各语句间的分隔符，存储过程、函数、匿名块不支持多语句执行。 > - “/”可用作创建单个存储过程、函数、匿名块的结束符。 3. 关闭语句对象。 @@ -138,7 +138,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: > > - MogDB数据库不支持带有输出参数的函数，也不支持存储过程和函数参数默认值。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 > @@ -172,7 +172,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: ``` // 注册out类型的参数，类型为复合类型,格式为“schema.typename”。 - cs.registerOutParameter(2, Types.STRUCT, "public.compfoo"); + cs.registerOutParameter(2, Types.STRUCT, "public.compfoo"); ``` 4. 调用CallableStatement的execute执行方法调用。 @@ -184,7 +184,7 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: 5. 调用CallableStatement的getObject方法获取输出参数。 ``` - PGobject result = (PGobject)cs.getObject(2); // 获取out参数 + PGobject result = (PGobject)cs.getObject(2); // 获取out参数 result.getValue(); // 获取复合类型字符串形式值。 result.getArrayValue(); //获取复合类型数组形式值，以复合数据类型字段顺序排序。 result.getStruct(); //获取复合类型子类型名，按创建顺序排序。 @@ -196,10 +196,10 @@ MogDB支持通过JDBC直接调用事先创建的存储过程，步骤如下: cs.close(); ``` - > **说明：** + > **说明**: > - > - oracle兼容模式开启参数后，调用存储过程必须使用{call proc_name(?,?,?)}形式调用，调用函数必须使用{? = call func_name(?,?)}形式调用（等号左侧的“？”为函数返回值的占位符，用于注册函数返回值)。 - > - 参数behavior_compat_options='proc_outparam_override'行为变更后，业务需要重新建立连接，否则无法正确调用存储过程和函数。 + > - oracle兼容模式开启参数后，调用存储过程必须使用{call proc_name(?,?,?)}形式调用，调用函数必须使用{? = call func_name(?,?)}形式调用（等号左侧的“？”为函数返回值的占位符，用于注册函数返回值)。 + > - 参数behavior_compat_options='proc_outparam_override'行为变更后，业务需要重新建立连接，否则无法正确调用存储过程和函数。 > - 函数和存储过程中包含复合类型时，参数的绑定与注册需要使用schema.typename形式。 示例： diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/4-development-process.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/4-development-process.md index 70c61839..8497be1a 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/4-development-process.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/4-development-process.md @@ -39,6 +39,6 @@ date: 2021-04-26 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明:** > 数据库中收到的一次执行请求（不在事务块中)，如果含有多条语句，将会被打包成一个事务，同时如果其中有一个语句失败，那么整个请求都将会被回滚。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **警告：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **警告**: > > ODBC为应用程序与数据库的中心层，负责把应用程序发出的SQL指令传到数据库当中，自身并不解析SQL语法。故在应用程序中写入带有保密信息的SQL语句时（如明文密码），保密信息会被暴露在驱动日志中。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md index 07c3729b..de4a3c87 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/3-development-based-on-odbc/5.1-typical-application-scenarios-and-configurations.md @@ -33,7 +33,7 @@ Servername=10.10.0.13（数据库Server IP） Debug=1（打开驱动端debug日志） ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** unixODBC日志将会生成在TraceFile配置的路径下，psqlODBC会在系统/tmp/下生成mylog_xxx.log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: unixODBC日志将会生成在TraceFile配置的路径下，psqlODBC会在系统/tmp/下生成mylog_xxx.log。 ## 高性能场景 @@ -493,4 +493,4 @@ int main() } ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 上述用例中定义了number列，调用SQLBindParameter接口时，绑定SQL_NUMERIC会比SQL_LONG性能高一些。因为如果是char，在数据库服务端插入数据时需要进行数据类型转换，从而引发性能瓶颈。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 上述用例中定义了number列，调用SQLBindParameter接口时，绑定SQL_NUMERIC会比SQL_LONG性能高一些。因为如果是char，在数据库服务端插入数据时需要进行数据类型转换，从而引发性能瓶颈。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md index 7dbb5a0a..fefdd9f3 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/11-PQprepare.md @@ -42,7 +42,7 @@ PGresult：包含查询结果的对象指针。 - PQprepare创建一个为PQexecPrepared执行用的预备语句，本特性支持命令的重复执行，不需要每次都进行解析和规划。PQprepare仅在协议3.0及以后的连接中支持，使用协议2.0时，PQprepare将失败。 - 该函数从查询字符串创建一个名为stmtName的预备语句，该查询字符串必须包含一个SQL命令。stmtName可以是”“来创建一个未命名的语句，在这种情况下，任何预先存在的未命名的语句都将被自动替换；否则，如果在当前会话中已经定义了语句名称，则这是一个错误。如果使用了任何参数，那么在查询中将它们称为$1,$2等。nParams是在paramTypes[]数组中预先指定类型的参数的数量。（当nParams为0时，数组指针可以为NULL） paramTypes[]通过OID指定要分配给参数符号的数据类型。如果paramTypes为NULL ，或者数组中的任何特定元素为零，服务器将按照对非类型化字面字符串的相同方式为参数符号分配数据类型。另外，查询可以使用数字高于nParams的参数符号；还将推断这些符号的数据类型。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过执行SQLPREPARE语句，还可以创建与PQexecPrepared一起使用的预备语句。此外，虽然没有用于删除预备语句的libpq函数，但是SQL DEALLOCATE语句可用于此目的。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md index 40b9d44f..01bbbdfd 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/2-libpq/2-database-statement-execution-functions/2-PQexec.md @@ -34,7 +34,7 @@ PGresult：包含查询结果的对象指针。 应该调用PQresultStatus函数来检查任何错误的返回值（包括空指针的值，在这种情况下它将返回PGRES_FATAL_ERROR）。使用PQerrorMessage获取有关错误的更多信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 命令字符串可以包括多个SQL命令（用分号分隔）。在一个PQexec调用中发送的多个查询是在一个事务里处理的，除非在查询字符串里有明确的BEGIN/COMMIT命令把整个字符串分隔成多个事务。请注意，返回的PGresult结构只描述字符串里执行的最后一条命令的结果，如果有一个命令失败，那么字符串处理的过程就会停止，并且返回的PGresult会描述错误条件。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/development-process.md b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/development-process.md index 9250d233..509208bc 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/development-process.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/dev/4-development-based-on-libpq/development-process.md @@ -11,7 +11,7 @@ date: 2022-04-26 1. 解压相应的发布包（如`MogDB-3.0.0-CentOS-64bit-Libpq.tar.gz`）文件，其中include文件夹下的头文件为所需的头文件，lib文件夹中为所需的libpq库文件。 - > **说明：** 除libpq-fe.h外，include文件夹下默认还存在头文件postgres_ext.h，gs_thread.h，gs_threadlocal.h，这三个头文件是libpq-fe.h的依赖文件。 + > **说明**: 除libpq-fe.h外，include文件夹下默认还存在头文件postgres_ext.h，gs_thread.h，gs_threadlocal.h，这三个头文件是libpq-fe.h的依赖文件。 2. 包含libpq-fe.h头文件： diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/logical-replication/logical-decoding/2-logical-decoding-by-sql-function-interfaces.md b/product/zh/docs-mogdb/v3.0/developer-guide/logical-replication/logical-decoding/2-logical-decoding-by-sql-function-interfaces.md index 00a2d6f1..d3d56951 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/logical-replication/logical-decoding/2-logical-decoding-by-sql-function-interfaces.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/logical-replication/logical-decoding/2-logical-decoding-by-sql-function-interfaces.md @@ -13,7 +13,7 @@ MogDB可以通过调用SQL函数，进行创建、删除、推进逻辑复制槽 - 逻辑日志目前从主机节点中抽取，默认关闭SSL连接，如果进行逻辑复制，需要先配置GUC参数[ssl](2-security-and-authentication#ssl)=on。 - > **说明：** 为避免安全风险，请保证启用SSL连接。 + > **说明**: 为避免安全风险，请保证启用SSL连接。 - 设置GUC参数[wal_level](1-settings#wal_level)=logical。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-11-cursors.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-11-cursors.md index 23e0f1f2..159c1dfe 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-11-cursors.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-11-cursors.md @@ -11,7 +11,7 @@ date: 2021-03-04 为了处理SQL语句，存储过程进程分配一段内存区域来保存上下文联系。游标是指向上下文区域的句柄或指针。借助游标，存储过程可以控制上下文区域的变化。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知**: > > 当游标作为存储过程的返回值时，如果使用JDBC调用该存储过程，返回的游标将不可用。 @@ -53,7 +53,7 @@ date: 2021-03-04 - select_statement：查询语句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > 根据执行计划的不同，系统会自动判断该游标是否可以用于以倒序的方式检索数据行。 @@ -126,7 +126,7 @@ date: 2021-03-04 **格式调用为**： SQL% -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > - INSERT、UPDATE、DELETE、SELECT语句中不必明确定义游标。 > - 兼容O模式下，GUC参数behavior_compat_options为compat_cursor时，隐式游标跨存储过程有效。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-13-debugging.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-13-debugging.md index aed5dc49..9cc66639 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-13-debugging.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-13-debugging.md @@ -57,12 +57,12 @@ date: 2021-03-04 如果在RAISE EXCEPTION命令中既没有指定条件名也没有指定SQLSTATE，默认用RAISE EXCEPTION (P0001)。如果没有指定消息文本，默认用条件名或者SQLSTATE作为消息文本。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知**: > > - 当由SQLSTATE指定了错误码，则不局限于已定义的错误码，可以选择任意包含五个数字或者大写的ASCII字母的错误码，而不是00000。建议避免使用以三个0结尾的错误码，因为这种错误码是类别码，会被整个种类捕获。 > - 兼容O模式下，SQLCODE等于SQLSTATE。 > -> ![https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** +> ![https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > [图5](#raise::=)所示的语法不接任何参数。这种形式仅用于一个BEGIN块中的EXCEPTION语句，它使得错误重新被处理。 @@ -79,7 +79,7 @@ date: 2021-03-04 - exception_name为用户申明的异常名，EXCEPTION_INIT语法必须出现在与申明异常相同部分，位于申明异常之后。 - sqlcode为自定义的SQLCODE，必须为负整数，取值范围-2147483647~-1。 -> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知：** 使用EXCEPTION_INIT语法自定义错误码SQLCODE时，SQLSTATE与SQLCODE相同，SQLERRM格式为” xxx: non-MogDB Exception”。比如自定义SQLCODE=-1，则SQLSTATE=“-1”，SQLERRM=” 1: non-MogDB Exception”。 +> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知**: 使用EXCEPTION_INIT语法自定义错误码SQLCODE时，SQLSTATE与SQLCODE相同，SQLERRM格式为” xxx: non-MogDB Exception”。比如自定义SQLCODE=-1，则SQLSTATE=“-1”，SQLERRM=” 1: non-MogDB Exception”。 ## **示例** @@ -104,10 +104,10 @@ HINT: Please check your user ID ```sql CREATE OR REPLACE PROCEDURE proc_raise2(user_id in integer) -AS -BEGIN -RAISE 'Duplicate user ID: %',user_id USING ERRCODE = 'unique_violation'; -END; +AS +BEGIN +RAISE 'Duplicate user ID: %',user_id USING ERRCODE = 'unique_violation'; +END; / \set VERBOSITY verbose @@ -127,20 +127,20 @@ RAISE SQLSTATE '22012'; 例如： ```sql -CREATE OR REPLACE PROCEDURE division(div in integer, dividend in integer) -AS -DECLARE -res int; - BEGIN - IF dividend=0 THEN - RAISE division_by_zero; - RETURN; - ELSE - res := div/dividend; +CREATE OR REPLACE PROCEDURE division(div in integer, dividend in integer) +AS +DECLARE +res int; + BEGIN + IF dividend=0 THEN + RAISE division_by_zero; + RETURN; + ELSE + res := div/dividend; RAISE INFO 'division result: %', res; - RETURN; - END IF; - END; + RETURN; + END IF; + END; / call division(3,0); diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-14-package.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-14-package.md index 665cef65..d7aec342 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-14-package.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-14-package.md @@ -13,9 +13,9 @@ package包含包头（Package Specification）和Package Body两个部分，其 PACKAGE的创建请参见[CREATE PACKAGE](CREATE-PACKAGE)。 -> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知：** +> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知**: > -> - 跨PACKAGE变量不支持作为FOR循环中控制变量使用。 +> - 跨PACKAGE变量不支持作为FOR循环中控制变量使用。 > - PACKAGE中定义类型不支持删除、修改等操作，也不支持定义表。 -> - 不支持以SCHEMA.PACKAGE.CUROSR的形式引用cursor变量。 +> - 不支持以SCHEMA.PACKAGE.CUROSR的形式引用cursor变量。 > - 带参数的CURSOR仅支持在当前PACKAGE内打开。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-4-arrays-and-records.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-4-arrays-and-records.md index d2513b93..f5ad6e31 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-4-arrays-and-records.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-4-arrays-and-records.md @@ -57,7 +57,7 @@ MogDB支持使用圆括号来访问数组元素，且还支持一些特有的函 - data_type：要创建的集合中成员的类型。 - indexby_type： 创建集合索引的类型。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在MogDB中，集合会自动增长，访问越界会返回一个NULL，不会报错。 > - 在存储过程中定义的集合类型，其作用域仅在该存储过程中。 @@ -75,7 +75,7 @@ MogDB支持使用圆括号来访问集合元素，且还支持一些特有的函 集合函数支持multiset union/intersect/except all/distinct函数。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 同一个表达式里不支持两个以上table of index by类型变量的函数调用。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-5-declare-syntax.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-5-declare-syntax.md index 77a4bfce..b204032e 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-5-declare-syntax.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-5-declare-syntax.md @@ -70,7 +70,7 @@ PL/SQL块可以分为以下几类： - 匿名块程序实施部分，以BEGIN语句开始，以END语句停顿，以一个分号结束。输入“/”按回车执行它。 - > **须知：** + > **须知**: > 最后的结束符”/“必须独占一行，不能直接跟在END后面。 - 声明部分包括变量定义、类型、游标定义等。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-6-basic-statements.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-6-basic-statements.md index bef934fc..f6fa87bc 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-6-basic-statements.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-6-basic-statements.md @@ -9,7 +9,7 @@ date: 2021-03-04 在编写PL/SQL过程中，会定义一些变量，给变量赋值，调用其他存储过程等。介绍PL/SQL中的基本语句，包括定义变量、赋值语句、调用语句以及返回语句。 -> **说明：** +> **说明**: > 尽量不要在存储过程中调用包含密码的SQL语句，因为存储在数据库中的存储过程文本可能被其他有权限的用户看到导致密码信息被泄漏。如果存储过程中包含其他敏感信息也需要配置存储过程的访问权限，保证敏感信息不会泄漏。 ## 定义变量 @@ -77,7 +77,7 @@ my_name cur.firstname%TYPE my_employee2 cur -- 对于PACKAGE中定义的cursor，可以省略%ROWTYPE字段 ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - %TYPE不支持引用复合类型或RECORD类型变量的类型、RECORD类型的某列类型、跨PACKAGE复合类型变量的某列类型、跨PACKAGE cursor变量的某列类型等。 > - %ROWTYPE不支持引用复合类型或RECORD类型变量的类型、跨PACKAGE cursor的类型。 @@ -146,7 +146,7 @@ END; / ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - INTO 方式赋值仅支持对第一层列赋值，且不支持二维及以上数组； > - 引用嵌套的列值时，若存在数组下标，目前仅支持在前三层列中只存在一个小括号情况，建议使用方括号[ ]引用下标； @@ -174,7 +174,7 @@ END; / ``` -> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知：** BULK COLLECT INTO 只支持批量赋值给数组。合理使用LIMIT字段避免操作过量数据导致性能下降。 +> ![img](https://opengauss.org/zh/docs/3.0.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知**: BULK COLLECT INTO 只支持批量赋值给数组。合理使用LIMIT字段避免操作过量数据导致性能下降。 ## 调用语句 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-8-control-statements.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-8-control-statements.md index dc0ee2bf..7ebc8a65 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-8-control-statements.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/1-8-control-statements.md @@ -190,9 +190,9 @@ MogDB有五种形式的IF： RETURN; END; / - + CALL proc_control_structure(3); - + --删除存储过程 DROP PROCEDURE proc_control_structure; ``` @@ -228,7 +228,7 @@ AS CALL proc_loop(10,5); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知**: > > 该循环必须要结合EXIT使用，否则将陷入死循环。 @@ -486,7 +486,7 @@ DROP TABLE mytab; 当控制到达给y赋值的地方时，会有一个division_by_zero错误失败。这个错误将被EXCEPTION子句捕获。而在RETURN语句里返回的数值将是x的增量值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > 进入和退出一个包含EXCEPTION子句的块要比不包含的块开销大的多。因此，不必要的时候不要使用EXCEPTION。 > 在下列场景中，无法捕获处理异常，整个存储过程回滚：节点故障、网络故障引起的存储过程参与节点线程退出以及COPY FROM操作中源数据与目标表的表结构不一致造成的异常。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/advanced-packages/basic-interfaces/PKG_SERVICE.md b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/advanced-packages/basic-interfaces/PKG_SERVICE.md index c842ceb6..a75dceeb 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/advanced-packages/basic-interfaces/PKG_SERVICE.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/plpgsql/advanced-packages/basic-interfaces/PKG_SERVICE.md @@ -39,7 +39,7 @@ PKG_SERVICE支持的所有接口请参见表1。 ```sql PKG_SERVICE.SQL_IS_CONTEXT_ACTIVE( - context_id IN INTEGER + context_id IN INTEGER ) RETURN BOOLEAN; ``` @@ -82,7 +82,7 @@ PKG_SERVICE支持的所有接口请参见表1。 ```sql PKG_SERVICE.SQL_UNREGISTER_CONTEXT( - context_id IN INTEGER + context_id IN INTEGER ) RETURN INTEGER; ``` @@ -186,7 +186,7 @@ PKG_SERVICE支持的所有接口请参见表1。 context_id IN INTEGER, pos IN INTEGER, coltype_oid IN ANYELEMENT, - maxsize IN INTEGER + maxsize IN INTEGER ) RETURN INTEGER; ``` @@ -259,7 +259,7 @@ PKG_SERVICE支持的所有接口请参见表1。 job OUT INTEGER); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当创建一个定时任务（JOB）时，系统默认将当前数据库和用户名与当前创建的定时任务绑定起来。该接口函数可以通过call或select调用，如果通过select调用，可以不填写出参。如果在存储过程中，则需要通过perform调用该接口函数。如果提交的sql语句任务使用到非public的schema，应该指定表或者函数的schema，或者在sql语句前添加set current_schema = xxx;语句。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当创建一个定时任务（JOB）时，系统默认将当前数据库和用户名与当前创建的定时任务绑定起来。该接口函数可以通过call或select调用，如果通过select调用，可以不填写出参。如果在存储过程中，则需要通过perform调用该接口函数。如果提交的sql语句任务使用到非public的schema，应该指定表或者函数的schema，或者在sql语句前添加set current_schema = xxx;语句。 **表 11** PKG_SERVICE.JOB_SUBMIT接口参数说明 @@ -275,11 +275,11 @@ PKG_SERVICE支持的所有接口请参见表1。 ```sql SELECT PKG_SERVICE.JOB_SUBMIT(NULL, 'call pro_xxx();', to_date('20180101','yyyymmdd'),'sysdate+1'); - + SELECT PKG_SERVICE.JOB_SUBMIT(NULL, 'call pro_xxx();', to_date('20180101','yyyymmdd'),'sysdate+1.0/24'); - + CALL PKG_SERVICE.JOB_SUBMIT(NULL, 'INSERT INTO T_JOB VALUES(1); call pro_1(); call pro_2();', add_months(to_date('201701','yyyymm'),1), 'date_trunc(''day'',SYSDATE) + 1 +(8*60+30.0)/(24*60)' ,:jobid); - + SELECT PKG_SERVICE.JOB_SUBMIT (101, 'insert_msg_statistic1;', sysdate, 'sysdate+3.0/24'); ``` diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/postgis-extension/using-postgis.md b/product/zh/docs-mogdb/v3.0/developer-guide/postgis-extension/using-postgis.md index 51c59aee..7a87b6fb 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/postgis-extension/using-postgis.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/postgis-extension/using-postgis.md @@ -58,7 +58,7 @@ MogDB=# SELECT p1.city_name,p2.city_name,ST_Distance(p1.position,p2.position) FR MogDB=# DROP EXTENSION postgis [CASCADE]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** 如果Extension被其它对象依赖（如创建的几何表），需要加入CASCADE（级联)关键字，删除所有依赖对象。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: 如果Extension被其它对象依赖（如创建的几何表），需要加入CASCADE（级联)关键字，删除所有依赖对象。 若要完全删除PostGIS Extension，则需由omm用户使用gs_om工具移除PostGIS及其依赖的动态链接库，格式如下： diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md index 5aed7ada..9db2063a 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/creating-a-resource-pool.md @@ -36,7 +36,7 @@ MogDB支持通过创建资源池对主机资源进行划分。开启资源负载 | nodegroup | installation | 资源池所在的逻辑集群的名称。 | | is_foreign | f | 资源池不用于逻辑集群之外的用户。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** MogDB不允许对default_pool参数进行修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: MogDB不允许对default_pool参数进行修改。 ## 前提条件 @@ -66,7 +66,7 @@ MogDB支持通过创建资源池对主机资源进行划分。开启资源负载 CREATE RESOURCE POOL ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果在创建资源池的时候不指定所关联的控制组，则该资源池会被关联到默认控制组（DefaultClass控制组下的“Medium” Timeshare控制组）。 > - control_group取值区分大小写，指定时要使用单引号。 @@ -91,14 +91,14 @@ MogDB=# DROP RESOURCE POOL resource_pool_a2; DROP RESOURCE POOL ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果某个角色已关联到该资源池，无法删除。 > - 多租户场景下，如果删除组资源池，其业务资源池都将被删除。只有不关联用户时，资源池才能被删除。 ## 查看资源池的信息 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不允许使用INSERT、UPDATE、DELETE、TRUNCATE操作资源负载管理的系统表pg_resource_pool。 > - 不允许修改资源池的memory_limit和cpu_affinity属性。 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md index 4c2f6f2b..94bd2910 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/enabling-resource-load-management.md @@ -34,7 +34,7 @@ date: 2021-10-22 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果一个用户的login权限被取消，那么他的resource pool将会自动修改为default_pool。default_pool的详细介绍请参见[创建资源池](creating-a-resource-pool)中的表2。 ## 操作步骤 diff --git a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md index ecdaab3a..6e145cdf 100644 --- a/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md +++ b/product/zh/docs-mogdb/v3.0/developer-guide/resource-load-management/resource-management-preparation/setting-a-cgroup.md @@ -19,7 +19,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 ## 操作步骤 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在MogDB中，需要在每个集群节点上执行控制组的创建、更新、删除操作，才能实现对整个集群资源的控制，所以下述步骤中都使用《工具参考》中“服务端工具 > gs_ssh”命令执行。 > - 控制组的命名要求如下： @@ -74,7 +74,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 gs_ssh -c "gs_cgroup -u -S class_a -G workload_a1 -g 30" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 调整后的Workload控制组“workload_a1”占有的CPU资源不应大于其对应的子Class控制组“class_a”。并且，此名称不能是Timeshare Cgroup的默认名称，如“Low”、“Medium”、“High”或“Rush”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 调整后的Workload控制组“workload_a1”占有的CPU资源不应大于其对应的子Class控制组“class_a”。并且，此名称不能是Timeshare Cgroup的默认名称，如“Low”、“Medium”、“High”或“Rush”。 **删除控制组** @@ -86,7 +86,7 @@ Class控制组为数据库业务运行所在的顶层控制组，集群部署时 以上操作可以删除控制组“class_a”。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** root用户或者具有root访问权限的用户指定“-d” 和“-U username”删除普通用户“username”可访问的默认Cgroups。普通用户指定“-d”和“-S classname”可以删除已有的Class Cgroups。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: root用户或者具有root访问权限的用户指定“-d” 和“-U username”删除普通用户“username”可访问的默认Cgroups。普通用户指定“-d”和“-S classname”可以删除已有的Class Cgroups。 ## 查看控制组的信息 diff --git a/product/zh/docs-mogdb/v3.0/faqs/deployment-and-maintenance-faqs.md b/product/zh/docs-mogdb/v3.0/faqs/deployment-and-maintenance-faqs.md index c5b699c3..83c71904 100644 --- a/product/zh/docs-mogdb/v3.0/faqs/deployment-and-maintenance-faqs.md +++ b/product/zh/docs-mogdb/v3.0/faqs/deployment-and-maintenance-faqs.md @@ -293,7 +293,7 @@ Checking directory. print(staticConfigPath_dn) ``` - > **说明：**需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 + > **说明**: 需根据实际情况，修改主机IP地址和主机名。例如，在本示例中，主机IP地址为`172.16.0.176`，旧主机名为`mogdb-kernel-0005`，新主机名为`www.mogdb.com`。 2. 执行如下命令生成集群静态配置文件。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md index 2465b415..c0111b96 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/1-installation-preparation.md @@ -221,7 +221,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `$地区/$时区`为需要设置时区的信息，例如：Asia/Shanghai。 3. 使用**date -s**命令将各数据库节点的时间设置为统一时间，举例如下。 @@ -232,7 +232,7 @@ vim /etc/profile ### (可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 @@ -304,7 +304,7 @@ swapoff -a ### 关闭HISTORY记录 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 为避免指令历史记录安全隐患，需关闭各主机的history指令。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md index 91c9fded..0f071e79 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/2-installation-on-a-single-node.md @@ -38,7 +38,7 @@ date: 2021-06-11 sh install.sh -w Enmo@123 &&source ~/.bashrc ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 > @@ -81,10 +81,10 @@ date: 2021-06-11 static_connections : 0 db_state : Normal detail_information : Normal - + Senders info: No information - + Receiver info: No information ``` @@ -97,12 +97,12 @@ date: 2021-06-11 source ~/.bash_profile -bash: ulimit: open files: cannot modify limit: Operation not permitted （默认设置fd可用大小超过系统设置，可以忽略该设置） - + -- 登录数据库 gsql -d postgres -p 5432 -r gsql ((MogDB x.x.x 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. - + MogDB=# - ``` \ No newline at end of file + ``` diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md index fce87fb8..ff462c19 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/simplified-installation-process/3-installation-on-primary-standby-nodes.md @@ -38,7 +38,7 @@ date: 2021-06-11 sh install.sh -w Enmo@123 --multinode ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。 > - -p：指定的MogDB主节点端口号，默认5432。备节点端口号会使用主端口号+200，默认5632。 @@ -61,7 +61,7 @@ date: 2021-06-11 omm 5083 1.1 0.9 1819988 327200 pts/0 Sl 14:26 0:49 /opt/software/mogdb/bin/mogdb -D /opt/software/mogdb/data/slave -M standby omm 20377 0.0 0.0 119880 1216 pts/0 S+ 15:37 0:00 grep --color=auto mogdb ``` - + 执行gs_ctl命令，显示类似如下信息： ``` @@ -71,7 +71,7 @@ date: 2021-06-11 static_connections : 1 db_state : Normal detail_information : Normal - + Senders info: sender_pid : 5165 local_role : Primary @@ -91,7 +91,7 @@ date: 2021-06-11 sync_priority : 1 sync_most_available : Off channel : 10.244.44.52:27001-->10.244.44.52:35912 - + Receiver info: No information ``` @@ -104,12 +104,12 @@ date: 2021-06-11 source ~/.bash_profile -bash: ulimit: open files: cannot modify limit: Operation not permitted （默认设置fd可用大小超过系统设置，可以忽略该设置） - + -- 登录数据库 gsql -d postgres -p 5432 -r gsql ((MogDB x.x.x 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. - + MogDB=# - ``` \ No newline at end of file + ``` diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md index 4f9ea3c3..ee46c0da 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/1-installation-overview.md @@ -9,4 +9,4 @@ date: 2021-04-02 MogDB支持单机部署和单机HA部署两种部署方式。单机部署时，可在一个主机部署多个数据库实例，但为了数据安全，不建议用户这样部署。单机HA部署支持一台主机和最少一台备机，最多可配置8台备机。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** 通过MogDB提供的脚本安装时，只允许在单台物理机部署一个数据库系统。如果您需要在单台物理机部署多个数据库系统，建议您通过命令行安装，不需要通过MogDB提供的安装脚本执行安装。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: 通过MogDB提供的脚本安装时，只允许在单台物理机部署一个数据库系统。如果您需要在单台物理机部署多个数据库系统，建议您通过命令行安装，不需要通过MogDB提供的安装脚本执行安装。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md index 148705c5..49779a1e 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/3-modifying-os-configuration.md @@ -86,7 +86,7 @@ vim /etc/profile cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > `$地区/$时区`为需要设置时区的信息，例如：Asia/Shanghai。 使用date -s命令将各主机的时间设置为统一时间，举例如下。 @@ -95,12 +95,12 @@ cp /usr/share/zoneinfo/$地区/$时区 /etc/localtime date -s "Sat Sep 27 16:00:07 CST 2020" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 可以通过date命令查询主机时区。 ## （可选）关闭swap交换内存 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关闭swap交换内存是为了保障数据库的访问性能，避免把数据库的缓冲区内存淘汰到磁盘上。 如果服务器内存比较小，内存过载时，可打开swap交换内存保障正常运行。 在各数据库节点上，使用swapoff -a命令将交换内存关闭。 @@ -179,7 +179,7 @@ swapoff -a ## 关闭HISTORY记录 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 为避免指令历史记录安全隐患，需关闭各主机的history指令。 @@ -211,7 +211,7 @@ swapoff -a 在MogDB安装时需要root帐户远程登录访问权限，本章介绍如何设置使用root用户远程登录。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 数据库需要root互信时才开启远程连接。操作完成并且验证完毕后请及时注销root用户，避免误操作。 @@ -267,7 +267,7 @@ swapoff -a ssh xxx.xxx.xxx.xxx ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > xxx.xxx.xxx.xxx为安装MogDB环境的IP地址。 diff --git a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md index 104df8af..21fd814d 100644 --- a/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md +++ b/product/zh/docs-mogdb/v3.0/installation-guide/standard-installation/4-installing-mogdb.md @@ -54,7 +54,7 @@ date: 2021-04-2 ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - “/opt/mogdb/install/om”存放互信等工具，为了避免权限问题，不要把实例数据目录放在此目录下。 > - 安装目录和数据目录需为空或者不存在，否则可能导致安装失败。 @@ -133,7 +133,7 @@ date: 2021-04-2 ### 配置Host基本信息 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 每台Host服务器都必须有如下信息，如下示例以node1为例。 > - 加粗字体内容为示例，可自行替换。每行信息均有注释进行说明。 @@ -165,7 +165,7 @@ date: 2021-04-2 | backIp1 | 主机在后端存储网络中的IP地址（内网IP）。所有MogDB主机使用后端存储网络通讯。 | | sshIp1 | 设置SSH可信通道IP地址（外网IP）。若无外网，则可以不设置该选项或者同backIp1设置相同IP。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 配置文件中所有IP参数（包含backIp、sshIp、listenIp等）均只支持配置一个IP。如果配置第二个IP参数，则不会读取第二个参数的配置值。 示例：xml配置文件中同时配置backIp1和backIp2参数： 在解析配置文件时仅读取backIp1参数的配置值，不会读取backIp2参数的配置值。 > @@ -211,8 +211,8 @@ date: 2021-04-2 **非CMS主节点配置以下信息。** ```xml - - + + ``` @@ -264,7 +264,7 @@ date: 2021-04-2 - + @@ -278,7 +278,7 @@ date: 2021-04-2 - + @@ -313,7 +313,7 @@ date: 2021-04-2 - + @@ -327,7 +327,7 @@ date: 2021-04-2 - + @@ -358,69 +358,69 @@ date: 2021-04-2 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ``` @@ -689,4 +689,4 @@ dn_6002值比较特殊，其值为固定值，主库为dn_6001，备库1为dn_60 'dn_6002,dn_6003'表示备库1，2为同步节点。 -请替换相应的数据存储路径。 \ No newline at end of file +请替换相应的数据存储路径。 diff --git a/product/zh/docs-mogdb/v3.0/performance-tuning/1-system/4-configuring-smp.md b/product/zh/docs-mogdb/v3.0/performance-tuning/1-system/4-configuring-smp.md index ea3522b0..c31ef5f0 100644 --- a/product/zh/docs-mogdb/v3.0/performance-tuning/1-system/4-configuring-smp.md +++ b/product/zh/docs-mogdb/v3.0/performance-tuning/1-system/4-configuring-smp.md @@ -105,7 +105,7 @@ SMP架构是一种利用富余资源来换取时间的方案，计划并行之 MogDB=# SET query_dop = 1; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 资源许可的情况下，并行度越高，性能提升效果越好。 > - SMP并行度支持会话级设置，推荐客户在执行符合要求的查询前，打开smp，执行结束后，关闭smp。以免在业务峰值时，对业务造成冲击。 diff --git a/product/zh/docs-mogdb/v3.0/performance-tuning/2-sql/9-hint-based-tuning.md b/product/zh/docs-mogdb/v3.0/performance-tuning/2-sql/9-hint-based-tuning.md index 64f42cb4..de3dc20d 100644 --- a/product/zh/docs-mogdb/v3.0/performance-tuning/2-sql/9-hint-based-tuning.md +++ b/product/zh/docs-mogdb/v3.0/performance-tuning/2-sql/9-hint-based-tuning.md @@ -634,12 +634,12 @@ set(param value) - 浮点类： cost_weight_index, default_limit_rows, seq_page_cost, random_page_cost, cpu_tuple_cost, cpu_index_tuple_cost, cpu_operator_cost, effective_cache_size - + - 枚举类型： - + try_vector_engine_strategy -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置不在白名单中的参数，参数取值不合法，或hint语法错误时，不会影响查询执行的正确性。使用explain(verbose on)执行可以看到hint解析错误的报错提示。 > - GUC参数的hint只在最外层查询生效——子查询内的GUC参数hint不生效。 @@ -666,7 +666,7 @@ set(param value) use_gplan ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于非PBE方式执行的SQL语句，设置本hint不会影响执行方式。 > - 本Hint的优先级仅高于基于代价的选择和plan_cache_mode参数，即plan_cache_mode无法强制选择执行方式的语句本hint也无法生效。 @@ -743,7 +743,7 @@ explain select * from t1 where t1.a in (select /*+ no_expand*/ t2.a from t2); no_gpc ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数仅在enable_global_plancache=on时对PBE执行的语句生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数仅在enable_global_plancache=on时对PBE执行的语句生效。 ### 示例 @@ -764,7 +764,7 @@ predpush_same_level(src, dest) predpush_same_level(src1 src2 ..., dest) ``` -> **说明：** 本参数仅在rewrite_rule中的predpushforce选项打开时生效。 +> **说明**: 本参数仅在rewrite_rule中的predpushforce选项打开时生效。 ### 示例 @@ -810,7 +810,7 @@ MogDB=# explain select /*+predpush_same_level(t1, t2)*/ * from t1, t2 where t1.a (4 rows) ``` -> **须知：** +> **须知**: > > - predpush_same_level可以指定多个src，但是所有的src必须在同一个条件中。 -> - 如果指定的src和dest条件不存在，或该条件不符合参数化路径要求，则本hint不生效。 \ No newline at end of file +> - 如果指定的src和dest条件不存在，或该条件不符合参数化路径要求，则本hint不生效。 diff --git a/product/zh/docs-mogdb/v3.0/performance-tuning/3-wdr/wdr-snapshot-schema.md b/product/zh/docs-mogdb/v3.0/performance-tuning/3-wdr/wdr-snapshot-schema.md index 22ecf8eb..85b51b95 100644 --- a/product/zh/docs-mogdb/v3.0/performance-tuning/3-wdr/wdr-snapshot-schema.md +++ b/product/zh/docs-mogdb/v3.0/performance-tuning/3-wdr/wdr-snapshot-schema.md @@ -93,15 +93,15 @@ WDR Snasphot启动（即参数enable_wdr_snapshot）为on时， 且快照数量 select create_wdr_snapshot(); ``` - > **说明：** 执行“cm_ctl query -Cdvi”，回显中“Central Coordinator State”下显示的信息即为CCN信息。 + > **说明**: 执行“cm_ctl query -Cdvi”，回显中“Central Coordinator State”下显示的信息即为CCN信息。 5. 执行如下命令，在本地生成HTML格式的WDR报告。 a. 执行如下命令，设置报告格式。\a: 不显示表行列符号， \t: 不显示列名 ，\o: 指定输出文件。 ``` - gsql> \a - gsql> \t + gsql> \a + gsql> \t gsql> \o /home/om/wdrTestNode.html ``` @@ -123,7 +123,7 @@ WDR Snasphot启动（即参数enable_wdr_snapshot）为on时， 且快照数量 select generate_wdr_report(1, 2, 'all', 'node', pgxc_node_str()::cstring); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前MogDB的节点名固定是“dn_6001_6002_6003”，也可直接代入。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前MogDB的节点名固定是“dn_6001_6002_6003”，也可直接代入。 **表 3** generate_wdr_report函数参数说明 @@ -154,7 +154,7 @@ gsql -d postgres -p 端口号 -r --查询已经生成的快照。 MogDB=# select * from snapshot.snapshot; - snapshot_id | start_ts | end_ts + snapshot_id | start_ts | end_ts -------------+-------------------------------+------------------------------- 1 | 2020-09-07 10:20:36.763244+08 | 2020-09-07 10:20:42.166511+08 2 | 2020-09-07 10:21:13.416352+08 | 2020-09-07 10:21:19.470911+08 @@ -182,4 +182,4 @@ MogDB=# select generate_wdr_report(1, 2, 'all', 'cluster'); MogDB=# \o \a \t Output format is aligned. Tuples only is off. -``` \ No newline at end of file +``` diff --git a/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md b/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md index 15cc3397..92543243 100644 --- a/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md +++ b/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-cli-to-access-mogdb/gsql.md @@ -37,7 +37,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 ```bash cat /mogdb/data/db1/postgresql.conf | grep port - + port = 26000 # (change requires restart) #comm_sctp_port = 1024 # Assigned by installation (change requires restart) #comm_control_port = 10001 # Assigned by installation (change requires restart) @@ -67,7 +67,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 3. 获取软件安装包中的"MogDB-x.x.x-openEuler-64bit-tools.tar.gz"上传到"/opt/mogdb/tools"路径下。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 软件包相对位置为安装时所放位置，根据实际情况填写。 > - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。 @@ -106,7 +106,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。 @@ -148,7 +148,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 postgres=# \q ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用omm用户在本地连接数据库，无需输入密码，这是由于在pg_hba.conf文件中默认设置了本机允许trust方式连接。 > - 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 @@ -159,7 +159,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 由于安全性限制，数据库初始用户omm无法进行远程连接。 @@ -201,7 +201,7 @@ gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具 这条命令在数据库主节点实例对应的"pg_hba.conf"文件中添加了一条规则，用于对连接数据库主节点的客户端进行鉴定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 更多关于客户端认证方式的信息，请参见[客户端接入认证](1-client-access-authentication)章节。 diff --git a/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md b/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md index aa4c979a..4b0502f3 100644 --- a/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md +++ b/product/zh/docs-mogdb/v3.0/quick-start/mogdb-access/use-gui-tools-to-access-mogdb/datastudio.md @@ -62,7 +62,7 @@ Data Studio还提供SQL助手用于在SQL终端和PL/SQLViewer中执行各种查 Java 1.8.0_181或更高版本。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > * 请参阅[https://java.com/en/download/help/path.xml](https://java.com/en/download/help/path.xml)以设置Java Home路径。 > * 保证最佳体验的情况下，推荐的最小屏幕分辨率是1080 x 768。低于此分辨率，界面会异常。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/1-logical-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/1-logical-operators.md index 5bb95b40..a2d1a8b4 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/1-logical-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/1-logical-operators.md @@ -22,5 +22,5 @@ date: 2021-04-20 | FALSE | NULL | FALSE | NULL | TRUE | | NULL | NULL | NULL | NULL | NOT NULL | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 操作符AND和OR具有交换性，即交换左右两个操作数，不影响其结果。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md index 98cb0606..3e8446ad 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/13.1-hll-functions-and-operators.md @@ -57,7 +57,7 @@ date: 2021-06-07 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数值大小相同的参数使用不同数据类型的哈希函数计算，最后结果会不一样，因为不同类型哈希函数会选取不同的哈希计算策略。 - hll_hash_smallint(smallint, int32) @@ -724,7 +724,7 @@ hll主要存在三种模式Explicit、Sparse、Full。当数据规模比较小 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 注意：当两个或者多个hll数据结构做union的时候，必须要保证其中每一个hll里面的精度参数一样，否则将不可以进行union。同样的约束也适用于函数hll_union(hll,hll)。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/14-sequence-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/14-sequence-functions.md index c732f5d0..1c4e40a5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/14-sequence-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/14-sequence-functions.md @@ -13,10 +13,10 @@ date: 2021-04-20 描述：递增序列并返回新值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 为了避免从同一个序列获取值的并发事务被阻塞， nextval操作不会回滚；也就是说，一旦一个值已经被抓取， 那么就认为它已经被用过了，并且不会再被返回。 即使该操作处于事务中，当事务之后中断，或者如果调用查询结束不使用该值，也是如此。这种情况将在指定值的顺序中留下未使用的“空洞”。 因此，MogDB序列对象不能用于获得“无间隙”序列。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > nextval函数只能在主机上执行，备机不支持执行此函数。 返回类型：numeric @@ -119,11 +119,11 @@ date: 2021-04-20 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > Setval后当前会话会立刻生效，但如果其他会话有缓存的序列值，只能等到缓存值用尽才能感知Setval的作用。所以为了避免序列值冲突，setval要谨慎使用。 > 因为序列是非事务的，setval造成的改变不会由于事务的回滚而撤销。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > nextval函数只能在主机上执行，备机不支持执行此函数。 - pg_sequence_last_value(sequence_oid oid, OUT cache_value int16, OUT last_value int16) diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/18-window-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/18-window-functions.md index 909589fd..6efb1c8f 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/18-window-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/18-window-functions.md @@ -11,7 +11,7 @@ date: 2021-04-20 窗口函数与OVER语句一起使用。OVER语句用于对数据进行分组，并对组内元素进行排序。窗口函数用于给组内的值生成序号。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 窗口函数中的order by后面必须跟字段名，若order by后面跟数字，该数字会被按照常量处理，因此对目标列没有起到排序的作用。 - RANK() diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/19-security-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/19-security-functions.md index a3ebca47..2f84609d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/19-security-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/19-security-functions.md @@ -26,7 +26,7 @@ MogDB=# SELECT gs_encrypt_aes128('MPPDB','Asdf1234'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史。即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -46,7 +46,7 @@ MogDB=# SELECT gs_encrypt('MPPDB','Asdf1234','sm4'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史。即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -54,7 +54,7 @@ MogDB=# SELECT gs_encrypt('MPPDB','Asdf1234','sm4'); 描述：以keystr为密钥对decrypt字符串进行解密，返回解密后的字符串。解密使用的keystr必须保证与加密时使用的keystr一致才能正常解密。keystr不得为空。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 此参数需要结合gs_encrypt_aes128加密函数共同使用。 @@ -70,7 +70,7 @@ MogDB=# SELECT gs_decrypt_aes128('gwditQLQG8NhFw4OuoKhhQJoXojhFlYkjeG0aYdSCtLCnI (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史；即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -92,7 +92,7 @@ MogDB=# select gs_decrypt('ZBzOmaGA4Bb+coyucJ0B8AkIShqc','Asdf1234','sm4'); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 由于该函数的执行过程需要传入解密口令，为了安全起见，gsql工具不会将该函数记录入执行历史；即无法在gsql里通过上下翻页功能找到该函数的执行历史。 @@ -212,7 +212,7 @@ MogDB=# SELECT inet_server_addr(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 上面是以客户端在10.10.0.50上，服务器端在10.10.0.13上为例。 > - 如果是通过本地连接，使用此接口显示为空。 @@ -233,7 +233,7 @@ MogDB=# SELECT inet_client_addr(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 上面是以客户端在10.10.0.50上，服务器端在10.10.0.13上为例。 > - 如果是通过本地连接，使用此接口显示为空。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/23-system-information-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/23-system-information-functions.md index a1679934..4e0b662a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/23-system-information-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/23-system-information-functions.md @@ -95,7 +95,7 @@ date: 2021-04-20 current_schemas(Boolean)返回搜索路径中所有模式名称的数组。布尔选项决定像pg_catalog这样隐含包含的系统模式是否包含在返回的搜索路径中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 搜索路径可以通过运行时设置更改。命令是： + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 搜索路径可以通过运行时设置更改。命令是： > > ```sql > SET search_path TO schema [, schema, ...] @@ -222,7 +222,7 @@ date: 2021-04-20 描述：连接的远端地址。inet_client_addr返回当前客户端的IP地址。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：inet @@ -240,7 +240,7 @@ date: 2021-04-20 描述：连接的远端端口。inet_client_port返回当前客户端的端口号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：int @@ -258,7 +258,7 @@ date: 2021-04-20 描述：连接的本地地址。inet_server_addr返回服务器接收当前连接用的IP地址。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：inet @@ -276,7 +276,7 @@ date: 2021-04-20 描述：连接的本地端口。inet_server_port返回接收当前连接的端口号。如果是通过Unix-domain socket连接的，则所有这些函数都返回NULL。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此函数只有在远程连接模式下有效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此函数只有在远程连接模式下有效。 返回值类型：int @@ -632,7 +632,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 备注：has_any_column_privilege检查用户是否以特定方式访问表的任何列。其参数可能与has_table_privilege类似，除了访问权限类型必须是SELECT、INSERT、UPDATE、COMMENT或REFERENCES的一些组合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 拥有表的表级别权限则隐含的拥有该表每列的列级权限，因此如果与has_table_privilege参数相同，has_any_column_privilege总是返回true。但是如果授予至少一列的列级权限也返回成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 拥有表的表级别权限则隐含的拥有该表每列的列级权限，因此如果与has_table_privilege参数相同，has_any_column_privilege总是返回true。但是如果授予至少一列的列级权限也返回成功。 - has_column_privilege(user, table, column, privilege) @@ -657,7 +657,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 备注：has_column_privilege检查用户是否以特定方式访问一列。其参数类似于has_table_privilege，可以通过列名或属性号添加列。想要的访问权限类型必须是SELECT、INSERT、UPDATE、COMMENT或REFERENCES的一些组合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 拥有表的表级别权限则隐含的拥有该表每列的列级权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 拥有表的表级别权限则隐含的拥有该表每列的列级权限。 - has_cek_privilege(user, cek, privilege) @@ -900,7 +900,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 返回类型：Boolean 备注：pg_has_role检查用户是否能以特定方式访问一个角色。其参数类似has_table_privilege，除了public不能用做用户名。访问权限类型必须是MEMBER或USAGE的一些组合。 MEMBER表示的是角色中的直接或间接成员关系（也就是SET ROLE的权限），而USAGE表示无需通过SET ROLE也直接拥有角色的使用权限。 - + - has_any_privilege(user, privilege) 描述：指定用户是否有某项ANY权限，若同时查询多个权限，只要具有其中一个则返回true。 @@ -908,7 +908,7 @@ DDL类权限ALTER、DROP、COMMENT、INDEX、VACUUM属于所有者固有的权 返回类型：Boolean **表 11** 参数类型说明 - + | 参数名 | 合法入参类型 | 描述 | 取值范围 | | :-------- | :----------- | :------ | :----------------------------------------------------------- | | user | name | 用户 | 已存在的用户名。 | diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/8-logical-replication-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/8-logical-replication-functions.md index e8d823da..955b329e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/8-logical-replication-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/8-logical-replication-functions.md @@ -91,7 +91,7 @@ date: 2021-04-20 取值范围：非负整数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** LSN和upto_nchanges中任一参数达到限制，解码都会结束。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: LSN和upto_nchanges中任一参数达到限制，解码都会结束。 - options：此项为可选参数，由一系列options_name和options_value一一对应组成。 @@ -144,7 +144,7 @@ date: 2021-04-20 白名单参数，包含需要进行解码的schema和表名。 取值范围：包含白名单中表名的字符串，不同的表以','为分隔符进行隔离；使用'*'来模糊匹配所有情况；schema名和表名间以'.'分割，不允许存在任意空白符。例： - + select * from pg_logical_slot_peek_changes('slot1', NULL, 4096, 'white-table-list', 'public.t1,public.t2'); 返回值类型：text, xid, text @@ -185,7 +185,7 @@ date: 2021-04-20 取值范围：非负整数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** LSN和upto_nchanges中任一参数达到限制，解码都会结束。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: LSN和upto_nchanges中任一参数达到限制，解码都会结束。 - options：此项为可选参数，由一系列options_name和options_value一一对应组成。 @@ -236,7 +236,7 @@ date: 2021-04-20 白名单参数，包含需要进行解码的schema和表名。 取值范围：包含白名单中表名的字符串，不同的表以','为分隔符进行隔离；使用'*'来模糊匹配所有情况；schema名和表名间以'.'分割，不允许存在任意空白符。例： - + select * from pg_logical_slot_peek_binary_changes('slot1', NULL, 4096, 'white-table-list', 'public.t1,public.t2'); 返回值类型：text, xid, bytea @@ -305,7 +305,7 @@ date: 2021-04-20 取值范围：非负整数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** LSN和upto_nchanges中任一参数达到限制，解码都会结束。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: LSN和upto_nchanges中任一参数达到限制，解码都会结束。 - decoding_plugin @@ -325,11 +325,11 @@ date: 2021-04-20 ``` MogDB=# SELECT pg_current_xlog_location(); - pg_current_xlog_location + pg_current_xlog_location -------------------------- 0/E62E238 (1 row) - + MogDB=# create table t1 (a int primary key,b int,c int); NOTICE: CREATE TABLE / PRIMARY KEY will create implicit index "t1_pkey" for table "t1" CREATE TABLE @@ -337,9 +337,9 @@ date: 2021-04-20 INSERT 0 1 MogDB=# insert into t1 values(2,2,2); INSERT 0 1 - + MogDB=# select data from pg_logical_get_area_changes('0/E62E238',NULL,NULL,'sql_decoding',NULL); - location | xid | data + location | xid | data -----------+-------+--------------------------------------------------- 0/E62E8D0 | 27213 | COMMIT (at 2022-01-26 15:08:03.349057+08) 3020226 0/E6325F0 | 27214 | COMMIT (at 2022-01-26 15:08:07.309869+08) 3020234 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md index 9fbcf725..bbfe1064 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/24-system-management-functions/9-other-functions.md @@ -131,7 +131,7 @@ date: 2021-04-20 | clean_type | text | - 'BY_USERID'：按用户ID来进行清理Unique SQL。
- 'BY_CNID'：按主节点的ID来进行清理Unique SQL。
- 'ALL'：全部清理。 | | clean_value | int8 | 具体清理type对应的清理值。 | - > **须知：** + > **须知**: > > - scope的取值GLOBAL和LOCAL针对分布式，对于MogDB而言两者意义相同，均表示清理本节点。 > - clean_type的值BY_CNID仅针对分布式，对于MogDB无效。 @@ -463,7 +463,7 @@ date: 2021-04-20 返回值类型：Boolean - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此函数会尝试创建public.pgxc_copy_error_log表，表的详细信息请参见表6。 > - 在relname列上创建B-tree索引，并REVOKE ALL on public.pgxc_copy_error_log FROM public对错误表进行权限控制（与COPY语句权限一致）。 @@ -496,112 +496,112 @@ date: 2021-04-20 | function_name | text | 功能的名称，当前仅支持'STMT'。 | | action | text | 当function_name为'STMT'时，action仅支持TRACK/UNTRACK/LIST/CLEAN：
- TRACK - 开始记录归一化SQL的全量SQL信息。
- UNTRACK - 取消记录归一化SQL的全量SQL信息。
- LIST - 列取当前TRACK的归一化SQL的信息。
- CLEAN - 清理记录当前归一化SQL的信息。 | | params | text[] | 当function_name为'STMT'时，对应不同的action时，对应的params设置如下：
- TRACK - '{“归一化SQLID”, “L0/L1/L2”}'
- UNTRACK - '{“归一化SQLID”}'
- LIST - '{}'
- CLEAN - '{}' | - + - gs_parse_page_bypath(path text, blocknum bigint, relation_type text, read_memory boolean) - + 描述：用于解析指定表页面，并返回存放解析内容的路径。 - + 返回值类型：text - + 备注：必须是系统管理员或运维管理员才能执行此函数。 - + **表 9** gs_parse_page_bypath参数说明 - + | 参数 | 类型 | 描述 | | :------------ | :------ | :----------------------------------------------------------- | | path | text | - 对于普通表或段页式表，相对路径为：tablespace name/database oid/表的relfilenode(物理文件名)。例如：base/16603/16394。
- 表文件的相对路径可以通过pg_relation_filepath(table_name text)查找。
- 合法的path格式列举：
- global/relNode
- base/dbNode/relNode
- pg_tblspc/spcNode/version_dir/dbNode/relNode | | blocknum | bigint | -1 所有block的信息
0- MaxBlockNumber 对应block的信息 | | relation_type | text | - heap(astore 表)
- uheap(ustore 表)
- btree_index(BTree 索引)
- ubtree_index(UBTree 索引)
- segment(段页式) | | read_memory | boolean | - false，从磁盘文件解析。
- true，首先尝试从共享缓冲区中解析该页面；如果共享缓冲区中不存在，则从磁盘文件解析。 | - + - gs_xlogdump_lsn(start_lsn text, end_lsn text) - + 描述：用于解析指定lsn范围之内的XLOG日志，并返回存放解析内容的路径。可以通过pg_current_xlog_location()获取当前XLOG位置。 - + 返回值类型：text - + 参数：LSN起始位置，LSN结束位置 - + 备注：必须是系统管理员或运维管理员才能执行此函数。 - + - gs_xlogdump_xid(c_xid xid) - + 描述：用于解析指定xid的XLOG日志，并返回存放解析内容的路径。可以通过txid_current()获取当前事务ID。 - + 参数：事务ID - + 返回值类型：text - + 备注：必须是系统管理员或运维管理员才能执行此函数。 - + - gs_xlogdump_tablepath(path text, blocknum bigint, relation_type text) - + 描述：用于解析指定表页面对应的日志，并返回存放解析内容的路径。 - + 返回值类型：text - + 备注：必须是系统管理员或运维管理员才能执行此函数。 - + **表 10** gs_xlogdump_tablepath参数说明 - + | 参数 | 类型 | 描述 | | :------------ | :----- | :----------------------------------------------------------- | | path | text | - 对于普通表或段页式表，相对路径为：tablespace name/database oid/表的relfilenode(物理文件名)。例如：base/16603/16394。
- 表文件的相对路径可以通过pg_relation_filepath(table_name text)查找。
- 合法的path格式列举：
- global/relNode
- base/dbNode/relNode
- pg_tblspc/spcNode/version_dir/dbNode/relNode | | blocknum | bigint | -1 所有block的信息
0- MaxBlockNumber 对应block的信息 | | relation_type | text | - heap(astore 表)
- uheap(ustore 表)
- btree_index(BTree 索引)
- ubtree_index(UBTree 索引)
- segment(段页式) | - + - gs_xlogdump_parsepage_tablepath(path text, blocknum bigint, relation_type text, read_memory boolean) - + 描述：用于解析指定表页面和表页面对应的日志，并返回存放解析内容的路径。可以看做一次执行gs_parse_page_bypath和gs_xlogdump_tablepath。该函数执行的前置条件是表文件存在。如果想查看已删除的表的相关日志，请直接调用gs_xlogdump_tablepath。 - + 返回值类型：text - + 备注：必须是系统管理员或运维管理员才能执行此函数。 - + **表 11** gs_xlogdump_parsepage_tablepath参数说明 - + | 参数 | 类型 | 描述 | | :------------ | :------ | :----------------------------------------------------------- | | path | text | - 对于普通表或段页式表，相对路径为：tablespace name/database oid/表的relfilenode(物理文件名)；例如：base/16603/16394
- 表文件的相对路径可以通过pg_relation_filepath(table_name text)查找。
- 合法的path格式列举：
- global/relNode
- base/dbNode/relNode
- pg_tblspc/spcNode/version_dir/dbNode/relNode | | blocknum | bigint | -1 所有block的信息
0- MaxBlockNumber 对应block的信息 | | relation_type | text | - heap(astore 表)
- uheap(ustore 表)
- btree_index(BTree 索引)
- ubtree_index(UBTree 索引)
- segment(段页式) | | read_memory | boolean | - false，从磁盘文件解析
- true，首先尝试从共享缓冲区中解析该页面；如果共享缓冲区中不存在，则从磁盘文件解析 | - + - gs_index_verify(Oid oid, uint32:wq blkno) - + 描述：用于校验UBtree索引页面或者索引树上key的顺序是否正确。 - + 返回值类型：record - + **表 12** gs_index_verify参数说明 - + | 参数 | 类型 | 描述 | | :---- | :----- | :----------------------------------------------------------- | | oid | Oid | 索引文件relfilenode,可以通过select relfilenode from pg_class where relname='name'查询，其中name表示对应的索引文件名字。 | | blkno | uint32 | 0 ，表示检验整个索引树上所有页面。
大于0，表示校验页面编码等于blkno的索引页面。 | - + - gs_index_recycle_queue(Oid oid, int type, uint32 blkno) - + 描述：用于解析UBtree索引回收队列信息。 - + 返回值类型：record - + **表 13** gs_index_recycle_queue参数说明 - + | 参数 | 类型 | 描述 | | :---- | :----- | :----------------------------------------------------------- | | oid | Oid | 索引文件relfilenode,可以通过select relfilenode from pg_class where relname='name'查询，其中name表示对应的索引文件名字。 | | type | int | 0，表示解析整个待回收队列。
1，表示解析整个空页队列。
2，表示解析单个页面。 | | blkno | uint32 | 回收队列页面编号，该参数只有在type=2的时候有效，blkno有效取值范围为1~4294967294。 | - + - gs_stat_wal_entrytable(int64 idx) - + 描述：用于输出xlog中预写日志插入状态表的内容。 - + 返回值类型：record - + **表 14** gs_stat_wal_entrytable参数说明 - + | 参数类型 | 参数名 | 类型 | 描述 | | :------- | :----- | :----- | :----------------------------------------------------------- | | 输入参数 | idx | int64 | -1：查询数组所有元素。
0-最大值：具体某个数组元素内容。 | @@ -609,15 +609,15 @@ date: 2021-04-20 | 输出参数 | endlsn | uint64 | 记录的LSN标签。 | | 输出参数 | lrc | int32 | 记录对应的LRC。 | | 输出参数 | status | uint32 | 标识当前entry对应的xlog是否已经完全拷贝到wal buffer中：
0：非COPIED
1：COPIED | - + - gs_walwriter_flush_position() - + 描述：输出预写日志的刷新位置。 - + 返回值类型：record - + **表 15** gs_walwriter_flush_position参数说明 - + | 参数类型 | 参数名 | 类型 | 描述 | | :------- | :---------------------- | :----- | :----------------------------------------------------------- | | 输出参数 | last_flush_status_entry | int32 | Xlog flush上一个刷盘的tblEntry下标索引。 | @@ -632,15 +632,15 @@ date: 2021-04-20 | 输出参数 | shm_result_write_pos | uint64 | 共享内存中记录的XLogCtl中LogwrtResult的write位置。 | | 输出参数 | shm_result_flush_pos | uint64 | 共享内存中记录的XLogCtl中LogwrtResult的flush位置。 | | 输出参数 | curr_time | text | 当前时间。 | - + - gs_walwriter_flush_stat(int operation) - + 描述：用于统计预写日志write与sync的次数频率与数据量，以及xlog文件的信息。 - + 返回值类型：record - + **表 16** gs_walwriter_flush_stat参数说明 - + | 参数类型 | 参数名 | 类型 | 描述 | | :------- | :--------------------------- | :----- | :----------------------------------------------------------- | | 输入参数 | operation | int | -1：关闭统计开关(默认状态为关闭)。
0：打开统计开关。
1：查询统计信息。2：重置统计信息。 | @@ -660,7 +660,7 @@ date: 2021-04-20 | 输出参数 | curr_open_xlog_segno | uint64 | 当前正在写的xlog段文件编号。 | | 输出参数 | last_reset_time | text | 上一次重置统计信息的时间。 | | 输出参数 | curr_time | text | 当前时间。 | - + - gs_comm_proxy_thread_status() 描述：用于在集群配置用户态网络的场景下，代理通信库comm_proxy收发数据包统计 @@ -669,6 +669,6 @@ date: 2021-04-20 返回值类型：record - >**说明：** + >**说明**: > >- 此函数的查询仅在集中式环境开始部署用户态网络，且comm_proxy_attr参数中enable_dfx配置为true的条件下显示具体信息。其他场景报错不支持查询。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/25-statistics-information-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/25-statistics-information-functions.md index 78e70286..9943d011 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/25-statistics-information-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/25-statistics-information-functions.md @@ -949,7 +949,7 @@ date: 2021-04-20 返回值类型：boolean -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 此函数中所说节点指分布式节点，当前MogDB为集中式数据库，global与local功能一致，取值范围不支持BY_CNID。 @@ -1013,7 +1013,7 @@ date: 2021-04-20 返回值类型：record -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 状态信息有17项：commit、rollback、sql、table_scan、blocks_fetched、physical_read_operation、 shared_blocks_dirtied、local_blocks_dirtied、shared_blocks_read、local_blocks_read、 blocks_read_time、blocks_write_time、sort_imemory、sort_idisk、cu_mem_hit、 cu_hdd_sync_read、cu_hdd_asyread。 @@ -1700,7 +1700,7 @@ date: 2021-04-20 描述：统计Session级别的内存使用情况，包含执行作业在数据节点上Postgres线程和Stream线程分配的所有内存。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 若GUC参数enable_memory_limit=off，该函数不能使用。 @@ -1816,7 +1816,7 @@ SELECT * FROM GS_ALL_NODEGROUP_CONTROL_GROUP_INFO('installation') | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，同一文件同一行多次申请会做累加。 | - > **说明：** 该视图不支持release版本小型化场景。 + > **说明**: 该视图不支持release版本小型化场景。 - gs_get_session_memctx_detail(text) @@ -1830,7 +1830,7 @@ SELECT * FROM GS_ALL_NODEGROUP_CONTROL_GROUP_INFO('installation') | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，同一文件同一行多次申请会做累加。 | - > **说明：** 该视图仅在线程池模式下生效，且该视图不支持release版本小型化场景。 + > **说明**: 该视图仅在线程池模式下生效，且该视图不支持release版本小型化场景。 - gs_get_thread_memctx_detail(tid,text) @@ -1844,4 +1844,4 @@ SELECT * FROM GS_ALL_NODEGROUP_CONTROL_GROUP_INFO('installation') | line | int8 | 申请内存所在文件的代码行号。 | | size | int8 | 申请的内存大小，同一文件同一行多次申请会做累加。 | - > **说明：** 该视图不支持release版本小型化场景。 + > **说明**: 该视图不支持release版本小型化场景。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/28-ai-feature-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/28-ai-feature-functions.md index 5ed91d9d..33e94215 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/28-ai-feature-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/28-ai-feature-functions.md @@ -85,7 +85,7 @@ date: 2021-04-20 返回值类型：text。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该函数为内部功能调用函数，不建议用户直接使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该函数为内部功能调用函数，不建议用户直接使用。 - model_train_opt(template text, model text) @@ -182,7 +182,7 @@ date: 2021-04-20 参数：模型名称和推断任务的输入列。 返回值类型：text - + - db4ai\_predict\_by\_float8\_array\(text, VARIADIC "any"\) 描述：获取返回值为字符型的模型进行模型推断任务。此函数为内部调用函数，建议直接使用语法PREDICT BY进行推断任务。 @@ -190,7 +190,7 @@ date: 2021-04-20 参数：模型名称和推断任务的输入列。 返回值类型：text - + - gs\_explain\_model\(text\) 描述：获取返回值为字符型的模型进行模型解析文本化任务。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md index 73f3748b..a9664305 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/29.1-dynamic-data-masking-functions.md @@ -7,7 +7,7 @@ date: 2021-10-28 # 动态数据脱敏函数 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 该函数为内部功能调用函数，详见“数据库安全-动态数据脱敏机制”章节。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md index 08218d92..be5260b6 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/3-character-processing-functions-and-operators.md @@ -121,7 +121,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 如果是查询bytea类型的长度，指定utf8编码时，最大长度只能为536870888。 @@ -474,7 +474,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果POSIX正则表达式模式包含任何圆括号，那么将返回匹配第一对子表达式（对应第一个左圆括号的) 的文本。如果你想在表达式里使用圆括号而又不想导致这个例外，那么你可以在整个表达式外边放上一对圆括号。 - substring(string from *pattern* for *escape*) @@ -549,13 +549,13 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 MogDB=# SELECT regexp_substr('str','[ac]'); regexp_substr --------------- - + (1 row) - - MogDB=# SELECT regexp_substr('foobarbaz', 'b(..)', 3, 2) AS RESULT; - result - -------- - baz + + MogDB=# SELECT regexp_substr('foobarbaz', 'b(..)', 3, 2) AS RESULT; + result + -------- + baz (1 row) ``` @@ -578,10 +578,10 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 示例： ``` - MogDB=# SELECT regexp_count('foobarbaz','b(..)', 5) AS RESULT; - result - -------- - 1 + MogDB=# SELECT regexp_count('foobarbaz','b(..)', 5) AS RESULT; + result + -------- + 1 (1 row) ``` @@ -608,16 +608,16 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 示例： ``` - MogDB=# SELECT regexp_instr('foobarbaz','b(..)', 1, 1, 0) AS RESULT; - result - -------- - 4 - (1 row) - - MogDB=# SELECT regexp_instr('foobarbaz','b(..)', 1, 2, 0) AS RESULT; - result - -------- - 7 + MogDB=# SELECT regexp_instr('foobarbaz','b(..)', 1, 1, 0) AS RESULT; + result + -------- + 4 + (1 row) + + MogDB=# SELECT regexp_instr('foobarbaz','b(..)', 1, 2, 0) AS RESULT; + result + -------- + 7 (1 row) ``` @@ -627,7 +627,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 flags参数为可选参数，包含零个或多个改变函数行为的单字母标记。i表示进行大小写无关的匹配，g表示替换每一个匹配的子字符串而不仅仅是第一个。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果提供了最后一个参数，但参数值是空字符串（")，且数据库SQL兼容模式设置为A的情况下，会导致返回结果为空集。这是因为A兼容模式将"作为NULL处理，避免此类行为的方式有如下几种： > > - 将数据库SQL兼容模式改为C； @@ -707,7 +707,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 由于数据库内存分配机制限制单次内存分配不可超过1GB，因此number最大值不应超过(1G-x)/lengthb(string) - 1。x为头信息长度，通常大于4字节，其具体值在不同的场景下存在差异。 - replace(string text, from text, to text) @@ -739,10 +739,10 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 示例： ```sql - MogDB=# SELECT replace('abcdefabcdef', 'cd'); - replace - ---------------- - abefabef + MogDB=# SELECT replace('abcdefabcdef', 'cd'); + replace + ---------------- + abefabef (1 row) ``` @@ -1328,7 +1328,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：将字符串str1和str2连接并返回。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**数据库SQL兼容模式设置为MY的情况下，参数str1或str2为NULL会导致返回结果为NULL。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:数据库SQL兼容模式设置为MY的情况下，参数str1或str2为NULL会导致返回结果为NULL。 返回值类型：varchar @@ -1427,10 +1427,10 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 示例： ``` - MogDB=# SELECT regexp_replace('foobarbaz','b(..)', E'X\\1Y', 2, 2, 'n') AS RESULT; - result - ------------ - foobarXazY + MogDB=# SELECT regexp_replace('foobarbaz','b(..)', E'X\\1Y', 2, 2, 'n') AS RESULT; + result + ------------ + foobarXazY (1 row) ``` @@ -1438,7 +1438,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：以第一个参数为分隔符，链接第二个以后的所有参数。NULL参数被忽略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果第一个参数值是NULL，会导致返回结果为NULL。 > - 如果第一个参数值是空字符串（"），且数据库SQL兼容模式设置为A的情况下，会导致返回结果为NULL。这是因为A兼容模式>将"作为NULL处理，避免此类行为，可以将数据库SQL兼容模式改为B、C或者PG。 @@ -1464,23 +1464,23 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 sort_method类型：text 返回值类型：text - + 示例： - + ``` - MogDB=# SELECT nlssort('A', 'nls_sort=schinese_pinyin_m'); - nlssort + MogDB=# SELECT nlssort('A', 'nls_sort=schinese_pinyin_m'); + nlssort ---------------- - 01EA0000020006 - (1 row) - - MogDB=# SELECT nlssort('A', 'nls_sort=generic_m_ci'); - nlssort - ---------------- - 01EA000002 + 01EA0000020006 + (1 row) + + MogDB=# SELECT nlssort('A', 'nls_sort=generic_m_ci'); + nlssort + ---------------- + 01EA000002 (1 row) ``` - + - convert(string bytea, src_encoding name, dest_encoding name) 描述：以dest_encoding指定的目标编码方式转化字符串bytea。src_encoding指定源编码方式，在该编码下，string必须是合法的。 @@ -1497,7 +1497,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果源编码格式到目标编码格式的转化规则不存在，则字符串不进行任何转换直接返回，如GBK和LATIN1之间的转换规则是不存在的，具体转换规则可以通过查看系统表pg_conversion获得。 > 示例： > @@ -1655,7 +1655,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 描述：将string使用MD5加密，并以16进制数作为返回值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MD5加密算法安全性低，存在安全风险，不建议使用。 返回值类型：text @@ -1750,7 +1750,7 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若字符串中存在换行符，如字符串由一个换行符和一个空格组成，在MogDB中LENGTH和LENGTHB的值为2。 > @@ -1764,5 +1764,5 @@ MogDB提供的字符处理函数和操作符主要用于字符串与字符串、 > ----------- > (1 row) > ``` -> +> > 这是因为内核在调用相应的函数进行处理前，会判断所输入的参数中是否含有NULL，假如 有，则不会调用相应的函数，因此会没有输出。而在PG模式下，字符串的处理方式与PostgreSQL保持一致，因此不会有上述问题产生。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md index 9e236107..4ea4082d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/5-bit-string-functions-and-operators.md @@ -25,7 +25,7 @@ date: 2021-04-20 (1 row) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 单字段内部连续连接操作不建议超过180次。如果超过180次，需拆分为多个连续连接的字符串，在它们之间再执行连接操作。 > 例如：str1||str2||str3||str4 拆分为 (str1||str2)||(str3||str4)。 @@ -151,5 +151,5 @@ MogDB=# select substring('10101111'::bit(8), 2); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 只是转换为“bit”的意思是转换成bit(1)，因此只会转换成整数的最低位。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/6-mode-matching-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/6-mode-matching-operators.md index 38b421df..d5cfc2fe 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/6-mode-matching-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/6-mode-matching-operators.md @@ -23,7 +23,7 @@ date: 2021-04-20 4. 要匹配逃逸字符本身，写两个逃逸字符。例如要写一个包含反斜线的模式常量，那你就要在SQL语句里写两个反斜线。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > 参数standard_conforming_strings设置为off时，在文串常量中写的任何反斜线都需要被双写。因此，写一个匹配单个反斜线的模式实际上要在语句里写四个反斜线（你可以通过用ESCAPE选择一个不同的逃逸字符来避免这种情况，这样反斜线就不再是LIKE的特殊字符了。但仍然是字符文本分析器的特殊字符，所以你还是需要两个反斜线)。 > > 在兼容MYSQL数据模式时，您也可以通过写ESCAPE ''的方式不选择逃逸字符，这样可以有效地禁用逃逸机制，但是没有办法关闭下划线和百分号在模式中的特殊含义。 @@ -161,16 +161,16 @@ date: 2021-04-20 - [regexp_replace(string, pattern, replacement [,flags ])](3-character-processing-functions-and-operators)函数提供了将匹配POSIX正则表达式模式的子串替换为新文本的功能。 - [regexp_matches(string text, pattern text [, flags text])](3-character-processing-functions-and-operators)函数返回一个文本数组，该数组由匹配一个POSIX正则表达式模式得到的所有被捕获子串构成。 - + - [regexp_split_to_table(string text, pattern text [, flags text])](3-character-processing-functions-and-operators)函数把一个POSIX正则表达式模式当作一个定界符来分离一个串。 - + - [regexp_split_to_array(string text, pattern text [, flags text ])](3-character-processing-functions-and-operators)和regexp_split_to_table类似，是一个正则表达式分离函数，不过它的结果以一个text数组的形式返回。 - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 正则表达式分离函数会忽略零长度的匹配，这种匹配发生在串的开头或结尾或者正好发生在前一个匹配之后。这和正则表达式匹配的严格定义是相悖的，后者由regexp_matches实现，但是通常前者是实际中最常用的行为。 - + 示例： - + ```sql MogDB=# SELECT 'abc' ~ 'Abc' AS RESULT; result @@ -178,7 +178,7 @@ date: 2021-04-20 f (1 row) ``` - + ```sql MogDB=# SELECT 'abc' ~* 'Abc' AS RESULT; result @@ -186,7 +186,7 @@ date: 2021-04-20 t (1 row) ``` - + ```sql MogDB=# SELECT 'abc' !~ 'Abc' AS RESULT; result @@ -194,7 +194,7 @@ date: 2021-04-20 t (1 row) ``` - + ```sql MogDB=# SELECT 'abc'!~* 'Abc' AS RESULT; result @@ -202,7 +202,7 @@ date: 2021-04-20 f (1 row) ``` - + ```sql MogDB=# SELECT 'abc' ~ '^a' AS RESULT; result @@ -210,7 +210,7 @@ date: 2021-04-20 t (1 row) ``` - + ```sql MogDB=# SELECT 'abc' ~ '(b|d)'AS RESULT; result @@ -218,7 +218,7 @@ date: 2021-04-20 t (1 row) ``` - + ```sql MogDB=# SELECT 'abc' ~ '^(b|c)'AS RESULT; result @@ -226,5 +226,5 @@ date: 2021-04-20 f (1 row) ``` - + 虽然大部分的正则表达式搜索都能很快地执行，但是正则表达式仍可能被人为地弄成需要任意长的时间和任意量的内存进行处理。不建议从非安全模式来源接受正则表达式搜索模式，如果必须这样做，建议加上语句超时限制。使用SIMILAR TO模式的搜索具有同样的安全性危险， 因为SIMILAR TO提供了很多和POSIX-风格正则表达式相同的能力。LIKE搜索比其他两种选项简单得多，因此在接受非安全模式来源搜索时要更安全些。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md index 2cc633b6..492d6e30 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/functions-and-operators/8-date-and-time-processing-functions-and-operators.md @@ -784,7 +784,7 @@ date: 2021-04-20 返回值类型：character varying - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 获取当前时间有多种方式，请根据实际业务从场景选择合适的接口： > @@ -1313,18 +1313,18 @@ MogDB=# SELECT date_part('hour', INTERVAL '4 hours 3 minutes'); | 儒略日 | J | 儒略日（自公元前 4712 年 1 月 1 日来的天数） | | 季度 | Q | 季度 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 上表中RR计算年的规则如下： > > - 输入的两位年份在00~49之间： -> +> > 当前年份的后两位在00~49之间，返回值年份的前两位和当前年份的前两位相同； -> +> > 当前年份的后两位在50~99之间，返回值年份的前两位是当前年份的前两位加1。 -> +> > - 输入的两位年份在50~99之间： -> +> > 当前年份的后两位在00\~49之间，返回值年份的前两位是当前年份的前两位减1； -> +> > 当前年份的后两位在50~99之间，返回值年份的前两位和当前年份的前两位相同。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md index 696afa2b..10361c55 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/1-logging-destination.md @@ -9,11 +9,11 @@ date: 2021-04-20 ## log_destination -**参数说明**：MogDB支持多种方法记录服务器日志，log_destination的取值为一个逗号分隔开的列表（如log_destination="stderr,csvlog"）。 +**参数说明**: MogDB支持多种方法记录服务器日志，log_destination的取值为一个逗号分隔开的列表（如log_destination="stderr,csvlog"）。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 有效值为stderr、csvlog、syslog。 @@ -27,11 +27,11 @@ date: 2021-04-20 local0.* /var/log/omm ``` -**默认值**：stderr +**默认值**: stderr ## logging_collector -**参数说明**：控制开启后端日志收集进程logger进行日志收集。该进程捕获发送到stderr或csvlog的日志消息并写入日志文件。 +**参数说明**: 控制开启后端日志收集进程logger进行日志收集。该进程捕获发送到stderr或csvlog的日志消息并写入日志文件。 这种记录日志的方法比将日志记录到syslog更加有效，因为某些类型的消息在syslog的输出中无法显示。例如动态链接库加载失败消息和脚本（例如archive_command）产生的错误消息。 @@ -39,16 +39,16 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：将服务器日志发送到stderr时可以不使用logging_collector参数，此时日志消息会被发送到服务器的stderr指向的空间。这种方法的缺点是日志回滚困难，只适用于较小的日志容量。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启日志收集功能。 - off表示关闭日志收集功能。 -**默认值**：on +**默认值**: on ## log_directory -**参数说明**：logging_collector设置为on时，log_directory决定存放服务器日志文件的目录。它可以是绝对路径，或者是相对路径（相对于数据目录的路径）。log_directory支持动态修改，可以通过gs_guc reload实现。 +**参数说明**: logging_collector设置为on时，log_directory决定存放服务器日志文件的目录。它可以是绝对路径，或者是相对路径（相对于数据目录的路径）。log_directory支持动态修改，可以通过gs_guc reload实现。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -63,13 +63,13 @@ date: 2021-04-20 > - 合法路径：用户对此路径有读写权限 > - 非法路径：用户对此路径无读写权限 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：安装时指定。 +**默认值**: 安装时指定。 ## log_filename -**参数说明**：logging_collector设置为on时，log_filename决定服务器运行日志文件的名称。通常日志文件名是按照strftime模式生成，因此可以用系统时间定义日志文件名，用%转义字符实现。 +**参数说明**: logging_collector设置为on时，log_filename决定服务器运行日志文件的名称。通常日志文件名是按照strftime模式生成，因此可以用系统时间定义日志文件名，用%转义字符实现。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -78,13 +78,13 @@ date: 2021-04-20 > - 建议使用%转义字符定义日志文件名称，否则难以对日志文件进行有效的管理。 > - 当log_destination设为csvlog时，系统会生成附加了时间戳的日志文件名，文件格式为csv格式，例如"server_log.1093827753.csv"。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：postgresql-%Y-%m-%d_%H%M%S.log +**默认值**: postgresql-%Y-%m-%d_%H%M%S.log ## log_file_mode -**参数说明**：[logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 +**参数说明**: [logging_collector](#logging_collector)设置为on时，log_file_mode设置服务器日志文件的权限。通常log_file_mode的取值是能够被chmod和umask系统调用接受的数字。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -93,18 +93,18 @@ date: 2021-04-20 > - 使用此选项前请设置log_directory，将日志存储到数据目录之外的地方。 > - 因日志文件可能含有敏感数据，故不能将其设为对外可读。 -**取值范围**：整型，0000～0777（8进制计数，转化为十进制 0 ~ 511）。 +**取值范围**: 整型，0000～0777（8进制计数，转化为十进制 0 ~ 511）。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 0600表示只允许服务器管理员读写日志文件。 > - 0640表示允许管理员所在用户组成员只能读日志文件。 -**默认值**：0600 +**默认值**: 0600 ## log_truncate_on_rotation -**参数说明**：logging_collector设置为on时，log_truncate_on_rotation设置日志消息的写入方式。 +**参数说明**: logging_collector设置为on时，log_truncate_on_rotation设置日志消息的写入方式。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -112,63 +112,63 @@ date: 2021-04-20 假设日志需要保留7天，每天生成一个日志文件，日志文件名设置为server_log.Mon、server_log.Tue等。第二周的周二生成的日志消息会覆盖写入到server_log.Tue。设置方法：将log_filename设置为server_log.%a ，log_truncate_on_rotation设置为on，log_rotation_age设置为1440，即日志有效时间为1天。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示MogDB以覆盖写入的方式写服务器日志消息。 - off表示MogDB将日志消息附加到同名的现有日志文件上。 -**默认值**：off +**默认值**: off ## log_rotation_age -**参数说明**：logging_collector设置为on时，log_rotation_age决定创建一个新日志文件的时间间隔。当现在的时间减去上次创建一个服务器日志的时间超过了log_rotation_age的值时，将生成一个新的日志文件。 +**参数说明**: logging_collector设置为on时，log_rotation_age决定创建一个新日志文件的时间间隔。当现在的时间减去上次创建一个服务器日志的时间超过了log_rotation_age的值时，将生成一个新的日志文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 +**取值范围**: 整型，0 ~ 35791394，单位为min。其中0表示关闭基于时间的新日志文件的创建。 -**默认值**：1440(min) +**默认值**: 1440(min) ## log_rotation_size -**参数说明**：logging_collector设置为on时，log_rotation_size决定服务器日志文件的最大容量。当日志消息的总量超过日志文件容量时，服务器将生成一个新的日志文件。 +**参数说明**: logging_collector设置为on时，log_rotation_size决定服务器日志文件的最大容量。当日志消息的总量超过日志文件容量时，服务器将生成一个新的日志文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ INT_MAX / 1024，单位为kB。 +**取值范围**: 整型，0 ~ INT_MAX / 1024，单位为kB。 0表示关闭基于容量的新日志文件的创建。 建议该值大小设置级别至少为MB级,利于日志文件的及时划分。 -**默认值**：20MB +**默认值**: 20MB ## syslog_facility -**参数说明**：log_destination设置为syslog时，syslog_facility配置使用syslog记录日志的“设备”。 +**参数说明**: log_destination设置为syslog时，syslog_facility配置使用syslog记录日志的“设备”。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 +**取值范围**: 枚举类型，有效值有local0、local1、local2、local3、local4、local5、local6、local7。 -**默认值**：local0 +**默认值**: local0 ## syslog_ident -**参数说明**：[log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 +**参数说明**: [log_destination](#log_destination)设置为syslog时，syslog_ident设置在syslog日志中MogDB日志消息的标识。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：postgres +**默认值**: postgres ## event_source -**参数说明**：该参数仅在windows环境下生效，MogDB暂不支持。log_destination设置为eventlog时，event_source设置在日志中MogDB日志消息的标识。 +**参数说明**: 该参数仅在windows环境下生效，MogDB暂不支持。log_destination设置为eventlog时，event_source设置在日志中MogDB日志消息的标识。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：PostgreSQL +**默认值**: PostgreSQL diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md index c97cde97..10c19fd1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/2-logging-time.md @@ -9,7 +9,7 @@ date: 2021-04-20 ## client_min_messages -**参数说明**：控制发送到客户端的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，发送给客户端的消息就越少。 +**参数说明**: 控制发送到客户端的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，发送给客户端的消息就越少。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -17,13 +17,13 @@ date: 2021-04-20 > > 当client_min_messages和[log_min_messages](#log_min_messages)取相同值时，其值所代表的级别不同。 -**取值范围**：枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见[表1](#信息严重程度分类)。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见[表1](#信息严重程度分类)。在实际设置过程中，如果设置的级别大于error，为fatal或panic，系统会默认将级别转为error。 -**默认值**：notice +**默认值**: notice ## log_min_messages -**参数说明**：控制写到服务器日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 +**参数说明**: 控制写到服务器日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -31,28 +31,28 @@ date: 2021-04-20 > > 当[client_min_messages](#client_min_messages)和log_min_messages取相同值log时所代表的消息级别不同。部分日志信息的打印需要同时配置该参数与logging_modules，即设置该参数打开后可能还需要设置logging_modules打开对应模块的日志打印开关。 -**取值范围**：枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见[表1](#信息严重程度分类)。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见[表1](#信息严重程度分类)。 -**默认值**：warning +**默认值**: warning ## log_min_error_statement -**参数说明**：控制在服务器日志中记录错误的SQL语句。 +**参数说明**: 控制在服务器日志中记录错误的SQL语句。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表[表1](#信息严重程度分类)。 +**取值范围**: 枚举类型，有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见表[表1](#信息严重程度分类)。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 设置为error，表示导致错误、日志消息、致命错误、panic的语句都将被记录。 > - 设置为panic，表示关闭此特性。 -**默认值**：error +**默认值**: error ## log_min_duration_statement -**参数说明**：当某条语句的持续时间大于或者等于特定的毫秒数时，log_min_duration_statement参数用于控制记录每条完成语句的持续时间。 +**参数说明**: 当某条语句的持续时间大于或者等于特定的毫秒数时，log_min_duration_statement参数用于控制记录每条完成语句的持续时间。 设置log_min_duration_statement可以很方便地跟踪需要优化的查询语句。对于使用扩展查询协议的客户端，语法分析、绑定、执行每一步所花时间被独立记录。 @@ -61,17 +61,17 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 当此选项与[log_statement](3-logging-content#log_statement)同时使用时，已经被log_statement记录的语句文本不会被重复记录。在没有使用syslog情况下，推荐使用[log_line_prefix](3-logging-content#log_line_prefix)记录PID或会话ID，方便将当前语句消息连接到最后的持续时间消息。 -**取值范围**：整型，-1 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，-1 ~ INT_MAX，单位为毫秒。 - 设置为250，所有运行时间不短于250ms的SQL语句都会被记录。 - 设置为0，输出所有语句的持续时间。 - 设置为-1，关闭此功能。 -**默认值**：30min +**默认值**: 30min ## backtrace_min_messages -**参数说明**：控制当产生该设置参数级别相等或更高级别的信息时，会打印函数的堆栈信息到服务器日志文件中。 +**参数说明**: 控制当产生该设置参数级别相等或更高级别的信息时，会打印函数的堆栈信息到服务器日志文件中。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -79,11 +79,11 @@ date: 2021-04-20 > > 该参数作为客户现场问题定位手段使用，且由于频繁的打印函数栈会对系统的开销及稳定性有一定的影响，因此如果需要进行问题定位时，建议避免将backtrace_min_messages的值设置为fatal及panic以外的级别。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 有效值有debug、debug5、debug4、debug3、debug2、debug1、info、log、notice、warning、error、fatal、panic。参数的详细信息请参见[表1](#信息严重程度分类)。 -**默认值**：panic +**默认值**: panic [表1](#信息严重程度分类)解释MogDB中使用的消息安全级别。当日志输出到syslog或者eventlog（仅windows环境下, MogDB版本不涉及该参数）时，MogDB进行如表中的转换。 @@ -102,7 +102,7 @@ date: 2021-04-20 ## plog_merge_age -**参数说明**：该参数用于控制性能日志数据输出的周期。 +**参数说明**: 该参数用于控制性能日志数据输出的周期。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -110,10 +110,10 @@ date: 2021-04-20 > > 该参数以毫秒为单位的，建议在使用过程中设置值为1000的整数倍，即设置值以秒为最小单位。该参数所控制的性能日志文件以prf为扩展名，文件放置在$GAUSSLOG/gs_profile/目录下面，其中node_name是由postgres.conf文件中的pgxc_node_name的值，不建议外部使用该参数。 -**取值范围**：0~2147483647，单位为毫秒（ms）。 +**取值范围**: 0~2147483647，单位为毫秒（ms）。 当设置为0时，当前会话不再输出性能日志数据。当设置为非0时，当前会话按照指定的时间周期进行输出性能日志数据。 该参数设置得越小，输出的日志数据越多，对性能的负面影响越大。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md index d5f3b5ea..62ba03a5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/10-error-reporting-and-logging/3-logging-content.md @@ -9,42 +9,42 @@ date: 2021-04-20 ## debug_print_parse -**参数说明**：用于控制打印解析树结果。 +**参数说明**: 用于控制打印解析树结果。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值**：off +**默认值**: off ## debug_print_rewritten -**参数说明**：用于控制打印查询重写结果。 +**参数说明**: 用于控制打印查询重写结果。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值**：off +**默认值**: off ## debug_print_plan -**参数说明**：用于设置是否将查询的执行计划打印到日志中。 +**参数说明**: 用于设置是否将查询的执行计划打印到日志中。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启打印结果的功能。 - off表示关闭打印结果的功能。 -**默认值**：off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > @@ -53,33 +53,33 @@ date: 2021-04-20 ## debug_pretty_print -**参数说明**：设置此选项对debug_print_parse、debug_print_rewritten和debug_print_plan产生的日志进行缩进，会生成易读但比设置为off时更长的输出格式。 +**参数说明**: 设置此选项对debug_print_parse、debug_print_rewritten和debug_print_plan产生的日志进行缩进，会生成易读但比设置为off时更长的输出格式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示进行缩进。 - off表示不进行缩进。 -**默认值**：on +**默认值**: on ## log_checkpoints -**参数说明**：控制在服务器日志中记录检查点和重启点的信息。打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量，其中包含需要写的缓存区的数量及写入所花费的时间等。 +**参数说明**: 控制在服务器日志中记录检查点和重启点的信息。打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量，其中包含需要写的缓存区的数量及写入所花费的时间等。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开此参数时，服务器日志消息包含涉及检查点和重启点的统计量。 - off表示关闭此参数时，服务器日志消息包含不涉及检查点和重启点的统计量。 -**默认值**：off +**默认值**: off ## log_connections -**参数说明**：控制记录客户端的连接请求信息。 +**参数说明**: 控制记录客户端的连接请求信息。 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -87,69 +87,69 @@ date: 2021-04-20 > > 有些客户端程序（例如gsql），在判断是否需要口令的时候会尝试连接两次，因此日志消息中重复的"connection receive"（收到连接请求)并不意味着一定是问题。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值**：off +**默认值**: off ## log_disconnections -**参数说明**：控制记录客户端结束连接信息。 +**参数说明**: 控制记录客户端结束连接信息。 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示记录信息。 - off表示不记录信息。 -**默认值**：off +**默认值**: off ## log_duration -**参数说明**：控制记录每个已完成SQL语句的执行时间。对使用扩展查询协议的客户端、会记录语法分析、绑定和执行每一步所花费的时间。 +**参数说明**: 控制记录每个已完成SQL语句的执行时间。对使用扩展查询协议的客户端、会记录语法分析、绑定和执行每一步所花费的时间。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - 设置为off，该选项与log_min_duration_statement的不同之处在于log_min_duration_statement强制记录查询文本。 - 设置为on并且log_min_duration_statement大于零，记录所有持续时间，但是仅记录超过阈值的语句。这可用于在高负载情况下搜集统计信息。 -**默认值**：on +**默认值**: on ## log_error_verbosity -**参数说明**：控制服务器日志中每条记录的消息写入的详细度。 +**参数说明**: 控制服务器日志中每条记录的消息写入的详细度。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - terse输出不包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录。 - verbose输出包括SQLSTATE错误代码、源代码文件名、函数名及产生错误所在的行号。 - default输出包括DETAIL、HINT、QUERY及CONTEXT错误信息的记录，不包括SQLSTATE错误代码 、源代码文件名、函数名及产生错误所在的行号。 -**默认值**：default +**默认值**: default ## log_hostname -**参数说明**：选项关闭状态下，连接消息日志只显示正在连接主机的IP地址。打开此选项同时可以记录主机名。由于解析主机名可能需要一定的时间，可能影响数据库的性能。 +**参数说明**: 选项关闭状态下，连接消息日志只显示正在连接主机的IP地址。打开此选项同时可以记录主机名。由于解析主机名可能需要一定的时间，可能影响数据库的性能。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以同时记录主机名。 - off表示不可以同时记录主机名。 -**默认值**：on +**默认值**: on ## log_line_prefix -**参数说明**：控制每条日志信息的前缀格式。日志前缀类似于printf风格的字符串，在日志的每行开头输出。用以%为开头的“转义字符”代替[表1](#转义字符表)中的状态信息。 +**参数说明**: 控制每条日志信息的前缀格式。日志前缀类似于printf风格的字符串，在日志的每行开头输出。用以%为开头的“转义字符”代替[表1](#转义字符表)中的状态信息。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -190,28 +190,28 @@ date: 2021-04-20 - 当log_line_prefix设置为非空值时，请将其最后一个字符作为一个独立的段，以此来直观地与后续的日志进行区分，也可以使用一个标点符号。 - Syslog生成自己的时间戳及进程ID信息，所以当登录日志时，不需要包含这些转义字符。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：%m %c %d %p %a %x %n %e +**默认值**: %m %c %d %p %a %x %n %e > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：%m %c %d %p %a %x %n %e表示在日志开头附加会话开始时间戳、会话ID、数据库名、线程ID、应用程序名、事务ID、报错节点、SQLSTATE错误码。 ## log_lock_waits -**参数说明**：当一个会话的等待获得一个锁的时间超过[deadlock_timeout](16-lock-management#deadlock_timeout)的值时，此选项控制在数据库日志中记录此消息。这对于决定锁等待是否会产生一个坏的行为是非常有用的。 +**参数说明**: 当一个会话的等待获得一个锁的时间超过[deadlock_timeout](16-lock-management#deadlock_timeout)的值时，此选项控制在数据库日志中记录此消息。这对于决定锁等待是否会产生一个坏的行为是非常有用的。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示记录此信息。 - off表示不记录此信息。 -**默认值**：off +**默认值**: off ## log_statement -**参数说明**：控制记录SQL语句。对于使用扩展查询协议的客户端，记录接收到执行消息的事件和绑定参数的值（内置单引号要双写）。 +**参数说明**: 控制记录SQL语句。对于使用扩展查询协议的客户端，记录接收到执行消息的事件和绑定参数的值（内置单引号要双写）。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -219,50 +219,50 @@ date: 2021-04-20 > > 即使log_statement设置为all，包含简单语法错误的语句也不会被记录，因为仅在完成基本的语法分析并确定了语句类型之后才记录日志。在使用扩展查询协议的情况下，在执行阶段之前（语法分析或规划阶段）同样不会记录。将log_min_error_statement设为ERROR或更低才能记录这些语句。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - none表示不记录语句。 - ddl表示记录所有的数据定义语句，比如CREATE、ALTER和DROP语句。 - mod表示记录所有DDL语句，还包括数据修改语句INSERT、UPDATE、DELETE、TRUNCATE和COPY FROM。 - all表示记录所有语句，PREPARE、EXECUTE和EXPLAIN ANALYZE语句也同样被记录。 -**默认值**：none +**默认值**: none ## log_temp_files -**参数说明**：控制记录临时文件的删除信息。临时文件可以用来排序、哈希及临时查询结果。当一个临时文件被删除时，将会产生一条日志消息。 +**参数说明**: 控制记录临时文件的删除信息。临时文件可以用来排序、哈希及临时查询结果。当一个临时文件被删除时，将会产生一条日志消息。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为-1，最大值2147483647，单位KB。 +**取值范围**: 整型，最小值为-1，最大值2147483647，单位KB。 - 正整数表示只记录比log_temp_files设定值大的临时文件的删除信息。 - 值0表示记录所有的临时文件的删除信息。 - 值-1表示不记录任何临时文件的删除信息。 -**默认值**：-1 +**默认值**: -1 ## log_timezone -**参数说明**：设置服务器写日志文件时使用的时区。与[TimeZone](2-zone-and-formatting#timezone)不同，这个值是数据库范围的，针对所有连接到本数据库的会话生效。 +**参数说明**: 设置服务器写日志文件时使用的时区。与[TimeZone](2-zone-and-formatting#timezone)不同，这个值是数据库范围的，针对所有连接到本数据库的会话生效。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 -**默认值**：PRC +**默认值**: PRC > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：gs_initdb进行相应系统环境设置时会对默认值进行修改。 ## logging_module -**参数说明**：用于设置或者显示模块日志在服务端的可输出性。该参数属于会话级参数，不建议通过gs_guc工具来设置。 +**参数说明**: 用于设置或者显示模块日志在服务端的可输出性。该参数属于会话级参数，不建议通过gs_guc工具来设置。 该参数属于USERSET类型参数，设置请参考表[GUC参数分类](30-appendix)中对应设置的方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS、GUC、ORC、SLRU、MEM_CTL、AUTOVAC、CACHE、ADIO、SSL、TBLSPC、WLM、EXECUTOR、OPFUSION、VEC_EXECUTOR、LLVM、OPT、OPT_REWRITE、OPT_JOIN、OPT_AGG、OPT_SUBPLAN、OPT_SETOP、OPT_SKEW、UDF、COOP_ANALYZE、WLMCP、ACCELERATE、PLANHINT、SNAPSHOT、XACT、HANDLE、CLOG、EC、REMOTE、CN_RETRY、PLSQL、TEXTSEARCH、SEQ、REDO、FUNCTION、PARSER、INSTR、INCRE_CKPT、DBL_WRT、RTO、HEARTBEAT)。 +**默认值**: 所有模块日志在服务端是不输出的，可由SHOW logging_module查看。为ALL,on(),off(DFS、GUC、ORC、SLRU、MEM_CTL、AUTOVAC、CACHE、ADIO、SSL、TBLSPC、WLM、EXECUTOR、OPFUSION、VEC_EXECUTOR、LLVM、OPT、OPT_REWRITE、OPT_JOIN、OPT_AGG、OPT_SUBPLAN、OPT_SETOP、OPT_SKEW、UDF、COOP_ANALYZE、WLMCP、ACCELERATE、PLANHINT、SNAPSHOT、XACT、HANDLE、CLOG、EC、REMOTE、CN_RETRY、PLSQL、TEXTSEARCH、SEQ、REDO、FUNCTION、PARSER、INSTR、INCRE_CKPT、DBL_WRT、RTO、HEARTBEAT)。 **设置方法**：首先，可以通过SHOW logging_module来查看哪些模块是支持可控制的。例如，查询输出结果为： @@ -312,11 +312,11 @@ ALL,on(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,VEC_E ## opfusion_debug_mode -**参数说明**：用于调试简单查询是否进行查询优化。设置成log级别可以在数据库节点的执行计划中看到没有查询优化的具体原因。 +**参数说明**: 用于调试简单查询是否进行查询优化。设置成log级别可以在数据库节点的执行计划中看到没有查询优化的具体原因。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - off表示不打开该功能。 - log表示打开该功能，可以在数据库节点的执行计划中看到没有查询优化的具体原因。 @@ -325,17 +325,17 @@ ALL,on(DFS,GUC,ORC,SLRU,MEM_CTL,AUTOVAC,CACHE,ADIO,SSL,TBLSPC,WLM,EXECUTOR,VEC_E > > 提供在log中显示语句没有查询优化的具体原因，需要将参数设置成log级别，log_min_messages设置成debug4级别，logging_module设置'on(OPFUSION)'，注意log内容可能会比较多，尽可能在调优期间执行少量作业使用。 -**默认值**：off +**默认值**: off ## enable_debug_vacuum -**参数说明**：允许输出一些与VACUUM相关的日志，便于定位VACUUM相关问题。开发人员专用，不建议普通用户使用。 +**参数说明**: 允许输出一些与VACUUM相关的日志，便于定位VACUUM相关问题。开发人员专用，不建议普通用户使用。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/11-alarm-detection.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/11-alarm-detection.md index 470841e6..0b3ad432 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/11-alarm-detection.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/11-alarm-detection.md @@ -11,63 +11,63 @@ date: 2021-04-20 ## enable_alarm -**参数说明**：允许打开告警检测线程，检测数据库中可能的错误场景。 +**参数说明**: 允许打开告警检测线程，检测数据库中可能的错误场景。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许打开告警检测线程。 - off表示不允许打开告警检测线程。 -**默认值**：on +**默认值**: on ## connection_alarm_rate -**参数说明**：允许和数据库连接的最大并发连接数的比率限制。数据库连接的最大并发连接数为max_connections * connection_alarm_rate。 +**参数说明**: 允许和数据库连接的最大并发连接数的比率限制。数据库连接的最大并发连接数为max_connections * connection_alarm_rate。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0~1.0 +**取值范围**: 浮点型，0.0~1.0 -**默认值**：0.9 +**默认值**: 0.9 ## alarm_report_interval -**参数说明**：指定告警上报的时间间隔。 +**参数说明**: 指定告警上报的时间间隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位为秒。 +**取值范围**: 整型，单位为秒。 -**默认值**：10 +**默认值**: 10 ## alarm_component -**参数说明**：在对告警做上报时，会进行告警抑制，即同一个实例的同一个告警项在alarm_report_interval（默认值为10s）内不做重复上报。在这种情况下设置用于处理告警内容的告警组件的位置。 +**参数说明**: 在对告警做上报时，会进行告警抑制，即同一个实例的同一个告警项在alarm_report_interval（默认值为10s）内不做重复上报。在这种情况下设置用于处理告警内容的告警组件的位置。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：/opt/snas/bin/snas_cm_cmd +**默认值**: /opt/snas/bin/snas_cm_cmd ## table_skewness_warning_threshold -**参数说明**：设置用于表倾斜告警的阈值。 +**参数说明**: 设置用于表倾斜告警的阈值。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～1 +**取值范围**: 浮点型，0～1 -**默认值**：1 +**默认值**: 1 ## table_skewness_warning_rows -**参数说明**：设置用于表倾斜告警的行数。 +**参数说明**: 设置用于表倾斜告警的行数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：100000 +**默认值**: 100000 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md index fcc65f77..80b08f25 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/1-query-and-index-statistics-collector.md @@ -11,123 +11,123 @@ date: 2021-04-20 ## track_activities -**参数说明**：控制收集每个会话中当前正在执行命令的统计数据。 +**参数说明**: 控制收集每个会话中当前正在执行命令的统计数据。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 -**默认值**：on +**默认值**: on ## track_counts -**参数说明**：控制收集数据库活动的统计数据。 +**参数说明**: 控制收集数据库活动的统计数据。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启收集功能。 - off表示关闭收集功能。 -**默认值**：on +**默认值**: on > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：在AutoVacuum自动清理进程中选择清理的数据库时，需要数据库的统计数据，故默认值设为on。 > ## track_io_timing -**参数说明**：控制收集数据库I/O调用时序的统计数据。I/O时序统计数据可以在pg_stat_database中查询。 +**参数说明**: 控制收集数据库I/O调用时序的统计数据。I/O时序统计数据可以在pg_stat_database中查询。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启收集功能，开启时，收集器会在重复地去查询当前时间的操作系统，这可能会引起某些平台的重大开销，故默认值设置为off。 - off表示关闭收集功能。 -**默认值**：off +**默认值**: off ## track_functions -**参数说明**：控制收集函数的调用次数和调用耗时的统计数据。 +**参数说明**: 控制收集函数的调用次数和调用耗时的统计数据。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：当SQL语言函数设置为调用查询的“内联”函数时，不管是否设置此选项，这些SQL语言函数无法被追踪到。 > -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - pl表示只追踪过程语言函数。 - all表示追踪SQL语言函数。 - none表示关闭函数追踪功能。 -**默认值**：none +**默认值**: none ## track_activity_query_size -**参数说明**：设置用于跟踪每一个活动会话的当前正在执行命令的字节数。 +**参数说明**: 设置用于跟踪每一个活动会话的当前正在执行命令的字节数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，100～102400 +**取值范围**: 整型，100～102400 -**默认值**：1024 +**默认值**: 1024 ## stats_temp_directory -**参数说明**：设置存储临时统计数据的目录。 +**参数说明**: 设置存储临时统计数据的目录。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：将其设置为一个基于RAM的文件系统目录会减少实际的I/O开销并可以提升其性能。 > -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：pg_stat_tmp +**默认值**: pg_stat_tmp ## track_thread_wait_status_interval -**参数说明**：用来定期收集thread状态信息的时间间隔。 +**参数说明**: 用来定期收集thread状态信息的时间间隔。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0～1天，单位为min。 +**取值范围**: 0～1天，单位为min。 -**默认值**：30min +**默认值**: 30min ## enable_save_datachanged_timestamp -**参数说明**：确定是否收集insert/update/delete, exchange/truncate/drop partition操作对表数据改动的时间。 +**参数说明**: 确定是否收集insert/update/delete, exchange/truncate/drop partition操作对表数据改动的时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许收集相关操作对表数据改动的时间。 - off表示禁止收集相关操作对表数据改动的时间。 -**默认值**：on +**默认值**: on ## track_sql_count -**参数说明**：控制对每个会话中当前正在执行的SELECT、INSERT、UPDATE、DELETE、MERGE INTO语句进行计数的统计数据。 +**参数说明**: 控制对每个会话中当前正在执行的SELECT、INSERT、UPDATE、DELETE、MERGE INTO语句进行计数的统计数据。 在x86平台集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约0.8%。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启计数功能。 - off表示关闭计数功能。 -**默认值**：on +**默认值**: on > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md index 68eb28cd..42bc5978 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/12-statistics-during-the-database-running/2-performance-statistics.md @@ -11,7 +11,7 @@ date: 2021-04-20 **输出性能统计日志** -**参数说明**：对每条查询，以下4个选项控制在服务器日志里记录相应模块的性能统计数据，具体含义如下: +**参数说明**: 对每条查询，以下4个选项控制在服务器日志里记录相应模块的性能统计数据，具体含义如下: - log_parser_stats控制在服务器日志里记录解析器的性能统计数据。 - log_planner_stats控制在服务器日志里记录查询优化器的性能统计数据。 @@ -27,9 +27,9 @@ date: 2021-04-20 > - log_statement_stats记录总的语句统计数据，而其他的只记录针对每个模块的统计数据。 > - log_statement_stats不能和其他任何针对每个模块统计的选项一起打开。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启记录性能统计数据的功能。 - off表示关闭记录性能统计数据的功能。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/13-load-management.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/13-load-management.md index 47989165..b2e9c66c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/13-load-management.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/13-load-management.md @@ -11,17 +11,17 @@ date: 2021-04-20 ## use_workload_manager -**参数说明**：是否开启资源管理功能。 +**参数说明**: 是否开启资源管理功能。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开资源管理。 - off表示关闭资源管理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当使用表[GUC参数设置方式](30-appendix)中的方式二来修改参数值时，新参数值只能对更改操作执行后启动的线程生效。此外，对于后台线程以及线程复用执行的新作业，该参数值的改动不会生效。如果希望这类线程即时识别参数变化，可以使用kill session或重启节点的方式来实现。 > @@ -32,11 +32,11 @@ date: 2021-04-20 > ``` > -**默认值**：off +**默认值**: off ## cgroup_name -**参数说明**：设置当前使用的Cgroups的名称或者调整当前group下排队的优先级。 +**参数说明**: 设置当前使用的Cgroups的名称或者调整当前group下排队的优先级。 即如果先设置cgroup_name，再设置session_respool，那么session_respool关联的控制组起作用，如果再切换cgroup_name，那么新切换的cgroup_name起作用。 @@ -46,29 +46,29 @@ date: 2021-04-20 建议尽量不要混合使用cgroup_name和session_respool。 -**取值范围**： 字符串 +**取值范围**: 字符串 -**默认值**：InvalidGroup +**默认值**: InvalidGroup ## cpu_collect_timer -**参数说明**：设置语句执行时在数据库节点上收集CPU时间的周期。 +**参数说明**: 设置语句执行时在数据库节点上收集CPU时间的周期。 数据库管理员需根据系统资源（如CPU资源、IO资源和内存资源）情况，调整此数值大小，使得系统支持较合适的收集周期，太小会影响执行效率，太大会影响异常处理的精确度。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，1~INT_MAX， 单位为秒。 +**取值范围**: 整型，1~INT_MAX， 单位为秒。 -**默认值**：30 +**默认值**: 30 ## memory_tracking_mode -**参数说明**：设置记录内存信息的模式。 +**参数说明**: 设置记录内存信息的模式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： +**取值范围**: - none：表示不启动内存统计功能。 - peak：表示统计query级内存peak值，此数值计入数据库日志，也可以由explain analyze输出。 @@ -76,279 +76,279 @@ date: 2021-04-20 - executor：表示生成统计文件，包含执行层使用过的所有已分配内存的上下文信息。 - fullexec：表示生成文件包含执行层申请过的所有内存上下文信息。 -**默认值**：none +**默认值**: none ## memory_detail_tracking -**参数说明**：设置需要的线程内分配内存上下文的顺序号以及当前线程所在query的plannodeid。 +**参数说明**: 设置需要的线程内分配内存上下文的顺序号以及当前线程所在query的plannodeid。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 -**默认值**：空 +**默认值**: 空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**该参数不允许用户进行设置，建议保持默认值。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:该参数不允许用户进行设置，建议保持默认值。 > ## enable_resource_track -**参数说明**：是否开启资源实时监控功能。 +**参数说明**: 是否开启资源实时监控功能。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开资源监控。 - off表示关闭资源监控。 -**默认值**：on +**默认值**: on ## enable_resource_record -**参数说明**：是否开启资源监控记录归档功能。 +**参数说明**: 是否开启资源监控记录归档功能。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启资源监控记录归档功能。 - off表示关闭资源监控记录归档功能。 -**默认值**：off +**默认值**: off ## enable_logical_io_statistics -**参数说明**：设置是否开启资源监控逻辑IO统计功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中的read_kbytes、write_kbytes、read_counts、write_counts、read_speed和write_speed字段，会统计对应用户的逻辑读写字节数、次数以及速率。 +**参数说明**: 设置是否开启资源监控逻辑IO统计功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中的read_kbytes、write_kbytes、read_counts、write_counts、read_speed和write_speed字段，会统计对应用户的逻辑读写字节数、次数以及速率。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启资源监控逻辑IO统计功能。 - off表示关闭资源监控逻辑IO统计功能。 -**默认值**：on +**默认值**: on ## enable_user_metric_persistent -**参数说明**：设置是否开启用户历史资源监控转存功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中数据，会定期采样保存到[GS_WLM_USER_RESOURCE_HISTORY](GS_WLM_USER_RESOURCE_HISTORY)系统表中。 +**参数说明**: 设置是否开启用户历史资源监控转存功能。开启时，对于PG_TOTAL_USER_RESOURCE_INFO视图中数据，会定期采样保存到[GS_WLM_USER_RESOURCE_HISTORY](GS_WLM_USER_RESOURCE_HISTORY)系统表中。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 ● on表示开启用户历史资源监控转存功能。 ● off表示关闭用户历史资源监控转存功能。 -**默认值**： on +**默认值**: on ## user_metric_retention_time -**参数说明**：设置用户历史资源监控数据的保存天数。该参数仅在enable_user_metric_persistent为on时有效。 +**参数说明**: 设置用户历史资源监控数据的保存天数。该参数仅在enable_user_metric_persistent为on时有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中的方法一和方法二进行设置。 -**取值范围**： 整型，0～730，单位为天。 +**取值范围**: 整型，0～730，单位为天。 ● 值等于0时，用户历史资源监控数据将永久保存。 ● 值大于0时，用户历史资源监控数据将保存对应天数。 -**默认值**： 7 +**默认值**: 7 ## enable_instance_metric_persistent -**参数说明**：设置是否开启实例资源监控转存功能。开启时，对实例的监控数据会保存到[GS_WLM_INSTANCE_HISTORY](GS_WLM_INSTANCE_HISTORY)系统表中。 +**参数说明**: 设置是否开启实例资源监控转存功能。开启时，对实例的监控数据会保存到[GS_WLM_INSTANCE_HISTORY](GS_WLM_INSTANCE_HISTORY)系统表中。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启实例资源监控转存功能。 - off表示关闭实例资源监控转存功能。 -**默认值**：on +**默认值**: on ## instance_metric_retention_time -**参数说明**：设置实例历史资源监控数据的保存天数。该参数仅在enable_instance_metric_persistent为on时有效。 +**参数说明**: 设置实例历史资源监控数据的保存天数。该参数仅在enable_instance_metric_persistent为on时有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中的方法一和方法二进行设置。 -**取值范围**： 整型，0～3650，单位为天。 +**取值范围**: 整型，0～3650，单位为天。 - 值等于0时，实例历史资源监控数据将永久保存。 - 值大于0时，实例历史资源监控数据将保存对应设置天数。 -**默认值**：7 +**默认值**: 7 ## resource_track_level -**参数说明**：设置当前会话的资源监控的等级。该参数只有当参数enable_resource_track为on时才有效。 +**参数说明**: 设置当前会话的资源监控的等级。该参数只有当参数enable_resource_track为on时才有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 枚举型 +**取值范围**: 枚举型 - none：表示不开启资源监控功能。 - query：表示开启query级别资源监控功能。 - operator：表示开启query级别和算子级别资源监控功能。 -**默认值**：query +**默认值**: query ## resource_track_cost -**参数说明**：设置对当前会话的语句进行资源监控的最小执行代价。该参数只有当参数enable_resource_track为on时才有效。 +**参数说明**: 设置对当前会话的语句进行资源监控的最小执行代价。该参数只有当参数enable_resource_track为on时才有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，-1～INT_MAX +**取值范围**: 整型，-1～INT_MAX - 值为-1时，不进行资源监控。 - 值大于或等于0且小于等于9时，对执行代价大于等于10的语句进行资源监控。 - 值大于或等于10时，对执行代价超过该参数值的语句进行资源监控。 -**默认值**：100000 +**默认值**: 100000 ## resource_track_duration -**参数说明**：设置资源监控实时视图中记录的语句执行结束后进行历史信息转存的最小执行时间。当执行完成的作业，其执行时间不小于此参数值时，作业信息会从实时视图（以statistics为后缀的视图）转存到相应的历史视图（以history为后缀的视图）中。该参数只有当[enable_resource_track](#enable_resource_track)为on时才有效。 +**参数说明**: 设置资源监控实时视图中记录的语句执行结束后进行历史信息转存的最小执行时间。当执行完成的作业，其执行时间不小于此参数值时，作业信息会从实时视图（以statistics为后缀的视图）转存到相应的历史视图（以history为后缀的视图）中。该参数只有当[enable_resource_track](#enable_resource_track)为on时才有效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，0～INT_MAX，单位为秒。 +**取值范围**: 整型，0～INT_MAX，单位为秒。 - 值为0时，资源监控实时视图中记录的所有语句都进行历史信息归档。 - 值大于0时，资源监控实时视图中记录的语句的执行时间超过这个值就会进行历史信息归档。 -**默认值**：1min +**默认值**: 1min ## disable_memory_protect -**参数说明**：设置是否禁止内存保护功能。当系统内存不足时如果需要查询系统视图，可以先将此参数置为on，禁止内存保护功能，保证视图可以正常查询。该参数只适用于在系统内存不足时进行系统诊断和调试，正常运行时请保持该参数配置为off。 +**参数说明**: 设置是否禁止内存保护功能。当系统内存不足时如果需要查询系统视图，可以先将此参数置为on，禁止内存保护功能，保证视图可以正常查询。该参数只适用于在系统内存不足时进行系统诊断和调试，正常运行时请保持该参数配置为off。 该参数属于USERSET类型参数，且只对当前会话有效。请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示禁止内存保护功能。 - off表示启动内存保护功能。 -**默认值**：off +**默认值**: off ## query_band -**参数说明**：用于标示当前会话的作业类型，由用户自定义。 +**参数说明**: 用于标示当前会话的作业类型，由用户自定义。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 -**默认值**：空 +**默认值**: 空 ## memory_fault_percent -**参数说明**：内存故障测试时内存申请失败的比例，仅用在DEBUG版本。 +**参数说明**: 内存故障测试时内存申请失败的比例，仅用在DEBUG版本。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～2147483647 +**取值范围**: 整型，0～2147483647 -**默认值**：0 +**默认值**: 0 ## enable_bbox_dump -**参数说明**： 是否开启黑匣子功能，在系统不配置core机制的时候仍可产生core文件。 +**参数说明**: 是否开启黑匣子功能，在系统不配置core机制的时候仍可产生core文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开黑匣子功能。 - off表示关闭黑匣子功能。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 黑匣子功能生成core文件依赖操作系统开放ptrace接口。若发生权限不足(errno = 1)，请确保/proc/sys/mogdb/yama/ptrace_scope配置合理。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 黑匣子功能生成core文件依赖操作系统开放ptrace接口。若发生权限不足(errno = 1)，请确保/proc/sys/mogdb/yama/ptrace_scope配置合理。 ## bbox_dump_count -**参数说明**：在[bbox_dump_path](#bbox_dump_path)定义的路径下，允许存储的MogDB所产生core文件最大数。超过此数量，旧的core文件会被删除。此参数只有当[enable_bbox_dump](#enable_bbox_dump)为on时才生效。 +**参数说明**: 在[bbox_dump_path](#bbox_dump_path)定义的路径下，允许存储的MogDB所产生core文件最大数。超过此数量，旧的core文件会被删除。此参数只有当[enable_bbox_dump](#enable_bbox_dump)为on时才生效。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，1～20 +**取值范围**: 整型，1～20 -**默认值**：8 +**默认值**: 8 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在并发产生core文件时，core文件的产生个数可能大于bbox_dump_count。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在并发产生core文件时，core文件的产生个数可能大于bbox_dump_count。 > ## bbox_dump_path -**参数说明**：黑匣子core文件的生成路径。此参数只有当[enable_bbox_dump](#enable_bbox_dump)为on时才生效。 +**参数说明**: 黑匣子core文件的生成路径。此参数只有当[enable_bbox_dump](#enable_bbox_dump)为on时才生效。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 字符型 +**取值范围**: 字符型 -**默认值**：空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 +**默认值**: 空。默认生成黑匣子core文件的路径为读取/proc/sys/mogdb/core_pattern下的路径，如果这个路径不是一个目录，或者用户对此目录没有写权限，黑匣子core文件将生成在数据库的data目录下。或者以安装时指定的目录为准。 ## enable_ffic_log -**参数说明**： 是否开启FFIC（First Failure Info Capture）功能。 +**参数说明**: 是否开启FFIC（First Failure Info Capture）功能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示打开FFIC功能。 - off表示关闭FFIC功能。 -**默认值**：on +**默认值**: on ## io_limits -**参数说明**： 每秒触发IO的上限。 +**参数说明**: 每秒触发IO的上限。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置的方法进行设置。 -**取值范围**： 整型，0～1073741823 +**取值范围**: 整型，0～1073741823 -**默认值**：0 +**默认值**: 0 ## io_priority -**参数说明**： IO利用率高达50%时，重消耗IO作业进行IO资源管控时关联的优先级等级。 +**参数说明**: IO利用率高达50%时，重消耗IO作业进行IO资源管控时关联的优先级等级。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置的方法进行设置。 -**取值范围**： 枚举型 +**取值范围**: 枚举型 - None：表示不受控。 - Low：表示限制iops为该作业原始触发数值的10%。 - Medium：表示限制iops为该作业原始触发数值的20%。 - High：表示限制iops为该作业原始触发数值的50%。 -**默认值**：None +**默认值**: None ## io_control_unit -**参数说明**： 行存场景下，io管控时用来对io次数进行计数的单位。 +**参数说明**: 行存场景下，io管控时用来对io次数进行计数的单位。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置方法进行设置。 记多少次io触发为一计数单位，通过此计数单位所记录的次数进行io管控。 -**取值范围**： 整型，1000~1000000 +**取值范围**: 整型，1000~1000000 -**默认值**：6000 +**默认值**: 6000 ## session_respool -**参数说明**： 当前的session关联的resource pool。 +**参数说明**: 当前的session关联的resource pool。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应类型的设置方法进行设置。 @@ -358,52 +358,52 @@ date: 2021-04-20 建议尽量不要混合使用cgroup_name和session_respool。 -**取值范围**： string类型，通过create resource pool所设置的资源池。 +**取值范围**: string类型，通过create resource pool所设置的资源池。 -**默认值**：invalid_pool +**默认值**: invalid_pool ## session_statistics_memory -**参数说明**： 设置实时查询视图的内存大小。 +**参数说明**: 设置实时查询视图的内存大小。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 +**取值范围**: 整型，5 * 1024 ～ max_process_memory的50%，单位KB。 -**默认值**：5MB +**默认值**: 5MB ## topsql_retention_time -**参数说明**： 设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。 +**参数说明**: 设置历史TopSQL中gs_wlm_operator_info表中数据的保存时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~730，单位为天。 +**取值范围**: 整型，0~730，单位为天。 - 值为0时，表示数据永久保存。 - 值大于0时，表示数据能够保存的对应天数。 -**默认值**： 0 +**默认值**: 0 ## session_history_memory -**参数说明**： 设置历史查询视图的内存大小。 +**参数说明**: 设置历史查询视图的内存大小。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，10 * 1024～max_process_memory的50%，单位KB。 +**取值范围**: 整型，10 * 1024～max_process_memory的50%，单位KB。 -**默认值**：10MB +**默认值**: 10MB ## transaction_pending_time -**参数说明**： 事务块语句和存储过程语句排队的最大时间。 +**参数说明**: 事务块语句和存储过程语句排队的最大时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，-1～INT_MAX/2，单位为秒。 +**取值范围**: 整型，-1～INT_MAX/2，单位为秒。 - 值为-1或0时，事务块语句和存储过程语句无超时判断，排队至资源满足可执行条件。 - 值大于0时，事务块语句和存储过程语句排队超过所设数值的时间后，无视当前资源情况强制执行。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/14-automatic-vacuuming.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/14-automatic-vacuuming.md index 9e775570..75a23af0 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/14-automatic-vacuuming.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/14-automatic-vacuuming.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## autovacuum -**参数说明**：控制数据库自动清理线程（autovacuum）的启动。自动清理线程运行的前提是将[track_counts](1-query-and-index-statistics-collector#track_counts)设置为on。 +**参数说明**: 控制数据库自动清理线程（autovacuum）的启动。自动清理线程运行的前提是将[track_counts](1-query-and-index-statistics-collector#track_counts)设置为on。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -25,51 +25,51 @@ date: 2021-04-20 > > 即使此参数设置为off，当事务ID回绕即将发生时，数据库也会自动启动自动清理线程。对于create/drop database发生异常时，可能有的节点提交或回滚，有的节点未提交（prepared状态），此时系统不能自动修复，需要手动修复。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启数据库自动清理线程。 - off表示关闭数据库自动清理线程。 -**默认值**：on +**默认值**: on ## autovacuum_mode -**参数说明**：该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze或autovacuum的打开情况。 +**参数说明**: 该参数仅在autovacuum设置为on的场景下生效，它控制autoanalyze或autovacuum的打开情况。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - analyze表示只做autoanalyze。 - vacuum表示只做autovacuum。 - mix表示autoanalyze和autovacuum都做。 - none表示二者都不做。 -**默认值**：mix +**默认值**: mix ## autoanalyze_timeout -**参数说明**：设置autoanalyze的超时时间。在对某张表做autoanalyze时，如果该表的analyze时长超过了autoanalyze_timeout，则自动取消该表此次analyze。 +**参数说明**: 设置autoanalyze的超时时间。在对某张表做autoanalyze时，如果该表的analyze时长超过了autoanalyze_timeout，则自动取消该表此次analyze。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~2147483，单位是秒。 +**取值范围**: 整型，0~2147483，单位是秒。 -**默认值**：5min（即300s） +**默认值**: 5min（即300s） ## autovacuum_io_limits -**参数说明**：控制autovacuum线程每秒触发IO的上限。 +**参数说明**: 控制autovacuum线程每秒触发IO的上限。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 +**取值范围**: 整型，0～1073741823和-1。其中-1表示不控制，而是使用系统默认控制组。 -**默认值**：-1 +**默认值**: -1 ## log_autovacuum_min_duration -**参数说明**：当自动清理的执行时间大于或者等于某个特定的值时，向服务器日志中记录自动清理执行的每一步操作。设置此选项有助于追踪自动清理的行为。 +**参数说明**: 当自动清理的执行时间大于或者等于某个特定的值时，向服务器日志中记录自动清理执行的每一步操作。设置此选项有助于追踪自动清理的行为。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -77,113 +77,113 @@ date: 2021-04-20 将log_autovacuum_min_duration设置为250ms，记录所有运行大于或者等于250ms的自动清理命令的相关信息。 -**取值范围**：整型，最小值为-1，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为-1，最大值为2147483647，单位为毫秒。 - 当参数设置为0时，表示所有的自动清理操作都记录到日志中。 - 当参数设置为-1时，表示所有的自动清理操作都不记录到日志中。 - 当参数设置为非-1、非0时，当由于锁冲突的存在导致一个自动清理操作被跳过，记录一条消息。 -**默认值**：-1 +**默认值**: -1 ## autovacuum_max_workers -**参数说明**：设置能同时运行的自动清理线程的最大数量，该参数的取值上限与GUC参数max_connections和job_queue_processes大小有关。 +**参数说明**: 设置能同时运行的自动清理线程的最大数量，该参数的取值上限与GUC参数max_connections和job_queue_processes大小有关。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - max_connections的值 - job_queue_processes的值 - 辅助线程数 – autovacuum的lancher线程数 - 1”，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 +**取值范围**: 整型，最小值为0（表示不会自动进行autovacuum），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - max_connections的值 - job_queue_processes的值 - 辅助线程数 – autovacuum的lancher线程数 - 1”，其中辅助线程数和autovacuum的lancher线程数由两个宏来指定，当前版本的默认值分别为20和2。 -**默认值**：3 +**默认值**: 3 ## autovacuum_naptime -**参数说明**：设置两次自动清理操作的时间间隔。 +**参数说明**: 设置两次自动清理操作的时间间隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位为s，最小值为1，最大值为2147483。 +**取值范围**: 整型，单位为s，最小值为1，最大值为2147483。 -**默认值**：10min（即600s） +**默认值**: 10min（即600s） ## autovacuum_vacuum_threshold -**参数说明**：设置触发VACUUM的阈值。当表上被删除或更新的记录数超过设定的阈值时才会对这个表执行VACUUM操作。 +**参数说明**: 设置触发VACUUM的阈值。当表上被删除或更新的记录数超过设定的阈值时才会对这个表执行VACUUM操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值**：50 +**默认值**: 50 ## autovacuum_analyze_threshold -**参数说明**：设置触发ANALYZE操作的阈值。当表上被删除、插入或更新的记录数超过设定的阈值时才会对这个表执行ANALYZE操作。 +**参数说明**: 设置触发ANALYZE操作的阈值。当表上被删除、插入或更新的记录数超过设定的阈值时才会对这个表执行ANALYZE操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为2147483647。 +**取值范围**: 整型，最小值为0，最大值为2147483647。 -**默认值**：50 +**默认值**: 50 ## autovacuum_vacuum_scale_factor -**参数说明**：设置触发一个VACUUM时增加到autovacuum_vacuum_threshold的表大小的缩放系数。 +**参数说明**: 设置触发一个VACUUM时增加到autovacuum_vacuum_threshold的表大小的缩放系数。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值**：0.2 +**默认值**: 0.2 ## autovacuum_analyze_scale_factor -**参数说明**：设置触发一个ANALYZE时增加到autovacuum_analyze_threshold的表大小的缩放系数。 +**参数说明**: 设置触发一个ANALYZE时增加到autovacuum_analyze_threshold的表大小的缩放系数。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～100.0 +**取值范围**: 浮点型，0.0～100.0 -**默认值**：0.1 +**默认值**: 0.1 ## autovacuum_freeze_max_age -**参数说明**：设置事务内的最大时间，使得表的pg_class.relfrozenxid字段在VACUUM操作执行之前被写入。 +**参数说明**: 设置事务内的最大时间，使得表的pg_class.relfrozenxid字段在VACUUM操作执行之前被写入。 - VACUUM也可以删除pg_clog/子目录中的旧文件。 - 即使自动清理线程被禁止，系统也会调用自动清理线程来防止循环重复。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：长整型，100 000～576 460 752 303 423 487 +**取值范围**: 长整型，100 000～576 460 752 303 423 487 -**默认值**：4000000000 +**默认值**: 4000000000 ## autovacuum_vacuum_cost_delay -**参数说明**：设置在自动VACUUM操作里使用的开销延迟数值。 +**参数说明**: 设置在自动VACUUM操作里使用的开销延迟数值。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 +**取值范围**: 整型，-1～100，单位为毫秒（ms）。其中-1表示使用常规的vacuum_cost_delay。 -**默认值**：20ms +**默认值**: 20ms ## autovacuum_vacuum_cost_limit -**参数说明**：设置在自动VACUUM操作里使用的开销限制数值。 +**参数说明**: 设置在自动VACUUM操作里使用的开销限制数值。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 +**取值范围**: 整型，-1～10000。其中-1表示使用常规的vacuum_cost_limit。 -**默认值**：-1 +**默认值**: -1 ## defer_csn_cleanup_time -**参数说明**：用来指定本地回收时间间隔。 +**参数说明**: 用来指定本地回收时间间隔。 该参数属于SIGHUP类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0~INT_MAX，单位为毫秒（ms）。 -**默认值**：5s（即5000ms） +**默认值**: 5s（即5000ms） diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md index 8f4a5671..cc6bed90 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/1-statement-behavior.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## search_path -**参数说明**：当一个被引用对象没有指定模式时，此参数设置模式搜索顺序。它的值由一个或多个模式名构成，不同的模式名用逗号隔开。 +**参数说明**: 当一个被引用对象没有指定模式时，此参数设置模式搜索顺序。它的值由一个或多个模式名构成，不同的模式名用逗号隔开。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 @@ -20,37 +20,37 @@ date: 2021-04-20 - 当没有指定一个特定模式而创建一个对象时，它们被放置到以search_path为命名的第一个有效模式中。当搜索路径为空时，会报错误。 - 通过SQL函数current_schema可以检测当前搜索路径的有效值。这和检测search_path的值不尽相同，因为current_schema显示search_path中首位有效的模式名称。 -**取值范围**：字符串 +**取值范围**: 字符串 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置为“$user”，public时，支持共享数据库（没有用户具有私有模式和所有共享使用public）、用户私有模式和这些功能的组合使用。可以通过改变默认搜索路径来获得其他效果，无论是全局化的还是私有化的。 > - 设置为空串（''）的时候，系统会自动转换成一对双引号。 > - 设置的内容中包含双引号，系统会认为是不安全字符，会将每个双引号转换成一对双引号。 -**默认值**："$user",public +**默认值**: "$user",public -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，$user将被忽略。 ## current_schema -**参数说明**：此参数设置当前的模式。 +**参数说明**: 此参数设置当前的模式。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**："$user",public +**默认值**: "$user",public -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > \$user表示与当前会话用户名同名的模式名，如果这样的模式不存在，$user将被忽略。 ## default_tablespace -**参数说明**：当CREATE命令没有明确声明表空间时，所创建对象（表和索引等）的缺省表空间。 +**参数说明**: 当CREATE命令没有明确声明表空间时，所创建对象（表和索引等）的缺省表空间。 - 值是一个表空间的名称或者一个表示使用当前数据库缺省表空间的空字符串。若指定的是一个非默认表空间，用户必须具有它的CREATE权限，否则尝试创建会失败。 @@ -60,186 +60,186 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，其中空表示使用默认表空间。 +**取值范围**: 字符串，其中空表示使用默认表空间。 -**默认值**：空 +**默认值**: 空 ## temp_tablespaces -**参数说明**：当一个CREATE命令没有明确指定一个表空间时，temp_tablespaces指定了创建临时对象（临时表和临时表的索引）所在的表空间。在这些表空间中创建临时文件用来做大型数据的排序工作。 +**参数说明**: 当一个CREATE命令没有明确指定一个表空间时，temp_tablespaces指定了创建临时对象（临时表和临时表的索引）所在的表空间。在这些表空间中创建临时文件用来做大型数据的排序工作。 其值是一系列表空间名的列表。如果列表中有多个表空间时，每次临时对象的创建，MogDB会在列表中随机选择一个表空间；如果在事务中，连续创建的临时对象被放置在列表里连续的表空间中。如果选择的列表中的元素是一个空串，MogDB将自动将当前的数据库设为默认的表空间。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 +**取值范围**: 字符串。空字符串表示所有的临时对象仅在当前数据库默认的表空间中创建，请参见[default_tablespace](#default_tablespace)。 -**默认值**：空 +**默认值**: 空 ## check_function_bodies -**参数说明**：设置是否在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。为了避免产生问题（比如避免从转储中恢复函数定义时向前引用的问题），偶尔会禁用验证。 +**参数说明**: 设置是否在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。为了避免产生问题（比如避免从转储中恢复函数定义时向前引用的问题），偶尔会禁用验证。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在CREATE FUNCTION执行过程中进行函数体字符串的合法性验证。 - off表示在CREATE FUNCTION执行过程中不进行函数体字符串的合法性验证。 -**默认值**：on +**默认值**: on ## default_transaction_isolation -**参数说明**：设置默认的事务隔离级别。 +**参数说明**: 设置默认的事务隔离级别。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - read committed表示事务读已提交。 - repeatable read表示事务可重复读。 - serializable，MogDB目前功能上不支持此隔离级别，等价于repeatable read。 -**默认值**：read committed +**默认值**: read committed ## default_transaction_read_only -**参数说明**：设置每个新创建事务是否是只读状态。 +**参数说明**: 设置每个新创建事务是否是只读状态。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示只读状态。 - off表示非只读状态。 -**默认值**：off +**默认值**: off ## default_transaction_deferrable -**参数说明**：控制每个新事务的默认延迟状态。只读事务或者那些比序列化更加低的隔离级别的事务除外。 +**参数说明**: 控制每个新事务的默认延迟状态。只读事务或者那些比序列化更加低的隔离级别的事务除外。 MogDB不支持可串行化的隔离级别，因此，该参数无实际意义。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示默认延迟。 - off表示默认不延迟。 -**默认值**：off +**默认值**: off ## session_replication_role -**参数说明**：控制当前会话与复制相关的触发器和规则的行为。 +**参数说明**: 控制当前会话与复制相关的触发器和规则的行为。 该参数属于SUSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**设置此参数会丢弃之前任何缓存的执行计划。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:设置此参数会丢弃之前任何缓存的执行计划。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - origin表示从当前会话中复制插入、删除、更新等操作。 - replica表示从其他地方复制插入、删除、更新等操作到当前会话。 - local表示函数执行复制时会检测当前登录数据库的角色并采取相应的操作。 -**默认值**：origin +**默认值**: origin ## statement_timeout -**参数说明**：当语句执行时间超过该参数设置的时间（从服务器收到命令时开始计时）时，该语句将会报错并退出执行。 +**参数说明**: 当语句执行时间超过该参数设置的时间（从服务器收到命令时开始计时）时，该语句将会报错并退出执行。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为2147483647，单位为毫秒。 +**取值范围**: 整型，最小值为0，最大值为2147483647，单位为毫秒。 -**默认值**：0 +**默认值**: 0 ## vacuum_freeze_min_age -**参数说明**：指定VACUUM在扫描一个表时用于判断是否用FrozenXID替换事务ID的中断寿命（在同一个事务中）。 +**参数说明**: 指定VACUUM在扫描一个表时用于判断是否用FrozenXID替换事务ID的中断寿命（在同一个事务中）。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 尽管随时可以将此参数设为0到10亿之间的任意值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的50%以内。 -**默认值**：2000000000 +**默认值**: 2000000000 ## vacuum_freeze_table_age -**参数说明**：指定VACUUM对全表的扫描冻结元组的时间。如果表的pg_class.relfrozenxid字段的值已经达到了参数指定的时间，VACUUM对全表进行扫描。 +**参数说明**: 指定VACUUM对全表的扫描冻结元组的时间。如果表的pg_class.relfrozenxid字段的值已经达到了参数指定的时间，VACUUM对全表进行扫描。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～576 460 752 303 423 487 +**取值范围**: 整型，0～576 460 752 303 423 487 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 尽管随时可以将此参数设为零到20亿之间的值，但是，VACUUM将默认其有效值范围限制在autovacuum_freeze_max_age的95%以内。定期的手动VACUUM可以在对此表的反重叠自动清理启动之前运行。 -**默认值**：15000000000 +**默认值**: 15000000000 ## bytea_output -**参数说明**：设置bytea类型值的输出格式。 +**参数说明**: 设置bytea类型值的输出格式。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - hex：将二进制数据编码为每字节2位十六进制数字。 - escape：传统化的PostgreSQL格式。采用以ASCII字符序列表示二进制串的方法，同时将那些无法表示成ASCII字符的二进制串转换成特殊的转义序列。 -**默认值**：hex +**默认值**: hex ## xmlbinary -**参数说明**：设置二进制值是如何在XML中进行编码的。 +**参数说明**: 设置二进制值是如何在XML中进行编码的。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - base64 - hex -**默认值**：base64 +**默认值**: base64 ## xmloption -**参数说明**：当XML和字符串值之间进行转换时，设置document或content是否是隐含的。 +**参数说明**: 当XML和字符串值之间进行转换时，设置document或content是否是隐含的。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - document：表示HTML格式的文档。 - content：普通的字符串。 -**默认值**：content +**默认值**: content ## max_compile_functions -**参数说明**：设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值，有助于减少内存占用，提升系统性能。 +**参数说明**: 设置服务器存储的函数编译结果的最大数量。存储过多的函数和存储过程的编译结果可能占用很大内存。将此参数设置为一个合理的值，有助于减少内存占用，提升系统性能。 该参数属于POSTMASTER类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~ 2147483647。 +**取值范围**: 整型，1~ 2147483647。 -**默认值**：1000 +**默认值**: 1000 ## gin_pending_list_limit -**参数说明**：设置当GIN索引启用fastupdate时，pending list容量的最大值。当pending list的容量大于设置值时，会把pending list中数据批量移动到GIN索引数据结构中以进行清理。单个GIN索引可通过更改索引存储参数覆盖此设置值。 +**参数说明**: 设置当GIN索引启用fastupdate时，pending list容量的最大值。当pending list的容量大于设置值时，会把pending list中数据批量移动到GIN索引数据结构中以进行清理。单个GIN索引可通过更改索引存储参数覆盖此设置值。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为64，最大值为INT_MAX，单位为KB。 +**取值范围**: 整型，最小值为64，最大值为INT_MAX，单位为KB。 -**默认值**：4MB +**默认值**: 4MB diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md index 7933f90e..fced12ed 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/2-zone-and-formatting.md @@ -11,15 +11,15 @@ date: 2021-04-20 ## DateStyle -**参数说明**：设置日期和时间值的显示格式，以及有歧义的输入值的解析规则。 +**参数说明**: 设置日期和时间值的显示格式，以及有歧义的输入值的解析规则。 这个变量包含两个独立的加载部分：输出格式声明（ISO、Postgres、SQL、German）和输入输出的年/月/日顺序（DMY、MDY、YMD）。这两个可以独立设置或者一起设置。关键字Euro和European等价于DMY；关键字US、NonEuro、NonEuropean等价于MDY。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：ISO，MDY +**默认值**: ISO，MDY > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > gs_initdb会将这个参数初始化成与[lc_time](#lc_time)一致的值。 @@ -28,11 +28,11 @@ date: 2021-04-20 ## IntervalStyle -**参数说明**：设置区间值的显示格式。 +**参数说明**: 设置区间值的显示格式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - sql_standard表示产生与SQL标准规定匹配的输出。 - postgres表示产生与PostgreSQL 8.4版本相匹配的输出，当[DateStyle](#DateStyle)参数被设为ISO时。 @@ -43,58 +43,58 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > IntervalStyle参数也会影响不明确的间隔输入的说明。 -**默认值**：postgres +**默认值**: postgres ## TimeZone -**参数说明**：设置显示和解释时间类型数值时使用的时区。 +**参数说明**: 设置显示和解释时间类型数值时使用的时区。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，可查询视图PG_TIMEZONE_NAMES获得。 +**取值范围**: 字符串，可查询视图PG_TIMEZONE_NAMES获得。 -**默认值**：PRC +**默认值**: PRC > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > gs_initdb将设置一个与其系统环境一致的时区值。 ## timezone_abbreviations -**参数说明**：设置服务器接受的时区缩写值。 +**参数说明**: 设置服务器接受的时区缩写值。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，可查询视图pg_timezone_names获得。 +**取值范围**: 字符串，可查询视图pg_timezone_names获得。 -**默认值**：Default +**默认值**: Default > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > Default表示通用时区的缩写, 适合绝大部分情况。但也可设置其他诸如 'Australia' 和 'India' 等用来定义特定的安装。而设置除此之外的时区缩写, 需要在建数据库之前通过相应的配置文件进行设置。 ## extra_float_digits -**参数说明**：这个参数为浮点数值调整显示的数据位数，浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上（FLT_DIG或DBL_DIG中合适的）。 +**参数说明**: 这个参数为浮点数值调整显示的数据位数，浮点类型包括float4、float8 以及几何数据类型。参数值加在标准的数据位数上（FLT_DIG或DBL_DIG中合适的）。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-15～3 +**取值范围**: 整型，-15～3 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 设置为3，表示包括部分关键的数据位。这个功能对转储那些需要精确恢复的浮点数据特别有用。 > - 设置为负数，表示消除不需要的数据位。 -**默认值**：0 +**默认值**: 0 ## client_encoding -**参数说明**：设置客户端的字符编码类型。 +**参数说明**: 设置客户端的字符编码类型。 请根据前端业务的情况确定。尽量客户端编码和服务器端编码一致，提高效率。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 +**取值范围**: 兼容PostgreSQL所有的字符编码类型。其中UTF8表示使用数据库的字符编码类型。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > @@ -102,13 +102,13 @@ date: 2021-04-20 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 > - 参数建议保持默认值，不建议通过gs_guc工具或其他方式直接在postgresql.conf文件中设置client_encoding参数，即使设置也不会生效，以保证MogDB内部通信编码格式一致。 -**默认值**：UTF8 +**默认值**: UTF8 **推荐值:**SQL_ASCII/UTF8 ## lc_messages -**参数说明**：设置信息显示的语言。 +**参数说明**: 设置信息显示的语言。 - 可接受的值是与系统相关的。 @@ -116,63 +116,63 @@ date: 2021-04-20 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值**：C +**默认值**: C ## lc_monetary -**参数说明**：设置货币值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 +**参数说明**: 设置货币值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值**：C +**默认值**: C ## lc_numeric -**参数说明**：设置数值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 +**参数说明**: 设置数值的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值**：C +**默认值**: C ## lc_time -**参数说明**：设置时间和区域的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 +**参数说明**: 设置时间和区域的显示格式，影响to_char之类的函数的输出。可接受的值是系统相关的。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > - 使用命令locale -a查看当前系统支持的区域和相应的编码格式，并可以选择进行设置。 > - 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 -**默认值**：C +**默认值**: C ## default_text_search_config -**参数说明**：设置全文检索的配置信息。 +**参数说明**: 设置全文检索的配置信息。 如果设置为不存在的文本搜索配置时将会报错。如果default_text_search_config对应的文本搜索配置被删除，需要重新设置default_text_search_config，否则会报设置错误。 @@ -182,9 +182,9 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > MogDB支持pg_catalog.english、pg_catalog.simple两种配置。 -**默认值**：pg_catalog.english +**默认值**: pg_catalog.english diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md index 6301529a..0ffca05d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/15-default-settings-of-client-connection/3-other-default-parameters.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## dynamic_library_path -**参数说明**：设置数据查找动态加载的共享库文件的路径。当需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令里面声明的名称没有目录部分时，系统将搜索这个目录以查找声明的文件。 +**参数说明**: 设置数据查找动态加载的共享库文件的路径。当需要打开一个可以动态装载的模块并且在CREATE FUNCTION或LOAD命令里面声明的名称没有目录部分时，系统将搜索这个目录以查找声明的文件。 用于dynamic_library_path的数值必须是一个冒号分隔的绝对路径列表。当一个路径名称以特殊变量\$libdir为开头时，会替换为MogDB发布提供的模块安装路径。例如： @@ -26,21 +26,21 @@ dynamic_library_path = '/usr/local/lib/mogdb:/opt/testgs/lib:$libdir' > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > 设置为空字符串，表示关闭自动路径搜索。 -**默认值**： `$libdir` +**默认值**: `$libdir` ## gin_fuzzy_search_limit -**参数说明**：设置GIN索引返回的集合大小的上限。 +**参数说明**: 设置GIN索引返回的集合大小的上限。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：0 +**默认值**: 0 ## local_preload_libraries -**参数说明**：指定一个或多个共享库，它们在开始连接前预先加载。多个加载库之间用逗号分隔，除了双引号，所有的库名都转换为小写。 +**参数说明**: 指定一个或多个共享库，它们在开始连接前预先加载。多个加载库之间用逗号分隔，除了双引号，所有的库名都转换为小写。 - 并非只有系统管理员才能更改此选项，因此只能加载安装的标准库目录下plugins子目录中的库文件，数据库管理员有责任确保该目录中的库都是安全的。local_preload_libraries中指定的项可以明确含有该目录，例如`$libdir/plugins/mylib`; 也可以仅指定库的名称，例如mylib（等价于`$libdir/plugins/mylib`）。 - 与shared_preload_libraries不同，在会话开始之前加载模块与在会话中使用到该模块的时候临时加载相比并不具有性能优势。相反，这个特性的目的是为了调试或者测量在特定会话中不明确使用LOAD加载的库。例如针对某个用户将该参数设为ALTER USER SET来进行调试。 @@ -49,6 +49,6 @@ dynamic_library_path = '/usr/local/lib/mogdb:/opt/testgs/lib:$libdir' 该参数属于BACKEND类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/16-lock-management.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/16-lock-management.md index 5cfb76e2..279c7634 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/16-lock-management.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/16-lock-management.md @@ -11,40 +11,40 @@ date: 2021-04-20 ## deadlock_timeout -**参数说明**：设置死锁超时检测时间，以毫秒为单位。当申请的锁超过设定值时，系统会检查是否产生了死锁。 +**参数说明**: 设置死锁超时检测时间，以毫秒为单位。当申请的锁超过设定值时，系统会检查是否产生了死锁。 - 死锁的检查代价是比较高的，服务器不会在每次等待锁的时候都运行这个过程。在系统运行过程中死锁是不经常出现的，因此在检查死锁前只需等待一个相对较短的时间。增加这个值就减少了无用的死锁检查浪费的时间，但是会减慢真正的死锁错误报告的速度。在一个负载过重的服务器上，用户可能需要增大它。这个值的设置应该超过事务持续时间，这样就可以减少在锁释放之前就开始死锁检查的问题。 - 当设置log_lock_waits为on时，deadlock_timeout决定一个等待时间来将查询执行过程中的锁等待耗时信息写入日志。如果要研究锁延时情况，可以设置deadlock_timeout的值比正常情况小。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~2147483647，单位为毫秒（ms）。 +**取值范围**: 整型，1~2147483647，单位为毫秒（ms）。 -**默认值**：1s +**默认值**: 1s ## lockwait_timeout -**参数说明**：控制单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。 +**参数说明**: 控制单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值**：20min +**默认值**: 20min ## update_lockwait_timeout -**参数说明**：允许并发更新参数开启情况下，该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。 +**参数说明**: 允许并发更新参数开启情况下，该参数控制并发更新同一行时单个锁的最长等待时间。当申请的锁等待时间超过设定值时，系统会报错。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值**：2min +**默认值**: 2min ## max_locks_per_transaction -**参数说明**：控制每个事务能够得到的平均的对象锁的数量。 +**参数说明**: 控制每个事务能够得到的平均的对象锁的数量。 - 共享的锁表的大小是以假设任意时刻最多只有max_locks_per_transaction*(max_connections+max_prepared_transactions) 个独立的对象需要被锁住为基础进行计算的。不超过设定数量的多个对象可以在任一时刻同时被锁定。当在一个事务里面修改很多不同的表时，可能需要提高这个默认数值。只能在数据库启动的时候设置。 - 增大这个参数可能导致MogDB请求更多的System V共享内存，有可能超过操作系统的缺省配置。 @@ -52,39 +52,39 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值**：256 +**默认值**: 256 ## max_pred_locks_per_transaction -**参数说明**：控制每个事务允许断定锁的最大数量，是一个平均值。 +**参数说明**: 控制每个事务允许断定锁的最大数量，是一个平均值。 - 共享的断定锁表的大小是以假设任意时刻最多只有max_pred_locks_per_transaction*(max_connections+max_prepared_transactions) 个独立的对象需要被锁住为基础进行计算的。不超过设定数量的多个对象可以在任一时刻同时被锁定。当在一个事务里面修改很多不同的表时，可能需要提高这个默认数值。只能在服务器启动的时候设置。 - 增大这个参数可能导致MogDB请求更多的System V共享内存，有可能超过操作系统的缺省配置。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10 ~ INT_MAX +**取值范围**: 整型，10 ~ INT_MAX -**默认值**：64 +**默认值**: 64 ## gs_clean_timeout -**参数说明**：控制主节点周期性清理临时表的时间，是一个平均值。 +**参数说明**: 控制主节点周期性清理临时表的时间，是一个平均值。 - 数据库连接异常终止时，通常会有临时表残留，此时需要对数据库中的临时表进行清理。 - 增大这个参数可能导致MogDB临时表清理时间延长。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 2147483，单位为秒（s）。 +**取值范围**: 整型，0 ~ 2147483，单位为秒（s）。 -**默认值**：1min +**默认值**: 1min ## partition_lock_upgrade_timeout -**参数说明**：在执行某些查询语句的过程中，会需要将分区表上的锁级别由允许读的ExclusiveLock级别升级到读写阻塞的AccessExclusiveLock级别。如果此时已经存在并发的读事务，那么该锁升级操作将阻塞等待。partition_lock_upgrade_timeout为尝试锁升级的等待超时时间。 +**参数说明**: 在执行某些查询语句的过程中，会需要将分区表上的锁级别由允许读的ExclusiveLock级别升级到读写阻塞的AccessExclusiveLock级别。如果此时已经存在并发的读事务，那么该锁升级操作将阻塞等待。partition_lock_upgrade_timeout为尝试锁升级的等待超时时间。 - 在分区表上进行MERGE PARTITION和CLUSTER PARTITION操作时，都利用了临时表进行数据重排和文件交换，为了最大程度提高分区上的操作并发度，在数据重排阶段给相关分区加锁ExclusiveLock，在文件交换阶段加锁AccessExclusiveLock。 @@ -96,46 +96,46 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值-1，最大值3000，单位为秒（s）。 +**取值范围**: 整型，最小值-1，最大值3000，单位为秒（s）。 -**默认值**：1800 +**默认值**: 1800 ## fault_mon_timeout -**参数说明**：轻量级死锁检测周期。 +**参数说明**: 轻量级死锁检测周期。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值0，最大值1440，单位为分钟（min） +**取值范围**: 整型，最小值0，最大值1440，单位为分钟（min） -**默认值**：5min +**默认值**: 5min ## enable_online_ddl_waitlock -**参数说明**：控制DDL是否会阻塞等待pg_advisory_lock/pgxc_lock_for_backup等MogDB锁。主要用于OM在线操作场景，不建议用户设置。 +**参数说明**: 控制DDL是否会阻塞等待pg_advisory_lock/pgxc_lock_for_backup等MogDB锁。主要用于OM在线操作场景，不建议用户设置。 该参数属于SIGHUP类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启。 - off表示关闭。 -**默认值**：off +**默认值**: off ## xloginsert_locks -**参数说明**：控制用于并发写预写式日志锁的个数。主要用于提高写预写式日志的效率。 +**参数说明**: 控制用于并发写预写式日志锁的个数。主要用于提高写预写式日志的效率。 该参数属于POSTMASTER类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，最小值1，最大值1000 +**取值范围**: 整型，最小值1，最大值1000 -**默认值**：8 +**默认值**: 8 ## num_internal_lock_partitions -**参数说明**：控制内部轻量级锁分区的个数。主要用于各类场景的性能调优。内容以关键字和数字的KV方式组织，各个不同类型锁之间以逗号隔开。先后顺序对设置结果不影响，例如“CLOG_PART=256,CSNLOG_PART=512”等同于“CSNLOG_PART=512,CLOG_PART=256”。重复设置同一关键字时，以最后一次设置为准，例如“CLOG_PART=256,CLOG_PART=2”，设置的结果为CLOG_PART=2。当没有设置关键字时，则为默认值，各类锁的使用描述和最大、最小、默认值如下。 +**参数说明**: 控制内部轻量级锁分区的个数。主要用于各类场景的性能调优。内容以关键字和数字的KV方式组织，各个不同类型锁之间以逗号隔开。先后顺序对设置结果不影响，例如“CLOG_PART=256,CSNLOG_PART=512”等同于“CSNLOG_PART=512,CLOG_PART=256”。重复设置同一关键字时，以最后一次设置为准，例如“CLOG_PART=256,CLOG_PART=2”，设置的结果为CLOG_PART=2。当没有设置关键字时，则为默认值，各类锁的使用描述和最大、最小、默认值如下。 - CLOG_PART：CLOG文件控制器的个数。增大该值可以提高CLOG日志写入效率，提升事务提交性能，但是会增大内存使用；减小该值会减少相应内存使用，但可能使得CLOG日志写入冲突变大，影响性能。最小值为1，最大值为256。 - CSNLOG_PART：CSNLOG文件控制器的个数。增大该值可以提高CSNLOG日志写入效率，提升事务提交性能，但是会增大内存使用；减小该值会减少相应内存使用，但可能使得CSNLOG日志写入冲突变大，影响性能。最小值为1，最大值为512。 @@ -144,7 +144,7 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 **默认值**: diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md index 06f85131..52b09858 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/1-compatibility-with-earlier-versions.md @@ -11,123 +11,123 @@ MogDB介绍数据库的向下兼容性和对外兼容性特性的参数控制。 ## array_nulls -**参数说明**：控制数组输入解析器是否将未用引用的NULL识别为数组的一个NULL元素。 +**参数说明**: 控制数组输入解析器是否将未用引用的NULL识别为数组的一个NULL元素。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许向数组中输入空元素。 - off表示向下兼容旧式模式。仍然能够创建包含NULL值的数组。 -**默认值**：on +**默认值**: on ## backslash_quote -**参数说明**：控制字符串文本中的单引号是否能够用\'表示。 +**参数说明**: 控制字符串文本中的单引号是否能够用\'表示。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 在字符串文本符合SQL标准的情况下，\\没有任何其他含义。这个参数影响的是如何处理不符合标准的字符串文本，包括明确的字符串转义语法是（E'...')。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on表示一直允许使用\'表示。 - off表示拒绝使用\'表示。 - safe_encoding表示仅在客户端字符集编码不会在多字节字符末尾包含\\的ASCII值时允许。 -**默认值**：safe_encoding +**默认值**: safe_encoding ## escape_string_warning -**参数说明**：警告在普通字符串中直接使用反斜杠转义。 +**参数说明**: 警告在普通字符串中直接使用反斜杠转义。 - 如果需要使用反斜杠作为转义，可以调整为使用转义字符串语法（E'...'）来做转义，因为在每个SQL标准中，普通字符串的默认行为现在将反斜杠作为一个普通字符。 - 这个变量可以帮助定位需要改变的代码。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：on +**默认值**: on ## lo_compat_privileges -**参数说明**：控制是否启动对大对象权限检查的向后兼容模式。 +**参数说明**: 控制是否启动对大对象权限检查的向后兼容模式。 该参数属于SUSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 on表示当读取或修改大对象时禁用权限检查，与PostgreSQL 9.0以前的版本兼容。 -**默认值**：off +**默认值**: off ## quote_all_identifiers -**参数说明**：当数据库生成SQL时，此选项强制引用所有的标识符（包括非关键字）。这将影响到EXPLAIN的输出及函数的结果，例如pg_get_viewdef。详细说明请参见gs_dump的--quote-all-identifiers选项。 +**参数说明**: 当数据库生成SQL时，此选项强制引用所有的标识符（包括非关键字）。这将影响到EXPLAIN的输出及函数的结果，例如pg_get_viewdef。详细说明请参见gs_dump的--quote-all-identifiers选项。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开强制引用。 - off表示关闭强制引用。 -**默认值**：off +**默认值**: off ## sql_inheritance -**参数说明**：控制继承语义。用来控制继承表的访问策略，off表示各种命令不能访问子表，即默认使用ONLY关键字。这是为了兼容旧版本而设置的。 +**参数说明**: 控制继承语义。用来控制继承表的访问策略，off表示各种命令不能访问子表，即默认使用ONLY关键字。这是为了兼容旧版本而设置的。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以访问子表。 - off表示不访问子表。 -**默认值**：on +**默认值**: on ## standard_conforming_strings -**参数说明**：控制普通字符串文本（'...'）中是否按照SQL标准把反斜扛当普通文本。 +**参数说明**: 控制普通字符串文本（'...'）中是否按照SQL标准把反斜扛当普通文本。 - 应用程序通过检查这个参数可以判断字符串文本的处理方式。 - 建议明确使用转义字符串语法（E'...'）来转义字符。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值**：on +**默认值**: on ## synchronize_seqscans -**参数说明**：控制启动同步的顺序扫描。在大约相同的时间内并行扫描读取相同的数据块，共享I/O负载。 +**参数说明**: 控制启动同步的顺序扫描。在大约相同的时间内并行扫描读取相同的数据块，共享I/O负载。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示扫描可能从表的中间开始，然后选择“环绕”方式来覆盖所有的行，为了与已经在进行中的扫描活动同步。这可能会造成没有用ORDER BY子句的查询得到行排序造成不可预测的后果。 - off表示确保顺序扫描是从表头开始的。 -**默认值**：on +**默认值**: on ## enable_beta_features -**参数说明**：控制开启某些非正式发布的特性，仅用于POC验证。这些特性属于延伸特性，建议客户谨慎开启，在某些功能场景下可能存在问题。 +**参数说明**: 控制开启某些非正式发布的特性，仅用于POC验证。这些特性属于延伸特性，建议客户谨慎开启，在某些功能场景下可能存在问题。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启这些功能受限的特性，保持前向兼容。但某些场景可能存在功能上的问题。 - off表示禁止使用这些特性。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md index 8e9778c4..e4799140 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/17-version-and-platform-compatibility/2-platform-and-client-compatibility.md @@ -11,101 +11,101 @@ date: 2021-04-20 ## convert_string_to_digit -**参数说明**：设置隐式转换优先级，是否优先将字符串转为数字。 +**参数说明**: 设置隐式转换优先级，是否优先将字符串转为数字。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示优先将字符串转为数字。 - off表示不优先将字符串转为数字。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 该参数调整会修改内部数据类型转换规则，导致不可预期的行为，请谨慎操作。 ## nls_timestamp_format -**参数说明**：设置时间戳默认格式。 +**参数说明**: 设置时间戳默认格式。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：DD-Mon-YYYY HH:MI:SS.FF AM +**默认值**: DD-Mon-YYYY HH:MI:SS.FF AM ## max_function_args -**参数说明**：函数参数最大个数。 +**参数说明**: 函数参数最大个数。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型 +**取值范围**: 整型 -**默认值**：8192 +**默认值**: 8192 ## transform_null_equals -**参数说明**：控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。如果expr得出NULL值则返回真，否则返回假。 +**参数说明**: 控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。如果expr得出NULL值则返回真，否则返回假。 - 正确的SQL标准兼容的expr = NULL总是返回NULL（未知）。 - Microsoft Access里的过滤表单生成的查询使用expr = NULL来测试空值。打开这个选项，可以使用该接口来访问数据库。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示控制表达式expr = NULL（或NULL = expr）当做expr IS NULL处理。 - off表示不控制，即expr = NULL总是返回NULL（未知）。 -**默认值**：off +**默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 新用户经常在涉及NULL的表达式上语义混淆，故默认值设为off。 ## support_extended_features -**参数说明**：控制是否支持数据库的扩展特性。 +**参数说明**: 控制是否支持数据库的扩展特性。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持数据库的扩展特性。 - off表示不支持数据库的扩展特性。 -**默认值**：off +**默认值**: off ## sql_compatibility -**参数说明**：控制数据库的SQL语法和语句行为同哪一个主流数据库兼容。 +**参数说明**: 控制数据库的SQL语法和语句行为同哪一个主流数据库兼容。 该参数属于INTERNAL类型参数，用户无法修改，只能查看。 -**取值范围**：枚举型 +**取值范围**: 枚举型 - A表示同O数据库兼容。 - B表示同MY数据库兼容。 - C表示同TD数据库兼容。 - PG表示同POSTGRES数据库兼容。 -**默认值**：A +**默认值**: A -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 该参数只能在执行[CREATE DATABASE](CREATE-DATABASE)命令创建数据库的时候设置。 > - 在数据库中，该参数只能是确定的一个值，要么始终设置为A，要么始终设置为B，请勿任意改动，否则会导致数据库行为不一致。 ## behavior_compat_options -**参数说明**：数据库兼容性行为配置项，该参数的值由若干个配置项用逗号隔开构成。 +**参数说明**: 数据库兼容性行为配置项，该参数的值由若干个配置项用逗号隔开构成。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前只支持[表1](#jianrongxing)。 > - 配置多个兼容性配置项时，相邻配置项用逗号隔开，例如：set behavior_compat_options='end_month_calculate,display_leading_zero'; @@ -137,42 +137,42 @@ date: 2021-04-20 ## plpgsql.variable_conflict -**参数说明**：设置同名的存储过程变量和表的列的使用优先级。 +**参数说明**: 设置同名的存储过程变量和表的列的使用优先级。 该参数属于USERSET类型参数，仅支持表[GUC参数设置方式](30-appendix)中对应设置方法3进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - error表示遇到存储过程变量和表的列名同名则编译报错。 - use_variable表示存储过程变量和表的列名同名则优先使用变量。 - use_column表示存储过程变量和表的列名同名则优先使用列名。 -**默认值**：error +**默认值**: error ## td_compatible_truncation -**参数说明**：控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 +**参数说明**: 控制是否开启与Teradata数据库相应兼容的特征。该参数在用户连接上与TD兼容的数据库时，可以将参数设置成为on（即超长字符串自动截断功能启用），该功能启用后，在后续的insert语句中，对目标表中char和varchar类型的列插入超长字符串时，会按照目标表中相应列定义的最大长度对超长字符串进行自动截断。保证数据都能插入目标表中，而不是报错。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 超长字符串自动截断功能不适用于insert语句包含外表的场景。如果向字符集为字节类型编码（SQL_ASCII、LATIN1等）的数据库中插入多字节字符数据（如汉字等)，且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 超长字符串自动截断功能不适用于insert语句包含外表的场景。如果向字符集为字节类型编码（SQL_ASCII、LATIN1等）的数据库中插入多字节字符数据（如汉字等)，且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启动超长字符串自动截断功能。 - off表示停止超长字符串自动截断功能。 -**默认值**：off +**默认值**: off ## lastval_supported -**参数说明**：控制是否可以使用lastval函数。 +**参数说明**: 控制是否可以使用lastval函数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持lastval函数，同时nextval函数不支持下推。 - off表示不支持lastval函数，同时nextval函数可以下推。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/18-fault-tolerance.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/18-fault-tolerance.md index b7d7280c..b4364c4d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/18-fault-tolerance.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/18-fault-tolerance.md @@ -11,24 +11,24 @@ date: 2021-04-20 ## exit_on_error -**参数说明**：打开该开关，ERROR级别报错会升级为PANIC报错，从而可以产生core堆栈。主要用于问题定位和业务测试。 +**参数说明**: 打开该开关，ERROR级别报错会升级为PANIC报错，从而可以产生core堆栈。主要用于问题定位和业务测试。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示ERROR级别报错会升级为PANIC报错。 - off表示不会对ERROR级别报错进行升级。 -**默认值**：off +**默认值**: off ## restart_after_crash -**参数说明**：设置为on，后端进程崩溃时，MogDB将自动重新初始化此后端进程。 +**参数说明**: 设置为on，后端进程崩溃时，MogDB将自动重新初始化此后端进程。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示能够最大限度地提高数据库的可用性。 @@ -36,84 +36,84 @@ date: 2021-04-20 - off表示能够使得管理工具在后端进程崩溃时获取控制权并采取适当的措施进行处理。 -**默认值**：on +**默认值**: on ## omit_encoding_error -**参数说明**：设置为on，数据库的客户端字符集编码为UTF-8时，出现的字符编码转换错误将打印在日志中，有转换错误的被转换字符会被忽略，以“?”代替。 +**参数说明**: 设置为on，数据库的客户端字符集编码为UTF-8时，出现的字符编码转换错误将打印在日志中，有转换错误的被转换字符会被忽略，以“?”代替。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示有转换错误的字符将被忽略，以“?”代替，打印错误信息到日志中。 - off表示有转换错误的字符不能被转换，打印错误信息到终端。 -**默认值**：off +**默认值**: off ## max_query_retry_times -**参数说明**：指定SQL语句出错自动重试功能的最大重跑次数（目前支持重跑的错误类型为“Connection reset by peer”、“Lock wait timeout”和“Connection timed out”等），设定为0时关闭重跑功能。 +**参数说明**: 指定SQL语句出错自动重试功能的最大重跑次数（目前支持重跑的错误类型为“Connection reset by peer”、“Lock wait timeout”和“Connection timed out”等），设定为0时关闭重跑功能。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~20。 +**取值范围**: 整型，0~20。 -**默认值**：0 +**默认值**: 0 ## cn_send_buffer_size -**参数说明**：指定数据库主节点发送数据缓存区的大小。 +**参数说明**: 指定数据库主节点发送数据缓存区的大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，8~128， 单位为KB。 +**取值范围**: 整型，8~128， 单位为KB。 -**默认值**：8KB +**默认值**: 8KB ## max_cn_temp_file_size -**参数说明**：指定SQL语句出错自动重试功能中数据库主节点端使用临时文件的最大值，设定为0表示不使用临时文件。 +**参数说明**: 指定SQL语句出错自动重试功能中数据库主节点端使用临时文件的最大值，设定为0表示不使用临时文件。 该参数属于SIGHUP类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~10485760， 单位为KB。 +**取值范围**: 整型，0~10485760， 单位为KB。 -**默认值**：5GB +**默认值**: 5GB ## retry_ecode_list -**参数说明**：指定SQL语句出错自动重试功能支持的错误类型列表。 +**参数说明**: 指定SQL语句出错自动重试功能支持的错误类型列表。 该参数属于USERSET类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 +**默认值**: YY001 YY002 YY003 YY004 YY005 YY006 YY007 YY008 YY009 YY010 YY011 YY012 YY013 YY014 YY015 53200 08006 08000 57P01 XX003 XX009 YY016 ## data_sync_retry -**参数说明**：控制当fsync到磁盘失败后是否继续运行数据库。由于在某些操作系统的场景下，fsync失败后重试阶段即使再次fsync失败也不会报错，从而导致数据丢失。 +**参数说明**: 控制当fsync到磁盘失败后是否继续运行数据库。由于在某些操作系统的场景下，fsync失败后重试阶段即使再次fsync失败也不会报错，从而导致数据丢失。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示当fsync同步到磁盘失败后采取重试机制，数据库继续运行。 - off表示当fsync同步到磁盘失败后直接报panic，停止数据库。 -**默认值**：off +**默认值**: off ## remote_read_mode -**参数说明**：远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 +**参数说明**: 远程读功能开关。读取主机上的页面失败时可以从备机上读取对应的页面。 该参数属于POSTMASTER类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - off表示关闭远程读功能。 - non_authentication表示开启远程读功能，但不进行证书认证。 - authentication表示开启远程读功能，但要进行证书认证。 -**默认值**：authentication +**默认值**: authentication diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/19-connection-pool-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/19-connection-pool-parameters.md index 6a022ea5..1ca28b12 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/19-connection-pool-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/19-connection-pool-parameters.md @@ -11,37 +11,37 @@ date: 2021-04-20 ## pooler_maximum_idle_time -**参数说明**：Pooler链接自动清理功能使用，当链接池中链接空闲时间超过所设置值时，会触发自动清理机制，清理各节点的空闲链接数到minimum_pool_size。 +**参数说明**: Pooler链接自动清理功能使用，当链接池中链接空闲时间超过所设置值时，会触发自动清理机制，清理各节点的空闲链接数到minimum_pool_size。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此参数在该版本不生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此参数在该版本不生效。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为INT_MAX，最小单位为分钟 +**取值范围**: 整型，最小值为0，最大值为INT_MAX，最小单位为分钟 -**默认值**：1h（即60min） +**默认值**: 1h（即60min） ## minimum_pool_size -**参数说明**：Pooler链接自动清理功能使用，自动清理后各pooler链接池对应节点的链接数最小剩余量，当参数设置为0时，可以关闭pooler链接自动清理功能。 +**参数说明**: Pooler链接自动清理功能使用，自动清理后各pooler链接池对应节点的链接数最小剩余量，当参数设置为0时，可以关闭pooler链接自动清理功能。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此参数在该版本不生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此参数在该版本不生效。 该参数属于USERSET类型参数，请参考[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为1，最大值为65535 +**取值范围**: 整型，最小值为1，最大值为65535 -**默认值**：200 +**默认值**: 200 ## cache_connection -**参数说明**：是否回收连接池的连接。 +**参数说明**: 是否回收连接池的连接。 该参数属于SIGHUP类型参数，请参考表[GUC参数设置方式](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示回收连接池的连接。 - off表示不回收连接池的连接。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/2-file-location.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/2-file-location.md index bf895406..f4e3b504 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/2-file-location.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/2-file-location.md @@ -16,53 +16,53 @@ date: 2021-04-20 ## data_directory -**参数说明**：设置MogDB的数据目录（data目录）。此参数可以通过如下方式指定。 +**参数说明**: 设置MogDB的数据目录（data目录）。此参数可以通过如下方式指定。 - 在安装MogDB时指定。 - 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值**：安装时指定，如果在安装时不指定，则默认不初始化数据库。 +**默认值**: 安装时指定，如果在安装时不指定，则默认不初始化数据库。 ## config_file -**参数说明**：设置主服务器配置文件名称（postgresql.conf）。 +**参数说明**: 设置主服务器配置文件名称（postgresql.conf）。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置，不支持使用表[GUC参数设置方式](30-appendix)中的方式四进行修改。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值**：postgresql.conf（实际安装可能带有绝对目录） +**默认值**: postgresql.conf（实际安装可能带有绝对目录） ## hba_file -**参数说明**：设置基于主机认证（HBA）的配置文件（pg_hba.conf）。此参数只能在配置文件postgresql.conf中指定。 +**参数说明**: 设置基于主机认证（HBA）的配置文件（pg_hba.conf）。此参数只能在配置文件postgresql.conf中指定。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：pg_hba.conf（实际安装可能带有绝对目录） +**默认值**: pg_hba.conf（实际安装可能带有绝对目录） ## ident_file -**参数说明**：设置用于客户端认证的配置文件的名称（pg_ident.conf）。 +**参数说明**: 设置用于客户端认证的配置文件的名称（pg_ident.conf）。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：pg_ident.conf（实际安装可能带有绝对目录） +**默认值**: pg_ident.conf（实际安装可能带有绝对目录） ## external_pid_file -**参数说明**：声明可被服务器管理程序使用的额外PID文件。 +**参数说明**: 声明可被服务器管理程序使用的额外PID文件。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：这个参数只能在数据库服务重新启动后生效。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/20-MogDB-transaction.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/20-MogDB-transaction.md index 644bc574..69609bd3 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/20-MogDB-transaction.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/20-MogDB-transaction.md @@ -11,41 +11,41 @@ date: 2021-04-20 ## transaction_isolation -**参数说明**：设置当前事务的隔离级别。 +**参数说明**: 设置当前事务的隔离级别。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，只识别以下字符串，大小写空格敏感: +**取值范围**: 字符串，只识别以下字符串，大小写空格敏感: - serializable: MogDB中等价于REPEATABLE READ。 - read committed: 只能读取已提交的事务的数据（缺省），不能读取到未提交的数据。 - repeatable read: 仅能读取事务开始之前提交的数据，不能读取未提交的数据以及在事务执行期间由其它并发事务提交的修改。 - default: 设置为default_transaction_isolation所设隔离级别。 -**默认值**：read committed +**默认值**: read committed ## transaction_read_only -**参数说明**：设置当前事务是只读事务。 +**参数说明**: 设置当前事务是只读事务。 该参数在数据库恢复过程中或者在备机里，固定为on；否则，固定为default_transaction_read_only的值。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示设置当前事务为只读事务。 - off表示该事务可以是非只读事务。 -**默认值**：off +**默认值**: off ## xc_maintenance_mode -**参数说明**：设置系统进入维护模式。 +**参数说明**: 设置系统进入维护模式。 该参数属于SUSET类型参数，仅支持表[GUC参数分类](30-appendix)中的方式三进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 @@ -54,66 +54,66 @@ date: 2021-04-20 > > 谨慎打开这个开关，避免引起MogDB数据不一致。 -**默认值**：off +**默认值**: off ## allow_concurrent_tuple_update -**参数说明**：设置是否允许并发更新。 +**参数说明**: 设置是否允许并发更新。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示该功能启用。 - off表示该功能被禁用。 -**默认值**：on +**默认值**: on ## transaction_deferrable -**参数说明**：指定是否允许一个只读串行事务延迟执行，使其不会执行失败。该参数设置为on时，当一个只读事务发现读取的元组正在被其他事务修改，则延迟该只读事务直到其他事务修改完成。该参数为预留参数，该版本不生效。与该参数类似的还有一个default_transaction_deferrable，设置它来指定一个事务是否允许延迟。 +**参数说明**: 指定是否允许一个只读串行事务延迟执行，使其不会执行失败。该参数设置为on时，当一个只读事务发现读取的元组正在被其他事务修改，则延迟该只读事务直到其他事务修改完成。该参数为预留参数，该版本不生效。与该参数类似的还有一个default_transaction_deferrable，设置它来指定一个事务是否允许延迟。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许执行。 - off表示不允许执行。 -**默认值**：off +**默认值**: off ## enable_show_any_tuples -**参数说明**：该参数只有在只读事务中可用，用于分析。 +**参数说明**: 该参数只有在只读事务中可用，用于分析。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示表中元组的所有版本都会可见。 - off/false表示表中元组的所有版本都不可见。 -**默认值**：off +**默认值**: off ## replication_type -**参数说明**：标记当前HA模式是单主机模式、主备从模式还是一主多备模式。 +**参数说明**: 标记当前HA模式是单主机模式、主备从模式还是一主多备模式。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 该参数用户不能自己去设置参数值。 -**取值范围**：0~2 +**取值范围**: 0~2 - 2 表示单主机模式，此模式无法扩展备机。 - 1 表示使用一主多备模式，全场景覆盖，推荐使用。 - 0 表示主备从模式，目前此模式暂不支持。 -**默认值**：1 +**默认值**: 1 ## pgxc_node_name -**参数说明**：指定节点名称。 +**参数说明**: 指定节点名称。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -121,19 +121,19 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **注意：** 此参数修改后会导致连接数据库实例失败，不建议进行修改。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：当前节点名称 +**默认值**: 当前节点名称 ## enable_defer_calculate_snapshot -**参数说明**：延迟计算快照的xmin和oldestxmin，执行1000个事务或者间隔1s才触发计算，设置为on时可以在高负载场景下减少计算快照的开销，但是会导致oldestxmin推进较慢，影响垃圾元组回收，设置为off时xmin和oldestxmin可以实时推进，但是会增加计算快照时的开销。 +**参数说明**: 延迟计算快照的xmin和oldestxmin，执行1000个事务或者间隔1s才触发计算，设置为on时可以在高负载场景下减少计算快照的开销，但是会导致oldestxmin推进较慢，影响垃圾元组回收，设置为off时xmin和oldestxmin可以实时推进，但是会增加计算快照时的开销。 该参数属于SIGHUP类型参数，改请参考[GUC参数分类](30-appendix)进行设置 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示延迟计算快照xmin和oldestxmin。 - off表示实时计算快照xmin和oldestxmin。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/21-developer-options.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/21-developer-options.md index 7602efdd..01939c97 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/21-developer-options.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/21-developer-options.md @@ -9,26 +9,26 @@ date: 2021-04-20 ## allow_system_table_mods -**参数说明**：设置是否允许修改系统表的结构。 +**参数说明**: 设置是否允许修改系统表的结构。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许修改系统表的结构。 - off表示不允许修改系统表的结构。 -**默认值**：off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**注意**：不建议修改该参数默认值，如果设置为on，可能导致系统表损坏，甚至数据库无法启动。 ## debug_assertions -**参数说明**：控制打开各种断言检查。能够协助调试，当遇到奇怪的问题或者崩溃，请把此参数打开，因为它能暴露编程的错误。要使用这个参数，必须在编译MogDB的时候定义宏USE_ASSERT_CHECKING（通过configure选项--enable-cassert完成）。 +**参数说明**: 控制打开各种断言检查。能够协助调试，当遇到奇怪的问题或者崩溃，请把此参数打开，因为它能暴露编程的错误。要使用这个参数，必须在编译MogDB的时候定义宏USE_ASSERT_CHECKING（通过configure选项--enable-cassert完成）。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开断言检查。 - off表示不打开断言检查。 @@ -37,83 +37,83 @@ date: 2021-04-20 > > 当启用断言选项编译MogDB时，debug_assertions缺省值为on 。 -**默认值**：off +**默认值**: off ## ignore_checksum_failure -**参数说明**：设置读取数据时是否忽略校验信息检查失败（但仍然会告警），继续执行可能导致崩溃，传播或隐藏损坏数据，无法从远程节点恢复数据及其他严重问题。不建议用户修改设置。 +**参数说明**: 设置读取数据时是否忽略校验信息检查失败（但仍然会告警），继续执行可能导致崩溃，传播或隐藏损坏数据，无法从远程节点恢复数据及其他严重问题。不建议用户修改设置。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示忽略数据校验错误。 - off表示数据校验错误正常报错。 -**默认值**：off +**默认值**: off ## ignore_system_indexes -**参数说明**：读取系统表时忽略系统索引（但是修改系统表时依然同时修改索引）。 +**参数说明**: 读取系统表时忽略系统索引（但是修改系统表时依然同时修改索引）。 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：这个参数在从系统索引被破坏的表中恢复数据的时候非常有用。 > -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示忽略系统索引。 - off表示不忽略系统索引。 -**默认值**：off +**默认值**: off ## post_auth_delay -**参数说明**：在认证成功后，延迟指定时间，启动服务器连接。允许调试器附加到启动进程上。 +**参数说明**: 在认证成功后，延迟指定时间，启动服务器连接。允许调试器附加到启动进程上。 该参数属于BACKEND类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为2147，单位为秒。 +**取值范围**: 整型，最小值为0，最大值为2147，单位为秒。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此参数只用于调试和问题定位，为避免影响正常业务运行，生产环境下请确保参数值为默认值0。参数设置为非0时可能会因认证延迟时间过长导致数据库实例状态异常。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此参数只用于调试和问题定位，为避免影响正常业务运行，生产环境下请确保参数值为默认值0。参数设置为非0时可能会因认证延迟时间过长导致数据库实例状态异常。 ## pre_auth_delay -**参数说明**：启动服务器连接后，延迟指定时间，进行认证。允许调试器附加到认证过程上。 +**参数说明**: 启动服务器连接后，延迟指定时间，进行认证。允许调试器附加到认证过程上。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0～60，单位为秒。 +**取值范围**: 整型，最小值为0～60，单位为秒。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此参数只用于调试和问题定位，为避免影响正常业务运行，生产环境下请确保参数值为默认值0。参数设置为非0时可能会因认证延迟时间过长导致数据库实例状态异常。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此参数只用于调试和问题定位，为避免影响正常业务运行，生产环境下请确保参数值为默认值0。参数设置为非0时可能会因认证延迟时间过长导致数据库实例状态异常。 ## trace_notify -**参数说明**：为LISTEN和NOTIFY命令生成大量调试输出。client_min_messages或log_min_messages级别必须是DEBUG1或者更低时，才能把这些输出分别发送到客户端或者服务器日志。 +**参数说明**: 为LISTEN和NOTIFY命令生成大量调试输出。client_min_messages或log_min_messages级别必须是DEBUG1或者更低时，才能把这些输出分别发送到客户端或者服务器日志。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开输出功能。 - off表示关闭输出功能。 -**默认值**：off +**默认值**: off ## trace_recovery_messages -**参数说明**：启用恢复相关调试输出的日志录，否则将不会被记录。该参数允许覆盖正常设置的log_min_messages，但是仅限于特定的消息，这是为了在调试备机中使用。 +**参数说明**: 启用恢复相关调试输出的日志录，否则将不会被记录。该参数允许覆盖正常设置的log_min_messages，但是仅限于特定的消息，这是为了在调试备机中使用。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见[log_min_messages](2-logging-time#log_min_messages)。 +**取值范围**: 枚举类型，有效值有debug5、debug4、debug3、debug2、debug1、log，取值的详细信息请参见[log_min_messages](2-logging-time#log_min_messages)。 -**默认值**：log +**默认值**: log > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > @@ -122,197 +122,197 @@ date: 2021-04-20 ## trace_sort -**参数说明**：控制是否在日志中打印排序操作中的资源使用相关信息。这个选项只有在编译MogDB的时候定义了TRACE_SORT宏的时候才可用，不过目前TRACE_SORT是由缺省定义的。 +**参数说明**: 控制是否在日志中打印排序操作中的资源使用相关信息。这个选项只有在编译MogDB的时候定义了TRACE_SORT宏的时候才可用，不过目前TRACE_SORT是由缺省定义的。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开控制功能。 - off表示关闭控制功能。 -**默认值**：off +**默认值**: off ## zero_damaged_pages -**参数说明**：控制检测导致MogDB报告错误的损坏的页头，终止当前事务。 +**参数说明**: 控制检测导致MogDB报告错误的损坏的页头，终止当前事务。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 设置为on时，会导致系统报告一个警告，把损坏的页面填充为零然后继续处理。这种行为会破坏数据，也就是所有在已经损坏页面上的行记录。但是它允许绕开坏页面然后从表中尚存的未损坏页面上继续检索数据行。因此它在因为硬件或者软件错误导致的崩溃中进行恢复是很有用的。通常不应该把它设置为on，除非不需要从崩溃的页面中恢复数据。 -**默认值**：off +**默认值**: off ## remotetype -**参数说明**：设置远程连接类型。 +**参数说明**: 设置远程连接类型。 该参数不支持修改。 -**取值范围**：枚举类型，有效值有application、datanode、internaltool。 +**取值范围**: 枚举类型，有效值有application、datanode、internaltool。 -**默认值**：application +**默认值**: application ## max_user_defined_exception -**参数说明**：异常最大个数，默认值不可更改。 +**参数说明**: 异常最大个数，默认值不可更改。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，当前只能取固定值1000 +**取值范围**: 整型，当前只能取固定值1000 -**默认值**：1000 +**默认值**: 1000 ## enable_fast_numeric -**参数说明**：标识是否开启Numeric类型数据运算优化。Numeric数据运算是较为耗时的操作之一，通过将Numeric转化为int64/int128类型，提高Numeric运算的性能。 +**参数说明**: 标识是否开启Numeric类型数据运算优化。Numeric数据运算是较为耗时的操作之一，通过将Numeric转化为int64/int128类型，提高Numeric运算的性能。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启Numeric优化。 - off/false表示关闭Numeric优化。 -**默认值**：on +**默认值**: on ## enable_compress_spill -**参数说明**：标识是否开启下盘压缩功能。 +**参数说明**: 标识是否开启下盘压缩功能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启下盘优化。 - off/false表示关闭下盘优化。 -**默认值**：on +**默认值**: on ## resource_track_log -**参数说明**：控制自诊断的日志级别。目前仅对多列统计信息进行控制。 +**参数说明**: 控制自诊断的日志级别。目前仅对多列统计信息进行控制。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - summary：显示简略的诊断信息。 - detail：显示详细的诊断信息。 目前这两个参数值只在显示多列统计信息未收集的告警的情况下有差别，summary不显示未收集多列统计信息的告警，detail会显示这类告警。 -**默认值**：summary +**默认值**: summary ## show_acce_estimate_detail -**参数说明**：评估信息一般用于运维人员在维护工作中使用，因此该参数默认关闭，此外为了避免这些信息干扰正常的explain信息显示，只有在explain命令的verbose选项打开的情况下才显示评估信息 +**参数说明**: 评估信息一般用于运维人员在维护工作中使用，因此该参数默认关闭，此外为了避免这些信息干扰正常的explain信息显示，只有在explain命令的verbose选项打开的情况下才显示评估信息 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以在explain命令的输出中显示评估信息。 - off表示不在explain命令的输出中显示评估信息。 -**默认值**：off +**默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前版本不支持加速数据库实例，因此该参数设置后不生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前版本不支持加速数据库实例，因此该参数设置后不生效。 ## support_batch_bind -**参数说明**：控制是否允许通过JDBC、ODBC、Libpq等接口批量绑定和执行PBE形式的语句。 +**参数说明**: 控制是否允许通过JDBC、ODBC、Libpq等接口批量绑定和执行PBE形式的语句。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用批量绑定和执行。 - off表示不使用批量绑定和执行。 -**默认值**：on +**默认值**: on ## numa_distribute_mode -**参数说明**：用于控制部分共享数据和线程在NUMA节点间分布的属性。用于大型多NUMA节点的ARM服务器性能调优，一般不用设置。 +**参数说明**: 用于控制部分共享数据和线程在NUMA节点间分布的属性。用于大型多NUMA节点的ARM服务器性能调优，一般不用设置。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，当前有效取值为'none', 'all'。 +**取值范围**: 字符串，当前有效取值为'none', 'all'。 - none：表示不启用本特性。 - all：表示将部分共享数据和线程分布到不同的NUMA节点下，减少远端访存次数，提高性能。目前仅适用于拥有多个NUMA节点的ARM服务器，并且要求全部NUMA节点都可用于数据库进程，不支持仅选择一部分NUMA节点。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前版本x86平台下不支持numa_distribute_mode设置为all。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前版本x86平台下不支持numa_distribute_mode设置为all。 -**默认值**：'none' +**默认值**: 'none' ## log_pagewriter -**参数说明**：设置用于增量检查点打开后，显示线程的刷页信息以及增量检查点的详细信息，信息比较多，不建议设置为true。 +**参数说明**: 设置用于增量检查点打开后，显示线程的刷页信息以及增量检查点的详细信息，信息比较多，不建议设置为true。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：on +**默认值**: on ## advance_xlog_file_num -**参数说明**：用于控制在后台周期性地提前初始化xlog文件的数目。该参数是为了避免事务提交时执行xlog文件初始化影响性能，但仅在超重负载时才可能出现，因此一般不用配置。 +**参数说明**: 用于控制在后台周期性地提前初始化xlog文件的数目。该参数是为了避免事务提交时执行xlog文件初始化影响性能，但仅在超重负载时才可能出现，因此一般不用配置。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1000000（0表示不提前初始化）。例如，取值10，表示后台线程会周期性地根据当前xlog写入位置提前初始化10个xlog文件。 +**取值范围**: 整型，0~1000000（0表示不提前初始化）。例如，取值10，表示后台线程会周期性地根据当前xlog写入位置提前初始化10个xlog文件。 -**默认值**：0 +**默认值**: 0 ## enable_beta_opfusion -**参数说明**：在enable_opfusion参数打开的状态下，如果开启该参数，可以支持TPCC中出现的聚集函数，排序两类SQL语句的加速执行，提升SQL执行性能。 +**参数说明**: 在enable_opfusion参数打开的状态下，如果开启该参数，可以支持TPCC中出现的聚集函数，排序两类SQL语句的加速执行，提升SQL执行性能。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on表示开启。 - off表示不开启。 -**默认值**：off +**默认值**: off ## string_hash_compatible -**参数说明**：该参数用来说明char类型和varchar/text类型的hash值计算方式是否相同，以此来判断进行分布列从char类型到相同值的varchar/text类型转换，数据分布变化时，是否需要进行重分布。 +**参数说明**: 该参数用来说明char类型和varchar/text类型的hash值计算方式是否相同，以此来判断进行分布列从char类型到相同值的varchar/text类型转换，数据分布变化时，是否需要进行重分布。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示计算方式相同，不需要进行重分布。 - off表示计算方式不同，需要进行重分布。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 计算方式的不同主要体现在字符串计算hash值时传入的字节长度上。（如果为char，则会忽略字符串后面空格的长度，如果为text或varchar，则会保留字符串后面空格的长度。）hash值的计算会影响到查询的计算结果，因此此参数一旦设置后，在整个数据库使用过程中不能再对其进行修改，以避免查询错误。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 计算方式的不同主要体现在字符串计算hash值时传入的字节长度上。（如果为char，则会忽略字符串后面空格的长度，如果为text或varchar，则会保留字符串后面空格的长度。）hash值的计算会影响到查询的计算结果，因此此参数一旦设置后，在整个数据库使用过程中不能再对其进行修改，以避免查询错误。 -**默认值**：off +**默认值**: off ## pldebugger_timeout -**参数说明**：该参数用来控制pldebugger server端等待debug端响应的超时时间。 +**参数说明**: 该参数用来控制pldebugger server端等待debug端响应的超时时间。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1 ~ 86400，单位为秒。 +**取值范围**: 整型，1 ~ 86400，单位为秒。 -**默认值**：15min +**默认值**: 15min ## plsql_show_all_error -**参数说明**：该参数用来控制编译PLPGSQL对象时是否支持跳过报错继续编译，具体影响请参考[DBE_PLDEVELOPER](overview-of-DBE_PLDEVELOPER)内的说明。 +**参数说明**: 该参数用来控制编译PLPGSQL对象时是否支持跳过报错继续编译，具体影响请参考[DBE_PLDEVELOPER](overview-of-DBE_PLDEVELOPER)内的说明。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md index 5438742d..11857119 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/1-audit-switch.md @@ -9,117 +9,117 @@ date: 2021-04-20 ## audit_enabled -**参数说明**：控制审计进程的开启和关闭。审计进程开启后，将从管道读取后台进程写入的审计信息，并写入审计文件。 +**参数说明**: 控制审计进程的开启和关闭。审计进程开启后，将从管道读取后台进程写入的审计信息，并写入审计文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启动审计功能。 - off表示关闭审计功能。 -**默认值**：on +**默认值**: on ## audit_directory -**参数说明**：审计文件的存储目录。一个相对于数据目录data的路径，可自行指定。 +**参数说明**: 审计文件的存储目录。一个相对于数据目录data的路径，可自行指定。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 +**默认值**: pg_audit。如果使用om工具部署MogDB，则审计日志路径为"$GAUSSLOG/pg_audit/实例名称"。 ## audit_data_format -**参数说明**：审计日志文件的格式。当前仅支持二进制格式。 +**参数说明**: 审计日志文件的格式。当前仅支持二进制格式。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：binary +**默认值**: binary ## audit_rotation_interval -**参数说明**：指定创建一个新审计日志文件的时间间隔。当现在的时间减去上次创建一个审计日志的时间超过了此参数值时，服务器将生成一个新的审计日志文件。 +**参数说明**: 指定创建一个新审计日志文件的时间间隔。当现在的时间减去上次创建一个审计日志的时间超过了此参数值时，服务器将生成一个新的审计日志文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~INT_MAX/60，单位为min。 +**取值范围**: 整型，1~INT_MAX/60，单位为min。 -**默认值**：1d +**默认值**: 1d > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 请不要随意调整此参数，否侧可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用[audit_resource_policy](#audit_resource_policy)、[audit_space_limit](#audit_space_limit)和[audit_file_remain_time](#audit_file_remain_time)参数进行控制。 ## audit_rotation_size -**参数说明**：指定审计日志文件的最大容量。当审计日志消息的总量超过此参数值时，服务器将生成一个新的审计日志文件。 +**参数说明**: 指定审计日志文件的最大容量。当审计日志消息的总量超过此参数值时，服务器将生成一个新的审计日志文件。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024~1048576，单位为KB。 +**取值范围**: 整型，1024~1048576，单位为KB。 -**默认值**：10MB +**默认值**: 10MB > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 请不要随意调整此参数，否侧可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 ## audit_resource_policy -**参数说明**：控制审计日志的保存策略，以空间还是时间限制为优先策略。 +**参数说明**: 控制审计日志的保存策略，以空间还是时间限制为优先策略。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示采用空间优先策略，最多存储[audit_space_limit](#audit_space_limit)大小的日志。 - off表示采用时间优先策略，最少存储[audit_file_remain_time](#audit_file_remain_time)长度时间的日志。 -**默认值**：on +**默认值**: on ## audit_file_remain_time -**参数说明**：表示需记录审计日志的最短时间要求，该参数在[audit_resource_policy](#audit_resource_policy)为off时生效。 +**参数说明**: 表示需记录审计日志的最短时间要求，该参数在[audit_resource_policy](#audit_resource_policy)为off时生效。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~730，单位为day，0表示无时间限制。 +**取值范围**: 整型，0~730，单位为day，0表示无时间限制。 -**默认值**：90 +**默认值**: 90 ## audit_space_limit -**参数说明**：审计文件占用的磁盘空间总量。 +**参数说明**: 审计文件占用的磁盘空间总量。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024KB~1024GB，单位为KB。 +**取值范围**: 整型，1024KB~1024GB，单位为KB。 -**默认值**：1GB +**默认值**: 1GB ## audit_file_remain_threshold -**参数说明**：审计目录下审计文件个数的最大值。 +**参数说明**: 审计目录下审计文件个数的最大值。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~1048576 +**取值范围**: 整型，1~1048576 -**默认值**：1048576 +**默认值**: 1048576 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 请尽量保证此参数为1048576，并不要随意调整此参数，否则可能会导致audit_resource_policy无法生效，如果需要控制审计日志的存储空间和时间，请使用audit_resource_policy、audit_space_limit和audit_file_remain_time参数进行控制。 ## audit_thread_num -**参数说明**：审计线程的个数。 +**参数说明**: 审计线程的个数。 该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~48 +**取值范围**: 整型，1~48 -**默认值**：1 +**默认值**: 1 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当audit_dml_state开关打开且在高性能场景下，建议增大此参数保证审计消息可以被及时处理和记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当audit_dml_state开关打开且在高性能场景下，建议增大此参数保证审计消息可以被及时处理和记录。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md index 932cfbd9..e7811eaf 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/2-user-and-permission-audit.md @@ -9,11 +9,11 @@ date: 2021-04-20 ## audit_login_logout -**参数说明**：这个参数决定是否审计MogDB用户的登录（包括登录成功和登录失败）、注销。 +**参数说明**: 这个参数决定是否审计MogDB用户的登录（包括登录成功和登录失败）、注销。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~7。 +**取值范围**: 整型，0~7。 - 0表示关闭用户登录、注销审计功能。 - 1表示只审计用户登录成功。 @@ -24,60 +24,60 @@ date: 2021-04-20 - 6表示只审计用户注销和登录失败。 - 7表示审计用户登录成功、失败和注销。 -**默认值**：7 +**默认值**: 7 ## audit_database_process -**参数说明**：该参数决定是否对MogDB的启动、停止、切换和恢复进行审计。 +**参数说明**: 该参数决定是否对MogDB的启动、停止、切换和恢复进行审计。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭MogDB启动、停止、恢复和切换审计功能。 - 1表示开启MogDB启动、停止、恢复和切换审计功能。 -**默认值**：1 +**默认值**: 1 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > MogDB启动时DN执行备升主流程，因此DN启动时审计日志中类型为system_switch。 ## audit_user_locked -**参数说明**：该参数决定是否审计MogDB用户的锁定和解锁。 +**参数说明**: 该参数决定是否审计MogDB用户的锁定和解锁。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户锁定和解锁审计功能。 - 1表示开启审计用户锁定和解锁功能。 -**默认值**：1 +**默认值**: 1 ## audit_user_violation -**参数说明**：该参数决定是否审计用户的越权访问操作。 +**参数说明**: 该参数决定是否审计用户的越权访问操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭用户越权操作审计功能。 - 1表示开启用户越权操作审计功能。 -**默认值**：0 +**默认值**: 0 ## audit_grant_revoke -**参数说明**：该参数决定是否审计MogDB用户权限授予和回收的操作。 +**参数说明**: 该参数决定是否审计MogDB用户权限授予和回收的操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计用户权限授予和回收功能。 - 1表示开启审计用户权限授予和回收功能。 -**默认值**：1 +**默认值**: 1 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md index c066413d..699df0a5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/22-auditing/3-operation-audit.md @@ -9,11 +9,11 @@ date: 2021-04-20 ## audit_system_object -**参数说明**：该参数决定是否对MogDB数据库对象的CREATE、DROP、ALTER操作进行审计。MogDB数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值，可以只审计需要的数据库对象的操作。 +**参数说明**: 该参数决定是否对MogDB数据库对象的CREATE、DROP、ALTER操作进行审计。MogDB数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值，可以只审计需要的数据库对象的操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～67108863 +**取值范围**: 整型，0～67108863 - 0代表关闭MogDB数据库对象的CREATE、DROP、ALTER操作审计功能。 - 非0代表只审计MogDB的某类或者某些数据库对象的CREATE、DROP、ALTER操作。 @@ -22,7 +22,7 @@ date: 2021-04-20 该参数的值由26个二进制位的组合求出，这26个二进制位分别代表MogDB的26类数据库对象。如果对应的二进制位取值为0，表示不审计对应的数据库对象的CREATE、DROP、ALTER操作；取值为1，表示审计对应的数据库对象的CREATE、DROP、ALTER操作。这26个二进制位代表的具体审计内容请参见[表1](#audit_system_object)。 -**默认值**：12295 +**默认值**: 12295 **表 1** audit_system_object取值含义说明 @@ -57,29 +57,29 @@ date: 2021-04-20 ## audit_dml_state -**参数说明**：这个参数决定是否对具体表的INSERT、UPDATE、DELETE操作进行审计。 +**参数说明**: 这个参数决定是否对具体表的INSERT、UPDATE、DELETE操作进行审计。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭具体表的DML操作（SELECT除外）审计功能。 - 1表示开启具体表的DML操作（SELECT除外）审计功能。 -**默认值**：0 +**默认值**: 0 ## audit_dml_state_select -**参数说明**：这个参数决定是否对SELECT操作进行审计。 +**参数说明**: 这个参数决定是否对SELECT操作进行审计。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SELECT操作审计功能。 - 1表示开启SELECT审计操作功能。 -**默认值**：0 +**默认值**: 0 ## audit_function_exec @@ -87,53 +87,53 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭过程或函数执行的审计功能。 - 1表示开启过程或函数执行的审计功能。 -**默认值**：0 +**默认值**: 0 ## audit_copy_exec -**参数说明**：这个参数决定是否对COPY操作进行审计。 +**参数说明**: 这个参数决定是否对COPY操作进行审计。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭COPY审计功能。 - 1表示开启COPY审计功能。 -**默认值**：1 +**默认值**: 1 ## audit_set_parameter -**参数说明**：这个参数决定是否对SET操作进行审计。 +**参数说明**: 这个参数决定是否对SET操作进行审计。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭SET审计功能。 - 1表示开启SET审计功能。 -**默认值**：1 +**默认值**: 1 ## audit_xid_info -**参数说明**：这个参数决定是否在审计日志字段detail_info中记录SQL语句的事务ID。 +**参数说明**: 这个参数决定是否在审计日志字段detail_info中记录SQL语句的事务ID。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0、1。 +**取值范围**: 整型，0、1。 - 0表示关闭审计日志记录事务ID功能。 - 1表示开启审计日志记录事务ID功能。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果开启此开关，审计日志中detail_info信息则以xid开始，例如： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果开启此开关，审计日志中detail_info信息则以xid开始，例如： > > ``` > detail_info: xid=14619 , create table t1(id int); @@ -143,44 +143,44 @@ date: 2021-04-20 ## enableSeparationOfDuty -**参数说明**：是否开启三权分立选项。 +**参数说明**: 是否开启三权分立选项。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启三权分立。 - off表示不开启三权分立。 -**默认值**：off +**默认值**: off ## enable_nonsysadmin_execute_direct -**参数说明**：是否允许非系统管理员执行EXECUTE DIRECT ON语句。 +**参数说明**: 是否允许非系统管理员执行EXECUTE DIRECT ON语句。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许任意用户执行EXECUTE DIRECT ON语句。 - off表示只允许系统管理员执行EXECUTE DIRECT ON语句。 -**默认值**：off +**默认值**: off ## enable_access_server_directory -**参数说明**：是否开启非初始用户创建、修改和删除DIRECTORY的权限。 +**参数说明**: 是否开启非初始用户创建、修改和删除DIRECTORY的权限。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启非初始用户创建、修改和删除DIRECTORY的权限。 - off表示不开启非初始用户创建、修改和删除DIRECTORY的权限。 -**默认值**：off +**默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 出于安全考虑，默认情况下，只有初始用户才能够创建、修改和删除DIRECTORY对象。 > diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/23-upgrade-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/23-upgrade-parameters.md index f1a8caa4..3a4d1197 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/23-upgrade-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/23-upgrade-parameters.md @@ -9,39 +9,39 @@ date: 2021-04-20 ## IsInplaceUpgrade -**参数说明**：标示是否在升级的过程中。该参数用户无法修改。 +**参数说明**: 标示是否在升级的过程中。该参数用户无法修改。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在升级过程中。 - off表示不在升级过程中。 -**默认值**：off +**默认值**: off ## inplace_upgrade_next_system_object_oids -**参数说明**：标示就地升级过程中，新增系统对象的OID。该参数用户无法修改。 +**参数说明**: 标示就地升级过程中，新增系统对象的OID。该参数用户无法修改。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## upgrade_mode -**参数说明**：标示升级模式。 +**参数说明**: 标示升级模式。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整数，0~INT_MAX +**取值范围**: 整数，0~INT_MAX - 0表示不在升级过程中。 - 1表示在就地升级过程中。 - 2表示在灰度升级过程中。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 特殊情况：在使用灰度升级的情况下，若选择策略为大版本升级，即需要执行升级脚本和替换二进制包，会将upgrade_mode设置为2，选择策略为小版本升级，只替换二进制包，则不会设置upgrade_mode设置为2。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 特殊情况：在使用灰度升级的情况下，若选择策略为大版本升级，即需要执行升级脚本和替换二进制包，会将upgrade_mode设置为2，选择策略为小版本升级，只替换二进制包，则不会设置upgrade_mode设置为2。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md index e10a09cc..503bbb20 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/24-miscellaneous-parameters.md @@ -9,198 +9,198 @@ date: 2021-04-20 ## enable_default_ustore_table -**参数说明**：指定是否开启默认支持Ustore存储引擎。该参数为on时，创建的表类型都为Ustore表。 +**参数说明**: 指定是否开启默认支持Ustore存储引擎。该参数为on时，创建的表类型都为Ustore表。 该参数属于USERSET类型，请参考表[GUC参数分类](30-appendix)对应设置方法进行设置。 -**取值范围**：[off,on] +**取值范围**: [off,on] -**默认值**：off +**默认值**: off ## reserve_space_for_nullable_atts -**参数说明**：指定是否为Ustore表的可空属性预留空间。该参数为on时默认为Ustore表的可空属性预留空间。 +**参数说明**: 指定是否为Ustore表的可空属性预留空间。该参数为on时默认为Ustore表的可空属性预留空间。 该参数属于USERSET类型，请参考表[GUC参数分类](30-appendix)对应设置方法进行设置。 -**取值范围**：[off,on] +**取值范围**: [off,on] -**默认值**：off +**默认值**: off ## ustore_attr -**参数说明**：Ustore测试参数。 +**参数说明**: Ustore测试参数。 该参数属于USERSET类型，可以设置包括enable_ustore_partial_seqscan（仅在ustore表中顺序扫描时复制选择性列）、enable_candidate_buf_usage_count（是否脏页淘汰加入使用次数权重）、ustats_tracker_naptime（重新加载统计文件所用的时间）、umax_search_length_for_prune（扩展表前要修剪的块数）、ustore_unit_test（开启Ustore白盒测试）。设置方法为 ustore_attr='需要设置的参数'，例如需要设置enable_ustore_partial_seqscan时，ustore_attr='enable_ustore_partial_seqscan=on'。 -**取值范围**：字符串 +**取值范围**: 字符串 ## server_version -**参数说明**：报告服务器版本号（字符串形式）。 +**参数说明**: 报告服务器版本号（字符串形式）。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version版本，无实际含义，为保持北向对外工具接口的生态兼容性（工具连接时查询），保留该参数。该参数不推荐使用，如想查询服务器版本号，可通过函数opengauss_version()获取。 -**取值范围**： 字符串 +**取值范围**: 字符串 -**默认值**： 9.2.4 +**默认值**: 9.2.4 ## server_version_num -**参数说明**：报告服务器版本号（整数形式）。 +**参数说明**: 报告服务器版本号（整数形式）。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version_num版本，无实际含义，为保持北向对外工具接口的生态兼容性（工具连接时查询），保留该参数。 -**取值范围**：整数 +**取值范围**: 整数 -**默认值**：90204 +**默认值**: 90204 ## block_size -**参数说明**：报告当前数据库所使用的块大小。 +**参数说明**: 报告当前数据库所使用的块大小。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：8192 +**取值范围**: 8192 -**默认值**：8192 +**默认值**: 8192 ## segment_size -**参数说明**：报告当前数据库所使用的段文件大小。 +**参数说明**: 报告当前数据库所使用的段文件大小。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 **单位**: 8KB -**默认值**：131072，即1GB +**默认值**: 131072，即1GB ## max_index_keys -**参数说明**：报告当前数据库能够支持的索引键值的最大数目。 +**参数说明**: 报告当前数据库能够支持的索引键值的最大数目。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值**：32 +**默认值**: 32 ## integer_datetimes -**参数说明**：报告是否支持64位整数形式的日期和时间格式。 +**参数说明**: 报告是否支持64位整数形式的日期和时间格式。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持。 - off表示不支持。 -**默认值**：on +**默认值**: on ## lc_collate -**参数说明**：报告当前数据库的字符串排序区域设置。 +**参数说明**: 报告当前数据库的字符串排序区域设置。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值**：依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## lc_ctype -**参数说明**：报告当前数据库的字母类别区域设置。如：哪些字符属于字母，它对应的大写形式是什么。 +**参数说明**: 报告当前数据库的字母类别区域设置。如：哪些字符属于字母，它对应的大写形式是什么。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值**：依赖于MogDB安装部署时的配置 +**默认值**: 依赖于MogDB安装部署时的配置 ## max_identifier_length -**参数说明**：报告当前系统允许的标识符最大长度。 +**参数说明**: 报告当前系统允许的标识符最大长度。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型 +**取值范围**: 整型 -**默认值**：63 +**默认值**: 63 ## server_encoding -**参数说明**：报告当前数据库的服务端编码字符集。 +**参数说明**: 报告当前数据库的服务端编码字符集。 默认情况下，gs_initdb会根据当前的系统环境初始化此参数，通过locale命令可以查看当前的配置环境。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**默认值**：在创建数据库的时候由当前系统环境决定的。 +**默认值**: 在创建数据库的时候由当前系统环境决定的。 ## enable_upgrade_merge_lock_mode -**参数说明**：当该参数设置为on时，通过提升deltamerge内部实现的锁级别，避免和update/delete并发操作时的报错。 +**参数说明**: 当该参数设置为on时，通过提升deltamerge内部实现的锁级别，避免和update/delete并发操作时的报错。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 布尔型 +**取值范围**: 布尔型 - on：表示提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 - off：表示在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。 -**默认值**：off +**默认值**: off ## transparent_encrypted_string -**参数说明**：它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。 +**参数说明**: 它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串"TRANS_ENCRYPT_SAMPLE_STRING"后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么数据库节点将拒绝启动。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。该参数当前版本只适用于DWS场景。 -**取值范围**：字符串，设置为空表示MogDB非加密。 +**取值范围**: 字符串，设置为空表示MogDB非加密。 -**默认值**：空 +**默认值**: 空 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：请勿手动设置该参数，设置不当将导致MogDB不可用。 ## transparent_encrypt_kms_url -**参数说明**：它存储的是透明加密的数据库密钥获取地址，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。格式为"kms://协议@KMS主机名1;KMS主机名2:KMS端口号/kms"，例如 kms://https@linux175:29800/。该参数当前版本只适用于DWS场景。 +**参数说明**: 它存储的是透明加密的数据库密钥获取地址，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。格式为"kms://协议@KMS主机名1;KMS主机名2:KMS端口号/kms"，例如 kms://https@linux175:29800/。该参数当前版本只适用于DWS场景。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## transparent_encrypt_kms_region -**参数说明**：它存储的是MogDB的部署区域，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。该参数当前版本只适用于DWS场景。 +**参数说明**: 它存储的是MogDB的部署区域，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。该参数当前版本只适用于DWS场景。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## basebackup_timeout -**参数说明**：备份传输完成后连接无读写的超时时间。 通过gs_basebackup工具作传输时，如果指定较高压缩率时，可能在传输表空间完成后超时（客户端需要压缩传输数据）。 +**参数说明**: 备份传输完成后连接无读写的超时时间。 通过gs_basebackup工具作传输时，如果指定较高压缩率时，可能在传输表空间完成后超时（客户端需要压缩传输数据）。 -**取值范围**：整型，0 ~ INT_MAX，单位为秒。其中0表示禁用该功能。 +**取值范围**: 整型，0 ~ INT_MAX，单位为秒。其中0表示禁用该功能。 -**默认值**： 600s +**默认值**: 600s ## datanode_heartbeat_interval -**参数说明**：设置心跳线程间心跳消息发送时间间隔，建议值不超过wal_receiver_timeout / 2。 +**参数说明**: 设置心跳线程间心跳消息发送时间间隔，建议值不超过wal_receiver_timeout / 2。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1000～60000，单位为毫秒。 +**取值范围**: 整型，1000～60000，单位为毫秒。 -**默认值**：1s +**默认值**: 1s ## max_concurrent_autonomous_transactions -**参数说明**：自治事务最大链接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 +**参数说明**: 自治事务最大链接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0-1024 +**取值范围**: 0-1024 -**默认值**：10 +**默认值**: 10 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/25-wait-events.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/25-wait-events.md index 3c95bd76..a0dd1e48 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/25-wait-events.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/25-wait-events.md @@ -9,15 +9,15 @@ date: 2021-04-20 ## enable_instr_track_wait -**参数说明**：是否开启等待事件信息实时收集功能。 +**参数说明**: 是否开启等待事件信息实时收集功能。 在x86平台集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约1.4%。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：表示打开等待事件信息收集功能。 - off：表示关闭等待事件信息收集功能。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/26-query.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/26-query.md index 2591a877..2069d596 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/26-query.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/26-query.md @@ -9,7 +9,7 @@ date: 2021-04-20 ## instr_unique_sql_count -**参数说明**：控制系统中unique sql信息实时收集功能。配置为0表示不启用unique sql信息收集功能。 +**参数说明**: 控制系统中unique sql信息实时收集功能。配置为0表示不启用unique sql信息收集功能。 该值由大变小将会清空系统中原有的数据重新统计；从小变大不受影响。 @@ -19,9 +19,9 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：100 +**默认值**: 100 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** > @@ -31,106 +31,106 @@ date: 2021-04-20 ## instr_unique_sql_track_type -**参数说明**：unique sql记录SQL方式。 +**参数说明**: unique sql记录SQL方式。 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 top：只记录顶层SQL。 -**默认值**：top +**默认值**: top ## enable_instr_rt_percentile -**参数说明**：是否开启计算系统中80%和95%的SQL响应时间的功能。 +**参数说明**: 是否开启计算系统中80%和95%的SQL响应时间的功能。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：表示打开SQL响应时间信息计算功能。 - off：表示关闭SQL响应时间信息计算功能。 -**默认值**：on +**默认值**: on ## percentile -**参数说明**：SQL响应时间百分比信息，后台计算线程根据设置的值计算相应的百分比信息。 +**参数说明**: SQL响应时间百分比信息，后台计算线程根据设置的值计算相应的百分比信息。 该参数属于INTERNAL类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：80,95 +**默认值**: 80,95 ## instr_rt_percentile_interval -**参数说明**：SQL响应时间信息计算间隔，SQL响应时间信息计算功能打开后，后台计算线程每隔设置的时间进行一次计算。 +**参数说明**: SQL响应时间信息计算间隔，SQL响应时间信息计算功能打开后，后台计算线程每隔设置的时间进行一次计算。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～3600，单位为秒。 +**取值范围**: 整型，0～3600，单位为秒。 -**默认值**：10s +**默认值**: 10s ## enable_instr_cpu_timer -**参数说明**：是否捕获SQL执行的cpu时间消耗 。 +**参数说明**: 是否捕获SQL执行的cpu时间消耗 。 在x86平台集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约3.5%。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：表示捕获SQL执行的cpu时间消耗。 - off：表示不捕获SQL执行的cpu时间消耗。 -**默认值**：on +**默认值**: on ## enable_stmt_track -**参数说明**：控制是否启用Full /Slow SQL特性。 +**参数说明**: 控制是否启用Full /Slow SQL特性。 在x86平台集中式部署下，硬件配置规格为32核CPU/256GB内存，使用Benchmark SQL 5.0工具测试性能，开关此参数性能影响约1.2%。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：表示开启Full /Slow SQL捕获。 - off：表示关闭Full /Slow SQL捕获。 -**默认值**：on +**默认值**: on ## track_stmt_session_slot -**参数说明**：设置一个session缓存的最大的全量/慢SQL的数量，超过这个数量，新的语句执行将不会被跟踪，直到落盘线程将缓存语句落盘，留出空闲的空间。 +**参数说明**: 设置一个session缓存的最大的全量/慢SQL的数量，超过这个数量，新的语句执行将不会被跟踪，直到落盘线程将缓存语句落盘，留出空闲的空间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 2147483647 +**取值范围**: 整型，0 ~ 2147483647 -**默认值**：1000 +**默认值**: 1000 ## track_stmt_details_size -**参数说明**：设置单语句可以收集的最大的执行事件的大小（byte）。 +**参数说明**: 设置单语句可以收集的最大的执行事件的大小（byte）。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 100000000 +**取值范围**: 整型，0 ~ 100000000 -**默认值**：4096 +**默认值**: 4096 ## track_stmt_retention_time -**参数说明**：组合参数，控制全量/慢SQL记录的保留时间。以60秒为周期读取该参数，并执行清理超过保留时间的记录，仅sysadmin用户可以访问。 +**参数说明**: 组合参数，控制全量/慢SQL记录的保留时间。以60秒为周期读取该参数，并执行清理超过保留时间的记录，仅sysadmin用户可以访问。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符型 +**取值范围**: 字符型 该参数分为两部分，形式为'full sql retention time, slow sql retention time' @@ -138,15 +138,15 @@ full sql retention time为全量SQL保留时间，取值范围为0 ~ 86400 slow sql retention time为慢SQL的保留时间，取值范围为0 ~ 604800 -**默认值**：3600,604800 +**默认值**: 3600,604800 ## track_stmt_stat_level -**参数说明**：控制语句执行跟踪的级别。 +**参数说明**: 控制语句执行跟踪的级别。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置，不区分英文字母大小写。 -**取值范围**：字符型 +**取值范围**: 字符型 该参数分为两部分，形式为'full sql stat level, slow sql stat level' @@ -154,18 +154,18 @@ full sql stat level为全量SQL跟踪级别，取值范围为OFF、L0、L1、L2 slow sql stat level为慢SQL的跟踪级别，取值范围为OFF、L0、L1、L2 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若全量SQL跟踪级别值为非OFF时，当前SQL跟踪级别值为全量SQL和慢SQL的较高级别（L2 > L1 > L0），L1在L0的基础上记录了执行计划，L2在L1的基础上记录了锁的详细信息，详情请参考[STATEMENT_HISTORY](STATEMENT_HISTORY)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若全量SQL跟踪级别值为非OFF时，当前SQL跟踪级别值为全量SQL和慢SQL的较高级别（L2 > L1 > L0），L1在L0的基础上记录了执行计划，L2在L1的基础上记录了锁的详细信息，详情请参考[STATEMENT_HISTORY](STATEMENT_HISTORY)。 -**默认值**：OFF,L0 +**默认值**: OFF,L0 ## enable_auto_clean_unique_sql -**参数说明**：当系统中产生的unique sql条目数量大于等于instr_unique_sql_count时，是否启用unique sql自动淘汰功能。 +**参数说明**: 当系统中产生的unique sql条目数量大于等于instr_unique_sql_count时，是否启用unique sql自动淘汰功能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 由于快照有部分信息是来源于unique sql，所以开启自动淘汰的情况下，在生成wdr报告时，如果选择的起始快照和终止快照跨过了淘汰发生的时间，会导致无法生成wdr报告。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27-system-performance-snapshot.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27-system-performance-snapshot.md index 61a8ce9d..8dbc7977 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27-system-performance-snapshot.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27-system-performance-snapshot.md @@ -9,116 +9,116 @@ date: 2021-04-20 ## enable_wdr_snapshot -**参数说明**：是否开启数据库监控快照功能。 +**参数说明**: 是否开启数据库监控快照功能。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：打开数据库监控快照功能。 - off：关闭数据库监控快照功能。 -**默认值**：off +**默认值**: off ## wdr_snapshot_retention_days -**参数说明**：系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照量数超过保留天数内允许生成的快照数量的最大值时，系统将每隔wdr_snapshot_interval时间间隔，清理snapshot_id最小的快照数据。 +**参数说明**: 系统中数据库监控快照数据的保留天数。当数据库运行过程期间所生成的快照量数超过保留天数内允许生成的快照数量的最大值时，系统将每隔wdr_snapshot_interval时间间隔，清理snapshot_id最小的快照数据。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～8。 +**取值范围**: 整型，1～8。 -**默认值**：8 +**默认值**: 8 ## wdr_snapshot_query_timeout -**参数说明**：系统执行数据库监控快照操作时，设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败。 +**参数说明**: 系统执行数据库监控快照操作时，设置快照操作相关的sql语句的执行超时时间。如果语句超过设置的时间没有执行完并返回结果，则本次快照操作失败。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，100～INT_MAX（秒）。 +**取值范围**: 整型，100～INT_MAX（秒）。 -**默认值**：100s +**默认值**: 100s ## wdr_snapshot_interval -**参数说明**：后台线程Snapshot自动对数据库监控数据执行快照操作的时间间隔。 +**参数说明**: 后台线程Snapshot自动对数据库监控数据执行快照操作的时间间隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10～60（分钟）。 +**取值范围**: 整型，10～60（分钟）。 -**默认值**：1h +**默认值**: 1h ## asp_flush_mode -**参数说明**：ASP刷新到磁盘上的方式分为写文件和写系统表，当为‘file’时，默认写文件，为‘table’时写系统表，为‘all’时，即写文件也写系统表，仅sysadmin用户可以访问。 +**参数说明**: ASP刷新到磁盘上的方式分为写文件和写系统表，当为‘file’时，默认写文件，为‘table’时写系统表，为‘all’时，即写文件也写系统表，仅sysadmin用户可以访问。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，‘table’、‘file’、‘all’。 +**取值范围**: 字符串，‘table’、‘file’、‘all’。 -**默认值**：‘table’ +**默认值**: ‘table’ ## asp_flush_rate -**参数说明**：当内存中样本个数达到asp_sample_num时，会按一定比例把内存中样本刷新到磁盘上，asp_flush_rate为刷新比例。该参数为10时表示按10：1进行刷新。 +**参数说明**: 当内存中样本个数达到asp_sample_num时，会按一定比例把内存中样本刷新到磁盘上，asp_flush_rate为刷新比例。该参数为10时表示按10：1进行刷新。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~10。 +**取值范围**: 整型，1~10。 -**默认值**：10 +**默认值**: 10 ## asp_log_filename -**参数说明**：当ASP写文件时，该参数设置文件名的格式，仅sysadmin用户可以访问。 +**参数说明**: 当ASP写文件时，该参数设置文件名的格式，仅sysadmin用户可以访问。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：“asp-%Y-%m-%d_%H%M%S.log” +**默认值**: “asp-%Y-%m-%d_%H%M%S.log” ## asp_retention_days -**参数说明**：当ASP样本写到系统表时，该参数表示保留的最大天数。 +**参数说明**: 当ASP样本写到系统表时，该参数表示保留的最大天数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~7。 +**取值范围**: 整型，1~7。 -**默认值**：2 +**默认值**: 2 ## asp_sample_interval -**参数说明**：每次采样的间隔。 +**参数说明**: 每次采样的间隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~10，单位为秒。 +**取值范围**: 整型，1~10，单位为秒。 -**默认值**：1s +**默认值**: 1s ## asp_sample_num -**参数说明**：LOCAL_ACTIVE_SESSION视图最大的样本个数，仅sysadmin用户可以访问。 +**参数说明**: LOCAL_ACTIVE_SESSION视图最大的样本个数，仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10000～100000。 +**取值范围**: 整型，10000～100000。 -**默认值**：100000 +**默认值**: 100000 ## enable_asp -**参数说明**：是否开启活跃会话信息active session profile。 +**参数说明**: 是否开启活跃会话信息active session profile。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on：打开active session profile功能。 - off：关闭active session profile功能。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27.1-security-configuration.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27.1-security-configuration.md index d483603e..29dc88a1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27.1-security-configuration.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/27.1-security-configuration.md @@ -9,76 +9,76 @@ date: 2021-11-08 ## elastic_search_ip_addr -**参数说明**：Elastic Search系统IP地址。 +**参数说明**: Elastic Search系统IP地址。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：'https:127.0.0.1' +**默认值**: 'https:127.0.0.1' ## enable_security_policy -**参数说明**：安全策略开关，控制统一审计和数据动态脱敏策略是否生效。 +**参数说明**: 安全策略开关，控制统一审计和数据动态脱敏策略是否生效。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 on：安全策略开关打开。 off：安全策略开关关闭。 -**默认值**：off +**默认值**: off ## use_elastic_search -**参数说明**：使能统一审计发送日志至Elastic Search系统，enable_security_policy打开且本参数打开后，统一审计日志会通过http（https）传递至Elastic Search系统（默认使用https安全协议）。此参数打开后需要保证elastic_search_ip_addr对应的es服务可正常连通，否则进程启动失败。 +**参数说明**: 使能统一审计发送日志至Elastic Search系统，enable_security_policy打开且本参数打开后，统一审计日志会通过http（https）传递至Elastic Search系统（默认使用https安全协议）。此参数打开后需要保证elastic_search_ip_addr对应的es服务可正常连通，否则进程启动失败。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 on：使能统一审计日志发送至Elastic Search。 off：关闭统一审计日志发送至Elastic Search。 -**默认值**：off +**默认值**: off ## is_sysadmin -**参数说明**：表示当前用户是否是初始用户。 +**参数说明**: 表示当前用户是否是初始用户。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 on：是初始用户。 off：不是初始用户。 -**默认值**：off +**默认值**: off ## enable_tde -**参数说明**：透明数据加密功能开关。创建加密表前需要将此参数置为on。当前参数值为off时，禁止创建新的加密表，对于已经创建的加密表只在读取数据时解密，写入数据时不再加密。 +**参数说明**: 透明数据加密功能开关。创建加密表前需要将此参数置为on。当前参数值为off时，禁止创建新的加密表，对于已经创建的加密表只在读取数据时解密，写入数据时不再加密。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 on：开启透明数据加密功能。 off：关闭透明数据加密功能。 -**默认值**：off +**默认值**: off ## tde_cmk_id -**参数说明**：透明数据加密功能使用的数据库实例主密钥CMK的ID编号，由使用的密钥管理服务KMS生成。数据库实例主密钥CMK用于对数据加密密钥DEK进行加密保护，当前需要对DEK进行解密时，需要给KMS发起请求报文，将DEK密文和对应CMK的ID编号一起发送给KMS。 +**参数说明**: 透明数据加密功能使用的数据库实例主密钥CMK的ID编号，由使用的密钥管理服务KMS生成。数据库实例主密钥CMK用于对数据加密密钥DEK进行加密保护，当前需要对DEK进行解密时，需要给KMS发起请求报文，将DEK密文和对应CMK的ID编号一起发送给KMS。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：”” +**默认值**: ”” diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29-global-temporary-table.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29-global-temporary-table.md index 7e6304b8..aa83cd3f 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29-global-temporary-table.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29-global-temporary-table.md @@ -9,23 +9,23 @@ date: 2021-04-20 ## max_active_global_temporary_table -**参数说明**：全局临时表功能开关，控制是否可以创建全局临时表。 +**参数说明**: 全局临时表功能开关，控制是否可以创建全局临时表。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 - 0：全局临时表功能关闭。 - > 0：全局临时表功能打开。 -**默认值**：1000 +**默认值**: 1000 ## vacuum_gtt_defer_check_age -**参数说明**：vacuum执行后检查全局临时表relfrozenxid与普通表的差异。如果全局临时表relfrozenxid落后超过指定参数值，就产生WARNING。一般不用修改。 +**参数说明**: vacuum执行后检查全局临时表relfrozenxid与普通表的差异。如果全局临时表relfrozenxid落后超过指定参数值，就产生WARNING。一般不用修改。 该参数USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 1000000 +**取值范围**: 整型，0 ~ 1000000 -**默认值**：10000 +**默认值**: 10000 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29.1-HyperLogLog.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29.1-HyperLogLog.md index 0ae5d495..09fc892e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29.1-HyperLogLog.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/29.1-HyperLogLog.md @@ -9,96 +9,96 @@ date: 2021-11-08 ## hll_default_log2m -**参数说明**：该参数可以指定hll数据结构桶的个数。桶的个数会影响hll计算distinct值的精度，桶的个数越多，误差越小。误差范围为：[-1.04/2^log2m\*1⁄2^,+1.04/2^log2m*1⁄2^]。 +**参数说明**: 该参数可以指定hll数据结构桶的个数。桶的个数会影响hll计算distinct值的精度，桶的个数越多，误差越小。误差范围为：[-1.04/2^log2m\*1⁄2^,+1.04/2^log2m*1⁄2^]。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10~16。 +**取值范围**: 整型，10~16。 -**默认值**：14 +**默认值**: 14 ## hll_default_log2explicit -**参数说明**：该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。 +**参数说明**: 该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~12。0表示跳过Explicit模式，取1-12表示在基数到达2^hll_default_log2explicit^时切换模式。 +**取值范围**: 整型，0~12。0表示跳过Explicit模式，取1-12表示在基数到达2^hll_default_log2explicit^时切换模式。 -**默认值**：10 +**默认值**: 10 ## hll_default_log2sparse -**参数说明**：该参数可以用来设置从Sparse模式到Full模式的默认阈值大小。 +**参数说明**: 该参数可以用来设置从Sparse模式到Full模式的默认阈值大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~14。0表示跳过Explicit模式，取1-14表示在基数到达2^hll_default_log2sparse^时切换模式。 +**取值范围**: 整型，0~14。0表示跳过Explicit模式，取1-14表示在基数到达2^hll_default_log2sparse^时切换模式。 -**默认值**：12 +**默认值**: 12 ## hll_duplicate_check -**参数说明**：该参数可以用来指定是否默认开启duplicatecheck。 +**参数说明**: 该参数可以用来指定是否默认开启duplicatecheck。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0，1。 +**取值范围**: 0，1。 - 0表示默认关闭。 - 1表示默认开启。 -**默认值**：0 +**默认值**: 0 ## hll_default_regwidth（废弃） -**参数说明**：该参数可以指定hll数据结构每个桶的位数，该值越大，hll所占内存越高。hll_default_regwidth和hll_default_log2m可以决定当前hll能够计算的最大distinct value。当前regwidth设为固定值，该参数不再使用。 +**参数说明**: 该参数可以指定hll数据结构每个桶的位数，该值越大，hll所占内存越高。hll_default_regwidth和hll_default_log2m可以决定当前hll能够计算的最大distinct value。当前regwidth设为固定值，该参数不再使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~5。 +**取值范围**: 整型，1~5。 -**默认值**：5 +**默认值**: 5 ## hll_default_expthresh（废弃） -**参数说明**：该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。当前已经使用参数hll_default_log2explicit替代类似功能。 +**参数说明**: 该参数可以用来设置从Explicit模式到Sparse模式的默认阈值大小。当前已经使用参数hll_default_log2explicit替代类似功能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~7。-1表示自动模式，0表示跳过Explicit模式，取1-7表示在基数到达2hll_default_expthresh时切换模式。 +**取值范围**: 整型，-1~7。-1表示自动模式，0表示跳过Explicit模式，取1-7表示在基数到达2hll_default_expthresh时切换模式。 -**默认值**：-1 +**默认值**: -1 ## hll_default_sparseon（废弃） -**参数说明**：该参数可用来指定是否默认开启Sparse模式。当前已经使用参数hll_default_log2sparse替代类似功能，hll_default_log2sparse设置为0时关闭Sparse模式。 +**参数说明**: 该参数可用来指定是否默认开启Sparse模式。当前已经使用参数hll_default_log2sparse替代类似功能，hll_default_log2sparse设置为0时关闭Sparse模式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0，1。0表示默认关闭，1表示默认开启。 +**取值范围**: 0，1。0表示默认关闭，1表示默认开启。 -**默认值**：1 +**默认值**: 1 ## hll_max_sparse（废弃） -**参数说明**：该参数可以用来指定max_sparse的大小。当前已经使用参数hll_default_log2sparse替代类似功能。 +**参数说明**: 该参数可以用来指定max_sparse的大小。当前已经使用参数hll_default_log2sparse替代类似功能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~2147483647 +**取值范围**: 整型，-1~2147483647 -**默认值**：-1 +**默认值**: -1 ## enable_compress_hll（废弃） -**参数说明**：该参数可以用来指定是否对hll开启内存优化模式。目前hll内存已经进行了优化设计，该参数不再使用。 +**参数说明**: 该参数可以用来指定是否对hll开启内存优化模式。目前hll内存已经进行了优化设计，该参数不再使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示对hll开启内存优化模式。 - off/false表示不开启内存优化模式。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md index 64ffd305..5169bfc6 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/1-connection-settings.md @@ -11,85 +11,85 @@ date: 2021-04-20 ## listen_addresses -**参数说明**：声明服务器侦听客户端的TCP/IP地址。 +**参数说明**: 声明服务器侦听客户端的TCP/IP地址。 该参数指定MogDB服务器使用哪些IP地址进行侦听，如IPV4或IPV6（若支持）。服务器主机上可能存在多个网卡，每个网卡可以绑定多个IP地址，该参数就是控制MogDB到底绑定在哪个或者哪几个IP地址上。而客户端则可以通过该参数中指定的IP地址来连接MogDB或者给MogDB发送请求。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： +**取值范围**: - 主机名或IP地址，多个值之间用英文逗号分隔。 - 星号`*`或`0.0.0.0`表示侦听所有IP地址。配置侦听所有IP地址存在安全风险，不推荐用户使用。必须与有效地址结合使用（比如本地IP等），否则，可能造成Build失败的问题。同时，主备环境下配置为`*`或`0.0.0.0`时，主节点数据库路径下postgresql.conf文件中的localport端口号不能为数据库dataPortBase+1，否则会导致数据库无法启动。 - 置空则服务器不会侦听任何IP地址，这种情况下，只有Unix域套接字可以用于连接数据库。 -**默认值**：数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：listen_addresses = 'x.x.x.x'。 ## local_bind_address -**参数说明**：声明当前节点连接MogDB其他节点绑定的本地IP地址。 +**参数说明**: 声明当前节点连接MogDB其他节点绑定的本地IP地址。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值**：数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 +**默认值**: 数据库实例安装好后，根据XML配置文件中不同实例的IP地址配置不同默认值。DN的默认参数值为：local_bind_address = 'x.x.x.x'。。 ## port -**参数说明**：MogDB服务侦听的TCP端口号。 +**参数说明**: MogDB服务侦听的TCP端口号。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该参数由安装时的配置文件指定，请勿轻易修改，否则修改后会影响数据库正常通信。 > -**取值范围**：整型，1～65535 +**取值范围**: 整型，1～65535 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置端口号时，请设置一个未被占用的端口号。设置多个实例的端口号，不可冲突。 > - 1~1023为操作系统保留端口号，请不要使用。 > - 通过配置文件安装数据库实例时，配置文件中的端口号需要注意通信矩阵预留端口。如：DN还需保留dataPortBase+1作为内部工具使用端口，保留dataPortBase+6作为流引擎消息队列通信端口等。故数据库实例安装阶段，port最大值为：DN可设置65529，同时需要保证端口号不冲突。 -**默认值**：5432（实际值由安装时的配置文件指定） +**默认值**: 5432（实际值由安装时的配置文件指定） ## max_connections -**参数说明**：允许和数据库连接的最大并发连接数。此参数会影响MogDB的并发能力。 +**参数说明**: 允许和数据库连接的最大并发连接数。此参数会影响MogDB的并发能力。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”。job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置。AUXILIARY_BACKENDS为预留辅助线程数，固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数，固定为2。 +**取值范围**: 整型。最小值为10（要大于max_wal_senders），理论最大值为262143，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS - max_inner_tool_connections”。job_queue_processes、autovacuum_max_workers和max_inner_tool_connections的值取决于对应GUC参数的设置。AUXILIARY_BACKENDS为预留辅助线程数，固定为20，AV_LAUNCHER_PROCS为预留autovacuum的lancher线程数，固定为2。 -**默认值**： +**默认值**: - **200**：编译安装数据库或极简安装数据库的情况下。 - **5000**：使用om安装数据库的情况下。 -**设置建议：** +**设置建议**: 数据库主节点中此参数建议保持默认值。 -**配置不当时影响：** +**配置不当时影响**: - 若配置max_connections过大，超过计算公式所描述的最大动态值，会出现节点拉起失败问题，报错提示“invalid value for parameter “max_connections””。 - 若未按照对外出口规格配置仅调大max_connections参数值，未同比例调整内存参数。业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 对于管理员用户的连接数限制会略超过max_connections设置，目的是为了让管理员在链接被普通用户占满后仍可以连接上数据库，再超过一定范围（sysadmin_reserved_connections参数）后才会报错。即管理员用户的最大连接数等于max_connections + sysadmin_reserved_connections。 > - 对于普通用户来说，由于内部作业也会使用一些链接，因此会略小于max_connections，具体值取决于内部链接个数。 ## max_inner_tool_connections -**参数说明**：允许和数据库连接的工具的最大并发连接数。此参数会影响MogDB的工具连接并发能力。 +**参数说明**: 允许和数据库连接的工具的最大并发连接数。此参数会影响MogDB的工具连接并发能力。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为1，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值**：数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 +**默认值**: 数据库节点为50。如果该默认值超过内核支持的最大值（在执行gs_initdb的时候判断），系统会提示错误。 -**设置建议：** +**设置建议**: 数据库主节点中此参数建议保持默认值。 @@ -97,39 +97,39 @@ date: 2021-04-20 ## sysadmin_reserved_connections -**参数说明**：为管理员用户预留的最少连接数, 不建议设置过大。该参数和max_connections参数配合使用，管理员用户的最大连接数等于max_connections+sysadmin_reserved_connections。 +**参数说明**: 为管理员用户预留的最少连接数, 不建议设置过大。该参数和max_connections参数配合使用，管理员用户的最大连接数等于max_connections+sysadmin_reserved_connections。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 +**取值范围**: 整型，最小值为0，最大值为MIN(262143, max_connections)，max_connections的计算方法见上文。 -**默认值**：3 +**默认值**: 3 ## unix_socket_directory -**参数说明**：设置MogDB服务器侦听客户端连接的Unix域套接字目录。 +**参数说明**: 设置MogDB服务器侦听客户端连接的Unix域套接字目录。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 该参数的长度限制于操作系统的长度，超过该限制将会导致Unix-domain socket path "xxx" is too long的问题。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空字符串（实际值由安装时配置文件指定） +**默认值**: 空字符串（实际值由安装时配置文件指定） ## unix_socket_group -**参数说明**：设置Unix域套接字的所属组（套接字的所属用户总是启动服务器的用户）。可以与选项[unix_socket_permissions](#unix_socket_permissions)一起用于对套接字进行访问控制。 +**参数说明**: 设置Unix域套接字的所属组（套接字的所属用户总是启动服务器的用户）。可以与选项[unix_socket_permissions](#unix_socket_permissions)一起用于对套接字进行访问控制。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，其中空字符串表示当前用户的缺省组。 +**取值范围**: 字符串，其中空字符串表示当前用户的缺省组。 -**默认值**：空字符串 +**默认值**: 空字符串 ## unix_socket_permissions -**参数说明**：设置Unix域套接字的访问权限。 +**参数说明**: 设置Unix域套接字的访问权限。 Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应该是数值的格式（chmod和umask命令可接受的格式）。如果使用自定义的八进制格式，数字必须以0开头。 @@ -137,11 +137,11 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0000-0777 +**取值范围**: 0000-0777 -**默认值**：0777 +**默认值**: 0777 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 在Linux中，文档具有十个属性，其中第一个属性为文档类型，后面九个为权限属性，分别为Owner，Group及Others这三个组别的read、write、execute属性。 文档的权限属性分别简写为r、w、x，这九个属性三个为一组，也可以使用数字来表示文档的权限，对照表如下： > @@ -167,27 +167,27 @@ Unix域套接字使用普通的Unix文件系统权限集。这个参数的值应 ## application_name -**参数说明**：当前连接请求当中，所使用的客户端名称。 +**参数说明**: 当前连接请求当中，所使用的客户端名称。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 在备机请求主机进行日志复制时，如果该参数非空串，那么会被用来作为备机在主机上的流复制槽名字。此时，如果该参数长度超过61个字节，那么流复制槽名字只会截取使用前61个字节的字符。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：空字符串（连接到后端的应用名，以实际安装为准） +**默认值**: 空字符串（连接到后端的应用名，以实际安装为准） ## connection_info -**参数说明**：连接数据库的驱动类型、驱动版本号、当前驱动的部署路径和进程属主用户。 +**参数说明**: 连接数据库的驱动类型、驱动版本号、当前驱动的部署路径和进程属主用户。 该参数属于USERSET类型参数，属于运维类参数，不建议用户设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：空字符串**。** +**默认值**: 空字符串**。** -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 空字符串，表示当前连接数据库的驱动不支持自动设置connection_info参数或应用程序未设置。 > - 驱动连接数据库的时候自行拼接的connection_info参数格式如下： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md index 06646d99..a102029a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/2-security-and-authentication.md @@ -11,57 +11,57 @@ date: 2021-04-20 ## authentication_timeout -**参数说明**：完成客户端认证的最长时间。如果一个客户端没有在这段时间里完成与服务器端的认证，则服务器自动中断与客户端的连接，这样就避免了出问题的客户端无限制地占用连接数。 +**参数说明**: 完成客户端认证的最长时间。如果一个客户端没有在这段时间里完成与服务器端的认证，则服务器自动中断与客户端的连接，这样就避免了出问题的客户端无限制地占用连接数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为1，最大值为600，最小单位为s。 +**取值范围**: 整型，最小值为1，最大值为600，最小单位为s。 -**默认值**：1min +**默认值**: 1min ## auth_iteration_count -**参数说明**：认证加密信息生成过程中使用的迭代次数。 +**参数说明**: 认证加密信息生成过程中使用的迭代次数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，2048-134217728。 +**取值范围**: 整型，2048-134217728。 -**默认值**：10000 +**默认值**: 10000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 迭代次数设置过小会降低口令存储的安全性，设置过大会导致认证、用户创建等涉及口令加密的场景性能劣化，请根据实际硬件条件合理设置迭代次数，推荐采用默认迭代次数。 ## session_authorization -**参数说明**：当前会话的用户标识。 +**参数说明**: 当前会话的用户标识。 该参数属于USERSET类型参数，此参数为内部参数，只能通过[SET SESSION AUTHORIZATION](SET-SESSION-AUTHORIZATION)语法设置，不支持直接设置。 -**取值范围**：字符串。 +**取值范围**: 字符串。 -**默认值**：NULL +**默认值**: NULL ## session_timeout -**参数说明**：表明与服务器建立链接后，不进行任何操作的最长时间。 +**参数说明**: 表明与服务器建立链接后，不进行任何操作的最长时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0-86400，最小单位为s，0表示关闭超时设置。 +**取值范围**: 整型，0-86400，最小单位为s，0表示关闭超时设置。 -**默认值**：10min +**默认值**: 10min > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > MogDB gsql客户端中有自动重连机制，所以针对初始化用户本地连接，超时后gsql表现的现象为断开后重连。 ## ssl -**参数说明**：启用SSL连接。请在使用这个选项之前阅读[gsql客户端连接](using-the-gsql-client-for-connection)。 +**参数说明**: 启用SSL连接。请在使用这个选项之前阅读[gsql客户端连接](using-the-gsql-client-for-connection)。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启用SSL连接。 - off表示不启用SSL连接。 @@ -70,15 +70,15 @@ date: 2021-04-20 > > 开启此参数需要同时配置ssl_cert_file、ssl_key_file和ssl_ca_file等参数及对应文件，不正确的配置可能会导致MogDB无法正常启动。 -**默认值**：on +**默认值**: on ## require_ssl -**参数说明**：设置服务器端是否强制要求SSL连接，该参数只有当参数[ssl](#ssl)为on时才有效。请在使用这个选项之前阅读[gsql客户端连接](using-the-gsql-client-for-connection)。 +**参数说明**: 设置服务器端是否强制要求SSL连接，该参数只有当参数[ssl](#ssl)为on时才有效。请在使用这个选项之前阅读[gsql客户端连接](using-the-gsql-client-for-connection)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示服务器端强制要求SSL连接。 - off表示服务器端对是否通过SSL连接不作强制要求。 @@ -86,135 +86,135 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > MogDB目前支持SSL的场景为客户端连接数据库主节点场景，该参数目前建议只在数据库主节点中开启。 -**默认值**：off +**默认值**: off ## ssl_ciphers -**参数说明**：指定SSL支持的加密算法列表。ssl_ciphers设置错误会导致数据库不能正常启动。 +**参数说明**: 指定SSL支持的加密算法列表。ssl_ciphers设置错误会导致数据库不能正常启动。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见[用SSL进行安全的TCP/IP连接](1-client-access-authentication#用ssl进行安全的tcpip连接)获取支持的加密算法。 +**取值范围**: 字符串，如果指定多个加密算法，加密算法之间需要以分号分割。详细请参见[用SSL进行安全的TCP/IP连接](1-client-access-authentication#用ssl进行安全的tcpip连接)获取支持的加密算法。 -**默认值**：ALL +**默认值**: ALL ## ssl_renegotiation_limit -**参数说明**：指定在会话密钥重新协商之前，通过SSL加密通道可以传输的流量。这个重新协商流量限制机制可以减少攻击者针对大量数据使用密码分析法破解密钥的几率，但是也带来较大的性能损失。流量是指发送和接受的流量总和。使用SSL重协商机制可能引入其他风险，因此已禁用SSL重协商机制，为保持版本兼容保留此参数，修改参数配置不再起作用。 +**参数说明**: 指定在会话密钥重新协商之前，通过SSL加密通道可以传输的流量。这个重新协商流量限制机制可以减少攻击者针对大量数据使用密码分析法破解密钥的几率，但是也带来较大的性能损失。流量是指发送和接受的流量总和。使用SSL重协商机制可能引入其他风险，因此已禁用SSL重协商机制，为保持版本兼容保留此参数，修改参数配置不再起作用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 +**取值范围**: 整型，最小值为0，最大值为2147483647。单位为KB。其中0表示禁用重新协商机制。 -**默认值**：0 +**默认值**: 0 ## ssl_cert_file -**参数说明**：指定包含SSL服务器证书的文件的名称。相对路径是相对于数据目录的。 +**参数说明**: 指定包含SSL服务器证书的文件的名称。相对路径是相对于数据目录的。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：server.crt +**默认值**: server.crt ## ssl_key_file -**参数说明**：指定包含SSL私钥的文件名称。相对路径是相对于数据目录的。 +**参数说明**: 指定包含SSL私钥的文件名称。相对路径是相对于数据目录的。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 取值范围:字符串 -**默认值**：server.key +**默认值**: server.key ## ssl_ca_file -**参数说明**：指定包含CA信息的文件的名称。相对路径是相对于数据目录的。 +**参数说明**: 指定包含CA信息的文件的名称。相对路径是相对于数据目录的。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，其中空字符串表示没有CA文件被加载，不进行客户端证书验证。 +**取值范围**: 字符串，其中空字符串表示没有CA文件被加载，不进行客户端证书验证。 -**默认值**：cacert.pem +**默认值**: cacert.pem ## ssl_crl_file -**参数说明**：证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。必须使用相对路径，相对路径是相对于数据目录的。 +**参数说明**: 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。必须使用相对路径，相对路径是相对于数据目录的。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，空字符串表示没有吊销列表。 +**取值范围**: 字符串，空字符串表示没有吊销列表。 -**默认值**：空 +**默认值**: 空 ## krb_server_keyfile -**参数说明**：指定Kerberos服务主配置文件的位置，详细请参见[配置客户端接入认证](1-client-access-authentication#配置客户端接入认证)。 +**参数说明**: 指定Kerberos服务主配置文件的位置，详细请参见[配置客户端接入认证](1-client-access-authentication#配置客户端接入认证)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## krb_srvname -**参数说明**：设置Kerberos服务名，详细请参见[配置客户端接入认证](1-client-access-authentication#配置客户端接入认证)。 +**参数说明**: 设置Kerberos服务名，详细请参见[配置客户端接入认证](1-client-access-authentication#配置客户端接入认证)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：postgres +**默认值**: postgres ## krb_caseins_users -**参数说明**：设置Kerberos用户名是否大小写敏感。 +**参数说明**: 设置Kerberos用户名是否大小写敏感。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示大小写不敏感。 - off表示大小写敏感。 -**默认值**：off +**默认值**: off ## modify_initial_password -**参数说明**：当MogDB安装成功后，数据库中仅存在一个初始用户（UID为10的用户）。客户通过该帐户初次登录数据库进行操作时，该参数决定是否要对该初始帐户的密码进行修改。 +**参数说明**: 当MogDB安装成功后，数据库中仅存在一个初始用户（UID为10的用户）。客户通过该帐户初次登录数据库进行操作时，该参数决定是否要对该初始帐户的密码进行修改。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 如果安装过程中未指定初始用户密码，则安装后初始用户密码默认为空，执行其他操作前需要先通过gsql客户端设置初始用户的密码。此参数功能不再生效，保留此参数仅为兼容升级场景。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示MogDB安装成功后初始用户首次登录操作前需要修改初始密码。 - off表示MogDB安装成功后初始用户无需修改初始密码即可进行操作。 -**默认值**：off +**默认值**: off ## password_policy -**参数说明**：在使用CREATE ROLE/USER或者ALTER ROLE/USER命令创建或者修改MogDB帐户时，该参数决定是否进行密码复杂度检查。关于密码复杂度检查策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 +**参数说明**: 在使用CREATE ROLE/USER或者ALTER ROLE/USER命令创建或者修改MogDB帐户时，该参数决定是否进行密码复杂度检查。关于密码复杂度检查策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > 从安全性考虑，请勿关闭密码复杂度策略。 -**取值范围**：0、1 +**取值范围**: 0、1 - 0表示不采用密码复杂度校验策略。 - 1表示采用默认密码复杂度校验策略。 -**默认值**：1 +**默认值**: 1 ## password_reuse_time -**参数说明**：在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用天数检查。关于密码可重用策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 +**参数说明**: 在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用天数检查。关于密码可重用策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -226,16 +226,16 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围**：浮点型，最小值为0，最大值为3650，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为3650，单位为天。 - 0表示不检查密码可重用的天数。 - 正数表示新密码不能为该值指定的天数内使用过的密码。 -**默认值**：60 +**默认值**: 60 ## password_reuse_max -**参数说明**：在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用次数检查。关于密码可重用策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 +**参数说明**: 在使用ALTER USER或者ALTER ROLE修改用户密码时，该参数指定是否对新密码进行可重用次数检查。关于密码可重用策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -247,52 +247,52 @@ date: 2021-04-20 > - 当[password_reuse_max](#password_reuse_max)为0时，表示不限制密码重用次数，仅限制密码重用天数。 > - 当[password_reuse_time](#password_reuse_time)和[password_reuse_max](#password_reuse_max)都为0时，表示不对密码重用进行限制。 -**取值范围**：整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示不检查密码可重用次数。 - 正整数表示新密码不能为该值指定的次数内使用过的密码。 -**默认值**：0 +**默认值**: 0 ## password_lock_time -**参数说明**：该参数指定帐户被锁定后自动解锁的时间。关于帐户自动锁定策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 +**参数说明**: 该参数指定帐户被锁定后自动解锁的时间。关于帐户自动锁定策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > password_lock_time和[failed_login_attempts](#failed_login_attempts)必须都为正数时锁定和解锁功能才能生效。 -**取值范围**：浮点型，最小值为0，最大值为365，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为365，单位为天。 - 0表示密码验证失败时，自动锁定功能不生效。 - 正数表示帐户被锁定后，当锁定时间超过password_lock_time设定的值时，帐户将会被自行解锁。 -**默认值**：1d +**默认值**: 1d ## failed_login_attempts -**参数说明**：在任意时在任意时候，如果输入密码错误的次数达到failed_login_attempts参数设定的值，则当前帐户会被锁定。password_lock_time参数设定的天数过后，帐户自动解锁。例如，登录时输入密码失败，ALTER USER时修改密码失败等。关于帐户自动锁定策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 +**参数说明**: 在任意时在任意时候，如果输入密码错误的次数达到failed_login_attempts参数设定的值，则当前帐户会被锁定。password_lock_time参数设定的天数过后，帐户自动解锁。例如，登录时输入密码失败，ALTER USER时修改密码失败等。关于帐户自动锁定策略请参见[设置密码安全策略](2-managing-users-and-their-permissions#设置密码安全策略)。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > failed_login_attempts和[password_lock_time](#password_lock_time)必须都为正数时锁定和解锁功能才能生效。 -**取值范围**：整型，最小值为0，最大值为1000。 +**取值范围**: 整型，最小值为0，最大值为1000。 - 0表示自动锁定功能不生效。 - 正整数表示当错误密码次数达到failed_login_attempts设定的值时，当前帐户将被锁定。 -**默认值**：10 +**默认值**: 10 ## password_encryption_type -**参数说明**：该字段决定采用何种加密方式对用户密码进行加密存储。修改此参数的配置不会自动触发已有用户密码加密方式的修改，只会影响新创建用户或修改用户密码操作。 +**参数说明**: 该字段决定采用何种加密方式对用户密码进行加密存储。修改此参数的配置不会自动触发已有用户密码加密方式的修改，只会影响新创建用户或修改用户密码操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0、1、2、3 +**取值范围**: 0、1、2、3 - 0表示采用md5方式对密码加密。 - 1表示采用sha256和md5两种方式分别对密码加密。 @@ -302,102 +302,102 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > md5加密算法安全性低，存在安全风险，不建议用户使用。 -**默认值**：2 +**默认值**: 2 ## password_min_length -**参数说明**：该字段决定帐户密码的最小长度。 +**参数说明**: 该字段决定帐户密码的最小长度。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值**：8 +**默认值**: 8 ## password_max_length -**参数说明**：该字段决定帐户密码的最大长度。 +**参数说明**: 该字段决定帐户密码的最大长度。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，6~999个字符。 +**取值范围**: 整型，6~999个字符。 -**默认值**：32 +**默认值**: 32 ## password_min_uppercase -**参数说明**：该字段决定帐户密码中至少需要包含大写字母个数。 +**参数说明**: 该字段决定帐户密码中至少需要包含大写字母个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建账户所指定的密码中至少需要包含大写字母个数。 -**默认值**：0 +**默认值**: 0 ## password_min_lowercase -**参数说明**：该字段决定帐户密码中至少需要包含小写字母的个数。 +**参数说明**: 该字段决定帐户密码中至少需要包含小写字母的个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含小写字母个数。 -**默认值**：0 +**默认值**: 0 ## password_min_digital -**参数说明**：该字段决定帐户密码中至少需要包含数字的个数。 +**参数说明**: 该字段决定帐户密码中至少需要包含数字的个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含数字个数。 -**默认值**：0 +**默认值**: 0 ## password_min_special -**参数说明**：该字段决定帐户密码中至少需要包含特殊字符个数。 +**参数说明**: 该字段决定帐户密码中至少需要包含特殊字符个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~999 +**取值范围**: 整型，0~999 - 0表示没有限制。 - 1~999表示创建帐户所指定的密码中至少需要包含特殊字符个数。 -**默认值**：0 +**默认值**: 0 ## password_effect_time -**参数说明**：该字段决定帐户密码的有效时间。 +**参数说明**: 该字段决定帐户密码的有效时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，最小值为0，最大值为999，单位为天。 +**取值范围**: 浮点型，最小值为0，最大值为999，单位为天。 - 0表示不开启有效期限制功能。 - 1~999表示创建帐户所指定的密码有效期，临近或超过有效期系统会提示用户修改密码。 -**默认值**：90 +**默认值**: 90 ## password_notify_time -**参数说明**：该字段决定帐户密码到期前提醒的天数。 +**参数说明**: 该字段决定帐户密码到期前提醒的天数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值为0，最大值为999，单位为天。 +**取值范围**: 整型，最小值为0，最大值为999，单位为天。 - 0表示不开启提醒功能。 - 1~999表示帐户密码到期前提醒的天数。 -**默认值**：7 +**默认值**: 7 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md index 5b3de42c..a793e9b9 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/3-connection-and-authentication/3-communication-library-parameters.md @@ -11,11 +11,11 @@ date: 2021-04-20 ## tcp_keepalives_idle -**参数说明**：在支持TCP_KEEPIDLE套接字选项的系统上，设置发送活跃信号的间隔秒数。不设置发送保持活跃信号，连接就会处于闲置状态。 +**参数说明**: 在支持TCP_KEEPIDLE套接字选项的系统上，设置发送活跃信号的间隔秒数。不设置发送保持活跃信号，连接就会处于闲置状态。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPIDLE选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 @@ -24,21 +24,21 @@ date: 2021-04-20 > - 该参数在不同的**会话之间不共享**，也就是说不同的会话连接可能有不同的值。 > - 查看该参数时查出来的是**当前会话连接内的参数值**，而不是**guc副本的值**。 -**取值范围**：0-3600，单位为s。 +**取值范围**: 0-3600，单位为s。 -**默认值**：0 +**默认值**: 0 ## tcp_keepalives_interval -**参数说明**：在支持TCP_KEEPINTVL套接字选项的操作系统上，以秒数声明在重新传输之间等待响应的时间。 +**参数说明**: 在支持TCP_KEEPINTVL套接字选项的操作系统上，以秒数声明在重新传输之间等待响应的时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0-180，单位为s。 +**取值范围**: 0-180，单位为s。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPINTVL选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行的连接的操作系统上，这个参数将被忽略。 @@ -48,11 +48,11 @@ date: 2021-04-20 ## tcp_keepalives_count -**参数说明**：在支持TCP_KEEPCNT套接字选项的操作系统上，设置MogDB服务端在断开与客户端连接之前可以等待的保持活跃信号个数。 +**参数说明**: 在支持TCP_KEEPCNT套接字选项的操作系统上，设置MogDB服务端在断开与客户端连接之前可以等待的保持活跃信号个数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果操作系统不支持TCP_KEEPCNT选项，这个参数的值必须为0。 > - 在通过Unix域套接字进行连接的操作系统上，这个参数将被忽略。 @@ -60,15 +60,15 @@ date: 2021-04-20 > - 该参数在不同的**会话之间不共享**，也就是说不同的会话连接可能有不同的值。 > - 查看该参数时查出来的是**当前会话连接内的参数值**，而不是**guc副本的值**。 -**取值范围**：0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 +**取值范围**: 0-100，其中0表示MogDB未收到客户端反馈的保持活跃信号则立即断开连接。 -**默认值**：0 +**默认值**: 0 ## comm_proxy_attr -**参数说明**：通信代理库相关参数配置。 +**参数说明**: 通信代理库相关参数配置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该参数仅支持欧拉2.9系统下的集中式ARM单机。 > - 本功能在线程池开启状态下生效，即enable_thread_pool为on。 @@ -82,6 +82,6 @@ date: 2021-04-20 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0。 +**取值范围**: 字符串，长度大于0。 -**默认值**：'none' +**默认值**: 'none' diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/31-scheduled-task.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/31-scheduled-task.md index de5c8bb2..a8e7b5fb 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/31-scheduled-task.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/31-scheduled-task.md @@ -9,11 +9,11 @@ date: 2021-06-07 ## job_queue_processes -**参数说明**：表示系统可以并发执行的job数目。该参数为postmaster级别，通过gs_guc设置，需要重启MogDB才能生效。 +**参数说明**: 表示系统可以并发执行的job数目。该参数为postmaster级别，通过gs_guc设置，需要重启MogDB才能生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0～1000 +**取值范围**: 0～1000 功能： @@ -26,17 +26,17 @@ date: 2021-06-07 注：如果同一时间内并行的job数很多，过小的参数值会导致job等待。而过大的参数值则消耗更多的系统资源，建议设置此参数为100，用户可以根据系统资源情况合理调整。 -**默认值**：10 +**默认值**: 10 ## enable_prevent_job_task_startup -**参数说明**：控制是否启动job线程。 +**参数说明**: 控制是否启动job线程。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示不能启动job线程。 - off表示可以启动job线程。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/32-thread-pool.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/32-thread-pool.md index f3e15ac5..6708e28f 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/32-thread-pool.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/32-thread-pool.md @@ -9,20 +9,20 @@ date: 2021-06-07 ## enable_thread_pool -**参数说明**：控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 控制是否使用线程池功能。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启线程池功能。 - off表示不开启线程池功能。 -**默认值**：off +**默认值**: off ## thread_pool_attr -**参数说明**：用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 用于控制线程池功能的详细属性，该参数仅在enable_thread_pool打开后生效。该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 该参数分为3个部分，'thread_num, group_num, cpubind_info'，这3个部分的具体含义如下： @@ -35,4 +35,4 @@ date: 2021-06-07 4. '(cpubind: 0-30)'，利用0-30号CPU core进行绑核。该参数不区分大小写。 5. '(numabind: 0-30)'，在NUMA组内利用0-30号CPU core进行绑核。利用0-30号CPU core进行绑核。该参数不区分大小写。 -**默认值**：'16, 2, (nobind)' +**默认值**: '16, 2, (nobind)' diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/33-user-defined-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/33-user-defined-functions.md index 83c772e2..c8cdfe0f 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/33-user-defined-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/33-user-defined-functions.md @@ -9,46 +9,46 @@ date: 2021-11-08 ## udf_memory_limit -**参数说明**：控制每个数据库节点执行UDF时可用的最大物理内存量。本参数当前版本不生效，请使用FencedUDFMemoryLimit和UDFWorkerMemHardLimit参数控制fenced udf worker虚存。 +**参数说明**: 控制每个数据库节点执行UDF时可用的最大物理内存量。本参数当前版本不生效，请使用FencedUDFMemoryLimit和UDFWorkerMemHardLimit参数控制fenced udf worker虚存。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，200\*1024～max_process_memory，单位为KB。 +**取值范围**: 整型，200\*1024～max_process_memory，单位为KB。 -**默认值**：200MB +**默认值**: 200MB ## FencedUDFMemoryLimit -**参数说明**：控制每个fenced udf worker进程使用的虚拟内存。 +**参数说明**: 控制每个fenced udf worker进程使用的虚拟内存。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整数，0 \~ 2147483647，单位为KB，设置可带单位（KB，MB，GB）。其中0表示不做内存控制。 +**取值范围**: 整数，0 \~ 2147483647，单位为KB，设置可带单位（KB，MB，GB）。其中0表示不做内存控制。 -**默认值**：0 +**默认值**: 0 ## UDFWorkerMemHardLimit -**参数说明**：控制fencedUDFMemoryLimit的最大值。 +**参数说明**: 控制fencedUDFMemoryLimit的最大值。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整数，0 \~ 2147483647，单位为KB，设置时可带单位（KB，MB，GB）。 +**取值范围**: 整数，0 \~ 2147483647，单位为KB，设置时可带单位（KB，MB，GB）。 -**默认值**：1GB +**默认值**: 1GB ## pljava_vmoptions -**参数说明**：用户自定义设置PL/Java函数所使用的JVM虚拟机的启动参数，仅sysadmin用户可以访问。 +**参数说明**: 用户自定义设置PL/Java函数所使用的JVM虚拟机的启动参数，仅sysadmin用户可以访问。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，支持： +**取值范围**: 字符串，支持： - JDK8 JVM启动参数（可参见JDK[官方](https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html)说明） - JDK8 JVM系统属性参数（以-D开头如-Djava.ext.dirs，可参见JDK[官方](https://docs.oracle.com/javase/tutorial/deployment/doingMoreWithRIA/properties.html)说明） - 用户自定义参数（以-D开头，如-Duser.defined.option） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**如果用户在pljava_vmoptions中设置参数不满足上述取值范围，会在使用PL/Java语言函数时报错。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:如果用户在pljava_vmoptions中设置参数不满足上述取值范围，会在使用PL/Java语言函数时报错。 -**默认值**：空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/34-backup-and-restoration.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/34-backup-and-restoration.md index de94a15d..d472ec73 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/34-backup-and-restoration.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/34-backup-and-restoration.md @@ -9,38 +9,38 @@ date: 2021-11-08 ## operation_mode -**参数说明**：标示系统进入备份恢复模式。 +**参数说明**: 标示系统进入备份恢复模式。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在备份恢复过程中。 - off表示不在备份恢复过程中。 -**默认值**：off +**默认值**: off ## enable_cbm_tracking -**参数说明**：当使用roach执行数据库实例的全量和增量备份时需要开启此参数，如果关闭会导致备份失败。 +**参数说明**: 当使用roach执行数据库实例的全量和增量备份时需要开启此参数，如果关闭会导致备份失败。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示追踪功能开启。 - off表示追踪功能关闭。 -**默认值**：off +**默认值**: off ## hadr_max_size_for_xlog_receiver -**参数说明**：该参数为异地容灾参数，表示灾备数据库实例中实例获取obs端日志和本地回放日志的最大允许差距，若差距大于此值时停止获取obs端日志。 +**参数说明**: 该参数为异地容灾参数，表示灾备数据库实例中实例获取obs端日志和本地回放日志的最大允许差距，若差距大于此值时停止获取obs端日志。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中方式对应设置方法进行设置。 **修改建议：**该参数的取值应和本地磁盘大小相关，建议设置为磁盘大小的50%。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：256GB +**默认值**: 256GB diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/35-undo.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/35-undo.md index 61219cbc..22591c06 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/35-undo.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/35-undo.md @@ -9,20 +9,20 @@ date: 2021-11-08 ## undo_space_limit_size -**参数说明**：用于控制undo强制回收阈值，达到阈值的80%启动强制回收，用户需要根据自己的业务情况，设置该值，可以通过先设置一个较大值，然后观察实际业务运行占用undo空间，再将该值调整为合理值。 +**参数说明**: 用于控制undo强制回收阈值，达到阈值的80%启动强制回收，用户需要根据自己的业务情况，设置该值，可以通过先设置一个较大值，然后观察实际业务运行占用undo空间，再将该值调整为合理值。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，800M~16TB +**取值范围**: 整型，800M~16TB -**默认值**：256GB +**默认值**: 256GB ## undo_limit_size_per_transaction -**参数说明**：用于控制单事务undo分配空间阈值，达到阈值时事务报错回滚。 +**参数说明**: 用于控制单事务undo分配空间阈值，达到阈值时事务报错回滚。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，2M~16TB +**取值范围**: 整型，2M~16TB -**默认值**：32GB +**默认值**: 32GB diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/36-DCF-parameters-settings.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/36-DCF-parameters-settings.md index 16361318..f1b8297b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/36-DCF-parameters-settings.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/36-DCF-parameters-settings.md @@ -9,123 +9,123 @@ date: 2021-11-08 ## enable_dcf -**参数说明**：是否开启DCF模式，该参数不允许修改。 +**参数说明**: 是否开启DCF模式，该参数不允许修改。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，on/off。on表示当前安装部署方式为DCF模式，off表示当前安装部署方式为非DCF模式。 +**取值范围**: 布尔型，on/off。on表示当前安装部署方式为DCF模式，off表示当前安装部署方式为非DCF模式。 -**默认值**：off +**默认值**: off ## dcf_ssl -**参数说明**：是否开启SSL，重启生效。 +**参数说明**: 是否开启SSL，重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型，on/off。on表示使用SSL，off表示不使用SSL。 +**取值范围**: 布尔型，on/off。on表示使用SSL，off表示不使用SSL。 -**默认值**：on +**默认值**: on ## dcf_config -**参数说明**：用户安装时自定义配置信息，该参数不允许修改。 +**参数说明**: 用户安装时自定义配置信息，该参数不允许修改。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值**：字符串，安装时用户自定义配置 +**默认值**: 字符串，安装时用户自定义配置 ## dcf_data_path -**参数说明**：DCF数据路径，该参数不允许修改。 +**参数说明**: DCF数据路径，该参数不允许修改。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值**：字符串，DN数据目录下的dcf_data目录 +**默认值**: 字符串，DN数据目录下的dcf_data目录 ## dcf_log_path -**参数说明**：DCF日志路径，该参数不允许修改。 +**参数说明**: DCF日志路径，该参数不允许修改。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值**：字符串，DN数据目录下的dcf_log目录 +**默认值**: 字符串，DN数据目录下的dcf_log目录 ## dcf_node_id -**参数说明**：DCF所在DN节点ID，用户安装时自定义，该参数不允许修改。 +**参数说明**: DCF所在DN节点ID，用户安装时自定义，该参数不允许修改。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**默认值**：整型，安装时用户自定义配置 +**默认值**: 整型，安装时用户自定义配置 ## dcf_max_workers -**参数说明**：DCF回调函数线程个数。如果节点数量超过7个，需要增加这个参数的数值（比如增加到40），否则可能会出现主节点一直处于promoting状态，主备节点日志不推进的状态。 +**参数说明**: DCF回调函数线程个数。如果节点数量超过7个，需要增加这个参数的数值（比如增加到40），否则可能会出现主节点一直处于promoting状态，主备节点日志不推进的状态。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10~262143 +**取值范围**: 整型，10~262143 -**默认值**：10 +**默认值**: 10 ## dcf_truncate_threshold -**参数说明**：DN对DCF日志进行truncate的门限阈值。 +**参数说明**: DN对DCF日志进行truncate的门限阈值。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~2147483647 +**取值范围**: 整型，1~2147483647 -**默认值**：100000 +**默认值**: 100000 ## dcf_election_timeout -**参数说明**：DCF leader和follower选举超时时间。选举超时时间数值依赖于当前DN之间的网络状况，在超时时间较小且网络极差的情形下，会有超时选举发生，待网络恢复选举恢复正常。建议根据当前网络状态合理设置超时时间。对DCF节点时钟的约束：DCF节点间最大时钟差异小于选举超时时间的一半。 +**参数说明**: DCF leader和follower选举超时时间。选举超时时间数值依赖于当前DN之间的网络状况，在超时时间较小且网络极差的情形下，会有超时选举发生，待网络恢复选举恢复正常。建议根据当前网络状态合理设置超时时间。对DCF节点时钟的约束：DCF节点间最大时钟差异小于选举超时时间的一半。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位s，1~600 +**取值范围**: 整型，单位s，1~600 -**默认值**：3 +**默认值**: 3 ## dcf_enable_auto_election_priority -**参数说明**：DCF优先级选主是否允许内部自动调整优先级值。0表示不允许，1表示允许内部自动调整。 +**参数说明**: DCF优先级选主是否允许内部自动调整优先级值。0表示不允许，1表示允许内部自动调整。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1 +**取值范围**: 整型，0~1 -**默认值**：1 +**默认值**: 1 ## dcf_election_switch_threshold -**参数说明**：DCF防频繁切主门限。推荐根据用户业务可接受的最大故障时间配置。 +**参数说明**: DCF防频繁切主门限。推荐根据用户业务可接受的最大故障时间配置。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位s，0~2147483647 +**取值范围**: 整型，单位s，0~2147483647 -**默认值**：0 +**默认值**: 0 ## dcf_run_mode -**参数说明**：DCF选举模式，0表示自动选举模式，2表示去使能选举模式。目前去使能选举模式只限定少数派恢复场景使用，修改会导致数据库实例不可用。 +**参数说明**: DCF选举模式，0表示自动选举模式，2表示去使能选举模式。目前去使能选举模式只限定少数派恢复场景使用，修改会导致数据库实例不可用。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型，0、2 +**取值范围**: 枚举类型，0、2 -**默认值**：0 +**默认值**: 0 ## dcf_log_level -**参数说明**：DCF日志级别。 +**参数说明**: DCF日志级别。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - **关闭日志**：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。 @@ -133,230 +133,230 @@ date: 2021-11-08 日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空串。 -**默认值**：“RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE” +**默认值**: “RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE” ## dcf_log_backup_file_count -**参数说明**：DCF运行日志备份保留个数。 +**参数说明**: DCF运行日志备份保留个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~100 +**取值范围**: 整型，1~100 -**默认值**：10 +**默认值**: 10 ## dcf_max_log_file_size -**参数说明**：DCF运行日志单个文件最大大小。 +**参数说明**: DCF运行日志单个文件最大大小。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，1~1000 +**取值范围**: 整型，单位MB，1~1000 -**默认值**：10 +**默认值**: 10 ## dcf_socket_timeout -**参数说明**：DCF通信模块连接socket超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建链不成功，此时需要适当增大此值。 +**参数说明**: DCF通信模块连接socket超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建链不成功，此时需要适当增大此值。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位ms，10~600000 +**取值范围**: 整型，单位ms，10~600000 -**默认值**：5000 +**默认值**: 5000 ## dcf_connect_timeout -**参数说明**：DCF通信模块建立连接超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建链不成功，此时需要适当增大此值。 +**参数说明**: DCF通信模块建立连接超时时间，参数重启生效。对于网络环境比较差的环境，若配置很小的超时时间，可能会导致建链不成功，此时需要适当增大此值。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位ms，10~600000 +**取值范围**: 整型，单位ms，10~600000 -**默认值**：60000 +**默认值**: 60000 ## dcf_mec_fragment_size -**参数说明**：DCF通信模块fragment大小，参数重启生效。 +**参数说明**: DCF通信模块fragment大小，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位KB，32~10240 +**取值范围**: 整型，单位KB，32~10240 -**默认值**：64 +**默认值**: 64 ## dcf_stg_pool_max_size -**参数说明**：DCF存储模内存池最大值，参数重启生效。 +**参数说明**: DCF存储模内存池最大值，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，32~2147483647 +**取值范围**: 整型，单位MB，32~2147483647 -**默认值**：2048 +**默认值**: 2048 ## dcf_stg_pool_init_size -**参数说明**：DCF存储模块内存池最小值，参数重启生效。 +**参数说明**: DCF存储模块内存池最小值，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，32~2147483647 +**取值范围**: 整型，单位MB，32~2147483647 -**默认值**：32 +**默认值**: 32 ## dcf_mec_pool_max_size -**参数说明**：DCF通信模块内存池最大值，参数重启生效。 +**参数说明**: DCF通信模块内存池最大值，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，32~2147483647 +**取值范围**: 整型，单位MB，32~2147483647 -**默认值**：200 +**默认值**: 200 ## dcf_flow_control_disk_rawait_threshold -**参数说明**：DCF流控功能的磁盘等待阈值。 +**参数说明**: DCF流控功能的磁盘等待阈值。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位us，0~2147483647 +**取值范围**: 整型，单位us，0~2147483647 -**默认值**：100000 +**默认值**: 100000 ## dcf_flow_control_net_queue_message_num_threshold -**参数说明**：DCF流控功能的网络队列消息数阈值。 +**参数说明**: DCF流控功能的网络队列消息数阈值。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~2147483647 +**取值范围**: 整型，0~2147483647 -**默认值**：1024 +**默认值**: 1024 ## dcf_flow_control_cpu_threshold -**参数说明**：DCF CPU流控阈值。 +**参数说明**: DCF CPU流控阈值。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位百分比，0~2147483647 +**取值范围**: 整型，单位百分比，0~2147483647 -**默认值**：100 +**默认值**: 100 ## dcf_mec_batch_size -**参数说明**：DCF通信批量消息数，数值为0时，DCF会根据网络以及写入数据量自适应调整，参数重启生效。 +**参数说明**: DCF通信批量消息数，数值为0时，DCF会根据网络以及写入数据量自适应调整，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1024 +**取值范围**: 整型，0~1024 -**默认值**：0 +**默认值**: 0 ## dcf_mem_pool_max_size -**参数说明**：DCF内存最大值，参数重启生效。 +**参数说明**: DCF内存最大值，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，32~2147483647 +**取值范围**: 整型，单位MB，32~2147483647 -**默认值**：2048 +**默认值**: 2048 ## dcf_mem_pool_init_size -**参数说明**：DCF内存初始化大小，参数重启生效。 +**参数说明**: DCF内存初始化大小，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位MB，32~2147483647 +**取值范围**: 整型，单位MB，32~2147483647 -**默认值**：32 +**默认值**: 32 ## dcf_compress_algorithm -**参数说明**：DCF运行日志传输压缩算法，参数重启生效。 +**参数说明**: DCF运行日志传输压缩算法，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型 +**取值范围**: 整型 - 0表示不压缩 - 1表示ZSTD压缩算法 - 2表示LZ4压缩算法 -**默认值**：0 +**默认值**: 0 ## dcf_compress_level -**参数说明**：DCF日志传输压缩级别，参数重启生效，此参数生效前提必须配置有效的压缩算法，即设置合法的dcf_compress_algorithm参数。 +**参数说明**: DCF日志传输压缩级别，参数重启生效，此参数生效前提必须配置有效的压缩算法，即设置合法的dcf_compress_algorithm参数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~22 +**取值范围**: 整型，1~22 若不开启压缩，配置的压缩级别将不生效。 -**默认值**：1 +**默认值**: 1 ## dcf_mec_channel_num -**参数说明**：DCF通信通道数量，参数重启生效。 +**参数说明**: DCF通信通道数量，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~64 +**取值范围**: 整型，1~64 -**默认值**：1 +**默认值**: 1 ## dcf_rep_append_thread_num -**参数说明**：DCF日志复制线程数量，参数重启生效。 +**参数说明**: DCF日志复制线程数量，参数重启生效。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~1000 +**取值范围**: 整型，1~1000 -**默认值**：2 +**默认值**: 2 ## dcf_mec_agent_thread_num -**参数说明**：DCF通信工作线程数量，参数重启生效。dcf_mec_agent_thread_num值建议不少于2\*节点数\*dcf_mec_channel_num。 +**参数说明**: DCF通信工作线程数量，参数重启生效。dcf_mec_agent_thread_num值建议不少于2\*节点数\*dcf_mec_channel_num。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~1000 +**取值范围**: 整型，1~1000 -**默认值**：10 +**默认值**: 10 ## dcf_mec_reactor_thread_num -**参数说明**：DCF使用reactor线程数量，参数重启生效。dcf_mec_reactor_thread_num与dcf_mec_agent_thread_num比例建议1：40。 +**参数说明**: DCF使用reactor线程数量，参数重启生效。dcf_mec_reactor_thread_num与dcf_mec_agent_thread_num比例建议1：40。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~100 +**取值范围**: 整型，1~100 -**默认值**：1 +**默认值**: 1 ## dcf_log_file_permission -**参数说明**：DCF运行日志文件属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志，首先需要所有的父目录都支持同组的其他用户也能访问。即若参数dcf_log_path_permission配置为750，dcf_log_file_permission只能为600或者640。若参数dcf_log_path_permission配置为700，dcf_log_file_permission只能为600。 +**参数说明**: DCF运行日志文件属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志，首先需要所有的父目录都支持同组的其他用户也能访问。即若参数dcf_log_path_permission配置为750，dcf_log_file_permission只能为600或者640。若参数dcf_log_path_permission配置为700，dcf_log_file_permission只能为600。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，600、640 +**取值范围**: 枚举型，600、640 -**默认值**：600 +**默认值**: 600 ## dcf_log_path_permission -**参数说明**：DCF运行日志目录属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志路径，需选择参数750，否则选择700。 +**参数说明**: DCF运行日志目录属性，参数重启生效，参数安装阶段配置，后续不支持修改。若用户需要支持同组的其他用户访问日志路径，需选择参数750，否则选择700。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，700、750 +**取值范围**: 枚举型，700、750 -**默认值**：700 +**默认值**: 700 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/37-flashback.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/37-flashback.md index 7bae24f1..fc62c942 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/37-flashback.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/37-flashback.md @@ -11,13 +11,13 @@ date: 2021-11-08 ## enable_recyclebin -**参数说明**：用来控制回收站的实时打开和关闭。 +**参数说明**: 用来控制回收站的实时打开和关闭。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：off +**默认值**: off ## recyclebin_retention_time @@ -31,34 +31,34 @@ date: 2021-11-08 ## version_retention_age -**参数说明**：设置旧版本保留的事务数，超过该事务数的旧版本将被回收清理。 +**参数说明**: 设置旧版本保留的事务数，超过该事务数的旧版本将被回收清理。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～576460752303423487，值为0表示不延迟。 +**取值范围**: 整型，0～576460752303423487，值为0表示不延迟。 -**默认值**：0 +**默认值**: 0 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 该参数已弃用。 ## vacuum_defer_cleanup_age -**参数说明**：指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。也可以通过设置该参数，配置闪回功能旧版本保留期限。 +**参数说明**: 指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。也可以通过设置该参数，配置闪回功能旧版本保留期限。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～1000000，值为0表示不延迟。取值范围需要扩展到1亿。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。取值范围需要扩展到1亿。 -**默认值**：0 +**默认值**: 0 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 在进行Ustore闪回时，无需关注该参数。其服务于之前版本的astore闪回功能，同时具有其他用途。本版本闪回功能已不使用。 ## undo_retention_time -**参数说明**：设置undo旧版本保留时间。 +**参数说明**: 设置undo旧版本保留时间。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，单位为s，最小值为0，最大值为2147483647。 +**取值范围**: 整型，单位为s，最小值为0，最大值为2147483647。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/38-rollback-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/38-rollback-parameters.md index bc7109fc..9769c979 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/38-rollback-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/38-rollback-parameters.md @@ -9,10 +9,10 @@ date: 2021-11-08 ## max_undo_workers -**参数说明**：异步回滚调用的undoworker线程数量，参数重启生效。 +**参数说明**: 异步回滚调用的undoworker线程数量，参数重启生效。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~100 +**取值范围**: 整型，1~100 -**默认值**：5 +**默认值**: 5 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/39-reserved-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/39-reserved-parameters.md index 998a8158..1cb16a5b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/39-reserved-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/39-reserved-parameters.md @@ -7,7 +7,7 @@ date: 2021-11-08 # 预留参数 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 下列参数为预留参数，该版本不生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 下列参数为预留参数，该版本不生效。 acce_min_datasize_per_thread @@ -27,4 +27,4 @@ backend_version undo_zone_count -version_retention_age \ No newline at end of file +version_retention_age diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md index d78996ca..20446f7b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/1-memory.md @@ -9,60 +9,60 @@ date: 2021-04-20 介绍与内存相关的参数设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**这些参数只能在数据库服务重新启动后生效。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:这些参数只能在数据库服务重新启动后生效。 ## memorypool_enable -**参数说明**：设置是否允许使用内存池。 +**参数说明**: 设置是否允许使用内存池。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许使用内存池。 - off表示不允许使用内存池。 -**默认值**：off +**默认值**: off ## memorypool_size -**参数说明**：设置内存池大小。 +**参数说明**: 设置内存池大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，128*1024～INT_MAX/2，单位为KB。 +**取值范围**: 整型，128*1024～INT_MAX/2，单位为KB。 -**默认值**：512MB +**默认值**: 512MB ## enable_memory_limit -**参数说明**：启用逻辑内存管理模块。 +**参数说明**: 启用逻辑内存管理模块。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启用逻辑内存管理模块。 - off表示不启用逻辑内存管理模块。 -**默认值**：on +**默认值**: on -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 若max_process_memory-shared_buffers-cstore_buffers-元数据少于2G，MogDB强制把enable_memory_limit设置为off。其中元数据是MogDB内部使用的内存和部分并发参数，如max_connections、thread_pool_attr、max_prepared_transactions等参数相关。 > - 当该值为off时，不对数据库使用的内存做限制，在大并发或者复杂查询时，使用内存过多，可能导致操作系统OOM问题。 ## max_process_memory -**参数说明**：设置一个数据库节点可用的最大物理内存。 +**参数说明**: 设置一个数据库节点可用的最大物理内存。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型 , `2*1024*1024` ～ INT_MAX，单位为KB。 +**取值范围**: 整型 , `2*1024*1024` ～ INT_MAX，单位为KB。 -**默认值**：12GB。 +**默认值**: 12GB。 -**设置建议：** +**设置建议**: 数据库节点上该数值需要根据系统物理内存及单节点部署主数据库节点个数决定。建议计算公式如下：`(物理内存大小 - vm.min_free_kbytes) * 0.7 / (1 + 主节点个数)`。该系数的目的是尽可能保证系统的可靠性，不会因数据库内存膨胀导致节点OOM。这个公式中提到vm.min_free_kbytes，其含义是预留操作系统内存供内核使用，通常用作操作系统内核中通信收发内存分配，至少为5%内存。即，max_process_memory = `物理内存 * 0.665 / (1 + 主节点个数)`。 @@ -70,42 +70,42 @@ date: 2021-04-20 ## enable_memory_context_control -**参数说明**：启用检查内存上下文是否超过给定限制的功能。仅适用于DEBUG版本。 +**参数说明**: 启用检查内存上下文是否超过给定限制的功能。仅适用于DEBUG版本。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启用最大内存上下文限制检查功能。 - off表示关闭最大内存上下文限制检查功能。 -**默认值**：off +**默认值**: off ## uncontrolled_memory_context -**参数说明**：启用检查内存上下文是否超过给定限制的功能时，设置不受此功能约束。仅适用于DEBUG版本。 +**参数说明**: 启用检查内存上下文是否超过给定限制的功能时，设置不受此功能约束。仅适用于DEBUG版本。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 查询时会在参数值的最前面添加标题含义字符串“MemoryContext white list:”。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## shared_buffers -**参数说明**：设置MogDB使用的共享内存大小。增加此参数的值会使MogDB比系统默认设置需要更多的System V共享内存。 +**参数说明**: 设置MogDB使用的共享内存大小。增加此参数的值会使MogDB比系统默认设置需要更多的System V共享内存。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，16 ~ 1073741823 ，单位为KB。 +**取值范围**: 整型，16 ~ 1073741823 ，单位为KB。 shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即shared_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 -**默认值**：8MB +**默认值**: 8MB -**设置建议：** +**设置建议**: 建议设置shared_buffers值为内存的40%以内。行存列存分开对待。行存设大，列存设小。列存：`(单服务器内存/单服务器数据库节点个数) * 0.4 * 0.25`。 @@ -113,7 +113,7 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 ## segment_buffers -**参数说明**：设置MogDB段页式元数据页的内存大小。 +**参数说明**: 设置MogDB段页式元数据页的内存大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -121,37 +121,37 @@ shared_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即 segment_buffers需要设置为BLCKSZ的整数倍，BLCKSZ目前设置为8KB，即segment_buffers需要设置为8KB整数倍。改变BLCKSZ的值会改变最小值。 -**默认值**：8MB +**默认值**: 8MB -**设置建议：** +**设置建议**: segment_buffers 用来缓存段页式段头的内容，属于关键元数据信息，为了提高性能建议常用的表的段头都能缓存在buffer中，不被置换出去。建议按照`表的个数（包括索引和toast表）* 分区数 * 3 + 128` 来设置。乘以3是因为每个表（分区）会有一些额外的元数据段，一般一个表有3个段。最后+128因为段页式表空间管理需要一定数量的buffer。 ## bulk_write_ring_size -**参数说明**：大批量数据写入触发时（例如copy动作），该操作使用的环形缓冲区大小。 +**参数说明**: 大批量数据写入触发时（例如copy动作），该操作使用的环形缓冲区大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，16384 ~ 2147483647，单位为KB。 +**取值范围**: 整型，16384 ~ 2147483647，单位为KB。 -**默认值**：2GB +**默认值**: 2GB -**设置建议：**建议导入压力大的场景中增加数据库节点中此参数配置。 +**设置建议**:建议导入压力大的场景中增加数据库节点中此参数配置。 ## standby_shared_buffers_fraction -**参数说明**：备实例所在服务器使用shared_buffers内存缓冲区大小的比例。 +**参数说明**: 备实例所在服务器使用shared_buffers内存缓冲区大小的比例。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度类型，0.1~1.0 +**取值范围**: 双精度类型，0.1~1.0 -**默认值**：0.3 +**默认值**: 0.3 ## temp_buffers -**参数说明**：设置每个数据库会话使用的LOCAL临时缓冲区的大小。 +**参数说明**: 设置每个数据库会话使用的LOCAL临时缓冲区的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -159,37 +159,37 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 一个会话将按照temp_buffers给出的限制，根据需要分配临时缓冲区。如果在一个并不需要大量临时缓冲区的会话里设置一个大的数值，其开销只是一个缓冲区描述符的大小。当缓冲区被使用，就会额外消耗8192字节。 -**取值范围**：整型，100~1073741823，单位为8KB。 +**取值范围**: 整型，100~1073741823，单位为8KB。 -**默认值**：1MB +**默认值**: 1MB ## max_prepared_transactions -**参数说明**：设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使MogDB比系统默认设置需要更多的System V共享内存。 +**参数说明**: 设置可以同时处于"预备"状态的事务的最大数目。增加此参数的值会使MogDB比系统默认设置需要更多的System V共享内存。 当MogDB部署为主备双机时，在备机上此参数的设置必须要高于或等于主机上的，否则无法在备机上进行查询操作。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型。0~262143。 +**取值范围**: 整型。0~262143。 -**默认值**：10 +**默认值**: 10 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 一般不需要对事务显式进行PREPARE操作，如果业务对事务进行显示PREPARE操作，为避免在准备步骤失败，需要调大该值，大于需要进行PREPARE业务的并发数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 一般不需要对事务显式进行PREPARE操作，如果业务对事务进行显示PREPARE操作，为避免在准备步骤失败，需要调大该值，大于需要进行PREPARE业务的并发数。 ## work_mem -**参数说明**： 设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 +**参数说明**: 设置内部排序操作和Hash表在开始写入临时磁盘文件之前使用的内存大小。ORDER BY，DISTINCT和merge joins都要用到排序操作。Hash表在散列连接、散列为基础的聚集、散列为基础的IN子查询处理中都要用到。 对于复杂的查询，可能会同时并发运行好几个排序或者散列操作，每个都可以使用此参数所声明的内存量，不足时会使用临时文件。同样，好几个正在运行的会话可能会同时进行排序操作。因此使用的总内存可能是work_mem的好几倍。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 整型，64~2147483647，单位为KB。 +**取值范围**: 整型，64~2147483647，单位为KB。 -**默认值**：64MB +**默认值**: 64MB -**设置建议：** +**设置建议**: > 依据查询特点和并发来确定，一旦work_mem限定的物理内存不够，算子运算数据将写入临时表空间，带来5-10倍的性能下降，查询响应时间从秒级下降到分钟级。 > @@ -200,45 +200,45 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 ## query_mem -**参数说明**：设置执行作业所使用的内存。 +**参数说明**: 设置执行作业所使用的内存。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**： 0，或大于32M的整型，默认单位为KB。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果设置的query_mem值大于0，在生成执行计划时，优化器会将作业的估算内存调整为该值。 > - 如果设置值为负数或小于32MB，将设置为默认值0，此时优化器不会根据该值调整作业的估算内存。 ## query_max_mem -**参数说明**：设置执行作业所能够使用的最大内存。 +**参数说明**: 设置执行作业所能够使用的最大内存。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：0，或大于32M的整型，默认单位为KB。 +**取值范围**: 0，或大于32M的整型，默认单位为KB。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果设置的query_max_mem值大于0，当作业执行时所使用内存超过该值时，将报错退出。 > - 如果设置值为负数或小于32M，将设置为默认值0，此时不会根据该值限制作业的内存使用。 ## maintenance_work_mem -**参数说明**：设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 +**参数说明**: 设置在维护性操作（比如VACUUM、CREATE INDEX、ALTER TABLE ADD FOREIGN KEY等）中可使用的最大的内存。该参数的设置会影响VACUUM、VACUUM FULL、CLUSTER、CREATE INDEX的执行效率。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024~INT_MAX，单位为KB。 +**取值范围**: 整型，1024~INT_MAX，单位为KB。 -**默认值**：16MB +**默认值**: 16MB -**设置建议：** +**设置建议**: - 建议设置此参数的值大于work_mem，可以改进清理和恢复数据库转储的速度。因为在一个数据库会话里，任意时刻只有一个维护性操作可以执行，并且在执行维护性操作时不会有太多的会话。 - 当[自动清理](14-automatic-vacuuming)线程运行时，autovacuum_max_workers倍数的内存将会被分配，所以此时设置maintenance_work_mem的值应该不小于work_mem。 @@ -246,37 +246,37 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 ## psort_work_mem -**参数说明**：设置列存表在进行局部排序中，在开始写入临时磁盘文件之前使用的内存大小。带partial cluster key的表、带索引的表插入、创建表索引、删除表和更新表都会用到。 +**参数说明**: 设置列存表在进行局部排序中，在开始写入临时磁盘文件之前使用的内存大小。带partial cluster key的表、带索引的表插入、创建表索引、删除表和更新表都会用到。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**同样，多个正在运行的会话可能会同时进行表的局部排序操作。因此，使用的总内存可能是psort_work_mem的几倍。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:同样，多个正在运行的会话可能会同时进行表的局部排序操作。因此，使用的总内存可能是psort_work_mem的几倍。 -**取值范围**：整型64~2147483647，单位为KB。 +**取值范围**: 整型64~2147483647，单位为KB。 -**默认值**：512MB +**默认值**: 512MB ## max_loaded_cudesc -**参数说明**：设置列存表在做扫描时，每列缓存cudesc信息的个数。增大设置会提高查询性能，但也会增加内存占用，特别是当列存表的列非常多时。 +**参数说明**: 设置列存表在做扫描时，每列缓存cudesc信息的个数。增大设置会提高查询性能，但也会增加内存占用，特别是当列存表的列非常多时。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：**max_loaded_cudesc设置过高时，有可能引起内存分配不足。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**:max_loaded_cudesc设置过高时，有可能引起内存分配不足。 -**取值范围**：100~1073741823。 +**取值范围**: 100~1073741823。 -**默认值**：1024 +**默认值**: 1024 ## max_stack_depth -**参数说明**：设置MogDB执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 +**参数说明**: 设置MogDB执行堆栈的最大安全深度。需要这个安全界限是因为在服务器里，并非所有程序都检查了堆栈深度，只是在可能递规的过程，比如表达式计算这样的过程里面才进行检查。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，100~INT_MAX，单位为KB。 +**取值范围**: 整型，100~INT_MAX，单位为KB。 -**默认值**：2MB +**默认值**: 2MB **设置原则**： @@ -287,13 +287,13 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 ## cstore_buffers -**参数说明**：设置列存所使用的共享缓冲区的大小。 +**参数说明**: 设置列存所使用的共享缓冲区的大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，16384～1073741823，单位为KB。 +**取值范围**: 整型，16384～1073741823，单位为KB。 -**默认值**：1GB +**默认值**: 1GB **设置建议**： @@ -301,30 +301,30 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 ## bulk_read_ring_size -**参数说明**：大批量数据查询时（例如大表扫描），该操作使用的环形缓冲区大小。 +**参数说明**: 大批量数据查询时（例如大表扫描），该操作使用的环形缓冲区大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，256~2147483647，单位为KB。 +**取值范围**: 整型，256~2147483647，单位为KB。 -**默认值**：16MB +**默认值**: 16MB ## enable_early_free -**参数说明**：控制是否可以实现算子内存的提前释放。 +**参数说明**: 控制是否可以实现算子内存的提前释放。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示支持算子内存提前释放。 - off表示不支持算子内存提前释放。 -**默认值**：on +**默认值**: on ## local_syscache_threshold -**参数说明**：系统表cache在单个session缓存的大小。 +**参数说明**: 系统表cache在单个session缓存的大小。 该参数属于PG_SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -332,6 +332,6 @@ segment_buffers 用来缓存段页式段头的内容，属于关键元数据信 如果enable_global_plancache和enable_thread_pool打开，该参数描述的是当前线程和绑定到当前线程上的session缓存的总大小。 -**取值范围**：整型，1\*1024 ~ 512\*1024，单位KB。 +**取值范围**: 整型，1\*1024 ~ 512\*1024，单位KB。 -**默认值**：on +**默认值**: on diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md index 447786b9..4cfc606b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/2-disk-space.md @@ -11,17 +11,17 @@ date: 2021-04-20 ## sql_use_spacelimit -**参数说明**：限制单个SQL在单个数据库节点上，触发落盘操作时，落盘文件的空间大小，管控的空间包括普通表、临时表以及中间结果集落盘占用的空间。 +**参数说明**: 限制单个SQL在单个数据库节点上，触发落盘操作时，落盘文件的空间大小，管控的空间包括普通表、临时表以及中间结果集落盘占用的空间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置 -**取值范围**：整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 -**默认值**：-1 +**默认值**: -1 ## temp_file_limit -**参数说明**：限制一个会话中，触发下盘操作时，单个下盘文件的空间大小。例如一次会话中，排序和哈希表使用的临时文件，或者游标占用的临时文件。 +**参数说明**: 限制一个会话中，触发下盘操作时，单个下盘文件的空间大小。例如一次会话中，排序和哈希表使用的临时文件，或者游标占用的临时文件。 此设置为会话级别的下盘文件控制。 @@ -30,6 +30,6 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > SQL查询执行时使用的临时表空间不在此限制。 -**取值范围**：整型，-1~2147483647，单位为KB。其中-1表示没有限制。 +**取值范围**: 整型，-1~2147483647，单位为KB。其中-1表示没有限制。 -**默认值**：-1 +**默认值**: -1 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md index 325eb638..9e559670 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/3-kernel-resource-usage.md @@ -11,19 +11,19 @@ date: 2021-04-20 ## max_files_per_process -**参数说明**：设置每个服务器进程允许同时打开的最大文件数目。如果操作系统内核强制一个合理的数目，则不需要设置。 +**参数说明**: 设置每个服务器进程允许同时打开的最大文件数目。如果操作系统内核强制一个合理的数目，则不需要设置。 但是在一些平台上（特别是大多数BSD系统），内核允许独立进程打开比系统真正可以支持的数目大得多的文件数。如果用户发现有的"Too many open files"这样的失败现象，请尝试缩小这个设置。通常情况下需要满足，系统FD（file descriptor）数量>=`最大并发数*数据库节点个数*max_files_per_process*3`。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，25~2147483647。 +**取值范围**: 整型，25~2147483647。 -**默认值**：1000 +**默认值**: 1000 ## shared_preload_libraries -**参数说明**：此参数用于声明一个或者多个在服务器启动的时候预先装载的共享库，多个库名称之间用逗号分隔。比如 '$libdir/mylib' 会在加载标准库目录中的库文件之前预先加载mylib.so（某些平台上可能是mylib.sl）库文件。 +**参数说明**: 此参数用于声明一个或者多个在服务器启动的时候预先装载的共享库，多个库名称之间用逗号分隔。比如 '$libdir/mylib' 会在加载标准库目录中的库文件之前预先加载mylib.so（某些平台上可能是mylib.sl）库文件。 可以用这个方法预先装载MogDB的存储过程库，通常是使用 '$libdir/plXXX' 语法。XXX只能是pgsql，perl，tcl，python之一。 @@ -36,6 +36,6 @@ date: 2021-04-20 > - 如果被声明的库不存在，MogDB服务将会启动失败。 > - 每一个支持MogDB的库都有一个特殊的标记用于保证兼容性。因此，不支持MogDB的库不能用这种方法加载。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md index d3edd1d3..382d40b2 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/4-cost-based-vacuum-delay.md @@ -23,7 +23,7 @@ date: 2021-04-20 ## vacuum_cost_delay -**参数说明**：指定开销超过vacuum_cost_limit的值时，进程睡眠的时间。 +**参数说明**: 指定开销超过vacuum_cost_limit的值时，进程睡眠的时间。 要注意在许多系统上，睡眠的有效分辨率是10毫秒。因此把vacuum_cost_delay设置为一个不是10的整数倍的数值与将它设置为下一个10的整数倍作用相同。 @@ -31,46 +31,46 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 +**取值范围**: 整型，0~100，正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 -**默认值**：0 +**默认值**: 0 ## vacuum_cost_page_hit -**参数说明**：清理一个在共享缓存里找到的缓冲区的预计开销。它代表锁住缓冲池、查找共享的Hash表、扫描页面内容的开销。 +**参数说明**: 清理一个在共享缓存里找到的缓冲区的预计开销。它代表锁住缓冲池、查找共享的Hash表、扫描页面内容的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~10000。 +**取值范围**: 整型，0~10000。 -**默认值**：1 +**默认值**: 1 ## vacuum_cost_page_miss -**参数说明**：清理一个要从磁盘上读取的缓冲区的预计开销。它代表锁住缓冲池、查找共享Hash表、从磁盘读取需要的数据块、扫描它的内容的开销。 +**参数说明**: 清理一个要从磁盘上读取的缓冲区的预计开销。它代表锁住缓冲池、查找共享Hash表、从磁盘读取需要的数据块、扫描它的内容的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~10000。 +**取值范围**: 整型，0~10000。 -**默认值**：10 +**默认值**: 10 ## vacuum_cost_page_dirty -**参数说明**：清理修改一个原先是干净的块的预计开销。它代表把一个脏的磁盘块再次刷新到磁盘上的额外开销。 +**参数说明**: 清理修改一个原先是干净的块的预计开销。它代表把一个脏的磁盘块再次刷新到磁盘上的额外开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1000 +**取值范围**: 整型，0~1000 -**默认值**：20 +**默认值**: 20 ## vacuum_cost_limit -**参数说明**：设置清理进程休眠的开销限制。 +**参数说明**: 设置清理进程休眠的开销限制。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~10000。 +**取值范围**: 整型，1~10000。 -**默认值**：200 +**默认值**: 200 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md index ea47e085..23827b68 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/5-background-writer.md @@ -13,58 +13,58 @@ date: 2021-04-20 ## bgwriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，将可以淘汰的脏页刷盘，不脏的页面放入到候选buffer链，设置此选项有助于加快buffer淘汰速度，提升性能。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～8 +**取值范围**: 整型，0～8 - 开发期间为测试关闭该特性的效果，可以设置为0，但是当前如果设置为0，会在代码中修正为1，不再支持关闭该特性。 - 当参数设置为1~8时，表示会启动相对应数量的background线程，用于维护候选buffer链，将满足条件的脏页刷盘，不脏的页放入到候选list中。 -**默认值**：2 +**默认值**: 2 ## bgwriter_delay -**参数说明**：设置后端写进程写“脏”共享缓冲区之间的时间间隔。每一次，后端写进程都会为一些脏的缓冲区发出写操作（用bgwriter_lru_maxpages参数控制每次写的量），然后休眠bgwriter_delay毫秒后才再次启动。 +**参数说明**: 设置后端写进程写“脏”共享缓冲区之间的时间间隔。每一次，后端写进程都会为一些脏的缓冲区发出写操作（用bgwriter_lru_maxpages参数控制每次写的量），然后休眠bgwriter_delay毫秒后才再次启动。 在许多系统上，休眠延时的有效分辨率是10毫秒。因此，设置一个不是10的倍数的数值与把它设置为下一个10的倍数是一样的效果。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，10~10000，单位为毫秒。 +**取值范围**: 整型，10~10000，单位为毫秒。 -**默认值**：2s +**默认值**: 2s **设置建议**：在数据写压力比较大的场景中可以尝试减小该值以降低checkpoint的压力。 ## candidate_buf_percent_target -**参数说明**：设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 +**参数说明**: 设置用于增量检查点打开时，候选buffer链中可用buffer数目占据shared_buffer内存缓冲区百分比的期望值，当前候选链中的数目少于目标值时，bgwriter线程会启动将满足条件的脏页刷盘。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度浮点类型，0.1～0.85 +**取值范围**: 双精度浮点类型，0.1～0.85 -**默认值**：0.3 +**默认值**: 0.3 ## bgwriter_lru_maxpages -**参数说明**：设置后端写进程每次可写入磁盘的"脏"缓存区的个数。 +**参数说明**: 设置后端写进程每次可写入磁盘的"脏"缓存区的个数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～1000 +**取值范围**: 整型，0～1000 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > > 此参数设置为0表示禁用后端写功能，禁用后端写功能不会对checkpoints产生影响。 -**默认值**：100 +**默认值**: 100 ## bgwriter_lru_multiplier -**参数说明**：通过与已使用缓存区数目的乘积评估下次服务器需要的缓存区数目。 +**参数说明**: 通过与已使用缓存区数目的乘积评估下次服务器需要的缓存区数目。 写“脏”缓存区到磁盘的数目取决于服务器最近几次使用的缓存区数目。最近的buffers数目的平均值乘以bgwriter_lru_multiplier是为了评估下次服务器进程需要的buffers数目。在有足够多的干净的、可用的缓存区之前，后端写进程会一直写“脏”缓存区的（每次写的缓存区数目不会超过bgwriter_lru_maxpages的值）。 @@ -74,79 +74,79 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0~10。 +**取值范围**: 浮点型，0~10。 -**默认值**：2 +**默认值**: 2 ## pagewriter_thread_num -**参数说明**：设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 +**参数说明**: 设置用于增量检查点打开后后台刷页的线程数，主要是按照脏页置脏的顺序刷盘，用于推进recovery点。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～16 +**取值范围**: 整型，1～16 -**默认值**：4 +**默认值**: 4 ## dirty_page_percent_max -**参数说明**：设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 +**参数说明**: 设置用于增量检查点打开后脏页数量占shared_buffers的百分比。达到这个设定值时，后台刷页线程将以设置的max_io_capacity计算出的最大值刷脏页。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.1～1 +**取值范围**: 浮点型，0.1～1 -**默认值**：0.9 +**默认值**: 0.9 ## pagewriter_sleep -**参数说明**：设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 +**参数说明**: 设置用于增量检查点打开后，pagewrite线程每隔pagewriter_sleep的时间刷一批脏页下盘。当脏页占据shared_buffers的比例达到dirty_page_percent_max时，每批页面数量以设定的max_io_capacity计算出的值刷页，其余情况每批页面数量按比例相对减少。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～3600000（毫秒） +**取值范围**: 整型，0～3600000（毫秒） -**默认值**：2000ms +**默认值**: 2000ms ## max_io_capacity -**参数说明**：设置后端写进程批量刷页每秒的IO上限，需要根据具体业务场景和机器磁盘IO能力进行设置。要求RTO很短时间或者数据量比共享内存大多倍的情况，业务访问数据量又是随机访问时，该值不宜过小。该参数设置较小会减小后端写进程刷页个数，如果业务触发页面淘汰多时，该值设置小会影响业务。 +**参数说明**: 设置后端写进程批量刷页每秒的IO上限，需要根据具体业务场景和机器磁盘IO能力进行设置。要求RTO很短时间或者数据量比共享内存大多倍的情况，业务访问数据量又是随机访问时，该值不宜过小。该参数设置较小会减小后端写进程刷页个数，如果业务触发页面淘汰多时，该值设置小会影响业务。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，30720~10485760。单位是KB。 +**取值范围**: 整型，30720~10485760。单位是KB。 -**默认值**：512000KB（500MB） +**默认值**: 512000KB（500MB） ## enable_consider_usecount -**参数说明**：设置backend线程在页面置换时是否考虑页面热度，建议大容量场景下开启此参数。 +**参数说明**: 设置backend线程在页面置换时是否考虑页面热度，建议大容量场景下开启此参数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示考虑页面热度。 - off/false表示不考虑页面热度。 -**默认值**：off +**默认值**: off ## dw_file_num -**参数说明**：设置批量双写文件的数量，该值与pagewriter_thread_num有关，不会大于pagwriter_thread_num，如果设置过大，内部会纠正为pagewriter_thread_num。 +**参数说明**: 设置批量双写文件的数量，该值与pagewriter_thread_num有关，不会大于pagwriter_thread_num，如果设置过大，内部会纠正为pagewriter_thread_num。 该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～16 +**取值范围**: 整型，1～16 -**默认值**：1 +**默认值**: 1 ## dw_file_size -**参数说明**：设置每个批量双写文件的大小。 +**参数说明**: 设置每个批量双写文件的大小。 该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，32～256 +**取值范围**: 整型，32～256 -**默认值**：256 +**默认值**: 256 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md index fea278bf..ee5a32c3 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/4-resource-consumption/6-asynchronous-io-operations.md @@ -9,143 +9,143 @@ date: 2021-04-20 ## enable_adio_debug -**参数说明**：允许维护人员输出一些与ADIO相关的日志，便于定位ADIO相关问题。开发人员专用，不建议普通用户使用。 +**参数说明**: 允许维护人员输出一些与ADIO相关的日志，便于定位ADIO相关问题。开发人员专用，不建议普通用户使用。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启此日志开关。 - off/false表示关闭此日志开关。 -**默认值**：off +**默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前版本暂不支持打开该开关，即使用户手动设置为打开，系统内部也会自动设置为关闭状态。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前版本暂不支持打开该开关，即使用户手动设置为打开，系统内部也会自动设置为关闭状态。 ## enable_adio_function -**参数说明**：是否开启ADIO功能。 +**参数说明**: 是否开启ADIO功能。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前版本暂不支持开启异步IO功能，默认该功能关闭。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前版本暂不支持开启异步IO功能，默认该功能关闭。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值**：off +**默认值**: off ## enable_fast_allocate -**参数说明**：磁盘空间快速分配开关。 +**参数说明**: 磁盘空间快速分配开关。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。只有在XFS文件系统上才能开启该开关。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示开启此功能。 - off/false表示关闭此功能。 -**默认值**：off +**默认值**: off ## prefetch_quantity -**参数说明**：描述行存储使用ADIO预读取IO量的大小。 +**参数说明**: 描述行存储使用ADIO预读取IO量的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值**：32MB (4096 * 8KB) +**默认值**: 32MB (4096 * 8KB) ## backwrite_quantity -**参数说明**：描述行存储使用ADIO写入IO量的大小。 +**参数说明**: 描述行存储使用ADIO写入IO量的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，128～131072，单位为8KB。 +**取值范围**: 整型，128～131072，单位为8KB。 -**默认值**：8MB (1024 * 8KB) +**默认值**: 8MB (1024 * 8KB) ## cstore_prefetch_quantity -**参数说明**：描述列存储使用ADIO预取IO量的大小。 +**参数说明**: 描述列存储使用ADIO预取IO量的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值**：32MB +**默认值**: 32MB ## cstore_backwrite_quantity -**参数说明**：描述列存储使用ADIO写入IO量的大小。 +**参数说明**: 描述列存储使用ADIO写入IO量的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值**：8MB +**默认值**: 8MB ## cstore_backwrite_max_threshold -**参数说明**：描述列存储使用ADIO写入数据库可缓存最大的IO量。 +**参数说明**: 描述列存储使用ADIO写入数据库可缓存最大的IO量。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，4096～INT_MAX/2，单位为KB。 +**取值范围**: 整型，4096～INT_MAX/2，单位为KB。 -**默认值**：2GB +**默认值**: 2GB ## fast_extend_file_size -**参数说明**：描述列存储使用ADIO预扩展磁盘的大小。 +**参数说明**: 描述列存储使用ADIO预扩展磁盘的大小。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1024～1048576，单位为KB。 +**取值范围**: 整型，1024～1048576，单位为KB。 -**默认值**：8MB +**默认值**: 8MB ## effective_io_concurrency -**参数说明**：磁盘子系统可以同时有效处理的请求数。对于RAID阵列，此参数应该是阵列中驱动器主轴的数量。 +**参数说明**: 磁盘子系统可以同时有效处理的请求数。对于RAID阵列，此参数应该是阵列中驱动器主轴的数量。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型 ，0~1000 +**取值范围**: 整型 ，0~1000 -**默认值**：1 +**默认值**: 1 ## checkpoint_flush_after -**参数说明**：设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置checkpointer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能）。例如，取值32，表示checkpointer线程连续写32个磁盘页，即32*8=256KB磁盘空间后会进行异步刷盘。 -**默认值**：32 +**默认值**: 32 ## bgwriter_flush_after -**参数说明**：设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置background writer线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示background writer线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：512KB（即64个页面） +**默认值**: 512KB（即64个页面） ## backend_flush_after -**参数说明**：设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 +**参数说明**: 设置backend线程刷页个数超过设定的阈值时，告知操作系统开始将操作系统缓存中的页面异步刷盘。MogDB中，磁盘页大小为8KB。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 +**取值范围**: 整型，0~256（0表示关闭异步刷盘功能），单位页面（8KB）。例如，取值64，表示backend线程连续写64个磁盘页，即64*8=512KB磁盘空间后会进行异步刷盘。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/40-AI-features.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/40-AI-features.md index 371b8868..8571058b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/40-AI-features.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/40-AI-features.md @@ -9,56 +9,56 @@ date: 2021-11-08 ## enable_hypo_index -**参数说明**：该参数控制数据库的优化器进行EXPLAIN时是否考虑创建虚拟索引。通过对特定的查询语句执行explain，用户可根据优化器给出的执行计划评估该索引是否能够提升该查询语句的执行效率。 +**参数说明**: 该参数控制数据库的优化器进行EXPLAIN时是否考虑创建虚拟索引。通过对特定的查询语句执行explain，用户可根据优化器给出的执行计划评估该索引是否能够提升该查询语句的执行效率。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在进行EXPLAIN时创建虚拟索引。 - off表示在进行EXPLAIN时不创建虚拟索引。 -**默认值**：off +**默认值**: off ## db4ai_snapshot_mode -**参数说明**：snapshot有2种模式：MSS（物化模式，存储数据实体）和CSS（计算模式，存储增量信息）。 +**参数说明**: snapshot有2种模式：MSS（物化模式，存储数据实体）和CSS（计算模式，存储增量信息）。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，MSS/CSS +**取值范围**: 字符串，MSS/CSS - MSS表示物化模式，db4ai在创建快照的时候存储数据实体。 - CSS表示计算模式，db4ai在创建快照的时候存储增量信息。 -**默认值**：MSS +**默认值**: MSS ## db4ai_snapshot_version_delimiter -**参数说明**：该参数为数据表快照版本分隔符。 +**参数说明**: 该参数为数据表快照版本分隔符。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值**：@ +**默认值**: @ ## db4ai_snapshot_version_separator -**参数说明**：该参数用于指定数据表快照子版本分隔符。 +**参数说明**: 该参数用于指定数据表快照子版本分隔符。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0 +**取值范围**: 字符串，长度大于0 -**默认值**：. +**默认值**: . ## unix_socket_directory -**参数说明**：用于指定unix_socket通信方式中，文件存放的路径。此参数只能在配置文件postgresql.conf中指定。再启动fenced模式前需要设定该GUC参数。 +**参数说明**: 用于指定unix_socket通信方式中，文件存放的路径。此参数只能在配置文件postgresql.conf中指定。再启动fenced模式前需要设定该GUC参数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于等于0 +**取值范围**: 字符串，长度大于等于0 -**默认值**：“ +**默认值**: “ diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md index 103cea1a..1d60aa63 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/1-settings.md @@ -9,7 +9,7 @@ date: 2021-04-20 ## wal_level -**参数说明**：设置写入WAL信息量的级别。 +**参数说明**: 设置写入WAL信息量的级别。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -19,7 +19,7 @@ date: 2021-04-20 > - 如果此参数设置为minimal，archive_mode必须设置为off，hot_standby必须设置为off，max_wal_senders参数设置为0，且需为单机环境，否则将导致数据库无法启动。 > - 如果此参数设置为archive，hot_standby必须设置为off，否则将导致数据库无法启动。但是，hot_standby在双机环境中不能设置为off，具体参见hot_standby参数说明。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - minimal @@ -40,11 +40,11 @@ date: 2021-04-20 这个参数表示WAL日志支持逻辑复制。 -**默认值**：hot_standby +**默认值**: hot_standby ## fsync -**参数说明**：设置MogDB服务器是否使用fsync()系统函数（请参见[wal_sync_method](#wal_sync_method)）确保数据的更新及时写入物理磁盘中。 +**参数说明**: 设置MogDB服务器是否使用fsync()系统函数（请参见[wal_sync_method](#wal_sync_method)）确保数据的更新及时写入物理磁盘中。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -53,16 +53,16 @@ date: 2021-04-20 > - 使用fsync()系统函数可以保证在操作系统或者硬件崩溃的情况下将数据恢复到一个已知的状态。 > - 如果将此参数关闭，可能会在系统崩溃时无法恢复原来的数据，导致数据库不可用。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用fsync()系统函数。 - off表示不使用fsync()系统函数。 -**默认值**：on +**默认值**: on ## synchronous_commit -**参数说明**：设置当前事务的同步方式。 +**参数说明**: 设置当前事务的同步方式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -77,7 +77,7 @@ date: 2021-04-20 7. 备机将备机文件系统中的日志内容刷盘。 8. 备机回放日志，完成对数据文件的增量更新。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on：表示主机事务提交需要等待备机将对应日志刷新到磁盘。 - off：表示主机事务提交无需等待主机自身将对应日志刷新到磁盘，通常也称为异步提交。 @@ -93,11 +93,11 @@ date: 2021-04-20 - 0：同off。 - 2：同remote_apply。 -**默认值**：on +**默认值**: on ## wal_sync_method -**参数说明**：设置向磁盘强制更新WAL数据的方法。 +**参数说明**: 设置向磁盘强制更新WAL数据的方法。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -105,7 +105,7 @@ date: 2021-04-20 > > 如果将[fsync](#fsync)关闭，这个参数的设置就没有意义，因为所有数据更新都不会强制写入磁盘。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - open_datasync表示用带O_DSYNC选项的open()打开"WAL"文件。 @@ -115,7 +115,7 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：由于历史原因，Windows平台支持将wal_sync_method设置为fsync_writethrough。在windows平台上fsync_writethrough和fsync等效。 > - + - fsync表示每次提交的时候调用fsync()。（支持suse10和suse11） - open_sync表示用带O_SYNC选项的open()写"WAL"文件。（支持suse10和suse11） @@ -123,11 +123,11 @@ date: 2021-04-20 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：不是所有的平台都支持以上参数。 > -**默认值**：fdatasync +**默认值**: fdatasync ## full_page_writes -**参数说明**：设置MogDB服务器在检查点之后对页面的第一次修改时，是否将每个磁盘页面的全部内容写到WAL日志中。当增量检查点开关和enable_double_write同时打开时，则不使用full_page_writes。 +**参数说明**: 设置MogDB服务器在检查点之后对页面的第一次修改时，是否将每个磁盘页面的全部内容写到WAL日志中。当增量检查点开关和enable_double_write同时打开时，则不使用full_page_writes。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -136,57 +136,57 @@ date: 2021-04-20 > - 设置这个参数是因为在操作系统崩溃过程中可能磁盘页面只写入了一部分内容，从而导致在同一个页面中包含新旧数据的混合。在崩溃后的恢复期间，由于在WAL日志中存储的行变化信息不够完整，因此无法完全恢复该页。把完整的页面影像保存下来就可以保证页面被正确还原，代价是增加了写入WAL日志的数据量。 > - 关闭此参数，在系统崩溃的时候，可能无法恢复原来的数据。如果服务器硬件的特质（比如电池供电的磁盘控制器）可以减小部分页面的写入风险，或者文件系统特性支持（比如ReiserFS 4），并且清楚知道写入风险在一个可以接受的范畴，可以关闭这个参数。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示启用此特性。 - off表示关闭此特性。 -**默认值**：on +**默认值**: on ## wal_log_hints -**参数说明**：设置在检查点之后对页面的第一次修改为页面上元组hint bits的修改时，是否将整个页面的全部内容写到WAL日志中。不推荐用户修改此设置。 +**参数说明**: 设置在检查点之后对页面的第一次修改为页面上元组hint bits的修改时，是否将整个页面的全部内容写到WAL日志中。不推荐用户修改此设置。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示整个页面全部内容写到WAL日志中。 - off表示整个页面内容不会写到WAL日志中。 -**默认值**：on +**默认值**: on ## wal_buffers -**参数说明**：设置用于存放WAL数据的共享内存空间的XLOG_BLCKSZ数，XLOG_BLCKSZ的大小默认为8KB。 +**参数说明**: 设置用于存放WAL数据的共享内存空间的XLOG_BLCKSZ数，XLOG_BLCKSZ的大小默认为8KB。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：-1~2^18^ +**取值范围**: -1~2^18^ - 如果设置为-1，表示wal_buffers的大小随着参数shared_buffers自动调整，为shared_buffers的1/32，最小值为8个XLOG_BLCKSZ，最大值为2048个XLOG_BLCKSZ，自动调整后的值小于最小值时会调整为最小值，大于最大值时会调整为最大值。 - 如果设置为其他值，当小于4时，会被默认设置为4。 -**默认值**：2048，即16MB +**默认值**: 2048，即16MB **设置建议**：每次事务提交时，WAL缓冲区的内容都写入到磁盘中，因此设置为很大的值不会带来明显的性能提升。如果将它设置成几百兆，就可以在有很多即时事务提交的服务器上提高写入磁盘的性能。根据经验来说，默认值可以满足大多数的情况。 ## wal_writer_delay -**参数说明**：WalWriter进程的写间隔时间。 +**参数说明**: WalWriter进程的写间隔时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：如果时间过长可能造成WAL缓冲区的内存不足，时间过短会引起WAL不断写入，增加磁盘I/O负担。 > -**取值范围**：整型， 1～10000，单位为毫秒。 +**取值范围**: 整型， 1～10000，单位为毫秒。 -**默认值**：200ms +**默认值**: 200ms ## commit_delay -**参数说明**：表示一个已经提交的数据在WAL缓冲区中存放的时间。 +**参数说明**: 表示一个已经提交的数据在WAL缓冲区中存放的时间。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -195,69 +195,69 @@ date: 2021-04-20 > - 设置为非 0 值时事务执行commit后不会立即写入WAL中，而仍存放在WAL缓冲区中，等待WalWriter进程周期性写入磁盘。 > - 如果系统负载很高，在延迟时间内，其他事务可能已经准备好提交。但如果没有事务准备提交，这个延迟就是在浪费时间。 -**取值范围**：整型， 0～100000，单位为微秒，其中0表示无延迟。 +**取值范围**: 整型， 0～100000，单位为微秒，其中0表示无延迟。 -**默认值**：0 +**默认值**: 0 ## commit_siblings -**参数说明**：当一个事务发出提交请求时，如果数据库中正在执行的事务数量大于此参数的值，则该事务将等待一段时间（[commit_delay](#commit_delay)的值），否则该事务则直接写入WAL。 +**参数说明**: 当一个事务发出提交请求时，如果数据库中正在执行的事务数量大于此参数的值，则该事务将等待一段时间（[commit_delay](#commit_delay)的值），否则该事务则直接写入WAL。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型， 0～1000 +**取值范围**: 整型， 0～1000 -**默认值**：5 +**默认值**: 5 ## wal_block_size -**参数说明**：说明WAL日志段文件中日志页面的大小。 +**参数说明**: 说明WAL日志段文件中日志页面的大小。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型，单位为Byte。 +**取值范围**: 整型，单位为Byte。 -**默认值**：8192 +**默认值**: 8192 ## wal_segment_size -**参数说明**：说明WAL日志段文件的大小。 +**参数说明**: 说明WAL日志段文件的大小。 该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。 -**取值范围**：整型，单位为8KB。 +**取值范围**: 整型，单位为8KB。 -**默认值**：16MB (2048 * 8KB) +**默认值**: 16MB (2048 * 8KB) ## walwriter_cpu_bind -**参数说明**：绑定到WAL写入线程的CPU核，与thread pool配合使用。 +**参数说明**: 绑定到WAL写入线程的CPU核，与thread pool配合使用。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~核数减1。 +**取值范围**: 整型，-1~核数减1。 -**默认值**：-1 +**默认值**: -1 ## walwriter_sleep_threshold -**参数说明**：xlogflusher进入sleep之前空闲xlog刷新的次数，达到阈值会休眠。 +**参数说明**: xlogflusher进入sleep之前空闲xlog刷新的次数，达到阈值会休眠。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~50000。 +**取值范围**: 整型，1~50000。 -**默认值**：500 +**默认值**: 500 ## wal_file_init_num -**参数说明**：WAL编写器将创建的xlog段文件的数量。 +**参数说明**: WAL编写器将创建的xlog段文件的数量。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~1000000。 +**取值范围**: 整型，0~1000000。 -**默认值**：10 +**默认值**: 10 ## force_promote @@ -265,30 +265,30 @@ date: 2021-04-20 备机强切在集群故障状态下，以丢失部分数据为代价换取集群尽可能快的恢复服务；是集群状态为不可用时的一个逃生方法，不建议频繁触发。如果操作者不清楚备机强切后丢失数据对业务的影响，请勿使用本功能。 -**取值范围**：整型，0或1 +**取值范围**: 整型，0或1 0表示关闭，1表示开启 -**默认值**：0 +**默认值**: 0 ## wal_flush_timeout -**参数说明**：遍历WalInsertStatusEntryTbl的超时时间。Xlog刷盘自适应控制的刷盘IO遍历WalInsertStatusEntryTbl等待的最大时间。 +**参数说明**: 遍历WalInsertStatusEntryTbl的超时时间。Xlog刷盘自适应控制的刷盘IO遍历WalInsertStatusEntryTbl等待的最大时间。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果时间过长可能造成Xlog刷盘频率降低，降低Xlog处理性能。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果时间过长可能造成Xlog刷盘频率降低，降低Xlog处理性能。 -**取值范围**：整型， 0 ~ 90000000（微秒） +**取值范围**: 整型， 0 ~ 90000000（微秒） -**默认值**：2us +**默认值**: 2us ## wal_flush_delay -**参数说明**：遍历WalInsertStatusEntryTbl时，遇到WAL_NOT_COPIED状态entry时等待的时间间隔。 +**参数说明**: 遍历WalInsertStatusEntryTbl时，遇到WAL_NOT_COPIED状态entry时等待的时间间隔。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型， 0 ~ 90000000（微秒） +**取值范围**: 整型， 0 ~ 90000000（微秒） -**默认值**：1us +**默认值**: 1us diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md index 4cb55774..000e4c89 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/2-checkpoints.md @@ -9,121 +9,121 @@ date: 2021-04-20 ## checkpoint_segments -**参数说明**：设置[checkpoint_timeout](#checkpoint_timeout)周期内所保留的最少WAL日志段文件数量。每个日志文件大小为16MB。 +**参数说明**: 设置[checkpoint_timeout](#checkpoint_timeout)周期内所保留的最少WAL日志段文件数量。每个日志文件大小为16MB。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，最小值1 +**取值范围**: 整型，最小值1 提升此参数可加快大数据的导入速度，但需要结合[checkpoint_timeout](#checkpoint_timeout)、[shared_buffers](1-memory#shared_buffers)这两个参数统一考虑。这个参数同时影响WAL日志段文件复用数量，通常情况下pg_xlog文件夹下最大的复用文件个数为2倍的checkpoint_segments个，复用的文件被改名为后续即将使用的WAL日志段文件，不会被真正删除。 -**默认值**：64 +**默认值**: 64 ## checkpoint_timeout -**参数说明**：设置自动WAL检查点之间的最长时间。 +**参数说明**: 设置自动WAL检查点之间的最长时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，30～3600（秒） +**取值范围**: 整型，30～3600（秒） 在提升[checkpoint_segments](#checkpoint_segments)以加快大数据导入的场景也需将此参数调大，同时这两个参数提升会加大[shared_buffers](1-memory#shared_buffers)的负担，需要综合考虑。 -**默认值**：15min +**默认值**: 15min ## checkpoint_completion_target -**参数说明**：指定检查点完成的目标。 +**参数说明**: 指定检查点完成的目标。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：双精度浮点类型，0.0～1.0 +**取值范围**: 双精度浮点类型，0.0～1.0 -**默认值**：0.5 +**默认值**: 0.5 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：默认值0.5表示每个checkpoint需要在checkpoints间隔时间的50%内完成。 ## checkpoint_warning -**参数说明**：如果由于填充检查点段文件导致检查点发生的时间间隔接近这个参数表示的秒数，就向服务器日志发送一个建议增加[checkpoint_segments](#checkpoint_segments)值的消息。 +**参数说明**: 如果由于填充检查点段文件导致检查点发生的时间间隔接近这个参数表示的秒数，就向服务器日志发送一个建议增加[checkpoint_segments](#checkpoint_segments)值的消息。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~INT_MAX（秒），其中0表示关闭警告。 +**取值范围**: 整型，0~INT_MAX（秒），其中0表示关闭警告。 -**默认值**：5min +**默认值**: 5min **推荐值**：5min ## checkpoint_wait_timeout -**参数说明**：设置请求检查点等待checkpointer线程启动的最长时间。 +**参数说明**: 设置请求检查点等待checkpointer线程启动的最长时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，2～3600（秒） +**取值范围**: 整型，2～3600（秒） -**默认值**：1min +**默认值**: 1min ## enable_incremental_checkpoint -**参数说明**：增量检查点开关。 +**参数说明**: 增量检查点开关。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：on +**默认值**: on ## enable_double_write -**参数说明**：双写开关。当增量检查点开关打开时，同时enable_double_write打开，则使用enable_double_write双写特性保护，不再使用full_page_writes防止半页写问题。 +**参数说明**: 双写开关。当增量检查点开关打开时，同时enable_double_write打开，则使用enable_double_write双写特性保护，不再使用full_page_writes防止半页写问题。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：on +**默认值**: on ## incremental_checkpoint_timeout -**参数说明**：增量检查点开关打开之后，设置自动WAL检查点之间的最长时间。 +**参数说明**: 增量检查点开关打开之后，设置自动WAL检查点之间的最长时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~3600（秒） +**取值范围**: 整型，1~3600（秒） -**默认值**：1min +**默认值**: 1min ## enable_xlog_prune -**参数说明**：设置在任一备机断联时，主机是否根据xlog日志的大小超过参数max_size_for_xlog_prune的值而回收日志。 +**参数说明**: 设置在任一备机断联时，主机是否根据xlog日志的大小超过参数max_size_for_xlog_prune的值而回收日志。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - 设置为on时，如果任一备机断联时，主机回收日志。 - 设置为off时，如果任一备机断联时，主机不回收日志。 -**默认值**：on +**默认值**: on ## max_redo_log_size -**参数说明**：备DN表示当前回放的最新检查点位置和当前日志回放位置之间日志量的期望值，主DN表示恢复点到当前最新日志之间日志量的期望值，关注RTO的情况下，这个值建议不宜过大。 +**参数说明**: 备DN表示当前回放的最新检查点位置和当前日志回放位置之间日志量的期望值，主DN表示恢复点到当前最新日志之间日志量的期望值，关注RTO的情况下，这个值建议不宜过大。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，163840~2147483647，单位为KB。 +**取值范围**: 整型，163840~2147483647，单位为KB。 -**默认值**：1GB +**默认值**: 1GB ## max_size_for_xlog_prune -**参数说明**：在enable_xlog_prune、synchronous_commit都打开时生效，如果有备机断连且xlog日志大小大于此阈值，则回收日志。所有备机断联且无逻辑复制槽时，不回收日志。 +**参数说明**: 在enable_xlog_prune、synchronous_commit都打开时生效，如果有备机断连且xlog日志大小大于此阈值，则回收日志。所有备机断联且无逻辑复制槽时，不回收日志。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～2147483647，单位为KB +**取值范围**: 整型，0～2147483647，单位为KB -**默认值**：2147483647，单位KB +**默认值**: 2147483647，单位KB diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md index 6a24b951..41ebdc4d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/3-log-replay.md @@ -9,77 +9,77 @@ date: 2021-04-20 ## recovery_time_target -**参数说明**：设置recovery_time_target秒能够让备机完成日志写入和回放。 +**参数说明**: 设置recovery_time_target秒能够让备机完成日志写入和回放。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~3600（秒） +**取值范围**: 整型，0~3600（秒） 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。另外，由于极致RTO自带流控，所以同时开启极致RTO与流控时会以极致RTO优先，在运行期间使流控不生效。 -**默认值**：0 +**默认值**: 0 ## recovery_max_workers -**参数说明**：设置最大并行回放线程个数。 +**参数说明**: 设置最大并行回放线程个数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~20 +**取值范围**: 整型，0~20 -**默认值**：1 （安装工具默认将设置为4，以获得更好的性能） +**默认值**: 1 （安装工具默认将设置为4，以获得更好的性能） ## recovery_parse_workers -**参数说明**：是极致RTO特性中ParseRedoRecord线程的数量。 +**参数说明**: 是极致RTO特性中ParseRedoRecord线程的数量。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~16 +**取值范围**: 整型，1~16 仅在开启极致RTO情况下可以设置recovery_parse_workers为>1。需要配合recovery_redo_workers使用。若同时开启recovery_parse_workers和recovery_max_workers，以开启极致RTO的recovery_parse_workers为准，并行回放特性失效。因极致RTO不支持hot standby模式和主备从模式, 仅在参数hot_standby设置成off，replication_type设置成1时可以设置recovery_parse_workers为>1。另外，极致RTO也不支持列存，在已经使用列存表或者即将使用列存表的系统中，请关闭极致RTO。由于极致RTO自带流控，所以同时开启极致RTO与流控时会以极致RTO优先，在运行期间使流控不生效。 -**默认值**：1 +**默认值**: 1 ## recovery_redo_workers -**参数说明**：是极致RTO特性中每个ParseRedoRecord线程对应的PageRedoWorker数量。 +**参数说明**: 是极致RTO特性中每个ParseRedoRecord线程对应的PageRedoWorker数量。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~8 +**取值范围**: 整型，1~8 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于0，recovery_redo_workers参数才生效。 -**默认值**：1 +**默认值**: 1 ## recovery_parallelism -**参数说明**：查询实际回放线程个数，该参数为只读参数，无法修改。 +**参数说明**: 查询实际回放线程个数，该参数为只读参数，无法修改。 该参数属于POSTMASTER类型参数，受recovery_max_workers以及recovery_parse_workers参数影响，任意一值大于0时，recover_parallelism将被重新计算。 -**取值范围**：整型，1~2147483647 +**取值范围**: 整型，1~2147483647 -**默认值**：1 +**默认值**: 1 ## enable_page_lsn_check -**参数说明**：数据页lsn检查开关。回放时，检查数据页当前的lsn是否是期望的lsn。 +**参数说明**: 数据页lsn检查开关。回放时，检查数据页当前的lsn是否是期望的lsn。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 -**默认值**：on +**默认值**: on ## recovery_min_apply_delay -**参数说明**：设置备节点回放的延迟时间。 +**参数说明**: 设置备节点回放的延迟时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数主节点设置无效，必须设置在需要延迟的备节点上，推荐设置在异步备上，设置了延时的异步备如果升主RTO时间会比较长。 > - 延迟时间是根据主服务器上事务提交的时间戳与备机上的当前时间来计算，因此需要保证主备系统时钟一致。 @@ -91,20 +91,20 @@ date: 2021-04-20 > - 主机执行了持有AccessExclusive锁的DDL操作，比如DROP和TRUNCATE操作，在备机延迟回放该条记录期间，在备机上对该操作对象执行查询操作会等待锁释放之后才会返回。 > - 不支持MOT表。 -**取值范围**：整型，0~INT_MAX，单位为毫秒。 +**取值范围**: 整型，0~INT_MAX，单位为毫秒。 -**默认值**：0（不增加延迟） +**默认值**: 0（不增加延迟） ## redo_bind_cpu_attr -**参数说明**：用于控制回放线程的绑核操作，仅sysadmin用户可以访问。 +**参数说明**: 用于控制回放线程的绑核操作，仅sysadmin用户可以访问。 该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串，长度大于0，该参数不区分大小写。 +**取值范围**: 字符串，长度大于0，该参数不区分大小写。 - 'nobind'：线程不做绑核。 - 'nodebind: 1, 2'：利用NUMA组1,2中的CPU core进行绑核。 - 'cpubind: 0-30'：利用0-30号CPU core进行绑核。 -**默认值**：'nobind' +**默认值**: 'nobind' diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md index 02a7dbcf..6e2e9726 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/6-write-ahead-log/4-archiving.md @@ -9,7 +9,7 @@ date: 2021-04-20 ## archive_mode -**参数说明**：表示是否进行归档操作。 +**参数说明**: 表示是否进行归档操作。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -19,16 +19,16 @@ date: 2021-04-20 > - 无论是同步备机还是异步备机都能够开启归档，归档开启的方式与单机开启归档一致，将archive_mode置为on，并设置正确的archive_dest或者archive_command即可。 > - 若未开启最大可用模式以及有同步备机与主机断开连接时，主机会因为业务阻塞的原因无法给备机发送归档的位置，从而导致归档失败。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示进行归档。 - off表示不进行归档。 -**默认值**：off +**默认值**: off ## archive_command -**参数说明**：由管理员设置的用于归档WAL日志的命令，建议归档路径为绝对路径。 +**参数说明**: 由管理员设置的用于归档WAL日志的命令，建议归档路径为绝对路径。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -57,13 +57,13 @@ date: 2021-04-20 > archive_command='sh dir/test.sh %p %f' > ``` -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：(disabled) +**默认值**: (disabled) ## archive_dest -**参数说明**：由管理员设置的用于归档WAL日志的目录，建议归档路径为绝对路径。 +**参数说明**: 由管理员设置的用于归档WAL日志的目录，建议归档路径为绝对路径。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -77,13 +77,13 @@ date: 2021-04-20 > archive_dest = '/mnt/server/archivedir/' > ``` -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空字符串 +**默认值**: 空字符串 ## archive_timeout -**参数说明**：表示归档周期。 +**参数说明**: 表示归档周期。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -92,6 +92,6 @@ date: 2021-04-20 > - 超过该参数设定的时间时强制切换WAL段。 > - 由于强制切换而提早关闭的归档文件仍然与完整的归档文件长度相同。因此，将archive_timeout设为很小的值将导致占用巨大的归档存储空间，建议将archive_timeout设置为60秒。 -**取值范围**：整型，0 ~ INT_MAX，单位为秒。其中0表示禁用该功能。 +**取值范围**: 整型，0 ~ INT_MAX，单位为秒。其中0表示禁用该功能。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md index 34515e8a..0763ab62 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/1-sending-server.md @@ -9,28 +9,28 @@ date: 2021-04-20 ## max_wal_senders -**参数说明**：指定事务日志发送进程的并发连接最大数量。不可大于等于[max_connections](1-connection-settings#max_connections)。 +**参数说明**: 指定事务日志发送进程的并发连接最大数量。不可大于等于[max_connections](1-connection-settings#max_connections)。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：[wal_level](1-settings#wal_level)必须设置为archive或者hot_standby以允许备机的连接。 -**取值范围**：整型，0～1024 +**取值范围**: 整型，0～1024 - 建议取值范围为8 ~ 100。 - 只有当使用单DN实例无主备场景下才可以设置为0。 -**默认值**：16 +**默认值**: 16 ## wal_keep_segments -**参数说明**：Xlog日志文件段数量。设置"pg_xlog"目录下保留事务日志文件的最小数目，备机通过获取主机的日志进行流复制。 +**参数说明**: Xlog日志文件段数量。设置"pg_xlog"目录下保留事务日志文件的最小数目，备机通过获取主机的日志进行流复制。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，2 ~ INT_MAX +**取值范围**: 整型，2 ~ INT_MAX -**默认值**：16 +**默认值**: 16 **设置建议**： @@ -41,7 +41,7 @@ date: 2021-04-20 ## wal_sender_timeout -**参数说明**：设置本端等待事务日志接收端接收日志的最大等待时间。 +**参数说明**: 设置本端等待事务日志接收端接收日志的最大等待时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -50,19 +50,19 @@ date: 2021-04-20 > - 如果主机数据较大，重建备机数据库时需要增大此参数的值，主机数据在 500G时，此参数的参考值为600s。 > - 此值不能大于wal_receiver_timeout或数据库重建时的超时参数。 -**取值范围**：整型，0 ~ INT_MAX，单位为毫秒（ms）。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒（ms）。 -**默认值**：6s +**默认值**: 6s ## max_replication_slots -**参数说明**：设置主机端的日志复制slot个数。 +**参数说明**: 设置主机端的日志复制slot个数。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 1024（建议取值范围：8 ~ 100） +**取值范围**: 整型，0 ~ 1024（建议取值范围：8 ~ 100） -**默认值**：8 +**默认值**: 8 **设置建议**： @@ -76,78 +76,78 @@ date: 2021-04-20 ## enable_slot_log -**参数说明**：是否开启逻辑复制槽主备同步特性。 +**参数说明**: 是否开启逻辑复制槽主备同步特性。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启逻辑复制槽主备同步特性。 - off表示不开启逻辑复制槽主备同步特性。 -**默认值**：off +**默认值**: off ## max_changes_in_memory -**参数说明**：逻辑解码时单条事务在内存中缓存的大小上限，单位字节。 +**参数说明**: 逻辑解码时单条事务在内存中缓存的大小上限，单位字节。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~2147483647 +**取值范围**: 整型，1~2147483647 -**默认值**：4096 +**默认值**: 4096 ## max_cached_tuplebufs -**参数说明**：逻辑解码时总元组信息在内存中缓存的大小上限，单位字节。建议设置为[max_changes_in_memory](1-sending-server#max_changes_in_memory)的两倍以上。 +**参数说明**: 逻辑解码时总元组信息在内存中缓存的大小上限，单位字节。建议设置为[max_changes_in_memory](1-sending-server#max_changes_in_memory)的两倍以上。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~2147483647 +**取值范围**: 整型，1~2147483647 -**默认值**：8192 +**默认值**: 8192 ## enable_wal_shipping_compression -**参数说明**：在流式容灾模式下设置启动跨数据库实例日志压缩功能。 +**参数说明**: 在流式容灾模式下设置启动跨数据库实例日志压缩功能。 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> **须知：** 该参数仅作用于流式容灾中跨数据库实例传输的一对walsender与walreceiver中，在主数据库实例上配置。 +> **须知**: 该参数仅作用于流式容灾中跨数据库实例传输的一对walsender与walreceiver中，在主数据库实例上配置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - true表示打开流式容灾跨数据库实例日志压缩 - false表示关闭流式容灾跨数据库实例日志压缩 -**默认值**：false +**默认值**: false ## replconninfoN -**参数说明**：设置本端侦听和鉴权的第N个节点信息（N=1, 2, 3, ...8）。 +**参数说明**: 设置本端侦听和鉴权的第N个节点信息（N=1, 2, 3, ...8）。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。其中空字符串表示没有配置第N个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第N个节点信息。 -**默认值**：空字符串 +**默认值**: 空字符串 ## cross_cluster_replconninfoN -**参数说明**：设置跨集群的本端侦听和鉴权的第N个节点信息（N=1, 2, 3, ...8）。 +**参数说明**: 设置跨集群的本端侦听和鉴权的第N个节点信息（N=1, 2, 3, ...8）。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。其中空字符串表示没有配置第N个节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置第N个节点信息。 -**默认值**：空字符串 +**默认值**: 空字符串 ## available_zone -**参数说明**：设置本端节点所在区域信息。 +**参数说明**: 设置本端节点所在区域信息。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串。其中空字符串表示没有配置节点信息。 +**取值范围**: 字符串。其中空字符串表示没有配置节点信息。 -**默认值**：空字符串 +**默认值**: 空字符串 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md index 1eb9912a..28c0186d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/2-primary-server.md @@ -9,7 +9,7 @@ date: 2021-04-20 ## synchronous_standby_names -**参数说明**：潜在同步复制的备机名称列表，每个名称用逗号分隔。 +**参数说明**: 潜在同步复制的备机名称列表，每个名称用逗号分隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -18,13 +18,13 @@ date: 2021-04-20 > - 当前连接的同步备机是列表中的第一个名称。如果当前同步备机失去连接，则它会立即更换下一个优先级更高的备机，并将此备机的名称放入列表中。 > - 备机名称可以通过设置环境变量PGAPPNAME指定。 -**取值范围**：字符串。当取值为*，表示匹配任意提供同步复制的备机名称。支持按如下格式配置： +**取值范围**: 字符串。当取值为*，表示匹配任意提供同步复制的备机名称。支持按如下格式配置： - ANY **num_sync (standby_name** [, ...]) [, ANY **num_sync (standby_name** [, ...])] - [FIRST] **num_sync (standby_name** [, ...]) - **standby_name** [, ...] -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 其中 **num_sync** 是事务需要等待其回复的同步复制的备机的数量，**standby_name** 是备机的名称，FIRST以及ANY指定从所列服务器中选取同步复制的备机的策略。 > @@ -41,37 +41,37 @@ date: 2021-04-20 > ``` > gs_guc reload -Z datanode -N @NODE_NAME@ -D @DN_PATH@ -c "synchronous_standby_names='ANY NODE 1(dn_instanceId1, dn_instanceId2)'"; > ``` -> +> > 或者： -> +> > ``` > gs_guc reload -Z datanode -N @NODE_NAME@ -D @DN_PATH@ -c "synchronous_standby_names='ANY 1(AZ1, AZ2)'"; > ``` > -**默认值**：* +**默认值**: * -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > - 备机名称列表中不可出现重复的名称，配置中num_sync 不可大于备机列表数量。 > - 多分组同步备机配置 如ANY N1 (node1,node2,…), ANY N2 (node3,node4,…) 的时候，多个分组之间为且关系，当前仅支持多ANY分组。不允许使用 * 来作为模糊匹配，不允许出现配置重复的备机。 ## most_available_sync -**参数说明**：在有同步备机故障时，主机事务不因同步备机故障而被阻塞。比如有两个同步备机，一个故障，另一个正常，这个时候主机事务只会等好的这个同步备，而不被故障的同步备所阻塞； 再比如走quroum协议时，一主三同步备，配置ANY 2(node1,node2,node3)，当node1、node3故障，node2正常时，主机业务同样不被阻塞。 +**参数说明**: 在有同步备机故障时，主机事务不因同步备机故障而被阻塞。比如有两个同步备机，一个故障，另一个正常，这个时候主机事务只会等好的这个同步备，而不被故障的同步备所阻塞； 再比如走quroum协议时，一主三同步备，配置ANY 2(node1,node2,node3)，当node1、node3故障，node2正常时，主机业务同样不被阻塞。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在有同步备机故障时，不阻塞主机。 - off表示在有同步备机故障时，阻塞主机。 -**默认值**：off +**默认值**: off ## keep_sync_window -**参数说明**：延迟进入最大可用模式的时间。 +**参数说明**: 延迟进入最大可用模式的时间。 - 当最大可用模式most_available_sync配置为on，在主备场景下，当存在同步备发生故障，导致不满足当前所配置的同步备数量(详细可参考synchonous_standby_name的含义)时，如果配置了keep_sync_window参数, 则在keep_sync_window设置的时间窗口内，继续保持最大保护模式，即阻塞主机的事务提交, 延缓进入最大可用模式的时间。 - 若在keep_sync_window超时窗口内，同步备机故障恢复，且满足当前所配置的同步备数量, 则不阻塞事务, 恢复到正常状态. @@ -79,39 +79,39 @@ date: 2021-04-20 该参数属于SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整形，范围0~INT_MAX，单位为秒。 +**取值范围**: 整形，范围0~INT_MAX，单位为秒。 - 0表示不设置keep_sync_window超时时间窗口, 即直接进入最大可用模式。 - 其余表示keep_sync_window超时时间窗口的大小。 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 配置该参数可能会对RPO造成影响, 若主机在所配置的超时时间窗口内发生故障，则从开始阻塞到主机故障这段时间窗口内的数据可能丢失。 ## enable_stream_replication -**参数说明**：控制主备、主从是否进行数据和日志同步。 +**参数说明**: 控制主备、主从是否进行数据和日志同步。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 此参数属于性能测试参数，用于测试带有备机和不带备机的性能参数。关闭参数后，不能进行切换、故障等异常场景测试，否则会出现主备从不一致的情况。 > - 此参数属于受控参数，不建议正常业务场景下关闭此参数。 > - 当前版本默认不支持主备从部署模式。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开主备、主从同步。 - off表示关闭主备、主从同步。 -**默认值**：on +**默认值**: on ## enable_mix_replication -**参数说明**：控制主备、主从之间WAL日志及数据复制的方式。 +**参数说明**: 控制主备、主从之间WAL日志及数据复制的方式。 该参数属于INTERNAL类型参数，默认值为off，不允许外部修改。 @@ -121,91 +121,91 @@ date: 2021-04-20 > > - 当前版本默认不支持主备从部署模式。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示打开WAL日志、数据页混合复制模式。 - off表示关闭WAL日志、数据页混合复制模式。 -**默认值**：off +**默认值**: off ## vacuum_defer_cleanup_age -**参数说明**：指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。 +**参数说明**: 指定VACUUM使用的事务数，VACUUM会延迟清除无效的行存表记录，延迟的事务个数通过vacuum_defer_cleanup_age进行设置。即VACUUM和VACUUM FULL操作不会立即清理刚刚被删除元组。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～1000000，值为0表示不延迟。 +**取值范围**: 整型，0～1000000，值为0表示不延迟。 -**默认值**：0 +**默认值**: 0 ## data_replicate_buffer_size -**参数说明**：发送端与接收端传递数据页时，队列占用内存的大小。此参数会影响主备之间复制的缓冲大小。 +**参数说明**: 发送端与接收端传递数据页时，队列占用内存的大小。此参数会影响主备之间复制的缓冲大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，4096~1072693248，单位为KB。 +**取值范围**: 整型，4096~1072693248，单位为KB。 -**默认值**：16MB（即16448KB） +**默认值**: 16MB（即16448KB） ## walsender_max_send_size -**参数说明**：设置主机端日志或数据发送缓冲区的大小。 +**参数说明**: 设置主机端日志或数据发送缓冲区的大小。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，8~INT_MAX，单位为KB。 +**取值范围**: 整型，8~INT_MAX，单位为KB。 -**默认值**：8M（即8192KB） +**默认值**: 8M（即8192KB） ## enable_data_replicate -**参数说明**：当数据库在数据导入行存表时，主机与备机的数据同步方式可以进行选择。 +**参数说明**: 当数据库在数据导入行存表时，主机与备机的数据同步方式可以进行选择。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示导入数据行存表时主备数据采用数据页的方式进行同步。当replication_type参数为1时，不允许设置为on，如果此时用guc工具设置成on，会强制改为off。 - off表示导入数据行存表时主备数据采用日志（Xlog）方式进行同步。 -**默认值**：off +**默认值**: off ## ha_module_debug -**参数说明**：用于查看数据复制时具体数据块的复制状态日志。 +**参数说明**: 用于查看数据复制时具体数据块的复制状态日志。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示日志中将打印数据复制时每个数据块的状态。 - off表示日志中不打印数据复制时每个数据块的状态。 -**默认值**：off +**默认值**: off ## enable_incremental_catchup -**参数说明**：控制主备之间数据追赶（catchup）的方式，目前默认不支持主备从部署模式。 +**参数说明**: 控制主备之间数据追赶（catchup）的方式，目前默认不支持主备从部署模式。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示备机catchup时用增量catchup方式，即从从备本地数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 - off表示备机catchup时用全量catchup方式，即从主机本地所有数据文件扫描获得主备差异数据文件列表，进行主备之间的catchup。 -**默认值**：on +**默认值**: on ## wait_dummy_time -**参数说明**：同时控制增量数据追赶（catchup）时，MogDB主备从按顺序启动时等待从备启动的最长时间以及等待从备发回扫描列表的最长时间。 +**参数说明**: 同时控制增量数据追赶（catchup）时，MogDB主备从按顺序启动时等待从备启动的最长时间以及等待从备发回扫描列表的最长时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，范围1~INT_MAX，单位为秒 +**取值范围**: 整型，范围1~INT_MAX，单位为秒 -**默认值**：300 +**默认值**: 300 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > @@ -214,33 +214,33 @@ date: 2021-04-20 ## catchup2normal_wait_time -**参数说明**：打开最大可用模式most_available_sync，主备场景下，控制备机数据追赶（catchup）阻塞主机的最长时间。该时间为估算值，实际结果可能与参数值有偏差。 +**参数说明**: 打开最大可用模式most_available_sync，主备场景下，控制备机数据追赶（catchup）阻塞主机的最长时间。该时间为估算值，实际结果可能与参数值有偏差。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，范围-1~10000，单位为毫秒。 +**取值范围**: 整型，范围-1~10000，单位为毫秒。 - -1表示主机阻塞直到备机数据追赶完成。 - 0表示备机数据追赶时始终不阻塞主机。 - 其余值表示备机数据追赶时阻塞主机的最长时间。例如，取值5000，表示当备机数据追赶完成时间还剩5s时，阻塞主机等待其完成。 -**默认值**：-1 +**默认值**: -1 ## sync_config_strategy -**参数说明**：主机和备机、备机和级联备之间配置文件的同步策略。 +**参数说明**: 主机和备机、备机和级联备之间配置文件的同步策略。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - all_node: 主机配置为all_node时，表示允许主机向所有备机主动同步配置文件；备机配置为all_node时，表示允许当前备机向其主机发送同步请求，允许当前备机向其所有级联备主动同步配置文件；级联备配置为all_node时，表示允许当前级联备向其备机发送同步请求。 - only_sync_node: 主机配置为only_sync_node时，表示仅允许主机向所有同步备机主动同步配置文件；备机配置为only_sync_node时，表示允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为only_sync_node时，表示允许当前级联备向其备机发送同步请求。 - none_node: 主机配置为none_node时，表示不允许主机向任何备机主动同步配置文件；备机配置为none_node时，表示不允许当前备机向其主机发送同步请求，不允许当前备机向其所有级联备主动同步配置文件；级联备配置为none_node时，表示不允许当前级联备向其备机发送同步请求。 -**默认值**：all_node +**默认值**: all_node -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 在一个包含了主机、备机和级联备的MogDB集群中，主机相对于备机是发送端，备机相对于主机是接收端，备机相对于级联备是发送端，级联备相对于备机是接收端。 > - 发送端主动向接收端同步配置文件、接收端请求发送端同步配置文件是两个独立的事件，均会使得配置文件同步。若不希望配置文件同步，则需要将集群中所有节点的sync_config_strategy参数配置为none_node；若仅希望主机与同步备机同步配置文件，则需要将主机的sync_config_strategy参数配置为only_sync_node，其余节点配置为none_node；若希望所有节点同步配置文件，则需要将所有节点的sync_config_strategy参数配置为all_node。目前暂不支持自定义指定任意节点间的同步策略。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md index e20fdb6d..6bd7c159 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/7-ha-replication/3-standby-server.md @@ -9,11 +9,11 @@ date: 2021-04-20 ## hot_standby -**参数说明**：设置是否允许备机在恢复过程中连接和查询。 +**参数说明**: 设置是否允许备机在恢复过程中连接和查询。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果此参数设置为on，[wal_level](1-settings#wal_level)必须设置为hot_standby，否则将导致数据库无法启动。 > - 在双机环境中，因为会对双机其他一些功能产生影响，hot_standby参数不能设置成off。 @@ -22,125 +22,125 @@ date: 2021-04-20 > - 在主机上执行checkpoint操作，并通过查询pg_stat_get_wal_senders()系统函数，确认各个备机的receiver_replay_location追上主机当前的sender_flush_location，保证wal_level的调整同步到备机并生效，且备机不需要再回放之前低等级的日志。 > - 将主、备的hot_standby参数打开（设为on），并重启实例生效。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许备机在恢复过程中连接和查询。 - off表示不允许备机在恢复过程中连接和查询。 -**默认值**：on +**默认值**: on ## max_standby_archive_delay -**参数说明**：当开启双机热备模式时，如果备机正处理归档WAL日志数据，这时进行查询就会产生冲突，此参数就是设置备机取消查询之前所等待的时间。 +**参数说明**: 当开启双机热备模式时，如果备机正处理归档WAL日志数据，这时进行查询就会产生冲突，此参数就是设置备机取消查询之前所等待的时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：-1表示允许备机一直等待冲突的查询完成。 > -**取值范围**：整型，范围：-1~INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围：-1~INT_MAX，单位为毫秒。 -**默认值**：3s（即3000ms） +**默认值**: 3s（即3000ms） ## max_standby_streaming_delay -**参数说明**：当开启双机热备模式时，如果备机正通过流复制接收WAL日志数据，这时进行查询就会产生冲突，这个参数就是设置备机取消查询之前所等待的时间。 +**参数说明**: 当开启双机热备模式时，如果备机正通过流复制接收WAL日志数据，这时进行查询就会产生冲突，这个参数就是设置备机取消查询之前所等待的时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：-1表示允许备机一直等待冲突的查询完成。 > -**取值范围**：整型（毫秒），范围：-1~INT_MAX。 +**取值范围**: 整型（毫秒），范围：-1~INT_MAX。 -**默认值**： 3s（即3000ms） +**默认值**: 3s（即3000ms） ## wal_receiver_status_interval -**参数说明**：设置WAL日志接收进程的状态通知给主机的最大时间间隔。 +**参数说明**: 设置WAL日志接收进程的状态通知给主机的最大时间间隔。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，范围：0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，范围：0 ~ INT_MAX，单位为毫秒。 -**默认值**：5s（即5000ms） +**默认值**: 5s（即5000ms） -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 当该参数设置为0时，表示关闭备机向主机反馈日志接收位置等信息，可能会导致主机事务提交阻塞、switchover操作失败等异常现象。正常业务场景，不建议将该参数设置为0。 ## hot_standby_feedback -**参数说明**：设置是否允许将备机上执行查询的结果反馈给主机，这可以避免查询冲突。 +**参数说明**: 设置是否允许将备机上执行查询的结果反馈给主机，这可以避免查询冲突。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许将备机上执行查询的最小事务号反馈给主机。 - off表示不允许将备机上执行查询的最小事务号反馈给主机。 -**默认值**：off +**默认值**: off > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**：当该参数为on时，主机的旧版本数据的清理会受限于备机正在读的事务，即主机只允许清理小于备机反馈回来的事务所作的更改。 所以，若该参数开启时，会影响主机的性能。 > ## wal_receiver_timeout -**参数说明**：设置从主机接收数据的最大等待时间。 +**参数说明**: 设置从主机接收数据的最大等待时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ INT_MAX，单位为毫秒。 +**取值范围**: 整型，0 ~ INT_MAX，单位为毫秒。 -**默认值**：6s（即6000ms） +**默认值**: 6s（即6000ms） ## wal_receiver_connect_timeout -**参数说明**：设置连接主机的最大等待超时时间。 +**参数说明**: 设置连接主机的最大等待超时时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ INT_MAX / 1000，单位为秒。 +**取值范围**: 整型，0 ~ INT_MAX / 1000，单位为秒。 -**默认值**：2s +**默认值**: 2s ## wal_receiver_connect_retries -**参数说明**：设置连接主机的最大尝试次数。 +**参数说明**: 设置连接主机的最大尝试次数。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~ INT_MAX。 +**取值范围**: 整型，1~ INT_MAX。 -**默认值**：1 +**默认值**: 1 ## wal_receiver_buffer_size -**参数说明**：备机与从备接收Xlog存放到内存缓冲区的大小，目前默认不支持主备从部署模式。 +**参数说明**: 备机与从备接收Xlog存放到内存缓冲区的大小，目前默认不支持主备从部署模式。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，4096~1047552，单位为KB。 +**取值范围**: 整型，4096~1047552，单位为KB。 -**默认值**：64MB（即65536KB） +**默认值**: 64MB（即65536KB） ## primary_slotname -**参数说明**：设置备机对应主机的slot name，用于主备校验，与wal日志删除机制。 +**参数说明**: 设置备机对应主机的slot name，用于主备校验，与wal日志删除机制。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符型 +**取值范围**: 字符型 -**默认值**：空字符串 +**默认值**: 空字符串 ## max_logical_replication_workers -**参数说明**：订阅端apply worker线程的最大数量。 +**参数说明**: 订阅端apply worker线程的最大数量。 该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0~262143 +**取值范围**: 整型，0~262143 -**默认值**：4 +**默认值**: 4 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/8-mot.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/8-mot.md index 7a089893..9582af39 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/8-mot.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/8-mot.md @@ -11,62 +11,62 @@ date: 2021-04-20 ## enable_codegen_mot -**参数说明**：设置是否启用原生LLVM Lite执行简单查询。如果当前平台上不支持原生LLVM，那么将使用伪LLVM。 +**参数说明**: 设置是否启用原生LLVM Lite执行简单查询。如果当前平台上不支持原生LLVM，那么将使用伪LLVM。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔值 +**取值范围**: 布尔值 -**默认值**：true +**默认值**: true ## force_pseudo_codegen_mot -**参数说明**：设置是否强制伪LLVM Lite执行简单查询，即使当前平台上支持原生LLVM。 +**参数说明**: 设置是否强制伪LLVM Lite执行简单查询，即使当前平台上支持原生LLVM。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔值 +**取值范围**: 布尔值 -**默认值**：true +**默认值**: true > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**：即使将force_pseudo_codegen_mot设置为true，而当前平台不支持原生LLVM，那么仍然会使用伪LLVM。 ## enable_codegen_mot_print -**参数说明**：设置是否打印生成函数的IR字节码（如果使用伪 LLVM，则打印伪IR字节码）。 +**参数说明**: 设置是否打印生成函数的IR字节码（如果使用伪 LLVM，则打印伪IR字节码）。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔值 +**取值范围**: 布尔值 -**默认值**：true +**默认值**: true ## codegen_mot_limit -**参数说明**：设置全局缓存计划源的数量限制以及每个会话的克隆计划。 +**参数说明**: 设置全局缓存计划源的数量限制以及每个会话的克隆计划。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：uint32 +**取值范围**: uint32 -**默认值**：100 +**默认值**: 100 ## mot_allow_index_on_nullable_column -**参数说明**：设置是否允许在内存表nullable列上创建索引。 +**参数说明**: 设置是否允许在内存表nullable列上创建索引。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔值 +**取值范围**: 布尔值 -**默认值**：true +**默认值**: true ## mot_config_file -**参数说明**：指定MOT的主配置文件。 +**参数说明**: 指定MOT的主配置文件。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：NULL +**默认值**: NULL diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md index a15fcb21..1cb96733 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/1-optimizer-method-configuration.md @@ -11,365 +11,365 @@ date: 2021-04-20 ## enable_bitmapscan -**参数说明**：控制优化器对位图扫描规划类型的使用。 +**参数说明**: 控制优化器对位图扫描规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## force_bitmapand -**参数说明**：控制优化器强制使用bitmapand规划类型的使用。 +**参数说明**: 控制优化器强制使用bitmapand规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_hashagg -**参数说明**：控制优化器对Hash聚集规划类型的使用。 +**参数说明**: 控制优化器对Hash聚集规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_hashjoin -**参数说明**：控制优化器对Hash连接规划类型的使用。 +**参数说明**: 控制优化器对Hash连接规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_indexscan -**参数说明**：控制优化器对索引扫描规划类型的使用。 +**参数说明**: 控制优化器对索引扫描规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_indexonlyscan -**参数说明**：控制优化器对仅索引扫描规划类型的使用。 +**参数说明**: 控制优化器对仅索引扫描规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_material -**参数说明**：控制优化器对实体化的使用。消除整个实体化是不可能的，但是可以关闭这个变量以防止优化器插入实体节点。 +**参数说明**: 控制优化器对实体化的使用。消除整个实体化是不可能的，但是可以关闭这个变量以防止优化器插入实体节点。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_mergejoin -**参数说明**：控制优化器对融合连接规划类型的使用。 +**参数说明**: 控制优化器对融合连接规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_nestloop -**参数说明**：控制优化器对内表全表扫描嵌套循环连接规划类型的使用。完全消除嵌套循环连接是不可能的，但是关闭这个变量就会让优化器在存在其他方法的时候优先选择其他方法。 +**参数说明**: 控制优化器对内表全表扫描嵌套循环连接规划类型的使用。完全消除嵌套循环连接是不可能的，但是关闭这个变量就会让优化器在存在其他方法的时候优先选择其他方法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_index_nestloop -**参数说明**：控制优化器对内表参数化索引扫描嵌套循环连接规划类型的使用。 +**参数说明**: 控制优化器对内表参数化索引扫描嵌套循环连接规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_seqscan -**参数说明**：控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的，但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。 +**参数说明**: 控制优化器对顺序扫描规划类型的使用。完全消除顺序扫描是不可能的，但是关闭这个变量会让优化器在存在其他方法的时候优先选择其他方法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_sort -**参数说明**：控制优化器使用的排序步骤。完全消除明确的排序是不可能的，但是关闭这个变量可以让优化器在存在其他方法的时候优先选择其他方法。 +**参数说明**: 控制优化器使用的排序步骤。完全消除明确的排序是不可能的，但是关闭这个变量可以让优化器在存在其他方法的时候优先选择其他方法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_tidscan -**参数说明**：控制优化器对TID扫描规划类型的使用。 +**参数说明**: 控制优化器对TID扫描规划类型的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_kill_query -**参数说明**：CASCADE模式删除用户时，会删除此用户拥有的所有对象。此参数标识是否允许在删除用户的时候，取消锁定此用户所属对象的query。 +**参数说明**: CASCADE模式删除用户时，会删除此用户拥有的所有对象。此参数标识是否允许在删除用户的时候，取消锁定此用户所属对象的query。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许取消锁定。 - off表示不允许取消锁定。 -**默认值**：off +**默认值**: off ## enforce_a_behavior -**参数说明**：控制正则表达式的规则匹配模式。 +**参数说明**: 控制正则表达式的规则匹配模式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示正则表达式采用A格式的匹配规则。 - off表示正则表达式采用POSIX格式的匹配规则。 -**默认值**：on +**默认值**: on ## max_recursive_times -**参数说明**：控制with recursive的最大迭代次数。 +**参数说明**: 控制with recursive的最大迭代次数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX。 +**取值范围**: 整型，0～INT_MAX。 -**默认值**：200 +**默认值**: 200 ## enable_vector_engine -**参数说明**：控制优化器对向量化执行引擎的使用。 +**参数说明**: 控制优化器对向量化执行引擎的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## enable_change_hjcost -**参数说明**：控制优化器在Hash Join代价估算路径选择时，是否使用将内表运行时代价排除在Hash Join节点运行时代价外的估算方式。如果使用，则有利于选择条数少，但运行代价大的表做内表。 +**参数说明**: 控制优化器在Hash Join代价估算路径选择时，是否使用将内表运行时代价排除在Hash Join节点运行时代价外的估算方式。如果使用，则有利于选择条数少，但运行代价大的表做内表。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_absolute_tablespace -**参数说明**：控制表空间是否可以使用绝对路径。 +**参数说明**: 控制表空间是否可以使用绝对路径。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以使用绝对路径。 - off表示不可以使用绝对路径。 -**默认值**：on +**默认值**: on ## enable_valuepartition_pruning -**参数说明**：是否对DFS分区表进行静态/动态优化。 +**参数说明**: 是否对DFS分区表进行静态/动态优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示对DFS分区表进行静态/动态优化。 - off表示不对DFS分区表进行静态/动态优化。 -**默认值**：on +**默认值**: on ## expected_computing_nodegroup -**参数说明**：标识选定的计算Node Group模式或目标计算Node Group。Node Group目前为内部用机制，用户无需设置。 +**参数说明**: 标识选定的计算Node Group模式或目标计算Node Group。Node Group目前为内部用机制，用户无需设置。 共4种计算Node Group模式，用于关联操作和聚集操作时选定计算Node Group。在每一种模式中，优化器有针对性地选定几个候选计算Node Group，然后根据代价，从中为当前算子挑选最佳计算Node Group。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - optimal：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前用户具有COMPUTE权限的所有Node Group包含的数据库节点构成的Node Group - query：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前查询涉及的所有基表所在Node Group包含的数据库节点构成的Node Group - Node Group名（[enable_nodegroup_debug](#enable_nodegroup_debug)被设置为off）：候选计算Node Group列表包含算子操作对象所在的Node Group和该指定的Node Group - Node Group名（[enable_nodegroup_debug](#enable_nodegroup_debug)被设置为on）：候选计算Node Group为指定的Node Group -**默认值**：query +**默认值**: query ## enable_nodegroup_debug -**参数说明**：控制优化器在多Node Group环境下，是否使用强制弹性计算。Node Group目前为内部用机制，用户无需设置。 +**参数说明**: 控制优化器在多Node Group环境下，是否使用强制弹性计算。Node Group目前为内部用机制，用户无需设置。 该参数只在[expected_computing_nodegroup](#expected_computing_nodegroup)被设置为具体Node Group时生效。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示强制将计算弹性到expected_computing_nodegroup所指定的Node Group进行计算。 - off表示不强制使用某个Node Group进行计算。 -**默认值**：off +**默认值**: off ## qrw_inlist2join_optmode -**参数说明**：控制是否使用inlist-to-join查询重写。 +**参数说明**: 控制是否使用inlist-to-join查询重写。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - disable: 关闭inlist2join查询重写。 - cost_base: 基于代价的inlist2join查询重写。 - rule_base: 基于规则的inlist2join查询重写，即强制使用inlist2join查询重写。 - 任意正整数: inlist2join查询重写阈值，即list内元素个数大于该阈值，进行inlist2join查询重写。 -**默认值**：cost_base +**默认值**: cost_base ## skew_option -**参数说明**：控制是否使用优化策略。 +**参数说明**: 控制是否使用优化策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - off: 关闭策略。 - normal: 采用激进策略。对于不确定是否出现倾斜的场景，认为存在倾斜，并进行相应优化。 - lazy: 采用保守策略。对于不确定是否出现倾斜场景，认为不存在倾斜，不进行优化。 -**默认值**：normal +**默认值**: normal ## default_limit_rows -**参数说明**：设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数，为负数时代表使用百分比的形式设置默认的估算值，负数转换为默认百分比，即-5代表5%。 +**参数说明**: 设置生成genericplan的缺省limit估算行数。此参数设置为正数时意为直接将设置的值作为估算limit的行数，为负数时代表使用百分比的形式设置默认的估算值，负数转换为默认百分比，即-5代表5%。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，-100~DBL_MAX。 +**取值范围**: 浮点型，-100~DBL_MAX。 -**默认值**：-10 +**默认值**: -10 ## check_implicit_conversions -**参数说明**：控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 +**参数说明**: 控制是否对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示对查询中有隐式类型转换的索引列是否会生成候选索引路径进行检查。 - off表示不进行相关检查。 -**默认值**：off +**默认值**: off ## cost_weight_index -**参数说明**：设置index_scan的代价权重。 +**参数说明**: 设置index_scan的代价权重。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，1e-10~1e+10。 +**取值范围**: 浮点型，1e-10~1e+10。 -**默认值**：1 +**默认值**: 1 ## try_vector_engine_strategy -**参数说明**：设置行存表走向量化执行引擎的策略。通过设置该参数，可以使包含行存表的查询可以转换为向量化的执行计划执行计算，从而提升类AP场景的复杂查询的执行性能。 +**参数说明**: 设置行存表走向量化执行引擎的策略。通过设置该参数，可以使包含行存表的查询可以转换为向量化的执行计划执行计算，从而提升类AP场景的复杂查询的执行性能。 该参数属于USERSET类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型 +**取值范围**: 枚举型 - off，为默认取值，表示关闭本功能，即行存表不会转换为向量的执行计划执行。 - force，表示只要查询中不包含向量化引擎不支持的类型或者表达式，则不论查询的基表为行存表、列存表，还是行列混合存储的，强制将查询转换为向量化的执行计划执行计算。在这种情况下，针对不同的查询场景可能出现性能下降。 - optimal，表示在force的基础上，由优化器根据查询的复杂度进行选择是否将查询语句转换为向量化的执行计划，尽可能避免转换为向量化的执行计划后出现性能下降。 -**默认值**：off +**默认值**: off diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/2-optimizer-cost-constants.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/2-optimizer-cost-constants.md index aecc306f..6dda2076 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/2-optimizer-cost-constants.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/2-optimizer-cost-constants.md @@ -11,17 +11,17 @@ date: 2021-04-20 ## seq_page_cost -**参数说明**：设置优化器计算一次顺序磁盘页面抓取的开销。 +**参数说明**: 设置优化器计算一次顺序磁盘页面抓取的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：1 +**默认值**: 1 ## random_page_cost -**参数说明**：设置优化器计算一次非顺序抓取磁盘页面的开销。 +**参数说明**: 设置优化器计算一次非顺序抓取磁盘页面的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -29,9 +29,9 @@ date: 2021-04-20 > > 虽然服务器允许将random_page_cost设置的比seq_page_cost小，但是物理上实际不受影响。如果所有数据库都位于随机访问内存中时，两者设置为相等很合理。因为在此种情况下，非顺序抓取页并没有副作用。同样，在缓冲率很高的数据库上，应该相对于CPU参数同时降低这两个值，因为获取内存中的页要比通常情况下开销小很多。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：4 +**默认值**: 4 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**： > @@ -40,37 +40,37 @@ date: 2021-04-20 ## cpu_tuple_cost -**参数说明**：设置优化器计算在一次查询中处理每一行数据的开销。 +**参数说明**: 设置优化器计算在一次查询中处理每一行数据的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：0.01 +**默认值**: 0.01 ## cpu_index_tuple_cost -**参数说明**：设置优化器计算在一次索引扫描中处理每条索引的开销。 +**参数说明**: 设置优化器计算在一次索引扫描中处理每条索引的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：0.005 +**默认值**: 0.005 ## cpu_operator_cost -**参数说明**：设置优化器计算一次查询中执行一个操作符或函数的开销。 +**参数说明**: 设置优化器计算一次查询中执行一个操作符或函数的开销。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：0.0025 +**默认值**: 0.0025 ## effective_cache_size -**参数说明**：设置优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。 +**参数说明**: 设置优化器在一次单一的查询中可用的磁盘缓冲区的有效大小。 设置这个参数，还要考虑MogDB的共享缓冲区以及内核的磁盘缓冲区。另外，还要考虑预计的在不同表之间的并发查询数目，因为它们将共享可用的空间。 @@ -78,18 +78,18 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX，单位为8KB。 +**取值范围**: 整型，1～INT_MAX，单位为8KB。 比默认值高的数值可能会导致使用索引扫描，更低的数值可能会导致选择顺序扫描。 -**默认值**：128MB +**默认值**: 128MB ## allocate_mem_cost -**参数说明**：设置优化器计算Hash Join创建Hash表开辟内存空间所需的开销，供Hash join估算不准时调优使用。 +**参数说明**: 设置优化器计算Hash Join创建Hash表开辟内存空间所需的开销，供Hash join估算不准时调优使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0～DBL_MAX。 +**取值范围**: 浮点型，0～DBL_MAX。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/3-genetic-query-optimizer.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/3-genetic-query-optimizer.md index c604834e..ab91194a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/3-genetic-query-optimizer.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/3-genetic-query-optimizer.md @@ -11,7 +11,7 @@ date: 2021-04-20 ## geqo -**参数说明**：控制基因查询优化的使用。 +**参数说明**: 控制基因查询优化的使用。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -19,16 +19,16 @@ date: 2021-04-20 > > 通常情况下在执行过程中不要关闭，geqo_threshold变量提供了更精细的控制GEQO的方法。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：on +**默认值**: on ## geqo_threshold -**参数说明**：如果执行语句的数量超过设计的FROM的项数，则会使用基因查询优化来执行查询。 +**参数说明**: 如果执行语句的数量超过设计的FROM的项数，则会使用基因查询优化来执行查询。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -37,13 +37,13 @@ date: 2021-04-20 > - 对于简单的查询，通常用详尽搜索方法，当涉及多个表的查询的时候，用GEQO可以更好的管理查询。 > - 一个FULL OUTER JOIN构造仅作为一个FROM项。 -**取值范围**：整型，2～INT_MAX。 +**取值范围**: 整型，2～INT_MAX。 -**默认值**：12 +**默认值**: 12 ## geqo_effort -**参数说明**：控制GEQO在规划时间和规划质量之间的平衡。 +**参数说明**: 控制GEQO在规划时间和规划质量之间的平衡。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -51,62 +51,62 @@ date: 2021-04-20 > > geqo_effort实际上并没有直接做任何事情，只是用于计算其他影响GEQO的变量的默认值。如果愿意，可以手工设置其他参数。 -**取值范围**：整型，1～10。 +**取值范围**: 整型，1～10。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > > 比默认值大的数值增加了查询规划的时间，但是也增加了选中有效查询的几率。 -**默认值**：5 +**默认值**: 5 ## geqo_pool_size -**参数说明**：控制GEQO使用池的大小，也就是基因全体中的个体数量。 +**参数说明**: 控制GEQO使用池的大小，也就是基因全体中的个体数量。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX。 +**取值范围**: 整型，0～INT_MAX。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > > 至少是2，且有用的值一般在100到1000之间。设置为0，表示使用系统自适应方式，MogDB会基于geqo_effort和表的个数选取合适的值。 -**默认值**：0 +**默认值**: 0 ## geqo_generations -**参数说明**：控制GEQO使用的算法的迭代次数。 +**参数说明**: 控制GEQO使用的算法的迭代次数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX。 +**取值范围**: 整型，0～INT_MAX。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > > 必须至少是1，且有用的值介于100和1000之间。如果设置为0，则基于geqo_pool_size选取合适的值。 -**默认值**：0 +**默认值**: 0 ## geqo_selection_bias -**参数说明**：控制GEQO的选择性偏好，即就是一个种群中的选择性压力。 +**参数说明**: 控制GEQO的选择性偏好，即就是一个种群中的选择性压力。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，1.5～2.0。 +**取值范围**: 浮点型，1.5～2.0。 -**默认值**：2 +**默认值**: 2 ## geqo_seed -**参数说明**：控制GEQO使用的随机数生产器的初始化值，用来从顺序连接在一起的查询空间中查找随机路径。 +**参数说明**: 控制GEQO使用的随机数生产器的初始化值，用来从顺序连接在一起的查询空间中查找随机路径。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～1.0。 +**取值范围**: 浮点型，0.0～1.0。 > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**： > > 不同的值会改变搜索的连接路径，从而影响了所找路径的优劣。 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md index 9f31a33a..4ffcbe97 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/9-query-planning/4-other-optimizer-options.md @@ -9,38 +9,38 @@ date: 2021-04-20 ## explain_dna_file -**参数说明**：指定explain_perf_mode为run，导出的csv信息的目标文件。 +**参数说明**: 指定explain_perf_mode为run，导出的csv信息的目标文件。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这个参数的取值必须是绝对路径加上.csv格式的文件名。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这个参数的取值必须是绝对路径加上.csv格式的文件名。 -**取值范围**：字符串 +**取值范围**: 字符串 -**默认值**：空 +**默认值**: 空 ## explain_perf_mode -**参数说明**：此参数用来指定explain的显示格式。 +**参数说明**: 此参数用来指定explain的显示格式。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：normal、pretty、summary、run +**取值范围**: normal、pretty、summary、run - normal：代表使用默认的打印格式。 - pretty：代表使用MogDB改进后的新显示格式。新的格式层次清晰，计划包含了plan node id，性能分析简单直接。 - summary：是在pretty的基础上增加了对打印信息的分析。 - run：在summary的基础上，将统计的信息输出到csv格式的文件中，以便于进一步分析。 -**默认值**：pretty（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal） +**默认值**: pretty（当前版本参数取值仅normal生效，若设置为非normal，显示格式依然为normal） ## analysis_options -**参数说明**：通过开启对应选项中所对应的功能选项使用相应的定位功能，包括数据校验，性能统计等，参见取值范围中的选项说明。 +**参数说明**: 通过开启对应选项中所对应的功能选项使用相应的定位功能，包括数据校验，性能统计等，参见取值范围中的选项说明。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。设置时，选择开启或者关闭的选项请使用'on()'或'off()'包括，未被显示指定的功能选项会维持原来的值，参考格式：'on(option1, option2, …)'。 -**取值范围**：字符串 +**取值范围**: 字符串 - LLVM_COMPILE表示在explain performance显示界面中显示每个线程的codegen编译时间。 @@ -48,13 +48,13 @@ date: 2021-04-20 - STREAM_DATA_CHECK表示对网络传输前后的数据进行CRC校验。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pretty模式当前版本不支持。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pretty模式当前版本不支持。 -**默认值**：ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 +**默认值**: ALL,on(),off(LLVM_COMPILE,HASH_CONFLICT,STREAM_DATA_CHECK)，不开启任何定位功能。 ## cost_param -**参数说明**：该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 +**参数说明**: 该参数用于控制在特定的客户场景中，使用不同的估算方法使得估算值与真实值更接近。此参数可以同时控制多种方法，与某一方法对应的位做与操作，不为0表示该方法被选择。 当cost_param & 1不为0，表示对于求不等值连接选择率时选择一种改良机制，此方法在自连接（两个相同的表之间连接）的估算中更加准确。目前，已弃用cost_param & 1不为0时的路径，默认选择更优的估算公式； @@ -62,26 +62,26 @@ date: 2021-04-20 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX +**取值范围**: 整型，0～INT_MAX -**默认值**：0 +**默认值**: 0 ## enable_partitionwise -**参数说明**：分区表连接操作是否选择智能算法。 +**参数说明**: 分区表连接操作是否选择智能算法。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示选择智能算法。 - off表示不选择智能算法。 -**默认值**：off +**默认值**: off ## rewrite_rule -**参数说明**：标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 +**参数说明**: 标识开启的可选查询重写规则。有部分查询重写规则是可选的，开启它们并不能总是对查询效率有提升效果。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 此参数可以控制查询重写规则的组合，比如有多个重写规则：rule1、rule2、rule3、rule4。可以设置： @@ -93,7 +93,7 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何可选查询重写规则。 - lazyagg：使用Lazy Agg查询重写规则（消除子查询中的聚集运算）。 @@ -106,62 +106,62 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 - predpushforce：使用Predicate Push查询重写规则（下推谓词条件到子查询中，尽可能的利用索引加速）。 - predpush：在predpushnormal和predpushforce中根据代价选择最优计划。 -**默认值**：magicset +**默认值**: magicset ## enable_pbe_optimization -**参数说明**：设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 +**参数说明**: 设置优化器是否对以PBE（Parse Bind Execute）形式执行的语句进行查询计划的优化。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示优化器将优化PBE语句的查询计划。 - off表示不使用优化。 -**默认值**：on +**默认值**: on ## enable_global_plancache -**参数说明**：设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 +**参数说明**: 设置是否对PBE查询的执行计划进行缓存共享，开启该功能可以节省高并发下数据库节点的内存使用。 在打开enable_global_plancache的情况下，为保证GPC生效，默认local_syscache_threshold不小于16MB。即如当前local_syscache_threshold小于16MB，则设置为16MB，如大于16MB，则不改变。 该参数属于POSTMASTER类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - on表示对PBE查询的执行计划进行缓存共享。 - off表示不共享。 -**默认值**：off +**默认值**: off ## gpc_clean_timeout -**参数说明**：开启enable_global_plancache的情况下，如果共享计划列表里的计划超过gpc_clean_timeout的时间没有被使用，则会被清理掉。本参数用于控制没有使用的共享计划的保留时间。 +**参数说明**: 开启enable_global_plancache的情况下，如果共享计划列表里的计划超过gpc_clean_timeout的时间没有被使用，则会被清理掉。本参数用于控制没有使用的共享计划的保留时间。 该参数属于SIGHUP类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，300~86400，单位为秒 +**取值范围**: 整型，300~86400，单位为秒 -**默认值**：1800，即30min +**默认值**: 1800，即30min ## enable_global_stats -**参数说明**：标识当前统计信息模式，区别采用全局统计信息收集模式还是单节点统计信息收集模式，默认创建为采用全局统计信息模式。当关闭该参数时，则默认收集MogDB第一个节点的统计信息，此时可能会影响生成查询计划的质量，但信息收集性能较优，建议客户谨慎考虑。 +**参数说明**: 标识当前统计信息模式，区别采用全局统计信息收集模式还是单节点统计信息收集模式，默认创建为采用全局统计信息模式。当关闭该参数时，则默认收集MogDB第一个节点的统计信息，此时可能会影响生成查询计划的质量，但信息收集性能较优，建议客户谨慎考虑。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on/true表示全局统计信息。 - off/false表示数据库节点统计信息。 -**默认值**：on +**默认值**: on ## enable_opfusion -**参数说明**：控制是否对简单增删改查进行优化。 +**参数说明**: 控制是否对简单增删改查进行优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 @@ -211,29 +211,29 @@ set rewrite_rule=none; --关闭所有可选查询重写规则 c3列修改的值可以是常量和参数，也可以是一个简单的表达式，c1和c2列为索引列，后边可以是常量或者参数。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_partition_opfusion -**参数说明**：在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 +**参数说明**: 在enable_opfusion参数打开的状态下，如果开启该参数，可以对分区表的简单查询进行查询优化，提升SQL执行性能。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## sql_beta_feature -**参数说明**：标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 +**参数说明**: 标识开启的可选SQL引擎Beta特性，其中包括对行数估算、查询等价估算等优化。 开启它们可以对特定的场景进行优化，但也可能会导致部分没有被测试覆盖的场景发生性能劣化。在特定的客户场景中，通过此GUC参数对查询重写规则进行设置，使得查询效率最优。 @@ -250,7 +250,7 @@ set sql_beta_feature=none; 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：字符串 +**取值范围**: 字符串 - none：不使用任何Beta优化器特性。 - sel_semi_poisson：使用泊松分布对等值的半连接和反连接选择率进行校准。 @@ -268,53 +268,53 @@ set sql_beta_feature=none; - partition_fdw_on：支持基于分区表创建postgres foreign table下的相关SQL。 - predpush_same_level：开启predpush hint控制同层参数化路径的功能。 -**默认值**：none +**默认值**: none ## ngram_gram_size -**参数说明**：ngram解析器分词的长度。 +**参数说明**: ngram解析器分词的长度。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～4 +**取值范围**: 整型，1～4 -**默认值**：2 +**默认值**: 2 ## ngram_grapsymbol_ignore -**参数说明**：ngram解析器是否忽略图形化字符。 +**参数说明**: ngram解析器是否忽略图形化字符。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示忽略图形化字符。 - off表示不忽略图形化字符。 -**默认值**：off +**默认值**: off ## ngram_punctuation_ignore -**参数说明**：ngram解析器是否忽略标点符号。 +**参数说明**: ngram解析器是否忽略标点符号。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示忽略标点符号。 - off表示不忽略标点符号。 -**默认值**：on +**默认值**: on ## default_statistics_target -**参数说明**：为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数时，代表统计信息的样本数量；设置为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 +**参数说明**: 为没有用ALTER TABLE SET STATISTICS设置字段目标的表设置缺省统计目标。此参数设置为正数时，代表统计信息的样本数量；设置为负数时，代表使用百分比的形式设置统计目标，负数转换为对应的百分比，即-5代表5%。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-100～10000。 +**取值范围**: 整型，-100～10000。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 比默认值大的正数数值增加了ANALYZE所需的时间，但是可能会改善优化器的估计质量。 > - 调整此参数可能存在性能劣化的风险，如果某个查询劣化，可以考虑： @@ -323,15 +323,15 @@ set sql_beta_feature=none; > - 当此guc参数设置为负数时，如果计算的采样样本数大于等于总数据量的2%，且用户表的数据量小于1600000时，ANALYZE所需时间相比guc参数为默认值的时间会有所增加。 > - 当此guc参数设置为负数时，则autoanalyze不生效。 -**默认值**：100 +**默认值**: 100 ## constraint_exclusion -**参数说明**：控制查询优化器使用表约束查询的优化。 +**参数说明**: 控制查询优化器使用表约束查询的优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - on表示检查所有表的约束。 @@ -339,378 +339,378 @@ set sql_beta_feature=none; - partition表示只检查继承的子表和UNION ALL子查询。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当constraint_exclusion为on，优化器用查询条件和表的CHECK约束比较，并且在查询条件和约束冲突的时候忽略对表的扫描。 -**默认值**：partition +**默认值**: partition -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 目前， constraint_exclusion缺省被打开，通常用来实现表分区。为所有的表打开它时，对于简单的查询强加了额外的规划，并且对简单查询没有什么好处。如果不用分区表，可以关掉它。 ## cursor_tuple_fraction -**参数说明**：优化器估计游标获取行数在总行数中的占比。 +**参数说明**: 优化器估计游标获取行数在总行数中的占比。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：浮点型，0.0～1.0。 +**取值范围**: 浮点型，0.0～1.0。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的值与使用 “fast start” 为游标规划的值相偏离，从而使得前几行恢复的很快而抓取全部的行需要很长的时间。比默认值大的值加大了总的估计的时间。在最大的值1.0处，像正常的查询一样规划游标，只考虑总的估计时间和传送第一行的时间。 -**默认值**：0.1 +**默认值**: 0.1 ## from_collapse_limit -**参数说明**：根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 +**参数说明**: 根据生成的FROM列表的项数来判断优化器是否将把子查询合并到上层查询，如果FROM列表项个数小于等于该参数值，优化器会将子查询合并到上层查询。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 比默认值小的数值将降低规划时间，但是可能生成差的执行计划。 -**默认值**：8 +**默认值**: 8 ## join_collapse_limit -**参数说明**：根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 +**参数说明**: 根据得出的列表项数来判断优化器是否执行把除FULL JOINS之外的JOIN构造重写到FROM列表中。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1～INT_MAX。 +**取值范围**: 整型，1～INT_MAX。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 设置为1会避免任何JOIN重排。这样就使得查询中指定的连接顺序就是实际的连接顺序。查询优化器并不是总能选取最优的连接顺序，高级用户可以选择暂时把这个变量设置为1，然后指定它们需要的连接顺序。 > - 比默认值小的数值减少规划时间但也降低了执行计划的质量。 -**默认值**：8 +**默认值**: 8 ## plan_mode_seed -**参数说明**：该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中： OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置guc参数值为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划。 如果设置guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 +**参数说明**: 该参数为调测参数，目前仅支持OPTIMIZE_PLAN和RANDOM_PLAN两种。其中： OPTIMIZE_PLAN表示通过动态规划算法进行代价估算的最优plan，参数值设置为0；RANDOM_PLAN表示随机生成的plan；如果设置guc参数值为-1，表示用户不指定随机数的种子标识符seed值，由优化器随机生成[1, 2147483647]范围整型值的随机数，并根据随机数生成随机的执行计划。 如果设置guc参数值为[1, 2147483647]范围的整型值，表示指定的生成随机数的种子标识符seed，优化器需要根据seed值生成随机的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，-1~ 2147483647 +**取值范围**: 整型，-1~ 2147483647 -**默认值**：0 +**默认值**: 0 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当该参数设置为随机执行计划模式时，优化器会生成不同的随机执行计划，该执行计划可能不是最优计划。因此在随机计划模式下，会对查询性能产生影响，所以建议在升级、扩容、缩容等正常业务操作或运维过程中将该参数保持为默认值0。 > - 当该参数不为0时，查询指定的plan hint不会生效。 ## hashagg_table_size -**参数说明**：用于设置执行HASH JOIN操作时HASH表的大小。 +**参数说明**: 用于设置执行HASH JOIN操作时HASH表的大小。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0～INT_MAX/2。 +**取值范围**: 整型，0～INT_MAX/2。 -**默认值**：0 +**默认值**: 0 ## enable_codegen -**参数说明**：标识是否允许开启代码生成优化，目前代码生成使用的是LLVM优化。 +**参数说明**: 标识是否允许开启代码生成优化，目前代码生成使用的是LLVM优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许开启代码生成优化。 - off表示不允许开启代码生成优化。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 目前LLVM优化仅支持向量化执行引擎特性和SQL on Hadoop特性，在其他场景下建议关闭此参数。 -**默认值**：on +**默认值**: on ## codegen_strategy -**参数说明**：标识在表达式codegen化过程中所使用的代码生成优化策略。 +**参数说明**: 标识在表达式codegen化过程中所使用的代码生成优化策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - partial表示当所计算表达式中即使包含部分未被codegen化的函数时，仍可借助表达式全codegen框架调用LLVM动态编译优化策略。 - pure表示当所计算表达式整体可被codegen化时，才考虑调用LLVM动态编译优化策略。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在开启代码生成优化会导致查询性能下降的场景下可以设置此参数为pure，其他场景下建议不改变此参数的默认值partial。 -**默认值**：partial +**默认值**: partial ## enable_codegen_print -**参数说明**：标识是否允许在log日志中打印所生成的LLVM IR函数。 +**参数说明**: 标识是否允许在log日志中打印所生成的LLVM IR函数。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许在log日志中打印IR函数。 - off表示不允许在log日志中打印IR函数。 -**默认值**：off +**默认值**: off ## codegen_cost_threshold -**参数说明**：由于LLVM编译生成最终的可执行机器码需要一定时间，因此只有当实际执行的代价大于编译生成机器码所需要的代码和优化后的执行代价之和时，利用代码生成才有收益。codegen_cost_threshold标识代价的阈值，当执行估算代价大于该代价时，使用LLVM优化。 +**参数说明**: 由于LLVM编译生成最终的可执行机器码需要一定时间，因此只有当实际执行的代价大于编译生成机器码所需要的代码和优化后的执行代价之和时，利用代码生成才有收益。codegen_cost_threshold标识代价的阈值，当执行估算代价大于该代价时，使用LLVM优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，0 ~ 2147483647。 +**取值范围**: 整型，0 ~ 2147483647。 -**默认值**：10000 +**默认值**: 10000 ## enable_bloom_filter -**参数说明**：标识是否允许使用BloomFilter优化。 +**参数说明**: 标识是否允许使用BloomFilter优化。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许使用BloomFilter优化。 - off表示不允许使用BloomFilter优化。 -**默认值**：on +**默认值**: on ## enable_extrapolation_stats -**参数说明**：标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性，但也存在错误推理导致估算过大的可能性，需要对于日期类型数据定期插入的场景开启此开关。 +**参数说明**: 标识对于日期类型是否允许基于历史统计信息使用推理估算的逻辑。使用该逻辑对于未及时收集统计信息的表可以增大估算准确的可能性，但也存在错误推理导致估算过大的可能性，需要对于日期类型数据定期插入的场景开启此开关。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许基于历史统计信息使用推理估算的逻辑。 - off表示不允许基于历史统计信息使用推理估算的逻辑。 -**默认值**：off +**默认值**: off ## autoanalyze -**参数说明**：标识是否允许在生成计划的时候，对于没有统计信息的表进行统计信息自动收集。对于外表和临时表，不支持autoanalyze，如果需要收集统计信息，用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常，当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作，以同步统计信息数据。 +**参数说明**: 标识是否允许在生成计划的时候，对于没有统计信息的表进行统计信息自动收集。对于外表和临时表，不支持autoanalyze，如果需要收集统计信息，用户需手动执行analyze操作。如果在auto analyze某个表的过程中数据库发生异常，当数据库正常运行之后再执行语句有可能仍提示需要收集此表的统计信息。此时需要用户对该表手动执行一次analyze操作，以同步统计信息数据。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许自动进行统计信息收集。 - off表示不允许自动进行统计信息收集。 -**默认值**：off +**默认值**: off ## enable_analyze_check -**参数说明**：标识是否允许在生成计划的时候，对于在pg_class中显示reltuples和relpages均为0的表，检查该表是否曾进行过统计信息收集。 +**参数说明**: 标识是否允许在生成计划的时候，对于在pg_class中显示reltuples和relpages均为0的表，检查该表是否曾进行过统计信息收集。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示允许检查。 - off表示不允许检查。 -**默认值**：off +**默认值**: off ## enable_sonic_hashagg -**参数说明**：标识是否依据规则约束使用基于面向列的hash表设计的Hash Agg算子。 +**参数说明**: 标识是否依据规则约束使用基于面向列的hash表设计的Hash Agg算子。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Agg算子。 - off表示不使用面向列的hash表设计的Hash Agg算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 在开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，查询对应的Hash Agg算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景enable_codegen打开后获得较大性能提升，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashagg，且查询达到约束条件使用基于面向列的hash表设计的Hash Agg算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为“Sonic Hash Aggregation”，而未达到该约束条件时，算子名称将显示为“Hash Aggregation”，Explain详解请参见[详解](2-introduction-to-the-sql-execution-plan#详解)。 -**默认值**：on +**默认值**: on ## enable_sonic_hashjoin -**参数说明**：标识是否依据规则约束使用基于面向列的hash表设计的Hash Join算子。 +**参数说明**: 标识是否依据规则约束使用基于面向列的hash表设计的Hash Join算子。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示在满足约束条件时使用基于面向列的hash表设计的Hash Join算子。 - off表示不使用面向列的hash表设计的Hash Join算子。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 当前开关仅适用于Inner Join的场景。 > - 在开启enable_sonic_hashjoin，查询对应的Hash Inner算子内存使用通常可获得精简。但对于代码生成技术可获得显著性能提升的场景，对应的算子查询性能可能会出现劣化。 > - 开启enable_sonic_hashjoin，且查询达到约束条件使用基于面向列的hash表设计的Hash Join算子时，在Explain Analyze/Performance的执行计划和执行信息中，算子显示为“Sonic Hash Join”，而未达到该约束条件时，算子名称将显示为“Hash Join”，Explain详解请参见[详解](2-introduction-to-the-sql-execution-plan#详解)。 -**默认值**：on +**默认值**: on ## enable_sonic_optspill -**参数说明**：标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时，在Hash Join算子下盘文件较多的时候，下盘文件数不会显著增加。 +**参数说明**: 标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时，在Hash Join算子下盘文件较多的时候，下盘文件数不会显著增加。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 - off表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。 -**默认值**：on +**默认值**: on ## log_parser_stats -**参数说明**：控制优化器输出parser模块的性能日志。 +**参数说明**: 控制优化器输出parser模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_planner_stats -**参数说明**：控制优化器输出planner模块的性能日志。 +**参数说明**: 控制优化器输出planner模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_executor_stats -**参数说明**：控制优化器输出executor模块的性能日志。 +**参数说明**: 控制优化器输出executor模块的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## log_statement_stats -**参数说明**：控制优化器输出该语句的性能日志。 +**参数说明**: 控制优化器输出该语句的性能日志。 该参数属于SUSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## plan_cache_mode -**参数说明**：标识在prepare语句中，选择生成执行计划的策略。 +**参数说明**: 标识在prepare语句中，选择生成执行计划的策略。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举类型 +**取值范围**: 枚举类型 - auto表示按照默认的方式选择custom plan或者generic plan。 - force_generic_plan表示强制走generic plan。 - force_custom_plan表示强制走custom plan。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此参数只对prepare语句生效，一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 > - custom plan是指对于preapre语句，在执行execute的时候，把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划，这种方案的优点是每次都按照具体的参数生成优选计划，执行性能比较好；缺点是每次执行前都需要重新生成计划，存在大量的重复的优化器开销。 > - generic plan是指对于preapre语句生成计划，该计划策略会在执行execute语句的时候把参数bind到plan中，然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销；缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的，部分bind参数场景下执行性能较差。 -**默认值**：auto +**默认值**: auto ## enable_hypo_index -**参数说明**：控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 +**参数说明**: 控制优化器执行EXPLAIN命令时是否考虑虚拟索引。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示使用。 - off表示不使用。 -**默认值**：off +**默认值**: off ## enable_force_vector_engine -**参数说明**：对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 +**参数说明**: 对于支持向量化的执行器算子，如果其子节点是非向量化的算子，通过设置此参数为on，强制生成向量化的执行计划。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示可以向量化的算子强制生成向量化。 - off表示由向量化算子优化器决定是否向量化。 -**默认值**：off +**默认值**: off ## enable_auto_explain -**参数说明**：控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 +**参数说明**: 控制是否开启自动打印执行计划。该参数是用来定位慢存储过程或慢查询，只对当前连接的数据库主节点有效。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - true表示开启。 - false表示关闭。 -**默认值**：false +**默认值**: false ## auto_explain_level -**参数说明**：控制自动打印执行计划的日志等级。 +**参数说明**: 控制自动打印执行计划的日志等级。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：枚举型，LOG或NOTICE。 +**取值范围**: 枚举型，LOG或NOTICE。 - LOG表示在日志中打印执行计划。 - NOTICE表示以提示的形式打印出计划。 -**默认值**：LOG +**默认值**: LOG ## query_dop -**参数说明**：用户自定义的查询并行度。 +**参数说明**: 用户自定义的查询并行度。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：整型，1~64。打开固定SMP功能，系统会使用固定并行度。 +**取值范围**: 整型，1~64。打开固定SMP功能，系统会使用固定并行度。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在开启并行查询后，请保证系统CPU、内存、网络等资源充足，以达到最佳效果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在开启并行查询后，请保证系统CPU、内存、网络等资源充足，以达到最佳效果。 -**默认值**：1 +**默认值**: 1 ## enable_startwith_debug -**参数说明**：该参数为start with/connect by用于debug的参数，打开参数可以显示start with特性所有涉及的尾列相关信息。 +**参数说明**: 该参数为start with/connect by用于debug的参数，打开参数可以显示start with特性所有涉及的尾列相关信息。 该参数属于USERSET类型参数，请参考表[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型。 +**取值范围**: 布尔型。 - true表示开启。 - false表示关闭。 -**默认值**：false +**默认值**: false diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_agent.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_agent.md index a933e42a..1da37f46 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_agent.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_agent.md @@ -9,203 +9,203 @@ date: 2022-05-23 ## log_dir -**参数说明**：log_dir决定存放cm_agent日志文件的目录。可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。 +**参数说明**: log_dir决定存放cm_agent日志文件的目录。可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。 -**取值范围**：字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：“log”，表示在$GAUSSLOG下对应的cm目录下生成cm_agent日志。 +**默认值**: “log”，表示在$GAUSSLOG下对应的cm目录下生成cm_agent日志。 ## log_file_size -**参数说明**：控制日志文件的大小。当日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 +**参数说明**: 控制日志文件的大小。当日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 -**取值范围**：整型，取值范围0~2047，单位为MB。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，取值范围0~2047，单位为MB。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：16MB +**默认值**: 16MB ## log_min_messages -**参数说明**：控制写到cm_agent日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 +**参数说明**: 控制写到cm_agent日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 -**取值范围**：枚举类型，有效值有debug5、debug1、warning、error、log、fatal。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 枚举类型，有效值有debug5、debug1、warning、error、log、fatal。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：warning +**默认值**: warning ## incremental_build -**参数说明**：控制重建备DN模式是否为增量。打开这个开关，则增量重建备DN；否则，全量重建备DN。 +**参数说明**: 控制重建备DN模式是否为增量。打开这个开关，则增量重建备DN；否则，全量重建备DN。 -**取值范围**：布尔型，有效值有on、off。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型，有效值有on、off。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：on +**默认值**: on ## alarm_component -**参数说明**：设置用于处理告警内容的告警组件的位置。 +**参数说明**: 设置用于处理告警内容的告警组件的位置。 -**取值范围**：字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - 若前置脚本gs_preinstall中的–alarm-type参数设置为5时，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为：/opt/snas/bin/snas_cm_cmd。 - 若前置脚本gs_preinstall中的–alarm-type参数设置为1时，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 -**默认值**：/opt/snas/bin/snas_cm_cmd +**默认值**: /opt/snas/bin/snas_cm_cmd ## alarm_report_interval -**参数说明**：指定告警上报的时间间隔。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**参数说明**: 指定告警上报的时间间隔。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**取值范围**：非负整型，单位为秒。 +**取值范围**: 非负整型，单位为秒。 -**默认值**：1 +**默认值**: 1 ## alarm_report_max_count -**参数说明**：指定告警上报的最大次数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**参数说明**: 指定告警上报的最大次数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**取值范围**：非负整型。 +**取值范围**: 非负整型。 -**默认值**：1 +**默认值**: 1 ## agent_report_interval -**参数说明**：cm_agent上报实例状态的时间间隔。 +**参数说明**: cm_agent上报实例状态的时间间隔。 -**取值范围**：整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## agent_phony_dead_check_interval -**参数说明**：cm_agent检测DN进程是否僵死的时间间隔。 +**参数说明**: cm_agent检测DN进程是否僵死的时间间隔。 -**取值范围**：整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10 +**默认值**: 10 ## agent_check_interval -**参数说明**：cm_agent查询DN等实例状态的时间间隔。 +**参数说明**: cm_agent查询DN等实例状态的时间间隔。 -**取值范围**：整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：2 +**默认值**: 2 ## agent_heartbeat_timeout -**参数说明**：cm_server心跳超时时间。 +**参数说明**: cm_server心跳超时时间。 -**取值范围**：整型，2~231 - 1，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，2~231 - 1，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：8 +**默认值**: 8 ## agent_connect_timeout -**参数说明**：cm_agent连接cm_server超时时间。 +**参数说明**: cm_agent连接cm_server超时时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## agent_connect_retries -**参数说明**：cm_agent连接cm_server尝试次数。 +**参数说明**: cm_agent连接cm_server尝试次数。 -**取值范围**：整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：15 +**默认值**: 15 ## agent_kill_instance_timeout -**参数说明**：当cm_agent在无法连接cm_server主节点后，发起一次杀死本节点上所有实例的操作之前，所需等待的时间间隔。 +**参数说明**: 当cm_agent在无法连接cm_server主节点后，发起一次杀死本节点上所有实例的操作之前，所需等待的时间间隔。 -**取值范围**：整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：0，不发起杀死本节点上所有实例的操作。 +**默认值**: 0，不发起杀死本节点上所有实例的操作。 ## security_mode -**参数说明**：控制是否以安全模式启动DN。打开这个开关，则以安全模式启动DN；否则，以非安全模式启动DN。 +**参数说明**: 控制是否以安全模式启动DN。打开这个开关，则以安全模式启动DN；否则，以非安全模式启动DN。 -**取值范围**：布尔型，有效值有on、off。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型，有效值有on、off。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：off +**默认值**: off ## upgrade_from -**参数说明**：就地升级过程中使用，用于标示升级前数据库的内部版本号，此参数禁止手动修改。 +**参数说明**: 就地升级过程中使用，用于标示升级前数据库的内部版本号，此参数禁止手动修改。 -**取值范围**：非负整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 非负整型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：0 +**默认值**: 0 ## process_cpu_affinity -**参数说明**：控制是否以绑核优化模式启动主DN进程。配置该参数为0，则不进行绑核优化；否则，进行绑核优化，且物理CPU片数为2n个。数据库、cm_agent重启生效。仅支持ARM。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**参数说明**: 控制是否以绑核优化模式启动主DN进程。配置该参数为0，则不进行绑核优化；否则，进行绑核优化，且物理CPU片数为2n个。数据库、cm_agent重启生效。仅支持ARM。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**取值范围**：整型，0~2。 +**取值范围**: 整型，0~2。 -**默认值**：0 +**默认值**: 0 ## log_threshold_check_interval -**参数说明**：日志压缩和清除的时间间隔，每1800秒压缩和清理一次。 +**参数说明**: 日志压缩和清除的时间间隔，每1800秒压缩和清理一次。 -**取值范围**：整型，0~2147483647，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~2147483647，单位为秒。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1800 +**默认值**: 1800 ## dilatation_shard_count_for_disk_capacity_alarm -**参数说明**：扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。 +**参数说明**: 扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该分片数请与实际扩容分片数设置为一致。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该分片数请与实际扩容分片数设置为一致。 -**取值范围**：整型，0~232 - 1，单位为个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~232 - 1，单位为个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## log_max_size -**参数说明**：控制日志最大存储值。 +**参数说明**: 控制日志最大存储值。 -**取值范围**：整型，0~2147483647，单位为MB。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~2147483647，单位为MB。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10240 +**默认值**: 10240 ## log_max_count -**参数说明**：硬盘上可存储的最多日志数量。 +**参数说明**: 硬盘上可存储的最多日志数量。 -**取值范围**：整型，0~10000，单位为个。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~10000，单位为个。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10000 +**默认值**: 10000 ## log_saved_days -**参数说明**：日志保存的天数。 +**参数说明**: 日志保存的天数。 -**取值范围**：整型，0~1000，单位为天。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~1000，单位为天。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：90 +**默认值**: 90 ## enable_log_compress -**参数说明**：控制压缩日志功能。 +**参数说明**: 控制压缩日志功能。 -**取值范围**：布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - on表示允许压缩日志。 - off表示不允许压缩日志。 -**默认值**：on +**默认值**: on ## log_pattern_%s -**参数说明**：enable_log_compress=on时使用，定义压缩日志的格式，压缩含有关键字%s的所有日志，%s为服务端工具名称。 +**参数说明**: enable_log_compress=on时使用，定义压缩日志的格式，压缩含有关键字%s的所有日志，%s为服务端工具名称。 -**取值范围**：表1中所有参数对应的值。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 表1中所有参数对应的值。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：表1 中各参数对应的默认值。不支持用户修改默认值。 +**默认值**: 表1 中各参数对应的默认值。不支持用户修改默认值。 **表 1** @@ -262,53 +262,53 @@ date: 2022-05-23 ## agent_backup_open -**参数说明**：灾备数据库实例设置，开启后CM按照灾备数据库实例模式运行。 +**参数说明**: 灾备数据库实例设置，开启后CM按照灾备数据库实例模式运行。 -**取值范围**：整型，0~1。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 +**取值范围**: 整型，0~1。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 - 0表示关闭。 - 1表示开启。 -**默认值**：0 +**默认值**: 0 ## enable_xc_maintenance_mode -**参数说明**：在数据库实例为只读模式下，控制是否可以修改pgxc_node系统表。 +**参数说明**: 在数据库实例为只读模式下，控制是否可以修改pgxc_node系统表。 -**取值范围**：布尔型。参数修改请参考[GUC参数分类](30-appendix)进行设置。 +**取值范围**: 布尔型。参数修改请参考[GUC参数分类](30-appendix)进行设置。 - on表示开启可以修改pgxc_node系统表功能。 - off表示关闭可以修改pgxc_node系统表功能。 -**默认值**：on +**默认值**: on ## unix_socket_directory -**参数说明**：unix套接字的目录位置。 +**参数说明**: unix套接字的目录位置。 -**取值范围**：字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 +**取值范围**: 字符串。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 **默认值：”** ## enable_dcf -**参数说明**：DCF模式开关。 +**参数说明**: DCF模式开关。 -**取值范围**：布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 - 0表示关闭。 - 1表示开启。 -**默认值**：off +**默认值**: off ## disaster_recovery_type -**参数说明**：主备数据库实例灾备关系的类型。 +**参数说明**: 主备数据库实例灾备关系的类型。 -**取值范围**：整型，0~2。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 +**取值范围**: 整型，0~2。修改后需要重启cm_agent才能生效。参数修改请参考[GUC参数分类](30-appendix)进行设置。 - 0表示未搭建灾备关系。 - 1表示搭建了obs灾备关系。 - 2表示搭建了流式灾备关系 -**默认值**：0 +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_server.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_server.md index 75626c04..6accb2a4 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_server.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/cm-parameters/cm_server.md @@ -9,383 +9,383 @@ date: 2022-05-23 ## log_dir -**参数说明**：log_dir决定存放cm_server日志文件的目录。它可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。 +**参数说明**: log_dir决定存放cm_server日志文件的目录。它可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。 -**取值范围**：字符串。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：“log”，表示在$GAUSSLOG下对应的cm目录下生成cm_server日志。 +**默认值**: “log”，表示在$GAUSSLOG下对应的cm目录下生成cm_server日志。 ## log_file_size -**参数说明**：控制日志文件的大小。当日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 +**参数说明**: 控制日志文件的大小。当日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 -**取值范围**：整型，取值范围0~2047，单位为MB。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，取值范围0~2047，单位为MB。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：16MB +**默认值**: 16MB ## log_min_messages -**参数说明**：控制写到cm_server日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 +**参数说明**: 控制写到cm_server日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 -**取值范围**：枚举类型，有效值有debug5、debug1、log、warning、error、fatal。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 枚举类型，有效值有debug5、debug1、log、warning、error、fatal。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：warning +**默认值**: warning ## thread_count -**参数说明**：cm_server线程池的线程数。 +**参数说明**: cm_server线程池的线程数。 -**取值范围**：整型，2~1000。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，2~1000。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1000 +**默认值**: 1000 ## alarm_component -**参数说明**：设置用于处理告警内容的告警组件的位置。 +**参数说明**: 设置用于处理告警内容的告警组件的位置。 -**取值范围**：字符串。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - 若前置脚本gs_preinstall中的–alarm-type参数设置为5时，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为：/opt/snas/bin/snas_cm_cmd。 - 若前置脚本gs_preinstall中的–alarm-type参数设置为1时，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。 -**默认值**：/opt/snas/bin/snas_cm_cmd +**默认值**: /opt/snas/bin/snas_cm_cmd ## instance_failover_delay_timeout -**参数说明**：cm_server检测到主机宕机，failover备机的延迟时间。 +**参数说明**: cm_server检测到主机宕机，failover备机的延迟时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：0 +**默认值**: 0 ## instance_heartbeat_timeout -**参数说明**：实例心跳超时时间。 +**参数说明**: 实例心跳超时时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：6 +**默认值**: 6 ## cmserver_ha_connect_timeout -**参数说明**：cm_server主备连接超时时间。 +**参数说明**: cm_server主备连接超时时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：2 +**默认值**: 2 ## cmserver_ha_heartbeat_timeout -**参数说明**：cm_server主备心跳超时时间。 +**参数说明**: cm_server主备心跳超时时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：6 +**默认值**: 6 ## phony_dead_effective_time -**参数说明**：用于DN进程的僵死检测，当检测到的僵死次数大于该参数值，认为进程僵死，将进程重启。 +**参数说明**: 用于DN进程的僵死检测，当检测到的僵死次数大于该参数值，认为进程僵死，将进程重启。 -**取值范围**：整型，单位为次数。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为次数。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：5 +**默认值**: 5 ## enable_transaction_read_only -**参数说明**：控制数据库是否为只读模式开关。 +**参数说明**: 控制数据库是否为只读模式开关。 -**取值范围**：布尔型，有效值有on，off，true，false，yes，no，1，0。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型，有效值有on，off，true，false，yes，no，1，0。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：on +**默认值**: on ## datastorage_threshold_check_interval -**参数说明**：检测磁盘占用的时间间隔。间隔用户指定时间，检测一次磁盘占用。 +**参数说明**: 检测磁盘占用的时间间隔。间隔用户指定时间，检测一次磁盘占用。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10 +**默认值**: 10 ## datastorage_threshold_value_check -**参数说明**：设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。 +**参数说明**: 设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。 -**取值范围**：整型，1 ~ 99，表示百分比。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，1 ~ 99，表示百分比。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：85 +**默认值**: 85 ## max_datastorage_threshold_check -**参数说明**：设置磁盘使用率的最大检测间隔时间。当用户手动修改只读模式参数后，会自动在指定间隔时间后开启磁盘满检测操作。 +**参数说明**: 设置磁盘使用率的最大检测间隔时间。当用户手动修改只读模式参数后，会自动在指定间隔时间后开启磁盘满检测操作。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：43200 +**默认值**: 43200 ## cmserver_ha_status_interval -**参数说明**：cm_server主备同步状态信息间隔时间。 +**参数说明**: cm_server主备同步状态信息间隔时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## cmserver_self_vote_timeout -**参数说明**：cm_server自仲裁超时时间。 +**参数说明**: cm_server自仲裁超时时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)行设置。 -**默认值**：6 +**默认值**: 6 ## alarm_report_interval -**参数说明**：指定告警上报的时间间隔。 +**参数说明**: 指定告警上报的时间间隔。 -**取值范围**：非负整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 非负整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：3 +**默认值**: 3 ## alarm_report_max_count -**参数说明**：指定告警上报的最大次数。 +**参数说明**: 指定告警上报的最大次数。 -**取值范围**：非负整型。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 非负整型。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## enable_az_auto_switchover -**参数说明**：AZ自动切换开关，若打开，则表示允许cm_server自动切换AZ。否则当发生dn故障等情况时，即使当前AZ已经不再可用，也不会自动切换到其它AZ上，除非手动执行切换命令。 +**参数说明**: AZ自动切换开关，若打开，则表示允许cm_server自动切换AZ。否则当发生dn故障等情况时，即使当前AZ已经不再可用，也不会自动切换到其它AZ上，除非手动执行切换命令。 -**取值范围**：非负整型，0或1，0表示开关关闭，1表示开关打开。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 非负整型，0或1，0表示开关关闭，1表示开关打开。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## instance_keep_heartbeat_timeout -**参数说明**：cm_agent会定期检测实例状态并上报给cm_server，若实例状态长时间无法成功检测，累积次数超出该数值，则cm_server将下发命令给agent重启该实例。 +**参数说明**: cm_agent会定期检测实例状态并上报给cm_server，若实例状态长时间无法成功检测，累积次数超出该数值，则cm_server将下发命令给agent重启该实例。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：40 +**默认值**: 40 ## az_switchover_threshold -**参数说明**：若一个AZ内DN分片的故障率（故障的dn分片数 / 总dn分片数 * 100%）超过该数值，则会触发AZ自动切换。 +**参数说明**: 若一个AZ内DN分片的故障率（故障的dn分片数 / 总dn分片数 * 100%）超过该数值，则会触发AZ自动切换。 -**取值范围**：整型，0~100。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~100。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：100 +**默认值**: 100 ## az_check_and_arbitrate_interval -**参数说明**：当某个AZ状态不正常时，会触发AZ自动切换，该参数是检测AZ状态的时间间隔。 +**参数说明**: 当某个AZ状态不正常时，会触发AZ自动切换，该参数是检测AZ状态的时间间隔。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：2 +**默认值**: 2 ## az_connect_check_interval -**参数说明**：定时检测AZ间的网络连接，该参数表示连续两次检测之间的间隔时间。 +**参数说明**: 定时检测AZ间的网络连接，该参数表示连续两次检测之间的间隔时间。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：60 +**默认值**: 60 ## az_connect_check_delay_time -**参数说明**：每次检测AZ间的网络连接时有多次重试，该参数表示两次重试之间的延迟时间**。** +**参数说明**: 每次检测AZ间的网络连接时有多次重试，该参数表示两次重试之间的延迟时间**。** -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：150 +**默认值**: 150 ## cmserver_demote_delay_on_etcd_fault -**参数说明**：因为etcd不健康而导致cm_server从主降为备的时间间隔**。** +**参数说明**: 因为etcd不健康而导致cm_server从主降为备的时间间隔**。** -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：8 +**默认值**: 8 ## instance_phony_dead_restart_interval -**参数说明**：当dn实例僵死时，会被cm_agent重启，相同的实例连续因僵死被杀时，其间隔时间不能小于该参数数值，否则cm_agent不会下发命令**。** +**参数说明**: 当dn实例僵死时，会被cm_agent重启，相同的实例连续因僵死被杀时，其间隔时间不能小于该参数数值，否则cm_agent不会下发命令**。** -**取值范围**：整型，单位为秒。最小生效值为1800，如果设置小于此值实际生效值为1800。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。最小生效值为1800，如果设置小于此值实际生效值为1800。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：21600 +**默认值**: 21600 ## cm_auth_method -**参数说明**：CM模块端口认证方式，trust表示未配置端口认证，gss表示采用kerberos端口认证。必须注意的是：只有当kerberos服务端和客户端成功安装后才能修改为gss，否则CM模块无法正常通信，将影响数据库状态。 +**参数说明**: CM模块端口认证方式，trust表示未配置端口认证，gss表示采用kerberos端口认证。必须注意的是：只有当kerberos服务端和客户端成功安装后才能修改为gss，否则CM模块无法正常通信，将影响数据库状态。 -**取值范围**：枚举类型，有效值有trust, gss。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 枚举类型，有效值有trust, gss。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：trust +**默认值**: trust ## cm_krb_server_keyfile -**参数说明**：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与数据库运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响数据库状态 +**参数说明**: kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与数据库运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响数据库状态 -**取值范围**：字符串类型，修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串类型，修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示 +**默认值**: ${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示 ## cm_server_arbitrate_delay_base_time_out -**参数说明**：cm_server仲裁延迟基础时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数 +**参数说明**: cm_server仲裁延迟基础时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数 -**取值范围**：整型，index>0，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，index>0，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10 +**默认值**: 10 ## cm_server_arbitrate_delay_incrememtal_time_out -**参数说明**：cm_server仲裁延迟增量时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数 +**参数说明**: cm_server仲裁延迟增量时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数 -**取值范围**：整型，index>0，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，index>0，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：3 +**默认值**: 3 ## force_promote -**参数说明**：cm_server是否打开强起逻辑（指数据库状态为Unknown的时候以丢失部分数据为代价保证数据库基本功能可用）的开关。0代表功能关闭，1代表功能开启。该参数同时适用于dn。 +**参数说明**: cm_server是否打开强起逻辑（指数据库状态为Unknown的时候以丢失部分数据为代价保证数据库基本功能可用）的开关。0代表功能关闭，1代表功能开启。该参数同时适用于dn。 -**取值范围**：整型，0~1。在cm_server上修改后需要重启cm_server才能生效。 +**取值范围**: 整型，0~1。在cm_server上修改后需要重启cm_server才能生效。 -**默认值**：0 +**默认值**: 0 ## switch_rto -**参数说明**：cm_server强起逻辑等待时延。在force_promote被置为1时，当数据库的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。 +**参数说明**: cm_server强起逻辑等待时延。在force_promote被置为1时，当数据库的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。 -**取值范围**：整型，60~2147483647，单位为秒。修改后需要重启cm_server才能生效。 +**取值范围**: 整型，60~2147483647，单位为秒。修改后需要重启cm_server才能生效。 -**默认值**：0 +**默认值**: 0 ## backup_open -**参数说明**：灾备数据库实例设置，开启后CM按照灾备数据库实例模式运行 +**参数说明**: 灾备数据库实例设置，开启后CM按照灾备数据库实例模式运行 -**取值范围**：整型，0~1。修改后需要重启cm_server才能生效。非灾备数据库实例不能开启该参数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~1。修改后需要重启cm_server才能生效。非灾备数据库实例不能开启该参数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - 0表示关闭。 - 1表示开启。 -**默认值**：0 +**默认值**: 0 ## enable_dcf -**参数说明**：DCF模式开关。 +**参数说明**: DCF模式开关。 -**取值范围**：布尔型。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - 0表示关闭。 - 1表示开启。 -**默认值**：off +**默认值**: off ## install_type -**参数说明**：容灾数据库实例相关的设置，用来区别是否是基于dorado的数据库实例。 +**参数说明**: 容灾数据库实例相关的设置，用来区别是否是基于dorado的数据库实例。 -**取值范围**：整型，0~2。修改后需要重启cm_server才能生效。非灾备数据库实例不能开启该参数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0~2。修改后需要重启cm_server才能生效。非灾备数据库实例不能开启该参数。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - 0表示未搭建容灾关系的数据库实例。 - 1表示基于dorado的数据库实例。 - 2表示基于流式的数据库实例。 -**默认值**：0 +**默认值**: 0 ## enable_ssl -**参数说明**：ssl证书开关。 +**参数说明**: ssl证书开关。 -**取值范围**：布尔型。打开后使用ssl证书加密通信。修改后需要重启才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 布尔型。打开后使用ssl证书加密通信。修改后需要重启才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 - on表示启用ssl。 - off表示不启用ssl。 -- **默认值**：off +- **默认值**: off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 出于安全性考虑，建议不要关闭该配置。关闭后cm将**不使用**加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 出于安全性考虑，建议不要关闭该配置。关闭后cm将**不使用**加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。 ## ssl_cert_expire_alert_threshold -**参数说明**：ssl证书过期告警时间。 +**参数说明**: ssl证书过期告警时间。 -**取值范围**：整型，单位为天。证书过期时间少于该时间时，上报证书即将过期告警。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为天。证书过期时间少于该时间时，上报证书即将过期告警。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：90 +**默认值**: 90 ## ssl_cert_expire_check_interval -**参数说明**：ssl证书过期检测周期。 +**参数说明**: ssl证书过期检测周期。 -**取值范围**：整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：86400 +**默认值**: 86400 ## delay_arbitrate_timeout -**参数说明**：设置等待跟主DN同AZ节点redo回放，优先选择同AZ升主的时间。 +**参数说明**: 设置等待跟主DN同AZ节点redo回放，优先选择同AZ升主的时间。 -**取值范围**：整型，[0, 21474836]，单位：秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，[0, 21474836]，单位：秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：0 +**默认值**: 0 ## ddb_type -**参数说明**：etcd，dcc模式切换开关。 +**参数说明**: etcd，dcc模式切换开关。 -**取值范围**：整型。0：etcd；1：dcc。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型。0：etcd；1：dcc。修改后需要重启cm_server才能生效。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：0 +**默认值**: 0 ## ddb_log_level -**参数说明**：设置ddb日志级别。 +**参数说明**: 设置ddb日志级别。 关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。 开启日志：“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空串。 -**取值范围**：字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE +**默认值**: RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE ## ddb_log_backup_file_count -**参数说明**：最大保存日志文件个数。 +**参数说明**: 最大保存日志文件个数。 -**取值范围**：整型，[1, 100]。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，[1, 100]。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10 +**默认值**: 10 ## ddb_max_log_file_size -**参数说明**：单条日志最大字节数。 +**参数说明**: 单条日志最大字节数。 -**取值范围**：字符串，[1M, 1000M]。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 字符串，[1M, 1000M]。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：10M +**默认值**: 10M ## ddb_log_suppress_enable -**参数说明**：是否开启日志抑制功能。 +**参数说明**: 是否开启日志抑制功能。 -**取值范围**：整型，0：关闭；1：开启。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，0：关闭；1：开启。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：1 +**默认值**: 1 ## ddb_election_timeout -**参数说明**：dcc选举超时时间。 +**参数说明**: dcc选举超时时间。 -**取值范围**：整型，[1, 600],单位：秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 +**取值范围**: 整型，[1, 600],单位：秒。参数修改请参考[GUC参数设置方式](30-appendix)进行设置。 -**默认值**：3 +**默认值**: 3 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/global-syscache-parameters.md b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/global-syscache-parameters.md index 1434f35d..a6fb44f7 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/global-syscache-parameters.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/guc-parameters/global-syscache-parameters.md @@ -9,28 +9,28 @@ date: 2022-05-23 ## enable_global_syscache -**参数说明**：控制是否使用全局系统缓存功能。该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 +**参数说明**: 控制是否使用全局系统缓存功能。该参数属于POSTMASTER类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 -**取值范围**：布尔型 +**取值范围**: 布尔型 - on表示开启全局系统缓存功能。 - off表示不开启全局系统缓存功能。 -**默认值**：on +**默认值**: on 推荐结合线程池参数使用。打开该参数后，如果需要访问备机，建议设置备机wal_level级别为hot_standby以上。 ## global_syscache_threshold -**参数说明**：全局系统缓存内存最大占用大小。 +**参数说明**: 全局系统缓存内存最大占用大小。 该参数属于PGC_SIGHUP类型参数，请参考[GUC参数分类](30-appendix)中对应设置方法进行设置。 需要打开enable_global_syscache参数。 -**取值范围**：整型，16384~1073741824，单位为kB。 +**取值范围**: 整型，16384~1073741824，单位为kB。 -**默认值**：163840 +**默认值**: 163840 推荐计算公式：热点DB个数和线程个数的最小值乘以每个DB分配的内存大小 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md b/product/zh/docs-mogdb/v3.0/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md index adc81d33..c58d9a0a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/schema/DBE_PLDEBUGGER-schema/overview-of-DBE_PLDEBUGGER-schema.md @@ -9,7 +9,7 @@ date: 2021-11-15 DBE_PLDEBUGGER下系统函数用于单机下调试存储过程，目前支持的接口及其描述如下所示。仅管理员有权限执行这些调试接口。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，调用attach、next、continue、 info_code、step、info_breakpoint、backtrace、 finish中会返回密码的明文。因此不建议用户在函数体中创建用户。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，调用attach、next、continue、 info_code、step、info_breakpoint、backtrace、 finish中会返回密码的明文。因此不建议用户在函数体中创建用户。 对应权限角色为gs_role_pldebugger，可以由管理员用户通过如下命令将debugger权限赋权给该用户。 @@ -111,9 +111,9 @@ GRANT gs_role_pldebugger to user; t (1 row) ``` - + client端查看代码信息并识别可以设置断点行号。 - + ```sql MogDB=# SELECT * FROM DBE_PLDEBUGGER.info_code(16389); lineno | query | canbreak @@ -127,9 +127,9 @@ GRANT gs_role_pldebugger to user; 6 | / | f (7 rows) ``` - + 设置断点。 - + ```sql MogDB=# SELECT * FROM DBE_PLDEBUGGER.add_breakpoint(16389,4); lineno | query | canbreak @@ -143,9 +143,9 @@ GRANT gs_role_pldebugger to user; 6 | / | f (7 rows) ``` - + 查看断点信息。 - + ```sql MogDB=# SELECT * FROM DBE_PLDEBUGGER.info_breakpoints(); breakpointno | funcoid | lineno | query | enable @@ -153,9 +153,9 @@ GRANT gs_role_pldebugger to user; 0 | 16389 | 4 | DELETE FROM t1 WHERE a = x; | t (1 row) ``` - + 执行至断点。 - + ```sql MogDB=# SELECT * FROM DBE_PLDEBUGGER.continue(); funcoid | funcname | lineno | query @@ -163,11 +163,11 @@ GRANT gs_role_pldebugger to user; 16389 | test_debug | 4 | DELETE FROM t1 WHERE a = x; (1 row) ``` - + 存储过程执行结束后，调试会自动退出，再进行调试需要重新attach关联。如果server端不需要继续调试，可执行turn_off关闭，或退出session。具体调试接口请见下面列表。 - + **表 1** DBE_PLDEBUGGER - + | 接口名称 | 描述 | | :----------------------------------------------------------- | :----------------------------------------------------------- | | [DBE_PLDEBUGGER.turn_on](DBE_PLDEBUGGER.turn_on) | server端调用，标记存储过程可以调试，调用后执行该存储过程时会hang住等待调试信息。 | diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/2-keywords.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/2-keywords.md index 31abca86..225dc298 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/2-keywords.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/2-keywords.md @@ -15,7 +15,7 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 - 标识符必须以字母（a-z）或下划线（_）开头。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 此命名规范为建议项，非强制项。 > - 特殊情况下可以使用双引号规避特殊字符报错。 @@ -207,4 +207,4 @@ SQL里有保留字和非保留字之分。根据标准，保留字决不能用 | XMLPARSE | col-name | | XMLPI | col-name | | XMLROOT | col-name | -| XMLSERIALIZE | col-name | \ No newline at end of file +| XMLSERIALIZE | col-name | diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md index c13008a4..dfb4bcc8 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/1-simple-expressions.md @@ -35,7 +35,7 @@ date: 2021-05-17 expression NOTNULL - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 不要写expression=NULL或expression<>(!=)NULL，因为NULL代表一个未知的值，不能通过该表达式判断两个未知值是否相等。 - is distinct from/is not distinct from diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md index ba703d78..93a125d4 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/4-expressions/4-array-expressions.md @@ -43,7 +43,7 @@ MogDB=# SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; 如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在所有情况下X NOT IN Y等价于NOT(X IN Y)。 ## ANY/SOME (array) @@ -70,7 +70,7 @@ MogDB=# SELECT 8000+500 < ANY (array[10000,9000]) AS RESULT; - 如果对比结果没有真值，则ANY的结果为false。 - 如果结果没有真值，并且数组表达式生成至少一个值为null，则ANY的值为NULL，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** SOME是ANY的同义词。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: SOME是ANY的同义词。 ## ALL (array) diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/2-operators.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/2-operators.md index 3e735a24..8091ea28 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/2-operators.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/2-operators.md @@ -63,7 +63,7 @@ MogDB=# SELECT 'abc' || 'def' AS "unspecified"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 因为查询中没有声明任何类型，所以本例中对类型没有任何初始提示。因此，分析器查找所有候选操作符，发现既存在接受字符串类型范畴的操作符也存在接受位串类型范畴的操作符。因为字符串类型范畴是首选，所以选择字符串类型范畴的首选类型text作为解析未知类型文本的声明类型。 示例3：绝对值和取反操作符类型分析。MogDB操作符表里面有几条记录对应于前缀操作符@，它们都用于为各种数值类型实现绝对值操作。其中之一用于float8类型，它是数值类型范畴中的首选类型。因此，在面对unknown输入的时候， MogDB会使用该类型： @@ -88,5 +88,5 @@ MogDB=# SELECT array[1,2] <@ '{1,2,3}' as "is subset"; (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > MogDB操作符表有几条记录对应于中缀操作符<@，但是只有两个可以在左侧接受一个整数数组的操作符是数组包含（anyarray <@ anyarray）和范围包含（anyelement <@ anyrange）的。因为没有多态的伪类型（参阅[伪类型](15-pseudo-types)）是首选的，所以解析器不能解决这个基础上的歧义。然而，最后一个解析规则告诉用户，假设未知类型的文字是和另外一个输入相同的类型，也就是，整数数组。现在只有两个操作符中的一个可以匹配，所以选择数组包含。（如果用户选择了范围包含，用户将得到一个错误，因为字符串没有正确的格式成为范围的文字。) diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/3-functions.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/3-functions.md index 1dc39d08..53cade05 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/3-functions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/3-functions.md @@ -79,7 +79,7 @@ MogDB=# SELECT substr(varchar '1234', 3); MogDB=# SELECT substr(CAST (varchar '1234' AS text), 3); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 分析器从pg_cast表中了解到text和varchar是二进制兼容的，意思是说一个可以传递给接受另一个的函数而不需要做任何物理转换。因此，在这种情况下，实际上没有做任何类型转换。 而且，如果以integer为参数调用函数，分析器将试图将其转换成text类型： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md index b9caa3db..e32bf296 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/4-value-storage.md @@ -32,5 +32,5 @@ MogDB=# SELECT VS_COL1, octet_length(VS_COL1) FROM tpcds.value_storage_t1; MogDB=# DROP TABLE tpcds.value_storage_t1; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 这里真正发生的事情是两个unknown文本缺省解析成text，这样就允许||操作符解析成text连接。然后操作符的text结果转换成bpchar(“空白填充的字符型”， character类型内部名称)以匹配目标字段类型。不过，从text到bpchar的转换是二进制兼容的，这样的转换是隐含的并且实际上不做任何函数调用。最后，在系统表里找到长度转换函数bpchar(bpchar, integer, Boolean) 并且应用于该操作符的结果和存储的字段长。这个类型相关的函数执行所需的长度检查和额外的空白填充。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md index bfae9274..218c6da1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/5-type-conversion/5-union-case-and-related-constructs.md @@ -19,7 +19,7 @@ SQL UNION构造必须把那些可能不太相似的类型匹配起来成为一 - 如果输入类型是同一个类型范畴，则选择该类型范畴的首选类型。（例外：union操作会选择第一个分支的类型作为所选类型。） - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 系统表pg_type中typcategory表示数据类型范畴， typispreferred表示是否是typcategory分类中的首选类型。 - 把所有输入转换为所选的类型（对于字符串保持原有长度）。如果从给定的输入到所选的类型没有隐式转换则失败。 @@ -170,14 +170,14 @@ ora_1=# INSERT INTO t1 VALUES(1, 2, '3', '4', date '12-10-2010'); --result1类型为char，defresult类型为text，text精度更高，返回值的类型由char更新为text。 ora_1=# SELECT decode(1, 2, c_char, c_text) AS result, pg_typeof(result) FROM t1; - result | pg_typeof + result | pg_typeof --------+----------- 4 | text (1 row) --result1类型为int，属于数值类型范畴，返回值的类型置为numeric。 ora_1=# SELECT decode(1, 2, c_int, c_float8) AS result, pg_typeof(result) FROM t1; - result | pg_typeof + result | pg_typeof --------+----------- 2 | numeric (1 row) diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md index 98ac8088..f105e81a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/1-introduction/2-what-is-a-document.md @@ -25,7 +25,7 @@ identify_serials (7 rows) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 实际上，在这些示例查询中，应该使用coalesce防止一个独立的NULL属性导致整个文档的NULL结果。 另外一种可能是：文档在文件系统中作为简单的文本文件存储。在这种情况下，数据库可以用于存储全文索引并且执行搜索，同时可以使用一些唯一标识从文件系统中检索文档。然而，从数据库外部检索文件需要拥有系统管理员权限或者特殊函数支持。因此，还是将所有数据保存在数据库中比较方便。同时，将所有数据保存在数据库中可以方便地访问文档元数据以便于索引和显示。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md index 72583ded..13dbea3c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/1-manipulating-tsvector.md @@ -19,7 +19,7 @@ MogDB提供了用来操作tsvector类型的函数和操作符。 setweight返回一个输入tsvector的副本，其中每一个位置都使用给定的权重做了标记。权值可以为A、B、C或D（D是tsvector副本的默认权重，并且不在输出中呈现）。当对tsvector进行连接操作时，这些权重标签将会被保留，文档不同部分以不同的权重进行排序。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 权重标签作用于位置，而不是词素。如果传入的tsvector已经被剥离了位置信息，那么setweight函数将什么都不做。 - length(vector tsvector) returns integer diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md index 93e46d61..aa404bbb 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/4-additional-features/3-rewriting-queries.md @@ -24,7 +24,7 @@ ts_rewrite函数族可以从tsquery中搜索一个特定的目标子查询，并 ts_rewrite的这种形式接受一个起始查询和SQL查询命令。 这里的查询命令是文本字串形式，必须产生两个tsquery列。查询结果的每一行，第一个字段的值（目标子查询） 都会被第二个字段（替代子查询）替换。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 当多个规则需要重写时，重写顺序非常重要； 因此在实践中需要使用ORDER BY将源查询按照某些字段进行排序。 例如：举一个现实生活中天文学上的例子。我们将使用表驱动的重写规则扩大supernovae的查询范围： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md index 6e23f0b6..55007a71 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/6-full-text-search/8-testing-and-debugging-text-search/3-testing-a-dictionary.md @@ -25,5 +25,5 @@ MogDB=# SELECT ts_lexize('english_stem', 'a'); {} ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > ts_lexize函数支持单一token，不支持文本。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/8-controlling-transactions.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/8-controlling-transactions.md index b5ababd7..c101f38b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/8-controlling-transactions.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/8-controlling-transactions.md @@ -25,5 +25,5 @@ MogDB通过COMMIT或者END可完成提交事务的功能，即提交事务的所 回滚是在事务运行的过程中发生了某种故障，事务不能继续执行，系统将事务中对数据库的所有已完成的操作全部撤销。请参考[ROLLBACK](ROLLBACK)。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 数据库中收到的一次执行请求（不在事务块中），如果含有多条语句，将会被打包成一个事务，如果其中有一个语句失败，那么整个请求都将会被回滚。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/9-ddl-syntax-overview.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/9-ddl-syntax-overview.md index 16b27a7e..7b865e57 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/9-ddl-syntax-overview.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-reference/9-ddl-syntax-overview.md @@ -9,7 +9,7 @@ date: 2021-05-17 DDL（Data Definition Language数据定义语言），用于定义或修改数据库中的对象。如：表、索引、视图等。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > MogDB不支持数据库主节点不完整时进行DDL操作。例如：MogDB中有1个数据库主节点故障时执行新建数据库、表等操作都会失败。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DATABASE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DATABASE.md index bd8f1cfe..39ac49de 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DATABASE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DATABASE.md @@ -69,7 +69,7 @@ date: 2021-05-17 AlterDatabase ::= ALTER DATABASE database_name [ WITH ] { ENABLE | DISABLE } PRIVATE OBJECT; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库的对象隔离属性时须连接至该数据库，否则无法更改。 > - 新创建的数据库，对象隔离属性默认是关闭的。当开启数据库对象隔离属性后，普通用户只能查看有权访问的对象（表、函数、视图、字段等）。对象隔离特性对管理员用户不生效，当开启对象隔离特性后，管理员也可以查看到全量的数据库对象。 @@ -130,7 +130,7 @@ date: 2021-05-17 重置全部的数据库会话参数值。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。 > - 修改的数据库会话参数值，将在下一次会话中生效。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DEFAULT-PRIVILEGES.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DEFAULT-PRIVILEGES.md index 8126cd5f..ee0a2ce8 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DEFAULT-PRIVILEGES.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-DEFAULT-PRIVILEGES.md @@ -181,7 +181,7 @@ AlterDafaultPrivileges ::= ALTER DEFAULT PRIVILEGES 取值范围: 已存在的角色名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果想删除一个被赋予了默认权限的角色，有必要恢复改变的缺省权限或者使用DROP OWNED BY来为角色脱离缺省的权限记录。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-FOREIGN-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-FOREIGN-TABLE.md index ece8ffff..37efc74d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-FOREIGN-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-FOREIGN-TABLE.md @@ -107,7 +107,7 @@ AlterForeignTable ::= ALTER FOREIGN TABLE [ IF EXISTS ] table_name 这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是， 文件级别null选项）。与COPY的 FORCE_NOT_NULL选项里的字段相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** file_fdw更多使用请参见[file_fdw](file_fdw)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: file_fdw更多使用请参见[file_fdw](file_fdw)。 - **value** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md index 9fc91a88..21b9ad14 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-INDEX.md @@ -90,7 +90,7 @@ ALTER INDEX用于修改现有索引的定义。 [ MODIFY PARTITION index_partition_name ] UNUSABLE; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表不支持该语法。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表不支持该语法。 - 重建表索引或索引分区。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-RESOURCE-POOL.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-RESOURCE-POOL.md index 86ba4455..df9f0393 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-RESOURCE-POOL.md @@ -36,7 +36,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 控制组名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置控制组名称时，语法可以使用双引号，也可以使用单引号。 > @@ -73,7 +73,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 在普通场景下，普通用户的mem_percent范围为0-100的整数，默认值为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** mem_percent和memory_limit同时指定时，只有mem_percent起作用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: mem_percent和memory_limit同时指定时，只有mem_percent起作用。 - **io_limits** @@ -87,7 +87,7 @@ AlterResourcePool ::= ALTER RESOURCE POOL pool_name 包括三档可选：Low、Medium和High。不控制时可设置为None，默认为None。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT，COPY FROM，CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT，COPY FROM，CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md index 590e99bf..da0da933 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-PARTITION.md @@ -77,7 +77,7 @@ date: 2021-05-17 - 列表分区表，哈希分区表不能是列存储。 - List/Hash/Range类型分区表支持exchange\_clause。 - > **须知：** + > **须知**: > > - 完成交换后，普通表和分区的数据被置换，同时普通表和分区的表空间信息被置换。此时，普通表和分区的统计信息变得不可靠，需要对普通表和分区重新执行analyze。 > - 由于非分区键不能建立本地唯一索引，只能建立全局唯一索引，所以如果普通表含有唯一索引时，会导致不能交换数据。 @@ -113,7 +113,7 @@ date: 2021-05-17 split_point_clause ::= AT ( partition_value ) INTO ( PARTITION partition_name [ TABLESPACE tablespacename ] , PARTITION partition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 列存分区表不支持切割分区。 > - 切割点的大小要位于正在被切割的分区的分区键范围内，指定切割点的方式只能把一个分区切割成两个新分区。 @@ -124,7 +124,7 @@ date: 2021-05-17 no_split_point_clause ::= INTO { ( partition_less_than_item [, ...] ) | ( partition_start_end_item [, ...] ) } ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 不指定切割点的方式，partition_less_than_item指定的第一个新分区的分区键要大于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_less_than_item指定的最后一个分区的分区键要等于正在被切割的分区的分区键大小。 > - 不指定切割点的方式，partition_start_end_item指定的第一个新分区的起始点（如果存在的话）必须等于正在被切割的分区的前一个分区（如果存在的话）的分区键，partition_start_end_item指定的最后一个分区的终止点（如果存在的话）必须等于正在被切割的分区的分区键。 @@ -147,7 +147,7 @@ date: 2021-05-17 {START(partition_value)} | {END({partition_value | MAXVALUE})} } [TABLESPACE tablespace_name] - + ``` - add_clause子语法用于为指定的分区表添加一个或多个分区。 @@ -167,7 +167,7 @@ date: 2021-05-17 [ TABLESPACE tablespacename ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - partition_list_item仅支持的1个分区键，其支持的数据类型参见[PARTITION BY LIST(partition_key)](CREATE-TABLE-PARTITION#list)。 > - 间隔/哈希分区表不支持添加分区。 @@ -178,10 +178,10 @@ date: 2021-05-17 drop_clause ::= DROP PARTITION { partition_name | FOR ( partition_value [, ...] ) } [ UPDATE GLOBAL INDEX ] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 哈希分区表不支持删除分区。 - + - truncate_clause子语法用于清空分区表中的指定分区。 ```ebnf+diagram @@ -267,7 +267,7 @@ date: 2021-05-17 在VALIDATION是WITH状态时，如果检查出普通表有不满足要交换分区的分区键范围的数据，那么把这些数据插入到正确的分区，如果路由不到任何分区，再报错。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 只有在VALIDATION是WITH状态时，才可以指定VERBOSE。 - **partition_new_name** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-SUBPARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-SUBPARTITION.md index 0eb876e1..557b446e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-SUBPARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE-SUBPARTITION.md @@ -41,7 +41,7 @@ date: 2021-11-01 ```ebnf+diagram action::= add_clause | - drop_clause | + drop_clause | split_clause | truncate_clause ``` @@ -76,7 +76,7 @@ date: 2021-11-01 subpartition_definition ::= SUBPARTITION subpartition_name [ VALUES LESS THAN ( partition_value | MAXVALUE ) | VALUES ( partition_value [, ...] | DEFAULT )] [ TABLESPACE tablespace ] ``` - >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: >若一级分区为HASH分区，不支持以ADD形式新增一级分区；若二级分区为HASH分区，不支持以MODIFY形式新增二级分区。 - drop\_clause子语法用于删除分区表中的指定分区。语法可以作用在一级分区上。 @@ -91,7 +91,7 @@ date: 2021-11-01 drop_clause ::= DROP SUBPARTITION { subpartition_name | FOR ( partition_value, subpartition_value ) } [ UPDATE GLOBAL INDEX ] ``` - >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > >- 若一级分区为HASH分区，不支持删除一级分区；若二级分区为HASH分区，不支持删除二级分区。 >- 不支持删除唯一子分区。 @@ -108,7 +108,7 @@ date: 2021-11-01 split_point_clause ::= AT ( subpartition_value ) INTO ( SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] , SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] ) ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 切割点的大小要位于正在被切割的分区的分区键范围内。 > @@ -119,19 +119,19 @@ date: 2021-11-01 ```ebnf+diagram split_point_clause ::= AT ( subpartition_value ) INTO ( SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] , SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] ) ``` - + 指定List分区策略切割点split\_point\_clause的语法为： - + ```ebnf+diagram split_point_clause ::= VALUES ( subpartition_value ) INTO ( SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] , SUBPARTITION subpartition_name [ TABLESPACE tablespacename ] ) ``` - - >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + + >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > >- 切割点的大小要位于正在被切割的分区的分区键范围内。 >- 只能把一个分区切割成两个新分区。 >- Range分区策略切割点是把当前分区以此切割点分割为两个分区（小于此分割点为一个分区，大于此分割点为另一个分区），所以Range分区策略切割点只能为一个。List分区策略切割点可以为多个，但不超过64个，即把这些切割点从当前分区的边界值提取出来作为一个新分区，当前分区剩余边界值作为另一个新分区。 - + - truncate_clause子语法用于清空分区表中的指定分区。 ```ebnf+diagram diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md index 41688806..71d5d66a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLE.md @@ -70,8 +70,8 @@ date: 2021-05-17 | NOT OF | REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING } ``` - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - **ADD table_constraint [ NOT VALID ]** 给表增加一个新的约束。 > - **ADD table_constraint_using_index** 根据已有唯一索引为表增加主键约束或唯一约束。 @@ -102,7 +102,7 @@ date: 2021-05-17 > - **OF type_name** 将表连接至一种复合类型，与CREATE TABLE OF选项创建表一样。表的字段的名称和类型必须精确匹配复合类型中的定义，不过oid系统字段允许不一样。表不能是从任何其他表继承的。这些限制确保CREATE TABLE OF选项允许一个相同的表定义。 > - **NOT OF** 将一个与某类型进行关联的表进行关联的解除。 > - **REPLICA IDENTITY { DEFAULT | USING INDEX index_name | FULL | NOTHING }** DEFAULT记录主键的列的旧值。USING INDEX记录命名索引覆盖的列的旧值，这些值必须是唯一的，不局部的，不可延迟的，并且仅包括标记为NOT NULL的列。FULL记录该行中所有列的旧值。NOTHING不记录有关旧行的信息。在所有情况下，除非该行的新旧版本中至少要记录的列之一不同，否则不会记录任何旧值。 - + - 其中列相关的操作column_clause可以是以下子句之一： ```ebnf+diagram @@ -121,8 +121,8 @@ date: 2021-05-17 | ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] ) | ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN } ``` - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - **ADD [ COLUMN ] column_name data_type [ compress_mode ] [ COLLATE collation ] [ column_constraint [ ... ] ]** 向表中增加一个新的字段。用ADD COLUMN增加一个字段，所有表中现有行都初始化为该字段的缺省值（如果没有声明DEFAULT子句，值为NULL）。 > @@ -151,7 +151,7 @@ date: 2021-05-17 > - **ALTER [ COLUMN ] column_name SET ( {attribute_option = value} [, ... ] )** **ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )** 设置/重置属性选项。 目前，属性选项只定义了n_distinct和n_distinct_inherited。n_distinct影响表本身的统计值，而n_distinct_inherited影响表及其继承子表的统计。目前，只支持SET/RESET n_distinct参数，禁止SET/RESET n_distinct_inherited参数。 > > - **ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }** 为一个字段设置存储模式。这个设置控制这个字段是内联保存还是保存在一个附属的表里，以及数据是否要压缩。仅支持对行存表的设置；对列存表没有意义，执行时报错。SET STORAGE本身并不改变表上的任何东西，只是设置将来的表操作时，建议使用的策略。 - + - 其中列约束column_constraint为： ```ebnf+diagram @@ -166,13 +166,13 @@ date: 2021-05-17 REFERENCES reftable [ ( refcolumn ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] ``` - + - 其中压缩可选项compress_mode为： ```ebnf+diagram compress_mode ::= [ DELTA | PREFIX | DICTIONARY | NUMSTR | NOCOMPRESS ] ``` - + - 其中根据已有唯一索引为表增加主键约束或唯一约束table_constraint_using_index为： ```ebnf+diagram @@ -180,7 +180,7 @@ date: 2021-05-17 { UNIQUE | PRIMARY KEY } USING INDEX index_name [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] ``` - + - 其中表约束table_constraint为： ```ebnf+diagram @@ -193,14 +193,14 @@ date: 2021-05-17 [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE action ] [ ON UPDATE action ] } [ DEFERRABLE | NOT DEFERRABLE | INITIALLY DEFERRED | INITIALLY IMMEDIATE ] ``` - + 其中索引参数index_parameters为： ```ebnf+diagram index_parameters ::= [ WITH ( {storage_parameter = value} [, ... ] ) ] [ USING INDEX TABLESPACE tablespace_name ] ``` - + - 重命名表。对名称的修改不会影响所存储的数据。 ```ebnf+diagram @@ -229,7 +229,7 @@ date: 2021-05-17 SET SCHEMA new_schema; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 这种形式把表移动到另外一个模式。相关的索引、约束都跟着移动。目前序列不支持改变schema。 若该表拥有序列，需要将序列删除，重建，或者取消拥有关系， 才能将表schema更改成功。 > - 要修改一个表的模式，用户必须在新模式上拥有CREATE权限。要把该表添加为一个父表的新子表，用户必须同时又是父表的所有者。要修改所有者，用户还必须是新的所有角色的直接或间接成员，并且该成员必须在此表的模式上有CREATE权限。这些限制规定了该用户不能做出了重建和删除表之外的事情。不过，系统管理员可以以任何方式修改任意表的所有权限。 @@ -284,7 +284,7 @@ date: 2021-05-17 表示创建索引时起的bgworker线程数量，例如2就表示将会起2个bgworker线程并发创建索引。 如果未设置，启动bgworker线程数量与表大小相关，一般不超过4个线程。 - + - hasuids（bool类型） 默认值：off @@ -319,7 +319,7 @@ date: 2021-05-17 USING子句声明如何从旧的字段值里计算新的字段值；如果省略，缺省从旧类型向新类型的赋值转换。如果从旧数据类型到新类型没有隐含或者赋值的转换，则必须提供一个USING子句。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > ALTER TYPE的USING选项实际上可以声明涉及该行旧值的任何表达式，即它可以引用除了正在被转换的字段之外其他的字段。这样，就可以用ALTER TYPE语法做非常普遍性的转换。因为这个灵活性，USING表达式并没有作用于该字段的缺省值（如果有的话)，结果可能不是缺省表达式要求的常量表达式。这就意味着如果从旧类型到新类型没有隐含或者赋值转换的话，即使存在USING子句，ALTER TYPE也可能无法把缺省值转换成新的类型。在这种情况下，应该用DROP DEFAULT先删除缺省，执行ALTER TYPE，然后使用SET DEFAULT增加一个合适的新缺省值。类似的考虑也适用于涉及该字段的索引和约束。 @@ -401,7 +401,7 @@ date: 2021-05-17 - INITIALLY IMMEDIATE：那么每条语句之后就立即检查它。 - INITIALLY DEFERRED：只有在事务结尾才检查它。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** Ustore表不支持新增DEFERRABLE以及INITIALLY DEFERRED约束。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: Ustore表不支持新增DEFERRABLE以及INITIALLY DEFERRED约束。 - **PARTIAL CLUSTER KEY** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLESPACE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLESPACE.md index 450cbffa..e6a69d86 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLESPACE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TABLESPACE.md @@ -17,7 +17,7 @@ date: 2021-05-17 - 要修改表空间的所有者A为B，则A必须是B的直接或者间接成员。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果new_owner与old_owner一致，此处不再校验当前执行操作的用户是否具有修改权限，而直接显示ALTER成功。 ## 语法格式 @@ -88,7 +88,7 @@ date: 2021-05-17 - random_page_cost：设置优化器计算一次非顺序获取磁盘页面的开销。缺省为4.0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - random_page_cost是相对于seq_page_cost的取值，等于或者小于seq_page_cost时毫无意义。 > - 默认值为4.0的前提条件是，优化器采用索引来扫描表数据，并且表数据在cache中命中率可以90%左右。 @@ -107,7 +107,7 @@ date: 2021-05-17 - 由space_size来确定，其格式参考[CREATE TABLESPACE](CREATE-TABLESPACE)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若调整后的限额值比当前表空间实际使用的值要小，调整操作可以执行成功，后续用户需要将该表空间的使用值降低到新限额值之下，才能继续往该表空间中写入数据。 > diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TEXT-SEARCH-DICTIONARY.md index 86f57fce..54f5712c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TEXT-SEARCH-DICTIONARY.md @@ -57,7 +57,7 @@ date: 2021-05-17 要修改的参数名。与template对应，不同的词典类型具有不同的参数列表，且与指定顺序无关。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 不支持修改词典的TEMPLATE参数值。 > - 不支持仅修改FILEPATH参数而不修改对应的词典定义文件参数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TRIGGER.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TRIGGER.md index c0c4e9ec..5489012b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TRIGGER.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TRIGGER.md @@ -11,7 +11,7 @@ date: 2021-05-17 修改触发器定义。 ->![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** +>![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > >目前只支持修改名称。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TYPE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TYPE.md index 36fcd30c..0a4052ab 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TYPE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ALTER-TYPE.md @@ -163,7 +163,7 @@ date: 2021-05-17 如果需联动更新类型是已更新类型的关联记录，则拒绝更新。这是缺省选项。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - ADD ATTRIBUTE、DROP ATTRIBUTE和ALTER ATTRIBUTE选项可以组合成一个列表同时处理。 例如，在一条命令中同时增加几个属性或是更改几个属性的类型是可以实现的。 > - 要修改一个类型的模式，必须在新模式上拥有CREATE权限。 要修改所有者，必须是新的所有角色的直接或间接成员， 并且该成员必须在此类型的模式上有CREATE权限。 （这些限制强制了修改所有者不会做任何通过删除和重建类型不能做的事情。 不过，系统管理员可以以任何方式修改任意类型的所有权。） 要增加一个属性或是修改一个属性的类型，也必须有该类型的USAGE权限。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ANALYZE-ANALYSE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ANALYZE-ANALYSE.md index 128a3281..062ab852 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ANALYZE-ANALYSE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/ANALYZE-ANALYSE.md @@ -39,7 +39,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 PARTITION ( patrition_name ) ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 普通分区表目前支持针对某个分区的统计信息的语法，但功能上不支持针对某个分区的统计信息收集。 - 收集多列统计信息。 @@ -48,7 +48,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 table_name (( column_1_name, column_2_name [, ...] )); ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 收集多列统计信息时，请设置GUC参数default_statistics_target为负数，以使用百分比采样方式。 > - 每组多列统计信息最多支持32列。 @@ -60,7 +60,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE}; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - Fast模式校验时，需要对校验的表有并发的DML操作，会导致校验过程中有误报的问题，因为当前Fast模式是直接从磁盘上读取，并发有其他线程修改文件时，会导致获取的数据不准确，建议离线操作。 > - 支持对全库进行操作，由于涉及的表较多，建议以重定向保存结果**gsql -d database -p port -f “verify.sql”> verify_warning.txt 2>&1**。 @@ -74,7 +74,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name|index_name [CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 支持对普通表的操作和索引表的操作，但不支持对索引表index使用CASCADE操作。原因是由于CASCADE模式用于处理主表的所有索引表，当单独对索引表进行检测时，无需使用CASCADE模式。 > - 对于主表的检测会同步检测主表的内部表，例如toast表、cudesc表等。 @@ -86,7 +86,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 AnalyzeAnalyse ::= {ANALYZE | ANALYSE} VERIFY {FAST|COMPLETE} table_name PARTITION {(patrition_name)}[CASCADE]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 支持对表的单独分区进行检测操作，但不支持对索引表index使用CASCADE操作。 ## 参数说明 @@ -94,7 +94,7 @@ ANALYZE|ANALYSE VERIFY用于检测数据库中普通表（行存表、列存表 启用显示进度信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 - **table_name** @@ -182,7 +182,7 @@ INFO: analyzing "public.customer_info" inheritance tree(cn_5002 pid=53078) ANALYZE ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若环境若有故障，需查看数据库主节点的log。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若环境若有故障，需查看数据库主节点的log。 - 删除表。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CALL.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CALL.md index c448fca0..59072c35 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CALL.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CALL.md @@ -43,7 +43,7 @@ Call ::= CALL [schema'.'|package'.'] {func_name| procedure_name} ( param_expr ); 取值范围: 已存在的函数参数名称或存储过程参数名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 参数可以包含入参（参数名和类型之间指定“IN”关键字）和出参（参数名和类型之间指定“OUT”关键字），使用CALL命令调用函数或存储过程时，对于非重载的函数，参数列表必须包含出参，出参可以传入一个变量或者任一常量，详见示例。对于重载的package函数，参数列表里可以忽略出参，忽略出参时可能会导致函数找不到。包含出参时，出参只能是常量。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md index e7d7ce3c..e26f2674 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/COPY.md @@ -45,7 +45,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 语法中的FIXED FORMATTER ( { column_name( offset, length ) } [, ...] )以及 [ ( option [, ...] ) | copy_option [ ...] ] 可以任意排列组合。 @@ -70,7 +70,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 | FIXED FORMATTER ( { column_name( offset, length ) } [, ...] ) [ ( option [, ...] ) | copy_option [ ...] ] ; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 1. COPY TO语法形式约束如下： > (query)与[USING] DELIMITER不兼容，即若COPY TO的数据来自于一个query的查询结果，那么COPY TO语法不能再指定[USING] DELIMITERS语法子句。 @@ -161,7 +161,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 打开字段固定长度模式。在字段固定长度模式下，不能声明DELIMITER，NULL，CSV选项。指定FIXED类型后，不能再通过option或copy_option指定BINARY、CSV、TEXT等类型。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 定长格式定义如下： > > 1. 每条记录的每个字段长度相同。 @@ -188,7 +188,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 仅支持导入（即COPY FROM）时指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 此容错选项的使用限制如下： > > - 此容错机制仅捕捉COPY FROM过程中数据库主节点上数据解析过程中相关的数据类型错误（DATA_EXCEPTION）。 @@ -213,7 +213,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：若未指定LOG ERRORS，则会报错；若指定LOG ERRORS，则默认为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如上述LOG ERRORS中描述的容错机制，REJECT LIMIT的计数也是按照执行COPY FROM的数据库主节点上遇到的解析错误数量计算，而不是数据库节点的错误数量。 - **FORMATTER** @@ -250,7 +250,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 指定数据文件行数据的字段分隔符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 分隔符不能是\\r和\\n。 > - 分隔符不能和null参数相同，CSV格式数据的分隔符不能和quote参数相同。 @@ -298,7 +298,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -316,7 +316,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\\r、\\n、\\r\\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式导入。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -354,7 +354,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果行尾换行符丢失，使两行变成一行时，设置此参数为true将导致后一行数据被忽略掉。 - COMPATIBLE_ILLEGAL_CHARS @@ -368,7 +368,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -388,7 +388,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考[时间和日期处理函数和操作符](8-date-and-time-processing-functions-and-operators)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT @@ -417,7 +417,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 用来指定数据文件中空值的表示。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 在使用COPY FROM的时候，任何匹配这个字符串的字符串将被存储为NULL值，所以应该确保指定的字符串和COPY TO相同。 取值范围: @@ -442,7 +442,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 导出数据时用于定义标题行的文件，一般用来描述每一列的数据信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 仅在header为on或true的情况下有效。 > - fileheader指定的是绝对路径。 @@ -459,7 +459,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 - 当前事务中没有打开的游标。 - 当前事务中没有原有的快照。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > COPY完成后，所有其他会话将会立刻看到这些数据。但是这违反了MVCC可见性的一般原则，用户应当了解这样会导致潜在的风险。 - FORCE NOT NULL column_name [, ...] @@ -488,7 +488,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：双引号。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - quote参数不能和分隔符、null参数相同。 > - quote参数只能是单字节的字符。 @@ -506,7 +506,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 支持多字符换行符，但换行符不能超过10个字节。常见的换行符，如\\r、\\n、\\r\\n（设成0x0D、0x0A、0x0D0A效果是相同的），其他字符或字符串，如$、#。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - EOL参数只能用于TEXT格式的导入导出，不支持CSV格式和FIXED格式。为了兼容原有EOL参数，仍然支持导出CSV格式和FIXED格式时指定EOL参数为0x0D或0x0D0A。 > - EOL参数不能和分隔符、null参数相同。 @@ -536,7 +536,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 若不使用该参数，导入时遇到非法字符进行报错，中断导入。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 导入非法字符容错规则如下： > （1）对于'\0'，容错后转换为空格； > （2）对于其他非法字符，容错后转换为问号； @@ -550,7 +550,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 缺省值：false/off。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目前COPY指定此Option实际不会生效，即不会有相应的容错处理效果（不生效）。需要额外注意的是，打开此选项会导致解析器在数据库主节点数据解析阶段（即COPY错误表容错的涵盖范围）忽略此数据问题，而到数据库节点重新报错，从而使得COPY错误表（打开LOG ERRORS REJECT LIMIT）在此选项打开的情况下无法成功捕获这类少列的数据异常。因此请不要指定此选项。 - DATE_FORMAT 'date_format_string' @@ -559,7 +559,7 @@ COPY FROM从一个文件拷贝数据到一个表，COPY TO把一个表的数据 取值范围: 合法DATE格式。可参考[时间和日期处理函数和操作符](8-date-and-time-processing-functions-and-operators)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 对于DATE类型内建为TIMESTAMP类型的数据库，在导入的时候，若需指定格式，可以参考下面的timestamp_format参数。 - TIME_FORMAT 'time_format_string' diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CLIENT-MASTER-KEY.md index f0a109ac..1a5c4cac 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-CLIENT-MASTER-KEY.md @@ -45,7 +45,7 @@ CreateClientMasterKey ::= CREATE CLIENT MASTER KEY client_master_key_name WITH ( 由本语法创建的用于加密COLUMN ENCRYPTION KEY，该参数用于指定加密算法的类型。取值范围: RSA_2048、RSA_3072和SM2。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** **密钥存储路径：**默认情况下，localkms将在`$LOCALKMS_FILE_PATH`路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取`$LOCALKMS_FILE_PATH`失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub、key_path_value.pub.rand、 key_path_value.priv、 key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: **密钥存储路径：**默认情况下，localkms将在`$LOCALKMS_FILE_PATH`路径下生成/读取/删除密钥文件，用户可手动配置该环境变量。但是，用户也可以不用单独配置该环境变量，在尝试获取`$LOCALKMS_FILE_PATH`失败时，localkms会尝试获取$GAUSSHOME/etc/localkms/路径，如果该路径存在，则将其作为密钥存储路径。 **密钥相关文件名：**使用CREATE CMK语法时，localkms将会创建四个与存储密钥相关的文件。示例：当KEY_PATH = “key_path_value”, 四个文件的名称分别为key_path_value.pub、key_path_value.pub.rand、 key_path_value.priv、 key_path_value.priv.rand。 所以，为了能够成功创建密钥相关文件，在密钥存储路径下，应该保证没有已存在的与密钥相关文件名同名的文件。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-COLUMN-ENCRYPTION-KEY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-COLUMN-ENCRYPTION-KEY.md index ea32930b..67a1a5e1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-COLUMN-ENCRYPTION-KEY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-COLUMN-ENCRYPTION-KEY.md @@ -45,7 +45,7 @@ CreateColumnEncryption ::= CREATE COLUMN ENCRYPTION KEY column_encryption_key_na 该值为用户指定的密钥口令，密钥口令长度范围为28 ~ 256位，28位派生出来的密钥安全强度满足AES128，若用户需要用AES256，密钥口令的长度需要39位，如果不指定，则会自动生成256字符的密钥。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 国密算法约束：由于SM2、SM3、SM4等算法属于中国国家密码标准算法，为规避法律风险，需配套使用。即如果将CEK用于SM4_SM3算法，则仅能使用SM2算法来对该CEK进行加密。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 国密算法约束：由于SM2、SM3、SM4等算法属于中国国家密码标准算法，为规避法律风险，需配套使用。即如果将CEK用于SM4_SM3算法，则仅能使用SM2算法来对该CEK进行加密。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-DATABASE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-DATABASE.md index 6fdab4c1..7e3782c2 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-DATABASE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-DATABASE.md @@ -108,7 +108,7 @@ CreateDatabase ::= CREATE DATABASE database_name > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意：** 需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII，服务器把字节值0-127根据 ASCII标准解释，而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII，就不会有编码转换。因此，这个设置基本不是用来声明所使用的指定编码， 因为这个声明会忽略编码。在大多数情况下，如果你使用了任何非ASCII数据，那么使用 SQL_ASCII设置都是不明智的，因为MogDB将无法帮助你转换或者校验非ASCII字符。 > - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 指定新的数据库字符集编码必须与所选择的本地环境中（LC_COLLATE和LC_CTYPE）的设置兼容。 > - 当指定的字符编码集为GBK时，部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时，字节编码与ASCII字符@A-Z[]\^_`a-z{|}重叠。其中@[]^_'{|}是数据库中的操作符，直接作为对象名时，会语法报错。例如“侤”字，GBK16进制编码为0x8240，第二个字节为0x40，与ASCII“@”符号编码相同，因此无法直接作为对象名使用。如果确实要使用，可以在创建和访问对象时，通过增加双引号来规避这个问题。 @@ -132,7 +132,7 @@ CreateDatabase ::= CREATE DATABASE database_name 指定兼容的数据库的类型。取值范围: A、B、C、PG。分别表示兼容Oracle、MySQL、Teradata和PostgreSQL。但是C目前已经放弃支持，因此常用的取值是A、B、PG，默认兼容A。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A兼容性下，数据库将空字符串作为NULL处理，数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。 > - 将字符串转换成整数类型时，如果输入不合法，B兼容性会将输入转换为0，而其它兼容性则会报错。 @@ -148,7 +148,7 @@ CreateDatabase ::= CREATE DATABASE database_name 数据库可以接受的并发连接数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md index cac6c5b9..1537f90a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FOREIGN-TABLE.md @@ -139,7 +139,7 @@ column_constraint ::= [ CONSTRAINT constraint_name ] 这是一个布尔选项。如果为真，则声明字段的值不应该匹配空字符串（也就是， 文件级别null选项）。与COPY的 FORCE_NOT_NULL选项里的字段相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 更多使用说明请参见[file_fdw](file_fdw)、[oracle_fdw](1-oracle_fdw)、[mysql_fdw](2-mysql_fdw)、[postgres_fdw](3-postgres_fdw)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 更多使用说明请参见[file_fdw](file_fdw)、[oracle_fdw](1-oracle_fdw)、[mysql_fdw](2-mysql_fdw)、[postgres_fdw](3-postgres_fdw)。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md index ce48ff82..478b2e53 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-FUNCTION.md @@ -107,7 +107,7 @@ date: 2021-05-10 取值范围: IN、OUT、INOUT或VARIADIC。缺省值是IN。并且OUT和INOUT模式的参数不能用在RETURNS TABLE的函数定义中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: VARIADIC用于声明数组类型的参数。 - **argtype** @@ -151,7 +151,7 @@ date: 2021-05-10 表示该函数是窗口函数。替换函数定义时不能改变WINDOW属性。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 自定义窗口函数只支持LANGUAGE是internal，并且引用的内部函数必须是窗口函数。 - **IMMUTABLE** @@ -253,7 +253,7 @@ date: 2021-05-10 PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在函数体中创建用户时，日志中会记录密码的明文。因此不建议用户在函数体中创建用户。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md index 8933ede3..82c34196 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-INDEX.md @@ -70,7 +70,7 @@ date: 2021-05-10 - 普通CREATE INDEX命令可以在事务内执行，但是CREATE INDEX CONCURRENTLY不可以在事务内执行。 - 列存表、分区表和临时表不支持CONCURRENTLY方式创建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > - 由于需要执行两次对表的扫描和build，而且必须等待现有的所有可能对该表执行修改的事务结束。这意味着该索引的创建比正常耗时更长，同时因此带来的CPU和I/O消耗对其他业务也会造成影响。 @@ -114,7 +114,7 @@ date: 2021-05-10 行存表（ASTORE存储引擎）支持的索引类型：btree（行存表缺省值）、hash、gin、gist。行存表（USTORE存储引擎）支持的索引类型：ubtree。列存表支持的索引类型：Psort（列存表缺省值）、btree、gin。全局临时表不支持GIN索引和Gist索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 列存表对GIN索引支持仅限于对于tsvector类型的支持，即创建列存GIN索引入参需要为to_tsvector函数（的返回值）。此方法为GIN索引比较普遍的使用方式。 - **column_name** @@ -239,47 +239,47 @@ date: 2021-05-10 索引分区的表空间。 取值范围: 如果没有声明，将使用分区表索引的表空间index_tablespace。 - + - **COMPRESS\_TYPE** 索引参数，设置索引压缩算法。1代表pglz算法，2代表zstd算法，默认不压缩。（仅支持B-TREE索引） 取值范围：0\~2，默认值为0。 - + - **COMPRESS\_LEVEL** - + 索引参数，设置索引压缩算法等级，仅当COMPRESS_TYPE为2时生效。压缩等级越高，索引的压缩效果越好，索引的访问速度越慢。（仅支持B-TREE索引） - + 取值范围：-31\~31，默认值为0。 - + - **COMPRESS\_CHUNK_SIZE** - + 索引参数，设置索引压缩chunk块大小。chunk数据块越小，预期能达到的压缩效果越好，同时数据越离散，影响索引的访问速度。（仅支持B-TREE索引） - + 取值范围：与页面大小有关。在页面大小为8k场景，取值范围为：512、1024、2048、4096。 - + 默认值：4096 - + - **COMPRESS_PREALLOC_CHUNKS** - + 索引参数，设置索引压缩chunk块预分配数量。预分配数量越大，索引的压缩率相对越差，离散度越小，访问性能越好。（仅支持B-TREE索引） - + 取值范围：0\~7，默认值为0。 - + - 当COMPRESS_CHUNK_SIZE为512和1024时，支持预分配设置最大为7。 - 当COMPRESS_CHUNK_SIZE为2048时，支持预分配设置最大为3。 - 当COMPRESS_CHUNK_SIZE为4096时，支持预分配设置最大为1。 - + - **COMPRESS_BYTE_CONVERT** - + 索引参数，设置索引压缩字节转换预处理。在一些场景下可以提升压缩效果，同时会导致一定性能劣化。 - + 取值范围：布尔值，默认关闭。 - + - **COMPRESS_DIFF_CONVERT** - + 索引参数，设置索引压缩字节差分预处理。只能与compress_byte_convert一起使用。在一些场景下可以提升压缩效果，同时会导致一定性能劣化。 - + 取值范围：布尔值，默认关闭。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md index e09a5854..46816a86 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-PROCEDURE.md @@ -64,7 +64,7 @@ plsql_body 参数的模式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** VARIADIC用于声明数组类型的参数。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: VARIADIC用于声明数组类型的参数。 取值范围: IN、OUT、INOUT或VARIADIC。缺省值是IN。只有OUT模式的参数能跟在VARIADIC参数之后。 @@ -104,9 +104,9 @@ plsql_body PL/SQL存储过程体。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 当在存储过程体中进行创建用户等涉及用户密码相关操作时，系统表及csv日志中会记录密码的明文。因此不建议用户在存储过程体中进行涉及用户密码的相关操作。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** argname和argmode的顺序没有严格要求，推荐按照argname、argmode、argtype的顺序使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: argname和argmode的顺序没有严格要求，推荐按照argname、argmode、argtype的顺序使用。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-RESOURCE-POOL.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-RESOURCE-POOL.md index 57a48fc2..1d2ae7d3 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-RESOURCE-POOL.md @@ -36,7 +36,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 控制组名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 设置控制组名称时，语法可以使用双引号，也可以使用单引号。 > - group_name对大小写敏感。 @@ -72,7 +72,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 在普通场景下，普通用户的mem_percent范围为0-100，默认值为0。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** mem_percent和memory_limit同时指定时，只有mem_percent起作用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: mem_percent和memory_limit同时指定时，只有mem_percent起作用。 - **io_limits** @@ -86,7 +86,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 包括三档可选：Low、Medium和High。不控制时可设置为None。默认为None。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT、COPY FROM、CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: io_limits和io_priority的设置都仅对复杂作业有效。包括批量导入（INSERT INTO SELECT、COPY FROM、CREATE TABLE AS等），单DN数据量大约超过500MB的复杂查询和VACUUM FULL等操作。 - **nodegroup** @@ -98,7 +98,7 @@ CreateResourcePool ::= CREATE RESOURCE POOL pool_name 在逻辑集群模式下，指定当前资源池用于控制没有关联本逻辑集群的普通用户的资源。这里的逻辑集群是由资源池nodegroup字段指定的。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - nodegroup必须是存在的逻辑集群，不能是elastic_group和安装的nodegroup (group_version1)。 > - 如果指定了is_foreign为true，则资源池不能再关联用户，即不允许通过CREATE USER … RESOURCE POOL语句来将该资源池配置给用户。该资源池自动检查用户是否关联到资源池指定的逻辑集群，如果用户没有关联到该逻辑集群，则这些用户在逻辑集群所包含的DN上运行将受到该资源池的资源控制。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROLE.md index 3ecb5ab7..92f8a7e5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROLE.md @@ -68,7 +68,7 @@ option ::= {SYSADMIN | NOSYSADMIN} 取值范围: 字符串，要符合标识符的命名规范，且最多为63个字符。若超过63个字符，数据库会截断并保留前63个字符当做角色名称。在创建角色时，数据库的时候会给出提示信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 标识符需要为字母、下划线、数字（0-9）或美元符号（$），且必须以字母（a-z）或下划线（_）开头。 - **password** @@ -177,14 +177,14 @@ option ::= {SYSADMIN | NOSYSADMIN} 该版本没有实际意义。 - **PERSISTENCE | NOPERSISTENCE** - + 定义永久用户。仅允许初始用户创建、修改和删除具有PERSISTENCE属性的永久用户。 - + - **CONNECTION LIMIT** 声明该角色可以使用的并发连接数量。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 系统管理员不受此参数的限制。 > - connlimit数据库主节点单独统计，MogDB整体的连接数 = connlimit * 当前正常数据库主节点个数。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROW-LEVEL-SECURITY-POLICY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROW-LEVEL-SECURITY-POLICY.md index 54576f48..9d7da002 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROW-LEVEL-SECURITY-POLICY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-ROW-LEVEL-SECURITY-POLICY.md @@ -91,7 +91,7 @@ CreateRowLevelSecurityPolicy ::= CREATE [ ROW LEVEL SECURITY ] POLICY policy_nam 当未指定时，PUBLIC为默认值，PUBLIC表示影响所有数据库用户，可以指定多个受影响的数据库用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 系统管理员不受行访问控制特性影响。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 系统管理员不受行访问控制特性影响。 - **using_expression** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SCHEMA.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SCHEMA.md index 3cdc9c4d..6cbc5008 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SCHEMA.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SCHEMA.md @@ -41,7 +41,7 @@ date: 2021-05-10 模式名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 模式名不能和当前数据库里其他的模式重名。 > 模式的名称不可以“pg_”开头。 @@ -63,7 +63,7 @@ date: 2021-05-10 子命令所创建的对象都被AUTHORIZATION子句指定的用户所拥有。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SEQUENCE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SEQUENCE.md index 5f39c81d..4f2dedaa 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SEQUENCE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SEQUENCE.md @@ -60,7 +60,7 @@ CreateSequence ::= CREATE [ LARGE ] SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为1，表示一次只能生成一个值，也就是没有缓存。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 不建议同时定义cache和maxvalue或minvalue。因为定义cache后不能保证序列的连续性，可能会产生空洞，造成序列号段浪费。 - **CYCLE** @@ -81,7 +81,7 @@ CreateSequence ::= CREATE [ LARGE ] SEQUENCE name [ INCREMENT [ BY ] increment ] 缺省值为OWNED BY NONE，表示不存在这样的关联。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 通过OWNED BY创建的Sequence不建议用于其他表，如果希望多个表共享Sequence，该Sequence不应该从属于特定表。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SYNONYM.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SYNONYM.md index 7fff1d0f..e71f39ce 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SYNONYM.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-SYNONYM.md @@ -42,7 +42,7 @@ CreateSynonym ::= CREATE [ OR REPLACE ] SYNONYM synonym_name 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > object_name可以是不存在的对象名称。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md index 0a9fa2e8..c6c549f4 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-AS.md @@ -54,7 +54,7 @@ CreateTableAs ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md index 9c98e465..f3a4e57f 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-PARTITION.md @@ -200,7 +200,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - STORAGE\_TYPE @@ -259,19 +259,19 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name （1）对于从句是VALUES LESS THAN的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是VALUE LESS THAN的语法格式，范围分区策略的分区键最多支持4列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、CHARACTER VARYING(n)、VARCHAR(n)、CHARACTER(n)、CHAR(n)、CHARACTER、CHAR、TEXT、NVARCHAR、NVARCHAR2、NAME、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （2）对于从句是START END的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于从句是START END的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：SMALLINT、INTEGER、BIGINT、DECIMAL、NUMERIC、REAL、DOUBLE PRECISION、TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 （3）对于指定了INTERVAL子句的语法格式： - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于指定了INTERVAL子句的语法格式，范围分区策略的分区键仅支持1列。 该情形下，分区键支持的数据类型为：TIMESTAMP[(p)] [WITHOUT TIME ZONE]、TIMESTAMP[(p)] [WITH TIME ZONE]、DATE。 @@ -279,7 +279,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 指定各分区的信息。partition_name为范围分区的名称。partition_value为范围分区的上边界，取值依赖于partition_key的类型。MAXVALUE表示分区的上边界，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 每个分区都需要指定一个上边界。 > - 分区上边界的类型应当和分区键的类型一致。 @@ -296,7 +296,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_value：对[START，END) 表示的范围进行切分，interval_value是指定切分后每个分区的宽度，不可是MAXVALUE；如果（END-START）值不能整除以EVERY值，则仅最后一个分区的宽度小于EVERY值。 - MAXVALUE：表示最大值，它通常用于设置最后一个范围分区的上边界。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 1. 在创建分区表若第一个分区定义含START值，则范围（MINVALUE，START）将自动作为实际的第一个分区。 > 2. START END语法需要遵循以下限制： @@ -316,7 +316,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - interval_expr：自动创建分区的间隔，例如：1 day、1 month。 - STORE IN (tablespace_name [, ...] )：指定存放自动创建分区的表空间列表，如果有指定，则自动创建的分区从表空间列表中循环选择使用，否则使用分区表默认的表空间。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列存表不支持间隔分区。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列存表不支持间隔分区。 - **PARTITION BY LIST(partition_key)** @@ -346,7 +346,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name - ENABLE（缺省值）：行迁移开关打开。 - DISABLE：行迁移开关关闭。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持ROW MOVEMENT。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持ROW MOVEMENT。 - **NOT NULL** @@ -378,7 +378,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 该子句将字段创建为生成列，生成列的值在写入（插入或更新）数据时由generation_expr计算得到，STORED表示像普通列一样存储生成列的值。 - >**说明：** + >**说明**: > >- 生成表达式不能以任何方式引用当前行以外的其他数据。生成表达式不能引用其他生成列，不能引用系统列。生成表达式不能返回结果集，不能使用子查询，不能使用聚集函数，不能使用窗口函数。生成表达式调用的函数只能是不可变（IMMUTABLE）函数。 > @@ -893,7 +893,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name partition p1, partition p2 ); - + -- 数据插入 MogDB=# INSERT INTO test_hash VALUES(1, 1); INSERT 0 1 @@ -903,7 +903,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name INSERT 0 1 MogDB=# INSERT INTO test_hash VALUES(4, 4); INSERT 0 1 - + -- 查看分区信息 MogDB=# SELECT t1.relname, partstrategy, boundaries FROM pg_partition t1, pg_class t2 WHERE t1.parentid = t2.oid AND t2.relname = 'test_hash' AND t1.parttype = 'p'; relname | partstrategy | boundaries @@ -911,7 +911,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name p1 | h | {0} p2 | h | {1} (2 rows) - + -- 查看数据 MogDB=# select * from test_hash partition (p1); col1 | col2 @@ -919,14 +919,14 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 3 | 3 4 | 4 (2 rows) - + MogDB=# select * from test_hash partition (p2); col1 | col2 ------+------ 1 | 1 2 | 2 (2 rows) - + -- 分区表和普通表交换数据 MogDB=# create table t1 (col1 int, col2 int); CREATE TABLE @@ -942,7 +942,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name 3 | 3 4 | 4 (2 rows) - + -- truncate分区 MogDB=# alter table test_hash truncate partition p2; ALTER TABLE @@ -950,7 +950,7 @@ CreateTablePartition ::= CREATE TABLE [ IF NOT EXISTS ] partition_table_name col1 | col2 ------+------ (0 rows) - + -- 删除分区表 MogDB=# drop table test_hash; ``` diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md index 310ef272..a528f890 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE-SUBPARTITION.md @@ -151,7 +151,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH - ROW（缺省值）：表的数据将以行式存储。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** orientation不支持修改。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: orientation不支持修改。 - COMPRESSION @@ -237,7 +237,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 该子句将字段创建为生成列，生成列的值在写入（插入或更新）数据时由generation_expr计算得到，STORED表示像普通列一样存储生成列的值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 生成表达式不能以任何方式引用当前行以外的其他数据。生成表达式不能引用其他生成列，不能引用系统列。生成表达式不能返回结果集，不能使用子查询，不能使用聚集函数，不能使用窗口函数。生成表达式调用的函数只能是不可变（IMMUTABLE）函数。 > - 不能为生成列指定默认值。 @@ -328,7 +328,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + drop table list_list; CREATE TABLE list_hash ( @@ -366,7 +366,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 3 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + drop table list_hash; CREATE TABLE list_range ( @@ -404,7 +404,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 2 | 1 | 1 201902 | 3 | 1 | 1 (5 rows) - + drop table list_range; CREATE TABLE range_list ( @@ -442,7 +442,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (6 rows) - + drop table range_list; CREATE TABLE range_hash ( @@ -480,7 +480,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (6 rows) - + drop table range_hash; CREATE TABLE range_range ( @@ -518,10 +518,10 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (6 rows) - + drop table range_range; ``` - + - 示例2：对二级分区表进行truncate操作 ```sql @@ -561,7 +561,7 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -569,13 +569,13 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (3 rows) - + alter table list_list truncate partition p_201901; select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list partition (p_201902); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -583,18 +583,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201903 | 2 | 1 | 1 201903 | 1 | 1 | 1 (3 rows) - + alter table list_list truncate partition p_201902; select * from list_list partition (p_201902); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list; month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + insert into list_list values('201902', '1', '1', 1); insert into list_list values('201902', '2', '1', 1); insert into list_list values('201902', '1', '1', 1); @@ -607,58 +607,58 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + alter table list_list truncate subpartition p_201901_a; select * from list_list subpartition (p_201901_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + alter table list_list truncate subpartition p_201901_b; select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + alter table list_list truncate subpartition p_201902_a; select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + alter table list_list truncate subpartition p_201902_b; select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list; month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + drop table list_list; ``` - + - 示例3：对二级分区表进行split操作 ```sql @@ -698,20 +698,20 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (6 rows) - + select * from list_list subpartition (p_201901_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + alter table list_list split subpartition p_201901_b values (2) into ( subpartition p_201901_b, @@ -723,18 +723,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (2 rows) - + select * from list_list subpartition (p_201901_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201902 | 2 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201901_c); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list partition (p_201901); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- @@ -742,20 +742,20 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH 201902 | 1 | 1 | 1 201902 | 1 | 1 | 1 (3 rows) - + select * from list_list subpartition (p_201902_a); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + alter table list_list split subpartition p_201902_b values (3) into ( subpartition p_201902_b, @@ -766,18 +766,18 @@ PARTITION BY {RANGE | LIST} (partition_key) SUBPARTITION BY {RANGE | LIST | HASH ------------+-----------+---------+----------- 201903 | 1 | 1 | 1 (1 row) - + select * from list_list subpartition (p_201902_b); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- (0 rows) - + select * from list_list subpartition (p_201902_c); month_code | dept_code | user_no | sales_amt ------------+-----------+---------+----------- 201903 | 2 | 1 | 1 201903 | 2 | 1 | 1 (2 rows) - + drop table list_list; ``` diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md index 58c0fcb7..f24d0dee 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TABLE.md @@ -112,7 +112,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 @@ -130,7 +130,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 要创建的表名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif)**须知**: > > 物化视图的一些处理逻辑会通过表名的前缀来识别是不是物化视图日志表和物化视图关联表，因此，用户不要创建表名以mlog\_或matviewmap\_为前缀的表，否则会影响此表的一些功能。 @@ -169,7 +169,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA - 如果指定了INCLUDING RELOPTIONS，则源表的存储参数（即源表的WITH子句）会复制到新表中。默认情况下，不复制源表的存储参数。 - INCLUDING ALL包含了INCLUDING DEFAULTS、INCLUDING CONSTRAINTS、INCLUDING INDEXES、INCLUDING STORAGE、INCLUDING COMMENTS、INCLUDING PARTITION和INCLUDING RELOPTIONS的内容。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果源表包含serial、bigserial、smallserial、largeserial类型，或者源表字段的默认值是sequence，且sequence属于源表（通过CREATE SEQUENCE … OWNED BY创建），这些Sequence不会关联到新表中，新表中会重新创建属于自己的sequence。这和之前版本的处理逻辑不同。如果用户希望源表和新表共享Sequence，需要首先创建一个共享的Sequence（避免使用OWNED BY），并配置为源表字段默认值，这样创建的新表会和源表共享该Sequence。 > - 不建议将其他表私有的Sequence配置为源表字段的默认值，尤其是其他表只分布在特定的NodeGroup上，这可能导致CREATE TABLE … LIKE执行失败。另外，如果源表配置其他表私有的Sequence，当该表删除时Sequence也会连带删除，这样源表的Sequence将不可用。如果用户希望多个表共享Sequence，建议创建共享的Sequence。 @@ -179,7 +179,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 这个子句为表或索引指定一个可选的存储参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用任意精度类型Numeric定义列时，建议指定精度p以及刻度s。在不指定精度和刻度时，会按输入的显示出来。 参数的详细描述如下所示。 @@ -323,7 +323,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 取值范围: 字符串。 默认值：不开启加密时默认为空。 - + - hasuids 参数开启：更新表元组时，为元组分配表级唯一标识id。 @@ -375,7 +375,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 声明为字段约束的检查约束应该只引用该字段的数值，而在表约束里出现的表达式可以引用多个字段。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: expression表达式中，如果存在“<>NULL”或“！=NULL”，这种写法是无效的，需要写成“is NOT NULL”。 - **DEFAULT default_expr** @@ -423,7 +423,7 @@ CreateTable ::= CREATE [ [ GLOBAL | LOCAL ] [ TEMPORARY | TEMP ] | UNLOGGED ] TA 这两个关键字设置该约束是否可推迟。一个不可推迟的约束将在每条命令之后马上检查。可推迟约束可以推迟到事务结尾使用SET CONSTRAINTS命令检查。缺省是NOT DEFERRABLE。目前，UNIQUE约束、主键约束、外键约束可以接受这个子句。所有其他约束类型都是不可推迟的。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif)**说明**: > > Ustore表不支持**DEFERRABLE**以及**INITIALLY DEFERRED**关键字。 @@ -1099,7 +1099,7 @@ MogDB=# DROP SCHEMA IF EXISTS joe CASCADE; - 如果指定了INCLUDING PARTITION，则源表的分区定义会复制到新表中，同时新表将不能再使用PARTITION BY子句。默认情况下，不拷贝源表的分区定义。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 列表/哈希分区表暂不支持LIKE INCLUDING PARTITION。 - LIKE INCLUDING RELOPTIONS diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TEXT-SEARCH-DICTIONARY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TEXT-SEARCH-DICTIONARY.md index ddb6bf4e..77edd53e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TEXT-SEARCH-DICTIONARY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TEXT-SEARCH-DICTIONARY.md @@ -136,7 +136,7 @@ CreateTextSearchDictionary ::= CREATE TEXT SEARCH DICTIONARY name ( 词典定义文件所在目录。可以指定为本地目录或者OBS目录（只能在安全模式下指定OBS目录，通过启动时添加securitymode选项进入安全模式）。其中，本地目录格式为”file://absolute_path”，OBS目录格式为”obs://bucket_name/path accesskey=ak secretkey=sk region=rg”。默认值为预定义词典文件所在目录。FILEPATH参数必须和STOPWORDS参数同时指定，不允许单独指定。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 词典定义文件的文件名仅支持小写字母、数据、下划线混合。 - **value** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TRIGGER.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TRIGGER.md index 7557ca0e..1121bd2a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TRIGGER.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TRIGGER.md @@ -127,7 +127,7 @@ CreateTrigger ::= CREATE [ CONSTRAINT ] TRIGGER trigger_name { BEFORE | AFTER | 执行触发器时要提供给函数的可选的以逗号分隔的参数列表。参数是文字字符串常量，简单的名称和数字常量也可以写在这里，但它们都将被转换为字符串。 请检查触发器函数的实现语言的描述，以了解如何在函数内访问这些参数。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 关于触发器种类： > > - INSTEAD OF的触发器必须标记为FOR EACH ROW，并且只能在视图上定义。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md index 3efe6044..1f9f31cb 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-TYPE.md @@ -30,7 +30,7 @@ date: 2021-05-10 - 枚举类型 由若干个标签构成的列表，每一个标签值都是一个非空字符串，且字符串长度必须不超过63个字节。 - + - 集合类型 类似数组，但是没有长度限制，主要在存储过程中使用。 @@ -123,7 +123,7 @@ CreateType ::= CREATE TYPE name AS TABLE OF data_type 输入函数必须返回一个该数据类型本身的值。通常，一个输入函数应该被声明为STRICT。 如果不是这样，在读到一个NULL输入值时，调用输入函数时第一个参数会是NULL。在这种情况下，该函数必须仍然返回NULL，除非调用函数发生了错误（这种情况主要是想支持域输入函数，域输入函数可能需要拒绝NULL输入）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 输入和输出函数能被声明为具有新类型的结果或参数是因为：必须在创建新类型之前创建这两个函数。而新类型应该首先被定义为一种shell type，它是一种占位符类型，除了名称和拥有者之外它没有其他属性。这可以通过不带额外参数的命令CREATE TYPE name做到。然后用C写的I/O函数可以被定义为引用这种shell type。最后，用带有完整定义的CREATE TYPE把该shell type替换为一个完全的、合法的类型定义，之后新类型就可以正常使用了。 - **output_function** @@ -159,7 +159,7 @@ CreateType ::= CREATE TYPE name AS TABLE OF data_type 可选参数。将类型的修饰符的内部形式转换为外部文本形式的函数名。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果该类型支持修饰符（附加在类型声明上的可选约束，例如，char(5)或numeric(30,2)），则需要可选的type_modifier_input_function以及type_modifier_output_function。MogDB允许用户定义的类型有一个或者多个简单常量或者标识符作为修饰符。不过，为了存储在系统目录中，该信息必须能被打包到一个非负整数值中。所声明的修饰符会被以cstring数组的形式传递给type_modifier_input_function。 type_modifier_input_function必须检查该值的合法性（如果值错误就抛出一个错误），如果值正确，要返回一个非负integer值，该值将被存储在“typmod”列中。如果类型没有 type_modifier_input_function则类型修饰符将被拒绝。type_modifier_output_function把内部的整数typmod值转换回正确的形式用于用户显示。type_modifier_output_function必须返回一个cstring值，该值就是追加到类型名称后的字符串。例如，numeric的函数可能会返回(30,2)。如果默认的显示格式就是只把存储的typmod整数值放在圆括号内，则允许省略type_modifier_output_function。 - **analyze_function** @@ -214,7 +214,7 @@ CreateType ::= CREATE TYPE name AS TABLE OF data_type 可选参数。如果这种类型是其类型分类中的优先类型则为TRUE，否则为FALSE。默认为假。在一个现有类型分类中创建一种新的优先类型要非常谨慎， 因为这可能会导致很大的改变。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > category和preferred参数可以被用来帮助控制在混淆的情况下应用哪一种隐式造型。每一种数据类型都属于一个用单个ASCII 字符命名的分类，并且每一种类型可以是其所属分类中的“首选”。当有助于解决重载函数或操作符时，解析器将优先造型到首选类型（但是只能从同类的其他类型造型）。对于没有隐式转换到或来自任意其他类型的类型，让这些设置保持默认即可。不过，对于有隐式转换的相关类型的组，把它们都标记为属于同一个类别并且选择一种或两种“最常用”的类型作为该类别的首选通常是很有用的。在把一种用户定义的类型增加到一个现有的内建类别（例如，数字或者字符串类型）中时，category参数特别有用。不过，也可以创建新的全部是用户定义类型的类别。对这样的类别，可选择除大写字母之外的任何ASCII 字符。 - **default** @@ -243,7 +243,7 @@ CreateType ::= CREATE TYPE name AS TABLE OF data_type 可选参数。与枚举类型的一个值相关的文本标签，其值为长度不超过63个字符的非空字符串。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在创建用户定义类型的时候， MogDB会自动创建一个与之关联的数组类型，其名称由该元素类型的名称前缀一个下划线组成。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md index e40a30ad..9cad3871 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-USER-MAPPING.md @@ -37,7 +37,7 @@ CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER 这个子句指定用户映射的选项。这些选项通常定义该映射实际的用户名和口令。选项名必须唯一。允许的选项名和值与该服务器的外部数据包装器有关。 - >**说明：** + >**说明**: > >- 用户的口令会加密后保存到系统表[PG_USER_MAPPING](PG_USER_MAPPING)中，加密时需要使用usermapping.key.cipher和usermapping.key.rand作为加密密码文件和加密因子。首次使用前需要通过如下命令创建这两个文件，并将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。gs_ssh工具可以协助您快速将文件放入各节点对应目录下。 > @@ -77,7 +77,7 @@ CreateUserMapping ::= CREATE USER MAPPING FOR { user_name | USER | CURRENT_USER 远端MogDB用户对应的密码。 - > **说明：** + > **说明**: > MogDB在后台会对用户输入的password加密以保证安全性。该加密所需密钥文件需要使用gs_guc工具生成并使用gs_ssh工具发布到MogDB每个节点的`$GAUSSHOME/bin`目录下。password不应当包含'encryptOpt'前缀，否则会被认为是加密后的密文。 ## 相关链接 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-VIEW.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-VIEW.md index 760ec16c..9a6d89d5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-VIEW.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/CREATE-VIEW.md @@ -23,7 +23,7 @@ CreateView ::= CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] VIEW view_name [ ( col AS query; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 创建视图时使用WITH(security_barrier)可以创建一个相对安全的视图，避免攻击者利用低成本函数的RAISE语句打印出隐藏的基表数据。 > - 旧版MogDB在create or replace创建视图的时候，如果存在同名视图，则replace时不可以更改列信息或者删除列，只能追加列。2.1版之后的MogDB支持REPLACE VIEW语法更新或者删除列信息。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-CLIENT-MASTER-KEY.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-CLIENT-MASTER-KEY.md index 9698ee8b..6e569e9b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-CLIENT-MASTER-KEY.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-CLIENT-MASTER-KEY.md @@ -38,7 +38,7 @@ DropClientMasterKey ::= DROP CLIENT MASTER KEY [ IF EXISTS ] client_master_key_n - **CASCADE**：表示允许级联删除依赖于客户端加密主密钥的对象。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 在执行本语法的生命周期中，同时需要客户端和服务端更改状态，发生异常时可能存在服务端已删除密钥信息，但客户端未删除密钥文件的情况。 此时，客户端并不会在执行下一条语法的生命周期中，检查是否有期望被删除但却因发生异常而未被删除的密钥文件，而是需要用户定期检查密钥文件夹，对未被使用的密钥文件进行确认并处理。 ## **示例** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-DATABASE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-DATABASE.md index f791f5a3..0c89e446 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-DATABASE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-DATABASE.md @@ -19,7 +19,7 @@ date: 2021-05-10 - 不能在事务块中执行DROP DATABASE命令。 - 如果执行DROP DATABASE失败，事务回滚，需要再次执行一次DROP DATABASE IF EXISTS。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DROP DATABASE一旦执行将无法撤销，请谨慎使用。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DROP DATABASE一旦执行将无法撤销，请谨慎使用。 ## 语法格式 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-RESOURCE-POOL.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-RESOURCE-POOL.md index 13ef989d..5daa4684 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-RESOURCE-POOL.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-RESOURCE-POOL.md @@ -11,7 +11,7 @@ date: 2021-11-01 删除一个资源池。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果某个角色已关联到该资源池，无法删除。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果某个角色已关联到该资源池，无法删除。 ## 注意事项 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-SCHEMA.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-SCHEMA.md index 6688bd7a..18bf39f0 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-SCHEMA.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-SCHEMA.md @@ -38,9 +38,9 @@ DropSchema ::= DROP SCHEMA [ IF EXISTS ] schema_name [, ...] [ CASCADE | RESTRIC - CASCADE：自动删除包含在模式中的对象。 - RESTRICT：如果模式包含任何对象，则删除失败（缺省行为）。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 不要随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-USER.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-USER.md index 8e1747ea..091f8921 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-USER.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/DROP-USER.md @@ -44,7 +44,7 @@ DropUser ::= DROP USER [ IF EXISTS ] user_name [, ...] [ CASCADE | RESTRICT ]; - RESTRICT：如果用户还有任何依赖的对象，则拒绝删除该用户（缺省行为）。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在MogDB中，存在一个配置参数enable_kill_query，此参数在配置文件postgresql.conf中。此参数影响级联删除用户对象的行为： > > - 当参数enable_kill_query为on ，且使用CASCADE模式删除用户时，会自动kill锁定用户级联对象的进程，并删除用户。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/EXPLAIN-PLAN.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/EXPLAIN-PLAN.md index 6ea7c486..c50077df 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/EXPLAIN-PLAN.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/EXPLAIN-PLAN.md @@ -25,7 +25,7 @@ FOR statement ; - STATEMENT_ID用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。 ## 注意事项 @@ -40,7 +40,7 @@ FOR statement ; 1. 执行EXPLAIN PLAN。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。 > PLAN_TABLE详细介绍见[PLAN_TABLE](PLAN_TABLE)。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/GRANT.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/GRANT.md index 119ce128..a80c7918 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/GRANT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/GRANT.md @@ -40,7 +40,7 @@ date: 2021-05-18 当声明了WITH ADMIN OPTION，被授权的用户可以将该权限再次授予其他角色或用户，以及撤销所有由该角色或用户继承到的权限。当授权的角色或用户发生变更或被撤销时，所有继承该角色或用户权限的用户拥有的权限都会随之发生变更。 数据库系统管理员可以给任何角色或用户授予/撤销任何权限。拥有CREATEROLE权限的角色可以赋予或者撤销任何非系统管理员角色的权限。 - + - **将ANY权限授予给角色或用户** 将ANY权限授予特定的角色和用户，ANY权限的取值范围参见语法格式。当声明了WITH ADMIN OPTION，被授权的用户可以将该ANY权限再次授予其他角色/用户，或从其他角色/用户处回收该ANY权限。ANY权限可以通过角色被继承，但不能赋予PUBLIC。初始用户和三权分立关闭时的系统管理员用户可以给任何角色/用户授予或撤销ANY权限。 @@ -67,7 +67,7 @@ date: 2021-05-18 TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]; ``` - + - 将表中字段的访问权限赋予指定的用户或角色。 ```ebnf+diagram @@ -108,7 +108,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予域的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予域的访问权限。 - 将客户端加密主密钥CMK的访问权限赋予指定的用户或角色。 @@ -184,7 +184,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持大对象。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持大对象。 - 将模式的访问权限赋予指定的用户或角色。 @@ -195,7 +195,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。同名模式下创建表的权限无法通过此语法赋予，可以通过将角色的权限赋予其他用户或角色的语法，赋予同名模式下创建表的权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 将模式中的表或者视图对象授权给其他用户时，需要将表或视图所属的模式的USAGE权限同时授予该用户，若没有该权限，则只能看到这些对象的名称，并不能实际进行对象访问。同名模式下创建表的权限无法通过此语法赋予，可以通过将角色的权限赋予其他用户或角色的语法，赋予同名模式下创建表的权限。 - 将表空间的访问权限赋予指定的用户或角色。 @@ -215,7 +215,7 @@ date: 2021-05-18 [ WITH GRANT OPTION ]; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本版本暂时不支持赋予类型的访问权限。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本版本暂时不支持赋予类型的访问权限。 - 将Data Source对象的权限赋予指定的角色。 @@ -454,7 +454,7 @@ GRANT的参数说明如下所示。 - 如果用户有该对象上的部分权限，则GRANT命令只授予他有授权选项的权限。 - 如果用户没有可用的授权选项，GRANT ALL PRIVILEGES形式将发出一个警告信息，其他命令形式将发出在命令中提到的且没有授权选项的相关警告信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库系统管理员可以访问所有对象，而不会受对象的权限设置影响。这个特点类似Unix系统的root的权限。和root一样，除了必要的情况外，建议不要总是以系统管理员身份进行操作。 不允许对表分区进行GRANT操作，对分区表进行GRANT操作会引起告警。 - **WITH ADMIN OPTION** @@ -481,7 +481,7 @@ GRANT的参数说明如下所示。 | CREATE ANY SEQUENCE | 用户能够在public模式和用户模式下创建序列。 | | CREATE ANY INDEX | 用户能够在public模式和用户模式下创建索引。如果在某表空间创建分区表索引，需要授予用户该表空间的创建权限。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 用户被授予任何一种ANY权限后，用户对public模式和用户模式具有USAGE权限，对表1中除public之外的系统模式没有USAGE权限。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 用户被授予任何一种ANY权限后，用户对public模式和用户模式具有USAGE权限，对表1中除public之外的系统模式没有USAGE权限。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md index 4633fa03..4f96b2c5 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/INSERT.md @@ -23,7 +23,7 @@ date: 2021-05-18 - 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的insert语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。 ## 语法格式 @@ -32,7 +32,7 @@ date: 2021-05-18 Insert ::= [ WITH [ RECURSIVE ] with_query [, ...] ] INSERT [/*+ plan_hint */] INTO table_name [partition_clause] [ AS alias ] [ ( column_name [, ...] ) ] { DEFAULT VALUES - | VALUES {( { expression | DEFAULT } [, ...] ) }[, ...] + | VALUES {( { expression | DEFAULT } [, ...] ) }[, ...] | query } [ ON DUPLICATE KEY UPDATE { NOTHING | { column_name = { expression | DEFAULT } } [, ...] [ WHERE condition ] }] [ RETURNING {* | {output_expression [ [ AS ] output_name ] }[, ...]} ]; @@ -57,14 +57,14 @@ INSERT [/*+ plan_hint */] INTO table_name [partition_clause] [ AS alias ] [ ( co - column_name指定子查询结果集中显示的列名。 - 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 - + - 用户可以使用MATERIALIZED / NOT MATERIALIZED对CTE进行修饰。 - + - 如果声明为MATERIALIZED，WITH查询将被物化，生成一个子查询结果集的拷贝，在引用处直接查询该拷贝，因此WITH子查询无法和主干SELECT语句进行联合优化（如谓词下推、等价类传递等），对于此类场景可以使用NOT MATERIALIZED进行修饰，如果WITH查询语义上可以作为子查询内联执行，则可以进行上述优化。 - + - 如果用户没有显示声明物化属性则遵守以下规则：如果CTE只在所属主干语句中被引用一次，且语义上支持内联执行，则会被改写为子查询内联执行，否则以CTE Scan的方式物化执行。 - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > INSERT ON DUPLICATE KEY UPDATE不支持WITH及WITH RECURSIVE子句。 - **plan_hint子句** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/MOVE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/MOVE.md index 19a4a675..4f73fc4b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/MOVE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/MOVE.md @@ -44,7 +44,7 @@ direction ::= NEXT MOVE命令的参数与FETCH的相同，详细请参见FETCH的参数说明。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 成功完成时，MOVE命令将返回一个“MOVE count”的标签，count是一个使用相同参数的FETCH命令会返回的行数（可能为零）。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/REINDEX.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/REINDEX.md index b851e486..64e74227 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/REINDEX.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/REINDEX.md @@ -74,7 +74,7 @@ REINDEX CONCURRENTLY这种形式的重建索引不能在事务块中执行。 - 列存表、全局分区表和临时表不支持CONCURRENTLY方式重建索引。 - REINDEX SYSTEM CONCURRENTLY不会执行任何操作，因为系统表不支持在线重建索引。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 重建索引时指定此关键字，需要执行先后两次对该表的全表扫描来完成build，第一次扫描的时候创建新索引，不阻塞读写操作；第二次扫描的时候合并更新第一次扫描到目前为止发生的变更。 > @@ -90,7 +90,7 @@ REINDEX CONCURRENTLY这种形式的重建索引不能在事务块中执行。 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 - **FORCE** @@ -107,7 +107,7 @@ REINDEX CONCURRENTLY这种形式的重建索引不能在事务块中执行。 - 如果前面是REINDEX TABLE，则这里应该指定分区的名称； - 如果前面是REINDEX INTERNAL TABLE，则这里应该指定列存分区表的分区的名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT-INTO.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT-INTO.md index 4477dd0e..a6f35db6 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT-INTO.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT-INTO.md @@ -64,14 +64,14 @@ new_table指定新建表的名称。 本地临时表只在当前会话可见，本会话结束后会自动删除。因此，在除当前会话连接的数据库节点故障时，仍然可以在当前会话上创建和使用临时表。由于临时表只在当前会话创建，对于涉及对临时表操作的DDL语句，会产生DDL失败的报错。因此，建议DDL语句中不要对临时表进行操作。TEMP和TEMPORARY等价。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 本地临时表通过每个会话独立的以pg_temp开头的schema来保证只对当前会话可见，因此，不建议用户在日常操作中手动删除以pg_temp，pg_toast_temp开头的schema。 > - 如果建表时不指定TEMPORARY/TEMP关键字，而指定表的schema为当前会话的pg_temp_开头的schema，则此表会被创建为临时表。 > - ALTER/DROP全局临时表和索引，如果其它会话正在使用它，禁止操作。 > - 全局临时表的DDL只会影响当前会话的用户数据和索引。例如truncate、reindex、analyze只对当前会话有效。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > SELECT INTO的其它参数可参考[SELECT](SELECT)的参数说明。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT.md index cf7b3c90..ec849266 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SELECT.md @@ -40,7 +40,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 [ {FOR { UPDATE | NO KEY UPDATE | SHARE | KEY SHARE } [ OF table_name [, ...] ] [ NOWAIT ]} [...] ]; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > condition和expression中可以使用targetlist中表达式的别名。 > @@ -90,7 +90,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 FOR ( partition_value [, ...] ) }; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定分区只适合普通表。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定分区只适合普通表。 - 其中设置排序方式nlssort_expression_clause为： @@ -138,7 +138,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 ON ( expression [, ...] ) 只保留那些在给出的表达式上运算出相同结果的行集合中的第一行。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: DISTINCT ON表达式是使用与ORDER BY相同的规则进行解释的。除非使用了ORDER BY来保证需要的行首先出现，否则，”第一行” 是不可预测的。 - **SELECT列表** @@ -187,7 +187,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 关键字，闪回查询的标识，根据表的CSN闪回查询指定CSN点的结果集。其中CSN可从gs_txn_snapshot记录的snpcsn号查得。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 闪回查询不能跨越影响表结构或物理存储的语句，否则会报错。即闪回点和当前点之间，如果执行过修改表结构或影响物理存储的语句（DDL、DCL、VACUUM FULL），则闪回失败，报错:“ERROR: The table definition of T1 has been changed.”。 > - 闪回点过旧时，因闪回版本被回收等导致无法获取旧版本会导致闪回失败，报错：Restore point too old。可通过将version_retention_age和vacuum_defer_cleanup_age设置成同值，配置闪回功能旧版本保留期限，取值范围是0~1000000，值为0表示VACUUM不会延迟清除无效的行存记录。 @@ -249,7 +249,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 CROSS JOIN等效于INNER JOIN ON（TRUE） ，即没有被条件删除的行。这种连接类型只是符号上的方便，因为它们与简单的FROM和WHERE的效果相同。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [, ...]) 之一。但是它们不能出现在CROSS JOIN中。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 必须为INNER和OUTER连接类型声明一个连接条件，即NATURAL ON，join_condition，USING (join_column [, ...]) 之一。但是它们不能出现在CROSS JOIN中。 其中CROSS JOIN和INNER JOIN生成一个简单的笛卡尔积，和在FROM的顶层列出两个项的结果相同。 @@ -286,7 +286,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 9. “(+)“只能出现”比较表达式”，”NOT表达式”，“ANY表达式”，“ALL表达式”，“IN表达式”，“NULLIF表达式”，“IS DISTINCT FROM表达式”，“IS OF”表达式。”(+)“不能出现在其他类型表达式中，并且这些表达式中不允许出现通过“AND”和“OR”连接的表达式。 10. “(+)“只能转化为左外连接或者右外连接，不能转化为全连接，即不能在一个表达式的两个表上同时指定”(+)“ - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对于WHERE子句的LIKE操作符，当LIKE中要查询特殊字符“%”、“_”、“\”的时候需要使用反斜杠“\”来进行转义。 - **START WITH** @@ -312,7 +312,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 GROUPING SETS子句是GROUP BY子句的进一步扩展，它可以使用户指定多个GROUP BY选项。 这样做可以通过裁剪用户不需要的数据组来提高效率。 当用户指定了所需的数据组时，数据库不需要执行完整CUBE或ROLLUP生成的聚合集合。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 如果SELECT列表的表达式中引用了那些没有分组的字段，则会报错，除非使用了聚集函数，因为对于未分组的字段，可能返回多个数值。 - **HAVING子句** @@ -351,7 +351,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 UNBOUNDED FOLLOWING - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询目前只支持row_number窗口函数，不支持frame_clause。 - **UNION子句** @@ -420,7 +420,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 - 在与DISTINCT关键字一起使用的情况下，ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - 在与GROUP BY子句一起使用的情况下，ORDER BY中排序的列必须包括在SELECT语句所检索的结果集的列中。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > 如果要支持中文拼音排序，需要在初始化数据库时指定编码格式为UTF-8或GBK。 命令如下: > @@ -474,7 +474,7 @@ SELECT语句就像叠加在数据库表上的过滤器，利用SQL关键字从 如果一个表中同时出现（或隐含同时出现）在多个子句中，则按照最强的锁处理。类似的，如果影响一个表的任意子句中出现了NOWAIT，该表将按照NOWAIT处理。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 对列存表的查询不支持for update/share。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 对列存表的查询不支持for update/share。 - **NLS_SORT** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET-TRANSACTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET-TRANSACTION.md index 89ebf03b..4bea2e60 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET-TRANSACTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET-TRANSACTION.md @@ -41,7 +41,7 @@ SetTransaction ::= { SET [ LOCAL ] TRANSACTION|SET SESSION CHARACTERISTICS AS TR 指定事务隔离级别，该参数决定当一个事务中存在其他并发运行事务时能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在事务中第一个数据修改语句（SELECT，INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，当前事务的隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET.md index a1e242cf..bed066be 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/SET.md @@ -101,7 +101,7 @@ date: 2021-05-18 可设置的运行时参数的名称。可用的运行时参数可以使用SHOW ALL命令查看。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 部分通过SHOW ALL查看的参数不能通过SET设置。如max_datanodes。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 部分通过SHOW ALL查看的参数不能通过SET设置。如max_datanodes。 - **value** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/START-TRANSACTION.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/START-TRANSACTION.md index db24b039..37d61f2c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/START-TRANSACTION.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/START-TRANSACTION.md @@ -51,7 +51,7 @@ Begin ::= BEGIN [ WORK | TRANSACTION ] 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > 在事务中第一个数据修改语句（SELECT, INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。 取值范围: diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/TRUNCATE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/TRUNCATE.md index 7a9ea3ca..d95d067e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/TRUNCATE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/TRUNCATE.md @@ -80,7 +80,7 @@ date: 2021-05-18 取值范围: 需要进行删除数据分区的分区键的取值范围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 使用PARTITION FOR子句时，partition_value所在的整个分区会被清空。 - **UPDATE GLOBAL INDEX** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/UPDATE.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/UPDATE.md index 540ed181..894774cc 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/UPDATE.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/UPDATE.md @@ -102,7 +102,7 @@ sub_query ::= SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ] 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 - **condition** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/VACUUM.md b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/VACUUM.md index 13320f54..96f2da6c 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/VACUUM.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/sql-syntax/VACUUM.md @@ -57,7 +57,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 选择“FULL”清理，这样可以恢复更多的空间，但是需要耗时更多，并且在表上施加了排他锁。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 使用FULL参数会导致统计信息丢失，如果需要收集统计信息，请在VACUUM FULL语句中加上analyze关键字。 - **FREEZE** @@ -94,7 +94,7 @@ VACUUM回收表或B-Tree索引中已经删除的行所占据的存储空间。 - **subpartition\_name** 要清理的表的二级分区名称。缺省时为所有二级分区。 - + - **DELTAMERGE** 只针对列存表，将列存表的delta table中的数据转移到主表存储上。对列存表而言，此操作受enable_delta_store和参数说明中的deltarow_threshold控制。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/13-HLL.md b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/13-HLL.md index a324a7b3..bac67b6a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/13-HLL.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/13-HLL.md @@ -22,7 +22,7 @@ HLL与其他算法的比较请参见[表1](#biao11)。 HLL在计算速度和所占存储空间上都占优势。在时间复杂度上，Sort算法需要排序至少O(nlogn)的时间，虽说Hash算法和HLL一样扫描一次全表O(n)的时间就可以得出结果，但是存储空间上，Sort算法和Hash算法都需要先把原始数据存起来再进行统计，会导致存储空间消耗巨大，而对HLL来说不需要存原始数据，只需要维护HLL数据结构，故占用空间有很大的压缩，默认规格下HLL数据结构的最大空间约为16KB。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 当前默认规格下可计算最大distinct值的数量约为1.1e+15个，误差率为0.8%。用户应注意如果计算结果超过当前规格下distinct最大值会导致计算结果误差率变大，或导致计算结果失败并报错。 > - 用户在首次使用该特性时，应该对业务的distinct value做评估，选取适当的配置参数并做验证，以确保精度符合要求： @@ -39,7 +39,7 @@ HLL中主要的数据结构，请参见[表2](#hyper)。 创建HLL数据类型时，可以支持0\~4个参数入参，具体的参数含义与参数规格同函数hll_empty一致。第一个参数为log2m，表示分桶数的对数值，取值范围10\~16；第二个参数为log2explicit，表示Explicit模式的阈值大小，取值范围0\~12；第三个参数为log2sparse，表示Sparse模式的阈值大小，取值范围0\~14；第四个参数为duplicatecheck，表示是否启用duplicatecheck，取值范围为0\~1。当入参输入值为-1时，会采用默认值设定HLL的参数。可以通过\d或\d+查看HLL类型的参数。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 创建HLL数据类型时，根据入参的行为不同，结果不同： > @@ -79,7 +79,7 @@ MogDB=# create table t4(id int, set hll(5,-1)); ERROR: log2m = 5 is out of range, it should be in range 10 to 16, or set -1 as default ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 对含有HLL类型的表插入HLL对象时，HLL类型的设定参数须同插入对象的设定参数一致，否则报错。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/17-xml-type.md b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/17-xml-type.md index 7c713859..d2409fac 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/17-xml-type.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/17-xml-type.md @@ -27,7 +27,7 @@ xmlconcat (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该功能默认未开启，如需使用，需要重新使用build.sh脚本编译数据库，修改./configure配置参数，在其中加入--with-libxml参数。 > - 在执行编译之前，需要先执行`yum install -y libxml2-devel`，否则会有”configure: error: library 'xml2' (version >= 2.6.23) is required for XML support”的报错。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/5-binary-data-types.md b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/5-binary-data-types.md index 09fb7b8d..5240c2f3 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/5-binary-data-types.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/5-binary-data-types.md @@ -21,7 +21,7 @@ MogDB支持的二进制类型请参见[表1](#biao1)。 | _BYTEAWITHOUTORDERWITHEQUALCOL | 变长的二进制字符串，密态特性新增的类型 | 4字节加上实际的二进制字符串。最大为1GB减去53字节（即1073741771字节）。 | | _BYTEAWITHOUTORDERCOL | 变长的二进制字符串，密态特性新增的类型 | 4字节加上实际的二进制字符串。最大为1GB减去53字节（即1073741771字节）。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-8203字节（即1073733621字节）。 > - 不支持直接使用BYTEAWITHOUTORDERWITHEQUALCOL、BYTEAWITHOUTORDERCOL、\_BYTEAWITHOUTORDERWITHEQUALCOL和\_BYTEAWITHOUTORDERCOL类型创建表。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/6-date-time-types.md b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/6-date-time-types.md index 29633a7c..62c8e351 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/6-date-time-types.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/supported-data-types/6-date-time-types.md @@ -9,7 +9,7 @@ date: 2021-06-16 MogDB支持的日期/时间类型请参见表1。该类型的操作符和内置函数请参见[时间和日期处理函数和操作符](8-date-and-time-processing-functions-and-operators)。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果其他的数据库时间格式和MogDB的时间格式不一致，可通过修改配置参数DateStyle的值来保持一致。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果其他的数据库时间格式和MogDB的时间格式不一致，可通过修改配置参数DateStyle的值来保持一致。 **表 1** 日期/时间类型 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md index 43fddeaa..85ddd143 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/overview-of-system-catalogs-and-system-views.md @@ -15,7 +15,7 @@ date: 2021-04-19 用户可以删除后重新创建这些表、增加列、插入和更新数值，但是用户修改系统表会导致系统信息的不一致，从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图，或者手工重命名系统表或系统视图所在的模式，而是由SQL语句关联的系统表操作自动维护系统表信息。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 用户应该禁止对系统表进行增删改等操作，人为对系统表的修改或破坏可能会导致系统各种异常情况甚至MogDB不可用。 ## 支持updatable-views @@ -45,7 +45,7 @@ date: 2021-04-19 + 多表连接的视图做DML的时候必须存在不少于1张带有唯一键或者主键的基表 + 多表连接的视图上的任何INSERT、UPDATE或DELETE操作一次只能修改一个基表 - + ## 示例 ### INSERT VIEW @@ -59,10 +59,10 @@ INSERT INTO table1 VALUES(3, reverse('HHiiw6'), 'Hiw6', '23fdsg'); CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; -INSERT INTO test_view VALUES(4, '2sdafd', '23ata', 'dstsee'); +INSERT INTO test_view VALUES(4, '2sdafd', '23ata', 'dstsee'); SELECT * FROM table1 WHERE id = 4; - id | a | b | c + id | a | b | c ----+--------+-------+-------- 4 | 2sdafd | 23ata | dstsee (1 row) @@ -84,7 +84,7 @@ CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; UPDATE test_view SET a = '2222' WHERE id = 2; SELECT * FROM table1; - id | a | b | c + id | a | b | c ----+--------+--------+-------- 1 | 87A321 | 123A78 | 1sdfBB 3 | 6wiiHH | Hiw6 | 23fdsg @@ -106,14 +106,14 @@ INSERT INTO table1 VALUES(3, reverse('HHiiw6'), 'Hiw6', '23fdsg'); CREATE VIEW test_view AS SELECT * FROM table1 WHERE id > 1; -DELETE FROM test_view WHERE id = 2; +DELETE FROM test_view WHERE id = 2; SELECT * FROM table1 WHERE id > 1; - id | a | b | c + id | a | b | c ----+--------+------+-------- 3 | 6wiiHH | Hiw6 | 23fdsg (1 row) DROP VIEW IF EXISTS test_view; DROP TABLE IF EXISTS table1; -``` \ No newline at end of file +``` diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC.md b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC.md index c66c7a8a..bf776f88 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC.md @@ -27,4 +27,4 @@ PG_STATISTIC系统表存储有关该数据库中表和索引列的统计数据 | stadndistinct | real | 标识dn1上字段里唯一的非NULL数据值的数目。
- 一个大于零的数值是独立数值的实际数目。
- 一个小于零的数值是表中行数的分数的负数（比如，一个字段的数值平均出现概率为两次，则可以表示为stadistinct=-0.5）。
- 零值表示独立数值的数目未知。 | | staextinfo | text | 统计信息的扩展信息。预留字段。 | -> **须知：** PG_STATISTIC系统表存储了统计对象的一些敏感信息，如高频值MCV。系统管理员和授权后的其他用户可以通过访问PG_STATISTIC系统表查询到统计对象的这些敏感信息。 +> **须知**: PG_STATISTIC系统表存储了统计对象的一些敏感信息，如高频值MCV。系统管理员和授权后的其他用户可以通过访问PG_STATISTIC系统表查询到统计对象的这些敏感信息。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC_EXT.md b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC_EXT.md index 16f06d82..55fc0a60 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC_EXT.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/system-catalogs-and-system-views/system-catalogs/PG_STATISTIC_EXT.md @@ -27,4 +27,4 @@ PG_STATISTIC_EXT系统表存储有关该数据库中表的扩展统计数据， | stavaluesN | anyarray | 第n个"槽位"类型的字段数据值，如果该槽位类型不存储任何数据值，则就是NULL。每个数组的元素值实际上都是指定字段的数据类型，因此，除了把这些字段的类型定义成anyarray之外，没有更好的办法。
n的取值范围: 1～5 | | staexprs | pg_node_tree | 扩展统计信息对应的表达式。 | -> **须知：** PG_STATISTIC_EXT系统表存储了统计对象的一些敏感信息，如高频值MCV。系统管理员和授权后的其他用户可以通过访问PG_STATISTIC_EXT系统表查询到统计对象的这些敏感信息。 +> **须知**: PG_STATISTIC_EXT系统表存储了统计对象的一些敏感信息，如高频值MCV。系统管理员和授权后的其他用户可以通过访问PG_STATISTIC_EXT系统表查询到统计对象的这些敏感信息。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/FAQ.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/FAQ.md index 11474752..b2f55aea 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/FAQ.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/FAQ.md @@ -78,7 +78,7 @@ read cipher file or random parameter file failed. gs_ctl build -D data_dir ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若备机数据库已停止，需要重新生成证书文件或者复制证书文件（$GAUSSHOME/share下的证书文件）到数据目录，启动备机并重建备实例。生成证书文件的相关操作请参见《开发者指南》。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若备机数据库已停止，需要重新生成证书文件或者复制证书文件（$GAUSSHOME/share下的证书文件）到数据目录，启动备机并重建备实例。生成证书文件的相关操作请参见《开发者指南》。 ## 使用gs_om -t status --all查询集群状态，长时间没有响应 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/client-tool/1-gsql.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/client-tool/1-gsql.md index 0a0fbe38..af2c1404 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/client-tool/1-gsql.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/client-tool/1-gsql.md @@ -15,7 +15,7 @@ gsql是MogDB提供在命令行下运行的数据库连接工具，可以通过 - **连接数据库**：详细操作请参见《管理指南》中“日常运维 > [gsql客户端连接](using-the-gsql-client-for-connection)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gsql创建连接时，数据库默认设置会有5分钟超时时间。如果在这个时间内，数据库未正确地接受连接并对身份进行认证，gsql将超时退出。 针对此问题，可以参考[常见问题处理](#常见问题处理)。 - **执行SQL语句**：支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 @@ -54,7 +54,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql预定义了一些特殊变量，同时也规划了变量的取值。为了保证和后续版本最大限度地兼容，请避免以其他目的使用这些变量。所有特殊变量见[表2](#teshubian)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 所有特殊变量都由大写字母、数字和下划线组成。 > - 要查看特殊变量的默认值，请使用元命令`\echo : _varname_`（例如`\echo :DBNAME`）。 @@ -94,7 +94,7 @@ gsql的高级特性如[表1](#gsql)所示。 执行以上命令，将会查询HR.areaS表。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 变量的值是逐字复制的，甚至可以包含不对称的引号或反斜杠命令。所以必须保证输入的内容有意义。 - 提示符 @@ -160,7 +160,7 @@ gsql的高级特性如[表1](#gsql)所示。 gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。 示例1，使用omm用户连接到本机mogdb数据库的15400端口。 @@ -533,7 +533,7 @@ omm@[local] MogDB=# 元命令的详细说明请参见下表。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 以下命令中所提到的FILE代表文件路径。此路径可以是绝对路径（如/home/gauss/file.txt），也可以是相对路径（file.txt，file.txt会默认在用户执行gsql命令所在的路径下创建）。 **表 11** 一般的元命令 @@ -568,7 +568,7 @@ omm@[local] MogDB=# | \\o [FILE] | 把所有的查询结果发送到文件里。 | | \\qecho [STRING] | 把字符串写到查询结果输出流里。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: [表14 显示信息元命令](#xianshi)中的选项S表示显示系统对象，PATTERN表示显示对象附加的描述信息。用来指定要被显示的对象名称。 **表 14** 显示信息元命令 @@ -786,7 +786,7 @@ omm@[local] MogDB=# 数据库由于安全问题，禁止远程登录时使用trust模式。这时需要修改pg_hba.conf里的连接认证信息。具体的设置信息请参见：《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。建议业务应用部署在MogDB之外，而非MogDB内部。 - 连接数据库，添加“-h 127.0.0.1”可以连接，去掉后无法连接问题。 @@ -839,7 +839,7 @@ omm@[local] MogDB=# GRANT CONNECT ON DATABASE mogdb TO user1; ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 实际上，常见的许多错误操作也可能产生用户无法连接上数据库的现象。如用户连接的数据库不存在，用户名或密码输入错误等。这些错误操作在客户端工具也有相应的提示信息。 > > ```bash > gsql -d mogdb -p 15400 @@ -925,7 +925,7 @@ omm@[local] MogDB=# 目标数据库主节点的pg_hba.conf里配置了当前客户端IP使用”gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到”sha256”后再试。配置方法见《安全指南》中“数据库安全管理 > 客户端接入认证 > [配置文件参考](1-client-access-authentication#配置文件参考)”章节。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 请不要修改pg_hba.conf中MogDB主机的相关设置，否则可能导致数据库功能故障。 > - 建议业务应用部署在MogDB之外，而非MogDB内部。 @@ -938,4 +938,4 @@ omm@[local] MogDB=# 解决此问题，重试便可。同时请尽可能避免在升级等运维操作过程中，在MogDB内部运行业务程序，避免升级时因替换文件产生此问题。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 \ No newline at end of file + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 此故障的core dump文件的可能堆栈是dl_main及其子调用，它是操作系统用来初始化进程做共享动态库加载的。如果进程已经初始化，但是共享动态库还未加载完成，严格意义上来说，进程并未完全启动。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/0-gs_cgroup.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/0-gs_cgroup.md index 2cdfd3b4..2fc18225 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/0-gs_cgroup.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/0-gs_cgroup.md @@ -51,7 +51,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 删除当前用户已建的`class1`Cgroups。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 如果删除Class控制组，则Workload控制组也被删除。 3. 更新已创建控制组的资源配额。 @@ -80,7 +80,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 更新Gaussdb进程使用的CPU核数为0-20。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > -f参数只适用于对Gaussdb设置核数范围。对于其他各控制组，如需设置核数范围，需要使用-fixed参数。 5. 设置异常处理信息（class:wg组需存在）。 @@ -109,7 +109,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup -S class -E "qualificationtime=2400,cpuskewpercnt=90" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > 给控制组设置异常处理信息，需要确保对应的控制组已经创建。指定多个阈值时用“，”分隔，不指定任何动作时默认为“penalty”操作。 6. 设置控制组使用的核数范围。 @@ -120,7 +120,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup -S class -G wg -g 20 --fixed -u ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > Class或Workload核数范围必须通过指定--fixed参数设置。 7. 回退上一个步骤。 @@ -129,7 +129,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 gs_cgroup --recover ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > --recover只支持对Class控制组和Workload控制组的增删改操作进行回退，且只支持回退一次操作。 8. 查看已创建的控制组信息。 @@ -198,7 +198,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 | 725 | | Medium | - | | | 726 | | High | - | | | 727 | | Rush | - | | - + 2. 查看操作系统中树形结构的控制组信息 `gs_cgroup -P`显示控制组树形结构信息，其中shares代表操作系统中CPU资源的动态资源配额`cpu.shares`的数值，cpus代表操作系统中CPUSET资源的动态资源限额`cpuset.cpus`的数值，指的是该控制组能够使用的核数范围。 @@ -425,7 +425,7 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 取值范围: 字符串，最长为32个字符。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 对于磁盘major:minor的编号获取，可以通过下面方式。如获取/mpp目录对应的磁盘编号： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 对于磁盘major:minor的编号获取，可以通过下面方式。如获取/mpp目录对应的磁盘编号： > > ```bash > df @@ -441,4 +441,4 @@ gs_cgroup工具为使用数据库的操作系统用户创建Cgroups配置文件 > brw-rw---- 1 root disk 8, 48 Feb 26 11:20 /dev/sdd > ``` > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 这里一定要查sdd的磁盘号，不能是sdd1的磁盘号。否则执行时会报错。 如果更新IO的限额配置信息超过了可允许的最大配置字串，则新的更新不存储在配置文件中。如当前设置的字串长度为96，更新IO的磁盘数量大于8个，则有可能超出字串限制，更新成功，但是不存储在配置文件中。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 这里一定要查sdd的磁盘号，不能是sdd1的磁盘号。否则执行时会报错。 如果更新IO的限额配置信息超过了可允许的最大配置字串，则新的更新不存储在配置文件中。如当前设置的字串长度为96，更新IO的磁盘数量大于8个，则有可能超出字串限制，更新成功，但是不存储在配置文件中。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/1-gs_check.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/1-gs_check.md index a8f5ec29..ec09754a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/1-gs_check.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/1-gs_check.md @@ -817,7 +817,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 否 - + - Others @@ -833,7 +833,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** CheckNetSpeed检查项： +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: CheckNetSpeed检查项： > > - CheckNetSpeed不支持-L本地检查模式，-L模式无法构造网络压力，检查的结果不准确。 > - 在节点数小于6时，speed_test构造的网络压力可能无法跑满带宽，可能会造成检查结果不准确。 @@ -867,7 +867,7 @@ gs_check改进增强，统一化当前系统中存在的各种检查工具，例 scp scene_upgrade.xml SIA1000068994：home/package/script/gspylib/inspection/config/ ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: home/package/script/gspylib/inspection/config就是新建的场景配置文件的绝对路径。 5. 换至omm用户，执行以下命令查看检查结果。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md index 9a8d7987..3c4421ba 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/2-gs_checkos.md @@ -47,7 +47,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 取值范围: A1…A14、B1…B8。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: A1…A14 表示只检查操作系统参数，并不设置。 B1…B8 表示将参数系统参数设置为期望值。 A和B不能同时输入。 详细的检查项请参见[表1](#gs_checkos)。 @@ -55,7 +55,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 主机名称列表文件。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称的列表。 @@ -120,7 +120,7 @@ gs_checkos工具用来帮助检查操作系统、控制参数、磁盘配置等 | B7 | 设置欧拉系统属性（Set RemoveIPC value） | 欧拉系统属性检查：检查设置欧拉系统文件/usr/lib/systemd/system/systemd-logind.service，/etc/systemd/logind.conf中配置项RemoveIPC属性值是否为no，当不为no时，对其进行修改设置。 | | B8 | 设置sshd服务应用pam模块（Set Session Process） | 远程设备继承系统默认资源：修改/etc/pam.d/sshd服务文件，添加配置项session required pam_limits.so，来控制用户使用的资源。 | -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - A6选项检查标准来自配置文件check_list.conf下[/etc/sysctl.conf]、[SUGGEST:/etc/sysctl.conf]域： 若[/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Abnormal，可以使用B1参数进行设置。 若[SUGGEST:/etc/sysctl.conf]下参数值与系统实际参数值不同，A6检查提示Warning，B1参数不会进行设置，需根据实际情况进行手动设置。 > - A7选项检查系统文件句柄标准来自配置文件check_list.conf下[/etc/security/limits.conf]域open file参数，可以使用B2参数进行设置。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/4-gs_collector.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/4-gs_collector.md index db05e882..9a6fd5f2 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/4-gs_collector.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/4-gs_collector.md @@ -60,7 +60,7 @@ date: 2021-06-07 主机名称列表文件。该文件为纯文本格式。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** -f和-h参数不能同时使用。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f和-h参数不能同时使用。 取值范围: 主机名称列表。 @@ -97,7 +97,7 @@ date: 2021-06-07 } ``` - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: TypeName和对应的Content取值范围见表1 gs_collector内容收集对照表。 对于Log、CoreDump、Config和XLog四种类型，Interval和Count参数不生效。 @@ -120,7 +120,7 @@ date: 2021-06-07 若关键字KEYWORD中含有空格，需要使用双引号包围。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 性能日志为二进制日志，关键字搜集功能不支持该日志的搜集。 - --begin-time diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/5-gs_dump.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/5-gs_dump.md index b11c9e11..4bd32807 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/5-gs_dump.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/5-gs_dump.md @@ -39,7 +39,7 @@ gs_dump可以创建四种不同的导出文件格式，通过“-F”或者“-- | 目录归档格式 | d | 该格式会创建一个目录，该目录包含两类文件，一类是目录文件，另一类是每个表和blob对象对应的数据文件。 | - | | | tar归档格式 | t | tar归档文件支持从导出文件中恢复所有或所选数据库对象。tar归档格式不支持压缩且对于单独表大小应小于8GB。 | - | | -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 ## 注意事项 @@ -53,7 +53,7 @@ gs_dump可以创建四种不同的导出文件格式，通过“-F”或者“-- gs_dump [OPTION]... [DBNAME] ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “DBNAME”前面不需要加短或长选项。“DBNAME”指定要连接的数据库。 例如： 不需要-d，直接指定“DBNAME”。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “DBNAME”前面不需要加短或长选项。“DBNAME”指定要连接的数据库。 例如： 不需要-d，直接指定“DBNAME”。 ```bash gs_dump -p port_number postgres -f dump1.sql @@ -148,7 +148,7 @@ gs_dump -p port_number -f dump1.sql 只转储与模式名称匹配的模式，此选项包括模式本身和所有它包含的对象。如果该选项没有指定，所有在目标数据库中的非系统模式将会被转储。写入多个-n选项来选择多个模式。此外，根据gsql的\d命令所使用的相同规则，模式参数可被理解成一个pattern，所以多个模式也可以通过在该pattern中写入通配符来选择。使用通配符时，注意给pattern打引号，防止shell扩展通配符。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - 当-n已指定时，gs_dump不会转储已选模式所附着的任何其他数据库对象。因此，无法保证某个指定模式的转储结果能够自行成功地储存到一个空数据库中。 - 当-n指定时，非模式对象不会被转储。 @@ -207,7 +207,7 @@ gs_dump -p port_number -f dump1.sql 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数--include-table-file来替换。 @@ -245,7 +245,7 @@ gs_dump -p port_number -f dump1.sql 指定不需要dump的表文件。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 同--include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 同--include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… - -x, --no-privileges|--no-acl @@ -365,7 +365,7 @@ gs_dump -p port_number -f dump1.sql - 至少包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）、非字母数字字符（限定为~!@#$%^&*()-_=+|[]{};:,<.>/?）四类字符中的三类字符。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定--with-key参数。 > - 不支持加密导出存储过程和函数。 @@ -404,7 +404,7 @@ gs_dump -p port_number -f dump1.sql gs_dump -p port_number postgres -f backup.sql -F plain --dont-overwrite-file ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -s/--schema-only和-a/--data-only不能同时使用。 - -c/--clean和-a/--data-only不能同时使用。 @@ -474,7 +474,7 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中“Bigdata@123”表示数据库用户密码；“backup/MPPDB_backup.sql”表示导出的文件，其中backup表示相对于当前目录的相对目录；“37300”表示数据库服务器端口；“postgres”表示要访问的数据库名。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1：执行gs_dump，导出postgres数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md index c31f27a5..eb196142 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/6-gs_dumpall.md @@ -194,12 +194,12 @@ gs_dumpall [OPTION]... - --parallel-jobs 指定备份进程并发数，取值范围为1~1000。 - + - --pipeline 使用管道传输密码，禁止在终端使用。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - -g/--globals-only和-r/--roles-only不能同时使用。 - -g/--globals-only和-t/--tablespaces-only不能同时使用。 @@ -268,7 +268,7 @@ gs_dumpall恢复前需要所有必要的表空间目录才能退出；否则， 使用gs_dumpall一次导出MogDB的所有数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: gs_dumpall仅支持纯文本格式导出。所以只能使用gsql恢复gs_dumpall导出的转储内容。 ```bash gs_dumpall -f backup/bkp2.sql -p 37300 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7-gs_guc.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7-gs_guc.md index 3916655d..398c8e48 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7-gs_guc.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7-gs_guc.md @@ -31,13 +31,13 @@ gs_guc工具由操作系统用户omm执行。 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为client，则会生成这两个文件。其中“client.key.cipher”存储用户密码的密文，“client.key.rand”存储的是加密因子。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: “client.key.cipher”和“client.key.rand”是不指定-U选项时生成的密文文件和加密因子文件。如果通过-U指定了用户名，则会生成以用户名开头的文件。以指定-U test为例，生成的文件名为:“test.key.cipher、test.key.rand”。 - “datasource.key.cipher”，“datasource.key.rand” 使用gs_guc encrypt命令加密用户密码时，如果指定的-M的值为source，则会生成这两个文件。其中“datasource.key.cipher”存储用户密码的密文，“datasource.key.rand”存储的是加密因子。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - “datasource.key.cipher”和“datasource.key.rand”是创建Data Source对象时调用的密钥文件。gs_guc生成时即有读权限。使用前需将这两个文件放入各节点目录$GAUSSHOME/bin，且确保具有读权限。gs_ssh工具可以协助您快速将文件放入集群各节点对应目录下。 > @@ -77,7 +77,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc {set | reload} -Z NODE-TYPE [-N NODE-NAME] {-I INSTANCE-NAME | -D DATADIR} -h "HOSTTYPE DATABASE USERNAME HOSTNAME AUTHMEHOD authentication-options" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - AUTHMEHOD后的authentication-options为可选参数，AUTHMEHOD支持以下选项： > @@ -118,7 +118,7 @@ gs_guc工具由操作系统用户omm执行。 gs_guc encrypt [-M keymode] -K password [-U username] -D DATADIR ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -K是用户指定的密码，gs_guc会对该密码进行长度（8<=len<=16）和密码复杂度要求，如果不满足，将会报错。此密码用于保证生成密码文件的安全性和唯一性，用户无需保存或记忆。 > @@ -130,14 +130,14 @@ gs_guc工具由操作系统用户omm执行。 gs_guc generate [-o prefix] [-S cipherkey] -D DATADIR ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - -o是输出cipher和rand文件前缀名称，默认输出文件名前缀为obsserver。其内容仅支持数字、字母和下划线。 > > - -S是用户指定的密码，密码需要满足长度要求（8<=len<=16）和复杂度要求，如不满足将会报错。当其值为default时，会随机生成一段字符串作为密码，该密码长度为13。如果不带-S参数则会提示交互式输入密码。为了系统安全，推荐使用交互式输入密码方式。 > - 使用gs_guc encrypt或generate命令生成加密密码和加密因子文件时只是参数不同，本质上是一样的。生成过程中会使用随机数作为加密密钥材料和盐值，因此是每次生成的文件都是不同的。每次生成的加密密码和加密因子文件需要成对使用，不能更换或交替使用，加密和解密时需要使用相同的加密密码和加密因子文件。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_guc工具不支持参数值中包含'#'的设置。可以使用vi工具通过手工修改配置文件来设置。 > @@ -176,7 +176,7 @@ gs_guc工具由操作系统用户omm执行。 当参数取值为ALL时，表示设置MogDB中所有的主机。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 - -I INSTANCE-NAME @@ -186,13 +186,13 @@ gs_guc工具由操作系统用户omm执行。 当参数取值为ALL时，表示设置主机中所有的实例。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 需依赖静态文件，仅在om安装的情况下有效，编译安装由于没有静态文件，所以无效。 - -D 需要执行命令的MogDB实例路径。使用encrypt命令时，此参数表示指定的密码文件生成的路径。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 与“-I” 不能一块使用 @@ -200,7 +200,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的MogDB配置参数的名称和参数值。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果参数是一个字符串变量，则使用-c parameter=“'value'“或者使用-c “parameter = 'value'“。 > @@ -216,7 +216,7 @@ gs_guc工具由操作系统用户omm执行。 要设定的逻辑数据库名称。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该参数必需同-Z datanode一起使用。即gs_guc只允许作用于逻辑数据库的DN实例。 > @@ -228,7 +228,7 @@ gs_guc工具由操作系统用户omm执行。 需要忽略的主机名称。 - >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + >![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 该参数必须与set/reload一起使用，且-Z只支持datanode。 > - 该参数不支持与-D一起使用。 @@ -269,7 +269,7 @@ authmehod-options是可选输入，取值： 详细的参数说明请参见“pg_hba.conf”配置文件中的描述。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 指定-h的情况下，默认会尝试修改所有节点的pg_hba文件，但是如果是编译安装，由于没有静态文件，可以成功修改本节点的pg_hba文件，但是会提示静态文件不存在。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 指定-h的情况下，默认会尝试修改所有节点的pg_hba文件，但是如果是编译安装，由于没有静态文件，可以成功修改本节点的pg_hba文件，但是会提示静态文件不存在。 - -?, --help @@ -283,7 +283,7 @@ authmehod-options是可选输入，取值： 设定该密码在数据库运行过程中，用于服务端(server)、客户端(client)还是创建Data Source对象时调用。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 在使用ssl功能时，会涉及到服务端证书和私钥文件的加密密码和客户端证书和私钥文件的加密密码，在加密存储加密密码时，需要指定模式，否则默认是生成服务端的密码文件。 取值范围: @@ -301,7 +301,7 @@ authmehod-options是可选输入，取值： 指定要加密的用户，隶属于OS用户。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: MogDB可以为每个用户配置不同的ssl证书和私钥文件，指定该选项，可以生成按用户名区分的密码文件。 - -S CIPHERKEY @@ -321,7 +321,7 @@ authmehod-options是可选输入，取值： 取值范围: datanode。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。MogDB只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 数据库实例节点类型有coordinator、datanode、cmserver、cmagent和gtm。MogDB只能取值为datanode，当NODE-TYPE为datanode时，对应数据库的数据目录中的配置文件postgresql.conf。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md index 48551f9d..762fbfaa 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/7.1-gs_encrypt.md @@ -17,7 +17,7 @@ MogDB提供了gs_encrypt工具为输入的明文字符串进行加密操作。 gs_encrypt [OPTION]... PLAINTEXT ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - “PLAINTEXT”前不需要加短选项或长选项。 > @@ -53,7 +53,7 @@ gs_encrypt [OPTION]... PLAINTEXT 加密时使用的随机数，以base64编码。base64编码前的字符串长度必须为16。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 出于安全考虑，建议用户在使用gs_encrypt工具前设置HISTCONTROL=ignorespace，强制不记录敏感历史命令，然后在执行gs_encrypt命令行前面加空格。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 出于安全考虑，建议用户在使用gs_encrypt工具前设置HISTCONTROL=ignorespace，强制不记录敏感历史命令，然后在执行gs_encrypt命令行前面加空格。 ## 示例 @@ -88,9 +88,9 @@ G0R7Y2oROfuiEjWtUBx9+eHP3I21A1wMOJ2onVQIiAsxMjM0NTY3ODkwMTIzNDU2 ```bash gs_encrypt -f test test_encrypt ``` - + 命令回显： - + ``` tSWpR8aFyF4GHVIVO7QNXhEMNlTcqRMrk172nAf2hLgSQwhcFWyP7X0QVS0SONon ``` @@ -128,9 +128,9 @@ G0R7Y2oROfuiEjWtUBx9+eHP3I21A1wMOJ2onVQIiAsxMjM0NTY3ODkwMTIzNDU2 ```bash gs_encrypt -B R2F1c3NAMTIz -D MTIzNDU2Nzg5MGFiY2RlZg== test_encrypt ``` - + 命令回显： - + ``` V7mpnsfIHTjVTYGw1YHI0c6aY0N4J5L7BtU4CqDoeIkxMjM0NTY3ODkwYWJjZGVm ``` diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/8-gs_om.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/8-gs_om.md index e4df43eb..50bff8c0 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/8-gs_om.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/8-gs_om.md @@ -151,7 +151,7 @@ gs_om参数可以分为如下几类： - on以安全模式启动。 - off不以安全模式启动，默认不开启安全模式。 - + - --cluster-number 指定启动时内核运行版本号。 @@ -215,13 +215,13 @@ gs_om参数可以分为如下几类： 显示详细信息。如果不指定，只提示该服务器是否正常。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gs_ctl query命令进行查询并汇总结果，来获取MogDB的详细信息。 - --all 显示MogDB所有节点信息。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数通过在每个数据库节点执行gsql查询系统表并汇总结果，来获取MogDB所有节点的信息。为保证显示信息的正确性，在使用本参数前请确认gsql可以查询。 - 生成配置文件参数： diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/9-gs_restore.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/9-gs_restore.md index 2467de63..4fe40f2e 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/9-gs_restore.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/server-tools/9-gs_restore.md @@ -29,7 +29,7 @@ gs_restore工具由操作系统用户omm执行。 gs_restore [OPTION]... FILE ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: - FILE没有短选项或长选项。用来指定归档文件所处的位置。 - 作为前提条件，需输入dbname或-l选项。不允许用户同时输入dbname和-l选项。 @@ -50,7 +50,7 @@ gs_restore [OPTION]... FILE 默认是标准输出。 - ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -f不能同-d一起使用。 @@ -194,7 +194,7 @@ gs_restore -h host_name -p port_number -d postgres -n test1 -t test1 -n test2 -t gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 -t table1 backup/MPPDB_backup.tar ``` -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: -t参数不支持schema_name.table_name的输入格式。 @@ -247,12 +247,12 @@ gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 该选项用来进行文本格式的备份。 输出SET SESSION AUTHORIZATION命令，而非ALTER OWNER命令，用以决定对象归属。该选项使转储更加兼容标准，但通过参考转储中对象的记录，导入过程可能会有问题。使用SET SESSION AUTHORIZATION的转储要求必须是系统管理员，同时在导入前还需参考”SET SESSION AUTHORIZATION”，手工对导出文件的密码进行修改验证，只有这样才能进行正确的导入操作，相比之下，ALTER OWNER对权限要求较低。 - + - --pipeline 使用管道传输密码，禁止在终端使用。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: - 如果安装过程中有任何本地数据要添加到template1数据库，请谨慎将gs_restore的输出载入到一个真正的空数据库中；否则可能会因为被添加对象的定义被复制，而出现错误。要创建一个无本地添加的空数据库，需从template0而非template1复制，例如： @@ -262,7 +262,7 @@ gs_restore -h host_name -p port_number -d postgres -n PUBLIC -t table1 -n test1 - gs_restore不能选择性地导入大对象；例如只能导入那些指定表的对象。如果某个归档形式包含大对象，那所有大对象都会被导入，或一个都不会被导入，如果它们通过-L、-t或其他选项被排除。 -![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1. -d/--dbname 和 -f/--file 不能同时使用； 2. -s/--schema-only 和 -a/--data-only不能同时使用； diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md index 5cd3a891..a15ff3a1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/1-gaussdb.md @@ -21,7 +21,7 @@ gaussdb [OPTION]... 客户端应用程序为了访问数据库，将连接（通过网络或本地）到一个正在运行的gaussdb进程。然后该进程实例会启动一个独立的线程来处理这个连接。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 通过gaussdb启动数据库时，需要再开一个窗口来连接到数据库，也可以使用&符号使程序在后台执行。 一个gaussdb进程总是管理来自同一个数据库的数据。一个系统上可以同时运行多个gaussdb进程，只要使用不同的数据目录和不同的端口号。gaussdb启动时需要知道数据目录的位置，该位置必须通过-D指定。通常，-D直接指向由gs_initdb创建的数据库目录。 @@ -131,7 +131,7 @@ ps -ef | grep gaussdb 无法绑定端口的错误信息可能表明该端口已经被其他非MogDB进程使用。如果终止gaussdb后又马上用同一端口号运行它，也可能得到错误信息。这时，必须多等几秒，等操作系统关闭了该端口再试。最后，如果使用了一个操作系统认为是保留的端口，也可能导致这个错误信息。例如：Unix版本认为低于1024的端口号是“可信任的”，因而只有Unix系统管理员可以使用它们。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 如果有可能，不要使用SIGKILL杀死主进程。这样会阻止gaussdb在退出前释放它持有的系统资源（例如共享内存和信号灯）。这样可能会影响到将来启动新的进程。 > - 可以使用SIGTERM，SIGINT，SIGQUIT信号正常结束服务器进程。第一个信号将等待所有的客户端退出后才退出。第二个将强制断开所有客户端，而第三个将不停止立刻退出，导致在重启时的恢复运行。 @@ -149,7 +149,7 @@ gaussdb --single -D /usr/local/pgsql/data other-options my_database 用-D给服务器提供正确的数据库目录的路径。同时还要声名已存在的特定数据库名称。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 通常，独立运行的服务器把换行符当做命令输入完成字符；要想把一行分成多行写，必需在除最后一个换行符以外的每个换行符前面敲一个反斜杠。 > - 如果使用了-j命令行选项，新行将不被当作命令结束符。此时服务器将从标准输入一直读取到EOF标志为止，然后把所有读到的内容当作一个完整的命令字符串看待，并且反斜杠与换行符也被当作普通字符来看待。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md index c3e92e03..37d1eb32 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/10-gs_tar.md @@ -11,7 +11,7 @@ date: 2021-06-07 通过gs_basebackup的压缩格式备份，主数据目录将被写入到一个名为 base.tar 的文件中，并且其他表空间将被以其 OID 命名。生成的数据文件，需要通过gs_tar命令作解压。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_tar命令当前仅支持解压通过gs_basebackup生成的归档文件。 > - 如果gs_basebackup制定了压缩等级，会生成以gz结尾的文件。此时需要使用gzip命令先解压缩生成tar包，之后才可以使用gs_tar命令解压生成的tar文件。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md index 959d28da..0235ac78 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/11-gs_uninstall.md @@ -49,7 +49,7 @@ MogDB提供了gs_uninstall工具来帮助完成MogDB的卸载。 - 当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为“gaussdbLogPath/用户名/om/gs_uninstall-YYYY-MM-DD_hhmmss.log”。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_uninstall时，系统会自动删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_uninstall时，系统会自动删除MogDB相关目录。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, --help diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md index f8b6ba18..652ba39d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/12-gs_upgradectl.md @@ -82,7 +82,7 @@ date: 2021-06-07 gs_upgradectl -t commit-upgrade -X XMLFILE [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 一旦提交操作完成，则不能再执行回滚操作。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md index e26ed0af..b1dc3d9a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/13-gs_expansion.md @@ -101,7 +101,7 @@ MogDB提供了gs_expansion工具对数据库的备机进行扩容。支持从单 默认值：300s。 单位：s。 - + - -?, --help 显示帮助信息。 @@ -176,7 +176,7 @@ Expansion results: Expansion Finish. ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: > > - 对数据库集群进行扩容前，需要关注主机及新扩容节点cpu、io、网络等情况，不建议在硬件压力较大时执行扩容，否则可能导致扩容耗时较长甚至扩容失败。 > - 当原集群数据量较大时，在进行扩容操作前应当在主机上先执行checkpoint，否则可能导致扩容耗时较长甚至扩容失败。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md index e7887206..9e28a56b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/15-gs_probackup.md @@ -329,7 +329,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 恢复目标相关参数(recovery_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： 1. 将物理备份的文件替换目标数据库目录。 2. 删除数据库目录下pg_xlog/中的所有文件。 3. 将归档的WAL日志文件复制到pg_xlog文件中（此步骤可以省略，通过配置recovery.conf恢复命令文件中的restore_command项替代）。 4. 在数据库目录下创建恢复命令文件recovery.conf，指定数据库恢复的程度。 5. 启动数据库。 6. 连接数据库，查看是否恢复到希望预期的状态。若已经恢复到预期状态，通过pg_xlog_replay_resume()指令使主节点对外提供服务。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 当前不支持配置连续的WAL归档的PITR，因而使用这些参数会有一定限制，具体如下描述。 如果需要使用持续归档的WAL日志进行PITR恢复，请按照下面描述的步骤： 1. 将物理备份的文件替换目标数据库目录。 2. 删除数据库目录下pg_xlog/中的所有文件。 3. 将归档的WAL日志文件复制到pg_xlog文件中（此步骤可以省略，通过配置recovery.conf恢复命令文件中的restore_command项替代）。 4. 在数据库目录下创建恢复命令文件recovery.conf，指定数据库恢复的程度。 5. 启动数据库。 6. 连接数据库，查看是否恢复到希望预期的状态。若已经恢复到预期状态，通过pg_xlog_replay_resume()指令使主节点对外提供服务。 - --recovery-target-lsn=*lsn* @@ -357,7 +357,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 留存相关参数(retention_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup和delete命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup和delete命令一起使用这些参数。 - --retention-redundancy=*retention-redundancy* @@ -395,7 +395,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 固定备份相关参数(pinning_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果要将某些备份从已建立的留存策略中排除，可以和backup和set-backup命令一起使用这些参数。 - --ttl=*interval* @@ -467,7 +467,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 连接相关参数(connection_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 - -d *dbname*, --pgdatabase=*dbname* @@ -507,7 +507,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 压缩相关参数(compression_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 可以和backup命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 可以和backup命令一起使用这些参数。 - --compress-algorithm=*compress-algorithm* @@ -534,7 +534,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 ### 远程模式相关参数(remote_options) -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。 - --remote-proto=*protocol* @@ -578,7 +578,7 @@ gs_probackup是一个用于管理MogDB数据库备份和恢复的工具。它对 例如：--ssh-options='-c cipher_spec -F configfile' - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 如果因为网络临时故障等原因导致server端无应答，gs_probackup将在等待archive-timeout（默认300秒）后退出。 > diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md index 3eda0b9d..b7f77884 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/16-gstrace.md @@ -11,7 +11,7 @@ date: 2021-06-07 gstrace是MogDB提供的用来跟踪内核代码执行路径、记录内核数据结构、分析代码性能的工具。Trace的有限点位和数据在版本中被固化，无法动态添加和删除。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-warning.gif) **警告**: > > 1. 对内核dump指定内存变量的数据用于诊断分析，不存在直接指定任意寄存器或者内存地址的行为。读取的内存地址均是在开发阶段硬编码，没有任意地读取或者修改寄存器或内存的操作。 > 2. Trace点可能涉及敏感数据，收集trace信息前需要同用户协商，授权和许可后方可收集。 @@ -19,7 +19,7 @@ gstrace是MogDB提供的用来跟踪内核代码执行路径、记录内核数 > 4. Trace仅用于诊断目的，开启trace将对性能产生一定影响，影响的大小视负载的高低，trace的模块而不同。 > 5. Trace工具的权限为0700，仅限于数据库用户读、写和执行。 > -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 如果进程异常终止，/dev/shm/ 目录下将会有gstrace_trace_cfg_*残留，可以手动清除。 ## 语法 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md index 5dd566d6..20bca04d 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/3-gs_basebackup.md @@ -11,7 +11,7 @@ date: 2021-06-07 MogDB部署成功后，在数据库运行的过程中，会遇到各种问题及异常状态。MogDB提供了gs_basebackup工具做基础的物理备份。gs_basebackup的实现目标是对服务器数据库文件的二进制进行拷贝，其实现原理使用了复制协议。远程执行gs_basebackup时，需要使用系统管理员账户。gs_basebackup当前支持热备份模式和压缩格式备份模式。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - gs_basebackup仅支持主机和备机的全量备份，不支持增量。 > - gs_basebackup当前支持热备份模式和压缩格式备份模式。 @@ -143,7 +143,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 当数据库发生故障时需要从备份文件进行恢复。因为gs_basebackup是对数据库按二进制进行备份，因此恢复时可以直接拷贝替换原有的文件，或者直接在备份的库上启动数据库。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 若当前数据库实例正在运行，直接从备份文件启动数据库可能会存在端口冲突，这时需要修改配置文件的port参数，或者在启动数据库时指定一下端口。 > - 若当前备份文件为主备数据库，可能需要修改一下主备之间的复制连接。即配置文件中的postgresql.conf中的replconninfo1，replconninfo2等。 @@ -158,7 +158,7 @@ INFO: The starting position of the xlog copy of the full build is: 0/1B800000. 5. 若数据库中存在链接文件，需要修改使其链接到正确的文件。 6. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 暂不支持备份文件增量恢复。 > - 恢复后需要检查数据库中的链接文件是否链接到正确的文件。 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md index 30934604..e817886a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/5-gs_initdb.md @@ -17,7 +17,7 @@ gs_initdb初始化数据库时，会创建数据库目录、生成系统表、 初始化数据库时会生成大量的系统表和视图，其中绝大部分都对任何数据库用户开放查看权限。 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: pg_user_status、pg_auth_history系统表权限只对初始化数据库用户和sysadmin用户开放。 **生成的数据库** diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md index 0b597780..f3e4b5a1 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/6-gs_install.md @@ -27,7 +27,7 @@ MogDB安装部署，要求用户指定配置文件，配置文件中会指定程 gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE] ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数--gsinit-parameter=“--locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数--gsinit-parameter=“--locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。 - 显示帮助信息 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md index 7a013bba..32eaf21a 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/7-gs_postuninstall.md @@ -73,7 +73,7 @@ MogDB提供了gs_postuninstall工具来帮助清理准备MogDB环境阶段所做 当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为：“/var/log/gaussdb/om/gs_local-YYYY-MMDD_hhmmss.log”。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 由于在执行gs_postuninstall后，系统会自动删除MogDB相关目录（包含$GAUSSLOG目录）。因此建议用户通过该参数指定日志文件到非MogDB相关路径。 - -?, --help diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md index 54e64cf1..c3304647 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/8-gs_preinstall.md @@ -57,7 +57,7 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串，要符合标识符的命名规范。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 配置-U参数值时，字符串中不能包含“|”、“;”、“&”、“$”、“<”、“>”、“`”、“\\”、“'”、“\”、“{”、“}”、“(”、“)”、“[”、“]”、“~”、“*”、“?”特殊字符。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 配置-U参数值时，字符串中不能包含“|”、“;”、“&”、“$”、“<”、“>”、“`”、“\\”、“'”、“\”、“{”、“}”、“(”、“)”、“[”、“]”、“~”、“*”、“?”特殊字符。 - -G @@ -90,13 +90,13 @@ MogDB提供了gs_preinstall工具来帮助完成MogDB的环境配置，以保证 取值范围: 字符串。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 本参数不能指定为MogDB默认创建的环境变量。否则，MogDB的环境变量将被覆盖。MogDB默认创建的环境变量见[表1](#mogdbmoren)。 - --sep-env-file=MPPRCFILE 保存环境变量的文件。如果指定该参数，表示将使用环境变量分离的版本。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 不能指定环境变量文件为MogDB相关目录或者和这些目录同名，不能和MogDB用户的目录相同。 - --skip-hostname-set @@ -161,7 +161,7 @@ SYSLOGD_OPTIONS="-r -m 0" KLOGD_OPTIONS="-x" ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 该配置需要在MogDB每台机器上都要修改。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 该配置需要在MogDB每台机器上都要修改。 ## 示例 diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md index 46395ff7..73f4fd9b 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/tools-used-in-the-internal-system/9-gs_sshexkey.md @@ -80,7 +80,7 @@ MogDB在安装过程中，需要在MogDB中的节点间执行命令，传送文 主机列表，列出所有需要建立互信主机的IP。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 确保hostfile文件中只配置主机IP（每行只写一个IP)，不包含其它信息。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 确保hostfile文件中只配置主机IP（每行只写一个IP)，不包含其它信息。 - -l diff --git a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/unified-database-management-tool.md b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/unified-database-management-tool.md index 3e514f05..baa12083 100644 --- a/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/unified-database-management-tool.md +++ b/product/zh/docs-mogdb/v3.0/reference-guide/tool-reference/unified-database-management-tool.md @@ -498,637 +498,637 @@ cm_agent相关参数可通过cm_agent数据目录下的cm_agent.conf文件查看 #### log_dir -**参数说明**：log_dir决定存放cm_agent日志文件的目录。 可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k log_dir=“'/log/dir'“。 +**参数说明**: log_dir决定存放cm_agent日志文件的目录。 可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k log_dir=“'/log/dir'“。 -**取值范围**：字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：“log”，表示在$GAUSSLOG下对应的cm目录下生成cm_agent日志。 +**默认值**: “log”，表示在$GAUSSLOG下对应的cm目录下生成cm_agent日志。 #### log_file_size -**参数说明**：控制日志文件的大小。当'cm_agent-xx-current.log'日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 +**参数说明**: 控制日志文件的大小。当'cm_agent-xx-current.log'日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 -**取值范围**：整型，[0, 2047]，实际生效范围[1, 2047]，单位：MB。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2047]，实际生效范围[1, 2047]，单位：MB。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：16MB。 +**默认值**: 16MB。 #### log_min_messages -**参数说明**：控制写到cm_agent日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 +**参数说明**: 控制写到cm_agent日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 -**取值范围**：枚举类型，有效值有debug5、debug1、warning、error、log、fatal（不区分大小写）。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 枚举类型，有效值有debug5、debug1、warning、error、log、fatal（不区分大小写）。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：warning +**默认值**: warning #### incremental_build -**参数说明**：控制重建备节点模式是否为增量。打开这个开关，则增量重建备节点；否则，全量重建备节点。 +**参数说明**: 控制重建备节点模式是否为增量。打开这个开关，则增量重建备节点；否则，全量重建备节点。 -**取值范围**：布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示增量重建备节点。 - off、no、false、0：表示全量重建备节点。 -**默认值**：on +**默认值**: on #### security_mode -**参数说明**：控制是否以安全模式启动节点。打开这个开关，则以安全模式启动节点；否则，以非安全模式启动节点。 +**参数说明**: 控制是否以安全模式启动节点。打开这个开关，则以安全模式启动节点；否则，以非安全模式启动节点。 -**取值范围**：布尔型。修改后可以动态生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后可以动态生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示以安全模式启动节点。 - off、no、false、0：表示以非安全模式启动节点。 -**默认值**：off +**默认值**: off #### upgrade_from -**参数说明**：就地升级过程中使用，用于标示升级前数据库的内部版本号，此参数禁止手动修改。 +**参数说明**: 就地升级过程中使用，用于标示升级前数据库的内部版本号，此参数禁止手动修改。 -**取值范围**：非负整型，[0, 4294967295]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，[0, 4294967295]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：0 +**默认值**: 0 #### alarm_component -**参数说明**：在使用第一种告警方式时，设置用于处理告警内容的告警组件的位置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k alarm_component=“'/alarm/dir'“。 +**参数说明**: 在使用第一种告警方式时，设置用于处理告警内容的告警组件的位置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k alarm_component=“'/alarm/dir'“。 -**取值范围**：字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：/opt/snas/bin/snas_cm_cmd +**默认值**: /opt/snas/bin/snas_cm_cmd #### alarm_report_interval -**参数说明**：指定告警上报的时间间隔。 +**参数说明**: 指定告警上报的时间间隔。 -**取值范围**：非负整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### agent_heartbeat_timeout -**参数说明**：cm_server心跳超时时间。 +**参数说明**: cm_server心跳超时时间。 -**取值范围**：整型，[2, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[2, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：5 +**默认值**: 5 #### agent_connect_timeout -**参数说明**：cm_agent连接cm_server超时时间。 +**参数说明**: cm_agent连接cm_server超时时间。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### agent_connect_retries -**参数说明**：cm_agent连接cm_server尝试次数。 +**参数说明**: cm_agent连接cm_server尝试次数。 -**取值范围**：整型，[0, 2147483647]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：15 +**默认值**: 15 #### agent_kill_instance_timeout -**参数说明**：当cm_agent在无法连接cm_server主节点后，发起一次杀死本节点上所有实例的操作之前，所需等待的时间间隔。 +**参数说明**: 当cm_agent在无法连接cm_server主节点后，发起一次杀死本节点上所有实例的操作之前，所需等待的时间间隔。 -**取值范围**：整型，[0, 2147483647]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：0，不发起杀死本节点上所有实例的操作。 +**默认值**: 0，不发起杀死本节点上所有实例的操作。 #### agent_report_interval -**参数说明**：cm_agent上报实例状态的时间间隔。 +**参数说明**: cm_agent上报实例状态的时间间隔。 -**取值范围**：整型，[0, 2147483647]。单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]。单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### alarm_report_max_count -**参数说明**：指定告警上报的最大次数。 +**参数说明**: 指定告警上报的最大次数。 -**取值范围**：非负整型，[1, 2592000]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，[1, 2592000]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### agent_check_interval -**参数说明**：cm_agent查询实例状态的时间间隔。 +**参数说明**: cm_agent查询实例状态的时间间隔。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：2 +**默认值**: 2 #### enable_log_compress -**参数说明**：控制压缩日志功能。 +**参数说明**: 控制压缩日志功能。 -**取值范围**：布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示允许压缩日志。 - off、no、false、0：表示不允许压缩日志。 -**默认值**：on +**默认值**: on #### process_cpu_affinity -**参数说明**：控制是否以绑核优化模式启动主节点进程。配置该参数为0，则不进行绑核优化；否则，进行绑核优化，且物理CPU片数为2n个。数据库、cm_agent重启生效。仅支持ARM。参数修改请参考[表 set cm参数](#table9)进行设置。 +**参数说明**: 控制是否以绑核优化模式启动主节点进程。配置该参数为0，则不进行绑核优化；否则，进行绑核优化，且物理CPU片数为2n个。数据库、cm_agent重启生效。仅支持ARM。参数修改请参考[表 set cm参数](#table9)进行设置。 -**取值范围**：整型，[0, 2]。 +**取值范围**: 整型，[0, 2]。 -**默认值**：0 +**默认值**: 0 #### enable_xc_maintenance_mode -**参数说明**：在数据库为只读模式下，控制是否可以修改pgxc_node系统表。 +**参数说明**: 在数据库为只读模式下，控制是否可以修改pgxc_node系统表。 -**取值范围**：布尔型。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示开启可以修改pgxc_node系统表功能。 - off、no、false、0：表示关闭可以修改pgxc_node系统表功能。 -**默认值**：on +**默认值**: on #### log_threshold_check_interval -**参数说明**：cm日志压缩和清除的时间间隔，每1800秒压缩和清理一次。 +**参数说明**: cm日志压缩和清除的时间间隔，每1800秒压缩和清理一次。 **生效范围**：\$GAUSSLOG/cm/cm_ctl；\$GAUSSLOG/cm/cm_server；\$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1800 +**默认值**: 1800 #### log_max_size -**参数说明**：控制cm日志最大存储值，当CM日志总大小超过（log_max_size*95/100）MB时，根据压缩日志生成时间，依次删除历史压缩日志，直到日志总大小小于（log_max_size*95/100）MB。 +**参数说明**: 控制cm日志最大存储值，当CM日志总大小超过（log_max_size*95/100）MB时，根据压缩日志生成时间，依次删除历史压缩日志，直到日志总大小小于（log_max_size*95/100）MB。 **生效范围**：\$GAUSSLOG/cm/cm_ctl；\$GAUSSLOG/cm/cm_server；\$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。 -**取值范围**：整型，[0, 2147483647]，单位：MB。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：MB。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10240 +**默认值**: 10240 #### log_max_count -**参数说明**：cm可存储的最多日志数量，当cm日志总个数超过该值，根据压缩日志文件名时间，删除超过保留天数log_saved_days的压缩日志。 +**参数说明**: cm可存储的最多日志数量，当cm日志总个数超过该值，根据压缩日志文件名时间，删除超过保留天数log_saved_days的压缩日志。 **生效范围**：\$GAUSSLOG/cm/cm_ctl；\$GAUSSLOG/cm/cm_server；\$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。 -**取值范围**：整型，[0, 10000]，单位：个。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 10000]，单位：个。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10000 +**默认值**: 10000 #### log_saved_days -**参数说明**：cm压缩日志保存的天数，cm压缩日志超过该值并且cm日志总个数超过log_max_count，删除压缩日志。 +**参数说明**: cm压缩日志保存的天数，cm压缩日志超过该值并且cm日志总个数超过log_max_count，删除压缩日志。 **生效范围**：\$GAUSSLOG/cm/cm_ctl；\$GAUSSLOG/cm/cm_server；\$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。 -**取值范围**：整型，[0, 1000]，单位天。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 1000]，单位天。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：90 +**默认值**: 90 #### agent_phony_dead_check_interval -**参数说明**：cm_agent检测进程是否僵死的时间间隔。 +**参数说明**: cm_agent检测进程是否僵死的时间间隔。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10 +**默认值**: 10 #### unix_socket_directory -**参数说明**：unix套接字的目录位置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k unix_socket_directory=“'/unix/dir'“。 +**参数说明**: unix套接字的目录位置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --agent -k unix_socket_directory=“'/unix/dir'“。 -**取值范围**：字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，最大长度为1024。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 **默认值：”** #### dilatation_shard_count_for_disk_capacity_alarm -**参数说明**：扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。 +**参数说明**: 扩容场景下，设置新增的扩容分片数，用于上报磁盘容量告警时的阈值计算。 -**取值范围**：整型，[0, 2147483647]，单位：个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：个。该参数设置为0，表示关闭磁盘扩容告警上报；该参数设置为大于0，表示开启磁盘扩容告警上报，且告警上报的阈值根据此参数设置的分片数量进行计算。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### enable_dcf -**参数说明**：DCF模式开关。 +**参数说明**: DCF模式开关。 -**取值范围**：布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示启用dcf。 - off、no、false、0：表示不启用dcf。 -**默认值**：off +**默认值**: off #### disaster_recovery_type -**参数说明**：主备数据库灾备关系的类型。 +**参数说明**: 主备数据库灾备关系的类型。 -**取值范围**：整型，[0, 2]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - 0表示未搭建灾备关系。 - 1表示搭建了obs灾备关系。 - 2表示搭建了流式灾备关系 -**默认值**：0 +**默认值**: 0 #### agent_backup_open -**参数说明**：灾备模式设置，开启后CM按照灾备模式运行。 +**参数说明**: 灾备模式设置，开启后CM按照灾备模式运行。 -**取值范围**：整型，[0, 2]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2]。修改后需要重启cm_agent才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - 0表示未搭建灾备关系。 - 1表示搭建了obs灾备关系（之后不再支持）。 - 2表示搭建了流式灾备关系。 -**默认值**：0 +**默认值**: 0 ### cm_server参数 #### log_dir -**参数说明**：log_dir决定存放cm_server日志文件的目录。 它可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k log_dir=“'/log/dir'“。 +**参数说明**: log_dir决定存放cm_server日志文件的目录。 它可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k log_dir=“'/log/dir'“。 -**取值范围**：字符串，最大长度为1024。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，最大长度为1024。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：“log”，表示在$GAUSSLOG下对应的cm目录下生成cm_server日志。 +**默认值**: “log”，表示在$GAUSSLOG下对应的cm目录下生成cm_server日志。 #### log_file_size -**参数说明**：控制日志文件的大小。当'cm_server-xx-current.log'日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 +**参数说明**: 控制日志文件的大小。当'cm_server-xx-current.log'日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。 -**取值范围**：整型，[0, 2047]，实际生效范围[1, 2047]，单位：MB。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2047]，实际生效范围[1, 2047]，单位：MB。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：16MB +**默认值**: 16MB #### log_min_messages -**参数说明**：控制写到cm_server日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 +**参数说明**: 控制写到cm_server日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。 -**取值范围**：枚举类型，有效值有debug5、debug1、log、warning、error、fatal（不区分大小写）。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 枚举类型，有效值有debug5、debug1、log、warning、error、fatal（不区分大小写）。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：warning +**默认值**: warning #### thread_count -**参数说明**：cm_server线程池的线程数。 +**参数说明**: cm_server线程池的线程数。 -**取值范围**：整型，[2, 1000]。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[2, 1000]。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1000 +**默认值**: 1000 #### instance_heartbeat_timeout -**参数说明**：实例心跳超时时间。 +**参数说明**: 实例心跳超时时间。 -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：6 +**默认值**: 6 #### instance_failover_delay_timeout -**参数说明**：cm_server检测到主机宕机，failover备机的延迟时间。 +**参数说明**: cm_server检测到主机宕机，failover备机的延迟时间。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：0 +**默认值**: 0 #### cmserver_ha_connect_timeout -**参数说明**：cm_server主备连接超时时间。 +**参数说明**: cm_server主备连接超时时间。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：2 +**默认值**: 2 #### cmserver_ha_heartbeat_timeout -**参数说明**：cm_server主备心跳超时时间。 +**参数说明**: cm_server主备心跳超时时间。 -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：6 +**默认值**: 6 #### cmserver_ha_status_interval -**参数说明**：cm_server主备同步状态信息间隔时间。 +**参数说明**: cm_server主备同步状态信息间隔时间。 -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### cmserver_self_vote_timeout -**参数说明**：cm_server之间相互投票的超时时间。旧版本遗留参数，实际不生效。 +**参数说明**: cm_server之间相互投票的超时时间。旧版本遗留参数，实际不生效。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 **默认值：6** #### phony_dead_effective_time -**参数说明**：用于数据库节点僵死检测，当检测到的僵死次数大于该参数值，认为进程僵死，将进程重启。 +**参数说明**: 用于数据库节点僵死检测，当检测到的僵死次数大于该参数值，认为进程僵死，将进程重启。 -**取值范围**：整型，[1, 2147483647]，单位：次数。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：次数。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：5 +**默认值**: 5 #### cm_server_arbitrate_delay_base_time_out -**参数说明**：cm_server仲裁延迟基础时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。 +**参数说明**: cm_server仲裁延迟基础时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10 +**默认值**: 10 #### cm_server_arbitrate_delay_incrememtal_time_out -**参数说明**：cm_server仲裁延迟增量时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。 +**参数说明**: cm_server仲裁延迟增量时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：3 +**默认值**: 3 #### alarm_component -**参数说明**：在使用第一种告警方式时，设置用于处理告警内容的告警组件的位置。参数修改请参考[表 set cm参数](#table9)进行设置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k alarm_component=“'/alarm/dir'“。 +**参数说明**: 在使用第一种告警方式时，设置用于处理告警内容的告警组件的位置。参数修改请参考[表 set cm参数](#table9)进行设置。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k alarm_component=“'/alarm/dir'“。 -**取值范围**：字符串，最大长度为1024。修改后需要重启cm_server才能生效。 +**取值范围**: 字符串，最大长度为1024。修改后需要重启cm_server才能生效。 -**默认值**：/opt/snas/bin/snas_cm_cmd +**默认值**: /opt/snas/bin/snas_cm_cmd #### alarm_report_interval -**参数说明**：指定告警上报的时间间隔。 +**参数说明**: 指定告警上报的时间间隔。 -**取值范围**：非负整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：3 +**默认值**: 3 #### alarm_report_max_count -**参数说明**：指定告警上报的最大次数。 +**参数说明**: 指定告警上报的最大次数。 -**取值范围**：非负整型，[1, 2592000]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，[1, 2592000]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### instance_keep_heartbeat_timeout -**参数说明**：cm_agent会定期检测实例状态并上报给cm_server，若实例状态长时间无法成功检测，累积次数超出该数值，则cm_server将下发命令给agent重启该实例。 +**参数说明**: cm_agent会定期检测实例状态并上报给cm_server，若实例状态长时间无法成功检测，累积次数超出该数值，则cm_server将下发命令给agent重启该实例。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：40 +**默认值**: 40 #### az_switchover_threshold -**参数说明**：若一个AZ内节点分片的故障率（故障的节点分片数 / 总节点分片数 * 100%）超过该数值，则会触发AZ自动切换。 +**参数说明**: 若一个AZ内节点分片的故障率（故障的节点分片数 / 总节点分片数 * 100%）超过该数值，则会触发AZ自动切换。 -**取值范围**：整型，[1, 100]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 100]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：100 +**默认值**: 100 #### az_check_and_arbitrate_interval -**参数说明**：当某个AZ状态不正常时，会触发AZ自动切换，该参数是检测AZ状态的时间间隔。 +**参数说明**: 当某个AZ状态不正常时，会触发AZ自动切换，该参数是检测AZ状态的时间间隔。 -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：2 +**默认值**: 2 #### az_connect_check_interval -**参数说明**：定时检测AZ间的网络连接，该参数表示连续两次检测之间的间隔时间。 +**参数说明**: 定时检测AZ间的网络连接，该参数表示连续两次检测之间的间隔时间。 -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：60 +**默认值**: 60 #### az_connect_check_delay_time -**参数说明**：每次检测AZ间的网络连接时有多次重试，该参数表示两次重试之间的延迟时间**。** +**参数说明**: 每次检测AZ间的网络连接时有多次重试，该参数表示两次重试之间的延迟时间**。** -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：150 +**默认值**: 150 #### cmserver_demote_delay_on_etcd_fault -**参数说明**：因为etcd不健康而导致cm_server从主降为备的时间间隔**。** +**参数说明**: 因为etcd不健康而导致cm_server从主降为备的时间间隔**。** -**取值范围**：整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：8 +**默认值**: 8 #### instance_phony_dead_restart_interval -**参数说明**：当数据库实例僵死时，会被cm_agent重启，相同的实例连续因僵死被杀时，其间隔时间不能小于该参数数值，否则cm_agent不会下发命令**。** +**参数说明**: 当数据库实例僵死时，会被cm_agent重启，相同的实例连续因僵死被杀时，其间隔时间不能小于该参数数值，否则cm_agent不会下发命令**。** -**取值范围**：整型，[1800, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1800, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：21600 +**默认值**: 21600 #### enable_transaction_read_only -**参数说明**：控制数据库是否为只读模式开关。 +**参数说明**: 控制数据库是否为只读模式开关。 -**取值范围**：布尔型，有效值有on，off，true，false，yes，no，1，0。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型，有效值有on，off，true，false，yes，no，1，0。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：on +**默认值**: on #### datastorage_threshold_check_interval -**参数说明**：检测磁盘占用的时间间隔。间隔时间由用户指定，表示检测一次磁盘的间隔时间。 +**参数说明**: 检测磁盘占用的时间间隔。间隔时间由用户指定，表示检测一次磁盘的间隔时间。 -**取值范围**：整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10 +**默认值**: 10 #### datastorage_threshold_value_check -**参数说明**：设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。 +**参数说明**: 设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。 -**取值范围**：整型，[1, 99]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 99]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：85 +**默认值**: 85 #### max_datastorage_threshold_check -**参数说明**：设置磁盘使用率的最大检测间隔时间。当用户手动修改只读模式参数后，会自动在指定间隔时间后开启磁盘检测操作。 +**参数说明**: 设置磁盘使用率的最大检测间隔时间。当用户手动修改只读模式参数后，会自动在指定间隔时间后开启磁盘检测操作。 -**取值范围**：整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：43200 +**默认值**: 43200 #### enable_az_auto_switchover -**参数说明**：AZ自动切换开关，若打开，则表示允许cm_server自动切换AZ。否则当发生节点故障等情况时，即使当前AZ已经不再可用，也不会自动切换到其他AZ上，除非手动执行切换命令。 +**参数说明**: AZ自动切换开关，若打开，则表示允许cm_server自动切换AZ。否则当发生节点故障等情况时，即使当前AZ已经不再可用，也不会自动切换到其他AZ上，除非手动执行切换命令。 -**取值范围**：非负整型，0或1，0：开关关闭，1：开关打开。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 非负整型，0或1，0：开关关闭，1：开关打开。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### cm_krb_server_keyfile -**参数说明**：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k cm_krb_server_keyfile=“'/krb/dir'“。 +**参数说明**: kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态。通过cm_ctl设置绝对路径时需要将路径用”把路径包含起来，例如：cm_ctl set --param --server -k cm_krb_server_keyfile=“'/krb/dir'“。 -**取值范围**：字符串类型，修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串类型，修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示。 +**默认值**: ${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示。 #### switch_rto -**参数说明**：cm_server强起逻辑等待时延。在force_promote被置为1时，当集群的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。 +**参数说明**: cm_server强起逻辑等待时延。在force_promote被置为1时，当集群的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。 -**取值范围**：整型，[60, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[60, 2147483647]，单位：秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：600 +**默认值**: 600 #### force_promote -**参数说明**：cm_server是否打开强起逻辑（指集群状态为Unknown的时候以丢失部分数据为代价保证集群基本功能可用）的开关。0代表功能关闭，1代表功能开启。 +**参数说明**: cm_server是否打开强起逻辑（指集群状态为Unknown的时候以丢失部分数据为代价保证集群基本功能可用）的开关。0代表功能关闭，1代表功能开启。 -**取值范围**：整型，[0, 1]。在cm_server上修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 1]。在cm_server上修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：0 +**默认值**: 0 #### backup_open -**参数说明**：灾备集群设置，开启后CM按照灾备集群模式运行。 +**参数说明**: 灾备集群设置，开启后CM按照灾备集群模式运行。 -**取值范围**：整型，[0, 1]。修改后需要重启cm_server才能生效。非灾备集群不能开启该参数。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 1]。修改后需要重启cm_server才能生效。非灾备集群不能开启该参数。参数修改请参考[表 set cm参数](#table9)进行设置。 - 0表示关闭。 - 1表示开启 -**默认值**：0 +**默认值**: 0 #### enable_dcf -**参数说明**：DCF模式开关。 +**参数说明**: DCF模式开关。 -**取值范围**：布尔型。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 - on、yes、true、1：表示启用dcf。 - off、no、false、0：表示不启用dcf。 -**默认值**：off +**默认值**: off #### ddb_type -**参数说明**：ETCD，DCC模式切换开关。 +**参数说明**: ETCD，DCC模式切换开关。 -**取值范围**：整型。0：ETCD；1：DCC。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型。0：ETCD；1：DCC。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > MogDB仅支持DCC模式。 #### enable_ssl -**参数说明**：ssl证书开关。 +**参数说明**: ssl证书开关。 -**取值范围**：布尔型。打开后使用ssl证书加密通信。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 布尔型。打开后使用ssl证书加密通信。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**： +**默认值**: - on、yes、true、1：表示启用ssl。 - off、no、false、0：表示不启用ssl。 -- **默认值**：off +- **默认值**: off -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知：** 出于安全性考虑，建议不要关闭该配置。关闭后cm将**不使用**加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-notice.gif) **须知**: 出于安全性考虑，建议不要关闭该配置。关闭后cm将**不使用**加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。 #### ssl_cert_expire_alert_threshold -**参数说明**：ssl证书过期告警时间。 +**参数说明**: ssl证书过期告警时间。 -**取值范围**：整型，[7, 180]，单位：天。证书过期时间少于该时间时，上报证书即将过期告警。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[7, 180]，单位：天。证书过期时间少于该时间时，上报证书即将过期告警。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：90 +**默认值**: 90 #### ssl_cert_expire_check_interval -**参数说明**：ssl证书过期检测周期。 +**参数说明**: ssl证书过期检测周期。 -**取值范围**：整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：86400 +**默认值**: 86400 #### ddb_log_level -**参数说明**：设置DDB日志级别。 +**参数说明**: 设置DDB日志级别。 关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。 开启日志：“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空串。 -**取值范围**：字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE +**默认值**: RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE #### ddb_log_backup_file_count -**参数说明**：最大保存日志文件个数。 +**参数说明**: 最大保存日志文件个数。 -**取值范围**：整型，[1, 100]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 100]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10 +**默认值**: 10 #### ddb_max_log_file_size -**参数说明**：单条日志最大字节数。 +**参数说明**: 单条日志最大字节数。 -**取值范围**：字符串，长度最大为1024，[1M, 1000M]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 字符串，长度最大为1024，[1M, 1000M]。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：10M +**默认值**: 10M #### ddb_log_suppress_enable -**参数说明**：是否开启日志抑制功能。 +**参数说明**: 是否开启日志抑制功能。 -**取值范围**：整型，0：关闭； 1：开启。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，0：关闭； 1：开启。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：1 +**默认值**: 1 #### ddb_election_timeout -**参数说明**：DCC 选举超时时间。 +**参数说明**: DCC 选举超时时间。 -**取值范围**：整型，[1, 600], 单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[1, 600], 单位：秒。修改后可以reload生效，参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：3 +**默认值**: 3 #### coordinator_heartbeat_timeout -**参数说明**：节点故障自动剔除心跳超时时间。设置后立即生效，不需要重启cm_server。该参数设置为0，则节点故障后不会自动剔除。 +**参数说明**: 节点故障自动剔除心跳超时时间。设置后立即生效，不需要重启cm_server。该参数设置为0，则节点故障后不会自动剔除。 -**取值范围**：整型，单位为秒。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，单位为秒。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：25 +**默认值**: 25 #### cluster_starting_aribt_delay -**参数说明**：cm_server在集群启动阶段，等待节点静态主升主的时间。 +**参数说明**: cm_server在集群启动阶段，等待节点静态主升主的时间。 -**取值范围**：整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，单位为秒。修改后需要重启cm_server才能生效。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：180 +**默认值**: 180 #### enable_e2e_rto -**参数说明**：端到端RTO开关，开启后僵死检测周期及网络检测超时时间将缩短，CM可以达到端到端RTO指标（单实例故障RTO<=10s，叠加故障RTO<=30s）。 +**参数说明**: 端到端RTO开关，开启后僵死检测周期及网络检测超时时间将缩短，CM可以达到端到端RTO指标（单实例故障RTO<=10s，叠加故障RTO<=30s）。 -**取值范围**：整型，[0, 1]。1表示开启，0表示关闭。参数修改请参考[表 set cm参数](#table9)进行设置。 +**取值范围**: 整型，[0, 1]。1表示开启，0表示关闭。参数修改请参考[表 set cm参数](#table9)进行设置。 -**默认值**：0 \ No newline at end of file +**默认值**: 0 diff --git a/product/zh/docs-mogdb/v3.0/security-guide/security/1-client-access-authentication.md b/product/zh/docs-mogdb/v3.0/security-guide/security/1-client-access-authentication.md index a21bee69..47f08127 100644 --- a/product/zh/docs-mogdb/v3.0/security-guide/security/1-client-access-authentication.md +++ b/product/zh/docs-mogdb/v3.0/security-guide/security/1-client-access-authentication.md @@ -230,8 +230,8 @@ MogDB在服务器部署完成后，默认已开启SSL认证模式。服务器端 | ssl_key_file | 指定服务器私钥文件，用以对公钥加密的数据进行解密。 | 请以实际的服务器私钥名称为准，其相对路径是相对于数据目录的。
**默认值** : server.key | | ssl_ca_file | CA服务器的根证书。此参数可选择配置，需要验证客户端证书的合法性时才需要配置。 | 请以实际的CA服务器根证书名称为准。
**默认值** : cacert.pem | | ssl_crl_file | 证书吊销列表，如果客户端证书在该列表中，则当前客户端证书被视为无效证书。 | 请以实际的证书吊销列表名称为准。
**默认值** : 空，表示没有吊销列表。 | -| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值:** ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | -| ssl_cert_notify_time | SSL服务器证书到期前提醒的天数。 | 请按照需求配置证书过期前提醒天数。
**默认值:** 90 | +| ssl_ciphers | SSL通讯使用的加密算法。 | 本产品支持的加密算法的详细信息请参见[表4](#表1.3.4)。
**默认值**: ALL，表示允许对端使用产品支持的所有加密算法，但不包含ADH、LOW、EXP、MD5算法。 | +| ssl_cert_notify_time | SSL服务器证书到期前提醒的天数。 | 请按照需求配置证书过期前提醒天数。
**默认值**: 90 | 在客户端配置SSL认证相关的环境变量，详细信息请参见[表6](#表1.3.3)。 @@ -242,8 +242,8 @@ MogDB在服务器部署完成后，默认已开启SSL认证模式。服务器端 | 环境变量 | 描述 | 取值范围 | | :------------ | :--------------------------- | :-------------------------- | -| PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如：
`export PGSSLCERT='/home/omm/client.crt'`
**默认值**：空 | -| PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如：
`export PGSSLKEY='/home/omm/client.key'`
**默认值**：空 | +| PGSSLCERT | 指定客户端证书文件，包含客户端的公钥。客户端证书用以表明客户端身份的合法性，公钥将发送给对端用来对数据进行加密。 | 必须包含文件的绝对路径，如：
`export PGSSLCERT='/home/omm/client.crt'`
**默认值**: 空 | +| PGSSLKEY | 指定客户端私钥文件，用以对公钥加密的数据进行解密。 | 必须包含文件的绝对路径，如：
`export PGSSLKEY='/home/omm/client.key'`
**默认值**: 空 | | PGSSLMODE | 设置是否和服务器进行SSL连接协商，以及指定SSL连接的优先级。 | **取值及含义：**
- disable：只尝试非SSL连接。
- allow：首先尝试非SSL连接，如果连接失败，再尝试SSL连接。
- prefer：首先尝试SSL连接，如果连接失败，将尝试非SSL连接。
- require：只尝试SSL连接。如果存在CA文件，则按设置成verify-ca的方式验证。
- verify-ca：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。
- verify-full：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。
**默认值：**prefer | | PGSSLROOTCERT | 指定为客户端颁发证书的根证书文件，根证书用于验证服务器证书的有效性。 | 必须包含文件的绝对路径，如：
`export PGSSLROOTCERT='/home/omm/certca.pem'`
**默认值：**空 | | PGSSLCRL | 指定证书吊销列表文件，用于验证服务器证书是否在废弃证书列表中，如果在，则服务器证书将会被视为无效证书。 | 必须包含文件的绝对路径，如：
`export PGSSLCRL='/home/omm/sslcrl-file.crl'`
**默认值：**空 | diff --git a/product/zh/docs-mogdb/v3.0/security-guide/security/2-managing-users-and-their-permissions.md b/product/zh/docs-mogdb/v3.0/security-guide/security/2-managing-users-and-their-permissions.md index baf95ebb..4fad0c06 100644 --- a/product/zh/docs-mogdb/v3.0/security-guide/security/2-managing-users-and-their-permissions.md +++ b/product/zh/docs-mogdb/v3.0/security-guide/security/2-managing-users-and-their-permissions.md @@ -808,7 +808,7 @@ DROP ROLE gs_guc reload -N all -I all -c "password_policy=1" ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > 帐户密码的复杂度要求如下： > @@ -990,7 +990,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 1234@abc、5678@def分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 1234@abc、5678@def分别代表用户user1的新密码和原始密码，这些密码要符合规则，否则会执行失败。 - 管理员可以修改自己的或者其他帐户的密码。通过修改其他帐户的密码，解决用户密码遗失所造成无法登录的问题。 @@ -1001,7 +1001,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 系统管理员之间不允许互相修改对方密码。 > @@ -1057,7 +1057,7 @@ DROP ROLE ALTER ROLE ``` - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 密码失效的用户登录数据库后，当执行简单查询或者扩展查询时，会提示用户修改密码。修改密码后可以正常执行语句。 > - 只有初始用户、系统管理员（sysadmin）或拥有创建用户（CREATEROLE）权限的用户才可以设置用户密码失效，其中系统管理员也可以设置自己或其他系统管理员密码失效。不允许设置初始用户密码失效。 diff --git a/product/zh/docs-mogdb/v3.0/security-guide/security/4-setting-encrypted-equality-query.md b/product/zh/docs-mogdb/v3.0/security-guide/security/4-setting-encrypted-equality-query.md index 0cd6aa71..08a99c08 100644 --- a/product/zh/docs-mogdb/v3.0/security-guide/security/4-setting-encrypted-equality-query.md +++ b/product/zh/docs-mogdb/v3.0/security-guide/security/4-setting-encrypted-equality-query.md @@ -161,7 +161,7 @@ public static Connection getConnect(String username, String passwd) }; ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 【建议】使用JDBC操作密态数据库时，一个数据库连接对象对应一个线程，否则，不同线程变更可能导致冲突。 > - 【建议】使用JDBC操作密态数据库时，不同connection对密态配置数据有变更，由客户端调用isvalid方法保证connection能够持有变更后的密态配置数据，此时需要保证参数refreshClientEncryption为1(默认值为1)，在单客户端操作密态数据场景下，refreshClientEncryption参数可以设置为0。 @@ -193,7 +193,7 @@ int rc = stmt.executeUpdate("CREATE CLIENT MASTER KEY ImgCMK1 WITH ( KEY_STORE = int rc = stmt.executeUpdate("CREATE CLIENT MASTER KEY ImgCMK1 WITH ( KEY_STORE = localkms, KEY_PATH = \"key_path_value\" , ALGORITHM = RSA_2048); ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 创建密钥之前需要使用gs_ktool工具提前生成密钥，才能创建CMK成功。 +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 创建密钥之前需要使用gs_ktool工具提前生成密钥，才能创建CMK成功。 ```java // 创建列加密密钥 @@ -304,7 +304,7 @@ pstmt.close(); ------------------ Avi (1 row) - + MogDB=# SELECT f_encrypt_in_plpgsql('Avi', val2=>'1234567890123456'); f_encrypt_in_plpgsql ---------------------- @@ -312,7 +312,7 @@ pstmt.close(); (1 row) ``` -> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** +> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 函数/存储过程中的“执行动态查询语句”中的查询是在执行过程中编译，因此函数/存储过程中的表名、列名不能在创建阶段未知，输入参数不能用于表名、列名或以任何方式连接。 > - 在RETURNS、IN和OUT的参数中，不支持混合使用加密和非加密类型参数。虽然参数类型都是原始数据类型，但实际类型不同。 diff --git a/product/zh/docs-mogdb/v3.0/security-guide/security/5-setting-a-ledger-database.md b/product/zh/docs-mogdb/v3.0/security-guide/security/5-setting-a-ledger-database.md index da3f8a43..029f13df 100644 --- a/product/zh/docs-mogdb/v3.0/security-guide/security/5-setting-a-ledger-database.md +++ b/product/zh/docs-mogdb/v3.0/security-guide/security/5-setting-a-ledger-database.md @@ -79,7 +79,7 @@ date: 2021-10-11 Location Nodes: ALL DATANODES Options: orientation=row, compression=no History table name: ledgernsp_usertable_hist - + MogDB=# \d+ blockchain.ledgernsp_usertable_hist; Table "blockchain.ledgernsp_usertable_hist" Column | Type | Modifiers | Storage | Stats target | Description @@ -93,12 +93,12 @@ date: 2021-10-11 Has OIDs: no Options: internal_mask=263 ``` - - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** + + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: > > - 防篡改表不支持非行存表、临时表、外表、unlog表、非行存表均无防篡改属性。 > - 防篡改表在创建时会自动增加一个名为hash的系统列，所以防篡改表单表最大列数为1599。 - + 3. 修改防篡改用户表数据。 例如，对防篡改用户表执行INSERT/UPDATE/DELETE。 @@ -113,7 +113,7 @@ date: 2021-10-11 2 | bob | 8fcd74a8a6a4b484 3 | peter | f51b4b1b12d0354b (3 rows) - + MogDB=# UPDATE ledgernsp.usertable SET name = 'bob2' WHERE id = 2; UPDATE 1 MogDB=# SELECT *, hash FROM ledgernsp.usertable ORDER BY id; @@ -123,7 +123,7 @@ date: 2021-10-11 2 | bob2 | 437761affbb7c605 3 | peter | f51b4b1b12d0354b (3 rows) - + MogDB=# DELETE FROM ledgernsp.usertable WHERE id = 3; DELETE 1 MogDB=# SELECT *, hash FROM ledgernsp.usertable ORDER BY id; @@ -163,7 +163,7 @@ date: 2021-10-11 用户历史表有4个字段，每个字段的含义见[表1](#table1)。 - > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明：** 用户历史表的表名一般为blockchain.hist形式。当防篡改用户表模式名或者表名过长导致前述方式生成的表名超出表名长度限制，则会采用blockchain.hist的方式命名。 + > ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) **说明**: 用户历史表的表名一般为blockchain.hist形式。当防篡改用户表模式名或者表名过长导致前述方式生成的表名超出表名长度限制，则会采用blockchain.hist的方式命名。 ### 操作步骤 @@ -216,7 +216,7 @@ date: 2021-10-11 ```sql MogDB=# SELECT *, hash FROM ledgernsp.usertable; - + id | name | hash ----+------+------------------ 1 | alex | 1f2e543c580cb8c5 diff --git a/scripts/test/overview.md b/scripts/test/overview.md index 6b41fe08..3ac4f32c 100644 --- a/scripts/test/overview.md +++ b/scripts/test/overview.md @@ -10,7 +10,7 @@ date `\df *` -> ![img](https://opengauss.org/zh/docs/1.1.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知：** +> ![img](https://opengauss.org/zh/docs/1.1.0/docs/Developerguide/public_sys-resources/icon-notice.gif) **须知**: > 用户应该禁止对系统表进行增删改等操作，人为对系统表的修改或破坏可能会导致系统各种异常情况甚至MogDB不可用。 Aaaaa @@ -78,7 +78,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者–for | 目录归档格式 | d | 该格式会创建一个目录，该目录包含两类文件，一类是目录文件，另一类是每个表和blob对象对应的数据文件。 | - | | | tar归档格式 | t | tar归档文件支持从导出文件中恢复所有或所选数据库对象。tar归档格式不支持压缩且对于单独表大小应小于8GB。 | - | | -![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 +![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: 可以使用gs_dump程序将文件压缩为目录归档或自定义归档导出文件，减少导出文件的大小。生成目录归档或自定义归档导出文件时，默认进行中等级别的压缩。gs_dump程序无法压缩已归档导出文件。 ## 注意事项 @@ -92,7 +92,7 @@ gs_dump可以创建四种不同的导出文件格式，通过**[**-F或者–for gs_dump [OPTION]... [DBNAME] ``` -![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 +![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: “dbname”前面不需要加短或长选项。“dbname”指定要连接的数据库。 例如： 不需要-d，直接指定“dbname”。 ```bash gs_dump -p port_number postgres -f dump1.sql @@ -187,7 +187,7 @@ gs_dump -p port_number -f dump1.sql 只转储与模式名称匹配的模式，此选项包括模式本身和所有它包含的对象。如果该选项没有指定，所有在目标数据库中的非系统模式将会被转储。写入多个-n选项来选择多个模式。此外，根据gsql的\d命令所使用的相同规则，模式参数可被理解成一个pattern，所以多个模式也可以通过在该pattern中写入通配符来选择。使用通配符时，注意给pattern打引号，防止shell扩展通配符。 - ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** + ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: - 当-n已指定时，gs_dump不会转储已选模式所附着的任何其他数据库对象。因此，无法保证某个指定模式的转储结果能够自行成功地储存到一个空数据库中。 - 当-n指定时，非模式对象不会被转储。 @@ -246,7 +246,7 @@ gs_dump -p port_number -f dump1.sql 当使用-t时，-n和-N没有任何效应，这是因为由-t选择的表的转储不受那些选项的影响。 - ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** + ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: - -t参数选项个数必须小于等于100。 - 如果-t参数选项个数大于100，建议使用参数–include-table-file来替换。 @@ -284,7 +284,7 @@ gs_dump -p port_number -f dump1.sql 指定不需要dump的表文件。 - ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** 同–include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… + ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: 同–include-table-file，其内容格式如下： schema1.table1 schema2.table2 …… - -x, –no-privileges|–no-acl @@ -396,7 +396,7 @@ gs_dump -p port_number -f dump1.sql - 至少包含大写字母（A-Z）、小写字母（a-z）、数字（0-9）、非字母数字字符（限定为~!@#$%^&*()-_=+|[]{};:,<.>/?）四类字符中的三类字符。 - > ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** + > ![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: > > - 使用gs_dump工具进行加密导出时，仅支持plain格式导出。通过-F plain导出的数据，需要通过gsql工具进行导入，且如果以加密方式导入，在通过gsql导入时，需要指定–with-key参数。 > - 不支持加密导出存储过程和函数。 @@ -431,7 +431,7 @@ gs_dump -p port_number -f dump1.sql gs_dump -p port_number postgres -f backup.sql -F plain --dont-overwrite-file ``` -![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** +![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: - -s/–schema-only和-a/–data-only不能同时使用。 - -c/–clean和-a/–data-only不能同时使用。 @@ -501,7 +501,7 @@ tar归档形式的文件大小不得超过8GB（tar文件格式的固有限制 示例中“Bigdata@123”表示数据库用户密码；“backup/MPPDB_backup.sql”表示导出的文件，其中backup表示相对于当前目录的相对目录；“37300”表示数据库服务器端口；“postgres”表示要访问的数据库名。 -![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明：** 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 +![img](https://opengauss.org/zh/docs/1.1.0/docs/Toolreference/public_sys-resources/icon-note.gif) **说明**: 导出操作时，请确保该目录存在并且当前的操作系统用户对其具有读写权限。 示例1：执行gs_dump，导出postgres数据库全量信息，导出的MPPDB_backup.sql文件格式为纯文本格式。 -- Gitee