DBMS_CLOUD pour la gestion de fichiers en masse

Sous-programmes d'opérations de fichier en masse dans le package DBMS_CLOUD.

Sous-programme	Description
BULK_COPY Procédure	Cette procédure copie des fichiers d'un bucket Cloud Object Storage vers un autre.
BULK_DELETE Procédure	La procédure supprime des fichiers du bucket ou du dossier Cloud Object Storage.
BULK_DOWNLOAD Procédure	Cette procédure télécharge des fichiers du bucket de banque d'objets cloud vers un répertoire dans Autonomous Database.
BULK_MOVE Procédure	Cette procédure déplace les fichiers d'un bucket Cloud Object Storage vers un autre.
BULK_UPLOAD Procédure	Cette procédure télécharge des fichiers d'un répertoire dans Autonomous Database vers le stockage d'objet cloud.

Prérequis

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

Selon le choix de déploiement, les prérequis 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.

• Oracle Public Cloud ou multicloud
• Exadata Cloud@Customer

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

• Créez une passerelle NAT dans le réseau cloud virtuel (VCN) où résident vos ressources Autonomous Database en suivant les instructions fournies dans Création d'une passerelle NAT dans la documentation Oracle Cloud Infrastructure.
• Après avoir créé la passerelle NAT, ajoutez une règle de routage et une règle de sécurité sortante à chaque sous-réseau (dans le VCN) dans lesquelles résident les ressources Autonomous Database afin que ces ressources puissent utiliser la passerelle pour obtenir une clé publique à partir de votre instance Azure AD :
  1. Accédez à la page Détails du 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 la page Détails de la table de routage correspondante.
  3. Dans la table des règles de routage existantes, vérifiez s'il existe déjà une règle avec 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 possédant ces caractéristiques.

  4. Revenez à 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é correspondante.
  6. Dans le menu latéral, sous Resources, cliquez sur Egress Rules.
  7. Dans la table des règles sortantes existantes, vérifiez s'il existe déjà une règle avec les caractéristiques suivantes :
     • Type de destination : CIDR
     • Destination : 0.0.0.0/0
     • Protocole IP : TCP
     • Plage de ports source: 443
     • Plage de ports de destination : Tout

     Si une telle règle n'existe pas, cliquez sur Ajouter des règles sortantes et ajoutez une règle présentant ces caractéristiques.

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

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

Remarques :

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

La configuration d'un proxy HTTP pour une infrastructure Exadata déjà provisionnée nécessite une demande de service (SR) dans My Oracle Support. Pour plus d'informations, reportez-vous à Création d'une demande d'assistance dans My Oracle Support.

BULK_COPY Procédure

Cette procédure copie en masse des fichiers d'un bucket Cloud Object Storage vers un autre. La forme surchargée permet d'utiliser le paramètre operation_id.

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

Le bucket ou le dossier source et cible peuvent se trouver dans le même fournisseur de banque d'objets cloud ou dans un autre fournisseur.

Lorsque la source et la cible se trouvent dans des banques d'objets distinctes ou ont des comptes différents avec le même fournisseur cloud, vous pouvez indiquer des noms d'informations d'identification distincts pour les emplacements source et cible.

Le nom des informations d'identification source 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 informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur source_credential_name, credential_name est défini sur NULL.
source_location_uri	Indique l'URI qui pointe vers l'emplacement du dossier ou du bucket Object Storage source. Ce paramètre est obligatoire. URI de fichier source cloud Vous pouvez utiliser des caractères génériques ainsi que des expressions régulières dans les noms de fichier dans les URI de fichier source cloud. Les expressions régulières ne peuvent être utilisées que lorsque le paramètre regexuri format est défini sur TRUE. Les caractères "*" et " ?" sont considérés comme des caractères génériques lorsque le paramètre regexuri est défini sur FALSE. Lorsque le paramètre regexuri est défini sur TRUE, les caractères "*" et " ?" font partie du modèle d'expression régulière indiqué. Les modèles d'expression régulière sont uniquement pris en charge pour le nom de fichier ou le chemin de sous-dossier dans vos URI et la correspondance de modèle est identique à celle effectuée par la fonction REGEXP_LIKE. Exemple d'utilisation d'expressions régulières : 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 avec 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 Cloud Object Storage que vous utilisez. Pour en savoir plus, reportez-vous àFormats d'URI de stockage d'objet cloud. Pour plus d'informations sur la condition REGEXP_LIKE, reportez-vous à Condition REGEXP_LIKE dans Référence de langage SQL Oracle Database 19c ou Référence de langage SQL Oracle Database 23ai.
target_location_uri	Spécifie l'URI du bucket ou du dossier Object Storage cible, où les fichiers doivent être copiés. Ce paramètre est obligatoire. Spécifie l'URI, qui pointe vers l'emplacement du bucket ou du dossier Object Storage source. Ce paramètre est obligatoire. Le format des URI dépend du service Cloud Object Storage. Pour plus d'informations, reportez-vous à DBMS_CLOUD Formats d'URI de stockage d'objet cloud de fichier de package.
target_credential_name	Nom des informations d'identification permettant d'accéder à l'emplacement Cloud Object Storage cible. Si vous n'indiquez pas de valeur target_credential_name, target_location_uri est défini sur 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 défini sur NULL. Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE.
format	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont indiquées sous forme de 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 statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. logprefix : 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 effectuées simultanément. Une opération avec une priorité plus élevée 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 gérés à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si la 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 Medium. La valeur par défaut est 4. LOW : traite 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 simultanées est limité à 64. Si vous n'indiquez pas de valeur format, format est défini sur NULL.
operation_id	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement sous l'ID correspondant dans la vue USER_LOAD_OPERATIONS.

