DBMS_CLOUD pour la gestion des fichiers en masse

Sous-programme	Description
Procédure BULK_COPY	Cette procédure copie les fichiers d'un seau de stockage d'objets en nuage vers un autre.
Procédure BULK_DELETE	La procédure supprime des fichiers du seau ou du dossier de stockage d'objets en nuage.
Procédure BULK_DOWNLOAD	Cette procédure télécharge des fichiers à partir du seau du magasin d'objets en nuage vers un répertoire dans Autonomous Database.
Procédure BULK_MOVE	Cette procédure déplace les fichiers d'un seau de stockage d'objets en nuage vers un autre.
Procédure BULK_UPLOAD	Cette procédure charge des fichiers à partir d'un répertoire dans Autonomous Database vers le stockage d'objets en nuage.

Conditions requises

En tant que développeur, vous pouvez utiliser des procédures DBMS_CLOUD avec des bases de données Autonomous Database déployées sur Oracle Public Cloud, Multicloud ou Exadata Cloud@Customer.

Selon le choix de déploiement, les préalables suivants doivent être satisfaits pour utiliser les procédures DBMS_CLOUD avec les fournisseurs de services Amazon S3, Azure Blob Storage et Google Cloud Storage.

Oracle Public Cloud ou multinuage
Exadata Cloud@Customer

Une connectivité sortante doit avoir été configurée à l'aide d'une passerelle NAT par l'administrateur de votre parc, comme décrit ci-dessous :

Créez une passerelle NAT dans le réseau en nuage virtuel (VCN) où résident vos ressources Autonomous Database en suivant les instructions sous Créer une passerelle NAT dans la documentation sur Oracle Cloud Infrastructure.
Après avoir créé la passerelle NAT, ajoutez une règle de routage et une règle de sécurité de trafic sortant à chaque sous-réseau (dans le VCN) où résident des ressources Autonomous Database afin que ces ressources puissent utiliser la passerelle pour obtenir une clé publique de votre instance Azure AD :
1. Allez à la page Détails du sous-réseau correspondante.
2. Dans l'onglet informations sur le sous-réseau, cliquez sur le nom de la table de routage du sous-réseau pour afficher la page Détails de la table de routage.
3. Dans la table des règles de routage existantes, vérifiez s'il existe déjà une règle présentant les caractéristiques suivantes :
  - Destination : 0.0.0.0/0
  - Type de cible : Passerelle NAT
  - Target : Nom de la passerelle NAT que vous venez de créer dans le VCN
  Si une telle règle n'existe pas, cliquez sur Ajouter des règles de routage et ajoutez une règle de routage avec ces caractéristiques.
4. Retournez à la page Détails du sous-réseau.
5. Dans la table Listes de sécurité du sous-réseau, cliquez sur le nom de la liste de sécurité du sous-réseau pour afficher la page Détails de la liste de sécurité.
6. Dans le menu latéral, sous Ressources, cliquez sur Règles de trafic sortant.
7. Dans la table des règles de trafic sortant existantes, vérifiez s'il existe déjà une règle présentant les caractéristiques suivantes :
  - Type de destination : CIDR
  - Destination : 0.0.0.0/0
  - Protocole IP : TCP
  - Intervalle de ports sources : 443
  - Intervalle de ports de destination : Tout
  Si une telle règle n'existe pas, cliquez sur Ajouter des règles de trafic sortant et ajoutez une règle de trafic sortant avec ces caractéristiques.

Les paramètres de mandataire HTTP de votre environnement doivent permettre à la base de données d'accéder au fournisseur de services en nuage.

Ces paramètres sont définis par l'administrateur de votre parc lors de la création de l'infrastructure Exadata Cloud@Customer, comme décrit dans Utilisation de la console pour provisionner le service Exadata Database sur Cloud@Customer.

Note :

La configuration réseau, y compris le mandataire HTTP, ne peut être modifiée que jusqu'à ce que l'infrastructure Exadata ait l'état Activation requise. Une fois activé, vous ne pouvez pas modifier ces paramètres.

La configuration d'un mandataire HTTP pour une infrastructure Exadata déjà provisionnée nécessite une demande de service dans My Oracle Support. Pour plus de détails, voir Créer une demande de service dans My Oracle Support.

Procédure BULK_COPY

Cette procédure copie en masse des fichiers d'un seau de stockage d'objets en nuage vers un autre. Le formulaire surchargé vous permet d'utiliser le paramètre operation_id.

Vous pouvez filtrer la liste des fichiers à supprimer à l'aide d'un modèle d'expression rationnelle compatible avec l'opérateur REGEXP_LIKE.

