DBMS_CLOUD pour la gestion de fichiers en masse

Conditions requises

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

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

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 de base de données d'intelligence artificielle autonome 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 les ressources de la base de données IA autonome afin que ces ressources puissent utiliser la passerelle pour obtenir une clé publique à partir de votre instance Azure AD :
1. Allez à la page Détails du sous-réseau pour le sous-réseau.
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 sa 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
  - Cible : 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 pour le 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 sa 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 :Tous
  Si une telle règle n'existe pas, cliquez sur Ajouter des règles sortantes et ajoutez une règle sortante 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 sous 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 soit à 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.

Sommaire des sous-programmes DBMS_CLOUD pour la gestion de fichiers en masse

Sous-programmes pour les opérations de fichiers en masse au sein du package DBMS_CLOUD.

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 les fichiers du seau du magasin d'objets en nuage dans un répertoire de la base de données d'intelligence artificielle autonome.
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 les fichiers d'un répertoire de la base de données IA autonome dans le stockage d'objets en nuage.

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 le dossier source et cible peuvent se trouver dans le même fournisseur ou dans un autre magasin d'objets en nuage.

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 n'indiquez pas de valeur `source_credential_name`, `credential_name` est réglé à `NULL`.
`source_location_uri`	Spécifie l'URI qui pointe vers le seau ou l'emplacement du dossier de stockage d'objets source. Ce paramètre est obligatoire. URI de fichier source en nuage Vous pouvez utiliser des caractères génériques ainsi que des expressions rationnelles dans les noms de fichier dans les URI de fichier source Cloud. Les expressions rationnelles ne peuvent être utilisées que lorsque le paramètre `regexuri` `format` est réglé à `TRUE`. Les caractères "" et "?" sont considérés comme des caractères génériques lorsque le paramètre `regexuri` est réglé à `FALSE`. Lorsque le paramètre `regexuri` est réglé à `TRUE`, les caractères "" et "?" font partie du modèle d'expression rationnelle spécifié. 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 `REGEXP_LIKE`. Exemple utilisant des expressions rationnelles : `source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` Exemple utilisant des caractères génériques : `source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/.csv` Le format des URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour plus de détails, voir Formats d'URI du service de stockage d'objets en nuage. 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 26ai pour plus d'informations sur la condition `REGEXP_LIKE`.
`target_location_uri`	Spécifie l'URI du seau ou du dossier de stockage d'objets cible, où les fichiers doivent être copiés. Ce paramètre est obligatoire. Spécifie l'URI, qui pointe vers le seau ou l'emplacement 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 du service de stockage d'objets en nuage pour l'ensemble DBMS_CLOUD.
`target_credential_name`	Nom des données d'identification pour accéder à l'emplacement de stockage d'objets en nuage cible. Si vous n'indiquez 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 n'indiquez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Pour plus d'informations, voir Condition REGEXP_LIKE.
`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 format 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 statuts est conservée pour une opération en masse. La valeur par défaut est 2 jours. `logprefix` : Accepte une valeur de chaîne qui détermine la chaîne de préfixe du nom de la table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_COPY`, la valeur par défaut de `logprefix` 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 avec 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 à l'aide de la limite d'accès simultané pour le service Medium. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre des numéros de série. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier concurrent est limité à 64. Si vous n'indiquez 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`.