Remarques sur l'utilisation

• Une erreur est renvoyée lorsque les URI source et cible pointent vers le même bucket ou dossier Object Storage.

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;
/

BULK_DELETE Procédure

Cette procédure supprime en masse des fichiers du stockage d'objet cloud. La forme surchargée permet d'utiliser le paramètre operation_id. Vous pouvez filtrer la liste des fichiers à supprimer à l'aide d'un modèle d'expression régulière 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 informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur credential_name, credential_name est défini sur NULL.
location_uri	Spécifie l'URI qui pointe vers un emplacement Object Storage dans Autonomous Database. Ce paramètre est obligatoire. URI de fichier source cloud Vous pouvez utiliser des caractères génériques ainsi que des expressions régulières dans les noms de fichier dans les URI de fichier source cloud. Les expressions régulières ne peuvent être utilisées que lorsque le paramètre regexuri format est défini sur TRUE. Les caractères "*" et " ?" sont considérés comme des caractères génériques lorsque le paramètre regexuri est défini sur FALSE. Lorsque le paramètre regexuri est défini sur TRUE, les caractères "*" et " ?" font partie du modèle d'expression régulière indiqué. Les modèles d'expression régulière sont uniquement pris en charge pour le nom de fichier ou le chemin de sous-dossier dans vos URI et la correspondance de modèle est identique à celle effectuée par la fonction REGEXP_LIKE. 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 Cloud Object Storage que vous utilisez. Pour en savoir plus, reportez-vous àFormats d'URI de stockage d'objet cloud. Pour plus d'informations sur la condition REGEXP_LIKE, reportez-vous à Condition REGEXP_LIKE dans Référence de langage SQL Oracle Database 19c ou Référence de langage SQL Oracle Database 23ai. Le format des URI dépend du service Cloud Object Storage. Pour plus d'informations, reportez-vous à DBMS_CLOUD Formats d'URI de stockage d'objet cloud de fichier de package.
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 défini sur NULL. Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE.
format	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont indiquées sous forme de 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 statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. logprefix : 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 effectué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 gérés à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si la 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 Medium. La valeur par défaut est 4. LOW : traite 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 simultanées est limité à 64. Si vous n'indiquez pas de valeur format, format est défini sur NULL.
operation_id	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement sous 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;
/

BULK_DOWNLOAD Procédure

Cette procédure télécharge des fichiers dans un répertoire Autonomous Database à partir du stockage d'objet cloud. La forme surchargée 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 régulière 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 informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur credential_name, credential_name est défini sur NULL.
location_uri	Spécifie l'URI qui pointe vers un emplacement Object Storage dans Autonomous Database. Ce paramètre est obligatoire. URI de fichier source cloud Vous pouvez utiliser des caractères génériques ainsi que des expressions régulières dans les noms de fichier dans les URI de fichier source cloud. Les expressions régulières ne peuvent être utilisées que lorsque le paramètre regexuri format est défini sur TRUE. Les caractères "*" et " ?" sont considérés comme des caractères génériques lorsque le paramètre regexuri est défini sur FALSE. Lorsque le paramètre regexuri est défini sur TRUE, les caractères "*" et " ?" font partie du modèle d'expression régulière indiqué. Les modèles d'expression régulière sont uniquement pris en charge pour le nom de fichier ou le chemin de sous-dossier dans vos URI et la correspondance de modèle est identique à celle effectuée par la fonction REGEXP_LIKE. 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 Cloud Object Storage que vous utilisez. Pour en savoir plus, reportez-vous àFormats d'URI de stockage d'objet cloud. Pour plus d'informations sur la condition REGEXP_LIKE, reportez-vous à Condition REGEXP_LIKE dans Référence de langage SQL Oracle Database 19c ou Référence de langage SQL Oracle Database 23ai.
directory_name	Nom du répertoire sur l'instance Autonomous Database à partir duquel 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 défini sur NULL. Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE.
format	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont indiquées sous forme de 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 statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. logprefix : 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 effectué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 gérés à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si la 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 Medium. La valeur par défaut est 4. LOW : traite 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 simultanées est limité à 64. Si vous n'indiquez pas de valeur format, format est défini sur NULL.
operation_id	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement sous 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;
/

BULK_MOVE Procédure

Cette procédure déplace en masse des fichiers d'un bucket ou dossier Cloud Object Storage vers un autre. La forme surchargée permet d'utiliser le paramètre operation_id.

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

Le bucket ou le dossier source et cible peuvent se trouver dans le même fournisseur de banque d'objets cloud ou dans un autre fournisseur.

