EXPORT_DATA 的 DBMS_CLOUD 套裝程式格式選項

描述文字檔格式、CSV、JSON 或 XML 之 DBMS_CLOUD.EXPORT_DATA 的有效格式參數選項。

這些是與 DBMS_CLOUD.EXPORT_DATA 搭配使用的有效 format 參數。當您使用 format type 選項，且值為下列其中之一時，可指定文字檔輸出：csv、json、parquet 或 xml。

指定格式引數的兩種方式如下：

format => '{"format_option" : "format_value" }'

和

format => json_object('format_option' value 'format_value')

範例：

format => json_object('type' VALUE 'json')

若要指定多個格式選項，請以 "," 分隔值。

舉例而言：

format => json_object('compression' value 'gzip', 'type' value 'json')

此表格涵蓋 format 參數 type 選項為下列其中之一時，DBMS_CLOUD.EXPORT_DATA 的格式選項：CSV、JSON、Parquet 或 XML。如需其他程序與其他輸出類型，請參閱 DBMS_CLOUD Package Format Options 以取得格式選項清單。

格式選項 描述 語法
compression

指定來源檔案的壓縮類型。

備註：不支援 ZIP 封存格式。

當 format type 為 csv、json 或 xml 時，預設壓縮為 Null，表示不壓縮。

當 format type 為 parquet 時，預設壓縮為 snappy。

當 type 為：csv | json | xml 時

compression: gzip

預設值：空值表示沒有壓縮。

當 type 為 parquet 時

compression: gzip | snappy

預設值：snappy
delimiter

指定自訂欄位分隔符號。

format => json_object('delimiter' value '|')

分界字元值不可為 ASCII 代碼或遁離字元。

注意：此選項僅適用於 csv type。

delimiter ：字元

預設值 (逗號)

endquote

指定欄位可以用 quote 和 endquote 括在兩個分隔符號之間。如果未指定 endquote，則預設會使用 quote 字元作為 endquote 字元。

舉例而言：

format => JSON_OBJECT('quote' value '(' , 'endquote' value ')')

注意：此選項僅適用於 csv type。

endquote：字元

預設值：空值，表示沒有 endquote。

escape

使用 "\\" 字元在欄位值中指定引號字元的出現位置。

注意：此選項僅適用於 csv type。

escape : true

預設值：false
encryption

格式選項 encryption 指定加密和解密選項，以匯出和匯入物件存放區的資料。

使用 encryption 來指定下列要加密和解密的參數：

  • user_defined_function：指定完整的使用者定義函數，以解密或加密指定的 BLOB (二進位大型物件)。它會傳回已解密或已加密的 BLOB。此參數與其他 encryption 的參數互斥。

    例如，ADMIN.DECRYPTION_CALLBACK。

  • type：指定要解密或加密的內建加密演算法。user_defined_function 和 type 互斥。

    type 接受「區塊加密演算法 + 區塊加密鏈結修飾條件 + 區塊加密填補修飾條件」格式的值。

    支援的區塊加密演算法如下：

    • DBMS_CRYPTO.ENCRYPT_AES256

    支援的區塊加密鏈結修飾條件如下：

    • DBMS_CRYPTO.CHAIN_CBC

    • DBMS_CRYPTO.CHAIN_CFB

    • DBMS_CRYPTO.CHAIN_ECB

    • DBMS_CRYPTO.CHAIN_OFB

    支援的區塊加密填補修飾條件為：

    • DBMS_CRYPTO.PAD_PKCS5

    • DBMS_CRYPTO.PAD_NONE

    • DBMS_CRYPTO.PAD_ZERO

    • DBMS_CRYPTO.PAD_ORCL

  • credential_name：指定用來儲存加密金鑰的證明資料。

如果您未指定這些參數的值，則「區塊加密鏈結修飾條件」和「區塊加密填補修飾條件」值會預設為 DBMS_CRYPTO.CHAIN_CBC 和 DBMS_CRYPTO.PAD_PKCS5。

