创建Foreign Server

前提条件

• 已创建OSS Bucket并导入数据，详情请参见开始使用OSS。

• 已创建DLF Catalog，详情请参见数据目录。

• 已具备所使用的foreign-data wrapper的USAGE权限，授权方式请参见权限授予。

使用说明

1. 登录Hologres管理控制台。

2. 在顶部菜单栏左侧，选择相应的地域。

3. 在左侧导航栏选择实例列表，单击目标实例操作列的数据湖加速。开启数据湖加速能力。

4. 在左侧导航栏单击前往HoloWeb，进入HoloWeb开发页面。

5. 登录目标数据库后，在顶部菜单栏单击元数据管理 > OSS数据湖加速 > 创建Foreign Server。

   参数说明如下：

   参数名	描述
   Server Name	外部服务器的名称。 重要 外部服务器名称必须在数据库中保持唯一。
   DLF EndPoint	默认为当前地域的DLF Endpoint，详情请参见已开通的地域和访问域名。
   DLF Catalog	在下拉列表中选择已创建的DLF Catalog名称，若下拉列表为空，可单击前往DLF控制台进行创建。
   OSS EndPoint	默认为当前地域的原生OSS Endpoint，OSS-HDFS Endpoint可在下拉列表中选择。若未创建OSS Bucket，可单击前往OSS控制台进行创建。 说明 OSS Endpoint：可通过访问域名和数据中心获取。 OSS-HDFS Endpoint：可以在OSS控制台中，已开通OSS-HDFS服务的Bucket概览页获取。

6. 单击提交，完成Foreign Server的创建。

Foreign Server相关操作

创建成功后，您可通过SQL语句对已创建的Foreign Server进行查看、修改及删除，语法如下：

• 查看已创建的Foreign Server：

  SELECT * FROM pg_foreign_server;

• 修改Foreign Server的DLF Catalog：

  ALTER SERVER <foreignserver_name> OPTIONS (ADD|SET|DROP dlf_catalog ['<catalog_name>']) ;

  参数说明如下：

  参数	描述
  foreignserver_name	待修改的Foreign Server名称。
  ADD	为Foreign Server添加DLF Catalog。
  SET	修改Foreign Server的DLF Catalog。
  DROP	删除Foreign Server的DLF Catalog。例如ALTER SERVER foreign_server_test OPTIONS (DROP dlf_catalog) ;。

• 删除Foreign Server：

  DROP SERVER <foreignserver_name> CASCADE;

  参数说明如下：

  参数	描述
  foreignserver_name	待删除的Foreign Server名称。
  CASCADE	删除Foreign Server时，级联删除依赖于Foreign Server的对象。例如外部表。

后续步骤

创建好Foreign Server后，您可以在HoloWeb中可视化创建外部表，从而通过外部表读取外部数据源（OSS）中的数据，详情请参见创建外部表。