DBMS_CATALOG 套裝程式

DBMS_CATALOG 套裝程式包含廣泛的目錄管理子程式，依功能分組。

• 目錄掛載與卸載

  您可以藉由掛載現有連線 (例如資料庫的現有資料庫連結)，或新增連線並將外部系統註冊為新目錄，將新目錄新增至 Oracle Autonomous AI Database 。

  附註：

  建立或更新目錄時，只能使用字母、數字和底線來指定這些特性 -- 目錄名稱、資料庫連結名稱、綱要名稱、表格名稱和資料欄名稱。這些不區分大小寫，不支援多位元組字元。

  您可以啟用或停用目錄。

  附註：

  停用的目錄會保留連線詳細資訊和所有目前的描述資料，但不會更新，而且無法從 UI 或 API 存取。

  從您的 Autonomous AI Database 中移除或分離目錄。

• 型錄館別管理
  此處提及的子程式可讓您擷取和更新系統中目錄、綱要和表格的各種特性。具體而言，它提供下列功能：

  • 取得目錄、綱要或表格的特性值，包括透過 CLOB 格式處理大型文字值的選項。

  • 更新目錄、綱要或表格的特性值，並支援一般和 CLOB 資料類型。

• 證明資料管理
  已掛載的目錄將會有零或多個必要的證明資料。這些是必須先指定的證明資料，才能使用目錄。例如，Apache Iceberg 目錄通常有兩個必要的認證。

  • ICEBERG_CREDENTIAL：用來呼叫 Iceberg REST 目錄端點的證明資料。這通常是 Bearer 權杖證明資料。
  • DATA_STORAGE_CREDENTIAL：用來存取儲存桶中 Iceberg 檔案的證明資料。
  您可以將必要的證明資料想像成需要指定的參數。本機證明資料是使用者綱要中的實際 CREDENTIAL 物件，可扮演其中一個必要證明資料的角色。當您掛載目錄時，可以使用 DBMS_CATALOG.MOUNT_ICEBERG 中的引數 (例如 catalog_credential 和 data_storage_credential)，指定本機證明資料。您也可以稍後呼叫 SET_LOCAL_CREDENTIAL 來指定它們。

  BEGIN
    -- Create a new credential
    DBMS_CLOUD.CREATE_CREDENTIAL('BUCKET_CREDENTIAL', ...);
  
    -- Make the new credential play the role of the required 'DATA_STORAGE_CREDENTIAL'
    DBMS_CATALOG.SET_LOCAL_CREDENTIAL(
      catalog_name => 'iceberg_cat',
      required_credential => 'DATA_STORAGE_CREDENTIAL',
      local_credential => 'BUCKET_CREDENTIAL');
  END;    

  您可以使用 GET_LOCAL_CREDENTIAL_MAP 函數查看必要和本機證明資料之間的目前對應。

  SELECT
     JSON_QUERY(dbms_catalog.get_local_credential_map('iceberg_cat'), '$' PRETTY)
  FROM dual;
    2    3  
  JSON_QUERY(DBMS_CATALOG.GET_LOCAL_CREDENTIAL_MAP('ICEBERG_CAT'),'$'PRETTY)
  ------------------------------------------------------------------------------------------------------------------------
  {
    "DATA_STORAGE_CREDENTIAL" : "BUCKET_CREDENTIAL",
    "ICEBERG_CREDENTIAL" : "UNITY_CRED"
  }

• 型錄實體管理
  此處列出的子程式是指管理目錄中的各種實體，包括建立、擷取及刪除儲存體連結、綱要、表格及其他目錄物件。它提供下列功能：

  • 建立及刪除連結至目錄的雲端儲存連結。

  • 建立及刪除目錄內的外部表格。

  • 建立及刪除綱要及其內容。

  • 使用選擇性篩選擷取表格、綱要以及其他目錄物件的清單。

• 資料存取與快取
  本節包含處理查詢資料、管理結果游標以及控制目錄內描述資料快取的函數。它包含下列功能：

  • 使用可自訂的選項產生邏輯表格的 SELECT 敘述句。

  • 開啟游標以從邏輯表格擷取資料。

  • 清除並預先填入目錄的描述資料快取，讓資料保持在最新狀態。

• 同步與共用
  本節列出子程式說明的功能，這些功能可以管理和維護不同系統或環境間的一致、最新的目錄和綱要。它提供以下功能：

  • CREATE_SYNCHRONIZED_SCHEMAS：在與遠端目錄定義同步的資料庫上建立本機綱要，確保本機環境反映遠端來源。
  • DROP_SYNCHRONIZED_SCHEMAS：移除一或多個先前已同步的綱要。
  • UPDATE_SYNCHRONIZED_SCHEMA_PROPERTY：使用 CLOB 格式的新值更新特性，以修改同步化綱要的特性，例如變更追蹤或同步化行為。
  • GRANT_TO_RECIPIENT 和 REVOKE_FROM_RECIPIENT：透過授予或撤銷特定共用收件者對目錄的存取權，控制誰可以檢視或修改目錄資料來管理存取權限。

  ​