HAWQ技术解析（五） —— 连接管理

本是古典何须时尚 2023-01-09 15:37 160阅读 0赞

服务器启动后，还要经过一系列配置，才能被客户端程序所连接。本篇说明如何配置客户端身份认证，HAWQ的权限管理机制，HAWQ最常用的命令行客户端工具psql及与mysql命令行常用命令类比，最后还将列举一些客户端连接HAWQ数据库的常见问题排查。

## 一、配置客户端身份认证 ##

上一篇曾经提到，HAWQ系统初始安装后，数据库包含一个预定义的超级用户。这个用户和安装HAWQ的操作系统用户用户具有相同的名字，叫做gpadmin。缺省时，系统只允许使用gpadmin用户从本地连接至数据库。为了允许任何其它用户从本地或远程主机连接数据库，需要配置HAWQ允许此类连接。

### 1. 配置允许连接至HAWQ ###

HAWQ脱胎于PostgreSQL，它的客户端访问与认证，是由标准的PostgreSQL基于主机的认证文件 — pg\_hba.conf所控制。master和每个segment的数据目录下都存在一个pg\_hba.conf文件。在HAWQ中，master实例的pg\_hba.conf文件控制客户端对HAWQ系统的访问和认证。而segment的pg\_hba.conf文件，作用只是允许每个segment作为master节点主机的客户端连接数据库，而**segment本身并不接受其它客户端的连接。正因如此，不要修改segment实例的pg\_hba.conf文件**。  
pg\_hba.conf的格式是普通文本，其中每行一条记录，表示一个认证条目，HAWQ忽略空行和任何\#注释字符后面的文本。一行记录由四个或五个以空格或tab符分隔的字段。如果字段值中包含空格，则需要用双引号引起来，并且记录不能跨行。与MySQL类似，HAWQ也接受TCP连接和本地的UNIX套接字连接。每个TCP连接客户端的访问认证记录具有以下格式：  
`host|hostssl|hostnossl <database> <role> <CIDR-address>|<IP-address>,<IP-mask> <authentication-method>`  
本地UNIX域套接字的访问记录具有下面的格式：`local <database> <role> <authentication-method>`  
表1描述了每个字段的含义

<table> 
 <thead> 
  <tr> 
   <th>字段</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>local</td> 
   <td>匹配使用UNIX域套接字的连接请求。如果没有此种类型的记录，则不允许UNIX域套接字连接。</td> 
  </tr> 
  <tr> 
   <td>host</td> 
   <td>匹配使用TCP/IP的连接请求。除非在服务器启动时使用了适当的listen_addresses服务器配置参数（缺省值为“*”，允许所有IP连接），否则不能远程TCP/IP连接。</td> 
  </tr> 
  <tr> 
   <td>hostssl</td> 
   <td>匹配使用TCP/IP的连接请求，但是仅当连接使用SSL加密时。服务器启动时必须通过设置ssl配置参数启用SSL。</td> 
  </tr> 
  <tr> 
   <td>hostnossl</td> 
   <td>匹配不使用SSL的TCP/IP的连接请求。</td> 
  </tr> 
  <tr> 
   <td>&lt;database&gt;</td> 
   <td>指定匹配此行记录的数据库名。值“all”指示匹配所有数据库。多个数据库名用逗号分隔。可以指定一个包含数据库名的文件，在文件名前加“@”。</td> 
  </tr> 
  <tr> 
   <td>&lt;role&gt;</td> 
   <td>指定匹配此行记录的数据库角色名。值“all”指示匹配所有角色。如果指定的角色是一个组并且希望包含所有的组成员，在角色名前面加一个“+”。多个角色名可以通过逗号分隔。可以指定一个包含角色名的文件，在文件名前加“@”。</td> 
  </tr> 
  <tr> 
   <td>&lt;CIDR-address&gt;</td> 
   <td>指定此行记录匹配的客户端主机的IP地址范围。它包含一个以标准点分十进制记法表示的IP地址，和一个CIDR掩码长度。IP地址只能用数字表示，不能是域或主机名。掩码长度标识客户端IP地址必须匹配的高位数。在IP地址、斜杠和CIDR掩码长度之间不能有空格。CIDR地址典型的例子有，单一主机如192.0.2.2/32，小型网络如192.0.2.0/24，大型网络如192.0.0.0/16。指定单一主机时，IPv4的CIDR掩码是32，Ipv6的是128。网络地址不要省略尾部的零。</td> 
  </tr> 
  <tr> 
   <td>&lt;IP-address&gt;，&lt;IP-mask&gt;</td> 
   <td>这个字段是CIDR-address表示法的另一个替代表示方法。用不同列表示的掩码替换掩码长度。例如，255.255.255.255对应的CIDR掩码长度是32。此字段应用于host、hostssl和hostnossl记录。</td> 
  </tr> 
  <tr> 
   <td>&lt;authentication-method&gt;</td> 
   <td>指定连接认证时使用的方法。HAWQ支持PostgreSQL 9.0所支持的认证方法（Trust、Password、GSSAPI、SSPI、Kerberos、Ident-based、LDAP、RADIUS、Certificate、PAM）。</td> 
  </tr> 
 </tbody> 
