Package DBMS_CLOUD_PIPELINE
Le package DBMS_CLOUD_PIPELINE
vous permet de créer des pipelines de données pour le chargement et l'export de données dans le cloud. Ce package prend en charge le chargement incrémentiel continu des données des fichiers de la banque d'objets dans la base de données. DBMS_CLOUD_PIPELINE
prend également en charge l'export incrémentiel continu des données de table ou des résultats de requête de la base de données vers la banque d'objets en fonction d'une colonne d'horodatage.
- Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
Ce tableau récapitule les sous-programmes inclus dans le packageDBMS_CLOUD_PIPELINE
. - DBMS_CLOUD_PIPELINE Attributs
Les attributs permettent de contrôler et de configurer le comportement d'un pipeline de données. - Vues DBMS_CLOUD_PIPELINE
Le packageDBMS_CLOUD_PIPELINE
utilise les vues suivantes.
Rubrique parent : Référence de package fourni avec Autonomous Database
Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
Ce tableau récapitule les sous-programmes inclus dans le package DBMS_CLOUD_PIPELINE
.
Sous-programme | Description |
---|---|
Crée un pipeline de données. |
|
Supprime un pipeline de données existant. |
|
Réinitialise l'état de suivi d'un pipeline de données. Utilisez le pipeline de réinitialisation pour redémarrer le pipeline à partir de l'état initial du chargement ou de l'export de données. La réinitialisation du pipeline peut éventuellement purger les données de la base de données ou de la banque d'objets, selon le type de pipeline. |
|
Exécute une exécution à la demande du pipeline dans la session de premier plan en cours, au lieu d'un travail programmé. |
|
Définit les attributs de pipeline. Il existe deux procédures surchargées, l'une pour définir un seul attribut et l'autre pour définir plusieurs attributs à l'aide d'un document JSON de paires nom/valeur d'attribut |
|
Démarre le pipeline de données. Lorsqu'un pipeline est démarré, l'opération de pipeline est exécutée en permanence dans un travail programmé en fonction de l'intervalle configuré dans les attributs de pipeline. |
|
Arrête le pipeline de données. Lorsqu'un pipeline est arrêté, aucun travail futur n'est programmé pour le pipeline. |
- Procédure CREATE_PIPELINE
La procédure crée un pipeline de données. - Procédure DROP_PIPELINE
La procédure supprime un pipeline de données existant. Si un pipeline a été démarré, il doit être arrêté avant de pouvoir être supprimé. - Procédure RESET_PIPELINE
Réinitialise l'état de suivi d'un pipeline de données. Utilisez le pipeline de réinitialisation pour redémarrer le pipeline à partir de l'état initial du chargement ou de l'export de données. La réinitialisation du pipeline peut éventuellement purger les données de la base de données ou de la banque d'objets, selon le type de pipeline. Un pipeline de données doit être à l'état Arrêté pour pouvoir être réinitialisé. - Procédure RUN_PIPELINE_ONCE
Cette procédure effectue une exécution à la demande du pipeline dans la session de premier plan en cours, au lieu d'une exécution dans un travail programmé. UtilisezDBMS_CLOUD_PIPELINE.RUN_PIPELINE_ONCE
pour tester un pipeline avant de le démarrer en tant que travail continu. - Procédure SET_ATTRIBUTE
Cette procédure définit les attributs de pipeline. Il existe deux procédures surchargées, l'une pour définir un seul attribut et l'autre pour définir plusieurs attributs à l'aide d'un document JSON de paires nom/valeur d'attribut. - Procédure START_PIPELINE
La procédure démarre le pipeline de données. Lorsqu'un pipeline est démarré, l'opération de pipeline est exécutée en continu dans un travail programmé en fonction de la valeurinterval
configurée avec les attributs de pipeline. - Procédure STOP_PIPELINE
La procédure arrête le pipeline de données. Lorsqu'un pipeline est arrêté, aucun travail futur n'est programmé pour le pipeline.
Rubrique parent : Package DBMS_CLOUD_PIPELINE
CREATE_PIPELINE Procédure
La procédure crée un pipeline de données.
Syntaxe
DBMS_CLOUD_PIPELINE.CREATE_PIPELINE
(
pipeline_name IN VARCHAR2,
pipeline_type IN VARCHAR2,
attributes IN CLOB DEFAULT NULL,
description IN VARCHAR2 DEFAULT NULL
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline. Le nom du pipeline doit respecter les règles de dénomination des identificateurs SQL Oracle. Pour plus d'informations, reportez-vous à Identificateurs. Ce paramètre est obligatoire. |
|
Indique le type de pipeline. Valeurs valides : Ce paramètre est obligatoire. |
|
Attributs de pipeline au format JSON. Valeur par défaut : Pour plus d'informations, reportez-vous à DBMS_CLOUD_PIPELINE Attributs. |
|
Description du pipeline. Valeur par défaut : |
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
DROP_PIPELINE Procédure
La procédure supprime un pipeline de données existant. Si un pipeline a été démarré, il doit être arrêté avant de pouvoir être supprimé.
Syntaxe
DBMS_CLOUD_PIPELINE.DROP_PIPELINE
(
pipeline_name IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie un nom de pipeline. Ce paramètre est obligatoire. |
|
Suppression forcée d'un pipeline, même s'il est à l'état démarré. Valeurs valides : Valeur par défaut : |
Remarque sur l'utilisation
-
Pour supprimer un pipeline à l'état Démarré, définissez le paramètre
force
surTRUE
.
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
RESET_PIPELINE Procédure
Réinitialise l'état de suivi d'un pipeline de données. Utilisez le pipeline de réinitialisation pour redémarrer le pipeline à partir de l'état initial du chargement ou de l'export de données. La réinitialisation du pipeline peut éventuellement purger les données de la base de données ou de la banque d'objets, selon le type de pipeline. Un pipeline de données doit être à l'état Arrêté pour pouvoir être réinitialisé.
Syntaxe
DBMS_CLOUD_PIPELINE.RESET_PIPELINE
(
pipeline_name IN VARCHAR2,
purge_data IN BOOLEAN DEFAULT FALSE
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline. Ce paramètre est obligatoire. |
|
Les données de purge s'appliquent à un pipeline de chargement ou à un pipeline d'export :
Valeurs valides : Valeur par défaut : |
Notes d'utilisation
-
Un pipeline de données doit être à l'état Arrêté pour pouvoir être réinitialisé. Pour plus d'informations, reportez-vous à STOP_PIPELINE Procédure.
-
Pour un pipeline de chargement, la réinitialisation du pipeline efface l'enregistrement des fichiers chargés par le pipeline. Lorsque vous appelez
START_PIPELINE
ouRUN_PIPELINE_ONCE
après la réinitialisation d'un pipeline de chargement, le pipeline répète le chargement de données et inclut tous les fichiers présents dans l'emplacement de la banque d'objets.Lorsque
purge_data
est défini surTRUE
,DBMS_CLOUD_PIPELINE.RESET_PIPELINE
effectue les opérations suivantes :-
Vide les données de la table de base de données du pipeline que vous indiquez avec l'attribut
table_name
. -
Supprime la table de statut du pipeline, ainsi que la table de fichiers incorrects et la table d'erreurs du pipeline (le cas échéant).
-
-
Pour un pipeline d'export, la réinitialisation du pipeline efface les dernières données suivies dans la table de base de données. Lorsque vous appelez
START_PIPELINE
ouRUN_PIPELINE_ONCE
après la réinitialisation d'un pipeline d'export, le pipeline répète l'export de données à partir de la table ou de la requête.Lorsque
purge_data
est défini surTRUE
,DBMS_CLOUD_PIPELINE.RESET_PIPELINE
supprime les fichiers existants dans l'emplacement de banque d'objets indiqué avec l'attributlocation
.
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
RUN_PIPELINE_ONCE Procédure
Cette procédure effectue une exécution à la demande du pipeline dans la session de premier plan en cours, au lieu d'une exécution dans un travail programmé. Utilisez DBMS_CLOUD_PIPELINE.RUN_PIPELINE_ONCE
pour tester un pipeline avant de le démarrer en tant que travail continu.
Syntaxe
DBMS_CLOUD_PIPELINE.RUN_PIPELINE_ONCE
(
pipeline_name IN VARCHAR2
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline à exécuter. Ce paramètre est obligatoire. |
Notes d'utilisation
-
Après avoir exécuté un test d'un pipeline, vous pouvez réinitialiser l'état du pipeline à l'aide de
DBMS_CLOUD_PIPELINE.RESET_PIPELINE
. Vous pouvez ainsi réinitialiser l'état du pipeline avant de le démarrer dans un travail programmé. -
Si un pipeline est à l'état démarré, il ne peut pas être exécuté dans la session de premier plan.
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
SET_ATTRIBUTE Procédure
Cette procédure définit les attributs de pipeline. Il existe deux procédures surchargées, l'une pour définir un seul attribut et l'autre pour définir plusieurs attributs à l'aide d'un document JSON de paires nom/valeur d'attribut.
Syntaxe
PROCEDURE DBMS_CLOUD_PIPELINE.SET_ATTRIBUTE
(
pipeline_name IN VARCHAR2,
attribute_name IN VARCHAR2,
attribute_value IN CLOB
);
PROCEDURE DBMS_CLOUD_PIPELINE.SET_ATTRIBUTE
(
pipeline_name IN VARCHAR2,
attributes IN CLOB
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline pour lequel définir des attributs. Ce paramètre est obligatoire. |
|
Indique le nom de l'attribut à définir. Pour plus d'informations, reportez-vous à DBMS_CLOUD_PIPELINE Attributs. |
attribute_value |
Indique la valeur de l'attribut de pipeline à définir. Pour plus d'informations, reportez-vous à DBMS_CLOUD_PIPELINE Attributs. |
|
Indique un document JSON contenant des noms et des valeurs d'attribut. Pour plus d'informations, reportez-vous à DBMS_CLOUD_PIPELINE Attributs. |
Remarque sur l'utilisation
-
Lorsque vous utilisez
DBMS_CLOUD_PIPELINE.SET_ATTRIBUTE
pour définir plusieurs attributs avec le paramètreattributes
, tous les attributs existants sont supprimés et remplacés par les attributs indiqués dans le document JSON.
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
START_PIPELINE Procédure
interval
configurée avec les attributs de pipeline.
Syntaxe
DBMS_CLOUD_PIPELINE.START_PIPELINE
(
pipeline_name IN VARCHAR2,
start_date IN TIMESTAMP WITH TIME ZONE DEFAULT NULL
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline. Ce paramètre est obligatoire. |
|
Indique la date de début du travail de pipeline. Valeur par défaut : |
Notes d'utilisation
-
Par défaut, un travail de pipeline commence immédiatement, dès que le pipeline est démarré. Pour démarrer un travail de pipeline ultérieurement, indiquez une date ou un horodatage valide à l'aide du paramètre
start_date
. -
Pour plus d'informations sur le pipeline
interval
et les autres attributs de pipeline, reportez-vous à Attributs DBMS_CLOUD_PIPELINE.
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
STOP_PIPELINE Procédure
La procédure arrête le pipeline de données. Lorsqu'un pipeline est arrêté, aucun travail futur n'est programmé pour le pipeline.
Syntaxe
DBMS_CLOUD_PIPELINE.STOP_PIPELINE
(
pipeline_name IN VARCHAR2,
force IN BOOLEAN DEFAULT FALSE
);
Paramètres
Paramètre | Description |
---|---|
|
Spécifie le nom du pipeline. Ce paramètre est obligatoire. |
|
Si le paramètre de force est transmis en tant que Valeurs valides : Valeur par défaut : |
Rubrique parent : Récapitulatif des sous-programmes DBMS_CLOUD_PIPELINE
DBMS_CLOUD_PIPELINE Attributs
Les attributs permettent de contrôler et de configurer le comportement d'un pipeline de données.
Attributs
Comme indiqué dans la colonne Type de pipeline, en fonction du type de pipeline
LOAD
ou EXPORT
, un pipeline prend en charge un autre ensemble d'attributs.
Nom d'attribut | Description | Type de pipeline | Modifiable après le début du pipeline |
---|---|---|---|
credential_name |
Nom des informations d'identification permettant d'accéder au stockage d'objet cloud source. Vous pouvez utiliser Valeur par défaut : Si vous n'indiquez pas de |
LOAD , EXPORT |
Oui |
field_list |
Identifie les champs dans les fichiers source et leurs types de données. La syntaxe de cet argument est identique à la clause Valeur par défaut : La valeur par défaut indique que les champs et leurs types de données sont déterminés par les colonnes de la table indiquée dans l'attribut |
LOAD |
Oui |
format |
Options décrivant le format du type de pipeline.
La pompe de données Cet attribut est obligatoire pour les pipelines |
LOAD , EXPORT |
Oui |
interval |
Intervalle en minutes entre les exécutions consécutives du travail de pipeline programmé. Valeur par défaut : 15 minutes |
LOAD , EXPORT |
Oui |
key_column |
Colonne d'horodatage ou de date dans le fichier Valeur par défaut : NULL. Si |
EXPORT |
Non |
location |
Indique un URI pointant vers un emplacement Object Storage. Le format de l'URI dépend du service Cloud Object Storage. Pour plus d'informations, reportez-vous à Formats d'URI DBMS_CLOUD. Cet attribut est obligatoire pour les pipelines |
LOAD , EXPORT |
Non |
priority |
Spécifie une valeur de chaîne qui détermine le nombre d'opérations parallèles effectuées pour le pipeline.
Une opération avec une priorité plus élevée consomme plus de ressources de base de données et se termine plus tôt. Valeurs valides :
Valeur par défaut : Le nombre maximal d'opérations de fichiers simultanées est limité à 64. |
LOAD , EXPORT |
Oui |
query |
Spécifie une instruction Par exemple :
Valeur par défaut : Pour un pipeline d'export, |
EXPORT |
Non |
table_name |
Spécifie le nom de la table cible pour le chargement ou l'export de données. Pour un pipeline de chargement, Pour un pipeline d'export, |
LOAD , EXPORT |
Non |
table_owner |
Nom du schéma dans lequel réside la table cible pour le chargement ou l'export de données. Valeur par défaut : Avec une valeur |
LOAD , EXPORT |
Non |
Rubrique parent : Package DBMS_CLOUD_PIPELINE
DBMS_CLOUD_PIPELINE Vues
Le package DBMS_CLOUD_PIPELINE
utilise les vues suivantes.
Rubrique parent : Package DBMS_CLOUD_PIPELINE