在专用 Exadata 基础结构上将网络文件存储附加到自治 AI 数据库

您可以将网络文件存储 (Network File Storage，NFS) 共享资源附加到自治 AI 数据库，前提是数据库和文件系统位于同一专用网络中。专用 Exadata 基础结构上的自治 AI 数据库默认支持 NFSv4。

支持网络文件系统 (Network File System，NFS) 允许您执行以下操作：

以高度安全的方式将高度敏感的数据从其他数据库加载到 Exadata Cloud@Customer 上的 Autonomous AI Database。
从多个 Exadata Cloud@Customer 部署中移入和移出数据，以简化供应商数据、导出转储和其他业务流程。

如果需要，必须显式将 NFS 共享连接到以下数据库：

通过克隆具有 NFS 挂载点的自治 AI 数据库创建的克隆数据库。
备用数据库：在 Autonomous Data Guard 设置中将主数据库附加到 NFS 共享的故障转移或切换操作后承担主角色。

网络文件系统要求

在将网络文件存储 (Network File Storage，NFS) 共享资源附加到自治 AI 数据库之前，请确保：

客户提供的 NFS 可以从自治 VM 集群节点访问网络。
NFS 挂载的文件系统可由 oracle 操作系统用户在所有自治 VM 集群节点上读取和写入。
如果在用户级别控制权限，则自治 VM 集群的 oracle 用户的 uid:gid 为 1001:1001。

附加网络文件系统

使用 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 将文件系统附加到自治 AI 数据库中的目录。

注：仅当自治 AI 数据库实例位于专用端点上时，DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 过程才能附加专用文件存储服务。

创建目录或使用现有目录在自治 AI 数据库中附加外部文件系统。您必须对自治 AI 数据库实例上的目录对象具有 WRITE 权限，才能将文件系统附加到数据库中的目录位置。

例如，以下命令将创建名为 NFS_DIR 的数据库目录并创建文件系统目录 nfs：
```
CREATE DIRECTORY NFS_DIR AS 'nfs';
```
有关更多信息，请参见 Create a Directory 。
运行 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 以将文件系统附加到自治 AI 数据库中的目录。要运行此过程，您必须以 ADMIN 用户身份登录，或者对 DBMS_CLOUD_ADMIN 具有 EXECUTE 权限。
- 缺省情况下，DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 使用 NFSv3。但是，您可以选择显式使用 params 参数并指定值为 3 的 nfs_version 以指定 NFSv3。
```
BEGIN
DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name      => 'NFS',
    file_system_location  => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name        => 'NFS_DIR',
    description           => 'Source NFS for sales data'
);END;
/
```
- 要使用 NFSv4，请将 params 参数与 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 结合使用，并指定值为 4 的 nfs_version 以指定 NFSv4。
```
BEGIN
  DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (
    file_system_name => 'NFS',
    file_system_location => 'myhost.sub000445.myvcn.oraclevcn.com:/results',
    directory_name => 'NFS_DIR',
    description => 'Source NFS for sales data',

    **params => JSON_OBJECT('nfs_version' value 4)**
  );
END;
/
```
上面显示的示例将 file_system_name 参数中指定的网络文件系统附加到自治 AI 数据库。

file_system_location 参数指定文件系统的位置。为 file_system_location 提供的值由全限定域名 (Fully Qualified Domain Name，FQDN) 和文件路径组成，格式为：FQDN: file_path 。

例如：
- FQDN:myhost.sub000445.myvcn.oraclevcn.com
- 文件路径：/results
directory_name 参数指定要在其中附加文件系统的自治 AI 数据库中的目录名称。这是您在步骤 1 或之前创建的其他目录中创建的目录。

description 参数指定任务的描述。

params 参数是一个 JSON 值，用于指定附加属性 nfs_version，其值可以是 3 或 4（NFSv3 或 NFSv4）。

有关使用 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 的说明：