</table>

（1）配置pg\_hba.conf文件  
这个例子显示如何编辑master的pg\_hba.conf文件，以允许远程客户端使用加密口令认证，用所有角色访问所有数据库。注意：对于更高安全要求的系统，应考虑从master的pg\_hba.conf文件中删除所有信任认证方式（Trust）的连接。信任方式意味着角色被授予访问权限而不需要任何认证，因此会绕过所有安全检查。  
编辑pg\_hba.conf

1.  从hawq-site.xml文件的hawq\_master\_directory属性获得master数据目录的位置，并使用文本编辑器打开此目录下的pg\_hba.conf文件。
2.  在该文件中，为允许的每个连接增加一行。记录是顺序读取的，因此记录的顺序至关重要。例如图1：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70]
3.  保存并关闭文件。
4.  执行下面的命令重载pg\_hba.conf文件的配置，使修改生效：hawq stop cluster -u -M fast  
    （2）限制并发连接  
    HAWQ的某些资源分配是以连接为基础的，因此推荐配置允许的最大连接数。为了限制HAWQ系统的并发会话数量，可以配置master的max\_connections服务器配置参数，或者segment的seg\_max\_connections服务器配置参数。这些参数是本地参数，因此必须在所有HAWQ实例的hawq-site.xml文件中进行设置。  
    如果设置了max\_connections，必须也要设置其依赖参数max\_prepared\_transactions。该参数值必须大于等于max\_connections的值，并且所有HAWQ实例要配置相同的值。下面是一个$GPHOME/etc/hawq-site.xml配置示例：

<property>
        <name>max_connections</name>
        <value>500</value>
    </property>
    <property>
        <name>max_prepared_transactions</name>
        <value>1000</value>
    </property>
    <property>
        <name>seg_max_connections</name>
        <value>3000</value>
    </property>

增加这些值会引起HAWQ需要更多的共享内存。为了缓解内存使用压力，可以考虑降低其它内存相关的服务器配置参数，如gp\_cached\_segworkers\_threshold等。不需要手工编辑每个节点的hawq-site.xml文件设置允许的连接数。可以使用Ambari或 命令行配置这些参数。使用Ambari：

1.  通过HAWQ service Configs > Advanced > Custom hawq-site > Add Property … 配置max\_connections、seg\_max\_connections和 max\_prepared\_transactions属性。
2.  选择Service Actions > Restart All重载更新的配置。  
    使用命令行：
