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. |
Rubriques connexes
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.
- 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 :
- Accédez à la page Détails du sous-réseau.
- 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.
- 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.
- Revenez à la page Détails du sous-réseau.
- 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.
- Dans le menu latéral, sous Resources, cliquez sur Egress Rules.
- 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.
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 |
---|---|
|
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur |
|
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. |
|
Spécifie l'URI du bucket ou du dossier Object Storage cible, où les fichiers doivent être copiés. 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. |
|
Nom des informations d'identification permettant d'accéder à l'emplacement Cloud Object Storage cible. Si vous n'indiquez pas de valeur |
|
Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur Si vous n'indiquez pas de valeur Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE. |
|
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 :
Si vous n'indiquez pas de valeur |
|
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 |
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 |
---|---|
|
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur |
|
Spécifie l'URI, qui pointe vers un emplacement Object Storage dans l'instance Autonomous Database. 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. |
|
Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur Si vous n'indiquez pas de valeur Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE. |
|
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 :
Si vous n'indiquez pas de valeur |
|
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 |
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 |
---|---|
|
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur |
|
Spécifie l'URI, qui pointe vers un emplacement Object Storage dans l'instance Autonomous Database. 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. |
|
Nom du répertoire sur l'instance Autonomous Database à partir duquel télécharger les fichiers. Ce paramètre est obligatoire. |
|
Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur Si vous n'indiquez pas de valeur Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE. |
|
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 :
Si vous n'indiquez pas de valeur |
|
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 |
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 |
---|---|
|
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud source. Si vous n'indiquez pas de valeur |
|
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. |
|
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. Pour plus d'informations, reportez-vous à DBMS_CLOUD Formats d'URI de stockage d'objet cloud de fichier de package. |
|
Nom des informations d'identification permettant d'accéder à l'emplacement Cloud Object Storage cible. Si vous n'indiquez pas de valeur |
|
Spécifie l'expression REGEX pour filtrer les fichiers. Le modèle d'expression REGEX doit être compatible avec l'opérateur Si vous n'indiquez pas de valeur Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE. |
|
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 :
Si vous n'indiquez pas de valeur |
|
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 |
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 |
---|---|
|
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud. Si vous n'indiquez pas de valeur |
|
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. |
|
Nom du répertoire sur l'instance Autonomous Database à partir duquel vous télé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 Si vous n'indiquez pas de valeur Pour plus d'informations, reportez-vous à Condition REGEXP_LIKE. |
|
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 :
Si vous n'indiquez pas de valeur |
|
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 |
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;
/