Oracle Cloud Infrastructure File Storage 使用 NFSv3 进行共享。有关更多信息，请参见 File Storage 概述。
如果连接到非 Oracle Cloud Infrastructure File Storage 系统，则该过程支持 NFSv3 和 NFSv4。
如果连接的 NFS 服务器使用 NFSv3，并且 NFS 版本在 NFS 服务器中更新为 NFSv4，则必须先运行 DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM，然后再运行 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM（使用 params 参数，将 nfs_version 设置为 4）。这将通过匹配协议附加 NFS，以便自治 AI 数据库可以访问 NFSv4 服务器。如果不分离，然后重新连接，NFS 服务器将无法访问，您可能会看到以下错误："Protocol not supported"。

查询 DBA_CLOUD_FILE_SYSTEMS

附加文件系统后，可以查询 DBA_CLOUD_FILE_SYSTEMS 视图以检索有关附加文件系统的信息。

例如：

SELECT file_system_name, file_system_location, directory_path
  FROM dba_cloud_file_systems
  WHERE file_system_name = 'FSS';

此查询返回 FSS 文件系统名称的详细信息。有关详细信息，请参阅 DBMS_CLOUD_FILE_SYSTEMS 视图。

使用附加的文件系统，您可以使用接受目录名称的任何 PL/SQL API 在附加的文件系统上读取和写入文件。例如，可以使用以下任何方法来处理连接的 FSS 目录：

UTL_FILE 软件包。
数据泵导出和导入实用程序。
与目录（如 DBMS_CLOUD.LIST_FILES 和 DBMS_CLOUD.PUT_OBJECT）一起使用的 DBMS_CLOUD API。

示例显示了使用 UTL_FILE 在附加的文件系统上写入文件：

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'w');

  UTL_FILE.PUT(l_file, 'Scott, male, 1000');

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

示例显示了使用 UTL_FILE 在附加的文件系统上读取文件：

DECLARE
  l_file         UTL_FILE.FILE_TYPE;
  l_location     VARCHAR2(100) := 'FSS_DIR';
  l_filename     VARCHAR2(100) := 'test.csv';
  l_text         VARCHAR2(32767);
BEGIN
  -- Open the file.
  l_file := UTL_FILE.FOPEN(l_location, l_filename, 'r');

  UTL_FILE.GET_LINE(l_file, l_text, 32767);

  -- Close the file.
  UTL_FILE.FCLOSE(l_file);
END;
/

使用 DBMS_CLOUD.LIST_FILES 显示附加文件系统上的列表文件的示例：

SELECT object_name FROM DBMS_CLOUD.LIST_FILES('FSS_DIR');

DBMS_CLOUD_FILE_SYSTEMS 视图

DBA_CLOUD_FILE_SYSTEMS 视图列出附加到数据库中的目录位置的外部文件系统的相关信息。

列	数据类型	说明
`FILE_SYSTEM_NAME`	`VARCHAR2(128)`	文件系统名称
`FILE_SYSTEM_LOCATION`	`VARCHAR2(4000)`	文件系统地点
`DIRECTORY_NAME`	`VARCHAR2(128)`	附加的目录名称
`DIRECTORY_PATH`	`VARCHAR2(4000)`	附加的目录路径
`NFS_VERSION`	`NUMBER`	NFS 版本
`DESCRIPTION`	`VARCHAR2(4000)`	运行 `DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM` 时为说明参数提供的值
`CREATION_TIME`	`TIMESTAMP(6) WITH TIME ZONE`	创建时间戳
`UPDATE_TIME`	`TIMESTAMP(6) WITH TIME ZONE`	更新时间戳

分离网络文件系统

使用 DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM 过程从自治 AI 数据库中的目录分离文件系统。

注：DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM 过程只能将专用文件存储服务与专用端点上的数据库分离。

必须对目录对象具有 WRITE 权限才能将文件系统从目录位置分离。

运行 DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM 过程以将文件系统从自治 AI 数据库中的目录位置分离。要运行此过程，您必须以 ADMIN 用户身份登录，或者对 DBMS_CLOUD_ADMIN 具有 EXECUTE 权限。

BEGIN
  DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'NFS'
  );END;
/

此示例将 file_system_name 参数中指定的网络文件系统与自治 AI 数据库分离。您必须为此参数提供值。将从 DBA_CLOUD_FILE_SYSTEMS 视图中删除有关此文件系统的信息。