3.  作为管理员登录HAWQ的master节点并设置环境：`source /usr/local/hawq/greenplum_path.sh`
4.  使用hawq config应用程序设置max\_connections、seg\_max\_connections和max\_prepared\_transactions参数值,max\_prepared\_transactions的值必须大于等于max\_connections。。例如：

$ hawq config -c max_connections -v 100
    $ hawq config -c seg_max_connections -v 640
    $ hawq config -c max_prepared_transactions -v 200

1.  重启HAWQ集群重载新的配置值。`$ hawq restart cluster`
2.  使用hawq config的-s选项显示服务器配置参数的值，确认配置生效：

$ hawq config -s max_connections
    $ hawq config -s seg_max_connections

## 二、管理角色与权限 ##

### 1. HAWQ角色与权限概述 ###

pg\_hba.conf文件限定了允许连接HAWQ的客户端主机、用户名、访问的数据库，认证方式等。用户名、口令，以及用户对数据库对象的使用权限保存在HAWQ的元数据表中（pg\_authid、pg\_roles、pg\_class等）。HAWQ采用基于角色的访问控制机制，通过角色机制，简化了用户和权限的关联性。HAWQ系统中的权限分为两种：**系统权限**和**对象权限**。**系统权限是指系统规定用户使用数据库的权限，如连接数据库、创建数据库、创建用户等**。**对象权限是指在表、序列、函数等数据库对象上执行特殊动作的权限，其权限类型有select、insert、update、delete、references、trigger、create、connect、temporary、execute和usage等**。  
与Oracle、SQLServer等数据库中角色的概念不同，这些系统中的所谓角色，是权限的组合和抽象，创建角色最主要的目的是简化对用户的授权。举一个简单的例子，假设需要给五个用户每个授予相同的五种权限，如果没有角色，需要授权二十五次，而如果把五种权限定义成一种角色，只需要先进行一次角色定义，再授权五次即可。然而**HAWQ中的角色既可以代表一个数据库用户，又可以代表一组权限**。而角色所拥有的预定义的系统权限是通过角色的属性实现的。角色可以是数据库对象 （例如表）的属主，也可以给其它角色赋予访问这些对象的权限。角色可以是其它角色的成员，因此一个成员角色可以从其父角色继承对象权限。  
HAWQ系统可能包含多个数据库角色（用户或组）。这些角色并不是运行服务器上操作系统的用户和组。但是为方便起见，可能希望维护操作系统用户名和HAWQ角色名的关系，因为很多客户端应用程序，如psql，使用当前操作系统用户名作为缺省的角色，gpadmin就以最典型的例子。用户通过master实例连接HAWQ，mater 通过pg\_hba.conf里的条目验证用户的角色和访问权限。之后master以当前登录的角色，从后台向segment实例发布SQL命令。系统级定义的角色对系统中所有数据库都是有效的。为了创建更多的角色，首先需要使用超级用户gpadmin连接HAWQ。

### 2. 角色和权限的安全最佳实践 ###

保证gpadmin系统用户安全。HAWQ需要一个UNIX用户ID安装和初始化HAWQ系统。这个系统用户ID在HAWQ文档中被称为gpadmin。gpadmin用户是HAWQ中缺省的数据库超级用户，也是HAWQ安装及其底层数据文件的文件系统属主。这个缺省的管理员账号是HAWQ的基础设计。缺了这个用户系统无法运行。并且，没有方法能够限制gpadmin用户对数据库的访问。应该只使用gpadmin账号执行诸如扩容和升级之类的系统维护任务。任何以这个用户登录HAWQ主机的人，都可以读取、修改和删除任何数据，尤其是系统目录数据和数据库访问权力。因此，gpadmin用户的安全非常重要，仅应该提供给关键的系统管理员使用。应用的数据库用户应该永不作为gpadmin登录，ETL或者生产环境的应用程序也不应该以gpadmin用户连接数据库。赋予每个登录用户不同的角色。出于记录和审核目的，每个登录HAWQ的用户都应该被赋予自己的数据库角色。对于应用程序或者web服务，最好为每个应用或服务创建不同的角色。使用组管理访问权限。限制具有超级用户角色属性的用户。超级用户角色绕过HAWQ中所有的访问权限检查和资源队列，所以只应该将超级用户权限授予系统管理员。

