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 une ",
".
Par exemple :
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 plus d'informations sur les options de format Avro, ORC ou Parquet, voir DBMS_CLOUD Options de format de l'ensemble 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 la valeur de format
type
est JSON.
Option de formatage | Description | Syntaxe |
---|---|---|
|
Lorsque cette option est réglée à |
Valeur par défaut : |
Valable avec le |
Spécifie le jeu de caractères des fichiers sources |
Valeur par défaut : Jeu de caractères de la base de données |
À utiliser uniquement avec le |
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 23ai JSON Developer's Guide. À utiliser uniquement avec le format JSON et |
Tableau JSON d'expressions de chemin json exprimées au format chaîne. Par exemple : Valeur |
Option valide avec données JSON |
Indique le type de compression du fichier source. Le format d'archivage zip n'est pas pris en charge. La valeur |
Valeur par défaut : Valeur nulle signifiant qu'aucune compression n'est effectuée. |
|
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 : |
|
Indique le format de date dans le fichier source. L'option de format J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
Valeur par défaut : Format de date de la base de données |
|
Spécifie le délimiteur de champ. Pour utiliser un caractère spécial en tant que délimiteur, spécifiez la valeur HEX du code ASCII du caractère. Par exemple, le caractère suivant spécifie le caractère TAB en tant que délimiteur :
|
Valeur par défaut : |
|
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 dans les fichiers de données externes sont comparés de manière non sensible à la casse avec les 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 : |
|
L'option de format
Par exemple : format => JSON_OBJECT('enablelogs' value FALSE) |
Valeur par défaut : |
|
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
encryption est utilisée avec les procédures DBMS_CLOUD suivantes :
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:value Où value est une chaîne JSON qui fournit des paramètres supplémentaires pour le chiffrement :
Indique le type de chiffrement.
Indique les données d'identification utilisées pour stocker la clé de chiffrement. 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). |
|
Les données peuvent être placées entre deux délimiteurs, spécifiés par Par exemple : format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Valeur par défaut : Nulle, signifiant aucun |
|
Le caractère "\" est utilisé comme caractère d'échappement lorsqu'il est spécifié. |
Valeur par défaut : |
Option valide avec données JSON |
Les lignes vides sont ignorées lorsque la valeur est true. |
Valeur par défaut : |
|
S'il y a plus de colonnes dans |
Valeur par défaut |
Utiliser uniquement avec |
Chemin JSON pour identifier le document à charger. Cette option n'est valide que pour les données de collection JSON avec |
Valeur par défaut : Nulle |
keyassignment Utiliser uniquement avec |
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 |
|
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 : Nulle Voir Locale Data dans le Guide sur la prise en charge de la globalisation de base de données dans Oracle Database 19c ou Oracle Database 23ai Database Globalization Support Guide pour obtenir la liste des langues prises en charge par Oracle. |
|
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 : |
|
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 par des guillemets doubles. Par exemple : format => JSON_OBJECT ('logprefix' value 'TEST') Les fichiers journaux utilisent ensuite le préfixe |
Valeur par défaut : |
|
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 les données JSON |
Taille maximale des documents JSON. |
Valeur par défaut : 1 mégaoctet Valeur maximale autorisée : 2 gigaoctets |
|
Spécifie les caractères à utiliser en tant que séparateur de groupe et caractère décimal. decimal_character : Décimal séparant la partie entière d'un nombre de la partie entière. group_separator : Le séparateur de groupe sépare des 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 Oracle Database 23ai Database Globalization Support Guide. |
|
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 : 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. |
|
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 |
|
|
Spécifie le caractère de guillemet pour les champs, les caractères |
Valeur par défaut : Null signifiant aucun guillemet |
Option valide avec données JSON |
Spécifie le délimiteur d'enregistrement. Par défaut, Indiquez 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
La valeur |
Valeur par défaut : Saut de ligne détecté |
|
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 qui sont créées dans un fichier du stockage d'objets. Par exemple :
Voir REGEXP_LIKE Condition 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 : |
|
L'opération échoue après le rejet du nombre spécifié de rangées. |
Valeur par défaut : |
|
Supprime les guillemets qui encadrent tout champ du fichier source. |
Valeur par défaut : |
|
Indique combien de rangées doivent être ignorées à partir du début du fichier. |
Valeur par défaut : 0 si cette option n'est pas spécifiée, 1 si elle est spécifiée sans valeur |
|
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 : Nulle Voir Locale Data dans le Guide sur la prise en charge de la globalisation de base de données dans Oracle Database 19c ou Oracle Database 23ai Database Globalization Support Guide pour obtenir la liste des langues prises en charge par Oracle. |
|
Précise le format de l'horodatage dans le fichier source. L'option de format YYYY-MM-DD HH:MI:SS.FF YYYY-MM-DD HH:MI:SS.FF3 YYYY-MM-DD HH24:MI:SS.FF3 MM/DD/YYYY HH:MI:SS.FF3 |
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 "$". |
|
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 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 le format de fuseau horaire local |
|
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 le format de fuseau horaire |
|
Indique la façon dont les espaces de début et de fin des champs sont tronqués. See the description of trim_spec in Oracle Database 19c Utilities or Oracle Database 23ai Utilities. |
Valeur par défaut : |
|
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 : |
|
Indique le type de fichier source. See the description of CSV in Oracle Database 19c Utilities or Oracle Database 23ai Utilities. Si Si Voir DBMS_CLOUD Options de format de l'ensemble pour Avro, ORC ou Parquet pour plus d'informations sur les valeurs Pour les données JSON avec Pour les données JSON avec
|
Note : Toutes les procéduresDBMS_CLOUD ne prennent pas en charge tous ces types.
Valeur par défaut : Nulle Pour les données JSON, il existe deux valeurs |
Utiliser uniquement avec |
Lorsque cette propriété est réglée à Lorsque cette option est réglée à Cette option n'est valide que pour les données de collection JSON avec |
Valeur par défaut : |
Rubriques connexes