华为云用户手册

术语表 下表包含缩略语、术语及其说明。 术语 描述 C 公用表表达式(CTE) 公用表表达式是一个在查询中定义的临时命名结果集，仅可用于更大的查询范围。 D 数据库(DB) 数据库是一组相关信息的集合，通常是为了使通用的检索变得简单和高效而组织起来的。 数据库属性： 数据库名称 Endian文件格式（BIG_ENDIAN大端或LITTLE_ENDIAN小端） 关系 不存在无关系的数据库。 数据库管理员(DBA) 数据库管理员是负责组织中数据库的安装、配置、升级、管理、监控和维护的人员。 该角色包括开发和设计数据库策略、监控和优化数据库性能和容量，以及规划未来的扩展需求。数据库管理员亦可计划、协调和实施安全措施，以保障资料库的安全。 E 编码 在信息处理中，编码是一种规则系统，它把字母、单词、声音、图像或手势等信息转换成另一种规则。有时，它以缩短或秘密的形式通过通道进行通讯或存储在介质中。 I 索引 数据库管理系统中的一种有序数据结构，可加速表内数据的查询和更新。 M 迁移 迁移是指将源数据库（如Teradata）中的脚本、查询、模式、数据等迁移到目标数据库（如 GaussDB (DWS)）。 元数据 元数据是关于数据的数据。元数据定义了数据的属性，用于指定数据的存储位置、历史数据、检索资源数据、记录信息等。 O 操作系统(OS) 操作系统是管理计算机中所有其他程序的程序，这些程序最初通过引导程序加载到计算机中。 Q 查询 查询是向数据库发出的信息请求。查询执行SQL语句，并返回该语句定义的结果集。 S 结构化查询语言(SQL) 一种编程语言，广泛用于访问、更新、管理和查询关系数据库中的数据。 模式 模式是数据库管理系统支持的正式语言中描述的结构。它是指数据的组织，描述数据库是如何构建的。（在关系数据库中，它描述了如何将数据库划分为表。） T Teradata Teradata是一种关系数据库管理系统。它可用于同时运行多个复杂查询。它支持使用SQL的即席查询，并广泛用于管理大型仓储操作。 表 紧密相关的列的集合。表由包含相同列的不同值的行组成。 V 视图 视图限制对表的特定行或列的访问。视图可以从一个或多个表中创建，并且由用于创建视图的查询决定。 父主题： DSC

PG_PLTEMPLATE PG_PLTEMPLATE系统表存储过程语言的“模板”信息。 表1 PG_PLTEMPLATE字段 名称 类型 描述 tmplname name 该模板所应用的语言的名称。 tmpltrusted boolean 如果语言被认为是可信的，则为真。 tmpldbacreate boolean 如果语言是由数据库所有者创建的，则为真。 tmplhandler text 调用处理器函数的名称。 tmplinline text 匿名块处理器的名称，如果没有则为NULL。 tmplvalidator text 校验函数的名称，如果没有则为NULL。 tmpllibrary text 实现语言的共享库的路径。 tmplacl aclitem[] 模板的访问权限（未使用）。 父主题： 系统表

PL/SQL包 本节主要介绍Oracle PL/SQL包（详情请参见包）和REF CURSOR（详情请参见REF CURSOR）的迁移语法。迁移语法决定了关键字/功能的迁移方式。 本节包括以下内容： 包、包变量、包拆分、REF CURSOR、VARRAY、创建包模式、授予执行权限、包名列表、数据类型，各节点的具体内容详见包~数据类型章节。 包 包变量 包拆分 REF CURSOR 创建包模式 父主题： Oracle语法迁移

声明 GaussDB(DWS)的作者们在进行文档写作时努力基于商用角度，从使用场景和任务完成角度给出内容指引。即使这样，文档中依然可能存在对Postgres内容的引用和参考。对于这类内容，遵从如下的Postgres Copyright： Postgres-XC is Copyright © 1996-2013 by the PostgreSQL Global Development Group. PostgreSQL is Copyright © 1996-2013 by the PostgreSQL Global Development Group. Postgres95 is Copyright © 1994-5 by the Regents of the University of California. IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS-IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

管理SQL终端连接 在Data Studio中，用户查看执行计划和成本、可视化计划解释以及在结果集中进行操作时，可重用SQL终端中的现有连接或新建连接。默认情况下，SQL终端会重用现有连接。当有多个查询在现有连接中排队等待执行时，请使用新连接，因为查询会按顺序执行且可能存在延迟。在处理临时表时请重用现有连接。有关编辑临时表的详情，请参阅编辑临时表。 要更改该设置，请执行以下步骤： 单击启用或禁用SQL终端中的连接重用功能。 有关重用连接和新建连接时的查询执行行为，请参阅FAQs。 用户仅能在已有连接中编辑临时表。 父主题： SQL终端管理

