Options du format du package DBMS_CLOUD pour EXPORT_DATA

Décrit les options de paramètre de format valides pour DBMS_CLOUD.EXPORT_DATA avec les formats de fichier texte, CSV, JSON ou XML.

Il s'agit des paramètres format valides à utiliser avec DBMS_CLOUD.EXPORT_DATA. Vous indiquez une sortie de fichier texte lorsque vous utilisez l'option format type et que la valeur est l'une des suivantes : csv, json, parquet ou xml.

Les deux méthodes de spécification de l'argument de format sont :

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

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

Exemples :

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

Pour indiquer plusieurs options, séparez les valeurs par une valeur ",".

Exemple :

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

Ce tableau présente les options de format pour DBMS_CLOUD.EXPORT_DATA lorsque l'option de paramètre format type est l'une des suivantes : CSV, JSON, Parquet ou XML. Pour obtenir la liste des options de format, reportez-vous à Options de format de package DBMS_CLOUD.

Option de format Description Syntaxe

Option de format	Description	Syntaxe
`compression`	Spécifie le type de compression du fichier source. Remarque : Le format d'archivage ZIP n'est pas pris en charge. Lorsque `format type` est `csv`, `json` ou `xml`, la compression par défaut est NULL, ce qui signifie qu'il n'y a pas de compression. Lorsque `format type` est `parquet`, la compression par défaut est `snappy`.	Lorsque `type` est :`csv \| json \| xml` `compression: gzip` Valeur par défaut : valeur NULL : aucune compression. Lorsque `type` est défini sur `parquet` `compression: gzip \| snappy` Valeur par défaut : `snappy`
`delimiter`	Spécifie un délimiteur de champ personnalisé. `format => json_object('delimiter' value '\|')` La valeur du délimiteur ne peut pas être un code ASCII ou un caractère d'échappement. Remarque : cette option s'applique uniquement avec `csv type`.	`delimiter` : caractère Valeur par défaut , (virgule)
`endquote`	Indique que les champs peuvent être placés entre deux délimiteurs, `quote` et `endquote`. Si `endquote` n'est pas spécifié, le caractère `quote` est utilisé par défaut en tant que caractère `endquote`. Exemple : `format => JSON_OBJECT('quote' value '(' , 'endquote' value ')')` Remarque : cette option s'applique uniquement à `csv type`.	`endquote` : caractère Valeur par défaut : NULL, ce qui signifie non `endquote`.
`escape`	Spécifie l'occurrence du guillemet dans la valeur de champ à l'aide du caractère `"\\"`. Remarque : cette option s'applique uniquement à `csv type`.	`escape` `: true` Valeur par défaut : `false`
`encryption`	L'option de format `encryption` indique les options de cryptage et de décryptage permettant d'exporter et d'importer des données vers et depuis la banque d'objets. Utilisez `encryption` pour indiquer les paramètres suivants pour crypter et décrypter : `user_defined_function` : indique une fonction entièrement qualifiée définie par l'utilisateur pour décrypter ou crypter le BLOB spécifié (objet LOB binaire). Il renvoie un BLOB déchiffré ou chiffré. Ce paramètre est mutuellement exclusif avec d'autres paramètres pour `encryption`. Par exemple, `ADMIN.DECRYPTION_CALLBACK`. `type` : indique l'algorithme de cryptage intégré à décrypter ou à crypter. `user_defined_function` et `type` s'excluent mutuellement. `type` accepte les valeurs au format Algorithmes de cryptage de bloc + Modificateurs de chaînage de cryptage de bloc + Modificateurs de remplissage de cryptage de bloc. Les algorithmes de cryptage de bloc pris en charge sont les suivants : `DBMS_CRYPTO.ENCRYPT_AES256` Modificateurs de chaînage de chiffrement de bloc pris en charge : `DBMS_CRYPTO.CHAIN_CBC` `DBMS_CRYPTO.CHAIN_CFB` `DBMS_CRYPTO.CHAIN_ECB` `DBMS_CRYPTO.CHAIN_OFB` Modificateurs de remplissage de chiffrement de bloc pris en charge : `DBMS_CRYPTO.PAD_PKCS5` `DBMS_CRYPTO.PAD_NONE` `DBMS_CRYPTO.PAD_ZERO` `DBMS_CRYPTO.PAD_ORCL` `credential_name` : indique les informations d'identification utilisées pour stocker la clé de cryptage. Les valeurs par défaut des modificateurs de chaînage de chiffrement de bloc et des modificateurs de remplissage de chiffrement de bloc sont `DBMS_CRYPTO.CHAIN_CBC` et `DBMS_CRYPTO.PAD_PKCS5`, si vous n'indiquez pas de valeurs pour ces paramètres. L'option de format `encryption` est utilisée avec les procédures `DBMS_CLOUD` suivantes : Utilisé pour transmettre les paramètres de décryptage pour les procédures suivantes : `DBMS_CLOUD.COPY_DATA` `DBMS_CLOUD.CREATE_EXTERNAL_TABLE` `DBMS_CLOUD.CREATE_HYBRID_TABLE` `DBMS_CLOUD.COPY_COLLECTION` Utilisé pour transmettre les paramètres à crypter pour la procédure suivante : `DBMS_CLOUD.EXPORT_DATA` Exemple : `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` La valeur est une chaîne JSON qui fournit des paramètres supplémentaires pour le cryptage : `type` : valeur Spécifie le type de chiffrement. `credential_name`: `value` Indique les informations d'identification utilisées pour stocker la clé de cryptage. `user_defined_function: value` Spécifie une fonction entièrement qualifiée définie par l'utilisateur pour déchiffrer ou chiffrer le BLOB spécifié (objet volumineux binaire).
`header`	Ecrit les noms de colonne en tant que première ligne dans les fichiers de sortie de type `csv`. L'option `header` peut accepter une valeur `boolean` ou `string`. Les valeurs valides sont les suivantes : `false` : ignore la ligne d'en-tête. `true` : inclut la ligne d'en-tête. Les noms de colonne sont basés sur l'instruction `SELECT` du paramètre `query`. Vous devez indiquer des alias de colonne dans l'instruction `SELECT` lorsque vous utilisez des colonnes ou des expressions virtuelles. `String to define custom header names` : permet de définir des lignes d'en-tête avec des noms personnalisés. Le nombre de colonnes et de délimiteurs dans la valeur de chaîne doit correspondre au nombre de colonnes et de délimiteurs dans l'instruction `SELECT`. Le délimiteur par défaut est un virgule (,). Exemple : `format => JSON_OBJECT('type' value 'csv', 'delimiter' value '\|', 'compression' value 'gzip', 'header' value true)` Remarque : cette option s'applique uniquement avec `csv type`.	`header: true\| false\| String to define custom header names` Valeur par défaut : `false`
`fileextension`	Extension de fichier personnalisée pour remplacer le choix par défaut pour le type de format. Cela s'applique aux formats de texte avec `DBMS_CLOUD.EXPORT_DATA` : CSV, JSON, Parquet ou XML. Si la chaîne spécifiée ne commence pas par le point (point), un point est automatiquement inséré avant l'extension de fichier dans le nom de fichier final. Si aucune extension de fichier n'est souhaitée, utilisez la valeur : `fileextension` =`'none'`	Valeurs valides : toute extension de fichier. Valeur par défaut : dépend de l'option `format` `type` : Format CSV : `.csv` Format JSON : `.json` Format PARQUET : `.parquet` Format XML : `.xml`
`maxfilesize`	Nombre en octets pour la taille maximale de la sortie générée. Cela s'applique aux formats basés sur du texte pour l'exportation de données avec `DBMS_CLOUD.EXPORT_DATA` lorsque l'option `format` `type` est définie sur `csv`, `json` ou `xml`. Remarque : cette option n'est pas valide lorsque l'option `format` `type` est `parquet`.	Valeur minimale : `10485760` (10 Mo) Valeur maximale : 1 Go Valeur par défaut : `10485760` (10 Mo)
`quote`	Au format CSV, les champs peuvent être placés entre deux délimiteurs. Indiquez les délimiteurs avec `quote` et `endquote`. Si `endquote` n'est pas spécifié, le caractère `quote` est utilisé par défaut en tant que caractère `endquote`. Remarque : cette option s'applique uniquement avec `csv type`.	`quote` : caractère Valeur par défaut : la signification NULL ne place pas les champs entre guillemets.
`trimspaces`	Indique la façon dont les espaces de début et de fin sont tronqués pour le format CSV. Si le paramètre `quote` est spécifié, des espaces sont appliqués avant d'indiquer le champ. Reportez-vous à la description de trim_spec dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 26ai. Remarque : cette option s'applique uniquement avec `csv type`.	`trimspaces` : `rtrim\| ltrim\| notrim\| lrtrim\| ldrtrim` Valeur par défaut : `notrim`
`type`	Indique le type de fichier de sortie. `csv` : indique le format CSV (Valeurs séparées par des caractères) qui vous permet d'exporter des résultats de requête en tant qu'ensemble de valeurs de colonne séparées par un caractère personnalisé. `json` : indique d'exporter les résultats de requête en tant que fichiers JSON. `parquet` : indique d'exporter les résultats de la requête en tant que fichiers Parquet. `xml` : indique d'exporter les résultats de requête en tant que lignes de documents XML valides. Chaque ligne est encapsulée dans une balise XML racine de . Le résultat de la requête est automatiquement transformé en format XML à l'aide de la fonction SQL XMLFOREST. Utilisez les alias de colonne pour personnaliser les noms de balise XML des colonnes. Pour plus d'informations, reportez-vous à clause access_parameters dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 26ai.	`type`: `csv\|datapump\|json\|parquet\|xml`

