最新动态
功能总览
服务公告
- 产品公告
- 版本支持公告
产品介绍
- 图解数据仓库服务
- 什么是数据仓库服务
- 数据仓库类型
- 数据仓库规格
- 产品优势
- 应用场景
- 产品功能
- 基本概念
- 与其他云服务的关系
- 安全
- GaussDB(DWS)权限管理
- 如何访问GaussDB(DWS)
- 使用限制
- 技术支持
- 配额说明
- GaussDB(DWS)技术指标
计费说明
- GaussDB(DWS)计费概述
- 计费模式
- 计费项
- 计费样例
- 变更计费模式
- 续费
  - 续费概述
  - 手动续费
- 费用账单
- 欠费说明
- 停止计费
- 成本管理
- 计费FAQ
快速入门
- 免费体验GaussDB(DWS)
- 快速创建GaussDB(DWS)集群并导入数据进行查询
- GaussDB(DWS)数据开发SQL入门操作
- GaussDB(DWS)入门实践
用户指南
- GaussDB(DWS)使用流程
- 准备工作
- 创建GaussDB(DWS)集群
- 连接GaussDB(DWS)集群
- 创建GaussDB(DWS)数据库和用户
- 迁移业务数据至GaussDB(DWS)集群
  - 使用GDS-Kafka工具迁移数据至GaussDB(DWS)集群
  - 管理数据源
- GaussDB(DWS)集群数据安全与加密
- GaussDB(DWS)集群管理
- GaussDB(DWS)集群运维
最佳实践
- 导入导出
- 数据迁移
- 数据分析
- 存算分离
  - GaussDB(DWS) 3.0 存算分离使用建议及性能优化
- 数据开发
- 数据库管理
- 性能调优
  - 基于表结构设计和调优提升GaussDB(DWS)查询性能
  - 分析正在执行的SQL以处理GaussDB(DWS)业务阻塞
- 集群管理
  - 为两种作业绑定不同资源池以实现GaussDB(DWS)资源负载能力
  - GaussDB(DWS)存算一体架构弹性伸缩系统性介绍
数据迁移与同步
- 迁移数据到GaussDB(DWS)
- 导入数据
- 整库迁移
  - 使用CDM迁移数据到GaussDB(DWS)
  - 使用DSC工具迁移SQL脚本
- 实时入库
  - Kafka实时入库到GaussDB(DWS)
- 元数据迁移
  - 使用gs_dump和gs_dumpall命令导出元数据
  - 使用gs_restore导入数据
- 导出数据
- 其他操作
开发指南
- 标准数仓开发指南(9.1.0.x)
- 标准数仓开发指南(8.1.3.x)
- 实时数仓开发指南(9.1.0.x)
- 实时数仓开发指南(8.1.3.x)
- 历史版本
SQL语法参考
- SQL语法参考(9.1.0.x)
- SQL语法参考(8.1.3.x)
- 历史版本
工具指南
- 工具简介
- 工具下载
- gsql
- Data Studio
- GDS
- DSC
- DataCheck
- DWS-Connector
- 服务端工具
API参考
- 使用前必读
- API概述
- 如何调用API
- 快速入门
- API说明
- 应用示例
  - 使用Postman调用创建集群接口
  - 使用Postman调用创建快照接口
- 权限及授权项说明
- 附录
SDK参考
- SDK概述
场景代码示例
错误码参考
- 控制台错误码
  - 管理控制台错误码
- 错误码(8.2.0及以下版本)
  - 管理控制台错误码
  - 数据仓库错误码
- 8.2.1及以上版本
  - 错误码命名规范
  - 行列存
    - 行存
    - 列存
    - GIN索引
    - Btree索引
    - 行存vacuum
    - SP-GiST索引
    - Hash索引
  - 事务
    - 锁
    - GTM
    - xlog
    - checkpoint
  - HA
  - SQL on Anywhere
    - SQL on hudi
    - OBS / HDFS / DLI
  - GDS/Copy
    - 公共机制（选项参数、任务分配、压缩）
    - 导入
  - 解析器
    - 词法分析
    - 语法分析
    - DDL
    - DML
    - 表达式
    - 元数据
  - 优化器
  - 执行器
  - 安全
    - 授权
    - 脱敏
  - 通信
  - WLM
  - 逻辑集群
  - 其他
常见问题
- Top问题汇总
- 产品咨询
- 数据库连接
- 数据迁移
- 数据库使用
- 集群管理
- 账户与权限
- 数据库性能
- 备份恢复
  1. 为什么DWS自动快照创建很慢，很长时间都没有创建好？
  2. DWS快照是否与EVS快照功能相同？
