MySQLShell的提示符可以使用提示符主题文件进行定制。该文件必须命名为prompt.json，并且必须重新启动MySQLShell才能使更改生效。通过定义环境变量，可以在所有平台上覆盖mysqlsh目录所在目录的用户配置路径。该变量的值在MicrosoftWindows或Unix上替换。在MicrosoftWindows上，在以下目录中找到提示主题文件：%programfiles%\MySQL\MySQLShell8.0\share\mysqlsh\prompt\。在示例提示主题中prompt256.json，有一个带有类disconnected%host%和的对象%isproduction%。

当您使用require()JavaScript中的函数或importPython中的函数时，为变量列出的模块搜索路径sys.path将用于搜索指定的模块。MySQLShell初始化该sys.path变量以包含

创建在JavaScript或Python模式下启动MySQLShell时执行的启动脚本。请参见第13.1节“使用启动脚本”。自定义MySQLShell提示符。设置配置选项以更改当前会话或永久更改MySQLShell的行为。此后，MySQLShell不会再次搜索启动脚本，

在MySQLShell8.0.30中已弃用。对于MySQLShell8.0.30及以上版本中的SQL日志记录，请参阅第12.4节“MySQLShellSQL日志记录”。从MySQLShell8.0.18开始，您可以将AdminAPI操作过程中执行的SQL语句包含在MySQLShell日志记录信息中。当您从AdminAPI操作激活SQL语句的日志记录时，这些语句将作为信息性消息写入MySQLShell应用程序日志文件，前提是日志记录级别设置为5或更高。如果verbose选项设置为1或以上，这些语句也会作为详细输出发送到控制台。SQL语句中包含的任何密码都会被屏蔽以进行记录和显示，并且不会被记录或显示。使用MySQLShell\option命令设置dba.logSqlMySQLShell配置选项。如果指定不带值的选项，则使用设置1。

关于实用程序util.debug.collectSlowQueryDiagnostics()在MySQL服务器上运行多次迭代的诊断报告，使您能够在处理指定查询时分析服务器的多个方面。诊断报告以zip文件形式生成到本地目录或指定路径。该实用程序生成TSV和YAML格式的文件。要求和限制以下要求适用于使用诊断收集实用程序的导出：需要MySQL5.7或更高版本。该实用程序必须以root身份运行。运行实用程序

关于实用程序要求和限制运行实用程序收集高负载诊断信息的选项关于实用程序util.debug.collectHighLoadDiagnostics()在您的MySQL服务器上运行多次迭代的诊断报告，使您能够在负载下分析服务器的多个方面。高负载诊断报告以zip文件形式生成到本地目录或指定路径。该实用程序生成TSV和YAML格式的文件。要求和限制以下要求适用于使用诊断收集实用程序的导出：需要MySQL5.7或更高版本。

调试和诊断实用程序util.debug.collectDiagnostics()使您能够收集MySQL服务器上的诊断数据。关于实用程序要求和限制运行实用程序收集诊断信息的选项关于实用程序诊断报告以zip文件形式生成到本地目录或指定路径。util.debug.collectDiagnostics()使您能够从独立服务器、复制拓扑成员、InnoDB集群和MySQLHeatWave服务数据库系统收集原始诊断数据。该实用程序生成TSV和YAML格式的文件。要求和限制以下要求适用于使用诊断收集实用程序的导出：需要MySQL5.7或更高版本。该实用程序必须以root身份运行。

1.概述在MogDB中，比较常用的物理备份工具是gsbasebackup和gsprobackup，后者的功能相对更加完善一些。本文主要测试如何在有自定义表空间存在的数据库进行物理备份与恢复以及需要注意的点。2.环境准备系统：centos7数据库版本：MogDB5.0架构：单机3.gsprobackup工具介绍参考连接：https://docsopengauss.osinfra.cn/zh/docs/1.1.0/docs/Toolreference/gsprobackup.html参数说明anamezhcntopic0287276008section520716591338a4.实践测试