PG_JOB PG_JOB视图存储用户创建的定时任务的任务详细信息。 PG_JOB视图用于代替历史版本的PG_JOB系统表，提供对之前版本的前向兼容。原PG_JOB系统表已经变更为PG_JOBS系统表，关于PG_JOBS系统表的描述详见PG_JOBS。 表1 PG_JOB字段 名字 类型 描述 job_id bigint 作业ID。 current_postgres_pid bigint 如果当前任务正在被执行，那么此处记录运行此任务的postgres线程ID。默认为-1，表示此任务未被执行或已执行完毕。 log_user name 创建者的UserName。 priv_user name 作业执行者的UserName。 dbname name 标识作业执行的数据库名。 node_name name 标识当前作业是在哪个CN上创建和执行。 job_status text 当前任务的执行状态，取值范围：('r', 's', 'f', 'd','p','w','l')，默认为's'，取值含义： r=running s=successfully finished f=job failed d=disable p=pending w=waiting l=launching 说明： 当用户将定时任务关闭（即job_queue_processes为0时），由于监控job执行的线程不会启动，所以job_status不会根据job的实时状态进行设置，用户不需要关注job_status。 只有当开启定时任务功能（job_queue_processes为非0时），系统才会根据当前job的实时状态刷新job_status的值。 其中，当前任务的执行状态“p，w，l”仅8.3.0.100及以上集群版本支持。 start_date timestamp without time zone 作业第一次开始执行时间，时间精确到毫秒。 next_run_date timestamp without time zone 下次定时执行任务的时间，时间精确到毫秒。 failure_count smallint 连续失败计数。 interval text 作业执行的重复时间间隔。 last_start_date timestamp without time zone 上次运行开始时间，时间精确到毫秒。 last_end_date timestamp without time zone 上次运行的结束时间，时间精确到毫秒。 last_suc_date timestamp without time zone 上次成功运行的开始时间，时间精确到毫秒。 this_run_date timestamp without time zone 正在运行任务的开始时间，时间精确到毫秒。 nspname name 作业运行时所在的命名空间的名称。 what text 作业内容。 父主题： 系统视图

PG_INHERITS PG_INHERITS系统表记录关于表继承层次的信息。数据库里每个直接的子系表都有一条记录。间接的继承可以通过追溯记录链来判断。 表1 PG_INHERITS字段 名字 类型 引用 描述 inhrelid oid PG_CLASS.oid 子表的OID。 inhparent oid PG_CLASS.oid 父表的OID。 inhseqno integer - 如果一个子表存在多个直系父表（多重继承），这个数字表示此继承字段的排列顺序。计数从1开始。 父主题： 系统表