Lorsque la source et la cible se trouvent dans des banques d'objets distinctes ou ont des comptes différents avec le même fournisseur cloud, vous pouvez indiquer des noms d'informations d'identification distincts pour les emplacements source et cible.

Le nom des informations d'identification source est également utilisé par défaut par l'emplacement cible lorsque le nom des informations d'identification cible n'est pas fourni.

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

L'objet est renommé plutôt que déplacé si la banque 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 informations d'identification permettant d'accéder au stockage d'objet cloud source. Si vous n'indiquez pas de valeur source_credential_name, credential_name est défini sur NULL.
source_location_uri	Indique l'URI qui pointe vers l'emplacement du dossier ou du bucket Object Storage source. Ce paramètre est obligatoire. URI de fichier source cloud Vous pouvez utiliser des caractères génériques ainsi que des expressions régulières dans les noms de fichier dans les URI de fichier source cloud. Les expressions régulières ne peuvent être utilisées que lorsque le paramètre regexuri format est défini sur TRUE. Les caractères "*" et " ?" sont considérés comme des caractères génériques lorsque le paramètre regexuri est défini sur FALSE. Lorsque le paramètre regexuri est défini sur TRUE, les caractères "*" et " ?" font partie du modèle d'expression régulière indiqué. Les modèles d'expression régulière sont uniquement pris en charge pour le nom de fichier ou le chemin de sous-dossier dans vos URI et la correspondance de modèle est identique à celle effectuée par la fonction REGEXP_LIKE. Exemple d'utilisation d'expressions régulières : 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 avec 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 Cloud Object Storage que vous utilisez. Pour en savoir plus, reportez-vous àFormats d'URI de stockage d'objet cloud. Pour plus d'informations sur la condition REGEXP_LIKE, reportez-vous à Condition REGEXP_LIKE dans Référence de langage SQL Oracle Database 19c ou Référence de langage SQL Oracle Database 23ai.
target_location_uri	Spécifie l'URI du bucket ou du dossier Object Storage cible, où les fichiers doivent être déplacés. Ce paramètre est obligatoire. Le format des URI dépend du service Cloud Object Storage que vous utilisez. Pour en savoir plus, reportez-vous àFormats d'URI de stockage d'objet cloud.
target_credential_name	Nom des informations d'identification permettant d'accéder à l'emplacement Cloud Object Storage cible. Si vous n'indiquez pas de valeur target_credential_name, target_location_uri est défini sur 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 défini sur NULL. Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE.
format	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont indiquées sous forme de 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 statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. logprefix : 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 effectué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 gérés à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si la 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 Medium. La valeur par défaut est 4. LOW : traite 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 simultanées est limité à 64. Si vous n'indiquez pas de valeur format, format est défini sur NULL.
operation_id	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement sous 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;
/

Remarques :

Une erreur est renvoyée lorsque les URI source et cible pointent vers le même bucket ou dossier Object Storage.

BULK_UPLOAD Procédure

Cette procédure copie des fichiers dans le stockage d'objet cloud à partir d'un répertoire Autonomous Database. La forme surchargée 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 informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur credential_name, credential_name est défini sur NULL.
location_uri	Indique un URI, qui pointe vers un emplacement Object Storage pour télécharger des fichiers. Ce paramètre est obligatoire. Le format des URI dépend du service Cloud Object Storage. Pour plus d'informations, reportez-vous à DBMS_CLOUD Formats d'URI de stockage d'objet cloud de fichier de package.
directory_name	Nom du répertoire sur l'instance Autonomous Database à partir duquel vous téléchargez des fichiers. Ce paramètre est obligatoire. Répertoire Vous pouvez indiquer 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 et ne tient pas compte de la casse. Ce nom de fichier distingue les majuscules des minuscules. Les expressions régulières ne sont pas prises en charge lors de la spécification des noms de fichier dans un répertoire. Vous pouvez uniquement utiliser des caractères génériques pour indiquer des noms de fichier dans un répertoire. Le caractère "*" peut être utilisé comme générique pour plusieurs caractères, et le caractère " ?" peut être utilisé comme générique 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 indiquer un nom de répertoire sensible à la casse. Par exemple :'"my_dir1":*, "my_dir2":Test?' Pour inclure un guillemet, utilisez deux guillemets. Par exemple :'MY_DIR:''filename.ext'. Cela indique que filename commence par un guillemet (').
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 défini sur NULL. Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE.
format	Spécifie les options de configuration supplémentaires pour l'opération de fichier. Ces options sont indiquées sous forme de 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 statut est conservée pour une opération en masse. La valeur par défaut est de 2 jours. logprefix : 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 effectué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 gérés à l'aide du nombre d'ECPU de la base de données (nombre d'OCPU si la 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 Medium. La valeur par défaut est 4. LOW : traite 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 simultanées est limité à 64. Si vous n'indiquez pas de valeur format, format est défini sur NULL.
operation_id	Utilisez ce paramètre pour suivre la progression et le statut final de l'opération de chargement sous 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;
/

---

Informations relatives au titre et au copyright

Copyright ©2024,2025,

Oracle et/ou ses affiliés.