故障排除
- 数据库连接管理
- JDBC/ODBC类
- 数据导入/导出
- 数据库参数修改
- 账号/权限/密码
- 集群性能
- 集群异常
  - 磁盘监控告警阈值太低，告警频繁
- 数据库使用
视频帮助
性能白皮书
- 性能白皮书(9.1.0.x)
- 性能白皮书(8.1.3.x)
文档下载
通用参考
- 产品术语
- 云服务等级协议（SLA）
- 白皮书资源
- 支持区域
- 系统权限

本文导读

展开导读

文档首页/ 数据仓库服务 GaussDB(DWS)/ SQL语法参考/ SQL语法参考(9.1.0.x)/ DDL语法/ CREATE SERVER

CREATE SERVER

更新时间：2025-03-21 GMT+08:00

查看PDF

功能描述

创建一个外部服务器。

外部服务器是存储HDFS集群信息、OBS服务器信息、DLI连接信息或其他同构集群信息的载体。

说明：

单节点集群（单机部署）仅8.2.x及以上集群版本支持创建FOREIGN DATA WRAPPER为DFS_FDW且type为OBS的外部服务器。

注意事项

默认只有系统管理员才可以创建外部服务器，否则需要对所使用的FOREIGN DATA WRAPPER授权，授权语法为：

    
       GRANT USAGE ON FOREIGN DATA WRAPPER fdw_name TO username;

其中fdw_name为FOREIGN DATA WRAPPER的名字，username为创建SERVER的用户名。

语法格式

    
       CREATE SERVER server_name 
    FOREIGN DATA WRAPPER fdw_name
    OPTIONS ( { option_name ' value ' } [, ...] ) ;

参数说明

server_name
要创建的外部服务器的名称。服务器名称在数据库中必须唯一。

取值范围：长度必须小于等于63。
FOREIGN DATA WRAPPER fdw_name
指定外部数据封装器的名字。

取值范围：fdw_name是数据库初始化时系统创建的数据封装器，目前对于HDFS集群，fdw_name的名字可以是hdfs_fdw或者dfs_fdw；对于其他同构集群，fdw_name为gc_fdw；对于数据导入导出场景，GDS外表使用gsmpp_server，fdw_name为dist_fdw。
OPTIONS ( { option_name ' value ' } [, ...] )
用于指定外部服务器的各类参数，详细的参数说明如下所示。
- address
  指定的OBS服务终端节点或HDFS集群的IP地址。
  
  OBS：OBS服务的终端节点（Endpoint）。
  
  HDFS：HDFS集群的元数据节点（NameNode）所在的IP地址以及端口，或者同构其他集群的CN的IP地址以及端口。
  
  为保证HA（High Availability），HDFS NameNode经常采用主备模式。主备NameNode的地址都需要加入到address值中。GaussDB(DWS)访问HDFS服务时，会动态查找当前处于active状态的主NameNode。
  
  若HDFS为联邦模式时，可将Router的地址都加入到address值中，GaussDB(DWS)访问HDFS服务时，会动态随机查找当前处于active状态的Router。
  说明：
  - address option必须存在，若用于跨集群互联互通场景则只允许设置1个。
  - 当server类型为DLI时，address为DLI服务上数据所存储的OBS address。
  - 若HDFS为联邦模式时，即fed 'rbf'，address可设置为多组IP、port，对应为HDFS Router的address。
- hdfscfgpath
  该参数仅支持type为HDFS时设置。
  
  用户通过配置hdfscfgpath参数来指定HDFS配置文件路径。GaussDB(DWS)会根据配置文件路径下的HDFS配置文件指定的连接配置方式，以及安全模式，来访问HDFS集群。非安全模式连接HDFS集群时，不支持数据传输加密。
  
  如果没有指定address选项，默认采用hdfscfgpath指定的配置文件中指定的address。
- fed
  表示dfs_fdw连接的是HDFS为联邦模式。
  
  取值rbf，表示HDFS为联邦rbf方式。
  
  说明：
  
  该参数8.1.2及以上版本支持。
- encrypt
  是否对数据进行加密，该参数仅支持type为OBS时设置。默认值为off。
  
  取值范围：
  - on表示对数据进行加密。
  - off表示不对数据进行加密。
- access_key
  OBS访问协议对应的AK值（OBS云服务界面由用户获取），创建外表时AK值会保存到数据库的元数据表中。
  说明：
  - FOREIGN DATA WRAPPER为dfs_fdw时，仅支持type为OBS时设置。
  - 8.2.0及以上版本集群，支持FOREIGN DATA WRAPPER为dist_fdw时指定该参数。