### 3. 创建角色（用户） ###

此时的角色指的是一个可以登录到数据库，并开启一个数据库会话的用户。使用create role命令创建一个角色时，必须授予login系统属性（功能类似于Oracle的connect角色），使得该角色可以连接数据库。例如：create role jsmith with login;一个数据库角色有很多属性，用以定义该角色可以在数据库中执行的任务类型，或者具有的系统权限。表2描述了有效的角色属性。

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>SUPERUSER/NOSUPERUSER</td> 
   <td>确定一个角色是否是超级用户。只有超级用户才能创建新的超级用户。缺省值为NOSUPERUSER。</td> 
  </tr> 
  <tr> 
   <td>CREATEDB/NOCREATEDB</td> 
   <td>确定角色是否被允许创建数据库。缺省值为NOCREATEDB。</td> 
  </tr> 
  <tr> 
   <td>CREATEROLE/NOCREATEROLE</td> 
   <td>确定角色是否被允许创建和管理其它角色。缺省值为NOCREATEROLE。</td> 
  </tr> 
  <tr> 
   <td>INHERIT/NOINHERIT</td> 
   <td>确定角色是否从其所在的组继承权限。具有INHERIT属性的角色可以自动使用所属组已经被授予的数据库权限，无论角色是组的直接成员还是间接成员。缺省值为INHERIT。</td> 
  </tr> 
  <tr> 
   <td>LOGIN/NOLOGIN</td> 
   <td>确定角色是否可以登录。具有LOGIN属性的角色可以将角色作为用户登录。没有此属性的角色被用于管理数据库权限（即用户组）。缺省值为NOLOGIN。</td> 
  </tr> 
  <tr> 
   <td>CONNECTION LIMIT connlimit</td> 
   <td>如果角色能够登录，此属性指定角色可以建立多少个并发连接。缺省值为-1，表示没有限制。</td> 
  </tr> 
  <tr> 
   <td>PASSWORD ’password’</td> 
   <td>设置角色的口令。如果不准备使用口令认证，可以忽略此选项。如果没有指定口令，口令将被设置为null，此时该用户的口令认证总是失败。一个null口令也可以显示的写成PASSWORD NULL。</td> 
  </tr> 
  <tr> 
   <td>ENCRYPTED/UNENCRYPTED</td> 
   <td>控制口令是否加密存储在系统目录中。行为由password_encryption配置参数所决定，缺省的设置是md5，如果要改为SHA-256加密，设置此参数为password。如果给出的口令字符串已经是加密格式，那么它被原样存储，而不管指定ENCRYPTED还是UNENCRYPTED（因为系统不能对加密的口令字符串进行解密）。这种设计允许在dump/restore时重新导入加密的口令。</td> 
  </tr> 
  <tr> 
   <td>VALID UNTIL ’timestamp’</td> 
   <td>设置一个日期和时间，在该时间点后角色的口令失效。如果忽略此选项，口令将永久有效。</td> 
  </tr> 
  <tr> 
   <td>RESOURCE QUEUE queue_name</td> 
   <td>赋予角色一个命名的资源队列用于负载管理。角色发出的任何语句都受到该资源队列的限制。注意，这个RESOURCE QUEUE属性不会被继承，必须在每个用户级（登录）角色设置。</td> 
  </tr> 
  <tr> 
   <td>DENY {deny_interval/deny_point}</td> 
   <td>在此时间区间内禁止访问。指定天或者天和时间。</td> 
  </tr> 
 </tbody> 
</table>

可以在创建角色时，或者创建角色后使用alter role命令指定这些属性。例如：