调试函数/过程 断点用于暂停其所在行中的PL/SQL程序的执行，可用断点控制执行并调试过程。设置并启用断点后，PL/SQL程序会在该断点所在的行停止执行，此时用户可以进行其他调试操作。 设置或添加断点 Data Studio支持为某行设置或创建断点。 打开需要添加断点的函数/过程，双击行号字段左侧的断点标尺，设置断点，断点标志启用表示操作成功。如果函数在调试过程中不会间断或停止执行，则为其设置的断点未生效。 使用“断点”窗格 在“断点”窗格中可查看和管理已有断点。可从最小化窗口窗格中单击断点按钮打开“断点”窗格。 在“断点”窗格中，勾选断点复选框，单击“启用”、“禁用”或“移除”按钮，进行断点启用、禁用或者删除操作。也可双击行号字段左侧的断点标尺设置断点；双击断点图标，将断点删除。 在“PL/SQL Viewer”窗格，双击所需断点信息行，定位该断点。 “断点”窗格会列出每一个断点所在行的行号以及调试对象的名称。 禁用断点后，程序不会在该断点处暂停执行，但该断点仍会保留（以备将来启用）。 删除的断点无法恢复。 按下“Alt+Y”可复制“断点”窗格内容。 修改源代码 调试过程中，如果用户修改了从服务器获取的源代码，并继续进行调试，Data Studio会提示错误：建议刷新该对象，再次执行调试操作。 如果用户修改了从服务器获取的源代码，且在未设置断点的情况下执行或调试了该代码，Data Studio会显示服务器中源代码的执行结果。建议在进行调试或者执行前，进行刷新操作。 使用断点调试函数/过程 在要调试的行创建断点后，单击“调试”按钮或在“对象浏览器”中右键单击函数，选择“调试”。在弹出的“调试函数/过程”对话框中，输入参数信息。 如果没有输入参数，则“调试函数/过程”对话框不会弹出。 对于varchar和date数据类型，参数值需加半角单引号（'）；对于numeric数据类型，参数值可以不加半角单引号。要将参数值设为NULL，需输入NULL或null。 调试或执行函数或过程期间，相同参数的值会在下次操作中被直接使用。首次执行时，参数值为空，可根据需要输入参数值。单击“确定”，参数值将被缓存。下次查询时，执行/调试期间会显示上次缓存的相同参数的值。某一连接被删除后，缓存的所有参数值都会被清除。 调试过程中“调用堆栈”窗格会填充信息。 “变量”窗格显示当前的变量值。将鼠标悬停在函数/过程中的变量上，也会显示当前的变量值。“变量”窗格默认显示系统变量。必要时，用户可以屏蔽系统变量。按钮默认开启，即默认启用系统变量。 设置/展示变量 说明 设置NULL值 在“变量”窗格中双击一个变量值。 弹出对话框。 设置值为空。 设置字符串值 设置字符串值如下： 要设置为abc，则输入abc。 要设置为Master's Degree，则输入Master''s Degree。 要将变量设置为文本（NULL），在“变量”窗格中设置NULL。 设置Boolean值 Boolean值t或f上加单引号。将t设成一个boolean变量，则在Variable窗格中输入't'。 显示变量值 如果变量值是NULL文本，则显示为NULL。 如果变量值是NULL，则显示为空。 如果变量值为字符串，比如abc，则显示为abc。 调试函数/过程期间，在编辑器中右键单击变量，可将变量添加至“监视器”窗格。如果变量处于被监控状态，“监视器”窗格中的值会随“变量”窗格中值的变化而变。 在Data Studio中调试PL/SQl函数期间，将光标放在变量上方，则会显示该变量的信息。 终止调试 在工具栏中单击“终止调试”按钮或在“调试”菜单中选择“终端调试”。调试完成后，函数会继续正常执行，不会在任何断点暂停。 调试完成后，“结果”页签中显示函数执行结果，“调用堆栈”和“变量”窗格将被清除。 Data Studio支持在调试完成后，提交/回滚查询结果。右键单击执行函数的终端窗格，勾选“使用回滚进行调试”启用回滚功能。 如果启用了“使用回滚进行调试”选项，则调试后获取的函数执行结果不会保存在数据库中。 如果禁用了“使用回滚进行调试”选项，则调试后获取的函数执行结果被提交到数据库中。

导出函数/过程DDL 可通过右键单击“导出DDL”导出该函数/过程定义。 在“对象浏览器”窗格中，右键单击所选函数/过程，选择“导出DDL”。 用户需自定义导出路径。如果需要将数据压缩，勾选“.zip”选项。 “Data Studio安全免责声明”必须勾选“我同意”才可以单击“确定”。用户可关闭安全免责声明，关闭后导出DDL时将不会再出现，详情请参见表1。 单击“确定”，右下角的状态栏会显示操作进度。 如果文件名包含Windows中文件名不支持的字符，则文件名的名称会与模式名称不同。 要执行该操作，需要MS Visual C Runtime文件（msvcrt100.dll）。详情请参阅故障处理。 “导出完成”对话框和状态栏显示已完成操作的状态。 表1 支持导出DDL的编码格式 数据库编码 文件编码 支持导出DDL UTF-8 UTF-8 是 GBK 是 LATIN1 是 GBK GBK 是 UTF-8 是 LATIN1 否 LATIN1 LATIN1 是 GBK 否 UTF-8 是

编辑函数/过程 在“对象浏览器”中双击所需过程/函数或SQL函数，或右键单击函数/过程或SQL函数并选择“查看源”。 “PL/SQL Viewer”页签显示所选函数/过程或SQL函数。 用户必须刷新“对象浏览器”才能查看最新DDL。 拥有相同模式、名称和输入参数的函数/过程或SQL函数一次只能打开一个。 编辑或更新后，可以编译并执行该PL/SQL程序或SQL函数。 在编译前若执行函数/过程或SQL函数，会显示一条“改变源代码”的提示。 单击“是”，编译并执行PL/SQL函数/过程。“消息”对话框显示已完成操作的状态。 编译函数/过程或SQL函数后，刷新“对象浏览器”（按下“F5”）查看更新后信息。

