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

使用 DBMS_CLOUD.EXPORT_DATA 將檔案匯出至目錄。
您匯出檔案的目錄可以在 Autonomous AI Database 檔案系統或附加的外部檔案系統中。請參閱下列頁面以瞭解詳細資訊:

將資料匯出為 CSV 至目錄

顯示透過指定查詢,將表格資料從您的 Autonomous AI Database 匯出至目錄作為 CSV 資料的步驟。

  1. 連線到您的 Autonomous AI Database 執行處理。

    如需詳細資訊,請參閱連線至 Autonomous AI Database

  2. 建立目錄。

    舉例而言:

    CREATE DIRECTORY export_dir AS 'export_dir';
    請參閱建立目錄以取得詳細資訊。
  3. 執行 DBMS_CLOUD.EXPORT_DATA 並使用 json 值指定 format 參數 type,以將結果匯出為 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 程序

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

    參數包括:

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

    • format:指定必要的 type 參數。有效值為 jsonxmlcsv

    • query:指定 SELECT 敘述句,以便只匯出必要的資料。此查詢決定傾印檔的內容。

    附註:

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

    如需有關參數的詳細資訊,請參閱 EXPORT_DATA 程序

使用 DBMS_CLOUD.EXPORT_DATA 進行匯出的注意事項:

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

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

將資料匯出為 JSON 目錄

顯示透過指定查詢,將表格資料從 Autonomous AI Database 匯出至目錄作為 JSON 資料的步驟。

  1. 連線到您的 Autonomous AI Database 執行處理。

    如需詳細資訊,請參閱連線至 Autonomous AI Database

  2. 建立目錄。

    舉例而言:

    CREATE DIRECTORY export_dir AS 'export_dir';
    請參閱建立目錄以取得詳細資訊。
  3. 執行 DBMS_CLOUD.EXPORT_DATA 並使用 json 值指定 format 參數 type,以將結果匯出為 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 程序

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

    參數包括:

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

    • format:指定必要的 type 參數。有效值為 jsonxmlcsv

    • query:指定 SELECT 敘述句,以便只匯出必要的資料。此查詢決定傾印檔的內容。

    附註:

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

    如需有關參數的詳細資訊,請參閱 EXPORT_DATA 程序

使用 DBMS_CLOUD.EXPORT_DATA 進行匯出的注意事項:

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

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

將資料匯出為 Parquet

顯示透過指定查詢,將表格資料從您的 Autonomous AI Database 匯出至目錄作為 Parquet 資料的步驟。

  1. 連線到您的 Autonomous AI Database 執行處理。

    如需詳細資訊,請參閱連線至 Autonomous AI Database

  2. 建立目錄。

    舉例而言:

    CREATE DIRECTORY export_dir AS 'export_dir';
    請參閱建立目錄以取得詳細資訊。
  3. 執行 DBMS_CLOUD.EXPORT_DATA 並指定值為 jsonformat 參數 type,以將結果匯出為 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 程序

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

    參數包括:

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

    • format:指定必要的 type 參數。有效值為 datapumpjsonxmlcsvparquet,並且可選擇性地定義使用 ORACLE_DATAPUMP 存取驅動程式為匯出指定的選項。

    • query:指定 SELECT 敘述句,以便只匯出必要的資料。此查詢決定傾印檔的內容。

    如需有關參數的詳細資訊,請參閱 EXPORT_DATA 程序

使用 DBMS_CLOUD.EXPORT_DATA 進行匯出的注意事項:

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

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

  • 請參閱 DBMS_CLOUD 將 Oracle 資料類型封裝至 Parquet 對應,瞭解 Oracle 類型與 Parquet 類型對應的詳細資訊。

    不支援下列類型,或限制使用 DBMS_CLOUD.EXPORT_DATA 匯出 Parquet 的支援:

    Oracle 類型 備註

    BFILE

    不支援

    BLOB

    不支援

    DATE

    支援下列限制:DATE 格式僅支援日期、月份及年度。不支援小時、分鐘和秒。

    如需將 DATE 匯出至 Parquet 之 NLS 格式限制的詳細資訊,請參閱 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping

    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 資料類型只會使用時戳。

    如需將 TIMESTAMP 匯出至 Parquet 之 NLS 格式限制的詳細資訊,請參閱 DBMS_CLOUD Package Oracle Data Type to Parquet Mapping

將資料匯出為 XML 至目錄

顯示透過指定查詢,將表格資料從 Autonomous AI Database 匯出至 Directory 作為 XML 資料的步驟。

  1. 連線到您的 Autonomous AI Database 執行處理。

    如需詳細資訊,請參閱連線至 Autonomous AI Database

  2. 建立目錄。

    舉例而言:

    CREATE DIRECTORY export_dir AS 'export_dir';
    請參閱建立目錄以取得詳細資訊。
  3. 執行 DBMS_CLOUD.EXPORT_DATA 並使用 json 值指定 format 參數 type,以將結果匯出為 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 程序

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

    參數包括:

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

    • format:指定必要的 type 參數。有效值為 jsonxmlcsv

    • query:指定 SELECT 敘述句,以便只匯出必要的資料。此查詢決定傾印檔的內容。

    附註:

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

    如需有關參數的詳細資訊,請參閱 EXPORT_DATA 程序

使用 DBMS_CLOUD.EXPORT_DATA 進行匯出的注意事項:

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

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