alter role jsmith with password 'passwd123';
    alter role admin valid until 'infinity';
    alter role jsmith login;
    alter role jsmith resource queue adhoc;
    alter role jsmith deny day 'sunday';

使用drop role或drop user命令删除角色（用户）。在删除角色前，先要收回角色所拥有的全部权限，或者先删除与角色相关联的所有对象，否则删除角色时会提示“cannot be dropped because some objects depend on it”错误。

### 4. 角色成员 ###

通常将多个权限合成一组，能够简化对权限的管理。使用这种方法，对于一个组中的用户，其权限可以被整体授予和回收。在HAWQ中的实现方式为，创建一个表示组的角色，然后为用户角色授予组角色的成员。下面的SQL命令使用create role创建一个名为admin组角色，该组角色具有createrole和createdb系统权限。`create role admin createrole createdb;`  
一旦组角色存在，就可以使用grant和revoke命令添加或删除组成员（用户角色）。例如：

grant admin to john, sally;
    revoke admin from bob;

为了简化对象权限的管理，应当只为组级别的角色授予适当的权限。成员用户角色继承组角色的对象权限。例如：

grant all on table mytable to admin;
    grant all on schema myschema to admin;
    grant all on database mydb to admin;

角色属性LOGIN、SUPERUSER、CREATEDB和CREATEROLE不会当做普通的数据库对象权限被继承。为了让用户成员使用这些属性，必须执行SET ROLE指定一个具有这些属性的角色。在上面的例子中，我们已经为admin指定了CREATEDB和CREATEROLE属性。sally是admin的成员，当以sally连接到数据库后，执行以下命令，使sally可以拥有父角色的CREATEDB和CREATEROLE属性。  
set role admin;  
有关角色属性信息可以在系统表pg\_authid中找到，pg\_roles是基于系统表pg\_authid的视图。系统表pa\_auth\_members存储了角色之间的成员关系。

### 5. 管理对象权限 ###

当一个对象（表、视图、序列、数据库、函数、语言、模式或表空间）被创建，它的权限被赋予属主。属主通常是执行create语句的角色。对于大多数类型的对象，其初始状态是只允许属主或超级用户在对象上做任何操作。为了允许其它角色使用对象，必须授予适当的权限。HAWQ对每种对象类型支持的权限如表3所示。

<table> 
 <thead> 
  <tr> 
   <th>对象类型</th> 
   <th>权限</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Tables、Views、Sequences</td> 
   <td>SELECT、INSERT、RULE、ALL</td> 
  </tr> 
  <tr> 
   <td>External Tables</td> 
   <td>SELECT、RULE、ALL</td> 
  </tr> 
  <tr> 
   <td>Databases</td> 
   <td>CONNECT、CREATE、TEMPORARY</td> 
  </tr> 
  <tr> 
   <td>Functions</td> 
   <td>EXECUTE</td> 
  </tr> 
  <tr> 
   <td>Procedural Languages</td> 
   <td>USAGE</td> 
  </tr> 
  <tr> 
   <td>Schemas</td> 
   <td>CREATE、USAGE、ALL</td> 
  </tr> 
  <tr> 
   <td>Custom Protocol</td> 
   <td>SELECT、INSERT、RULE、ALL</td> 
  </tr> 
 </tbody> 
</table>

注意：必须为每个对象单独授权。例如，授予数据库上的ALL权限，并不会授予数据库中全部对象的访问权限，而只是授予了该数据库自身的数据库级别的全部权限（CONNECT、CREATE、TEMPORARY）。  
使用grant SQL语句为一个角色授予一个对象权限。例如：`grant insert on mytable to jsmith;`  
使用revoke命令回收权限。例如： revoke all privileges on mytable from jsmith;  
也可以使用drop owned和reassign owned命令为一个角色删除或重新赋予对象属主权限。只有对象的属主或超级用户可以删除或重新赋予对象的属主权限。例如：