控制执行 单步调试PL/SQL函数 调试执行函数时，可使用工具栏中的单步调试命令。通过进行单步控制，可逐行调试程序。如果进行单步操作时遇到断点，则该单步操作会停止，程序也会暂停执行。 “单步”是指一次执行一条语句。单步执行一条语句后，可以在其他调试窗口中查看执行结果。 一次最多可以弹出100个“PL/SQL Viewer”页签。如果打开的页签超过100个，则调用函数页签关闭。例如，如果已打开100个页签，且调试对象调用了新调试对象，则Data Studio会关闭调用函数并打开新的调试对象。 单步进入 在“调试”菜单中选择单步进入，可以逐条语句执行代码。 当单步跳入一个函数，Data Studio执行当前语句，然后进入调试模式，调试位置由左侧标尺区域中的箭头表示。如果执行语句调用另一个函数，Data Studio将单步跳入该函数。一旦函数中的所有语句执行完成，Data Studio将跳回其调用函数的下一语句。 单步进入(F7)，进入下一语句如果按“继续”，PL/SQL代码执行将继续。 单步跳过 单步跳过与单步进入相同，除非调用了另一个函数，否则不会跳入该函数。该函数将运行，进入当前函数中的下一个语句。F8是单步跳过的快捷键。如果该调用函数内设置了断点，单步跳过将进入该函数，并命中该断点。 单步退出 子程序单步退出，继续该函数的执行，在该过程返回其调用函数后，暂停执行，确定该函数的剩余部分无需调试后，可单步退出该段函数。然而，如果该函数其余部分设置了断点，在返回调用函数前，该断点将被命中。 单步跳过和单步退出过程都会执行函数。单步退出操作的快捷键是“Shift+F7”。 继续执行 调试进程在某一位置停止时，可在“调试”菜单中选择“继续”（F9）继续PL/SQL函数执行。 查看调用堆栈 “调用堆栈”窗格展示调用过程时的过程链。可从最小化窗口窗格中打开“调用堆栈”窗格。最近的过程在顶部，最早的在底部，每个程序名的末尾是该过程的当前行号。 双击“调用堆栈”窗格中的函数名，通过“调用堆栈”窗格在多个函数中导航。

创建函数/过程 在“对象浏览器”窗格中，右键单击待创建PL/SQL过程的指定模式下的“函数/过程”，按照要求选择“创建函数”、“创建SQL函数”、“创建过程”或“创建C函数”。 例如右键单击“函数/过程”，弹出如下菜单： Data Studio在新页签中显示所选模板。 完成添加函数/过程后，可选择“编译”按钮或在页签空白处右键单击选在“编辑”选项编译该函数/过程。 编译运行成功后会在“对象浏览器”中显示新函数/过程。 过程名称旁的星号（*），表示该过程不被编译或添加到“对象浏览器”。 刷新（按下“F5”）后，“对象浏览器”中会显示新添加的调试对象。 C函数不支持调试操作。 弹出消息显示已完成操作的状态。状态栏将不显示此操作的状态。

PG_STATIO_USER_SEQUEN CES PG_STATIO_USER_SEQUENCES视图显示命名空间中所有用户关系表类型为序列的IO状态信息。 表1 PG_STATIO_USER_SEQUENCES字段 名称 类型 描述 relid oid 序列OID。 schemaname name 序列中模式名。 relname name 序列名。 blks_read bigint 从序列中读取的磁盘块数。 blks_hit bigint 序列中缓存命中数。 父主题： 系统视图

transaction_deferrable 参数说明：指定是否允许一个只读串行事务延迟执行，使其不会执行失败。该参数设置为on时，当一个只读事务发现读取的元组正在被其他事务修改，则延迟该只读事务直到其他事务修改完成。目前，GaussDB(DWS)暂时未用到这个参数。与该参数类似的还有一个default_transaction_deferrable，设置它来指定一个事务是否允许延迟。 参数类型：USERSET 取值范围：布尔型 on表示允许执行。 off表示不允许执行。 默认值：off

transaction_isolation 参数说明：设置当前事务的隔离级别。 参数类型：USERSET 取值范围： read committed：读已提交隔离级别，只能读到已经提交的数据，而不会读到未提交的数据。这是缺省值。 read uncommitted：读未提交隔离级别，GaussDB(DWS)不支持read uncommitted，如果设置了read uncommitted，实际上使用的是read committed。 repeatable read：可重复读隔离级别，仅仅能看到事务开始之前提交的数据，不能看到未提交的数据，以及在事务执行期间由其它并发事务提交的修改。 serializable：事务可序列化，GaussDB(DWS)不支持SERIALIZABLE，如果设置了serializable，实际上使用的是repeatable read。 默认值：read committed