MySQLShell的转储加载实用程序util.loadDump()在MySQLShell8.0.21中引入，支持将使用MySQLShell的第11.5节转储的模式或表导入到MySQLHeatWave服务数据库系统（简称MySQL数据库系统）或MySQLServer实例中，“实例转储实用程序、架构转储实用程序和表转储实用程序”。转储加载实用程序提供来自远程存储的数据流、表或表块的并行加载、进度状态跟踪、恢复和重置功能以及转储仍在进行时并发加载的选项。为了获得最佳功能，请始终使用MySQLShell转储和转储加载实用程序的最新版本。关于实用程序

MySQLShell的实例转储实用程序util.dumpInstance()和架构转储实用程序util.dumpSchemas()是在MySQLShell8.0.21中引入的，支持将所有架构或选定架构从本地MySQL实例导出到Oracle云基础设施对象存储存储桶或一组本地文件中。MySQLShell8.0.22中引入的表转储实用程序util.dumpTables()支持从模式中选择表或视图的相同操作。然后，可以使用该实用程序将导出的项目导入MySQLHeatWave服务数据库系统（简称MySQL数据库系统）或MySQL服务器实例util.loadDump()（请参阅第11.6节“转储加载实用程序”）。为了获得最佳功能，请始终使用MySQLShell转储和转储加载实用程序的最新版本。

MySQLShell的并行表导入实用程序util.importTable()可以将大型数据文件的数据快速导入到MySQL关系表。该实用程序分析输入数据文件，将其分配为块，并使用并行连接将块上传到目标MySQL服务器。该实用程序能够比使用语句的标准单线程上传更快地完成大量数据导

MySQLShell的表导出实用程序util.exportTable()在MySQLShell8.0.22中引入，可将MySQL关系表导出到本地服务器上或OracleCloudInfrastructure对象存储存储桶中的数据文件中。然后可以使用MySQLShell的并行表导入实用程序util.importTable()将数据上传到目标MySQL服务器上的表中，该实用程序使用并行连接为大型数据文件提供快速数据导入。数据文件还可用于将数据导入到不同的应用程序，或作为单个数据表的轻量级逻辑备份。util.exportTable()可以与分区表和子分区表一起使用，但不对这些表执行任何特殊处理。选择表导出文件的目标时，请注意，要导入到MySQL数据库系统，运行并行表导入实用程序的MySQLShell实例必须安装在有权访问MySQL数据

此命令提供了不使用选项名称的简短语法，并且它接受来自标准输入的JSON文档。与mysqlsh命令界面一样，您必须在类似URI的连接字符串中或使用附加命令行选项指定目标数据库schema。输入流的结尾是文件结束指示符，在Unix系统上为CtrlD，在Windows系统上为CtrlZ。否则，将使用默认列名doc，该列名必须存在于现有表中。如果要导入包含BSON数据类型表示的文档，您还可以指定第11.2.4节“BSON数据类型表示的转换”convertBsonOid中列出的选项、、和控制选项。以下示例从标准输入读取JSON文档并将其导入到数据库territories中指定的目标mydb。如果未找到名为的集合或表territories，该实用程序将创建名为的集合territories并将文档导入其中。导入完成后，或者如果用户使用CtrlC或因错误而中途停止导入，则会向用户返回一条消息，显示成功导入的JSON文档的数量以及任何适用的错误消息。

有关此语法的信息，请参阅第5.8节“API命令行集成”。用于运行JSON导入实用程序的用户帐户的用户名。MySQL服务器的主机名。此连接的默认端口是33060。包含要导入的JSON文档的文件的文件路径。、collection和table选项tableColumn指定目标集合或目标表和列。使用mysqlsh命令界面调用JSON导入实用程序时的关系和默认值与在MySQLShell会话中使用相应选项时的关系和默认值相同。还可以指定特定BSON数据类型的附加控制选项；有关这些控制选项和默认类型转换的列表，请参阅第11.2.4节，“BSON数据类型表示的转换