reassign owned by sally to bob;
    drop owned by visitor;

HAWQ不支持行级和列级的访问控制，但是可以使用视图限制查询的行或列，模拟行级和列级访问控制。此时角色被授予对视图而不是基表的访问权限。对象权限，存储在pg\_class.relacl中，更多对象权限的信息，可以参考”PostgreSQL 表和列权限(ACL)解读“

### 6. 口令加密 ###

HAWQ缺省使用MD5为用户口令加密，通过适当配置服务器参数，也能实现口令的SHA-256加密存储。为了使用SHA-256加密，客户端认证方法必须设置为password而不是缺省的MD5。口令虽然以加密形式存储在系统表中，但仍然以明文在网络间传递。为了避免这种情况，应该建立客户端与服务器之间的SSL加密通道。

#### （1）系统级启用SHA-256加密 ####

如果使用Ambari管理HAWQ集群：

1.  通过HAWQ service Configs > Advanced > Custom hawq-site下拉列表设置password\_hash\_algorithm配置属性，有效值为SHA-256。
2.  选择Service Actions > Restart All重载更新的配置。  
    如果从命令行管理HAWQ集群：
3.  作为管理员登录HAWQ master并设置路径：`$ source /usr/local/hawq/greenplum_path.sh`
4.  使用hawq config应用程序设置password\_hash\_algorithm为SHA-256：`$ hawq config -c password_hash_algorithm -v 'SHA-256'`
5.  重载HAWQ配置：`$ hawq stop cluster -u`
6.  验证设置：`$ hawq config -s password_hash_algorithm`

#### （2）会话级启用SHA-256加密 ####

为单个数据库会话设置password\_hash\_algorithm服务器参数：

1.  以超级用户登录HAWQ实例。
2.  设置password\_hash\_algorithm参数为SHA-256：`set password_hash_algorithm = 'SHA-256';`
3.  验证参数设置：`show password_hash_algorithm;`

#### （3）验证口令加密方式生效 ####

建立一个具有login权限的新角色，并设置口令：`create role testdb with password 'testdb12345#' login;`  
修改客户端认证方法，允许存储SHA-256加密的口令，打开master的pg\_hba.conf文件并添加下面一行：`host all testdb 0.0.0.0/0 password`  
重启集群：`hawq restart cluster`  
以刚创建的testdb用户登录数据库。`psql -d postgres -h hdp3 -U testdb`  
在提示时输入正确的口令。  
验证口令被以SHA-256哈希方式存储，哈希后的口令存储在pg\_authid.rolpasswod字段中。

1.  作为超级用户登录。
2.  执行下面的查询：`select rolpassword from pg_authid where rolname = 'testdb';` 查询结果如图2所示。  
    ![在这里插入图片描述][20210121225506930.png]

## 三、使用psql连接HAWQ ##

用户可以使用与一个PostgreSQL兼容的客户端程序连接到HAWQ，最常用的客户端工具就是psql。再次强调，用户和管理员总是通过master连接到HAWQ，segment不能接受客户端连接。为了建立一个到master的连接，需要知道表4所示的连接信息，并在psql命令行给出相应参数或配置相关的环境变量。

<table> 
 <thead> 
  <tr> 
   <th>连接参数</th> 
   <th>描述</th> 
   <th>环境变量</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>应用名</td> 
   <td>连接数据库的应用名称。连接参数application_name中配置的缺省值是psql。</td> 
   <td>$PGAPPNAME</td> 
  </tr> 
  <tr> 
   <td>数据库名</td> 
   <td>连接的数据库名称。对于一个新初始化的系统，首次连接使用template1数据库。</td> 
   <td>$PGDATABASE</td> 
  </tr> 
  <tr> 
   <td>主机名</td> 
   <td>HAWQ master的主机名。缺省主机时localhost。</td> 
   <td>$PGHOST</td> 
  </tr> 
  <tr> 
   <td>端口</td> 
   <td>HAWQ master实例运行的端口号。缺省是5432。</td> 
   <td>$PGPORT</td> 
  </tr> 
  <tr> 
   <td>用户名</td> 
   <td>连接数据库的用户（角色）名称。与操作系统用户名相同的用户名不需要此参数。注意，每个HAWQ系统都有一个在初始化时自动创建的超级用户账号。这个账号与初始化HAWQ系统的操作系统用户同名（典型地是gpadmin）。</td> 
   <td>$PGUSER</td> 
  </tr> 
 </tbody> 