常见问题处理 Server common name "xxxx" does not match host name "xxxxx" 此问题的原因是使用了SSL加密的“verify-full”选项，这时驱动程序会验证证书中的主机名与实际部署数据库的主机名是否一致。碰到此问题可以使用“verify-ca”选项，不再校验主机名；或者重新生成一套与数据库所在主机名相同的CA证书。 connect to server failed: no such file or directory 此问题可能的原因： 配置了错误的/不可达的数据库地址，或者端口 请检查数据源配置中的Servername及Port配置项。 服务器监听不正确 如果确认Servername及Port配置正确，请根据“操作步骤”中数据库服务器的相关配置，确保数据库监听了合适的网卡及端口。 防火墙及网闸设备 请确认防火墙设置，将数据库的通信端口添加到可信端口中。 如果有网闸设备，请确认相关的设置。 在指定的DSN中，驱动程序和应用程序之间的体系结构不匹配 此问题可能的原因：在64位程序中使用了32位驱动，或者相反。 C:\Windows\SysWOW64\odbcad32.exe：这是32位ODBC驱动管理器。 C:\Windows\System32\odbcad32.exe：这是64位ODBC驱动管理器。 The password-stored method is not supported. 此问题可能原因： 数据源中未配置sslmode配置项，请调整此项至allow或以上级别，允许SSL连接，此选项的更多说明，请见表1。 authentication method 10 not supported. 使用开源客户端碰到此问题，可能原因： 数据库中存储的口令校验只存储了SHA256格式哈希，而开源客户端只识别MD5校验，双方校验方法不匹配报错。 数据库并不存储用户口令，只存储用户口令的哈希码。 早期版本（V100R002C80SPC300之前的版本）的数据库只存储了SHA256格式的哈希，并未存储MD5的哈希，所以无法使用MD5做用户口令校验。 新版本（V100R002C80SPC300及之后版本）的数据库当用户更新用户口令或者新建用户时，会同时存储两种格式的哈希码，这时将兼容开源的认证协议。 但是当老版本升级到新版本时，由于哈希的不可逆性，所以数据库无法还原用户口令，进而生成新格式的哈希，所以仍然只保留了SHA256格式的哈希，导致仍然无法使用MD5做口令认证。 要解决该问题，参见以下操作： 将数据库参数password_encryption_type修改为1，修改方法参见修改数据库参数。 新建一个数据库用户用于连接，或者重置准备使用的数据库用户的密码。 如果您使用的是管理员账号，参见重置密码。 如果是普通用户，可以先通过其他客户端工具（例如Data Studio）连接数据库后，使用ALTER USER语句来修改密码。 再尝试连接数据库。 unsupported frontend protocol 3.51: server supports 1.0 to 3.0 目标数据库版本过低，或者目标数据库为开源数据库。请使用对应版本的数据库驱动连接目标数据库。 FATAL: GSS authentication method is not allowed because XXXX user password is not disabled. 或：GSSAPI authentication not supported. 目标CN的pg_hba.conf里配置了当前客户端IP使用“gss”方式来做认证，该认证算法不支持用作客户端的身份认证，请修改到“sha256”后再试。 同时请注意，数据库当前不支持在集群内跨节点连接数据库，如果是在集群内跨节点连接CN出现此问题，请将业务程序调整到集群外后重试。

PG_SECLABELS PG_SECLABELS视图提供关于安全标签的信息。 表1 PG_SECLABELS字段 名字 类型 引用 描述 objoid oid 任意OID属性 安全标签所属的对象的OID。 classoid oid PG_CLASS.oid 此对象的系统表的OID。 objsubid integer - 对于某个在表字段上的安全标签，为字段编号（引用表本身的objoid和classoid）。对于所有其他对象类型，该字段为0。 objtype text - 标签出现的对象的类型。 objnamespace oid PG_NAMESPACE.oid 对象的命名空间的OID，如果适用；否则为NULL。 objname text - 标签适用的对象名。 provider text PG_SECLABEL.provider 与标签相关的标签提供者。 label text PG_SECLABEL.label 应用于此对象的安全标签。 父主题： 系统视图

查看表属性 右键单击表，选择“属性”查看表属性。 Data Studio在不同页签显示所选表的属性（“一般”、“列”、“约束”和“索引”）。可在每个页签上对指定对象进行编辑，可双击单元格执行编辑操作。 查看表格数据时，Data Studio会自动调整列宽以获得表视图。用户可以根据需要调整列的大小。如果单元格的文本内容超出了可用的显示区域，则调整单元格列的大小可能会导致DS无法响应。 一个表显示一个属性窗口。 如果一个已打开的表格的属性被修改，刷新并重新打开该表格的属性查看更新后的表格属性信息。 如果列的内容包含空格，会在空格处自动断行以适应该列的显示区域。不包含空格的内容不会自动断行。 列的大小取决于内容最长的列的长度。 刷新“属性”页签后，将显示在“对象浏览器”对表属性所做的任何更改。 “Data Type”列不允许粘贴操作。