compression

Spécifie le type de compression du fichier source.

Remarque : Le format d'archivage ZIP n'est pas pris en charge.

Lorsque format type est csv, json ou xml, la compression par défaut est NULL, ce qui signifie qu'il n'y a pas de compression.

Lorsque format type est parquet, la compression par défaut est snappy.

Lorsque type est :csv | json | xml

compression: gzip

Valeur par défaut : valeur NULL : aucune compression.

Lorsque type est défini sur parquet

compression: gzip | snappy

Valeur par défaut : snappy

delimiter

Spécifie un délimiteur de champ personnalisé.

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

La valeur du délimiteur ne peut pas être un code ASCII ou un caractère d'échappement.

Remarque : cette option s'applique uniquement avec csv type.

delimiter : caractère

Valeur par défaut , (virgule)

endquote

Indique que les champs peuvent être placés entre deux délimiteurs, quote et endquote. Si endquote n'est pas spécifié, le caractère quote est utilisé par défaut en tant que caractère endquote.

Exemple :

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

Remarque : cette option s'applique uniquement à csv type.

endquote : caractère

Valeur par défaut : NULL, ce qui signifie non endquote.

escape

Spécifie l'occurrence du guillemet dans la valeur de champ à l'aide du caractère "\\".

Remarque : cette option s'applique uniquement à csv type.