</table>

下面的例子显示如何通过psql访问一个数据库，没有指定的连接参数 依赖于设置的环境变量或使用缺省值。

psql -d mytest -h hdp3 -p 5432 -U `gpadmin`
    psql mytest
    psql

如果一个用户定义的数据库还没有创建，可以通过连接template1数据库访问系统。例如：psql template1  
连接数据库后，psql提供一个由当前连接的数据库名后跟=>构成的提示符（超级用户是=\#）。例如：mytest=>  
在提示符下，可以键入SQL命令。一个SQL命令必须以;（分号）结束，以发送到诉服务器执行。例如：select \* from mytable;  
psql常用命令与mysql命令行的比较如表5所示。

<table> 
 <thead> 
  <tr> 
   <th>功能描述</th> 
   <th>psql</th> 
   <th>mysql</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>联机帮助</td> 
   <td>help：简要帮助 ?：psql命令帮助 \h：SQL命令帮助</td> 
   <td>help、?、?、\h：都是等价的简要帮助。后面可以跟SQL命令，显示详细的命令语法</td> 
  </tr> 
  <tr> 
   <td>执行SQL</td> 
   <td>分号或\g</td> 
   <td>分号、\g或\G</td> 
  </tr> 
  <tr> 
   <td>退出</td> 
   <td>\q</td> 
   <td>\q、exit或quit</td> 
  </tr> 
  <tr> 
   <td>列出所有数据库</td> 
   <td>\l</td> 
   <td>show databases;</td> 
  </tr> 
  <tr> 
   <td>改变当前连接的数据库</td> 
   <td>\c DBNAME</td> 
   <td>use db_name;</td> 
  </tr> 
  <tr> 
   <td>列出内部表</td> 
   <td>\dt</td> 
   <td>show tables;</td> 
  </tr> 
  <tr> 
   <td>列出外部表</td> 
   <td>\dx</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>表的描述</td> 
   <td>\d NAME</td> 
   <td>desc tbl_name;</td> 
  </tr> 
  <tr> 
   <td>列出索引</td> 
   <td>目前不支持索引</td> 
   <td>show index from tbl_name;</td> 
  </tr> 
  <tr> 
   <td>列出视图</td> 
   <td>\dv</td> 
   <td>show tables;</td> 
  </tr> 
  <tr> 
   <td>列出序列</td> 
   <td>\ds</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>列出系统表</td> 
   <td>\dtS+</td> 
   <td>show tables from mysql; show tables from information_schema; show tables from performance_schema;</td> 
  </tr> 
 </tbody> 
</table>

表5

## 四、用Kettle连接HAWQ ##

1.  在pg\_hba.conf文件中添加客户端连接 echo “host all kettle 192.168.8.187/32 md5” >> /data/hawq/master/pg\_hba.conf
2.  重载pg\_hba.conf文件使修改生效hawq stop cluster -u -M fast
3.  在psql中建立用户并授权

create role kettle with login;
    alter role kettle with password '123456';
    \t on
    \o /tmp/grant.sql
    select 'grant select on '||tablename || ' to kettle;' from pg_tables where schemaname='public';
    \o
    \i /tmp/grant.sql