查看数据 右键单击表，选择“查看数据”查看表数据。Data Studio显示“查看数据”页签，可在该页签查看表数据信息。 “查看数据”页签的工具栏菜单： 工具栏名称 说明 复制 用于从“查看数据”页签将数据复制。快捷键为Ctrl+C。 高级复制 用于将结果窗口中的内容复制。可以复制结果以包含行号和/或列标题。请参阅表1以设置此首选项。快捷键为Ctrl+Shift+C。 显示/隐藏搜索栏 用于显示/隐藏搜索文本区域。单击该按钮可在两种状态间切换。 编码 有关如何选择编码，请参见执行SQL查询。 搜索区域中的图标： 图标名称 描述 搜索 用于根据定义的标准，搜索显示的表数据。搜索内容不区分大小写。 清空搜索内容 用于清空在搜索字段中输入的搜索内容。 有关调整列位置或对列进行排序的具体信息，请参阅执行SQL查询。 “查询提交时间”：提供查询的提交时间。 获取的行数和执行时间同时显示，且会显示默认行数。如果有其他记录待获取，此图标将显示为“更多”。用户可将光标滚至表底部读取并显示所有行。 查看表数据时，Data Studio会自动调整列宽。用户可以根据需要调整列的大小。如果单元格的文本内容超出了可用的显示区域，则调整单元格列的大小可能会导致Data Studio无法响应。 表的单元格最多可显示1000个字符，超出部分显示为“...”。 一个表显示一个表数据窗口。 如果已打开的表数据被修改了，刷新并重新打开该表数据并在同一打开的窗口查看更新后的表数据。 数据在加载过程中，表格下方会出现一条“读取中”的消息。 如果列的内容包含空格，会在空格处自动断行以适应该列的显示区域。不包含空格的内容不会自动断行。 要复制单元格中的部分内容，先选中所需部分，然后按下“Ctrl+C”。 列的大小取决于内容最长的列的长度。

编辑表数据 右键单击表，选择“编辑数据”。页面显示“编辑表数据”页签。 有关复制、搜索工具栏和字符编码下拉列表选项的说明，请参阅查看数据。 Data Studio仅识别单元格中的如下数据类型：Bigint、bit、Boolean、char、date、decimal、double、float、integer、numeric、real、smallint、tinyint和varchar。 不支持编辑数组数据类型、包含时区的时间列和包含时区的时间戳列。 数据库上报的与该操作相关的错误会显示在Data Studio中。

重建索引 使用索引可帮助用户更快地查找数据。以下场景需要重建索引： 索引已破坏，不再包含任何有效数据。虽然理论上不会发生，但事实上，索引可能由于软件或硬件故障而被破坏重建索引提供恢复方法。 索引包含很多空的或几乎为空的页面，DWS数据库的B-tree索引在特定的非常规访问模式下可能会发生这种情况，REINDEX方式可以减少索引的空间消耗，即创建一个新的索引，不再有空页面。 已修改索引的存储参数（如“填充因子”），且希望保证修改完全生效。 执行以下操作重建索引： 右键单击表，选择“重建索引”。弹出消息和状态栏显示已完成操作的状态。 分区ORC表不支持重建索引。

导出DDL和数据 通过导出表DDL和数据，可导出表的DDL和表的数据。 在“对象浏览器”窗格中，右键单击所选表，选择“导出DDL和数据”。 用户需自定义导出路径。如果需要将数据压缩，勾选“.zip”选项。 “Data Studio安全免责声明”必须勾选“我同意”才可以单击“确定”。用户可关闭安全免责声明，关闭后导出DDL时将不会再出现，详情请参见表1。 单击“确定”，右下角的状态栏会显示操作进度。 如果文件名包含Windows中文件名不支持的字符，则文件名的名称会与模式名称不同。 要执行该操作，需要MS Visual C Runtime文件（msvcrt100.dll）。详情请参阅故障处理。 “导出完成”对话框和状态栏显示已完成操作的状态。 表1 支持导出DDL的编码格式 数据库编码 文件编码 支持导出DDL UTF-8 UTF-8 是 GBK 是 LATIN1 是 GBK GBK 是 UTF-8 是 LATIN1 否 LATIN1 LATIN1 是 GBK 否 UTF-8 是 可从普通表和分区表中选择多个对象，以导出DDL和数据。导出的内容包含列、行、索引、约束和分区。

