使用 DBMS_CLOUD.EXPORT_DATA 將資料匯出至目錄

使用 DBMS_CLOUD.EXPORT_DATA 將檔案匯出至目錄。

您匯出檔案的目錄可以在「自治式 AI 資料庫」檔案系統或連附的外部檔案系統中。請參閱下列頁面以瞭解詳細資訊：

• 建立及管理目錄

• 將網路檔案儲存連附至自治式 AI 資料庫

• 將外部檔案儲存連附至自治式 AI 資料庫

將 CSV 的資料匯出到目錄

顯示透過指定查詢，將表格資料從您的自治式 AI 資料庫匯出至目錄作為 CSV 資料的步驟。

1. 連線至您的自治式 AI 資料庫執行處理。

   請參閱連線至自治式 AI 資料庫以瞭解詳細資訊。

2. 建立目錄。

   舉例而言：

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   請參閱建立目錄以瞭解詳細資訊。

3. 執行 DBMS_CLOUD.EXPORT_DATA 並指定 format 參數 type 與值 json，以將結果匯出為 CSV 檔案至目錄。將輸出傳送至目錄時，請勿包含 credential 參數。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   當記錄分隔符號包含逸出字元 (例如 \r\n 或 \t) 時，請以雙引號括住記錄分隔符號。例如，若要使用記錄分隔符號 \r\n，請以雙引號括住值："\r\n"。

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /
   

   當目錄名稱以雙引號括住時，目錄名稱會區分大小寫。舉例而言：

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

   如需可與 DBMS_CLOUD.EXPORT_DATA 搭配使用之可用 format 參數的詳細資訊，請參閱 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

   參數包括：

   • file_uri_list：以逗號分隔的匯出檔案清單。file_uri_list 中不支援使用萬用字元和替代字元。

   • format：指定必要的 type 參數。有效值為 json、xml 和 csv。

   • query：指定 SELECT 陳述式，以便只匯出必要的資料。查詢決定傾印檔的內容。

   注意：DBMS_CLOUD.EXPORT_DATA 程序會建立您在 file_uri_list 中指定的傾印檔。程序不會覆寫檔案。如果 file_uri_list 中的傾印檔存在，DBMS_CLOUD.EXPORT_DATA 會產生另一個具有唯一名稱的檔案。DBMS_CLOUD.EXPORT_DATA 不會建立目錄。

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 匯出的注意事項：

• 您提供的 query 參數可以是進階查詢 (如有需要)，例如包含結合或子查詢的查詢。

• 使用 compression 選項指定 format 參數以壓縮輸出檔案。

將資料匯出為 JSON 目錄

顯示透過指定查詢，將表格資料從自治式 AI 資料庫匯出至目錄作為 JSON 資料的步驟。

1. 連線至您的自治式 AI 資料庫執行處理。

   請參閱連線至自治式 AI 資料庫以瞭解詳細資訊。

2. 建立目錄。

   舉例而言：

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   請參閱建立目錄以瞭解詳細資訊。

3. 執行 DBMS_CLOUD.EXPORT_DATA 並指定 format 參數 type 與值 json，以將結果匯出為 JSON 檔案至目錄。將輸出傳送至目錄時，請勿包含 credential 參數。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   當記錄分隔符號包含逸出字元 (例如 \r\n 或 \t) 時，請以雙引號括住記錄分隔符號。例如，若要使用記錄分隔符號 \r\n，請以雙引號括住值："\r\n"。

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /
   

   當目錄名稱以雙引號括住時，目錄名稱會區分大小寫。舉例而言：

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

   如需可與 DBMS_CLOUD.EXPORT_DATA 搭配使用之可用 format 參數的詳細資訊，請參閱 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

   參數包括：

   • file_uri_list：以逗號分隔的匯出檔案清單。file_uri_list 中不支援使用萬用字元和替代字元。

   • format：指定必要的 type 參數。有效值為 json、xml 和 csv。

   • query：指定 SELECT 陳述式，以便只匯出必要的資料。查詢決定傾印檔的內容。

   注意：DBMS_CLOUD.EXPORT_DATA 程序會建立您在 file_uri_list 中指定的傾印檔。程序不會覆寫檔案。如果 file_uri_list 中的傾印檔存在，DBMS_CLOUD.EXPORT_DATA 會產生另一個具有唯一名稱的檔案。DBMS_CLOUD.EXPORT_DATA 不會建立目錄。

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 匯出的注意事項：

• 您提供的 query 參數可以是進階查詢 (如有需要)，例如包含結合或子查詢的查詢。

• 使用 compression 選項指定 format 參數以壓縮輸出檔案。

將資料匯出為 Parquet 到目錄

顯示透過指定查詢，將表格資料從您的自治式 AI 資料庫匯出至目錄作為 Parquet 資料的步驟。

1. 連線至您的自治式 AI 資料庫執行處理。

   請參閱連線至自治式 AI 資料庫以瞭解詳細資訊。