Le seau ou dossier source et cible peut se trouver dans le même fournisseur de magasin d'objets en nuage ou dans un autre.

Lorsque la source et la cible se trouvent dans des magasins d'objets distincts ou ont des comptes différents avec le même fournisseur de services en nuage, vous pouvez donner des noms de données d'identification distincts pour les emplacements source et cible.

Le nom des données d'identification sources est également utilisé par défaut par l'emplacement cible.

Syntaxe

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_COPY (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

Paramètres

Paramètre	Description
`source_credential_name`	Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage. Si vous ne fournissez pas de valeur pour `source_credential_name`, `credential_name` est réglé à `NULL`.
`source_location_uri`	Indique l'URI, qui pointe vers l'emplacement du seau ou du dossier de stockage d'objets source. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`target_location_uri`	Indique l'URI du seau ou dossier de stockage d'objets cible, où les fichiers doivent être copiés. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`target_credential_name`	Nom des données d'identification permettant d'accéder à l'emplacement de stockage d'objets en nuage cible. Si vous ne fournissez pas de valeur `target_credential_name`, `target_location_uri` est réglé à la valeur `source_credential_name`.
`regex_filter`	Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur `REGEXP_LIKE`. Si vous ne fournissez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Voir REGEXP_LIKE Condition pour plus d'informations.
`format`	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont spécifiées en tant que chaîne JSON. Les options de formatage prises en charge sont les suivantes : `logretention` : Accepte une valeur entière qui détermine la durée en jours pendant laquelle la table de statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. `logprefix` : Elle accepte une valeur de chaîne qui détermine la chaîne de préfixe de nom de table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_COPY`, la valeur `logprefix` par défaut est `COPYOBJ`. `priority` : Accepte une valeur de chaîne qui détermine le nombre d'opérations de fichier exécutées simultanément. Une opération ayant une priorité supérieure consomme plus de ressources de base de données et doit s'exécuter plus rapidement. Il accepte les valeurs suivantes : `HIGH` : Détermine le nombre de fichiers parallèles traités à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si votre base de données utilise des OCPU) `MEDIUM` : Détermine le nombre de processus simultanés utilisant la limite d'accès simultané pour le service moyen. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre séquentiel. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier simultanées est limité à 64. Si vous ne fournissez pas de valeur `format`, `format` est réglé à `NULL`.
`operation_id`	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement avec l'ID correspondant dans la vue `USER_LOAD_OPERATIONS`.

Notes d'utilisation

Une erreur est retournée lorsque les URI source et cible pointent vers le même seau ou dossier de stockage d'objets.

Exemple

BEGIN 
DBMS_CLOUD.BULK_COPY (
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format       => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
);
END;
/

Procédure BULK_DELETE

Cette procédure supprime en masse des fichiers du stockage d'objets en nuage. Le formulaire surchargé vous permet d'utiliser le paramètre operation_id. Vous pouvez filtrer la liste des fichiers à supprimer à l'aide d'un modèle d'expression rationnelle compatible avec l'opérateur REGEXP_LIKE.

Syntaxe

 DBMS_CLOUD.BULK_DELETE(
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DELETE (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Paramètres

Paramètre	Description
`credential_name`	Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage. Si vous ne fournissez pas de valeur pour `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Indique l'URI qui pointe vers un emplacement de stockage d'objets dans Autonomous Database. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`regex_filter`	Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur `REGEXP_LIKE`. Si vous ne fournissez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Voir REGEXP_LIKE Condition pour plus d'informations.
`format`	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont spécifiées en tant que chaîne JSON. Les options de formatage prises en charge sont les suivantes : `logretention` : Accepte une valeur entière qui détermine la durée en jours pendant laquelle la table de statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. `logprefix` : Elle accepte une valeur de chaîne qui détermine la chaîne de préfixe de nom de table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_DELETE`, la valeur `logprefix` par défaut est `DELETE`. `priority` : Accepte une valeur de chaîne qui détermine le nombre d'opérations de fichier exécutées simultanément. Une opération ayant une priorité supérieure consomme plus de ressources de base de données et se termine plus tôt. Il accepte les valeurs suivantes : `HIGH` : Détermine le nombre de fichiers parallèles traités à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si votre base de données utilise des OCPU). `MEDIUM` : Détermine le nombre de processus simultanés utilisant la limite d'accès simultané pour le service moyen. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre séquentiel. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier simultanées est limité à 64. Si vous ne fournissez pas de valeur `format`, `format` est réglé à `NULL`.
`operation_id`	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement avec l'ID correspondant dans la vue `USER_LOAD_OPERATIONS`.

Exemple

BEGIN
DBMS_CLOUD.BULK_DELETE (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKDEL')
);
END;
/

Procédure BULK_DOWNLOAD

Cette procédure télécharge des fichiers dans un répertoire Autonomous Database à partir du stockage d'objets en nuage. Le formulaire surchargé vous permet d'utiliser le paramètre operation_id. Vous pouvez filtrer la liste des fichiers à télécharger à l'aide d'un modèle d'expression rationnelle compatible avec l'opérateur REGEXP_LIKE.

Syntaxe

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_DOWNLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Paramètres

Paramètre	Description
`credential_name`	Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage. Si vous ne fournissez pas de valeur pour `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Indique l'URI qui pointe vers un emplacement de stockage d'objets dans Autonomous Database. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`directory_name`	Nom du répertoire dans Autonomous Database à partir duquel vous voulez télécharger les fichiers. Ce paramètre est obligatoire.
`regex_filter`	Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur `REGEXP_LIKE`. Si vous ne fournissez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Voir REGEXP_LIKE Condition pour plus d'informations.
`format`	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont spécifiées en tant que chaîne JSON. Les options de formatage prises en charge sont les suivantes : `logretention` : Accepte une valeur entière qui détermine la durée en jours pendant laquelle la table de statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. `logprefix` : Elle accepte une valeur de chaîne qui détermine la chaîne de préfixe de nom de table de statut d'opération en masse. Pour `BULK_DOWNLOAD`, la valeur `logprefix` par défaut est `DOWNLOAD`. Le type d'opération est la valeur par défaut. `priority` : Accepte une valeur de chaîne qui détermine le nombre d'opérations de fichier exécutées simultanément. Une opération ayant une priorité supérieure consomme plus de ressources de base de données et se termine plus tôt. Il accepte les valeurs suivantes : `HIGH` : Détermine le nombre de fichiers parallèles traités à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si votre base de données utilise des OCPU). `MEDIUM` : Détermine le nombre de processus simultanés utilisant la limite d'accès simultané pour le service moyen. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre séquentiel. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier simultanées est limité à 64. Si vous ne fournissez pas de valeur `format`, `format` est réglé à `NULL`.
`operation_id`	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement avec l'ID correspondant dans la vue `USER_LOAD_OPERATIONS`.

Exemple

BEGIN
DBMS_CLOUD.BULK_DOWNLOAD (    
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKOP')
 );
END;
/

Procédure BULK_MOVE

Cette procédure déplace en masse des fichiers d'un seau ou d'un dossier du service de stockage d'objets en nuage vers un autre. Le formulaire surchargé vous permet d'utiliser le paramètre operation_id.

Vous pouvez filtrer la liste des fichiers à supprimer à l'aide d'un modèle d'expression rationnelle compatible avec l'opérateur REGEXP_LIKE.

Le seau ou dossier source et cible peut se trouver dans le même fournisseur de magasin d'objets en nuage ou dans un autre.

Lorsque la source et la cible se trouvent dans des magasins d'objets distincts ou ont des comptes différents avec le même fournisseur de services en nuage, vous pouvez donner des noms de données d'identification distincts pour les emplacements source et cible.

Le nom des données d'identification sources est également utilisé par défaut par l'emplacement cible lorsque le nom des données d'identification cibles n'est pas indiqué.

La première étape du déplacement des fichiers consiste à les copier vers l'emplacement cible, puis à supprimer les fichiers sources, une fois qu'ils ont été copiés avec succès.

L'objet est renommé plutôt que déplacé si le magasin d'objets permet de renommer les opérations entre les emplacements source et cible.

Syntaxe

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_MOVE (
      source_credential_name  IN  VARCHAR2 DEFAULT NULL,
      source_location_uri     IN  VARCHAR2,
      target_location_uri     IN  VARCHAR2,
      target_credential_name  IN  VARCHAR2 DEFAULT NULL,
      regex_filter            IN  VARCHAR2 DEFAULT NULL,
      format                  IN  CLOB     DEFAULT NULL,
      operation_id            OUT NUMBER
);

Paramètres

Paramètre	Description
`source_credential_name`	Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage source. Si vous ne fournissez pas de valeur pour `source_credential_name`, `credential_name` est réglé à `NULL`.
`source_location_uri`	Indique l'URI, qui pointe vers l'emplacement du seau ou du dossier de stockage d'objets source. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`target_location_uri`	Indique l'URI du seau ou dossier de stockage d'objets cible, où les fichiers doivent être déplacés. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`target_credential_name`	Nom des données d'identification permettant d'accéder à l'emplacement de stockage d'objets en nuage cible. Si vous ne fournissez pas de valeur `target_credential_name`, `target_location_uri` est réglé à la valeur `source_credential_name`.
`regex_filter`	Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur `REGEXP_LIKE`. Si vous ne fournissez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Voir REGEXP_LIKE Condition pour plus d'informations.
`format`	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont spécifiées en tant que chaîne JSON. Les options de formatage prises en charge sont les suivantes : `logretention` : Accepte une valeur entière qui détermine la durée en jours pendant laquelle la table de statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. `logprefix` : Elle accepte une valeur de chaîne qui détermine la chaîne de préfixe de nom de table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_MOVE`, la valeur `logprefix` par défaut est `MOVE`. `priority` : Accepte une valeur de chaîne qui détermine le nombre d'opérations de fichier exécutées simultanément. Une opération ayant une priorité supérieure consomme plus de ressources de base de données et se termine plus tôt. Il accepte les valeurs suivantes : `HIGH` : Détermine le nombre de fichiers parallèles traités à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si votre base de données utilise des OCPU). `MEDIUM` : Détermine le nombre de processus simultanés utilisant la limite d'accès simultané pour le service moyen. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre séquentiel. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier simultanées est limité à 64. Si vous ne fournissez pas de valeur `format`, `format` est réglé à `NULL`.
`operation_id`	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement avec l'ID correspondant dans la vue `USER_LOAD_OPERATIONS`.

Exemple

BEGIN 
DBMS_CLOUD.BULK_MOVE (    
     source_credential_name => 'OCI_CRED',
     source_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/o',
     target_location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/o',
     format                 => JSON_OBJECT ('logretention' value 7, 'logprefix' value 'BULKMOVE')
);
END;
/

Note :

Une erreur est retournée lorsque les URI source et cible pointent vers le même seau ou dossier de stockage d'objets.

Procédure BULK_UPLOAD

Cette procédure copie des fichiers dans le stockage d'objets en nuage à partir d'un répertoire Autonomous Database. Le formulaire surchargé vous permet d'utiliser le paramètre operation_id.

Syntaxe

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL
);

DBMS_CLOUD.BULK_UPLOAD (
     credential_name  IN  VARCHAR2 DEFAULT NULL,
     location_uri     IN  VARCHAR2,
     directory_name   IN  VARCHAR2,
     regex_filter     IN  VARCHAR2 DEFAULT NULL,
     format           IN  CLOB     DEFAULT NULL,
     operation_id     OUT NUMBER
);

Paramètres

Paramètre	Description
`credential_name`	Nom des données d'identification permettant d'accéder au service de stockage d'objets en nuage. Si vous ne fournissez pas de valeur pour `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Indique un URI, qui pointe vers un emplacement de stockage d'objets pour charger des fichiers. Ce paramètre est obligatoire. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI des services de stockage d'objets en nuage de l'ensemble DBMS_CLOUD.
`directory_name`	Nom du répertoire dans Autonomous Database à partir duquel vous chargez des fichiers. Ce paramètre est obligatoire.
`regex_filter`	Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur `REGEXP_LIKE`. Si vous ne fournissez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Voir REGEXP_LIKE Condition pour plus d'informations.
`format`	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont spécifiées en tant que chaîne JSON. Les options de formatage prises en charge sont les suivantes : `logretention` : Accepte une valeur entière qui détermine la durée en jours pendant laquelle la table de statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. `logprefix` : Elle accepte une valeur de chaîne qui détermine la chaîne de préfixe de nom de table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_UPLOAD`, la valeur `logprefix` par défaut est `UPLOAD`. `priority` : Accepte une valeur de chaîne qui détermine le nombre d'opérations de fichier exécutées simultanément. Une opération ayant une priorité supérieure consomme plus de ressources de base de données et se termine plus tôt. Il accepte les valeurs suivantes : `HIGH` : Détermine le nombre de fichiers parallèles traités à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si votre base de données utilise des OCPU). `MEDIUM` : Détermine le nombre de processus simultanés utilisant la limite d'accès simultané pour le service moyen. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre séquentiel. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier simultanées est limité à 64. Si vous ne fournissez pas de valeur `format`, `format` est réglé à `NULL`.
`operation_id`	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement avec l'ID correspondant dans la vue `USER_LOAD_OPERATIONS`.

Exemple

BEGIN
DBMS_CLOUD.BULK_UPLOAD ( 
     credential_name => 'OCI_CRED',
     location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
     directory_name  => 'BULK_TEST',
     format          => JSON_OBJECT ('logretention' value 5, 'logprefix' value 'BULKUPLOAD')
 );
END;
/