Options de format de l'ensemble DBMS_CLOUD
L'argument de format dans DBMS_CLOUD spécifie le format des fichiers sources.
Les deux façons de spécifier l'argument de format sont les suivantes :
format => '{"format_option" : "format_value" }'
et
format => json_object('format_option' value 'format_value')
Exemples :
format => json_object('type' VALUE 'CSV')
Pour spécifier plusieurs options de format, séparez les valeurs par un "," comme indiqué ci-dessous :
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true',
'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)
Note : Pour les options de format Avro, ORC ou Parquet, voir Options de format d'ensemble DBMS_CLOUD pour Avro, ORC ou Parquet.
Comme indiqué dans la colonne Option de format, un jeu limité d'options de format est valide avec DBMS_CLOUD.COPY_COLLECTION ou avec DBMS_CLOUD.COPY_DATA lorsque format type est JSON.
| Option de format | Description | Syntaxe |
|---|---|---|
blankasnull |
Lorsque cette option est réglée à true, les champs contenant des espaces sont chargés en tant que champs vides. |
Valeur par défaut : |
Valide avec |
Spécifie le jeu de caractères des fichiers sources |
Valeur par défaut : Jeu de caractères de base de données |
Utiliser uniquement avec |
Tableau d'expressions de chemin JSON correspondant aux champs à extraire des enregistrements JSON. Chacune des expressions de chemin JSON du tableau doit suivre les règles décrites dans Expressions de chemin SQL/JSON dans Oracle Database 19c JSON Developer's Guide ou Oracle Database 26ai JSON Developer's Guide. N'utilisez qu'avec le format JSON et |
Tableau JSON d'expressions de chemin json exprimées au format chaîne. Par exemple : Valeur 'columnpath' '["$.WEATHER_STATION_ID", "$.WEATHER_STATION_NAME"]' |
Option valide avec les données JSON |
Indique le type de compression du fichier source. Le format d'archivage ZIP n'est pas pris en charge. La spécification de la valeur |
Valeur par défaut : Valeur nulle signifiant aucune compression. |
conversionerrors |
Si une rangée est rejetée en raison d'erreurs de conversion de type de données, les colonnes connexes sont stockées comme nulles ou la rangée est rejetée. |
Valeur par défaut : |
dateformat |
Indique le format de date dans le fichier source. L'option de format J |
Valeur par défaut : Format de date de la base de données |
delimiter |
Spécifie le délimiteur de champ. Pour utiliser un caractère spécial comme délimiteur, spécifiez la valeur HEX du code ASCII du caractère. Par exemple, ce qui suit spécifie le caractère TAB comme délimiteur : |
Valeur par défaut |
detectfieldorder |
Indique que les champs des fichiers de données externes sont dans un ordre différent de celui des colonnes de la table. Détectez l'ordre des champs à l'aide de la première ligne de chaque fichier de données externe et mappez-le aux colonnes de la table. Les noms de champ des fichiers de données externes sont comparés de manière non sensible à la casse aux noms des colonnes de la table. Cette option de format s'applique aux procédures suivantes :
Restrictions pour
Pour plus d'informations, voir NOMS DU SERVICE APRÈS-VENTE dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 23ai et la description de |
Valeur par défaut : |
enablelogs |
L'option de format
Par exemple : format => JSON_OBJECT('enablelogs' value FALSE) |
Valeur par défaut : |
encryption |
L'option de format Utilisez
Les valeurs par défaut des modificateurs d'enchaînement de chiffrement par blocs et des modificateurs de remplissage de chiffrement par blocs sont L'option de format
Par 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:valueOù la valeur est une chaîne JSON qui fournit des paramètres supplémentaires pour le chiffrement :
Spécifie le type de chiffrement.
Spécifie les données d'identification utilisées pour stocker la clé de chiffrement. user_defined_function: valueSpécifie une fonction entièrement qualifiée définie par l'utilisateur pour déchiffrer ou chiffrer le BLOB spécifié (objet volumineux binaire). |
endquote |
Les données peuvent être placées entre deux délimiteurs, spécifiés avec Par exemple : format => JSON_OBJECT('quote' value '(', 'endquote' value ')') |
Valeur par défaut : Nul, ce qui signifie qu'il n'y a pas de |
escape |
Le caractère "\" est utilisé comme caractère d'échappement lorsqu'il est spécifié. |
Valeur par défaut : |
Option valide avec les données JSON |
Les lignes vides sont ignorées lorsque la valeur est true. |
Valeur par défaut : |
ignoremissingcolumns |
S'il y a plus de colonnes dans field_list que dans les fichiers sources, les colonnes supplémentaires sont stockées en tant que colonnes vides. |
Valeur par défaut |
Utiliser uniquement avec |
Chemin JSON permettant d'identifier le document à charger. Cette option n'est valide que pour les données de collecte JSON avec |
Valeur par défaut : Nul |
| `affectation de clé` Utiliser uniquement avec 'COPY_COLLECTION' |
Indique si une nouvelle collection est créée en tant que collection compatible mongo ou en tant que collection SODA. Lorsque la valeur est réglée à Par défaut, ce paramètre n'est pas défini, ce qui signifie qu'une nouvelle collection est créée en tant que collection SODA. |
Par défaut : |
Utiliser uniquement avec |
Spécifie un attribut dans les données à charger en tant que valeur Si Réglez la valeur à un chemin, par exemple Ce paramètre est facultatif et n'est valide que pour le chargement dans des collections compatibles mongo. S'il n'est pas spécifié, Oracle génère un ID système unique de 12 octets et l'alimente en tant qu'attribut |
Par défaut : Lorsque |
language |
Indique un nom de langue (par exemple, FRENCH), à partir duquel les informations sensibles aux paramètres régionaux peuvent être dérivées. |
Valeur par défaut : Nul Voir Locale Data (Données locales) dans le guide de prise en charge de la globalisation de base de données Oracle Database 19c ou le guide de prise en charge de la globalisation de base de données Oracle Database 23ai pour obtenir la liste des langues prises en charge par Oracle. |
logdir |
Spécifie une valeur de chaîne qui détermine le nom de l'objet de répertoire où les fichiers Par défaut, Par exemple :
L'option de format
L'option de format |
Valeur par défaut : |
logprefix |
Spécifie une valeur de chaîne qui détermine le préfixe des fichiers Le format du nom de la table de journaux est : logprefix Par défaut, le préfixe de journal est en majuscules, mais la casse est réservée lorsque la valeur spécifiée est encadrée de guillemets doubles. Par exemple : format => JSON_OBJECT ('logprefix' value 'TEST')Les fichiers journaux utilisent ensuite le préfixe |
Valeur par défaut : |
logretention |
Spécifie une durée entière positive, en jours, pour laquelle les fichiers Valeurs valides : Par exemple : format => JSON_OBJECT ('logretention' value 7) |
Valeur par défaut : |
Cette option n'est valide qu'avec des données JSON |
Taille maximale des documents JSON. |
Valeur par défaut : 1 mégaoctet Valeur maximale autorisée : 2 gigaoctets |
numericcharacters |
Spécifie les caractères à utiliser en tant que séparateur de groupe et caractère décimal. Décimal_caractère : La décimale sépare la partie entière d'un nombre de la partie décimale. group_separator : Le séparateur de groupe sépare les groupes entiers (c'est-à-dire des milliers, des millions, des milliards, etc.). |
Valeur par défaut : Pour plus d'informations, voir NLS_NUMERIC_CHARACTERS Guide de prise en charge de la globalisation de base de données pour Oracle Database 19c Guide de prise en charge de la globalisation de base de données pour Oracle Database 23ai. |
numberformat |
Spécifie le modèle de format numérique. Avec les modèles de format numérique, le nombre est arrondi au nombre spécifié de chiffres significatifs. Un modèle de format numérique est composé d'un ou plusieurs éléments de format numérique. Il est utilisé conjointement avec |
Valeur par défaut : est dérivée du paramètre Pour plus d'informations, voir Modèles de format numérique dans Informations de référence sur le langage SQL pour Oracle Database 19c ou Informations de référence sur le langage SQL pour Oracle Database 23ai. |
partition_columns |
L'option de format
Si les fichiers de données ne sont pas structurés et que la sous-clause Pour les noms d'objet qui ne sont pas basés sur le format de ruche, l'ordre des colonnes spécifiées par |
|
quote |
Spécifie le caractère de guillemet pour les champs. Les caractères quote sont supprimés lors du chargement lorsqu'ils sont spécifiés. |
Valeur par défaut : Nul signifiant aucun guillemet |
Option valide avec les données JSON |
Spécifie le délimiteur d'enregistrement. Par défaut, Spécifiez cet argument explicitement si vous souhaitez remplacer le comportement par défaut, par exemple : Pour indiquer qu'il n'y a pas de délimiteur d'enregistrement, vous pouvez spécifier une valeur
|
Valeur par défaut : newline détectée |
regexuri |
L'option de format
Lorsque la valeur de Les caractères "*" et "?" sont considérés comme des caractères génériques lorsque le paramètre Les modèles d'expression rationnelle ne sont pris en charge que pour le nom de fichier ou le chemin du sous-dossier dans vos URI et la correspondance de modèle est identique à celle effectuée par la fonction Pour les tables externes, cette option n'est prise en charge qu'avec les tables créées dans un fichier du stockage d'objets. Par exemple :
Voir Condition REGEXP_LIKE dans Informations de référence sur le langage SQL pour Oracle Database 19c ou Informations de référence sur le langage SQL pour Oracle Database 23ai pour plus d'informations sur la condition |
Valeur par défaut : |
rejectlimit |
L'opération échoue après le rejet du nombre spécifié de rangées. |
Valeur par défaut : |
removequotes |
Supprime les guillemets qui encadrent tout champ du fichier source. |
Valeur par défaut : |
skipheaders |
Indique combien de rangées doivent être ignorées à partir du début du fichier. |
Valeur par défaut : 0 s'il n'est pas spécifié, 1 s'il est spécifié sans valeur |
territory |
Indique un nom de territoire pour déterminer plus précisément les caractéristiques des données d'entrée. |
Valeur par défaut : Nul Voir Locale Data (Données locales) dans le guide de prise en charge de la globalisation de base de données Oracle Database 19c ou le guide de prise en charge de la globalisation de base de données Oracle Database 23ai pour obtenir la liste des langues prises en charge par Oracle. |
timestampformat |
Précise le format de l'horodatage dans le fichier source. L'option de format YYYY-MM-DD HH:MI:SS.FF |
Valeur par défaut : Format d'horodatage de la base de données La chaîne peut contenir des caractères génériques tels que "$". |
timestampltzformat |
Indique l'horodatage avec le format de fuseau horaire local dans le fichier source. L'option de format DD Mon YYYY HH:MI:SS.FF TZR |
Valeur par défaut : Horodatage de la base de données au format de fuseau horaire local |
timestamptzformat |
Indique l'horodatage avec le format de fuseau horaire dans le fichier source. L'option de format DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR |
Valeur par défaut : Horodatage de la base de données avec format de fuseau horaire |
trimspaces |
Indique la façon dont les espaces de début et de fin des champs sont tronqués. Voir la description de trim_spec dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 23ai. |
Valeur par défaut : |
truncatecol |
Si les données du fichier sont trop longues pour un champ, cette option tronque la valeur du champ plutôt que de rejeter la rangée. |
Valeur par défaut : |
type |
Indique le type de fichier source. Voir la description de CSV dans Utilitaires Oracle Database 19c ou Utilitaires Oracle Database 23ai. Si If the Voir Options de format d'ensemble DBMS_CLOUD pour Avro, ORC ou Parquet pour les valeurs Pour les données JSON avec Pour les données JSON avec
|
Note : Les procédures
Valeur par défaut : Nul Pour les données JSON, il existe deux valeurs |
Utiliser uniquement avec |
Lorsque cette option est réglée à Lorsque cette option est réglée à Cette option n'est valide que pour les données de collecte JSON avec |
Valeur par défaut : |