2. 建立目錄。

   舉例而言：

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   請參閱建立目錄以瞭解詳細資訊。

3. 執行 DBMS_CLOUD.EXPORT_DATA 並指定 format 參數 type 與值 json，以將結果匯出為 Parquet 檔案至目錄。將輸出傳送至目錄時，請勿包含 credential 參數。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   當目錄名稱以雙引號括住時，目錄名稱會區分大小寫。舉例而言：

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

   如需可與 DBMS_CLOUD.EXPORT_DATA 搭配使用之可用 format 參數的詳細資訊，請參閱 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

   參數包括：

   • file_uri_list：以逗號分隔的匯出檔案清單。file_uri_list 中不支援使用萬用字元和替代字元。

   • format：指定必要的 type 參數。有效值為 datapump、json、xml、csv 和 parquet，也可以選擇性地定義您可使用「ORACLE_DATAPUMP 存取驅動程式」為匯出指定的選項。

   • query：指定 SELECT 陳述式，以便只匯出必要的資料。查詢決定傾印檔的內容。

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 匯出的注意事項：

• 您提供的 query 參數可以是進階查詢 (如有需要)，例如包含結合或子查詢的查詢。

• 使用 compression 選項指定 format 參數以壓縮輸出檔案。

• 請參閱 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping ，瞭解 Oracle Type to Parquet Type 對映的詳細資訊。

  不支援下列類型，或支援以 DBMS_CLOUD.EXPORT_DATA 匯出 Parquet 的限制：

  Oracle 類型	備註
  BFILE	不支援
  BLOB	不支援
  DATE	支援下列限制：DATE 格式僅支援日期、月份及年度。不支援小時、分鐘和秒。 請參閱 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping ，瞭解將 DATE 匯出至 Parquet 的 NLS 格式限制詳細資訊。
  INTERVAL DAY TO SECOND	支援並被視為內部字串
  INTERVAL YEAR TO MONTH	支援並被視為內部字串
  LONG	不支援
  LONG RAW	不支援
  NUMBER	支援下列限制： - 最大精確度為 38 且小數位數等於小數位數。 - 如果未提供資料欄 NUMBER 類型的小數位數與小數位數，則預設使用小數位數為 38 且小數位數為 20。 - NUMBER 類型不支援負數小數位數。
  Object Types	不支援
  TIMESTAMP	支援下列限制： - 如果有多個不同精確度的資料欄，將採用最高精確度。 - TIMESTAMP WITH TIME ZONE Oracle 資料類型將只使用時戳。 請參閱 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping ，瞭解將 TIMESTAMP 匯出至 Parquet 的 NLS 格式限制詳細資訊。

將資料匯出為 XML 至目錄

顯示透過指定查詢，將表格資料從「自治式 AI 資料庫」匯出至「目錄」作為 XML 資料的步驟。

1. 連線至您的自治式 AI 資料庫執行處理。

   請參閱連線至自治式 AI 資料庫以瞭解詳細資訊。

2. 建立目錄。

   舉例而言：

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   請參閱建立目錄以瞭解詳細資訊。

3. 執行 DBMS_CLOUD.EXPORT_DATA 並指定 format 參數 type 與值 json，以將結果匯出為 XML 檔案至目錄。將輸出傳送至目錄時，請勿包含 credential 參數。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   當目錄名稱以雙引號括住時，目錄名稱會區分大小寫。舉例而言：

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.xml',
        format => JSON_OBJECT('type' value 'xml'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

   如需可與 DBMS_CLOUD.EXPORT_DATA 搭配使用之可用 format 參數的詳細資訊，請參閱 DBMS_CLOUD Package Format Options for EXPORT_DATA 。

   參數包括：

   • file_uri_list：以逗號分隔的匯出檔案清單。file_uri_list 中不支援使用萬用字元和替代字元。

   • format：指定必要的 type 參數。有效值為 json、xml 和 csv。

   • query：指定 SELECT 陳述式，以便只匯出必要的資料。查詢決定傾印檔的內容。

   注意：DBMS_CLOUD.EXPORT_DATA 程序會建立您在 file_uri_list 中指定的傾印檔。程序不會覆寫檔案。如果 file_uri_list 中的傾印檔存在，DBMS_CLOUD.EXPORT_DATA 會產生另一個具有唯一名稱的檔案。DBMS_CLOUD.EXPORT_DATA 不會建立目錄。

   如需有關參數的詳細資訊，請參閱 EXPORT_DATA Procedure 。

使用 DBMS_CLOUD.EXPORT_DATA 匯出的注意事項：

• 您提供的 query 參數可以是進階查詢 (如有需要)，例如包含結合或子查詢的查詢。

• 使用 compression 選項指定 format 參數以壓縮輸出檔案。

相關內容

• 匯出資料程序

• EXPORT_DATA 的 DBMS_CLOUD 套裝程式格式選項