escape : true

Valeur par défaut : false

encryption

L'option de format encryption indique les options de cryptage et de décryptage permettant d'exporter et d'importer des données vers et depuis la banque d'objets.

Utilisez encryption pour indiquer les paramètres suivants pour crypter et décrypter :

user_defined_function : indique une fonction entièrement qualifiée définie par l'utilisateur pour décrypter ou crypter le BLOB spécifié (objet LOB binaire). Il renvoie un BLOB déchiffré ou chiffré. Ce paramètre est mutuellement exclusif avec d'autres paramètres pour encryption.
Par exemple, ADMIN.DECRYPTION_CALLBACK.
type : indique l'algorithme de cryptage intégré à décrypter ou à crypter. user_defined_function et type s'excluent mutuellement.
type accepte les valeurs au format Algorithmes de cryptage de bloc + Modificateurs de chaînage de cryptage de bloc + Modificateurs de remplissage de cryptage de bloc.
Les algorithmes de cryptage de bloc pris en charge sont les suivants :
- DBMS_CRYPTO.ENCRYPT_AES256
Modificateurs de chaînage de chiffrement de bloc pris en charge :
- DBMS_CRYPTO.CHAIN_CBC
- DBMS_CRYPTO.CHAIN_CFB
- DBMS_CRYPTO.CHAIN_ECB
- DBMS_CRYPTO.CHAIN_OFB
Modificateurs de remplissage de chiffrement de bloc pris en charge :
- DBMS_CRYPTO.PAD_PKCS5
- DBMS_CRYPTO.PAD_NONE
- DBMS_CRYPTO.PAD_ZERO
- DBMS_CRYPTO.PAD_ORCL

credential_name : indique les informations d'identification utilisées pour stocker la clé de cryptage.

Les valeurs par défaut des modificateurs de chaînage de chiffrement de bloc et des modificateurs de remplissage de chiffrement de bloc sont DBMS_CRYPTO.CHAIN_CBC et DBMS_CRYPTO.PAD_PKCS5, si vous n'indiquez pas de valeurs pour ces paramètres.

L'option de format encryption est utilisée avec les procédures DBMS_CLOUD suivantes :