- secret_access_key
  OBS访问协议对应的SK值（OBS云服务界面由用户获取），创建外表时SK值会加密保存到数据库的元数据表中。
  说明：
  - FOREIGN DATA WRAPPER为dfs_fdw时，仅支持type为OBS时设置。
  - 8.2.0及以上集群版本，支持FOREIGN DATA WRAPPER为dist_fdw时指定该参数。
- security_token
  对应统一身份认证服务IAM中临时安全凭证的SecurityToken的值，与临时AK、SK共同组成临时安全凭证，临时安全凭证有效期不超过24小时。该参数仅8.2.0及以上集群版本支持。
  说明：
  - FOREIGN DATA WRAPPER为dfs_fdw时，仅支持type为OBS时设置。
  - 8.2.0及以上集群版本，支持FOREIGN DATA WRAPPER为dist_fdw时指定该参数。
  - 使用该参数时，access_key和secret_access_key参数分别对应临时AK、SK。
- type
  表示dfs_fdw连接的类型。
  
  取值范围：
  - OBS表示连接的是OBS。
  - HDFS表示连接的是HDFS。
  - DLI表示连接的是DLI。
- dli_address
  DLI服务的终端节点，即endpoint。该参数仅支持type为DLI时设置。
- dli_access_key
  DLI访问协议对应的AK值（DLI云服务界面由用户获取），创建外表时AK值会保存到数据库的元数据表中。该参数仅支持type为DLI时设置。
- dli_secret_access_key
  DLI访问协议对应的SK值（DLI云服务界面由用户获取），创建外表时SK值会加密保存到数据库的元数据表中。该参数仅支持type为DLI时设置。
- dbname
  用于协同分析、跨集群互联互通，表示将要连接的远端集群的数据库名字。
- username
  用于协同分析、跨集群互联互通，表示将要连接的远端集群的用户名。
- password
  用于协同分析、跨集群互联互通，表示将要连接的远端集群的用户名密码。
  
  说明：
  
  对于云下集群迁移到云上的场景，从云下集群导出的server配置中密码为密文，由于云上和云下集群加解密的密钥不同，如果直接在云上集群执行导出时的CREATE SERVER，会执行失败，报解密失败的错误。这种场景下需要将CREATE SERVER中的password手动修改成明文密码进行配置。
- syncsrv
  仅用于跨集群互联互通，表示数据同步过程中使用到的GDS服务，设置方式与GDS外表的location属性相同。

示例

建立一个hdfs_server，其中hdfs_fdw为数据库中存在的foreign data wrapper：

    
       CREATE SERVER hdfs_server FOREIGN DATA WRAPPER HDFS_FDW OPTIONS 
   (address '10.10.0.100:25000,10.10.0.101:25000',
    hdfscfgpath '/opt/hadoop_client/HDFS/hadoop/etc/hadoop', 
    type 'HDFS'
) ;

建立一个obs_server，其中dfs_fdw为数据库中存在的foreign data wrapper：

    
       CREATE SERVER obs_server FOREIGN DATA WRAPPER DFS_FDW OPTIONS ( 
  address 'obs.cn-north-1.myhuaweicloud.com', 
   access_key 'xxxxxxxxx', 
  secret_access_key 'yyyyyyyyyyyyy', 
  type 'obs'
);

建立一个dli_server，其中dfs_fdw为数据库中存在的foreign data wrapper：

    
       CREATE SERVER dli_server FOREIGN DATA WRAPPER DFS_FDW OPTIONS ( 
  address 'obs.cn-north-1.myhuaweicloud.com', 
  access_key 'xxxxxxxxx', 
  secret_access_key 'yyyyyyyyyyyyy', 
  type 'dli',
  dli_address 'dli.example.com',
  dli_access_key 'xxxxxxxxx',
  dli_secret_access_key 'yyyyyyyyyyyyy'
);

建立另外一个同构集群的server，其中gc_fdw为数据库中存在的foreign data wrapper：

    
       CREATE SERVER server_remote FOREIGN DATA WRAPPER GC_FDW OPTIONS 
   (address '10.10.0.100:25000,10.10.0.101:25000',
  dbname 'test', 
  username 'test', 
  password 'xxxxxxxx'
);

建立一个FOREIGN DATA WRAPPER为dist_fdw的server，用于obs上文本数据的导入导出：

    
       CREATE SERVER import_server FOREIGN DATA WRAPPER DIST_FDW OPTIONS 
(
  access_key 'ak_string',
  secret_access_key 'sk_string'
);

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

CREATE SERVER

功能描述

注意事项

语法格式

参数说明

示例

相关链接

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