阅读指引 对于首次接触 GaussDB(DWS)的用户，建议先阅读以下部分： 介绍GaussDB(DWS)服务的特点、功能和适用场景。 GaussDB(DWS)入门包含一个示例，引导您完成创建 数据仓库 集群、创建数据库表、上传数据和测试查询这一过程。 如果打算或正在将应用程序从其他数据仓库向GaussDB(DWS)迁移，您可能想知道GaussDB(DWS)在实施方式上有什么区别。 GaussDB(DWS)进行数据库应用程序开发过程中，下表将帮您找到对应的信息。 如果要.. 查阅建议 快速开始使用GaussDB(DWS)。 首先，按照《数据仓库服务快速入门》中的步骤快速部署集群、连接到数据库并尝试进行一些查询。 准备好构建数据库后，将数据加载到表中并编写查询内容以操作数据仓库中的数据后，可以回到《数据仓库服务数据库开发指南》。 了解GaussDB(DWS)数据仓库的内部架构。 如果您想要更全面地了解GaussDB(DWS)服务，请转到GaussDB(DWS)产品首页。 了解如何设计表以实现良好性能。 开发设计建议介绍数据库应用程序开发过程中，应当遵守的设计规范。依据这些规范进行建模，能够更好的契合GaussDB(DWS)的分布式处理架构，输出更高效的业务SQL代码。 对业务的执行效率不满意，期望通过调优加快业务执行的情况下，可以参考优化查询性能进行调优。性能调优是一项复杂的工程，有些时候无法系统性地说明和解释，而是依赖于DBA的经验判断。尽管如此，优化查询性能一节还是期望能尽量系统性的对性能调优方法加以说明，方便应用开发人员和刚接触GaussDB(DWS)的DBA参考。 加载数据。 导入数据介绍数据入库GaussDB(DWS)的方法和途径。 导入最佳实践提供有关快速高效数据导入的经验提示。 管理用户、组和数据库安全。 管理数据库安全涵盖数据库安全主题。 监控和优化系统性能。 系统表和系统视图详细介绍您可以从中查询数据库状态并监控查询内容与流程的系统表和视图。 您还应该查阅管理指南了解如何使用GaussDB(DWS)管理控制台检查系统运行状况、监控指标。 父主题： 欢迎

OUTER JOIN 本节主要介绍Oracle OUTER JOIN的迁移语法。迁移语法决定了关键字/功能的迁移方式。 OUTER JOIN会返回所有满足关联条件的行。此外，如果无法为一个表中的某些行在另一个表中找到任何满足关联条件的行，则该语句会返回这些行。在Oracle中： 通过在WHERE条件中对表B的所有字段使用外连接操作符“+”，表A和B的左外连接返回表A中的所有行和所有满足关联条件的行。 通过在WHERE条件中对表A的所有字段使用外连接操作符“+”，表A和B的右外连接返回表B中的所有行和所有满足关联条件的行。 GaussDB(DWS)不支持“+”操作符。该操作符的功能通过LEFT OUTER JOIN和RIGHT OUTER JOIN关键词实现。 图1 输入：OUTER JOIN 图2 输出：OUTER JOIN 父主题： Oracle语法迁移

Netezza配置 设置Netezza配置参数可在迁移Netezza数据库脚本时自定义迁移工具的行为。 打开config文件夹中的features-netezza.properties文件，并根据实际需要设置表1中的参数。 表1 features-netezza.properties文件中的配置参数 参数 说明 取值范围 默认值 样例 rowstoreToColumnstore 是否将rowstore迁移为columnstore。 true false false rowstoreToColumnstore=false cstore_blob cstore_blob取值如下： bytea none bytea none bytea cstore_blob=bytea keywords_addressed_using_as 关键字“addressed_using_as”的取值如下： OWNER ATTRIBUTE SOURCE FREEZE OWNER ATTRIBUTE SOURCE FREEZE OWNER keywords_addressed_using_as=OWNER keywords_addressed_using_doublequote 关键字“addressed_using_doublequote”的可能取值。 FREEZE FREEZE keywords_addressed_using_doublequote=FREEZE 父主题： 配置DSC

在“SQL终端”页签中加载多条SQL查询 单击“加载至SQL终端并关闭”按钮，可在“SQL终端”页签中加载所选查询，并关闭“历史执行SQL”对话框。 执行如下步骤在“SQL终端”页签中加载多条所选SQL查询： 选择多条所需查询。 单击。 这些查询会添加到“SQL终端”页签中光标所在位置。 如果作业出错时仍继续执行，则终端中的每条语句将作为定时任务依次运行。系统会在控制台上更新执行状态，在进度条中显示作业。当作业执行、进度条更新和控制台更新之间的时间差变得非常细微，则用户无法打开进度条去停止作业执行。此时，必须关闭SQL终端才能停止执行。