格式選項 encryption 可搭配下列 DBMS_CLOUD 程序使用：

  • 用於傳送參數以解密這些程序：

    • DBMS_CLOUD.COPY_DATA

    • DBMS_CLOUD.CREATE_EXTERNAL_TABLE

    • DBMS_CLOUD.CREATE_HYBRID_TABLE

    • DBMS_CLOUD.COPY_COLLECTION

  • 用來傳送參數以加密下列程序：

    • DBMS_CLOUD.EXPORT_DATA

舉例而言：

format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED')) 		encryption:value

其中值是提供額外加密參數的 JSON 字串：

type：值

指定加密類型。

credential_name: value

指定用來儲存加密金鑰的證明資料。

user_defined_function: value

指定完整的使用者定義函數，以解密或加密指定的 BLOB (二進位大型物件)。
header

將資料欄名稱寫入為 csv 類型輸出檔案中的第一行。

header 選項可以接受 boolean 或 string 值。

有效值為：

  • false：略過標頭資料列。

  • true：包含標頭資料列。資料欄名稱是以 query 參數中的 SELECT 敘述句為基礎。使用虛擬資料欄或表示式時，您必須在 SELECT 敘述句中指定資料欄別名。

  • String to define custom header names：可讓您以自訂名稱定義標頭資料列。字串值中的欄數和分隔符號必須符合 SELECT 陳述式中的欄數和分隔符號。預設分隔符號為逗號 (，)。

舉例而言：

format => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true)

注意：此選項僅適用於 csv type。

header: true| false| String to define custom header names

預設值：false
fileextension

覆寫格式類型預設選項的自訂副檔名。這適用於含有 DBMS_CLOUD.EXPORT_DATA 的文字格式：CSV、JSON、Parquet 或 XML。

如果指定的字串不是以句點 (點) 開頭，則會在最終檔案名稱的副檔名前面自動插入點。

如果不需要副檔名，請使用值：fileextension ='none'

有效值：任何副檔名。

預設值：視 format type 選項而定：

  • CSV 格式：.csv
  • JSON 格式：.json
  • PARQUET 格式：.parquet
  • XML 格式：.xml
maxfilesize

產生的輸出大小上限 (位元組)。

這適用於將 format type 選項設為 csv、json 或 xml 時，使用 DBMS_CLOUD.EXPORT_DATA 匯出資料的文字格式。

注意：當 format type 選項為 parquet 時，此選項無效。

最小值：10485760 (10 MB)

最大值：1 GB

預設值：10485760 (10 MB)

quote

在 CSV 格式中，欄位可以放在兩個分隔符號之間。指定含有 quote 和 endquote 的分界字元。如果未指定 endquote，則預設會使用 quote 字元作為 endquote 字元。

注意：此選項僅適用於 csv type。

quote：字元

預設值：空值表示不將欄位括在引號中。
trimspaces

指定如何裁剪 CSV 格式的欄位前端與尾端空格。如果指定 quote 參數，則會在引用欄位前套用修剪空格。

請參閱 Oracle Database 19c Utilities 或 Oracle Database 26ai Utilities 中的 trim_spec 描述。

注意：此選項僅適用於 csv type。

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

預設值：notrim
type

指定輸出檔案類型。

csv：指定「字元分隔值 (CSV)」格式，可讓您將查詢結果匯出為以任何自訂字元分隔的一組資料欄值。

json：指定將查詢結果匯出為 JSON 檔案。

parquet：指定將查詢結果匯出為 Parquet 檔案。

xml：指定將查詢結果匯出為有效 XML 文件的資料列。每個資料列都會封裝在 的根 XML 標記中。

使用 XMLFOREST SQL 函數的查詢結果會自動轉換為 XML 格式。使用資料欄別名來自訂資料欄的 XML 標記名稱。

請參閱 Oracle Database 19c Utilities 或 Oracle Database 26ai Utilities 中的 access_parameters 子句瞭解詳細資訊。

type: csv|datapump|json|parquet|xml

相關內容

匯出資料程序