1.  在Kettle中建立DB连接  
    （1）新建转换。  
    （2）选中“主对象树” -> 转换 -> 转换1 -> DB连接，右键点击“新建”。  
    （3）如图3配置数据库连接。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 1]  
    （4）点击“测试”，弹出图4所示的测试成功页面。  
    ![在这里插入图片描述][20210121225746214.png]  
    （5）新建一个“表输入”步骤，在编辑窗口中，“数据库连接”选择“hawq”，然后点击“获取查询SQL语句…”，在图5所示的弹出窗口中选择一个表并确定，结果如图6所示。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 2]  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 3]  
    （6）点击“预览”，结果如图7所示。  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 4]  
    正确显示出查询的数据，连接成功。如果在HAWQ中授予kettle用户的insert权限，HAWQ也可作为表输出步骤的数据库连接，在Kettle中创建转换，从其它数据源向HAWQ导入数据。

## 五、连接常见问题 ##

很多问题会引起客户端应用连接HAWQ失败。表6是HAWQ提供的造成连接问题的常见原因及其排查方法。

<table> 
 <thead> 
  <tr> 
   <th>问题</th> 
   <th>解决方案</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>No pg_hba.conf entry for host or user</td> 
   <td>为了让HAWQ接受远程客户端连接，必须配置HAWQ的master实例上配置位于master实例数据目录下的pg_hba.conf文件，在该文件中增加适当的条目，允许客户端主机和数据库用户连接到HAWQ。</td> 
  </tr> 
  <tr> 
   <td>HAWQ is not running</td> 
   <td>如果HAWQ master实例宕机，用户将不能连接。可以在HAWQ master上运行hawq state应用程序，验证HAWQ系统正在运行。</td> 
  </tr> 
  <tr> 
   <td>Network problem Interconnect timeouts</td> 
   <td>当用户从远程客户端连接到HAWQ master时，网络问题可能阻止连接，例如，DNS主机名解析问题，主机系统断网等等。为了确认不是网络问题，从远程客户端所在主机连接HAWQ master所在主机。例如：ping hostname。如果系统不能解析HAWQ主机IP地址所涉及的主机名，查询和连接将失败。有些操作使用localhost进行连接，而另一些操作使用实际的主机名，所以两种情况都必须能正确解析。如果碰到连接错误，首先核实能够从HAWQ master所在主机连接到集群主机。在master和所有段的/etc/hosts文件中，确认有HAWQ集群中所有主机的正确的主机名和IP地址。127.0.0.1必须被解析成localhost。</td> 
  </tr> 
  <tr> 
   <td>Too many clients already</td> 
   <td>缺省时，HAWQ master和segment允许的最大并发连接数分别是200和1280。超出此限制的连接将被拒绝。这个限制由master实例的max_connections参数和segment实例的seg_max_connections参数所控制。如果修改了master的设置，也必须在segment节点上做适当的修改。</td> 
  </tr> 
  <tr> 
   <td>Query failure</td> 
   <td>HAWQ集群网络中必须配置DNS反向解析。如果DNS反向解析没有配置，失败的查询将在HAWQ master的日志文件中产生“Failed to reverse DNS lookup for ip &lt;ip-address&gt;”警告消息。</td> 
  </tr> 
 </tbody> 
</table>

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70]: /images/20221119/f041c6dad6284be69003e8eb6366f07e.png
[20210121225506930.png]: /images/20221119/037270e7b4c24cebad5dc7c0a6027c5b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 1]: /images/20221119/254b7a5346fb42d8b5026048b256cae7.png
[20210121225746214.png]: /images/20221119/e57fed590fc64ef2a73a5ad9fb323a12.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 2]: /images/20221119/83a6d0aee4bb4221a272a9b3915e844b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 3]: /images/20221119/c77ce85609f9442aa654a707a4f8917f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FzbWFydGtpbGxlcg_size_16_color_FFFFFF_t_70 4]: /images/20221119/30f05085b1ae4f3196446843196205f8.png