Note : 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 service de 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 n'indiquez pas de valeur `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Spécifie l'URI, qui pointe vers un emplacement de stockage d'objets dans la base de données d'intelligence artificielle autonome. Ce paramètre est obligatoire. URI de fichier source en nuage Vous pouvez utiliser des caractères génériques ainsi que des expressions rationnelles dans les noms de fichier dans les URI de fichier source Cloud. Les expressions rationnelles ne peuvent être utilisées que lorsque le paramètre `regexuri` `format` est réglé à `TRUE`. Les caractères "" et "?" sont considérés comme des caractères génériques lorsque le paramètre `regexuri` est réglé à `FALSE`. Lorsque le paramètre `regexuri` est réglé à `TRUE`, les caractères "" et "?" font partie du modèle d'expression rationnelle spécifié. 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 `REGEXP_LIKE`. Par exemple : `location_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)*[a-z]+[1-3]??.csv'` Le format des URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour plus de détails, voir Formats d'URI du service de stockage d'objets en nuage. 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 26ai pour plus d'informations sur la condition `REGEXP_LIKE`. Le format des URI dépend du service de stockage d'objets en nuage. Pour plus d'informations, voir Formats d'URI du service de stockage d'objets en nuage pour 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 n'indiquez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Pour plus d'informations, voir Condition REGEXP_LIKE.
`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 format 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 statuts est conservée pour une opération en masse. La valeur par défaut est 2 jours. `logprefix` : Accepte une valeur de chaîne qui détermine la chaîne de préfixe du nom de la table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_DELETE`, la valeur par défaut de `logprefix` 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 avec une priorité plus élevée consomme plus de ressources de base de données et est terminée 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 à l'aide de la limite d'accès simultané pour le service Medium. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre des numéros de série. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier concurrent est limité à 64. Si vous n'indiquez 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 les fichiers dans un répertoire de base de données d'intelligence artificielle autonome à 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 n'indiquez pas de valeur `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Spécifie l'URI, qui pointe vers un emplacement de stockage d'objets dans la base de données d'intelligence artificielle autonome. Ce paramètre est obligatoire. URI de fichier source en nuage Vous pouvez utiliser des caractères génériques ainsi que des expressions rationnelles dans les noms de fichier dans les URI de fichier source Cloud. Les expressions rationnelles ne peuvent être utilisées que lorsque le paramètre `regexuri` `format` est réglé à `TRUE`. Les caractères "" et "?" sont considérés comme des caractères génériques lorsque le paramètre `regexuri` est réglé à `FALSE`. Lorsque le paramètre `regexuri` est réglé à `TRUE`, les caractères "" et "?" font partie du modèle d'expression rationnelle spécifié. 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 `REGEXP_LIKE`. Par exemple : `location_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)*[a-z]+[1-3]??.csv'` Le format des URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour plus de détails, voir Formats d'URI du service de stockage d'objets en nuage. 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 26ai pour plus d'informations sur la condition `REGEXP_LIKE`.
`directory_name`	Nom du répertoire de la base de données d'intelligence artificielle autonome à 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 n'indiquez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Pour plus d'informations, voir Condition REGEXP_LIKE.
`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 format 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 statuts est conservée pour une opération en masse. La valeur par défaut est 2 jours. `logprefix` : Accepte une valeur de chaîne qui détermine la chaîne de préfixe du nom de la table de statut d'opération en masse. Pour `BULK_DOWNLOAD`, la valeur par défaut de `logprefix` 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 avec une priorité plus élevée consomme plus de ressources de base de données et est terminée 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 à l'aide de la limite d'accès simultané pour le service Medium. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre des numéros de série. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier concurrent est limité à 64. Si vous n'indiquez 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 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 le dossier source et cible peuvent se trouver dans le même fournisseur ou dans un autre magasin d'objets en nuage.

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.

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 pour accéder au stockage d'objets en nuage source. Si vous n'indiquez pas de valeur `source_credential_name`, `credential_name` est réglé à `NULL`.
`source_location_uri`	Spécifie l'URI qui pointe vers le seau ou l'emplacement du dossier de stockage d'objets source. Ce paramètre est obligatoire. URI de fichier source en nuage Vous pouvez utiliser des caractères génériques ainsi que des expressions rationnelles dans les noms de fichier dans les URI de fichier source Cloud. Les expressions rationnelles ne peuvent être utilisées que lorsque le paramètre `regexuri` `format` est réglé à `TRUE`. Les caractères "" et "?" sont considérés comme des caractères génériques lorsque le paramètre `regexuri` est réglé à `FALSE`. Lorsque le paramètre `regexuri` est réglé à `TRUE`, les caractères "" et "?" font partie du modèle d'expression rationnelle spécifié. 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 `REGEXP_LIKE`. Exemple utilisant des expressions rationnelles : `source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o(/)year=[0-9]+(/)month=[0-9]+(/)[a-z]+[1-3]??.csv'` Exemple utilisant des caractères génériques : `source_location_uri => 'https://objectstorage.my$region.oraclecloud.com/n/namespace-string/b/bucketname/o/year=????/month=??/.csv` Le format des URI dépend du service de stockage d'objets en nuage que vous utilisez. Pour plus de détails, voir Formats d'URI du service de stockage d'objets en nuage. 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 26ai pour plus d'informations sur la condition `REGEXP_LIKE`.
`target_location_uri`	Spécifie l'URI du seau ou du 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 que vous utilisez. Pour plus de détails, voir Formats d'URI du service de stockage d'objets en nuage.
`target_credential_name`	Nom des données d'identification pour accéder à l'emplacement de stockage d'objets en nuage cible. Si vous n'indiquez 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 n'indiquez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Pour plus d'informations, voir Condition REGEXP_LIKE.
`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 format 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 statuts est conservée pour une opération en masse. La valeur par défaut est 2 jours. `logprefix` : Accepte une valeur de chaîne qui détermine la chaîne de préfixe du nom de la table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_MOVE`, la valeur par défaut de `logprefix` 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 avec une priorité plus élevée consomme plus de ressources de base de données et est terminée 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 à l'aide de la limite d'accès simultané pour le service Medium. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre des numéros de série. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier concurrent est limité à 64. Si vous n'indiquez 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 les fichiers dans le stockage d'objets en nuage à partir d'un répertoire de base de données du service d'intelligence artificielle autonome. 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 n'indiquez pas de valeur `credential_name`, `credential_name` est réglé à `NULL`.
`location_uri`	Spécifie l'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 du service de stockage d'objets en nuage pour l'ensemble DBMS_CLOUD.
`directory_name`	Nom du répertoire de la base de données d'intelligence artificielle autonome à partir duquel vous chargez des fichiers. Ce paramètre est obligatoire. Répertoire Vous pouvez spécifier un répertoire et un ou plusieurs noms de fichier ou utiliser une liste de répertoires et de noms de fichier séparés par des virgules. Le format pour spécifier un répertoire est :`'MY_DIR:filename.ext'`. Par défaut, le nom de répertoire `MY_DIR` est un objet de base de données non sensible à la casse. Le nom du fichier est sensible à la casse. Les expressions rationnelles ne sont pas prises en charge lors de la spécification des noms de fichier dans un répertoire. Vous ne pouvez utiliser que des caractères génériques pour spécifier des noms de fichier dans un répertoire. Le caractère "" peut être utilisé pour plusieurs caractères, et le caractère "?" peut être utilisé pour un seul caractère. Par exemple :`'MY_DIR:"` ou `'MY_DIR:test?'` Pour spécifier plusieurs répertoires, utilisez une liste de répertoires séparés par des virgules : Par exemple :`'MY_DIR1:, MY_DIR2:test?'` Utilisez des guillemets doubles pour spécifier un nom de répertoire sensible à la casse. Par exemple :`'"my_dir1":, "my_dir2":Test?'` Pour inclure un caractère de guillemet, utilisez deux guillemets. Par exemple :`'MY_DIR:''filename.ext'`. Cela spécifie que `filename` commence par une soumission (`'`).
`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 n'indiquez pas de valeur `regex_filter`, `regex_filter` est réglé à `NULL`. Pour plus d'informations, voir Condition REGEXP_LIKE.
`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 format 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 statuts est conservée pour une opération en masse. La valeur par défaut est 2 jours. `logprefix` : Accepte une valeur de chaîne qui détermine la chaîne de préfixe du nom de la table de statut d'opération en masse. Le type d'opération est la valeur par défaut. Pour `BULK_UPLOAD`, la valeur par défaut de `logprefix` 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 avec une priorité plus élevée consomme plus de ressources de base de données et est terminée 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 à l'aide de la limite d'accès simultané pour le service Medium. La valeur par défaut est 4. `LOW` : Traitez les fichiers dans l'ordre des numéros de série. La valeur par défaut est `MEDIUM`. Le nombre maximal d'opérations de fichier concurrent est limité à 64. Si vous n'indiquez 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;
/

Contenu connexe

Opérations en masse pour les fichiers dans le nuage