Utilisé pour transmettre les paramètres de décryptage pour les procédures suivantes :
- DBMS_CLOUD.COPY_DATA
- DBMS_CLOUD.CREATE_EXTERNAL_TABLE
- DBMS_CLOUD.CREATE_HYBRID_TABLE
- DBMS_CLOUD.COPY_COLLECTION
Utilisé pour transmettre les paramètres à crypter pour la procédure suivante :
- DBMS_CLOUD.EXPORT_DATA

Exemple :

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

La valeur est une chaîne JSON qui fournit des paramètres supplémentaires pour le cryptage :

type : valeur

Spécifie le type de chiffrement.

credential_name: value

Indique les informations d'identification utilisées pour stocker la clé de cryptage.

user_defined_function: value

Spécifie une fonction entièrement qualifiée définie par l'utilisateur pour déchiffrer ou chiffrer le BLOB spécifié (objet volumineux binaire).

header

Ecrit les noms de colonne en tant que première ligne dans les fichiers de sortie de type csv.

L'option header peut accepter une valeur boolean ou string.

Les valeurs valides sont les suivantes :

false : ignore la ligne d'en-tête.
true : inclut la ligne d'en-tête. Les noms de colonne sont basés sur l'instruction SELECT du paramètre query. Vous devez indiquer des alias de colonne dans l'instruction SELECT lorsque vous utilisez des colonnes ou des expressions virtuelles.
String to define custom header names : permet de définir des lignes d'en-tête avec des noms personnalisés. Le nombre de colonnes et de délimiteurs dans la valeur de chaîne doit correspondre au nombre de colonnes et de délimiteurs dans l'instruction SELECT. Le délimiteur par défaut est un virgule (,).

Exemple :

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

Remarque : cette option s'applique uniquement avec csv type.

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

Valeur par défaut : false

fileextension

Extension de fichier personnalisée pour remplacer le choix par défaut pour le type de format. Cela s'applique aux formats de texte avec DBMS_CLOUD.EXPORT_DATA : CSV, JSON, Parquet ou XML.

Si la chaîne spécifiée ne commence pas par le point (point), un point est automatiquement inséré avant l'extension de fichier dans le nom de fichier final.

Si aucune extension de fichier n'est souhaitée, utilisez la valeur : fileextension ='none'

Valeurs valides : toute extension de fichier.

Valeur par défaut : dépend de l'option format type :

Format CSV : .csv
Format JSON : .json
Format PARQUET : .parquet
Format XML : .xml

maxfilesize

Nombre en octets pour la taille maximale de la sortie générée.

Cela s'applique aux formats basés sur du texte pour l'exportation de données avec DBMS_CLOUD.EXPORT_DATA lorsque l'option format type est définie sur csv, json ou xml.

Remarque : cette option n'est pas valide lorsque l'option format type est parquet.

Valeur minimale : 10485760 (10 Mo)

Valeur maximale : 1 Go

Valeur par défaut : 10485760 (10 Mo)

quote

Au format CSV, les champs peuvent être placés entre deux délimiteurs. Indiquez les délimiteurs avec quote et endquote. Si endquote n'est pas spécifié, le caractère quote est utilisé par défaut en tant que caractère endquote.

Remarque : cette option s'applique uniquement avec csv type.

quote : caractère

Valeur par défaut : la signification NULL ne place pas les champs entre guillemets.

trimspaces

Indique la façon dont les espaces de début et de fin sont tronqués pour le format CSV. Si le paramètre quote est spécifié, des espaces sont appliqués avant d'indiquer le champ.

Reportez-vous à la description de trim_spec dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 26ai.

Remarque : cette option s'applique uniquement avec csv type.

trimspaces : rtrim| ltrim| notrim| lrtrim| ldrtrim

Valeur par défaut : notrim

type

Indique le type de fichier de sortie.

csv : indique le format CSV (Valeurs séparées par des caractères) qui vous permet d'exporter des résultats de requête en tant qu'ensemble de valeurs de colonne séparées par un caractère personnalisé.

json : indique d'exporter les résultats de requête en tant que fichiers JSON.

parquet : indique d'exporter les résultats de la requête en tant que fichiers Parquet.

xml : indique d'exporter les résultats de requête en tant que lignes de documents XML valides. Chaque ligne est encapsulée dans une balise XML racine de .

Le résultat de la requête est automatiquement transformé en format XML à l'aide de la fonction SQL XMLFOREST. Utilisez les alias de colonne pour personnaliser les noms de balise XML des colonnes.

Pour plus d'informations, reportez-vous à clause access_parameters dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 26ai.

type: csv|datapump|json|parquet|xml

Contenu connexe

Procédure EXPORT_DATA