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

將資料匯出為 CSV 至目錄

顯示透過指定查詢，將 Autonomous Database 中的表格資料匯出至 CSV 資料目錄的步驟。

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

如需詳細資訊，請參閱連線至 Autonomous Database 。
建立目錄。
舉例而言：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
請參閱建立目錄以取得詳細資訊。
執行 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 參數。有效值為 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 程序。

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

如有需要，您可以提供的 query 參數可以是進階查詢，例如包含結合或子查詢的查詢。
以 compression 選項指定 format 參數以壓縮輸出檔案。

將資料匯出為 JSON 目錄

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

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

如需詳細資訊，請參閱連線至 Autonomous Database 。
建立目錄。
舉例而言：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
請參閱建立目錄以取得詳細資訊。
執行 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 參數。有效值為 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 程序。

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

如有需要，您可以提供的 query 參數可以是進階查詢，例如包含結合或子查詢的查詢。
以 compression 選項指定 format 參數以壓縮輸出檔案。

將資料匯出為 Parquet

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

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

如需詳細資訊，請參閱連線至 Autonomous Database 。
建立目錄。
舉例而言：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
請參閱建立目錄以取得詳細資訊。
執行 DBMS_CLOUD.EXPORT_DATA 並指定值為 json 的 format 參數 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 參數。有效值為 datapump、json、xml、csv 和 parquet，並且可選擇性地定義使用 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 Database 中的表格資料匯出至目錄作為 XML 資料的步驟。

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

如需詳細資訊，請參閱連線至 Autonomous Database 。
建立目錄。
舉例而言：
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
請參閱建立目錄以取得詳細資訊。
執行 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 參數。有效值為 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 程序。

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

如有需要，您可以提供的 query 參數可以是進階查詢，例如包含結合或子查詢的查詢。
以 compression 選項指定 format 參數以壓縮輸出檔案。