您可以选择计划升级到的目标MySQLServer版本，范围从第一个MySQLServer8.0通用版本到与当前MySQLShell版本号匹配的MySQLServer版本号。升级检查实用程序执行与指定目标版本相关的自动检查，并建议您应手动进行进一步的相关检查。升级检查实用程序不支持检查MySQL5.7之前版本的MySQLServer实例。my.ini该实用程序检查配置文件中定义但已在目标MySQLServer版本中删除的任何系统变量，以及配置文件中未定义且在目标MySQL中具有不同默认值的任何系统变量服务器发布。升级检查器实用程序可以以文本格式（默认）或JSON格式生成其输出，这可能更易于解析和处理，以便在DevOps自动化中使用。升级检查器实用程序可以使用TCP或Unix套接字通过X协议连接或经典MySQL协议连接进行操作。该实用程序始终创建一个新会话来连接到服务器，因此MySQLShell全局会话不受影响。在MySQLShell8.0.20之前，用于运行升级检查器实用程序的用户帐户必须具有ALL权限。

MySQLShell包含用于使用MySQL的实用程序。要从MySQLShell中访问实用程序，请使用util全局对象，该对象在JavaScript和Python模式下可用，但在SQL模式下不可用。升级检查实用程序，使您能够验证MySQL服务器实例是否已准备好升级。一个表导出实用程序，可将MySQL关系表导出到数据文件中，然后可以使用MySQLShell的并行表导入实用程序将其上传到目标MySQL服务器上的表中，或者将数据导入到不同的应用程序中，或者作为轻量级数据文件。实例转储实用程序、架构转储实用程序和表转储实用程序，可以将所有架构、

从MySQLShell8.0.17开始，您可以使用启动时加载的用户定义插件来扩展MySQLShell。插件可以用JavaScript或Python编写，它们包含的函数可以在JavaScript和Python模式下的MySQLShell中使用。通过MySQLShell插件注册为报告或扩展对象成员的函数在MySQL完成启动后立即可用。为了在启动时自动加载MySQLShell插件，其文件夹必须位于pluginsMySQLShell用户配置路径的文件夹下。MySQLShell在此位置搜索任何初始化脚本。plugins该文件夹的默认路径/.mysqlsh/plugins在Unix和%AppData%\MySQL\mysqlsh\pluginsWindows上。该变量的值%AppData%\MySQL\mysqlsh\在Windows或/.mysqlsh/Unix上替换。当加载插件时发现错误时，会显示一条警告

MySQLShell包含内置报告来显示以下信息：任何指定SQL查询的结果（query可从MySQLShell8.0.16获得）。连接的MySQL服务器中当前线程的列表（threads可从MySQLShell8.0.18获得）。有关指定线程的详细信息（thread可从MySQLShell8.0.18获得）。与用户定义的报告一样，内置报告可以使用MySQLShell\show命令运行一次，也可以使用该命令在MySQLShell会话中运行并持续刷新\watch。除非其说明中另有说明，除了特定于报告的选项之外，内置报告还支持\show和命令的标准选项。\watch还可以使用对象作为API函数来

要使用\show和\watch命令，活动的MySQL会话必须可用。该\show命令运行指定的报告，该报告可以是内置的MySQLShell报告，也可以是已在MySQLShell中注册的用户定义的报告。例如，以下命令运行内置的reportquery，它将单个SQL语句作为参数：。报告名称不区分大小写，破折号和下划线字符被视为相同。该\watch命令具有额外的标准选项来控制刷新行为，如下所示：。intervalfloat(或)指定刷新之间等待的秒数。可以指定小数秒，最小间隔为0.1秒，间隔最大可设置为86400秒。\watchqueryinterval0.5showglobalstatuslike'Com%'.该shell.reports对象在JavaScript和Python模式下可用，并使用注册期间提供的报告名称作为函数名称。

此示例用户定义的报告sessions显示当前存在哪些会话。'details':['YouneedtheSELECTprivilegeonsys.sessionviewandtheunderlyingtablesandfunctionsusedbyit.'],'brief':'Themaximumnumberofrowstoreturn.',