將網路檔案儲存連附至專用 Exadata 基礎架構上的自治式 AI 資料庫

如果資料庫和檔案系統位於相同的專用網路中,您可以將網路檔案儲存 (NFS) 共用連附至 Autonomous AI Database專用 Exadata 基礎架構上的自治式 AI 資料庫預設支援 NFSv4。

支援網路檔案系統 (NFS) 可讓您執行下列動作:
  • 以高度安全的方式在 Exadata Cloud@Customer 上,將高敏感度資料從其他資料庫載入至 Autonomous AI Database
  • 從多個 Exadata Cloud@Customer 部署移入和移出資料,以協助廠商資料、匯出傾印及其他業務流程。
如有需要,您必須明確地將 NFS 共用附加至下列資料庫:
  • 從使用 NFS 掛載點複製 Autonomous AI Database 所建立的複製資料庫
  • 待命資料庫:主要資料庫連附至 NFS 共用之自治式資料保全設定中的容錯移轉或切換作業後,便會成為主要角色。

網路檔案系統需求

將網路檔案儲存 (NFS) 共用連附至自治式 AI 資料庫之前,請確定:
  • 客戶提供的 NFS 可以從自治式 VM 叢集節點存取網路。
  • NFS 掛載的檔案系統可供所有自治式 VM 叢集節點上的 oracle 作業系統使用者讀取和寫入。
  • 如果在使用者層次控制權限,則自治式 VM 叢集之 oracle 使用者的 uid:gid 為 1001:1001。

連附網路檔案系統

使用 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM,將檔案系統附加至 Autonomous AI Database 中的目錄。

附註:

只有當 Autonomous AI Database 執行處理位於專用端點時,DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 程序才能附加專用檔案儲存服務。
  1. 建立目錄或使用現有目錄附加 Autonomous AI Database 中的外部檔案系統。您必須具備 Autonomous AI Database 實例上目錄物件的 WRITE 權限,才能將檔案系統附加至資料庫中的目錄位置。

    例如,下列命令會建立名為 NFS_DIR 的資料庫目錄,並建立檔案系統目錄 nfs
    CREATE DIRECTORY NFS_DIR AS ‘nfs’;

    請參閱建立目錄以取得詳細資訊。

  2. 執行 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM,將檔案系統附加至 Autonomous AI Database 中的目錄。若要執行此程序,您必須以 ADMIN 使用者身分登入,或具有 DBMS_CLOUD_ADMINEXECUTE 權限。

    • 依照預設,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 參數中指定的網路檔案系統附加至 Autonomous AI Database

    file_system_location 參數會指定檔案系統的位置。您提供給 file_system_location 的值包含「完整網域名稱 (FQDN)」,且檔案路徑的格式為:FQDN:file_path

    舉例而言:
    • FQDN:myhost.sub000445.myvcn.oraclevcn.com
    • 檔案路徑:/results

    directory_name 參數會在您要附加檔案系統的自治式 AI 資料庫中指定目錄名稱。這是您在步驟 1 中建立的目錄,或是您先前建立的其他目錄。

    description 參數會指定工作的描述。

    params 參數是指定額外屬性 nfs_version 的 JSON 值,其值可以是 3 或 4 (NFSv3 或 NFSv4)。

使用 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM 的注意事項:
  • Oracle Cloud Infrastructure File Storage 使用 NFSv3 進行共用。如需詳細資訊,請參閱檔案儲存簡介

  • 如果您連附至非 Oracle Cloud Infrastructure 檔案儲存系統,此程序支援 NFSv3 和 NFSv4。

  • 如果您連附的 NFS 伺服器使用 NFSv3,而 NFS 版本在 NFS 伺服器中更新為 NFSv4,則必須執行 DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM,然後執行 DBMS_CLOUD_ADMIN.ATTACH_FILE_SYSTEM (使用 params 參數並將 nfs_version 設為 4)。這會將 NFS 連附至相符的協定,讓 Autonomous AI Database 可以存取 NFSv4 伺服器。若未取消連附然後重新連附,將無法存取 NFS 伺服器,您可能會見到以下錯誤:"Protocol not supported"

如需詳細資訊,請參閱ATTACH_FILE_SYSTEM 程序

查詢 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_FILESDBMS_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 程序從 Autonomous AI Database 中的目錄分離檔案系統。

附註:

DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM 程序只能從專用端點上的資料庫切離專用檔案儲存服務。

您必須具備目錄物件的 WRITE 權限,才能從目錄位置切離檔案系統。

執行 DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM 程序,從 Autonomous AI Database 中的目錄位置分離檔案系統。若要執行此程序,您必須以 ADMIN 使用者身分登入,或具有 DBMS_CLOUD_ADMINEXECUTE 權限。
BEGIN
  DBMS_CLOUD_ADMIN.DETACH_FILE_SYSTEM (
    file_system_name      => 'NFS'                                       
  );END;                                                                          
/    

此範例會從 Autonomous AI Database 切離 file_system_name 參數中指定的網路檔案系統。您必須為此參數提供一個值。此檔案系統的資訊將從 DBA_CLOUD_FILE_SYSTEMS 視觀表中移除。

如需詳細資訊,請參閱DETACH_FILE_SYSTEM 程序