锁定SQL查询 如果不希望Data Studio从“历史执行SQL”列表中自动删除某些查询，可锁定这些查询。最多可锁定50条查询。锁定的查询会显示在列表顶部。在“SQL历史记录数”中设置的值不会影响锁定的查询。有关SQL历史记录数的更多信息，请参见表1。 “历史执行SQL”窗口关闭后重新打开时，锁定的查询会出现在列表顶部。 执行如下步骤锁定SQL查询： 选择所需SQL查询，单击。 “锁定状态”列显示查询的锁定状态。

PG_JOB_SINGLE PG_JOB_SINGLE视图用于显示当前节点的作业信息。 表1 PG_JOB_SINGLE字段 名字 类型 描述 job_id bigint 作业ID。 current_postgres_pid bigint 如果当前任务正在被执行，那么此处记录运行此任务的postgres线程ID。默认为-1，表示此任务未被执行或已执行完毕。 log_user name 创建者的UserName。 priv_user name 作业执行者的UserName。 dbname name 标识作业执行的数据库名。 node_name name 标识当前作业是在哪个CN上创建和执行。 job_status text 当前任务的执行状态，取值范围：('r', 's', 'f', 'd','p','w','l')，默认为's'，取值含义： r=running s=successfully finished f=job failed d=disable p=pending w=waiting l=launching 说明： 当用户将定时任务关闭（即job_queue_processes为0时），由于监控job执行的线程不会启动，所以job_status不会根据job的实时状态进行设置，用户不需要关注job_status。 只有当开启定时任务功能（job_queue_processes为非0时），系统才会根据当前job的实时状态刷新job_status的值。 其中，当前任务的执行状态“p，w，l”仅8.3.0.100及以上集群版本支持。 start_date timestamp without time zone 作业第一次开始执行时间，时间精确到毫秒。 next_run_date timestamp without time zone 下次定时执行任务的时间，时间精确到毫秒。 failure_count smallint 连续失败计数。 interval text 作业执行的重复时间间隔。 last_start_date timestamp without time zone 上次运行开始时间，时间精确到毫秒。 last_end_date timestamp without time zone 上次运行的结束时间，时间精确到毫秒。 last_suc_date timestamp without time zone 上次成功运行的开始时间，时间精确到毫秒。 this_run_date timestamp without time zone 正在运行任务的开始时间，时间精确到毫秒。 nspname name 作业运行时所在的命名空间的名称。 what text 作业内容。 父主题： 系统视图

vacuum_cost_delay 参数说明：指定开销超过vacuum_cost_limit的值时，进程睡眠的时间。 参数类型：USERSET 取值范围：整型，0~100，单位为毫秒（ms）。正数值表示打开基于开销的清理延迟特性；0表示关闭基于开销的清理延迟特性。 默认值：0 许多系统上，睡眠的有效分辨率是10毫秒。因此把vacuum_cost_delay设置为一个不是10的整数倍的数值与将它设置为下一个10的整数倍作用相同。 此参数一般设置较小，常见的设置是10或20毫秒。调整此特性资源占用率时，最好是调整其他参数，而不是该参数。

PGXC_BULKLOAD_STATIS TICS 通过CN查看PGXC_BULKLOAD_STATISTI CS 视图，可获取GDS、COPY、\COPY等业务执行过程中的实时统计信息。该视图汇总当前集群上各个节点正在执行的导入/导出类业务的实时执行情况，从而可以监控导入导出类业务的实时进度，辅助进行性能问题排查。 PGXC_BULKLOAD_STATISTICS视图与PG_BULKLOAD_STATISTICS视图列定义完全相同。这是由于PGXC_BULKLOAD_STATISTICS视图本质是到集群中各个节点上查询PG_BULKLOAD_STATISTICS视图汇总的结果。 需要有系统管理员权限才可以访问此视图。 表1 PGXC_BULKLOAD_STATISTICS字段 名称 类型 描述 node_name text 节点名称。 db_name text 数据库名称。 query_id bigint 查询ID，对应debug_query_id。 tid bigint 当前线程的线程号。 lwtid integer 当前线程的轻量级线程号。 session_id bigint GDS的会话ID。 direction text 业务类型，取值包括：gds to file、gds from file、gds to pipe、gds from pipe、copy from、copy to。 query text 查询语句。 address text 当前导入导出外表的location。 query_start timestamp with time zone 导入/导出开始时间。 total_bytes bigint 待处理数据的总大小。 仅GDS普通文件导入时，且该行记录来自CN节点才会显示，否则为空。 phase text 当前阶段，包括：INITIALIZING、TRANSFER_DATA、RELEASE_RESOURCE。 done_lines bigint 已传输行数。 done_bytes bigint 已传输字节数。 父主题： 系统视图